AttachDisk - Elastic Compute Service: Central de Documentação do Alibaba Cloud

Anexa um disco de dados ou um disco do sistema a uma instância ECS.

Descrição da operação

Ao chamar esta operação, observe os seguintes itens:

A instância e o disco devem estar na mesma zona.
O disco deve estar no estado Available (Available).
Ao anexar um disco de dados:
- A instância ECS de destino deve estar no estado Running (Running) ou Stopped (Stopped).
- Se o disco foi comprado separadamente, seu método de faturamento deve ser pay-as-you-go.
- Se um disco do sistema desanexado de uma instância ECS for anexado como um disco de dados, seu método de faturamento não será limitado.
- Depois que um disco efêmero elástico for desanexado, ele só poderá ser reanexado à sua instância original.
Ao anexar um disco do sistema:
- A instância ECS de destino deve ser a instância de origem da qual o disco do sistema foi desanexado.
- A instância ECS de destino deve estar no estado Stopped (Stopped).
- Você deve configurar as credenciais de logon da instância.
- Discos efêmeros elásticos não podem ser anexados como discos do sistema.
- Para obter mais informações sobre como anexar um disco do sistema, consulte Desanexar ou anexar um disco do sistema.
Ao consultar as informações de uma instância ECS, se a resposta contiver {"OperationLocks": {"LockReason" : "security"}}, todas as operações na instância serão proibidas.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância ECS à qual você deseja anexar o disco.	i-bp1dq5lozx5f4pmd****
DiskId	string	Sim	O ID do disco que você deseja anexar. O disco (`DiskId`) e a instância (`InstanceId`) devem estar na mesma zona. Nota Você pode anexar discos de dados e discos do sistema. Para as restrições relacionadas, consulte a seção de descrição da operação acima.	d-bp1j4l5axzdy6ftk****
Device	string	Não	O nome do dispositivo do disco. Nota Este parâmetro está sendo descontinuado. Para melhorar a compatibilidade, recomendamos que você use outros parâmetros para identificar o disco.	testDeviceName
DeleteWithInstance	boolean	Não	Especifica se o disco deve ser liberado quando a instância for liberada. Valores válidos: true: O disco é liberado. false: O disco não é liberado. O disco é retido e convertido em um disco de dados pay-as-you-go. Valor padrão: false. Ao configurar este parâmetro, observe os seguintes itens: Se você definir `DeleteWithInstance` como `false` e a instância ECS estiver bloqueada por motivos de segurança (ou seja, `"LockReason" : "security"` estiver marcado em `OperationLocks`), essa propriedade do disco será ignorada e o disco será liberado quando a instância ECS for liberada. Se o disco de destino que você deseja anexar for um `elastic ephemeral disk`, você deverá definir o parâmetro `DeleteWithInstance` como `true`. Este parâmetro não pode ser configurado para discos com o recurso multi-attach ativado.	false
Bootable	boolean	Não	Especifica se o disco deve ser anexado como um disco do sistema. Valores válidos: true: Sim. false: Não. Valor padrão: false. Nota Se você definir este parâmetro como `Bootable=true`, a instância ECS de destino não deve ter um disco do sistema anexado.	false
Password	string	Não	A senha de logon da instância, que é configurada ao anexar um disco do sistema. Este parâmetro entra em vigor apenas para os nomes de usuário administrator e root e não entra em vigor para outros nomes de usuário. A senha deve ter de 8 a 30 caracteres e deve conter pelo menos três dos seguintes tipos de caracteres: letras maiúsculas, letras minúsculas, dígitos e caracteres especiais. Os caracteres especiais podem ser: ()`~!@#$%^&-_+=\|{}[]:;'<>,.?/ Para instâncias Windows, a senha não pode começar com uma barra (/). Nota* Se você especificar o parâmetro `Password`, envie a solicitação via HTTPS para evitar vazamentos de senha.	EcsV587!
KeyPairName	string	Não	O nome do par de chaves SSH a ser vinculado a uma instância ECS Linux ao anexar um disco do sistema. Windows Server: Pares de chaves SSH não são suportados. Mesmo que você especifique este parâmetro, apenas a configuração `Password` será aplicada. Linux: O logon baseado em senha é desativado por padrão.	KeyPairTestName
Force	boolean	Não	Especifica se o disco deve ser anexado à força. Valores válidos: true: Sim. false: Não. Valor padrão: false. Nota Atualmente, apenas os Enterprise SSDs (ESSDs) regionais (`cloud_regional_disk_auto`) suportam a definição deste parâmetro como true.	false

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Códigos de erro

Código de status HTTP	Código de erro	Mensagem de erro	Descrição
400	InvalidDevice.Malformed	The specified device is not valid.
400	IncorrectInstanceStatus	The current status of the resource does not support this operation.	O status atual da instância não oferece suporte a este tipo de operação.
400	InvalidParameter	The input parameter is mandatory for processing this request is empty.	Os parâmetros da solicitação são inválidos. Tente novamente.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid.
400	InvalidOperation.InstanceTypeNotSupport	The instance type of the specified instance does not support hot attach disk.	A instância à qual o disco está anexado não suporta hot-plugging de disco.
400	DiskCategory.OperationNotSupported	The disk category of the specified disk does not support the current operation. Please check the operations supported by the disk category and try again.
400	InvalidDisk.DiskNotBootable	The specified disk is not a bootable disk. It cannot be attached as a system disk.
400	InvalidInstance.NotOriginInstance	The specified disk can not attached to other instance as system disk.
400	InvalidParameterForce.DiskCategoryNotSupported	The specified disk category does not support force attach operation.	A categoria de disco especificada não oferece suporte à anexação forçada.
400	InvalidParameterForce.PrepaidDiskNotSupported	The prepaid disk does not support force attach operation.	Discos por assinatura não suportam operações de anexação forçada.
400	InvalidParameterForce.MultiAttachDiskNotSupported	The multi attach disk does not support force attach operation.	Discos com anexação múltipla não suportam operações de anexação forçada.
400	InvalidParameterForce.RegionNotSupported	The specified region does not support force attach operation.	A região especificada não suporta operações de anexação forçada.
400	OperationConflict.DisksAttachingParallellyExceed	The number of disks attaching parallelly exceeds the limit.	O número de discos anexados simultaneamente excede o limite.
400	InvalidInstanceType.NotSupported	The specified instanceType is not supported by the image architecture.	O InstanceType especificado não é suportado.
400	InvalidOperation.EncryptedDiskUnsupported	The specified encrypted disk is not supported for this operation.
400	InvalidOperation.ForceAttachConflict	The device still has mount residue on the source instance. Please ensure no residual mount points exist in the source instance and try again.
500	InternalError	The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
403	InstanceDiskLimitExceeded	The number of disks attached to the instance has exceeded the limit.
403	InvalidDevice.InUse	The specified device has been occupied.
403	DiskNotPortable	The specified disk is not a portable disk.
403	InstanceLockedForSecurity	The instance is locked due to security.	A instância à qual o disco está anexado está bloqueada por motivos de segurança.
403	ResourcesNotInSameZone	The specified instance and disk are not in the same zone.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	DiskInArrears	The specified operation is denied because the disk has overdue payments. Please settle the outstanding balance.
403	DiskError	IncorrectDiskStatus.
403	DiskId.ValueNotSupported	The specified parameter diskid is not supported.	Esta operação não é suportada para o tipo de block storage especificado.
403	DiskId.StatusNotSupported	The specified disk status is not supported.	O estado atual do disco não oferece suporte a esta operação.
403	IncorrectInstanceStatus.NotSupportESSD	The operation is not supported in this status. Please reboot the instance.
403	IncorrectDiskStatus	The operation is not supported in this status.	O disco não suporta esta operação. Certifique-se de que o disco esteja em uso normal e de que sua conta não tenha pagamentos em atraso.
403	UserNotInTheWhiteList	The user is not in disk white list.	O usuário não está na lista de permissões do Shared Block Storage. Envie um ticket para solicitar a inclusão na lista de permissões.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK has not authorized the ECS service to perform the KMS TagResource and UntagResource operations. Please verify the authorization and try again.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service does not have permission to access your KMS key. Please verify that the specified KMS key has authorized the ECS service.
403	DependencyViolation.WindowsInstance	The instance image is Windows. SSH key pair login is not supported.
403	InvalidInstanceType.NotSupportDiskCategory	The instance type of the specified instance does not support the specified disk category. Please call DescribeAvailableResource to query the supported disk category and try again.
403	InvalidInstanceType.NotSupportPL0	The instanceType of the specified instance does not support PL0 of cloud_essd.
403	InvalidInstanceType.NvmeRequired	The instanceType of the specified instance requires nvme protocol.	O tipo de instância especificado requer o protocolo NVMe.
403	InvalidInstanceType.NvmeUnsupported	The instanceType of the specified instance does not support nvme protocol.	O tipo de instância especificado não suporta o protocolo NVMe.
403	InvalidInstanceType.NotSupportMultiAttachDisk	The instanceType of the specified instance does not support multi attach disk.	O tipo de instância especificado não suporta a anexação de discos com o recurso multi-attach ativado.
403	DiskAttachedNumberExceeded	The attaching times of the specified disk exceeded.	O número de instâncias anexadas ao disco especificado atingiu o limite superior.
403	InvalidOperation.CanNotAttachMultiAttachDiskAsSystemDisk	Multi attach disk can not be attached as system disk.	Discos com o recurso multi-attach ativado não podem ser usados como discos de sistema.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	O disco especificado não é um disco removível e não pode ser liberado com a instância.
403	InvalidParameter.DeleteWithInstance	The DeleteWithInstance for the elastic ephemeral disk must be set to true.	O atributo DeleteWithInstance de um disco efêmero elástico deve ser definido como true.
403	InvalidOperation.OtherInstanceUnsupported	The elastic ephemeral disk can only be attached to the instance it was last mounted on. Please check the disk system tag to get the last associated instance.
403	InvalidInstance.ZoneConflict	The force attach operation is not supported when both the current and target instances are in the same zone.	A anexação forçada requer que a instância atual e a instância de destino estejam em zonas diferentes.
403	InvalidParameter.AllEmpty	The current operation requires either a password or a keyPairName to must be provided. Please ensure that at least one of them is not empty.	Nenhum parâmetro foi especificado. Especifique os parâmetros obrigatórios.
403	InvalidOperation.DiskQueueNumberNotEnough	The number of disk queues on the instance is not enough.	O número de filas de disco na instância é insuficiente.
403	InvalidOperation.DiskAttachModeUnsupported	The instance type does not support the disk attach mode.	O tipo de instância atual não suporta o modo de anexação de disco.
403	OperationDenied.HpnZoneMismatch	Instance and disk must be in the same HPN zone for restricted HPN zones.	Nas regiões HPN restritas, a instância e o disco devem residir na mesma região HPN para realizar a operação de anexação.
403	OperationDenied.UnsupportedEncryptedDisk	The instance type does not support attaching encrypted disks.	O tipo de instância não suporta a anexação de discos criptografados.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	A instância especificada não existe. Verifique se o ID da instância está correto.
404	InvalidDiskId.NotFound	The specified disk does not exist.	O DiskId especificado não existe. Verifique o ID do disco e a região.
404	InvalidDisk.InUse	The specified disk has been occupied.
404	DiskAttachedNumberExceeded	The attaching times of the specified disk exceeded.
404	InvalidKMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.