Modifica la configuración de un grupo de servidores de Network Load Balancer (NLB).
Depuración
Parámetros de solicitud
| Parámetro | Tipo | Obligatorio | Ejemplo | Descripción |
| Action | String | Sí | UpdateServerGroupAttribute | La operación que desea ejecutar. Establezca el valor en UpdateServerGroupAttribute. |
| ServerGroupId | String | Sí | sgp-atstuj3rtoptyui**** | El ID del grupo de servidores. |
| ServerGroupName | String | No | NLB_ServerGroup1 | El nuevo nombre del grupo de servidores. El nombre debe tener entre 2 y 128 caracteres de longitud y puede contener letras, dígitos, puntos (.), guiones bajos (_) y guiones (-). Debe comenzar con una letra. |
| ConnectionDrainEnabled | Boolean | No | false | Especifica si se habilita el drenado de conexiones. Valores válidos:
|
| ConnectionDrainTimeout | Integer | No | 10 | El tiempo de espera del drenado de conexiones. Unidad: segundos. Valores válidos: de 10 a 900. |
| Scheduler | String | No | Wrr | El algoritmo de programación. Valores válidos:
|
| PreserveClientIpEnabled | Boolean | No | false | Especifica si se habilita la preservación de la IP del cliente. Valores válidos:
|
| HealthCheckConfig.HealthCheckEnabled | Boolean | No | false | Especifica si se habilita la función de comprobación de estado. Valores válidos:
|
| HealthCheckConfig.HealthCheckType | String | No | TCP | El protocolo utilizado para las comprobaciones de estado. Valores válidos: TCP y HTTP. |
| HealthCheckConfig.HealthCheckConnectPort | Integer | No | 0 | El puerto de backend utilizado para las comprobaciones de estado. Valores válidos: de 0 a 65535. Si establece el valor en 0, se utilizan los puertos de los servidores backend para las comprobaciones de estado. |
| HealthCheckConfig.HealthyThreshold | Integer | No | 3 | El número de veces consecutivas que un servidor backend no saludable debe pasar las comprobaciones de estado antes de considerarse saludable. En este caso, el estado de salud cambia de fail a success. Valores válidos: de 2 a 10. |
| HealthCheckConfig.UnhealthyThreshold | Integer | No | 3 | El número de veces consecutivas que un servidor backend saludable debe fallar las comprobaciones de estado antes de considerarse no saludable. En este caso, el estado de salud cambia de success a fail. Valores válidos: de 2 a 10. |
| HealthCheckConfig.HealthCheckConnectTimeout | Integer | No | 100 | El tiempo máximo de espera de una respuesta de comprobación de estado. Unidad: segundos. Valores válidos: de 1 a 300. |
| HealthCheckConfig.HealthCheckInterval | Integer | No | 5 | El intervalo entre dos comprobaciones de estado consecutivas. Unidad: segundos. Valores válidos: de 5 a 50. |
| HealthCheckConfig.HealthCheckDomain | String | No | $SERVER_IP | El nombre de dominio utilizado para las comprobaciones de estado. Valores válidos:
Nota Este parámetro solo surte efecto cuando establece HealthCheckType en HTTP. |
| HealthCheckConfig.HealthCheckUrl | String | No | /test/index.html | La ruta a la que se envían las solicitudes de comprobación de estado. La ruta debe tener entre 1 y 80 caracteres de longitud y solo puede contener letras, dígitos y los siguientes caracteres especiales: Nota Este parámetro solo surte efecto cuando establece HealthCheckType en HTTP. |
| HealthCheckConfig.HealthCheckHttpCode.N | String | No | http_2xx | Los códigos de estado HTTP que se devuelven para las comprobaciones de estado. Separe varios códigos de estado HTTP con comas (,). Valores válidos: http_2xx (predeterminado), http_3xx, http_4xx y http_5xx. Nota Este parámetro solo surte efecto cuando establece HealthCheckType en HTTP. |
| HealthCheckConfig.HttpCheckMethod | String | No | GET | El método HTTP utilizado para las comprobaciones de estado. Valores válidos: GET y HEAD. Nota Este parámetro solo surte efecto cuando establece HealthCheckType en HTTP. |
| RegionId | String | No | cn-hangzhou | El ID de la región donde se despliega la instancia NLB. Puede llamar a la operación DescribeRegions para consultar las regiones disponibles. |
| DryRun | Boolean | No | false | Especifica si solo se realiza una comprobación previa de la solicitud. Valores válidos:
|
| ClientToken | String | No | 123e4567-e89b-12d3-a456-426655440000 | El token de cliente utilizado para garantizar la idempotencia de la solicitud. Puede utilizar el cliente para generar el valor, pero debe asegurarse de que sea único entre diferentes solicitudes. El token solo puede contener caracteres ASCII. Nota Si no especifica este parámetro, el sistema establece automáticamente ClientToken con el valor de RequestId. RequestId puede ser diferente para cada solicitud de API. |
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=UpdateServerGroupAttribute
&ServerGroupId=sgp-atstuj3rtoptyui****
&ServerGroupName=NLB_ServerGroup1
&ConnectionDrainEnabled=false
&ConnectionDrainTimeout=10
&Scheduler=Wrr
&PreserveClientIpEnabled=false
&HealthCheckConfig={"HealthCheckEnabled":false,"HealthCheckType":"TCP","HealthCheckConnectPort":0,"HealthyThreshold":3,"UnhealthyThreshold":3,"HealthCheckConnectTimeout":100,"HealthCheckInterval":5,"HealthCheckDomain":"$SERVER_IP","HealthCheckUrl":"/test/index.html","HealthCheckHttpCode":["http_2xx"],"HttpCheckMethod":"GET"}
&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
<UpdateServerGroupAttributeResponse>
<RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
<ServerGroupId>sgp-atstuj3rtoptyui****</ServerGroupId>
<JobId>72dcd26b-f12d-4c27-b3af-18f6aed5****</JobId>
</UpdateServerGroupAttributeResponse>
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, consulte Códigos de error del servicio.