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

Querying Alarm Notification Configurations

Function Description

This API is used to query alarm notification configurations.

URI

  • URI format

    GET /v1/{project_id}/waf/config/alert

  • Parameter description
    Table 1 Path parameters

    Parameter

    Mandatory

    Type

    Description

    project_id

    Yes

    String

    Specifies the project ID.

Request

Request parameters

None

Response

Response parameters
Table 2 Parameter description

Parameter

Type

Description

id

String

Specifies the unique ID of an alarm configuration.

enabled

Boolean

Specifies whether to send an alarm notification.

  • true: Send the alarm notification.
  • false: Do not send the alarm notification.

topic_urn

String

Specifies the SMN topic to which an alarm is sent.

sendfreq

Integer

Specifies the minimum interval between two alarms in minutes. The options are 5, 15, 30, and 60.

times

Integer

Specifies the alarm threshold. Alarm notifications are sent when the number of attacks is greater than or equal to the threshold within the configured period. This value is greater than or equal to 1.

threat

List<String>

Specifies the list of event types.

  • all refers to all types of events.
  • cc refers to CC attack.
  • cmdi refers to command injection.
  • custom refers to Precise Protection events.
  • illegal refers to invalid requests.
  • sqli refers to SQL injection.
  • lfi refers to local file inclusion.
  • robot refers to malicious crawlers.
  • antitamper refers to Web Tamper Protection events.
  • rfi refers to remote file inclusion.
  • vuln refers to other types of attacks.
  • xss refers to XSS attack.
  • whiteblackip refers to Blacklist and Whitelist events.
  • webshell refers to webshells.

locale

String

Specifies the language configuration. Only zh-cn and en-us are supported. The default value is en-us.

Example

Response example
{
    "id": "37b4bbe8a562453aa0163a96e6b71dd6",
    "enabled": true,
    "topic_urn": "urn:smn:eude:fca6f667ac5f4d9798d1641dfd38106b:wbtest",
    "sendfreq": 5,
    "times": 200,
    "threat": ["xss", "sqli", "cmdi"],
    "locale": "en-us"
}

Status Code

Table 3 describes the normal status code returned by the API.
Table 3 Status code

Status Code

Description

Meaning

200

OK

The request has succeeded.

For details about error status codes, see Status Codes.