Updated on 2022-02-22 GMT+08:00

Adding a Data Masking Rule

Function Description

This API is used to add a data masking rule.

URI

  • URI format

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

  • 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 the URL to which the data masking rule applies (exact match by default).

category

Yes

String

Specifies the masked field. The options are params and header.

index

Yes

String

Specifies the masked subfield.

Response

Response parameters
Table 3 Parameter description

Parameter

Type

Description

id

String

Specifies the ID of a data masking rule.

policy_id

String

Specifies the policy ID.

path

String

Specifies the URL to which the data masking rule applies (exact match by default).

category

String

Specifies the masked field. The options are params and header.

index

String

Specifies the masked subfield.

timestamp

Long

Specifies the time when a data masking rule is added.

Examples

  • Request example
    {
      "path": "/login",
      "category": "params",
      "index": "name"
    }
  • Response example
    {
          "id": "e1c0e55865544d1f8c95cf71df108c6b",
          "policy_id": "yuc0e55865544d1f8c95cf71df108c6b",
          "path": "/login",
          "category":"params",
          "index": "name",
          "timestamp": 123243414132
    }

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.