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/ Consulta de detalles de un grupo de servidores backend

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

Ver PDF

Consulta de detalles de un grupo de servidores backend

Función

Esta API se utiliza para ver los detalles de un grupo de servidores backend.

URI

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

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

Parámetros de solicitud

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

Parámetros de respuesta

Código de estado: 200

**Tabla 3** Parámetros del cuerpo 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 4** 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 balanceador 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: round robin 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 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 ID de los oyentes con los que está asociado el grupo de servidores backend.
loadbalancers	Array of LoadBalancerRef objects	Especifica los ID de los balanceadores 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 oyente es UDP, el protocolo del grupo de servidores backend debe ser UDP. Si el protocolo del oyente es TCP, el protocolo del grupo de servidores backend debe ser TCP. Si el protocolo del oyente es HTTP, el protocolo del grupo de servidores backend debe ser HTTP. Si el protocolo del oyente es HTTPS, el protocolo del grupo de servidores backend puede ser HTTP o HTTPS. Si el protocolo del oyente 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: Desactivar 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 5** ListenerRef
Parámetro	Tipo	Descripción
id	String	Especifica el ID de oyente.

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

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

**Tabla 8** 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 9** SlowStart
Parámetro	Tipo	Descripción
enable	Boolean	Especifica si se habilitará el inicio lento. true: Activa el inicio lento. false: Desactiva el inicio lento. Predeterminado: false
duration	Integer	Especifica la duración de inicio lento, en segundos. El valor varía de 30 a 1200, y el valor predeterminado es 30. Mínimo: 30 Máximo: 1200 Predeterminado: 30

Ejemplo de las solicitudes

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

Ejemplo de las respuestas

Código de estado: 200

Solicitud exitosa.

{
  "pool" : {
    "type" : "",
    "vpc_id" : "",
    "lb_algorithm" : "LEAST_CONNECTIONS",
    "protocol" : "TCP",
    "description" : "My pool",
    "admin_state_up" : true,
    "member_deletion_protection_enable" : false,
    "loadbalancers" : [ {
      "id" : "098b2f68-af1c-41a9-8efd-69958722af62"
    } ],
    "project_id" : "99a3fff0d03c428eac3678da6a7d0f24",
    "session_persistence" : "",
    "healthmonitor_id" : "",
    "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" : "c1a60da2-1ec7-4a1c-b4cc-73e1a57b368e"
}