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 de Balanceador de carga compartido/ Balanceador de carga/ Consulta del árbol de estado de un balanceador de carga

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

Ver PDF

Consulta del árbol de estado de un balanceador de carga

Función

Esta API se utiliza para consultar el árbol de estado de un balanceador de carga. Puede utilizar esta API para consultar detalles sobre los oyentes asociados, grupos de servidores backend, servidores backend, comprobaciones de estado, políticas de reenvío y reglas de reenvío, lo que le ayudará a comprender la topología de los recursos asociados con el balanceador de carga.

URI

GET /v2/{project_id}/elb/loadbalancers/{loadbalancer_id}/statuses

**Tabla 1** Descripción del parámetro
Parámetro	Obligatorio	Tipo	Descripción
project_id	Sí	String	Especifica el ID del proyecto.
loadbalancer_id	Sí	String	Especifica el ID del balanceador de carga.

Solicitud

No hay

Respuesta

**Tabla 2** Descripción del parámetro
Parámetro	Tipo	Descripción
statuses	Statuses object	Especifica el árbol de estado de un balanceador de carga. Para más detalles, consulte Tabla 3.

**Tabla 3** Descripción del parámetro **statuses**
Parámetro	Tipo	Descripción
loadbalancer	Loadbalancer object	Especifica el balanceador de carga. Para más detalles, consulte Tabla 4.

**Tabla 4** Descripción de parámetro **loadbalancer**
Parámetro	Tipo	Descripción
id	String	Especifica el ID del balanceador de carga.
name	String	Especifica el nombre del balanceador de carga. El valor contiene un máximo de 255 caracteres.
listeners	Array of Listeners objects	Enumera los oyentes agregados al balanceador de carga. Para obtener más información sobre este parámetro, consulte Tabla 5.
pools	Array of Pools objects	Muestra los grupos de servidores backend asociados con el balanceador de carga. Para obtener más información sobre este parámetro, consulte Tabla 6.
operating_status	String	Este campo está reservado. Especifica el estado de funcionamiento del balanceador de carga. El valor puede ser uno de los siguientes: ONLINE (predeterminado): El balanceador de carga se está ejecutando normalmente. DEGRADED: Este estado se muestra solo cuando provisioning_status de una política de reenvío o regla de reenvío agregada a un oyente del balanceador de carga se establece en ERROR y se llama a la API para consultar el árbol de estado del balanceador de carga. DISABLED: Este estado solo se muestra cuando admin_state_up del balanceador de carga se establece en false y se llama a la API para consultar el árbol de estado del balanceador de carga. FROZEN: El balanceador de carga está congelado.
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.

**Tabla 5** Descripción del parámetro **listeners**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de oyente.
name	String	Especifica el nombre de oyente.
l7policies	Array of l7policies objects	Muestra las políticas de reenvío asociadas. Para obtener más información sobre este parámetro, consulte Tabla 9.
pools	Array of Pools objects	Enumera los grupos de servidores backend asociados con el oyente. Para obtener más información sobre este parámetro, consulte Tabla 6.
operating_status	String	Este parámetro está reservado, y su valor solo puede ser ONLINE. Especifica el estado de funcionamiento del oyente.
provisioning_status	String	Este parámetro está reservado y su valor sólo puede ser ACTIVE. Especifica el estado de aprovisionamiento del oyente.

**Tabla 6** Descripción del parámetro **pools**
Parámetro	Tipo	Descripción
id	String	Especifica el ID del grupo de servidores backend.
name	String	Especifica el nombre del grupo de servidores backend.
healthmonitor	Healthmonitor object	Proporciona detalles de comprobación de estado del grupo de servidores backend. Para obtener más información sobre este parámetro, consulte Tabla 7.
members	Array of Members objects	Muestra los miembros contenidos en el grupo de servidores backend. Para obtener más información sobre este parámetro, consulte Tabla 8.
operating_status	String	Este parámetro está reservado, y su valor solo puede ser ONLINE. Especifica el estado operativo del grupo de servidores backend.
provisioning_status	String	Este parámetro está reservado y su valor sólo puede ser ACTIVE. Especifica el estado de aprovisionamiento del grupo de servidores backend.

**Tabla 7** Descripción de parámetro **healthmonitor**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de comprobación de estado.
name	String	Especifica el nombre de la comprobación de estado.
type	String	Especifica el protocolo de comprobación de estado. El valor puede ser UDP_CONNECT, TCP o HTTP.
provisioning_status	String	Este parámetro está reservado y su valor sólo puede ser ACTIVE. Especifica el estado de aprovisionamiento de la comprobación de estado.

**Tabla 8** Descripción del parámetro **members**
Parámetro	Tipo	Descripción
id	String	Especifica el ID del servidor backend.
address	String	Especifica la dirección IP privada del servidor backend, por ejemplo, 192.168.3.11.
protocol_port	Integer	Especifica el puerto utilizado por el servidor backend. El número de puerto va de 0 a 65535.
operating_status	String	Este parámetro está reservado. Especifica el estado operativo 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. DISABLED: El servidor backend no está disponible. Este estado solo se muestra cuando admin_state_up del servidor backend, o el grupo de servidores backend al que pertenece, o el balanceador de carga asociado se establece en false y se llama a la API para consultar el árbol de estado del balanceador de carga. OFFLINE: El servidor en la nube utilizado como servidor backend se detiene o no existe. NOTA: Cuando admin_state_up se establece en false y operating_status se establece en OFFLINE para un servidor backend, DISABLED se devuelve para operating_status del servidor backend en la respuesta de esta API.
provisioning_status	String	Este parámetro está reservado y su valor sólo puede ser ACTIVE. Especifica el estado de aprovisionamiento del servidor backend.

**Tabla 9** Descripción del parámetro **l7policies**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de política de reenvío.
name	String	Especifica el nombre de la política de reenvío.
rules	Array of Rules objects	Lists the forwarding rules of the forwarding policy. Para obtener más información sobre este parámetro, consulte Tabla 10.
action	String	Especifica si las solicitudes se reenvían a otro grupo de servidores backend o se redirigen a un HTTPS oyente. El valor puede ser REDIRECT_TO_POOL o REDIRECT_TO_LISTENER. REDIRECT_TO_POOL: Las solicitudes se reenvían a otro grupo de servidores backend. REDIRECT_TO_LISTENER: Las solicitudes se redirigen a un oyente HTTPS.
provisioning_status	String	Este parámetro está reservado. Especifica el estado de aprovisionamiento de la política de reenvío. El valor puede ser uno de los siguientes: ACTIVE (predeterminado): La política de reenvío es normal. ERROR: Otra política de reenvío del mismo oyente tiene la misma regla de reenvío.

**Tabla 10** Descripción del parámetro **rules**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de regla de reenvío.
type	String	Especifica el tipo de coincidencia de una regla de reenvío. El valor puede ser PATH o HOST_NAME. PATH: coincide con la ruta de acceso en la solicitud. HOST_NAME: coincide con el nombre de dominio en la solicitud.
provisioning_status	String	Este parámetro está reservado. Especifica el estado de aprovisionamiento de la regla de reenvío. El valor puede ser uno de los siguientes: ACTIVE (predeterminado): La regla de reenvío es normal. ERROR: Otra política de reenvío del mismo oyente tiene la misma regla de reenvío.

Ejemplo de la solicitud

GET https://{Endpoint}/v2/145483a5107745e9b3d80f956713e6a3/elb/loadbalancers/38278031-cfca-44be-81be-a412f618773b/statuses

Ejemplo de la respuesta

{
    "statuses": {
        "loadbalancer": {
            "name": "lb-jy",
            "provisioning_status": "ACTIVE",
            "listeners": [
                {
                    "name": "listener-jy-1",
                    "provisioning_status": "ACTIVE",
                    "pools": [
                        {
                            "name": "pool-jy-1",
                            "provisioning_status": "ACTIVE",
                            "healthmonitor": {
                                "type": "TCP",
                                "id": "7422b51a-0ed2-4702-9429-4f88349276c6",
                                "name": "",
                                "provisioning_status": "ACTIVE"
                            },
                            "members": [
                                {
                                    "protocol_port": 80,
                                    "address": "192.168.44.11",
                                    "id": "7bbf7151-0dce-4087-b316-06c7fa17b894",
                                    "operating_status": "ONLINE",
                                    "provisioning_status": "ACTIVE"
                                }
                            ],
                            "id": "c54b3286-2349-4c5c-ade1-e6bb0b26ad18",
                            "operating_status": "ONLINE"
                        }
                    ],
                    "l7policies": [],
                    "id": "eb84c5b4-9bc5-4bee-939d-3900fb05dc7b",
                    "operating_status": "ONLINE"
                }
            ],
            "pools": [
                {
                    "name": "pool-jy-1",
                    "provisioning_status": "ACTIVE",
                    "healthmonitor": {
                        "type": "TCP",
                        "id": "7422b51a-0ed2-4702-9429-4f88349276c6",
                        "name": "",
                        "provisioning_status": "ACTIVE"
                    },
                    "members": [
                        {
                            "protocol_port": 80,
                            "address": "192.168.44.11",
                            "id": "7bbf7151-0dce-4087-b316-06c7fa17b894",
                            "operating_status": "ONLINE",
                            "provisioning_status": "ACTIVE"
                        }
                    ],
                    "id": "c54b3286-2349-4c5c-ade1-e6bb0b26ad18",
                    "operating_status": "ONLINE"
                }
            ],
            "id": "38278031-cfca-44be-81be-a412f618773b",
            "operating_status": "ONLINE"
        }
    }
}