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
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ámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
marker |
No |
String |
Especifica el identificador del último registro de la página anterior. Nota:
|
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:
Nota:
|
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:
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.
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:
|
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
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
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. |
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. |
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.
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.
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:
|
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:
|
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. |
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:
|
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.