Todos os produtos
Search
Central de documentação

Auto Scaling:DetachLoadBalancers

Última atualização: Jul 03, 2026

Desanexa instâncias do Classic Load Balancer (CLB, anteriormente conhecido como Server Load Balancer ou SLB) de um grupo de dimensionamento. Se a instância CLB atual não atender mais aos requisitos de negócio, chame a operação DetachLoadBalancers para removê-la do grupo de dimensionamento. Nessa chamada, use os parâmetros ScalingGroupId, LoadBalancer.N e ForceDetach para especificar uma ou mais instâncias CLB a serem desanexadas. Também é possível definir se a operação será assíncrona e se as instâncias do Elastic Compute Service (ECS) que atuam como servidores de back-end serão removidas dos grupos de servidores de back-end da instância CLB. Esta operação desanexa apenas instâncias CLB de um grupo de dimensionamento.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, 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

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

DetachLoadBalancers

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

ScalingGroupId

String

Sim

asg-bp1ffogfdauy0jw0****

O ID do grupo de dimensionamento.

ForceDetach

Boolean

Não

false

Indica se as instâncias ECS que atuam como servidores de back-end devem ser removidas dos grupos de servidores de back-end da instância CLB. 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. Use o cliente para gerar o token, mas certifique-se de que ele seja único entre diferentes solicitações.

O token pode conter apenas caracteres ASCII e não deve exceder 64 caracteres. Para obter mais informações, consulte Garantir idempotência.

Async

Boolean

Não

false

Defina se a instância CLB N será desanexada do grupo de dimensionamento de forma assíncrona. Na execução assíncrona, a chamada só é considerada bem-sucedida após a conclusão de todas as operações. Se alguma operação falhar, a chamada também falhará. Recomendamos definir este parâmetro como true.

Valores válidos:

  • true: desanexa a instância CLB N do grupo de dimensionamento de maneira assíncrona. Nesse caso, o ID da atividade de dimensionamento é retornado.

  • false: não desanexa a instância CLB N do grupo de dimensionamento de maneira assíncrona.

Valor padrão: false.

LoadBalancer.N

String

Não

lb-2zeur05gfs****

ID da instância CLB N a ser desanexada do grupo de dimensionamento. Valores válidos para N: 1 a 5.

RegionId

String

Não

cn-qingdao

ID da região do grupo de dimensionamento.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

ScalingActivityId

String

asa-bp140qd7mak8k63f****

ID da atividade de dimensionamento.

Este valor é retornado apenas quando Async é definido como true. Chame a operação DescribeScalingActivities para consultar os IDs das atividades de dimensionamento retornados e visualizar o status de execução dessas atividades.

RequestId

String

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

ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ess.aliyuncs.com/?Action=DetachLoadBalancers
&ScalingGroupId=asg-bp1ffogfdauy0jw0****
&ForceDetach=false
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&Async=false
&LoadBalancer=["lb-2zeur05gfs****"]
&RegionId=cn-qingdao
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<DetachLoadBalancersResponse>
    <ScalingActivityId>asa-bp140qd7mak8k63f****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</DetachLoadBalancersResponse>

Formato JSON

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

{
  "ScalingActivityId" : "asa-bp140qd7mak8k63f****",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

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

403

Forbidden.Unauthorized

A required authorization for the specified action is not supplied.

O Auto Scaling não tem autorização para chamar a operação.

404

InvalidScalingGroupId.NotFound

The specified scaling group does not exist.

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

404

InvalidLoadBalancerId.NotFound

The Load Balancer "%s" does not exist.

A instância CLB especificada não está anexada ao grupo de dimensionamento.