Todos os produtos
Search
Central de documentação

:Liberar uma instância

Última atualização: Jun 26, 2026

Chame a operação DeleteDBInstance para liberar uma instância do ApsaraDB RDS.

Antes de chamar esta operação, verifique se os seguintes requisitos são atendidos:

  • A instância está no estado Running.

  • O recurso de divisão de leitura/gravação está desabilitado para a instância.

  • A instância é primária, somente leitura, de recuperação de desastres ou temporária. Se for uma instância primária, ela deve usar o método de faturamento de pagamento conforme o uso.

Nota

É possível liberar uma instância manualmente no console do ApsaraDB RDS. Para mais informações, consulte

Liberar uma instância

.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para maior comodidade, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros de solicitação

ParameterTypeRequiredExampleDescription
ActionStringYesDeleteDBInstance

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

DBInstanceIdStringYesrm-uf6wjk5****

O ID da instância. Chame a operação DescribeDBInstances para consultar o ID da instância.

ReleasedKeepPolicyStringNoLastest

A política com base na qual o ApsaraDB RDS retém os arquivos de backup arquivados após a liberação da instância. Valores válidos:

  • None: Nenhum arquivo de backup arquivado é retido.
  • Lastest: Somente o último arquivo de backup arquivado é retido.
  • All: Todos os arquivos de backup arquivados são retidos.
Nota Este parâmetro é compatível apenas quando a instância executa MySQL e utiliza SSDs locais.

Parâmetros de resposta

Parameter

Type

Example

Description

RegionId

String

ap-southeast-1

O ID da região da instância.

RequestId

String

65BDA532-28AF-4122-AA39-B382721EEE64

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://rds.aliyuncs.com/?Action=DeleteDBInstance
&DBInstanceId=rm-uf6wjk5****
&<Common request parameters>

Exemplos de respostas bem-sucedidas

XML format

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

<DeleteDBInstanceResponse>
<RequestId>65BDA532-28AF-4122-AA39-B382721EEE64</RequestId>
<RegionId>ap-southeast-1</RegionId>
</DeleteDBInstanceResponse>

JSON format

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

{
  "RequestId" : "65BDA532-28AF-4122-AA39-B382721EEE64",
  "RegionId" : "ap-southeast-1"
}

Códigos de erro

HTTP status code

Error code

Error message

Description

400

EngineMigration.ActionDisabled

Specified action is disabled while custins is in engine migration.

A mensagem de erro retornada porque a operação especificada está desabilitada durante a migração do mecanismo para a instância.

403

OperationDenied.PrePayTypeNotSupported

The operation is not permitted due to pay type of instance.

A mensagem de erro retornada porque a instância é do tipo assinatura e não pode ser excluída diretamente.

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