Todos os produtos
Search
Central de documentação

:DeleteInstances

Última atualização: Jul 03, 2026

Libera uma ou mais instâncias de pagamento conforme o uso ou instâncias do Elastic Compute Service (ECS) com assinatura expirada.

Observações de uso

  • Após a liberação da instância, todos os recursos físicos utilizados são reciclados. Os dados relevantes são apagados e não podem ser recuperados.

  • As configurações de disco podem afetar o comportamento dos discos quando as instâncias associadas são liberadas. Observe os seguintes itens:

    • Discos com DeleteWithInstance definido como false são retidos como discos de pagamento conforme o uso.

    • Discos com DeleteWithInstance definido como true são liberados junto com a instância.

    • Snapshots automáticos de discos com DeleteAutoSnapshot definido como false são retidos.

    • Snapshots automáticos de discos com DeleteAutoSnapshot definido como true são liberados.

    • Snapshots manuais dos discos são retidos.

    • Se OperationLocks na resposta contiver "LockReason" : "security" para uma instância, ela estará bloqueada por motivos de segurança. Para obter mais informações, consulte Comportamento da API quando uma instância é bloqueada por motivos de segurança. Mesmo que DeleteWithInstance esteja definido como false para os discos de dados anexados à instância, esse parâmetro será ignorado e os discos de dados serão liberados junto com a instância.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer para maior conveniência. O OpenAPI Explorer gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

ParâmetroTipoObrigatórioExemploDescrição
ActionStringSimDeleteInstances

Operação a ser executada. Defina o valor como DeleteInstances.

DryRunBooleanNãofalse

Especifica se deve executar uma simulação. Valor padrão: false. Valores válidos:

  • true: executa uma simulação. O sistema verifica o par de AccessKey, as permissões do usuário RAM e os parâmetros obrigatórios. Se a solicitação falhar na simulação, o sistema retorna a mensagem de erro correspondente. Se a solicitação passar na simulação, o sistema retorna o código de erro DRYRUN.SUCCESS.
  • false: executa uma simulação e envia a solicitação. Se a solicitação passar na simulação, o sistema retorna um código de status HTTP 2XX e executa a operação.
ForceBooleanNãofalse

Especifica se deve forçar a liberação da instância no estado Running (Running). Valor padrão: false. Valores válidos:

  • true: força a liberação da instância no estado Running (Running). Quando o parâmetro Force é definido como true, esta operação equivale a desligar a energia. Dados temporários na memória e no armazenamento da instância são apagados e não podem ser restaurados.
  • false: libera a instância normalmente. Este valor é válido apenas para instâncias no estado Stopped (Stopped).
TerminateSubscriptionBooleanNãofalse

Especifica se deve liberar a instância com assinatura expirada.

Valor padrão: false.

ClientTokenStringNão123e4567-e89b-12d3-a456-426655440000

Token de cliente usado para garantir a idempotência da solicitação. Use o cliente para gerar o token e garanta que ele seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para obter mais informações, consulte Como garantir a idempotência.

RegionIdStringSimcn-hangzhou

ID da região da instância. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.

InstanceId.NStringSimi-bp1g6zv0ce8oghu7****

ID da instância N.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

7B7813C6-57BF-41XX-B12B-F172F65A6046

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ecs.aliyuncs.com/?Action=DeleteInstances
&InstanceId.1=i-bp1g6zv0ce8oghu7****
&Force=false
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<DeleteInstancesResponse>
    <RequestId>7B7813C6-57BF-41XX-B12B-F172F65A6046</RequestId>
</DeleteInstancesResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "7B7813C6-57BF-41XX-B12B-F172F65A6046"
}

Códigos de erro

HttpCode

Código de erro

Mensagem de erro

Descrição

400

DRYRUN.SUCCESS

This request is a dryrun request with successful result.

Mensagem retornada porque a validade da solicitação foi verificada e considerada válida.

400

DependencyViolation.SLBConfiguring

Specified operation is denied as your instance is using by another product.

Mensagem retornada porque a instância está sendo referenciada por uma instância do Server Load Balancer (SLB) em configuração.

400

DependencyViolation.RouteEntry

Specified instance is used by route entry.

Mensagem retornada porque existem regras de roteamento personalizadas na Virtual Private Cloud (VPC) e a VPC não pode ser excluída.

500

InternalError

The request processing has failed due to some unknown error.

Mensagem retornada devido à ocorrência de um erro interno. Tente novamente mais tarde.

500

InternalError

%s

Mensagem retornada devido à ocorrência de um erro interno.

403

InvalidOperation.DeletionProtection

%s

Mensagem retornada porque a operação é inválida. Desative primeiro a proteção contra liberação da instância.

403

InvalidOperation.EniLinked

%s

Mensagem retornada porque a operação não é suportada enquanto a elastic network interface (ENI) da instância estiver associada a outras ENIs. Desassocie a ENI das outras ENIs antes de desanexá-la da instância.

403

IncorrectInstanceStatus

%s

Mensagem retornada porque a operação não é suportada enquanto a instância estiver no estado atual.

403

InstanceLockedForSecurity

The specified operation is denied as your instance is locked for security reasons.

Mensagem retornada porque a instância está bloqueada por motivos de segurança.

404

InvalidInstanceIds.NotFound

The specified InstanceIds does not exist.

Mensagem retornada porque o ID da instância especificado não existe. Verifique se o ID da instância especificado é válido. Chame a operação DescribeInstances para consultar os estados de instâncias específicas.

404

InvalidInstanceId.NotFound

%s

Mensagem retornada porque o parâmetro InstanceId especificado não existe.

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.