Todos los productos
Search
Centro de documentos

:UpdateServerGroupAttribute

Última actualización: Sep 03, 2026

Modifica la configuración de un grupo de servidores de Network Load Balancer (NLB).

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que llame a 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ámetroTipoObligatorioEjemploDescripción
ActionStringSíUpdateServerGroupAttribute

La operación que desea ejecutar. Establezca el valor en UpdateServerGroupAttribute.

ServerGroupIdStringSísgp-atstuj3rtoptyui****

El ID del grupo de servidores.

ServerGroupNameStringNoNLB_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.

ConnectionDrainEnabledBooleanNofalse

Especifica si se habilita el drenado de conexiones. Valores válidos:

  • true: habilita el drenado de conexiones.
  • false: deshabilita el drenado de conexiones.
ConnectionDrainTimeoutIntegerNo10

El tiempo de espera del drenado de conexiones. Unidad: segundos. Valores válidos: de 10 a 900.

SchedulerStringNoWrr

El algoritmo de programación. Valores válidos:

  • Wrr: los servidores backend con pesos más altos reciben más solicitudes que aquellos con pesos más bajos.
  • rr: las solicitudes se reenvían a los servidores backend en secuencia.
  • sch: las solicitudes de la misma dirección IP de origen se reenvían al mismo servidor backend.
  • tch: se utiliza hash de cuatro elementos. Este valor especifica un hash consistente basado en cuatro factores: dirección IP de origen, dirección IP de destino, puerto de origen y puerto de destino. Las solicitudes con la misma información en estos cuatro factores se reenvían al mismo servidor backend.
  • qch: las solicitudes con el mismo ID de QUIC se reenvían al mismo servidor backend.
PreserveClientIpEnabledBooleanNofalse

Especifica si se habilita la preservación de la IP del cliente. Valores válidos:

  • true: habilita la preservación de la IP del cliente.
  • false: deshabilita la preservación de la IP del cliente.
HealthCheckConfig.HealthCheckEnabledBooleanNofalse

Especifica si se habilita la función de comprobación de estado. Valores válidos:

  • true: habilita la función de comprobación de estado.
  • false: deshabilita la función de comprobación de estado.
HealthCheckConfig.HealthCheckTypeStringNoTCP

El protocolo utilizado para las comprobaciones de estado. Valores válidos: TCP y HTTP.

HealthCheckConfig.HealthCheckConnectPortIntegerNo0

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.HealthyThresholdIntegerNo3

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.UnhealthyThresholdIntegerNo3

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.HealthCheckConnectTimeoutIntegerNo100

El tiempo máximo de espera de una respuesta de comprobación de estado. Unidad: segundos. Valores válidos: de 1 a 300.

HealthCheckConfig.HealthCheckIntervalIntegerNo5

El intervalo entre dos comprobaciones de estado consecutivas. Unidad: segundos.

Valores válidos: de 5 a 50.

HealthCheckConfig.HealthCheckDomainStringNo$SERVER_IP

El nombre de dominio utilizado para las comprobaciones de estado. Valores válidos:

  • $SERVER_IP: la dirección IP privada de un servidor backend.
  • domain: un nombre de dominio específico. Debe tener entre 1 y 80 caracteres de longitud y puede contener letras minúsculas, dígitos, guiones (-) y puntos (.).
Nota Este parámetro solo surte efecto cuando establece HealthCheckType en HTTP.
HealthCheckConfig.HealthCheckUrlStringNo/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: - / . % ? # & =. También puede contener los siguientes caracteres extendidos: _ ; ~ ! ( ) * [ ] @ $ ^ : ' , +. Debe comenzar con una barra diagonal (/).

Nota Este parámetro solo surte efecto cuando establece HealthCheckType en HTTP.
HealthCheckConfig.HealthCheckHttpCode.NStringNohttp_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.HttpCheckMethodStringNoGET

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.
RegionIdStringNocn-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.

DryRunBooleanNofalse

Especifica si solo se realiza una comprobación previa de la solicitud. Valores válidos:

  • true: comprueba la solicitud sin ejecutar la operación UpdateServerGroupAttribute. El sistema verifica los parámetros obligatorios, la sintaxis de la solicitud y los límites. Si la solicitud no pasa la comprobación, se devuelve un mensaje de error. Si la solicitud pasa la comprobación, se devuelve el código de error DryRunOperation.
  • false (predeterminado): envía la solicitud. Si la solicitud pasa la comprobación, se devuelve un código de estado HTTP 2xx y se ejecuta la operación UpdateServerGroupAttribute.
ClientTokenStringNo123e4567-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.