Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ Elastic Load Balance/ Referencia de la API/ API del balanceador de carga dedicado/ Grupo de servidores de backend/ Actualización de un grupo de servidores backend

Actualización más reciente 2022-11-17 GMT+08:00

Ver PDF

Actualización de un grupo de servidores backend

Función

Esta API se utiliza para actualizar un grupo de servidores backend.

Restricciones

El grupo de servidores backend solo se puede actualizar cuando el estado de aprovisionamiento del equilibrador de carga asociado es ACTIVE.

URI

PUT /v3/{project_id}/elb/pools/{pool_id}

**Tabla 1** Parámetros de path
Parámetro	Obligatorio	Tipo	Descripción
pool_id	Sí	String	Especifica el ID de grupo del servidor backend.
project_id	Sí	String	Especifica el ID del proyecto.

Parámetros de solicitud

**Tabla 2** Parámetros de encabezado de solicitud
Parámetro	Obligatorio	Tipo	Descripción
X-Auth-Token	Sí	String	Especifica el token utilizado para la autenticación IAM.

**Tabla 3** Parámetros de body de solicitud
Parámetro	Obligatorio	Tipo	Descripción
pool	Sí	UpdatePoolOption object	Especifica el grupo de servidores backend.

**Tabla 4** UpdatePoolOption
Parámetro	Obligatorio	Tipo	Descripción
admin_state_up	No	Boolean	Especifica el estado administrativo del grupo de servidores backend. El valor solo se puede actualizar a true. Este parámetro no es compatible. Por favor, no lo use.
description	No	String	Proporciona información adicional sobre el grupo de servidores backend. Mínimo: 0 Máximo: 255
lb_algorithm	No	String	Especifica el algoritmo de equilibrio de carga utilizado por el equilibrador de carga para enrutar las solicitudes a los servidores backend del grupo de servidores backend asociado. El valor puede ser uno de los siguientes: ROUND_ROBIN: petirrojo redondo ponderado LEAST_CONNECTIONS: conexiones mínimas ponderadas SOURCE_IP: hash IP de origen QUIC_CID: ID de conexión Nota: Si el valor es SOURCE_IP, el parámetro de weight no tendrá efecto para los servidores backend. QUIC_CID solo se admite cuando el protocolo del grupo de servidores backend es QUIC. El protocolo QUIC no se admite en la región eu-nl.
name	No	String	Especifica el nombre del grupo del servidor backend. Mínimo: 0 Máximo: 255
session_persistence	No	UpdatePoolSessionPersistenceOption object	Especifica la sesión adhesiva.
slow_start	No	UpdatePoolSlowStartOption object	Especifica los detalles de inicio lento. Después de habilitar el inicio lento, los nuevos servidores backend agregados al grupo de servidores backend se calientan y el número de solicitudes que pueden recibir aumenta linealmente durante la duración de inicio lento configurada. Este parámetro se puede utilizar cuando el protocolo del grupo de servidores backend es HTTP o HTTPS. Se devolverá un error si el protocolo no es HTTP o HTTPS. Este parámetro no está disponible en la región eu-nl. Por favor, no lo use.
member_deletion_protection_enable	No	Boolean	Especifica si se habilitará la protección de eliminación para el equilibrador de carga. true: Habilitar la protección de eliminación. false: Deshabilitar la protección de eliminación. NOTA: Desactive la protección de eliminación de todos sus recursos antes de eliminar su cuenta. Este parámetro no está disponible en la región eu-nl. Por favor, no lo use.
vpc_id	No	String	Especifica el ID de la VPC donde funciona el grupo de servidores backend. Este parámetro solo se puede actualizar cuando vpc_id se deja en blanco. Mínimo: 0 Máximo: 36
type	No	String	Especifica el tipo del grupo de servidores backend. Valores: instance: Se puede agregar cualquier tipo de servidores backend. vpc_id es obligatorio. ip: Solo se pueden agregar servidores backend entre VPC. No se puede especificar vpc_id. "": Se puede agregar cualquier tipo de servidores backend. Nota: Este parámetro solo se puede actualizar cuando el type se deja en blanco.

**Tabla 5** UpdatePoolSessionPersistenceOption
Parámetro	Obligatorio	Tipo	Descripción
cookie_name	No	String	Especifica el nombre de la cookie. El valor puede contener solo letras, dígitos, guiones (-) guiones bajos (_), y puntos (.). Nota: Este parámetro solo tendrá efecto cuando type se establece en APP_COOKIE.
type	No	String	Especifica el tipo de sesión adhesiva. El valor puede ser SOURCE_IP, HTTP_COOKIE, o APP_COOKIE.Nota: Si el protocolo del grupo de servidores backend es TCP o UDP, solo SOURCE_IP tiene efecto. Para balanceadores de carga dedicados, si el protocolo del grupo de servidores backend es HTTP o HTTPS, el valor solo puede ser HTTP_COOKIE.
persistence_timeout	No	Integer	Especifica la duración de la pegajosidad, en minutos. Este parámetro no tendrá efecto cuando type se establezca en APP_COOKIE. Si el protocolo del grupo de servidores backend es TCP, UDP o QUIC, el valor varía de 1 a 60, y el valor predeterminado es 1. Si el protocolo del grupo de servidores backend es HTTP o HTTPS, el valor varía de 1 a 1440, y el valor por defecto es 1440. El protocolo QUIC no se admite en la región eu-nl.

**Tabla 6** UpdatePoolSlowStartOption
Parámetro	Obligatorio	Tipo	Descripción
enable	No	Boolean	Especifica si se habilitará el inicio lento. true: Activar el inicio lento. false: Deshabilitar el inicio lento.
duration	No	Integer	Especifica la duración de inicio lento, en segundos. El valor oscila entre 30 y 1200, y el valor predeterminado es 30. Mínimo: 30 Máximo: 1200

Parámetros de respuesta

Código de estado: 200

**Tabla 7** Parámetros de body de respuesta
Parámetro	Tipo	Descripción
request_id	String	Especifica el ID de la solicitud. El valor se genera automáticamente.
pool	Pool object	Especifica el grupo de servidores backend.

**Tabla 8** Pool
Parámetro	Tipo	Descripción
admin_state_up	Boolean	Especifica el estado administrativo del grupo de servidores backend. El valor solo puede ser true. Este parámetro no es compatible. Por favor, no lo use.
description	String	Proporciona información adicional sobre el grupo de servidores backend.
healthmonitor_id	String	Especifica el ID de la comprobación de estado configurada para el grupo de servidores backend.
id	String	Especifica el ID de grupo del servidor backend.
lb_algorithm	String	Especifica el algoritmo de equilibrio de carga utilizado por el equilibrador de carga para enrutar las solicitudes a los servidores backend del grupo de servidores backend asociado. El valor puede ser uno de los siguientes: ROUND_ROBIN: petirrojo redondo ponderado LEAST_CONNECTIONS: conexiones mínimas ponderadas SOURCE_IP: hash IP de origen QUIC_CID: ID de conexión Nota: Si el valor es SOURCE_IP, el parámetro de weight no tendrá efecto para los servidores backend. QUIC_CID solo se admite cuando el protocolo del grupo de servidores backend es QUIC. El protocolo QUIC no se admite en la región eu-nl.
listeners	Array of ListenerRef objects	Especifica los identificadores de los listeners con los que está asociado el grupo de servidores backend.
loadbalancers	Array of LoadBalancerRef objects	Especifica los ID de los equilibradores de carga con los que está asociado el grupo de servidores backend.
members	Array of MemberRef objects	Especifica los ID de los servidores backend del grupo de servidores backend.
name	String	Especifica el nombre del grupo del servidor backend.
project_id	String	Especifica el ID del proyecto.
protocol	String	Especifica el protocolo utilizado por el grupo de servidores backend para recibir solicitudes. El valor puede ser TCP, UDP, HTTP, HTTPS, o QUIC. Si el protocolo del listener es UDP, el protocolo del grupo de servidores backend debe ser UDP. Si el protocolo del listener es TCP, el protocolo del grupo de servidores backend debe ser TCP. Si el protocolo del listener es HTTP, el protocolo del grupo de servidores backend debe ser HTTP. Si el protocolo del listener es HTTPS, el protocolo del grupo de servidores backend puede ser HTTP o HTTPS. Si el protocolo del listener es TERMINATED_HTTPS, el protocolo del grupo de servidores backend debe ser HTTP. El protocolo QUIC no se admite en la región eu-nl.
session_persistence	SessionPersistence object	Especifica la sesión adhesiva.
ip_version	String	Especifica la versión de la dirección IP admitida por el grupo de servidores backend. IPv6 no es compatible. Solo se devolverá v4.
slow_start	SlowStart object	Especifica los detalles de inicio lento. Después de habilitar el inicio lento, los nuevos servidores backend agregados al grupo de servidores backend se calientan y el número de solicitudes que pueden recibir aumenta linealmente durante la duración de inicio lento configurada. Este parámetro se puede utilizar cuando el protocolo del grupo de servidores backend es HTTP o HTTPS. Se devolverá un error si el protocolo no es HTTP o HTTPS. Este parámetro no está disponible en la región eu-nl. Por favor, no lo use.
member_deletion_protection_enable	Boolean	Especifica si se habilitará la protección de eliminación. true: Habilitar la protección de eliminación. false: Deshabilitar la protección de eliminación. NOTA: Desactive la protección de eliminación de todos sus recursos antes de eliminar su cuenta. Este parámetro no está disponible en la región eu-nl. Por favor, no lo use.
created_at	String	Especifica la hora a la que se creó un grupo de servidores backend. El formato es yyyy-MM-dd'T'HH:mm:ss'Z' (hora UTC). Este es un campo nuevo en esta versión, y no se devolverá para los recursos asociados con balanceadores de carga dedicados existentes y para los recursos asociados con balanceadores de carga compartidos existentes y nuevos.
updated_at	String	Especifica la hora a la que se actualizó un grupo de servidores backend. El formato es yyyy-MM-dd'T'HH:mm:ss'Z' (hora UTC). Este es un campo nuevo en esta versión, y no se devolverá para los recursos asociados con balanceadores de carga dedicados existentes y para los recursos asociados con balanceadores de carga compartidos existentes y nuevos.
vpc_id	String	Especifica el ID de la VPC donde funciona el grupo de servidores backend.
type	String	Especifica el tipo del grupo de servidores backend. Valores: instance: Se puede agregar cualquier tipo de servidores backend. vpc_id es obligatorio. ip: Solo se pueden agregar servidores backend entre VPC. No se puede especificar vpc_id. "": Se puede agregar cualquier tipo de servidores backend.

**Tabla 9** ListenerRef
Parámetro	Tipo	Descripción
id	String	Especifica el ID del listener.

**Tabla 10** LoadBalancerRef
Parámetro	Tipo	Descripción
id	String	Especifica el ID del equilibrador de carga.

**Tabla 11** MemberRef
Parámetro	Tipo	Descripción
id	String	Especifica el ID del servidor backend.

**Tabla 12** SessionPersistence
Parámetro	Tipo	Descripción
cookie_name	String	Especifica el nombre de la cookie. El valor puede contener solo letras, dígitos, guiones (-) guiones bajos (_), y puntos (.). Nota: Este parámetro solo tendrá efecto cuando type se establece en APP_COOKIE.
type	String	Especifica el tipo de sesión adhesiva. El valor puede ser SOURCE_IP, HTTP_COOKIE, o APP_COOKIE.Nota: Si el protocolo del grupo de servidores backend es TCP o UDP, solo SOURCE_IP tiene efecto. Para balanceadores de carga dedicados, si el protocolo del grupo de servidores backend es HTTP o HTTPS, el valor solo puede ser HTTP_COOKIE.
persistence_timeout	Integer	Especifica la duración de la pegajosidad, en minutos. Este parámetro no tendrá efecto cuando type se establezca en APP_COOKIE. Si el protocolo del grupo de servidores backend es TCP, UDP o QUIC, el valor varía de 1 a 60, y el valor predeterminado es 1. Si el protocolo del grupo de servidores backend es HTTP o HTTPS, el valor varía de 1 a 1440, y el valor por defecto es 1440. El protocolo QUIC no se admite en la región eu-nl.

**Tabla 13** SlowStart
Parámetro	Tipo	Descripción
enable	Boolean	Especifica si se habilitará el inicio lento. true: Activar el inicio lento. false: Deshabilitar el inicio lento. Predeterminado: false
duration	Integer	Especifica la duración de inicio lento, en segundos. El valor oscila entre 30 y 1200, y el valor predeterminado es 30. Mínimo: 30 Máximo: 1200 Predeterminado: 30

Solicitudes de ejemplo

PUT https://{ELB_Endpoint}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/pools/36ce7086-a496-4666-9064-5ba0e6840c75

{
  "pool" : {
    "name" : "My pool.",
    "description" : "My pool update",
    "lb_algorithm" : "LEAST_CONNECTIONS"
  }
}

Ejemplo de respuestas

Código de estado: 200

Solicitud exitosa.

{
  "pool" : {
    "type" : "",
    "vpc_id" : "",
    "lb_algorithm" : "LEAST_CONNECTIONS",
    "protocol" : "TCP",
    "description" : "My pool update",
    "admin_state_up" : true,
    "member_deletion_protection_enable" : false,
    "loadbalancers" : [ {
      "id" : "098b2f68-af1c-41a9-8efd-69958722af62"
    } ],
    "project_id" : "99a3fff0d03c428eac3678da6a7d0f24",
    "session_persistence" : null,
    "healthmonitor_id" : null,
    "listeners" : [ {
      "id" : "0b11747a-b139-492f-9692-2df0b1c87193"
    }, {
      "id" : "61942790-2367-482a-8b0e-93840ea2a1c6"
    }, {
      "id" : "fd8f954c-f0f8-4d39-bb1d-41637cd6b1be"
    } ],
    "members" : [ ],
    "id" : "36ce7086-a496-4666-9064-5ba0e6840c75",
    "name" : "My pool.",
    "ip_version" : "dualstack"
  },
  "request_id" : "8f40128b-c72b-4b64-986a-f7e2c633d75f"
}