Consulta de detalles de un balanceador de carga
Función
Esta API se utiliza para consultar detalles sobre un balanceador de carga mediante su ID. También puede consultar el EIP enlazado al balanceador de carga basándose en el valor de vip_port_id.
URI
GET /v2.0/lbaas/loadbalancers/{loadbalancer_id}
Parámetro |
Obligatorio |
Tipo |
Descripción |
---|---|---|---|
loadbalancer_id |
Sí |
String |
Especifica el ID del balanceador de carga. |
Solicitud
No hay
Respuesta
Parámetro |
Tipo |
Descripción |
---|---|---|
loadbalancer |
Object |
Especifica el balanceador de carga. Para más detalles, consulte Tabla 3. |
Parámetro |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el ID del balanceador de carga. |
project_id |
String |
Especifica el ID del proyecto al que pertenece el balanceador de carga. Este parámetro tiene el mismo significado que tenant_id. |
tenant_id |
String |
Especifica el ID del proyecto en el que se utiliza el balanceador de carga. El valor contiene un máximo de 255 caracteres. |
name |
String |
Especifica el nombre del balanceador de carga. El valor contiene un máximo de 255 caracteres. |
description |
String |
Proporciona información adicional sobre el balanceador de carga. El valor contiene un máximo de 255 caracteres. |
vip_subnet_id |
String |
Especifica el ID de red IPv4 de la subred en la que funciona el balanceador de carga. |
vip_port_id |
String |
Especifica el ID del puerto enlazado a la dirección IP privada del balanceador de carga. Cuando se crea un balanceador de carga, el sistema crea automáticamente un puerto y lo asocia a un grupo de seguridad. Sin embargo, el grupo de seguridad no tendrá efecto. |
provider |
String |
Especifica el proveedor del balanceador de carga. |
vip_address |
String |
Especifica la dirección IP privada del balanceador de carga. El valor incluye un máximo de 64 caracteres. |
listeners |
Array |
Muestra los ID de oyentes agregados al balanceador de carga. Para más detalles, consulte Tabla 5. |
pools |
Array |
Muestra los ID de los grupos de servidores backend asociados con el balanceador de carga. Para más detalles, consulte Tabla 6. |
operating_status |
String |
Este parámetro está reservado, y su valor puede ser ONLINE o FROZEN. Especifica el estado de funcionamiento del balanceador de carga. |
provisioning_status |
String |
Este parámetro está reservado y su valor sólo puede ser ACTIVE. Especifica el estado de aprovisionamiento del balanceador de carga. |
admin_state_up |
Boolean |
Especifica el estado administrativo del balanceador de carga. Este parámetro está reservado. El valor puede ser true o false.
|
tags |
Array |
Enumera las etiquetas de balanceador de carga. |
created_at |
String |
Especifica la hora en que se creó el balanceador de carga. La hora UTC está en formato AAAA-MM-DDTHH:MM:SS. El valor contiene un máximo de 19 caracteres. |
updated_at |
String |
Especifica la hora a la que se actualizó el balanceador de carga. La hora UTC está en formato AAAA-MM-DDTHH:MM:SS. El valor contiene un máximo de 19 caracteres. |
Parámetro |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el ID del oyente asociado. |
Parámetro |
Tipo |
Descripción |
---|---|---|
id |
String |
Especifica el ID del grupo de servidores backend asociado. |
Ejemplo de la solicitud
- Ejemplo de solicitud 1: Consulta de detalles de un balanceador de carga usando su ID
- Ejemplo de solicitud 2: Consulta del EIP enlazado al balanceador de carga. Para obtener más información, consulte Consulta de EIP.
GET https://{EIP_Endpoint}/v1/{project_id}/publicips?port_id={vip_port_id}
vip_port_id es el valor de vip_port_id para el balanceador de carga.
Ejemplo de la respuesta
- Ejemplo de respuesta 1
{ "loadbalancer": { "description": "", "admin_state_up": true, "tenant_id": "1867112d054b427e808cc6096d8193a1", "project_id": "1867112d054b427e808cc6096d8193a1", "provisioning_status": "ACTIVE", "vip_subnet_id": "4f5e8efe-fbbe-405e-b48c-a41202ef697c", "listeners": [ { "id": "09e64049-2ab0-4763-a8c5-f4207875dc3e" } ], "vip_address": "192.168.2.4", "vip_port_id": "c7157e7a-036a-42ca-8474-100be22e3727", "provider": "vlb", "pools": [ { "id": "b7e53dbd-62ab-4505-a280-5c066078a5c9" } ], "id": "3d77894d-2ffe-4411-ac0a-0d57689779b8", "operating_status": "ONLINE", "tags": [], "name": "lb-2", "created_at": "2018-07-25T01:54:13", "updated_at": "2018-07-25T01:54:14" } }
- Ejemplo de respuesta 2
{ "publicips": [ { "id": "6285e7be-fd9f-497c-bc2d-dd0bdea6efe0", "status": "DOWN", "profile": { "user_id": "35f2b308f5d64441a6fa7999fbcd4321", "product_id": "00301-48027-0--0", "region_id": "xxx", "order_id": "xxxxxxxxx" }, "type": "5_bgp", "public_ip_address": "161.xx.xx.9", "private_ip_address": "192.168.2.4", "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c", "create_time": "2015-07-16 04:22:32", "bandwidth_id": "3fa5b383-5a73-4dcb-a314-c6128546d855", "bandwidth_share_type": "PER", "bandwidth_size": 5, "bandwidth_name": "bandwidth-test", "enterprise_project_id":"b261ac1f-2489-4bc7-b31b-c33c3346a439", "ip_version": 4, "port_id": "c7157e7a-036a-42ca-8474-100be22e3727" } ] }
public_ip_address indica el EIP enlazado al balanceador de carga.
Código de estado
Para más detalles, consulte Códigos de estado.