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

Exclui ou libera uma instância ECS especificada.

Descrição da operação

Aviso Após a liberação de uma instância, todos os recursos físicos utilizados pela instância são recuperados. Todos os dados relacionados são perdidos permanentemente e não podem ser recuperados.

Os snapshots manuais dos discos são retidos e continuam a incorrer em cobranças. Você pode excluí-los chamando DeleteSnapshot.
A liberação dos discos anexados à instância e dos snapshots automáticos depende das configurações de parâmetros especificadas quando foram criados. Antes de liberar uma instância, você pode chamar DescribeDisks e ModifyDiskAttribute para consultar e modificar as configurações de parâmetros relacionadas:
- Se DeleteWithInstance=false, o disco é convertido em um disco pós-pago e retido. Caso contrário, o disco é liberado junto com a instância.
- Se DeleteAutoSnapshot=false, os snapshots automáticos são retidos. Caso contrário, eles são liberados junto com a instância.
Os endereços IP elásticos (EIPs) não são liberados junto com a instância. Você pode chamar ReleaseEipAddress para liberá-los.
Importante Para uma instância bloqueada por segurança, mesmo que o parâmetro DeleteWithInstance de um disco esteja definido como false, esse atributo é ignorado e o disco é liberado junto com a instância.
.

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

delete

*Instance

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.	i-bp1g6zv0ce8oghu7****
Force	boolean	Não	Especifica se deve forçar a liberação de uma instância em execução (`Running`). true: Força a liberação de uma instância em execução (`Running`). false: Libera a instância de forma normal. A instância deve estar no estado Parada (`Stopped`). Valor padrão: false. Aviso Uma liberação forçada equivale a um desligamento abrupto. Os dados temporários na memória e no armazenamento da instância são apagados e não podem ser recuperados. .	false
ForceStop	boolean	Não	Especifica se deve usar a política de desligamento forçado ao liberar uma instância em execução (`Running`). Este parâmetro só entra em vigor quando `Force=true`. Valores válidos: true: Desliga e libera a instância forçadamente. Isso equivale a uma operação típica de desligamento. A instância entra diretamente no processo de liberação de recursos. Aviso Uma liberação forçada equivale a um desligamento abrupto. Os dados temporários na memória e no armazenamento da instância são apagados e não podem ser recuperados. false: Antes que a instância seja liberada, o sistema executa preferencialmente um processo de desligamento padrão. Este modo faz com que a liberação da instância leve vários minutos. Você pode configurar ações de drenagem de serviço durante o desligamento do sistema operacional para reduzir impactos em seus sistemas de negócios. Valor padrão: true.	true
TerminateSubscription	boolean	Não	Especifica se deve liberar uma instância por assinatura expirada. true: Libera a instância. false: Não libera a instância. Valor padrão: false.	false
DryRun	boolean	Não	Especifica se deve ser realizado apenas um dry run. Valores válidos: true: Envia uma solicitação de verificação sem liberar a instância. O sistema verifica se os parâmetros obrigatórios foram especificados, se o formato da solicitação é válido, se os requisitos de negócios são atendidos e se os recursos do ECS são suficientes. Se a verificação falhar, o erro correspondente será retornado. Se a verificação for bem-sucedida, o código de erro `DryRunOperation` será retornado. false (padrão): Envia uma solicitação normal. Após a solicitação passar na verificação, a instância é excluída diretamente.	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	DependencyViolation.SLBConfiguring	Specified operation is denied as your instance is using by another product.
400	DependencyViolation.RouteEntry	Specified instance is used by route entry.	Custom route entries exist in the VPC and the VPC cannot be deleted.
400	InvalidParameter	The input parameter InstanceId is invalid.	The specified InstanceId parameter is invalid.
500	InternalError	The request processing has failed due to some unknown error.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
403	IncorrectInstanceStatus.Initializing	The specified instance status does not support this operation.	The specified instance cannot be released at this time. Try again later.
403	InvalidOperation.DeletionProtection	%s	The operation is invalid. Disable release protection for the instance first.
403	InvalidOperation.EniLinked	%s	The operation is invalid because the current ENI of the instance is associated with other ENIs. You must disassociate the ENI from the other ENIs before you can unbind the ENI from the instance.
403	OperationDenied.SystemInstanceNotSupport	The system instance does not support the %s operation because %s.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	The specified instanceId is invalid.

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.