List firewall rules

Fetches firewall rules in a zone. You can filter the results using several optional parameters.

application/json

Body

result

required

Any of

allOf {2}

array[object (filter-rule-response) {8}]

allOf {2}

One of

array[object (filter-rule-response) {8}]

object

action

enum<string>

firewall-rules_components-schemas-action

optional

The action to apply to a matched request. The log action is only available on an Enterprise plan.

Allowed values:

blockchallengejs_challengemanaged_challengeallowlogbypass

Example:

block

description

string

firewall-rules_components-schemas-description

optional

An informative summary of the firewall rule.

<= 500 characters

Example:

Blocks traffic identified during investigation for MIR-31

string

firewall-rules_components-schemas-id

read-onlyoptional

The unique identifier of the firewall rule.

<= 32 characters

Example:

372e67954025e0ba6aaa6d586b9e0b60

paused

boolean

firewall-rules_components-schemas-paused

optional

When true, indicates that the firewall rule is currently paused.

Example:

false

priority

number

firewall-rules_components-schemas-priority

optional

The priority of the rule. Optional value used to define the processing order. A lower number indicates a higher priority. If not provided, rules with a defined priority will be processed before rules without a priority.

>= 0<= 2147483647

Example:

products

array[string]

products

optional

Allowed values:

zoneLockdownuaBlockbichotsecurityLevelrateLimitwaf

ref

string

ref

optional

A short reference tag. Allows you to select related firewall rules.

<= 50 characters

Example:

MIR-31

filter

optional

errors

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

messages

array [object {2}]

messages

required

Example:

[]

code

integer

required

>= 1000

message

string

required

success

enum<boolean>

required

Whether the API call was successful

Allowed value:

true

Example:

true

result_info

object

result_info

optional

count

number

optional

Total number of results for the requested service

Example:

page

number

optional

Current page within paginated list of results

Example:

per_page

number

optional

Number of results per page of results

Example:

total_count

number

optional

Total results available without any search parameters

Example:

2000

Example

{
    "errors": [],
    "messages": [],
    "result": [
        {
            "action": "block",
            "description": "Blocks traffic identified during investigation for MIR-31",
            "id": "372e67954025e0ba6aaa6d586b9e0b60",
            "paused": false,
            "priority": 50,
            "products": [
                "waf"
            ],
            "ref": "MIR-31",
            "filter": {
                "description": "Restrict access from these browsers on this address range.",
                "expression": "(http.request.uri.path ~ \".*wp-login.php\" or http.request.uri.path ~ \".*xmlrpc.php\") and ip.addr ne 172.16.22.155",
                "id": "372e67954025e0ba6aaa6d586b9e0b61",
                "paused": false,
                "ref": "FIL-100"
            }
        }
    ],
    "success": true,
    "result_info": {
        "count": 1,
        "page": 1,
        "per_page": 20,
        "total_count": 2000
    }
}

Request

Request samples

Responses