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

Descrição

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

O disco deve estar anexado a uma instância ECS e no estado In Use (In_Use).
A instância da qual você deseja desanexar o disco de dados deve estar no estado Running (Running) ou Stopped (Stopped).
Para desanexar o disco do sistema, a instância deve estar no estado Stopped (Stopped).
Se OperationLocks na resposta contiver "LockReason" : "security" ao consultar informações de uma instância, isso indica que a instância está bloqueada por motivos de segurança e nenhuma operação terá efeito sobre ela.
DetachDisk é uma operação assíncrona. O disco leva aproximadamente 1 minuto para ser desanexado da instância após a chamada da operação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	DetachDisk	A operação a ser executada. Defina o valor como DetachDisk.
DiskId	String	Sim	d-bp67acfmxazb4p****	ID do disco a ser desanexado.
InstanceId	String	Sim	i-bp67acfmxazb4p****	ID da instância ECS da qual o disco será desanexado.
DeleteWithInstance	Boolean	Não	false	Especifica se o disco do sistema deve ser liberado automaticamente quando a instância à qual ele está anexado for liberada. Valores válidos: true: O disco do sistema é liberado quando a instância é liberada. false: O disco do sistema não é liberado quando a instância é liberada. O disco do sistema é retido como um disco de dados com pagamento conforme o uso. Valor padrão: true. Observe os seguintes itens: Este parâmetro não pode ser definido para discos com o recurso de multi-anexação ativado. Se um disco de dados for desanexado, o valor padrão será `false`.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DetachDisk
&DiskId=d-bp67acfmxazb4p****
&InstanceId=i-bp67acfmxazb4p****
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<DetachDiskResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DetachDiskResponse>

Formato JSON

{
    "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.	Mensagem retornada porque um parâmetro obrigatório não foi definido.
400	InvalidRegionId.MalFormed	The specified RegionId is not valid	Mensagem retornada porque o parâmetro RegionId especificado é inválido.
400	InvalidOperation.InstanceTypeNotSupport	The instance type of the specified instance does not support hot detach disk.	Mensagem retornada porque a instância à qual o disco está anexado não suporta a troca dinâmica de discos.
403	IncorrectDiskStatus	The current disk status does not support this operation.	Mensagem retornada porque a operação não é suportada enquanto o disco está no estado atual. Verifique se o disco está utilizável e se não há pagamentos pendentes.
403	DiskNotPortable	The specified disk is not a portable disk.	Mensagem retornada porque o disco especificado não é removível.
403	InstanceLockedForSecurity	The instance is locked due to security.	Mensagem retornada porque a operação não é suportada enquanto a instância está bloqueada por motivos de segurança.
403	DependencyViolation	The specified disk has not been attached on the specified instance.	Mensagem retornada porque a operação não é suportada enquanto o recurso possui outras dependências. Por exemplo, o disco especificado não está anexado à instância especificada, ou o grupo de segurança especificado não pode ser excluído enquanto contém instâncias. Remova as dependências e tente novamente.
403	DiskTypeViolation	The specified disk is a system disk and cannot support the operation.	Mensagem retornada porque o disco especificado é um disco do sistema e não pode ser desanexado da instância à qual está anexado.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	Mensagem retornada porque a operação não é suportada enquanto o recurso está no estado atual.
403	UserNotInTheWhiteList	The user is not in disk white list.	Mensagem retornada porque você não tem autorização para gerenciar o disco. Tente novamente após obter a autorização necessária.
403	InvalidInstance.ImageCategory	The image category of the specified instance does not support detaching system disk.	Mensagem retornada porque o disco do sistema especificado não pode ser desanexado da instância especificada enquanto a imagem da instância está no estado atual. Causa possível: A imagem usada para criar a instância foi excluída.
403	DeleteWithInstance.Conflict	Multi attach disk cannot be set to DeleteWithInstance attribute.	Mensagem retornada porque o atributo DeleteWithInstance é inválido para discos com o recurso de multi-anexação ativado.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Mensagem retornada porque o parâmetro InstanceId especificado é inválido.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Mensagem retornada porque o disco especificado não existe. Verifique se o ID do disco está correto.
404	InvalidDisk.AlreadyDetached	The specified disk has been detached.	Mensagem retornada porque o disco especificado já foi desanexado da instância.
500	InternalError	The request processing has failed due to some unknown error.	Mensagem retornada porque ocorreu um erro interno. Tente novamente mais tarde.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	Mensagem retornada porque ocorreu um erro interno. Tente novamente mais tarde.

Para obter uma lista de códigos de erro, visite o API Error Center.