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

Adiciona um ou mais grupos de servidores a um grupo de dimensionamento para ajustar dinamicamente a quantidade de instâncias conforme as mudanças na carga de trabalho e garantir alta disponibilidade. Os tipos de grupos de servidores compatíveis incluem Application Load Balancer (ALB), Network Load Balancer (NLB) e Gateway Load Balancer (GWLB). Após a associação dos grupos de servidores, o Auto Scaling registra automaticamente as instâncias nesses grupos para distribuir o tráfego com base na carga.

Experimente agora

Chame esta operação diretamente no OpenAPI Explorer. O OpenAPI Explorer elimina a necessidade de calcular assinaturas manualmente. Após uma chamada bem-sucedida, ele gera automaticamente códigos de exemplo para diversos SDKs.

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	AttachServerGroups	A operação a ser executada. Defina o valor como AttachServerGroups.
RegionId	String	Sim	cn-hangzhou	O ID da região do grupo de dimensionamento.
ScalingGroupId	String	Sim	asg-bp18p2yfxow2dloq****	O ID do grupo de dimensionamento.
ClientToken	String	Não	123e4567-e89b-12d3-a456-42665544****	Um token de cliente que garante a idempotência da solicitação. O token deve ser exclusivo para cada solicitação, conter apenas caracteres ASCII e ter no máximo 64 caracteres. Para obter mais informações, consulte Como garantir a idempotência.
ForceAttach	Boolean	Não	false	Especifica se as instâncias ECS ou ECI existentes no grupo de dimensionamento devem ser adicionadas aos novos grupos de servidores. Valores válidos: true: Adiciona as instâncias. false: Não adiciona as instâncias. Valor padrão: false.
ServerGroup.N.ServerGroupId	String	Sim	sgp-60ofsqhwer0b***	O ID do grupo de servidores.
ServerGroup.N.Type	String	Sim	ALB	O tipo do grupo de servidores. Valores válidos: ALB: Application Load Balancer. NLB: Network Load Balancer. GWLB: Gateway Load Balancer.
ServerGroup.N.Weight	Integer	Não	100	O peso de uma instância ECS ou ECI como servidor back-end. Valores válidos: 0 a 100. Quanto maior o peso, mais solicitações são encaminhadas para a instância. Um peso igual a 0 indica que nenhuma solicitação será encaminhada. Nota Este parâmetro é obrigatório para grupos de servidores ALB e NLB. Não é possível definir este parâmetro para grupos de servidores GWLB.
ServerGroup.N.Port	Integer	Não	22	O número da porta usada pela instância ECS ou ECI como servidor back-end. Valores válidos: 1 a 65535. Nota Este parâmetro é obrigatório para grupos de servidores ALB e NLB. Não é possível defini-lo para grupos de servidores GWLB. Para grupos GWLB, a porta padrão é 6081.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
ScalingActivityId	String	asa-bp1c9djwrgxjyk31****	O ID da atividade de dimensionamento que associa os grupos de servidores e adiciona as instâncias existentes no grupo de dimensionamento a esses grupos. Nota Este parâmetro é retornado apenas se `ForceAttach` estiver definido como `true`.
RequestId	String	74C4E313-8570-479F-8791-DC25360D****	O ID da solicitação.

Exemplos

Solicitação de exemplo

http(s)://ess.aliyuncs.com/?Action=AttachServerGroups
&RegionId=cn-hangzhou
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&ForceAttach=false
&ServerGroup=[{"ServerGroupId":"sgp-60ofsqhwer0b***","Type":"ALB","Weight":100,"Port":22}]
&Common request parameters

Resposta de exemplo

XML formato

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

<AttachServerGroupsResponse>
    <ScalingActivityId>asa-bp1c9djwrgxjyk31****</ScalingActivityId>
    <RequestId>74C4E313-8570-479F-8791-DC25360D****</RequestId>
</AttachServerGroupsResponse>

JSON formato

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

{
  "ScalingActivityId" : "asa-bp1c9djwrgxjyk31****",
  "RequestId" : "74C4E313-8570-479F-8791-DC25360D****"
}

Códigos de erro

Para obter uma lista de códigos de erro, consulte o Error Center.