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 listas blancas

Función

Esta API se utiliza para consultar las listas blancas. Se admite la consulta de filtro y la consulta de paginación. A menos que se especifique lo contrario, se aplica una coincidencia exacta.

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 /v2/{project_id}/elb/whitelists

Tabla 1 Parámetros de ruta

Parámetro

Obligatorio

Tipo

Descripción

project_id

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 lista blanca desde la que se inicia la consulta de paginación, es decir, el ID de la última lista blanca de la página anterior.

Este parámetro debe usarse con limit.

limit

No

Integer

Especifica el número de listas blancas de cada página. Si este parámetro no está definido, todas las listas blancas 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 con limit.

id

No

String

Especifica el ID de la lista blanca.

tenant_id

No

String

Especifica el ID del proyecto en el que se utiliza la lista blanca.

El valor contiene un máximo de 255 caracteres.

listener_id

No

String

Especifica el ID del oyente al que se agrega la lista blanca.

enable_whitelist

No

Boolean

Especifica si se debe habilitar el control de acceso.

true: El control de acceso está habilitado.

false: el control de acceso está deshabilitado.

whitelist

No

String

Especifica las direcciones IP de la lista blanca.

Solicitud

No hay

Respuesta

Tabla 3 Descripción del parámetro

Parámetro

Tipo

Descripción

whitelists

Array of Whitelists objects

Especifica la lista blanca. Para más detalles, consulte Tabla 4.

Tabla 4 Descripción de parámetro whitelists

Parámetro

Tipo

Descripción

id

String

Especifica el ID de la lista blanca.

tenant_id

String

Especifica el ID del proyecto en el que se utiliza la lista blanca.

El valor contiene un máximo de 255 caracteres.

listener_id

String

Especifica el ID del oyente al que se agrega la lista blanca.

enable_whitelist

Boolean

Especifica si se debe habilitar el control de acceso.

true: El control de acceso está habilitado.

false: el control de acceso está deshabilitado.

whitelist

String

Especifica las direcciones IP de la lista blanca.

Ejemplo de la solicitud

  • Ejemplo de solicitud 1: Consultar todas las listas blancas
    GET https://{Endpoint}/v2/eabfefa3fd1740a88a47ad98e132d238/elb/whitelists
  • Ejemplo de solicitud 2: Consultar las listas blancas agregadas a oyente eabfefa3fd1740a88a47ad98e132d230
    GET https://{Endpoint}/v2/eabfefa3fd1740a88a47ad98e132d238/elb/whitelists?listener_id=eabfefa3fd1740a88a47ad98e132d230

Ejemplo de la respuesta

  • Ejemplo de respuesta 1
    { 
        "whitelists": [ 
            { 
                "id": "eabfefa3fd1740a88a47ad98e132d238",  
                "listener_id": "eabfefa3fd1740a88a47ad98e132d238",  
                "tenant_id": "eabfefa3fd1740a88a47ad98e132d238",  
                "enable_whitelist": true,  
                "whitelist": "192.168.11.1,192.168.0.1/24,192.168.201.18/8,100.164.0.1/24" 
            },  
            { 
                "id": "eabfefa3fd1740a88a47ad98e132d326",  
                "listener_id": "eabfefa3fd1740a88a47ad98e132d327",  
                "tenant_id": "eabfefa3fd1740a88a47ad98e132d436",  
                "enable_whitelist": true,  
                "whitelist": "192.168.12.1,192.168.1.1/24,192.168.203.18/8,100.164.5.1/24" 
            } 
        ] 
    }
  • Ejemplo de respuesta 2
    { 
        "whitelists": [ 
            { 
                "id": "eabfefa3fd1740a88a47ad98e132d238",  
                "listener_id": "eabfefa3fd1740a88a47ad98e132d230",  
                "tenant_id": "eabfefa3fd1740a88a47ad98e132d239",  
                "enable_whitelist": true,  
                "whitelist": "192.168.11.1,192.168.0.1/24,192.168.201.18/8,100.164.0.1/24" 
            },  
            { 
                "id": "eabfefa3fd1740a88a47ad98e132d326",  
                "listener_id": "eabfefa3fd1740a88a47ad98e132d327",  
                "tenant_id": "eabfefa3fd1740a88a47ad98e132d439",  
                "enable_whitelist": true,  
                "whitelist": "192.168.12.1,192.168.1.1/24,192.168.203.18/8,100.164.5.1/24" 
            } 
        ] 
    }

Código de estado

Para más detalles, consulte Códigos de estado.