Adding a False Alarm Masking Rule

Function Description

This API is used to add a false alarm masking rule.

URI

  • URI format

    POST /v1/{project_id}/waf/policy/{policy_id}/ignore

  • 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

path

Yes

String

Specifies a misreported URL excluding a domain name.

event_id

Yes

String

Specifies the event ID.

ID of a misreported event in Events whose type is not Custom. Click Handle False Alarm in the row containing the attack event to obtain the event ID.

Response

Response parameters

Table 3 Parameter description

Parameter

Type

Description

id

String

Specifies the ID of a false alarm masking rule.

policy_id

String

Specifies the policy ID.

path

String

Specifies a misreported URL excluding a domain name.

event_id

String

Specifies the event ID.

event_type

String

Specifies the event type.

timestamp

Long

Specifies the time when a false alarm masking rule is added.

rule

String

Specifies the rule ID, which consists of six digits and cannot be empty.

Examples

Rule ID 100001 is used as example.

  • Request example

    {
      "path": "/a",
      "event_id": "3737fb122f2140f39292f597ad3b7e9a"
    
    }
    
  • Response example

    {
      "id": "6cdc116040d444f6b3e1bf1dd629f1d0",
      "policy_id": "44d887434169475794b2717438f7fa78",
      "path": "/a",
      "event_id": "3737fb122f2140f39292f597ad3b7e9a",
      "event_type": "xss",
      "rule": "100001",
      "timestamp": 1499817600
    }
    

Status Code

Table 4 describes the normal status code returned by the API.

Table 4 Status code

Status Code

Description

Meaning

200

OK

The request has succeeded.

For details about error status codes, see Status Codes.