Updated on 2022-01-25 GMT+08:00

Querying Details of a Whitelist

Function

This API is used to query details about a whitelist using its ID.

URI

GET /v2.0/lbaas/whitelists/{whitelist_id}

Table 1 Parameter description

Parameter

Mandatory

Type

Description

whitelist_id

Yes

String

Specifies the whitelist ID.

Request

None

Response

Table 2 Response parameters

Parameter

Type

Description

whitelist

Object

Specifies the whitelist. For details, see Table 3.

Table 3 whitelist parameter description

Parameter

Type

Description

id

String

Specifies the whitelist ID.

tenant_id

String

Specifies the ID of the project where the forwarding rule is used.

The value contains a maximum of 255 characters.

listener_id

String

Specifies the ID of the listener to which the whitelist is added.

enable_whitelist

Boolean

Specifies whether to enable access control.

true: Access control is enabled.

false: Access control is disabled.

whitelist

String

Specifies the IP addresses in the whitelist.

Example Request

  • Example request: Querying details of a whitelist
    GET https://{Endpoint}/v2.0/lbaas/whitelists/09e64049-2ab0-4763-a8c5-f4207875dc3e

Example Response

  • Example response
    { 
        "whitelist": { 
            "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" 
        } 
    }

Status Code

For details, see HTTP Status Codes of Load Balancers.