Todos os produtos
Search
Central de documentação

Auto Scaling:AttachAlbServerGroups

Última atualização: Jul 03, 2026

Associa grupos de servidores do Application Load Balancer (ALB) a um grupo de dimensionamento. Após a associação dos grupos de servidores ALB, o Auto Scaling ajusta automaticamente a capacidade de computação com base na carga de trabalho e distribui dinamicamente o tráfego entre as instâncias, melhorando a estabilidade e o desempenho da aplicação.

Observações de uso

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

  • O grupo de dimensionamento e o grupo de servidores ALB devem estar na mesma virtual private cloud (VPC).

  • O grupo de servidores ALB deve estar no estado Available.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos que você chame esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Yes

AttachAlbServerGroups

A operação que você deseja executar. Defina o valor como AttachAlbServerGroups.

RegionId

String

Yes

cn-hangzhou

O ID da região do grupo de dimensionamento.

Exemplos: cn-hangzhou e cn-shanghai. Para obter mais informações sobre regiões e zonas, consulte Regiões e zonas.

ScalingGroupId

String

Yes

asg-bp18p2yfxow2dloq****

O ID do grupo de dimensionamento.

ClientToken

String

No

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

O 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 exclusivo 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.

ForceAttach

Boolean

No

false

Especifica se as instâncias existentes do Elastic Compute Service (ECS) ou instâncias de contêiner elástico no grupo de dimensionamento devem ser adicionadas ao grupo de servidores ALB. Valores válidos:

  • true: adiciona as instâncias ECS ou instâncias de contêiner elástico existentes no grupo de dimensionamento ao grupo de servidores ALB. O sistema retorna o valor de ScalingActivityId.

  • false: não adiciona as instâncias ECS ou instâncias de contêiner elástico existentes no grupo de dimensionamento ao grupo de servidores ALB.

Valor padrão: false.

AlbServerGroup.N.AlbServerGroupId

String

Yes

sgp-ddwb0y0g6y9bjm****

O ID do grupo de servidores ALB N.

N especifica o número de série do grupo de servidores ALB. É possível associar apenas um número limitado de grupos de servidores ALB a um grupo de dimensionamento. Para visualizar o limite de cota predefinido ou solicitar manualmente um aumento de cota, acesse o Quota Center.

AlbServerGroup.N.Weight

Integer

Yes

100

O peso de uma instância ECS ou instância de contêiner elástico como servidor backend no grupo de servidores ALB N.

Um peso maior significa uma proporção maior de solicitações. Um peso zero indica que nenhuma solicitação é alocada à instância. Valores válidos: 0 a 100.

AlbServerGroup.N.Port

Integer

Yes

22

A porta usada pelas instâncias ECS ou instâncias de contêiner elástico como servidores backend no grupo de servidores ALB N. Valores válidos: 1 a 65535.

Nota

N especifica o número de série do grupo de servidores ALB. Se instâncias ECS ou instâncias de contêiner elástico forem adicionadas ao grupo de servidores ALB N por portas diferentes, o sistema considera que várias portas do grupo de servidores ALB N estão associadas ao grupo de dimensionamento.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

ScalingActivityId

String

asa-2ze6wxj8vsohn6j9****

O ID da atividade de dimensionamento na qual o grupo de servidores ALB N é associado ao grupo de dimensionamento e as instâncias ECS ou instâncias de contêiner elástico existentes são adicionadas ao grupo de servidores ALB N.

Nota

Este parâmetro é retornado apenas se você definir ForceAttach como true.

RequestId

String

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

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ess.aliyuncs.com/?Action=AttachAlbServerGroups
&RegionId=cn-hangzhou
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&ForceAttach=false
&AlbServerGroup=[{"AlbServerGroupId":"sgp-ddwb0y0g6y9bjm****","Weight":100,"Port":22}]
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<AttachAlbServerGroupsResponse>
    <ScalingActivityId>asa-2ze6wxj8vsohn6j9****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AttachAlbServerGroupsResponse>

Formato JSON

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

{
  "ScalingActivityId" : "asa-2ze6wxj8vsohn6j9****",
  "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

400

AlbServerGroup.NotExist

The ServerGroup "%s" do(es) not exist.

O grupo de servidores ALB não existe na conta Alibaba Cloud.

400

AlbServerGroup.AlreadyAttached

The ALB ServerGroups are already attached.

O grupo de servidores ALB já está associado ao grupo de dimensionamento.