AddServersToServerGroup - : Central de Documentação do Alibaba Cloud

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	Sim	AddServersToServerGroup	A operação a ser executada. Defina o valor como AddServersToServerGroup.
ServerGroupId	String	Sim	sgp-atstuj3rtoptyui****	O ID do grupo de servidores.
Servers.N.ServerId	String	Sim	ecs-bp67acfmxazb4p****	O ID do servidor de backend. Especifique até 40 servidores de backend em cada chamada. Se o tipo de grupo de servidores for Instance, defina este parâmetro como o ID de uma instância do Elastic Compute Service (ECS), uma interface de rede elástica (ENI) ou uma instância de contêiner elástico. Os servidores de backend são especificados por Ecs, Eni ou Eci. Caso o tipo de grupo de servidores seja Ip, defina este parâmetro como um endereço IP.
Servers.N.ServerType	String	Sim	Ecs	O tipo do servidor de backend. Valores válidos: Ecs: instância ECS Eni: ENI Eci: instância de contêiner elástico Ip: endereço IP Nota Especifique até 40 servidores de backend em cada chamada.
Servers.N.ServerIp	String	Não	192.168.6.6	O endereço IP do servidor de backend. Se o tipo de grupo de servidores for Ip, especifique um endereço IP. Nota Especifique até 40 servidores de backend em cada chamada.
Servers.N.Port	Integer	Não	443	A porta usada pelo servidor de backend. Valores válidos: 1 a 65535. Após ativar o encaminhamento de todas as portas para um grupo de servidores, não é necessário especificar portas ao adicionar servidores de backend. O NLB encaminha o tráfego para os servidores de backend com base nas portas de frontend. Verifique se o encaminhamento de todas as portas está ativado para um grupo de servidores consultando o valor de AnyPortEnabled retornado pela operação ListServerGroups. Nota Especifique até 40 servidores de backend em cada chamada.
Servers.N.Weight	Integer	Não	100	O peso do servidor de backend. Valores válidos: 0 a 100. Valor padrão: 100. Se o peso de um servidor de backend for definido como 0, nenhuma solicitação será encaminhada para ele. Nota Especifique até 40 servidores de backend em cada chamada.
Servers.N.Description	String	Não	ECS	A descrição do servidor de backend. A descrição deve ter entre 2 e 256 caracteres e pode conter letras, dígitos, vírgulas (,), pontos (.), ponto e vírgula (;), barras (/), arrobas (@), sublinhados (_) e hifens (-). Nota Especifique até 40 servidores de backend em cada chamada.
RegionId	String	Não	cn-hangzhou	O ID da região da instância NLB. Chame a operação DescribeRegions para consultar a lista de regiões mais recente.
DryRun	Boolean	Não	false	Especifica se deve ser executada apenas uma simulação, sem realizar a solicitação real. Valores válidos: true: execute apenas uma simulação. O sistema verifica a solicitação em busca de possíveis problemas, incluindo valores de parâmetros ausentes, sintaxe de solicitação incorreta e limites de serviço. Se a solicitação falhar na simulação, uma mensagem de erro será retornada. Caso a solicitação passe na simulação, o código de erro `DryRunOperation` será retornado. false (padrão): execute uma simulação e realiza a solicitação real. Se a solicitação passar na simulação, um código de status HTTP 2xx será retornado e a operação será executada.
ClientToken	String	Não	123e4567-e89b-12d3-a456-426655440000	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. Nota Se você não especificar este parâmetro, o sistema usará automaticamente o client token como o request ID. O request ID pode ser diferente para cada solicitação.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	O ID da solicitação.
ServerGroupId	String	sgp-atstuj3rtoptyui****	O ID do grupo de servidores.
JobId	String	72dcd26b-f12d-4c27-b3af-18f6aed5****	O ID da tarefa assíncrona.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=AddServersToServerGroup
&ServerGroupId=sgp-atstuj3rtoptyui****
&Servers=[{"ServerId":"ecs-bp67acfmxazb4p****","ServerType":"Ecs","ServerIp":"192.168.6.6","Port":443,"Weight":100,"Description":"ECS"}]
&RegionId=cn-hangzhou
&DryRun=false
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

<AddServersToServerGroupResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <ServerGroupId>sgp-atstuj3rtoptyui****</ServerGroupId>
    <JobId>72dcd26b-f12d-4c27-b3af-18f6aed5****</JobId>
</AddServersToServerGroupResponse>

Formato JSON

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

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "ServerGroupId" : "sgp-atstuj3rtoptyui****",
  "JobId" : "72dcd26b-f12d-4c27-b3af-18f6aed5****"
}

Códigos de erro

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