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

Anexa um disco de dados ou 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 for adquirido separadamente, o método de cobrança deve ser pay-as-you-go.
- Um disco do sistema que foi desinstalado de uma instância ECS pode ser anexado como um disco de dados sem restrições de métodos de cobrança.
- Um disco efêmero elástico que foi desanexado só pode ser reanexado à sua instância original.
Ao anexar um disco do sistema:
- A instância ECS de destino deve ser a instância original da qual o disco do sistema foi desanexado.
- A instância ECS de destino deve estar no estado Stopped (Stopped).
- Você deve especificar a credencial de logon para a instância.
- Discos efêmeros elásticos não podem ser anexados como discos do sistema.
- Para obter mais informações sobre como anexar discos do sistema, consulte Desanexar ou anexar um disco do sistema.
Ao consultar informações da instância ECS, se a resposta contiver {"OperationLocks": {"LockReason" : "security"}}, todas as operações 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

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

ecs:AttachDisk

update

*Disk

acs:ecs:{#regionId}:{#accountId}:disk/{#diskId}

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

ecs:LoginAsNonRoot
ecs:PasswordCustomized

Nenhuma

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 a ser anexado. O disco (`DiskId`) e a instância (`InstanceId`) devem estar na mesma zona. Nota Tanto discos de dados quanto discos do sistema podem ser anexados. Para 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 será descontinuado em breve. Para melhorar a compatibilidade, 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 junto com a instância. false: O disco não é liberado junto com a instância. O disco é retido como um disco de dados pay-as-you-go. Valor padrão: false. Ao definir 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, `OperationLocks` contiver `"LockReason" : "security"`, este parâmetro será ignorado quando a instância for liberada, e o disco será liberado junto com a instância. Se o disco a ser anexado for um `elastic ephemeral disk`, você deve definir `DeleteWithInstance` como `true`. Discos com o recurso multi-attach ativado não suportam este parâmetro.	false
Bootable	boolean	Não	Especifica se o disco deve ser anexado como um disco do sistema. Valores válidos: true: O disco é anexado como um disco do sistema. false: O disco não é anexado como um disco do sistema. Valor padrão: false. Nota Se você definir `Bootable=true`, a instância ECS de destino não deve ter nenhum disco do sistema anexado.	false
Password	string	Não	A senha definida para a instância ao anexar um disco do sistema. A senha é válida apenas para os nomes de usuário administrator e root e não é válida 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 seguintes caracteres especiais são suportados: ()`~!@#$%^&-_+=\|{}[]:;'<>,.?/ 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 vinculado à instância ECS Linux ao anexar um disco do sistema. Instâncias Windows Server: Pares de chaves SSH não são suportados. Mesmo que este parâmetro seja especificado, apenas a configuração `Password` terá efeito. Instâncias Linux: O método de logon baseado em senha é desativado por padrão.	KeyPairTestName
Force	boolean	Não	Especifica se o disco deve ser anexado forçadamente. Valores válidos: true: Anexa o disco forçadamente. false: Não anexa o disco forçadamente. Valor padrão: false. Nota Atualmente, apenas 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.	A operação não é permitida porque o status da instância não a suporta.
400	InvalidParameter	The input parameter is mandatory for processing this request is empty.	A combinação de parâmetros especificada é inválida.
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 troca de disco a quente.
400	DiskCategory.OperationNotSupported	The operation is not supported to the specified disk due to its disk category.	O disco especificado não suporta esta operação devido a restrições de tipo de disco.
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.	O tipo de disco especificado não suporta operações de 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.	Esta região 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 em paralelo excede o limite.
400	InvalidInstanceType.NotSupported	The specified instanceType is not supported by the image architecture.	A arquitetura de imagem especificada não suporta este tipo de instância.
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 está bloqueada por motivos de segurança. Entre em contato com o suporte técnico 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.	O tipo de armazenamento em bloco especificado não suporta esta operação.
403	DiskId.StatusNotSupported	The specified disk status is not supported.	O status atual do disco não suporta 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 estado do disco não suporta esta operação. O disco deve estar no estado InUse ou Available para prosseguir.
403	UserNotInTheWhiteList	The user is not in disk white list.	O usuário não está na lista de operações de parâmetros relacionados a ARN.
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 instanceType of the specified instance does not support this disk category.	O tipo de instância especificado (InstanceType) não suporta a categoria de disco da instância atual. Tente um tipo de instância diferente. Para obter informações sobre os tipos de disco suportados por cada tipo de instância, consulte a documentação da família de instâncias.
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 às quais o disco especificado está anexado atingiu o limite superior.
403	InvalidOperation.CanNotAttachMultiAttachDiskAsSystemDisk	Multi attach disk can not be attached as system disk.	Um disco com o recurso multi-attach ativado não pode ser usado como disco do sistema.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	A imagem especificada é do Alibaba Cloud Marketplace e não suporta a desativação da liberação junto com a instância.
403	InvalidParameter.DeleteWithInstance	The DeleteWithInstance for the elastic ephemeral disk must be set to true.	O atributo DeleteWithInstance do 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 exige 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.	password e keyPairName não podem estar vazios para esta operação. Certifique-se de que pelo menos um entre password ou keyPairName seja especificado.
403	InvalidOperation.DiskQueueNumberNotEnough	The number of disk queues on the instance is not enough.	A instância não tem capacidade de fila de disco suficiente.
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.	Para zonas HPN parcialmente restritas, a instância e o disco devem estar na mesma zona 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.	O ID da instância especificado é inválido.
404	InvalidDiskId.NotFound	The specified disk does not exist.	O disco especificado não existe.
404	InvalidDisk.InUse	The specified disk has been occupied.
404	DiskAttachedNumberExceeded	The attaching times of the specified disk exceeded.
404	InvalidKMSKeyId.NotFound	The KMS key used by the disk does not exist.	O ID da chave KMS especificado não existe.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.