Todos os produtos
Search
Central de documentação

:DeleteInstance

Última atualização: Jul 03, 2026

Libera uma instância de pagamento conforme o uso ou uma instância de assinatura expirada.

Descrição

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

  • Discos anexados à instância:

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

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

    • Se DeleteAutoSnapshot estiver definido como false para um disco, os snapshots automáticos desse disco serão retidos.

    • Se DeleteAutoSnapshot estiver definido como true para um disco, os snapshots automáticos desse disco serão liberados.

    • Os snapshots manuais dos discos são retidos.

    • Se OperationLocks na resposta contiver "LockReason" : "security" para uma instância, a instância 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
ActionStringSimDeleteInstance

A operação a ser executada. Defina o valor como DeleteInstance.

InstanceIdStringSimi-bp1g6zv0ce8oghu7****

O ID da instância a ser liberada.

ForceBooleanNãofalse

Especifica se a liberação forçada da instância no estado Running (Running) deve ocorrer. 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 ao desligamento forçado. 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).

Valor padrão: false.

TerminateSubscriptionBooleanNãofalse

Especifica se a instância de assinatura expirada deve ser liberada.

Valor padrão: false.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

O ID da solicitação.

Exemplos

Exemplos de solicitações

https://ecs.aliyuncs.com/?Action=DeleteInstance
&InstanceId=i-bp1g6zv0ce8oghu7****
&Force=false
&TerminateSubscription=false
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DeleteInstanceResponse>
    <RequestId>928E2273-5715-46B9-A730-238DC996A533</RequestId>
</DeleteInstanceResponse>

Formato JSON

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

{
  "RequestId" : "928E2273-5715-46B9-A730-238DC996A533"
}

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.

A mensagem de erro 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.

A mensagem de erro retornada porque ainda existem regras de roteamento personalizadas na Virtual Private Cloud (VPC).

400

InvalidParameter

The input parameter InstanceId is invalid.

A mensagem de erro retornada porque o parâmetro InstanceId especificado é inválido.

500

InternalError

The request processing has failed due to some unknown error.

A mensagem de erro retornada devido a um erro interno. Tente novamente mais tarde.

403

IncorrectInstanceStatus

The current status of the resource does not support this operation.

A mensagem de erro retornada porque o estado atual do recurso não suporta esta operação.

403

InstanceLockedForSecurity

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

A mensagem de erro retornada porque a instância está bloqueada por motivos de segurança.

403

ChargeTypeViolation

The operation is not permitted due to charge type of the instance.

A mensagem de erro retornada porque o método de faturamento da instância não suporta esta operação.

403

IncorrectInstanceStatus.Initializing

The specified instance status does not support this operation.

A mensagem de erro retornada porque a instância está em inicialização e não pode ser liberada. Tente novamente mais tarde.

403

IncorrectInstanceStatus

The specified instance is still attached by volumes.

A mensagem de erro retornada porque a instância especificada ainda possui volumes de dados anexados.

403

InvalidOperation.DeletionProtection

%s

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

403

InvalidOperation.EniLinked

%s

A mensagem de erro retornada porque a instância está vinculada a interfaces de rede elásticas (ENIs). Desvincule as ENIs antes de liberar a instância.

404

InvalidInstanceId.NotFound

The specified InstanceId does not exist.

A mensagem de erro retornada porque o parâmetro InstanceId especificado é inválido.

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