AddServersToServerGroup - - Centro de documentación de Alibaba Cloud

Agrega servidores backend a un grupo de servidores especificado.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que ejecute esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	AddServersToServerGroup	La operación que desea ejecutar. Establezca el valor en AddServersToServerGroup.
ServerGroupId	String	Sí	sgp-atstuj3rtoptyui****	El ID del grupo de servidores.
Servers.N.ServerId	String	Sí	ecs-bp67acfmxazb4p****	El ID del servidor backend. Especifique hasta 40 servidores backend en cada llamada. Si el tipo de grupo de servidores es Instance, establezca este parámetro en el ID de una instancia de Elastic Compute Service (ECS), una interfaz de red elástica (ENI) o una instancia de contenedor elástico. Los servidores backend se especifican mediante Ecs, Eni o Eci. Si el tipo de grupo de servidores es Ip, establezca este parámetro en una dirección IP.
Servers.N.ServerType	String	Sí	Ecs	El tipo de servidor backend. Valores válidos: Ecs: instancia ECS Eni: ENI Eci: instancia de contenedor elástico Ip: dirección IP Nota Especifique hasta 40 servidores backend en cada llamada.
Servers.N.ServerIp	String	No	192.168.6.6	La dirección IP del servidor backend. Si el tipo de grupo de servidores es Ip, debe especificar una dirección IP. Nota Especifique hasta 40 servidores backend en cada llamada.
Servers.N.Port	Integer	No	443	El puerto que utiliza el servidor backend. Valores válidos: del 1 al 65535. Una vez habilitado el reenvío de todos los puertos para un grupo de servidores, no es necesario especificar puertos al agregar servidores backend. NLB reenvía el tráfico a los servidores backend según los puertos frontend. Consulte si el reenvío de todos los puertos está habilitado para un grupo de servidores mediante AnyPortEnabled, devuelto por la operación ListServerGroups. Nota Especifique hasta 40 servidores backend en cada llamada.
Servers.N.Weight	Integer	No	100	El peso del servidor backend. Valores válidos: de 0 a 100. Valor predeterminado: 100. Si el peso de un servidor backend se establece en 0, no se reenvían solicitudes a dicho servidor. Nota Especifique hasta 40 servidores backend en cada llamada.
Servers.N.Description	String	No	ECS	La descripción del servidor backend. La descripción debe tener entre 2 y 256 caracteres de longitud, y puede contener letras, dígitos, comas (,), puntos (.), punto y coma (;), barras diagonales (/), arrobas (@), guiones bajos (_) y guiones (-). Nota Especifique hasta 40 servidores backend en cada llamada.
RegionId	String	No	cn-hangzhou	El ID de región de la instancia NLB. Llame a la operación DescribeRegions para consultar la lista de regiones más reciente.
DryRun	Boolean	No	false	Especifica si se debe realizar solo una ejecución de prueba, sin ejecutar la solicitud real. Valores válidos: true: realiza solo una ejecución de prueba. El sistema comprueba la solicitud en busca de posibles problemas, incluidos valores de parámetros faltantes, sintaxis de solicitud incorrecta y límites de servicio. Si la solicitud falla en la ejecución de prueba, se devuelve un mensaje de error. Si la solicitud pasa la ejecución de prueba, se devuelve el código de error `DryRunOperation`. false (predeterminado): realiza una ejecución de prueba y ejecuta la solicitud real. Si la solicitud pasa la ejecución de prueba, se devuelve un código de estado HTTP 2xx y se ejecuta la operación.
ClientToken	String	No	123e4567-e89b-12d3-a456-426655440000	El token de cliente que se utiliza para garantizar la idempotencia de la solicitud. Utilice el cliente para generar el token, pero asegúrese de que sea único entre las diferentes solicitudes. El token solo puede contener caracteres ASCII. Nota Si no especifica este parámetro, el sistema utiliza automáticamente el token de cliente como el ID de solicitud. El ID de solicitud puede ser diferente para cada solicitud.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	54B48E3D-DF70-471B-AA93-08E683A1B45	El ID de la solicitud.
ServerGroupId	String	sgp-atstuj3rtoptyui****	El ID del grupo de servidores.
JobId	String	72dcd26b-f12d-4c27-b3af-18f6aed5****	El ID de la tarea asíncrona.

Ejemplos

Solicitudes de ejemplo

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>

Respuestas exitosas de ejemplo

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 error

Para obtener una lista de códigos de error, visite el Centro de errores de API.