Adding a Blacklist or Whitelist Rule

Function Description

This API is used to add a blacklist or whitelist rule.

URI

URI format
POST /v1/{project_id}/waf/policy/{policy_id}/whiteblackip

Parameter description

**Table 1** Path parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Specifies the project ID.
policy_id	Yes	String	Specifies the policy ID.

Request

Request parameters

**Table 2** Parameter description
Parameter	Mandatory	Type	Description
addr	Yes	String	Specifies the public IP address or range (IP address and subnet mask). For example, X.X.0.125 or X.X.6.0/24.
white	No	Integer	Specifies the IP address type. 1: Whitelist 0: Blacklist If you do not configure the white parameter, the value is Blacklist by default.

Response

Response parameters

**Table 3** Parameter description
Parameter	Type	Description
id	String	Specifies the ID of a blacklist or whitelist rule.
policy_id	String	Specifies the policy ID.
addr	String	Specifies the public IP address or range (IP address and subnet mask). For example, X.X.0.125 or X.X.6.0/24.
white	Integer	Specifies the IP address type. 1: Whitelist 0: Blacklist If you do not configure the white parameter, the value is Blacklist by default.
timestamp	Long	Specifies the time when a blacklist or whitelist rule is added.

Examples

X.X.0.125 is used as an example.

Request example

{
    "addr": "X.X.0.125",
    "white": 1
}

Response example

{
  "id": "44d887434169475794b2717438f7fa78",
  "policy_id": "ertr45c0f96784ec8abd8ba61a98064ef",
  "addr": "X.X.0.125",
  "white": 1,
  "timestamp": 1499817600
}