Todos os produtos
Search
Central de documentação

Auto Scaling:DetachDBInstances

Última atualização: Jul 03, 2026

Desanexa uma ou mais instâncias do ApsaraDB RDS de um grupo de dimensionamento. Para reduzir o número de instâncias do ApsaraDB RDS associadas ao grupo de dimensionamento, chame a operação DetachDBInstances. Essa operação libera as instâncias do ApsaraDB RDS do grupo de dimensionamento, aumentando significativamente a agilidade e a eficiência no gerenciamento e na alocação de recursos.

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âmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DetachDBInstances

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

ScalingGroupId

String

Sim

asg-bp1igpak5ft1flyp****

O ID do grupo de dimensionamento.

ForceDetach

Boolean

Não

false

Indica se os endereços IP privados das instâncias existentes no grupo de dimensionamento serão removidos da lista de permissões de endereços IP da instância do ApsaraDB RDS marcada para desanexação. Valores válidos:

  • true

  • false

Valor padrão: false.

ClientToken

String

Não

123e4567-e89b-12d3-a456-42665544****

Token de cliente usado para garantir a idempotência da solicitação.

Gere o token com o cliente, mas garanta que seja exclusivo entre solicitações diferentes. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres. Para obter mais informações, consulte Garantir idempotência.

DBInstance.N

String

Não

rm-bp12cy3****

ID da instância N do ApsaraDB RDS a ser desanexada do grupo de dimensionamento. É possível desanexar até cinco instâncias do ApsaraDB RDS de um grupo de dimensionamento por chamada.

RegionId

String

Não

cn-qingdao

O ID da região do grupo de dimensionamento.

RemoveSecurityGroup

Boolean

Não

false

Indica se a lista de permissões do grupo de segurança da instância do ApsaraDB RDS marcada para desanexação será removida. Este parâmetro só tem efeito se AttachMode estiver definido como SecurityGroup. Valores válidos:

  • true

  • false

Valor padrão: false.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ess.aliyuncs.com/?Action=DetachDBInstances
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&ForceDetach=false
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&DBInstance=["rm-bp12cy3****"]
&RegionId=cn-qingdao
&RemoveSecurityGroup=false
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DetachDBInstancesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</DetachDBInstancesResponse>

Formato JSON

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Códigos de erro

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

Código de status HTTP

Código de erro

Mensagem de erro

Descrição

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

O grupo de dimensionamento especificado não existe na conta Alibaba Cloud.

400

InvalidDBInstanceId.NotFound

DB instance "%s" does not exist.

A instância do ApsaraDB RDS especificada não existe.