更新CC规则
功能介绍
更新某个CC规则。
URI
请求消息
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
path |
是 |
String |
规则应用的URL链接，不包含域名。 |
|
limit_num |
是 |
Integer |
单个用户的周期内请求次数（单用户限速）。取值范围为(0次, 232次) |
|
limit_period |
是 |
Integer |
限速周期。取值范围为(0秒, 232秒) |
|
lock_time |
否 |
Integer |
锁定时长。取值范围为[0秒, 232秒) |
|
tag_type |
是 |
String |
防护模式。
|
|
tag_index |
否 |
String |
当“tag_type”为“cookie”时，该参数表示cookie name。 |
|
tag_condition |
否 |
Referer（自定义请求访问的来源）字段，当“tag_type”为“other”时，需要传该字段。 |
|
|
action |
是 |
请求次数到达限制后采取的动作。 |
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
category |
是 |
String |
类别。取值为“Referer”。 当传tag_condition字段时，需要传该字段。 |
|
contents |
是 |
List |
category的内容。 格式为：http://www.example.com/path。 当传tag_condition字段时，需要传该字段。目前该字段只接受单个值，不要写入多个参数。 |
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
category |
是 |
String |
动作类型。
默认为“block”。 当“tag_type”为“other”时，只能取值“block”。 |
|
detail |
否 |
动作详情，“detail”为“null”时表示默认阻断页面。 当“category”为“captcha”时，不能传此字段。 当“category”为“block”时，需要传此字段。 |
|
名称 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
|
content_type |
是 |
String |
返回页面的内容类型。 固定值为“application/json”、“text/html”、“text/xml”。 默认值为“application/json”。 |
|
content |
是 |
String |
返回页面的内容。 |
GET /v1/{project_id}/waf/policy/{policy_id}/custom?offset={offset}&limit={limit}
响应消息
|
名称 |
参数类型 |
说明 |
|---|---|---|
|
id |
String |
CC规则的ID。 |
|
policy_id |
String |
策略ID。 |
|
path |
String |
规则应用的URL链接，不包含域名。 |
|
limit_num |
Integer |
单个用户的周期内请求次数（单用户限速）。 |
|
limit_period |
Integer |
限速周期。 |
|
lock_time |
Integer |
锁定时长。取值范围为[0秒, 232秒) |
|
tag_type |
String |
标记对象类型，固定值cookie、ip、other。 |
|
tag_index |
String |
当“tag_type”为“cookie”时，index表示cookie name。 |
|
tag_condition |
当“tag_type”为“other”时，该字段才有意义。 |
|
|
action |
请求次数到达限制后采取的动作。 |
|
|
timestamp |
Long |
创建CC规则的时间。 |
|
default |
Boolean |
是否为默认CC规则。
|
示例
如下以更新一条CC规则为例。
- 请求样例
{ "path": "/abc1", "limit_num": 10, "limit_period": 60, "lock_time": "", "tag_type": "cookie", "tag_index": "sesssionid", "action": { "category": "block", "detail": { "response": { "content_type": "application/json", "content": "{\'error\':\'forbidden\}" } } } }
- 响应样例
{ "id": "3a9b5c0f96784ec8abd8ba61a98064ef", "policy_id": "9tre832yf96784ec8abd8ba61a98064ef", "path": "/abc1", "limit_num": 10, "limit_period": 60, "lock_time": "", "tag_type": "cookie", "tag_index": "sesssionid", "action": { "category": "block", "detail": { "response": { "content_type": "application/json", "content": "{\"error\":\"forbidden\"}" } } }, "timestamp": 1499817600, "default": false }
