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.
Actualización más reciente 2022-11-17 GMT+08:00

Consulta de servidores backend

Función

Esta API se utiliza para consultar todos los servidores backend.

Restricciones

Esta API tiene las siguientes restricciones:

  • Los parámetros marker, limit, y page_reverse se utilizan para la consulta de paginación.
  • Los parámetros marker y page_reverse solo tienen efecto cuando se usan junto con el parámetro limit.

URI

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

Tabla 1 Parámetros de path

Parámetro

Obligatorio

Tipo

Descripción

project_id

String

Especifica el ID del proyecto.

pool_id

String

Especifica el ID del grupo de servidores backend.

Tabla 2 Parámetros de Query

Parámetro

Obligatorio

Tipo

Descripción

marker

No

String

Especifica el identificador del último registro de la página anterior.

Nota:

  • Este parámetro debe usarse junto con limit.
  • Si no se especifica este parámetro, se consultará la primera página.
  • Este parámetro no se puede dejar en blanco ni establecer un ID no válido.

limit

No

Integer

Especifica el número de registros de cada página.

Mínimo: 0

Máximo: 2000

Predeterminado: 2000

page_reverse

No

Boolean

Especifica si se va a utilizar la consulta inversa. Valores:

  • true: consulta la página anterior.
  • false (predeterminado): consulta la página siguiente.

Nota:

  • Este parámetro debe usarse junto con limit.
  • Si page_reverse se establece en true y desea consultar la página anterior, establezca el valor de marker en el valor de previous_marker.

name

No

Array

Especifica el nombre del servidor backend.

Se pueden consultar varios nombres con el formato name=xxx&name=xxx.

weight

No

Array

Especifica el peso del servidor backend. Las solicitudes se enrutan a los servidores backend en el mismo grupo de servidores backend según sus pesos.

El valor varía de 0 a 100. Cuanto mayor sea el peso, mayor será la proporción de solicitudes que recibe el servidor backend. Si el peso se establece en 0, el servidor backend no aceptará nuevas solicitudes.

Se pueden consultar varios pesos en el formato de weight=xxx&weight=xxx.

admin_state_up

No

Boolean

Especifica el estado administrativo del servidor backend. El valor puede ser true o false.

Aunque este parámetro se puede utilizar en las API para crear y actualizar servidores backend, su valor real depende de si existen servidores en la nube. Si existen servidores en la nube, el valor es true. De lo contrario, el valor es false.

subnet_cidr_id

No

Array

Especifica el ID de la subred IPv4 o IPv6 donde reside el servidor backend.

Se pueden consultar varios ID en el formato de subnet_cidr_id=xxx&subnet_cidr_id=xxx.

IPv6 no es compatible. No establezca el valor en el ID de una subred IPv6.

address

No

Array

Especifica la dirección IP enlazada al servidor backend.

Se pueden consultar varias direcciones IP en el formato address=xxx&address=xxx.

IPv6 no es compatible. No establezca el valor en una dirección IPv6.

protocol_port

No

Array

Especifica el puerto utilizado por el servidor backend para recibir solicitudes.

Se pueden consultar varios puertos en el formato de protocol_port=xxx&protocol_port=xxx.

id

No

Array

Especifica el ID del servidor backend.

Se pueden consultar múltiples ID en el formato id=xxx&id=xxx.

operating_status

No

Array

Especifica el estado de mantenimiento del servidor backend. El valor puede ser uno de los siguientes:

  • ONLINE: El servidor backend se está ejecutando normalmente.
  • NO_MONITOR: No se configura ninguna comprobación de estado para el grupo de servidores backend al que pertenece el servidor backend.
  • OFFLINE: El servidor en la nube utilizado como servidor backend se detiene o no existe.

Se pueden consultar varios estados operativos en el formato de operating_status=xxx&operating_status=xxx.

enterprise_project_id

No

Array

Especifica el ID del proyecto de empresa.

  • Si no se pasa este parámetro, se consultan los recursos del proyecto de empresa predeterminado y se realiza la autenticación en función del proyecto de empresa predeterminado.
  • Si se pasa este parámetro, su valor puede ser el ID de un proyecto de empresa existente (se requieren recursos en el proyecto de empresa específico) o all_granted_eps (se consultan recursos en todos los proyectos de empresa).

Se pueden consultar varios identificadores en el formato enterprise_project_id=xxx&enterprise_project_id=xxx.

Este parámetro no es compatible. Por favor, no lo use.

ip_version

No

Array

Especifica la versión IP admitida por el servidor backend. El valor puede ser v4 (IPv4) o v6 (IPv6).

member_type

No

Array

Especifica el tipo del servidor backend. Valores:

  • ip: servidores backend entre VPC
  • instance: ECS utilizados como servidores backend Se pueden consultar varios valores en el formato member_type=xxx&member_type=xxx.

instance_id

No

Array

Especifica el ID de la instancia asociada al servidor backend. Si este parámetro se deja en blanco, el servidor backend no es un ECS. Puede ser una dirección IP.

Se pueden consultar múltiples identificadores de instancia en el formato de instance_id=xxx&instance_id=xxx.

Parámetros de solicitud

Tabla 3 Parámetros de encabezado de solicitud

Parámetro

Obligatorio

Tipo

Descripción

X-Auth-Token

String

Especifica el token utilizado para la autenticación IAM.

Parámetros de respuesta

Código de estado: 200

Tabla 4 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.

page_info

PageInfo object

Muestra información de paginación.

members

Array of Member objects

Enumera los servidores backend.

Tabla 5 PageInfo

Parámetro

Tipo

Descripción

previous_marker

String

Especifica el ID del primer registro del resultado de la consulta de paginación. Establezca este parámetro para consultar la página anterior.

next_marker

String

Especifica el ID del último registro del resultado de la consulta de paginación. Establezca este parámetro para consultar la página siguiente.

current_count

Integer

Especifica el número de registros.

Tabla 6 Member

Parámetro

Tipo

Descripción

id

String

Especifica el ID del servidor backend.

Nota:

El valor de este parámetro no es el ID del servidor, sino un ID generado automáticamente para el servidor backend que ya se ha asociado con el balanceador de carga.

name

String

Especifica el nombre del servidor backend.

project_id

String

Especifica el ID del proyecto del servidor backend.

pool_id

String

Especifica el ID del grupo de servidores backend al que pertenece el servidor backend.

Este parámetro solo se muestra en la API para consultar todos los servidores backend (GET /v3/{project_id}/elb/members).

Este parámetro no es compatible. Por favor, no lo use.

admin_state_up

Boolean

Especifica el estado administrativo del servidor backend. El valor puede ser true o false.

Aunque este parámetro se puede utilizar en las API para crear y actualizar servidores backend, su valor real depende de si existen servidores en la nube. Si existen servidores en la nube, el valor es true. De lo contrario, el valor es false.

subnet_cidr_id

String

Especifica el ID de la subred IPv4 o IPv6 donde reside el servidor backend.

Este parámetro puede dejarse en blanco, lo que indica que el backend cruzado de VPC ha sido habilitado para el balanceador de carga. En este caso, las direcciones IP de estos servidores deben ser direcciones IPv4, y el protocolo del grupo de servidores backend debe ser TCP, HTTP o HTTPS.

La subred IPv4 o IPv6 debe estar en la misma VPC que la subred del balanceador de carga.

IPv6 no es compatible. No establezca el valor en el ID de una subred IPv6.

protocol_port

Integer

Especifica el puerto utilizado por el servidor backend para recibir solicitudes.

Mínimo: 1

Máximo: 65535

weight

Integer

Especifica el peso del servidor backend. Las solicitudes se enrutan a los servidores backend en el mismo grupo de servidores backend según sus pesos.

El valor varía de 0 a 100, y el valor predeterminado es 1. Cuanto mayor sea el peso, mayor será la proporción de solicitudes que recibe el servidor backend. Si el peso se establece en 0, el servidor backend no aceptará nuevas solicitudes.

Si lb_algorithm se establece en SOURCE_IP, este parámetro no tendrá efecto.

Mínimo: 0

Máximo: 100

address

String

Especifica la dirección IP privada enlazada al servidor backend.

  • Si subnet_cidr_id se deja en blanco, el backend cross-VPC está habilitado. En este caso, la dirección IP debe ser una dirección IPv4.
  • Si subnet_cidr_id no se deja en blanco, la dirección IP puede ser IPv4 o IPv6. Debe estar en la subred especificada por subnet_cidr_id y solo puede estar enlazada a la NIC principal del servidor backend.

IPv6 no es compatible. No introduzca una dirección IPv6.

ip_version

String

Especifica la versión IP admitida por el servidor backend. El valor puede ser v4 (IPv4) o v6 (IPv6), dependiendo del valor de address devuelto por el sistema.

device_owner

String

Especifica si el servidor backend está asociado a un ECS.

  • Si este parámetro se deja en blanco, el servidor backend no está asociado con un ECS.
  • Si el valor es compute:{az_name}, el servidor backend está asociado con un ECS. {az_name} indica la zona de disponibilidad donde reside el ECS.

Este parámetro no es compatible. Por favor, no lo use.

device_id

String

Especifica el ID del ECS al que está asociado el servidor backend. Si este parámetro se deja en blanco, el servidor backend no está asociado con un ECS.

Este parámetro no es compatible. Por favor, no lo use.

operating_status

String

Especifica el estado del estado del servidor backend si no se especifica listener_id bajo status. El valor puede ser uno de los siguientes:

  • ONLINE: El servidor backend se está ejecutando normalmente.
  • NO_MONITOR: No se configura ninguna comprobación de estado para el grupo de servidores backend al que pertenece el servidor backend.
  • OFFLINE: El servidor en la nube utilizado como servidor backend se detiene o no existe.

status

Array of MemberStatus objects

Especifica el estado de mantenimiento del servidor backend si se especifica listener_id.

loadbalancer_id

String

Especifica el ID del equilibrador de carga al que está asociado el servidor backend.

Este parámetro no es compatible. Por favor, no lo use.

loadbalancers

Array of ResourceID objects

Especifica los ID de los equilibradores de carga asociados con el servidor backend.

Este parámetro no es compatible. Por favor, no lo use.

created_at

String

Especifica la hora en que se agregó un servidor 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 en que se actualizó un servidor 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.

member_type

String

Especifica el tipo del servidor backend. Valores:

  • ip: servidores backend entre VPC
  • instance: ECS utilizados como servidores backend

instance_id

String

Especifica el ID del ECS utilizado como servidor backend. Si este parámetro se deja en blanco, el servidor backend no es un ECS. Por ejemplo, puede ser una dirección IP.

Tabla 7 MemberStatus

Parámetro

Tipo

Descripción

listener_id

String

Especifica el ID del listener.

operating_status

String

Especifica el estado de mantenimiento del servidor backend. El valor puede ser uno de los siguientes:

  • ONLINE: El servidor backend se está ejecutando normalmente.
  • NO_MONITOR: No se configura ninguna comprobación de estado para el grupo de servidores backend al que pertenece el servidor backend.
  • OFFLINE: El servidor en la nube utilizado como servidor backend se detiene o no existe.
Tabla 8 ResourceID

Parámetro

Tipo

Descripción

id

String

Especifica el ID del recurso.

Solicitudes de ejemplo

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

Ejemplo de respuestas

Código de estado: 200

Solicitud exitosa.

{
  "members" : [ {
    "name" : "quark-neutron",
    "weight" : 100,
    "admin_state_up" : false,
    "subnet_cidr_id" : "c09f620e-3492-4429-ac15-445d5dd9ca74",
    "project_id" : "99a3fff0d03c428eac3678da6a7d0f24",
    "address" : "120.10.10.2",
    "protocol_port" : 2100,
    "id" : "0aa23a52-1ac2-4a2d-8dfa-1e11cb26079d",
    "operating_status" : "NO_MONITOR",
    "ip_version" : "v4"
  }, {
    "name" : "quark-neutron",
    "weight" : 100,
    "admin_state_up" : false,
    "subnet_cidr_id" : "c09f620e-3492-4429-ac15-445d5dd9ca74",
    "project_id" : "99a3fff0d03c428eac3678da6a7d0f24",
    "address" : "120.10.10.2",
    "protocol_port" : 2101,
    "id" : "315b928b-39e4-4d5f-8e48-39e9108c1035",
    "operating_status" : "NO_MONITOR",
    "ip_version" : "v4"
  }, {
    "name" : "quark-neutron",
    "weight" : 100,
    "admin_state_up" : false,
    "subnet_cidr_id" : "27e4ab69-a5ed-46c6-921a-5212be19ce87",
    "project_id" : "99a3fff0d03c428eac3678da6a7d0f24",
    "address" : "2001:db8:a583:6a::4",
    "protocol_port" : 2101,
    "id" : "53976f72-d2aa-47f5-baf4-4906ed6b42d6",
    "operating_status" : "NO_MONITOR",
    "ip_version" : "v6"
  } ],
  "page_info" : {
    "previous_marker" : "0aa23a52-1ac2-4a2d-8dfa-1e11cb26079d",
    "current_count" : 3
  },
  "request_id" : "87e29592-7ab8-401a-9bf4-66cf6747eab9"
}

Códigos de estado

Código de estado

Descripción

200

Solicitud exitosa.

Códigos de error

Consulte Códigos de error.