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

Associa grupos de vServer a um grupo de dimensionamento. Após associar uma instância do Classic Load Balancer (CLB) ao grupo de dimensionamento, as instâncias desse grupo são adicionadas automaticamente como servidores de backend da instância CLB. Esses servidores passam a processar as solicitações encaminhadas pelo CLB, otimizando o fluxo de tráfego recebido. Para direcionar diferentes tipos de requisição a servidores de backend específicos ou distribuir o tráfego com base em nomes de domínio ou URLs, chame a operação AttachVServerGroups. Essa operação permite adicionar vários grupos de vServer e facilita a gestão de diversas configurações de servidores de backend conforme suas necessidades de roteamento.

Notas de uso

Antes de chamar esta operação para associar grupos de vServer ao grupo de dimensionamento, certifique-se de que os seguintes requisitos sejam atendidos:
- A instância CLB e o grupo de dimensionamento pertencem à mesma conta Alibaba Cloud.
- A instância CLB e o grupo de dimensionamento estão na mesma região.
- A instância CLB está no estado Running.
- A instância CLB tem pelo menos um listener configurado e o recurso de verificação de integridade ativado.
- Se o tipo de rede da instância CLB e do grupo de dimensionamento for Virtual Private Cloud (VPC), ambos devem utilizar a mesma VPC.
- Caso o grupo de dimensionamento utilize VPC e a instância CLB use rede clássica, qualquer servidor de backend da instância CLB em uma VPC deve compartilhar a mesma VPC do grupo de dimensionamento.
- Os grupos de vServer a serem associados ao grupo de dimensionamento devem pertencer à instância CLB.
- A associação dos grupos de vServer não pode fazer com que o número total de grupos ultrapasse a cota predefinida. Para mais informações sobre a cota de grupos de vServer, consulte "Limites".
Ao chamar esta operação para associar grupos de vServer, especifique os seguintes parâmetros:
- LoadBalancerId: o ID da instância CLB
- VServerGroupId: o ID do grupo de vServer
- Port: o número da porta do grupo de vServer.
  
  Nota
  Se você tentar associar o mesmo grupo de vServer a um grupo de dimensionamento várias vezes usando a mesma porta, o sistema tratará cada tentativa como uma associação distinta. Caso sua solicitação inclua o mesmo ID de grupo de vServer combinado com o mesmo número de porta múltiplas vezes, apenas a primeira configuração desse par será considerada válida. As combinações subsequentes de grupo de vServer e número de porta serão ignoradas.

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 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	Sim	AttachVServerGroups	A operação a ser executada. Defina o valor como AttachVServerGroups.
RegionId	String	Sim	cn-hangzhou	O ID da região do grupo de dimensionamento. Exemplos: cn-hangzhou e cn-shanghai. Para obter informações sobre regiões e zonas, consulte Regiões e zonas.
ScalingGroupId	String	Sim	asg-bp18p2yfxow2dloq****	O ID do grupo de dimensionamento.
ClientToken	String	Não	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 garanta que ele seja único entre diferentes solicitações. O token pode conter apenas caracteres ASCII e não pode exceder 64 caracteres. Para mais informações, consulte Garantir idempotência.
ForceAttach	Boolean	Não	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 novo grupo de vServer. true false Valor padrão: false.
VServerGroup.N.VServerGroupAttribute.N.VServerGroupId	String	Não	rsp-bp1jp1rge****	O ID do grupo de vServer. Os dois Ns no nome do parâmetro têm os seguintes significados: O primeiro N especifica o número de série da instância CLB. Valores válidos: 1 a 5. O segundo N especifica o número de série do grupo de vServer pertencente à instância CLB. Valores válidos: 1 a 5.
VServerGroup.N.VServerGroupAttribute.N.Weight	Integer	Não	100	O peso de uma instância ECS ou instância de contêiner elástico como servidor de backend no novo grupo de vServer. Valores válidos: 0 a 100. Os dois Ns no nome do parâmetro têm os seguintes significados: O primeiro N especifica o número de série da instância CLB. Valores válidos: 1 a 5. O segundo N especifica o número de série do grupo de vServer pertencente à instância CLB. Valores válidos: 1 a 5. Valor padrão: 50.
VServerGroup.N.VServerGroupAttribute.N.Port	Integer	Não	22	O número da porta pelo qual o Auto Scaling adiciona instâncias ECS ou instâncias de contêiner elástico ao novo grupo de vServer. Valores válidos: 1 a 65535. Os dois Ns no nome do parâmetro têm os seguintes significados: O primeiro N especifica o número de série da instância CLB. Valores válidos: 1 a 5. O segundo N especifica o número de série do grupo de vServer pertencente à instância CLB. Valores válidos: 1 a 5.
VServerGroup.N.LoadBalancerId	String	Não	lb-bp1u7etiogg38yvwz****	O ID da instância CLB N à qual o grupo de vServer pertence. N especifica o número de série da instância CLB. Valores válidos de N: 1 a 5.

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=AttachVServerGroups
&RegionId=cn-hangzhou
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&ForceAttach=false
&VServerGroup=[{"VServerGroupAttribute":[{"VServerGroupId":"rsp-bp1jp1rge****","Weight":100,"Port":22}],"LoadBalancerId":"lb-bp1u7etiogg38yvwz****"}]
&<Common request parameters>

Exemplos de respostas de sucesso

XML formato

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

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

JSON formato

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
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 especificada.
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 existe na conta 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	InvalidVServerGroupId.ForLoadBalancer	Invalid VServerGroupId For LoadBalancer "%s".	O grupo de vServer especificado por VServerGroupId não pertence à instância CLB indicada.
400	QuotaExceeded.VServerGroup	VServerGroup quota exceeded in the specified scaling group.	O número máximo de grupos de vServer que podem ser associados ao grupo de dimensionamento foi atingido.