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/ Política de reenvío/ Consulta de políticas de reenvío

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

Ver PDF

Consulta de políticas de reenvío

Función

Esta API se utiliza para consultar todas las políticas de reenvío. Se admite la consulta de filtro y la consulta de paginación. A menos que se especifique lo contrario, se aplica una coincidencia exacta.

URI

GET /v2/{project_id}/elb/l7policies

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

**Tabla 2** Parámetros de consulta
Parámetro	Obligatorio	Tipo	Descripción
marker	No	String	Especifica el ID de la política de reenvío desde la que se inicia la consulta de paginación, es decir, el ID de la última política de reenvío de la página anterior. Este parámetro debe usarse junto con limit.
limit	No	Integer	Especifica el número de políticas de reenvío de cada página. Si este parámetro no está definido, todas las políticas de reenvío se consultan de forma predeterminada.
page_reverse	No	Boolean	Especifica la dirección de la página. El valor puede ser true o false, y el valor predeterminado es false. La última página de la lista solicitada con page_reverse establecido en false no contendrá el enlace "next", y la última página de la lista solicitada con page_reverse establecido en true no contendrá el enlace "anterior". Este parámetro debe usarse junto con limit.
id	No	String	Especifica el ID de política de reenvío.
tenant_id	No	String	Especifica el ID del proyecto en el que se utiliza la política de reenvío. El valor contiene un máximo de 255 caracteres.
project_id	No	String	Especifica el ID del proyecto al que pertenece la política de reenvío. Este parámetro tiene el mismo significado que tenant_id.
name	No	String	Especifica el nombre de la política de reenvío. El valor contiene un máximo de 255 caracteres.
admin_state_up	No	Boolean	Especifica el estado administrativo de la política de reenvío. Este parámetro está reservado y el valor predeterminado es true.
description	No	String	Proporciona información adicional sobre la política de reenvío. El valor contiene un máximo de 255 caracteres.
listener_id	No	String	Especifica el ID del oyente al que se agrega la política de reenvío.
action	No	String	Especifica si las solicitudes se reenvían a otro grupo de servidores backend o se redirigen a un HTTPS oyente. El rango de valores varía dependiendo del protocolo del grupo de servidores backend: REDIRECT_TO_POOL: Las solicitudes se reenvían al grupo de servidores backend especificado por el identificador de redirect_pool_id. REDIRECT_TO_LISTENER: Las solicitudes son redirigidas desde el oyente HTTP especificado por listener_id al oyente HTTPS especificado por redirect_listener_id.
redirect_pool_id	No	String	Especifica el ID del grupo de servidores backend al que se reenvía el tráfico.
redirect_listener_id	No	String	Especifica el ID del oyente al que se redirige el tráfico.
redirect_url	No	String	Especifica la dirección URL a la que se redirige el tráfico. Este parámetro está reservado. El valor contiene un máximo de 255 caracteres.
position	No	Integer	Especifica la prioridad de reenvío. El valor varía de 1 a 100. El valor predeterminado es 100. Este parámetro está reservado.
provisioning_status	No	String	Este parámetro está reservado y su valor sólo puede ser ACTIVE. Especifica el estado de aprovisionamiento de la política de reenvío.
enterprise_project_id	No	String	Especifica el ID del proyecto de empresa. Los proyectos empresariales se utilizan para la autenticación detallada. Si listener_id se pasa, el ID del proyecto de empresa al que pertenece el balanceador de carga se utiliza para la autenticación. Si listener_id no se pasa, el ID del proyecto de empresa al que pertenece la política de reenvío se utiliza para la autenticación. Si no se pasa ni listener_id ni enterprise_project_id, se realiza una autenticación de grano fino. Los permisos elb:loadbalancers:list deben asignarse al grupo de usuarios.

Solicitud

No hay

Respuesta

**Tabla 3** Parámetros de respuesta
Parámetro	Tipo	Descripción
l7policies	Array of L7policies objects	Muestra las políticas de reenvío. Para más detalles, consulte Tabla 4.

**Tabla 4** Descripción del parámetro **l7policy**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de política de reenvío.
tenant_id	String	Especifica el ID del proyecto en el que se utiliza la política de reenvío.
project_id	String	Especifica el ID del proyecto al que pertenece la política de reenvío. Este parámetro tiene el mismo significado que tenant_id.
name	String	Especifica el nombre de la política de reenvío.
admin_state_up	Boolean	Especifica el estado administrativo de la política de reenvío. Este parámetro está reservado. El valor puede ser true o false. true: habilitar false: deshabilitar
description	String	Proporciona información adicional sobre la política de reenvío.
listener_id	String	Especifica el ID del oyente al que se agrega la política de reenvío.
action	String	Especifica si las solicitudes se reenvían a otro grupo de servidores backend o se redirigen a un HTTPS oyente. El rango de valores varía dependiendo del protocolo del grupo de servidores backend: REDIRECT_TO_POOL: Las solicitudes se reenvían al grupo de servidores backend especificado por el identificador de redirect_pool_id. REDIRECT_TO_LISTENER: Las solicitudes son redirigidas desde el oyente HTTP especificado por listener_id al oyente HTTPS especificado por redirect_listener_id.
redirect_pool_id	String	Especifica el ID del grupo de servidores backend al que se reenvía el tráfico.
redirect_listener_id	String	Especifica el ID del oyente al que se redirige el tráfico.
redirect_url	String	Especifica la dirección URL a la que se redirige el tráfico. Este parámetro está reservado.
rules	Array of Rules objects	Muestra las reglas de reenvío de la política de reenvío. Para más detalles, consulte Tabla 7.
position	Integer	Especifica la prioridad de reenvío. El valor varía de 1 a 100. El valor predeterminado es 100. Este parámetro está reservado.
provisioning_status	String	Este parámetro está reservado y su valor sólo puede ser ACTIVE. Especifica el estado de aprovisionamiento de la política de reenvío.

**Tabla 5** Descripción del parámetro **rules**
Parámetro	Tipo	Descripción
id	String	Especifica el ID de la regla de reenvío asociada.

Ejemplo de la solicitud

Ejemplo de solicitud 1: consulta de todas las políticas de reenvío

GET https://{Endpoint}/v2/a31d2bdcf7604c0faaddb058e1e08819/elb/l7policies

Ejemplo de solicitud 2: Consulta de políticas de reenvío a través de las cuales las solicitudes se reenvían al grupo de servidores backend
```
GET https://{Endpoint}/v2/a31d2bdcf7604c0faaddb058e1e08819/elb/l7policies?action=REDIRECT_TO_POOL
```

Ejemplo de la respuesta

Ejemplo de respuesta 1

{
    "l7policies": [
        {
            "redirect_pool_id": "431a03eb-81bb-408e-ae37-7ce19023692b", 
            "redirect_listener_id": null,  
            "description": "", 
            "admin_state_up": true, 
            "rules": [
                {
                    "id": "67d8a8fa-b0dd-4bd4-a85b-671db19b2ef3"
                }, 
                {
                    "id": "f02b3bca-69d2-4335-a3fa-a8054e996213"
                }
            ], 
            "tenant_id": "a31d2bdcf7604c0faaddb058e1e08819",
            "project_id": "a31d2bdcf7604c0faaddb058e1e08819",
            "listener_id": "26058b64-6185-4e06-874e-4bd68b7633d0", 
            "redirect_url": null, 
            "action": "REDIRECT_TO_POOL", 
            "position": 2,
            "provisioning_status": "ACTIVE", 
            "id": "5ae0e1e7-5f0f-47a1-b39f-5d4c428a1586", 
            "name": ""
        }, 
        {
            "redirect_pool_id": "59eebd7b-c68f-4f8a-aa7f-e062e84c0690", 
            "redirect_listener_id": null,  
            "description": "", 
            "admin_state_up": true, 
            "rules": [
                {
                    "id": "f4499f48-de3d-4efe-926d-926aa4d6aaf5"
                }
            ], 
            "tenant_id": "a31d2bdcf7604c0faaddb058e1e08819",
            "project_id": "a31d2bdcf7604c0faaddb058e1e08819",
            "listener_id": "e1310063-00de-4867-ab55-ccac4d9db364", 
            "redirect_url": null, 
            "action": "REDIRECT_TO_POOL", 
            "position": 1, 
            "provisioning_status": "ACTIVE",
            "id": "6cfd9d89-1d7e-4d84-ae1f-a8c5ff126f72", 
            "name": ""
        }
    ]
}

Ejemplo de respuesta 2

{
    "l7policies": [
        {
            "redirect_pool_id": "431a03eb-81bb-408e-ae37-7ce19023692b", 
            "redirect_listener_id": null,  
            "description": "", 
            "admin_state_up": true, 
            "rules": [
                {
                    "id": "67d8a8fa-b0dd-4bd4-a85b-671db19b2ef3"
                }, 
                {
                    "id": "f02b3bca-69d2-4335-a3fa-a8054e996213"
                }
            ], 
            "tenant_id": "a31d2bdcf7604c0faaddb058e1e08819",
            "project_id": "a31d2bdcf7604c0faaddb058e1e08819",
            "listener_id": "26058b64-6185-4e06-874e-4bd68b7633d0", 
            "redirect_url": null, 
            "action": "REDIRECT_TO_POOL", 
            "position": 2,
            "provisioning_status": "ACTIVE", 
            "id": "5ae0e1e7-5f0f-47a1-b39f-5d4c428a1586", 
            "name": ""
        }, 
        {
            "redirect_pool_id": "59eebd7b-c68f-4f8a-aa7f-e062e84c0690", 
            "redirect_listener_id": null,  
            "description": "", 
            "admin_state_up": true, 
            "rules": [
                {
                    "id": "f4499f48-de3d-4efe-926d-926aa4d6aaf5"
                }
            ], 
            "tenant_id": "a31d2bdcf7604c0faaddb058e1e08819",
            "project_id": "a31d2bdcf7604c0faaddb058e1e08819",
            "listener_id": "e1310063-00de-4867-ab55-ccac4d9db364", 
            "redirect_url": null, 
            "action": "REDIRECT_TO_POOL", 
            "position": 1, 
            "provisioning_status": "ACTIVE",
            "id": "6cfd9d89-1d7e-4d84-ae1f-a8c5ff126f72", 
            "name": ""
        }
    ]
}