AttachLoadBalancers - Auto Scaling: Central de Documentação do Alibaba Cloud

Associa balanceadores de carga a um grupo de dimensionamento. O Auto Scaling permite associar balanceadores de carga a grupos de dimensionamento. Esses balanceadores distribuem o tráfego de acesso entre as instâncias do grupo e melhoram o desempenho do serviço. Chame a operação AttachLoadBalancers para associar um ou mais balanceadores de carga ao seu grupo de dimensionamento.

Observações de uso

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

O balanceador de carga e o grupo de dimensionamento pertencem à mesma conta e região da Alibaba Cloud.
O balanceador de carga está no estado Running.
Pelo menos um listener está configurado para o balanceador de carga e o recurso de verificação de integridade está ativado.
Se os tipos de rede do balanceador de carga e do grupo de dimensionamento forem Virtual Private Cloud (VPC), ambos devem usar a mesma VPC.
Caso o tipo de rede do grupo de dimensionamento seja VPC e o do balanceador seja rede clássica, com pelo menos um servidor de back-end utilizando VPC, o grupo de dimensionamento e esse servidor devem estar na mesma VPC.
A associação garante que o número total de balanceadores vinculados ao grupo de dimensionamento permaneça dentro do limite máximo predefinido. Para detalhes sobre a cota de balanceadores de carga, consulte Limites.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. A ferramenta gera dinamicamente códigos de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	AttachLoadBalancers	A operação a ser executada. Defina o valor como AttachLoadBalancers.
ScalingGroupId	String	Yes	asg-bp1avr6ensitts3w****	O ID do grupo de dimensionamento.
ForceAttach	Boolean	No	false	Especifica se todas as instâncias do grupo de dimensionamento atual devem ser adicionadas aos grupos de servidores de back-end da instância do Classic Load Balancer (CLB, anteriormente conhecido como slb) marcada para associação. Valores válidos: true: Ao definir este parâmetro como `true`, a operação de associação inclui a adição das instâncias existentes no grupo de dimensionamento aos grupos de servidores de back-end da instância CLB. Nota Se já houver um balanceador de carga associado ao seu grupo de dimensionamento e você desejar adicionar as instâncias desse grupo aos servidores de back-end do balanceador, chame esta operação novamente e defina o parâmetro de solicitação `ForceAttach` como `true`. false: Ao definir este parâmetro como `false`, a operação de associação não inclui a adição das instâncias existentes no grupo de dimensionamento aos grupos de servidores de back-end da instância CLB. Valor padrão: false.
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 mais informações, consulte Garantir idempotência.
Async	Boolean	No	false	Defina se a operação de associação será executada de forma assíncrona. Chamadas assíncronas mantêm a integridade transacional das operações e garantem que os resultados sejam aplicados somente após a conclusão bem-sucedida de todas as etapas. Recomendamos definir este parâmetro como true. Valores válidos: true: executa a operação de associação de forma assíncrona. Nesse caso, o ID da atividade de dimensionamento é retornado. false: não executa a operação de associação de forma assíncrona. Valor padrão: false.
LoadBalancer.N	String	No	lb-2zeur05gfs****	O ID da instância CLB N. Valores válidos de N: 1 a 5. Nota É possível associar até cinco balanceadores de carga a um grupo de dimensionamento em uma única chamada.
LoadBalancerConfig.N.LoadBalancerId	String	No	147b46d767c-cn-qingdao-cm5****	O ID da instância CLB.
LoadBalancerConfig.N.Weight	Integer	No	10	O peso de cada instância como servidor de back-end. Um peso maior indica que a instância receberá uma proporção maior das solicitações recebidas. Se uma instância tiver peso 0, ela não receberá nenhuma solicitação de acesso. Valores válidos: 0 a 100.

Parâmetros de resposta

Parameter

Type

Example

Description

ScalingActivityId

String

asa-bp140qd7mak8k63f****

O ID da atividade de dimensionamento.

Este parâmetro é retornado apenas se Async for definido como true. Chame a operação DescribeScalingActivities para consultar o ID da atividade de dimensionamento e verificar seu status.

RequestId

String

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

O ID da solicitação.

Exemplos

Exemplos de solicitações

http(s)://ess.aliyuncs.com/?Action=AttachLoadBalancers
&ScalingGroupId=asg-bp1avr6ensitts3w****
&ForceAttach=false
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&Async=false
&LoadBalancer=["lb-2zeur05gfs****"]
&LoadBalancerConfig=[{"LoadBalancerId":"147b46d767c-cn-qingdao-cm5****","Weight":10}]
&<Common request parameters>

Exemplos de respostas de sucesso

XML formato

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

<AttachLoadBalancersResponse>
    <ScalingActivityId>asa-bp140qd7mak8k63f****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AttachLoadBalancersResponse>

JSON formato

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

{
  "ScalingActivityId" : "asa-bp140qd7mak8k63f****",
  "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.

HTTP status code	Error code	Error message	Description
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 da Alibaba Cloud.
400	QuotaExceeded.LoadBalancer	LoadBalancer quota exceeded in the scaling group "%s".	A quantidade de instâncias CLB que podem ser associadas ao grupo de dimensionamento excede o limite superior.
404	InvalidLoadBalancerId.NotFound	The load balancer "%s" does not exist.	A instância CLB especificada não existe na conta da Alibaba Cloud.
400	InvalidLoadBalancerId.RegionMismatch	The load balancer "%s" and the specified scaling group are not in the same Region.	A instância CLB e o grupo de dimensionamento não estão na mesma região.
400	IncorrectLoadBalancerStatus	The current status of the load balancer "%s" does not support this action.	A operação não é suportada quando a instância CLB está no estado atual.
400	IncorrectLoadBalancerHealthCheck	The current health check type of the load balancer "%s" does not support this action.	O recurso de verificação de integridade não está ativado para a instância CLB.
400	InvalidLoadBalancerId.VPCMismatch	The specified virtual switch and the instance in the load balancer "%s" are not in the same VPC.	A instância CLB e o grupo de dimensionamento não residem na mesma VPC.
400	QuotaExceeded.BackendServer	Backend server quota exceeded in the load balancer "%s".	O número de servidores de back-end da instância CLB excede o limite superior.
404	InvalidScalingConfigurationId.NotFound	The specified scaling configuration does not exist.	O grupo de dimensionamento não possui nenhuma configuração de dimensionamento ativada.