文档首页/ Web应用防火墙 WAF/ API参考 (巴黎) / API说明/ 云模式/ 精准防护规则/ 查询某个自定义规则
更新时间：2022-02-22 GMT+08:00
查看PDF
分享

查询某个自定义规则

功能介绍

查询自定义规则的详细信息。

URI

  • URI格式

    GET /v1/{project_id}/waf/policy/{policy_id}/custom/{custom_rule_id}

  • 参数说明
    表1 Path参数说明

    名称

    是否必选

    参数类型

    说明

    project_id

    是

    String

    用户操作的项目ID。

    policy_id

    是

    String

    策略ID。

    custom_rule_id

    是

    String

    自定义精准防护规则的ID。

请求消息

请求参数

无

响应消息

响应参数
表2 响应参数说明

名称

参数类型

说明

id

String

精准防护规则的ID。

policy_id

String

策略ID。

name

String

精准防护规则名称。

time

Boolean

精准防护规则生效时间。

  • “false”：表示该规则立即生效。
  • “true”：表示自定义生效时间。

start

Long

精准防护规则生效的起始时间。

end

Long

精准防护规则生效的终止时间。

conditions

List of 表3

匹配条件列表。

action

表4

精准防护规则命中后操作对象。

priority

Integer

执行该规则的优先级，值越小，优先级越高，值相同时，规则创建时间早，优先级越高。取值范围：0到65535。

timestamp

Long

创建精准访问防护规则的时间。
表3 conditions

名称

参数类型

说明

category

String

条件类型。固定值path、user-agent、ip、params、cookie、referer、header。

index

String
  • 当“category”为“cookie”时，index表示cookie name。
  • 当“category”为“params”时，index表示param name。
  • 当“category”为“header”时，index表示header中的选项。

logic

String

“contain”，“not_contain”“equal”,“not_equal”,“prefix”，“not_prefix”，“suffix”，“not_suffix”分别代表包含、不包含、等于、不等于、前缀为、前缀不为、后缀为、后缀不为。

当条件类型“category”为“ip”时，“logic”只能为“equal”或者“not_equal”。

contents

List

条件匹配的内容。
表4 action

名称

参数类型

说明

category

String

操作类型。

  • “block”：拦截。
  • “pass”：放行。

示例

如下以查询id 为“7374ad99c6c448e9a9ca35cb46660a39”的自定义规则为例。

响应样例

{ 
      "id": "7374ad99c6c448e9a9ca35cb46660a39", 
      "policy_id": "9tre832yf96784ec8abd8ba61a98064ef", 
      "name": "rule1", 
      "time": true, 
      "start": 1499817600, 
      "end": 1567817600, 
      "conditions": [{ 
          "category ": "path", 
          "contents": ["/login"], 
          "logic": "contain"
        },{ 
          "category": "ip", 
          "logic": "equal", 
          "contents": ["X.X.1.1"]
        }, { 
          "category": "referer", 
          "logic": "prefix", 
          "contents": ["https://www.waf.com/xxx"]
        }, { 
          "category": "user-agent", 
          "logic": "contain", 
          "contents": ["Mozilla/5.0"]
        }, { 
          "category": "cookie",
		  "index": "SID",
          "logic": 3, 
          "contents": ["234SDFASR4R32412FSR325S"]
        }, { 
          "category": "header",
		  "index": "x-language",
          "logic": "equal", 
          "contents": ["en-us"]
        }, { 
          "category": "params",
		  "index": "name",
          "logic": "equal", 
          "contents": ["abc"]
        }
      ], 
      "action": { 
        "category": "block" 
      }, 
     "priority": 10, 
     "timestamp": 1499817600 
}

状态码

表5描述的是API返回的正常状态码。
表5 状态码

状态码

编码

状态说明

200

OK

客户端请求已处理成功。

异常状态码，请参见状态码。

父主题： 精准防护规则