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

Desanexa um disco de dados ou disco de sistema pós-pago de uma instância ECS.

Descrição da operação

Observe os seguintes itens ao chamar esta operação:

Esta é uma operação assíncrona. Após uma chamada bem-sucedida, aguarde aproximadamente um minuto para que o desanexamento seja concluído.
A instância à qual o disco está anexado não deve estar bloqueada com "LockReason" : "security" em OperationLocks.
Após um disco efêmero elástico ser desanexado, ele só pode ser reanexado à sua instância original.

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:DetachDisk

update

*Disco.

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

*Instância.

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

Nenhuma

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
InstanceId	string	Sim	O ID da instância ECS à qual o disco está anexado.	i-bp67acfmxazb4p****
DiskId	string	Sim	O ID do disco que você deseja desanexar. O disco deve estar anexado a uma instância e no estado Em uso (`In_use`). Para desanexar um disco de dados, a instância à qual o disco está anexado deve estar no estado Em execução (`Running`) ou Parado (`Stopped`). Para desanexar um disco de sistema, a instância à qual o disco está anexado deve estar no estado Parado (`Stopped`).	d-bp67acfmxazb4p****
DeleteWithInstance	boolean	Não	Especifica se deve configurar o atributo de liberação automática ao desanexar um disco de sistema ou disco de dados. Este atributo determina se o disco de sistema ou disco de dados é liberado junto com a instância ECS. 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 pós-pago. Valor padrão: true Nota: Discos com o recurso de anexação múltipla ativado não suportam este parâmetro. Se você desanexar um disco de dados, o valor padrão é `false`. Se o disco que você deseja desanexar for um `disco efêmero elástico`, você deve definir `DeleteWithInstance` 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	InvalidParameter	The input parameter is mandatory for processing this request is empty.	Os parâmetros da solicitação atual 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 detach disk.	A instância à qual o disco está anexado não suporta hot swapping.
400	DisksDetachingOnEcsExceeded	The number of disks detaching on the instance exceeds the limit.	O número de discos que estão sendo desanexados da instância excede o limite.
400	InvalidInstanceId.Malformed	The specified parameter InstanceId is not valid.
500	InternalError	The request processing has failed due to some unknown error.
403	IncorrectDiskStatus	The current disk status does not support this operation.
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	DependencyViolation	The specified disk has not been attached on the specified instance.
403	DiskTypeViolation	The specified disk is a system disk and cannot support the operation.	O disco especificado é um disco do sistema e não pode ser desanexado.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
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. Abra um ticket para solicitar a inclusão na lista de permissões.
403	InvalidInstance.ImageCategory	The system disk cannot be detached because it was created from a marketplace image. Please use a system disk created from a custom or public image.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	O disco especificado não é um disco removível e não oferece suporte à liberação junto com a instância.
403	InvalidOperation.DiskCategoryUnsupported	The DetachDisk operation is not supported for elastic ephemeral disk.	Os discos efêmeros elásticos não podem ser desanexados individualmente.
403	InvalidParameter.DeleteWithInstance	The DeleteWithInstance for the elastic ephemeral disk must be set to true.	A propriedade DeleteWithInstance de um disco efêmero elástico deve ser definida como true.
403	InvalidOperation.DiskDetachingFromThisEcs	The specified disk is detaching from this ecs.	O disco está sendo desanexado da instância atual.
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 disco especificado não existe. Verifique se o ID do disco está correto.
404	InvalidDisk.AlreadyDetached	The specified disk has been detached.
404	InvalidDiskId.OperationNotSupported	The operation is not supported due to base image not exist.
429	Throttling	The request was denied due to request throttling. Please retry later.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.