新增頻率控制策略
更新時間 2023-11-13 18:33:44
最近更新時間: 2023-11-13 18:33:44
分享文章
接口描述:調用本接口新增域名的頻率控制規則配置內容
請求方式:post
請求路徑:/waf/access-rate-limit/create-access-rate-limit
使用說明:
- 查詢前,您需要先開通安全加速產品;
- 單個用戶一分鐘限制調用10000次,并發不超過100;
請求參數說明(json):
| 參數名 | 類型 | 是否必填 | 名稱 | 說明 |
|---|---|---|---|---|
| domain | string | 是 | 域名 | 單次調用支持新增一個域名 |
| accessRateLimitInfoList | list | 否 | 訪問限速 |
1)accessRateLimitInfoList參數
| 參數名 | 類型 | 是否必傳 | 名稱及描述 |
|---|---|---|---|
| mod | string | 是 | 開關狀態 1、開啟:ON 2、關閉:CLOSE |
| act | string | 是 | mod=ON時為必填; 處理動作 1、告警:LOG 2、攔截:BLOCK 3、人機跳轉:CC 4、丟棄:DROP |
| ruleName | string | 是 | 規則名 |
| ruleDesc | string | 否 | 規則描述 |
| accessRateLimitCondition | List | 是 | 防護條件 |
| countGranularity | List | 是 | 統計粒度 |
| noKey | string | 是 | 粒度缺失限速 |
| limitTime | int | 是 | 觸發條件時間,單位s |
| maxNumber | int | 是 | 統計周期內,最多允許多少個請求 |
| durationTime | int | 是 | 處理動作持續時間,單位s |
2)accessRateLimitCondition參數
| 參數 | 類型 | 是否必傳 | 名稱及描述 |
|---|---|---|---|
| equal | String | 是 | 1、包含:TRUE 2、不包含:FALSE |
| zone | String | 是 | 粒度(PATH、GEO、ARGS、CI、IP、REQUEST_URI、METHOD、IPR、HEADER、IPS、URI) |
| publicContent | String | 非必須 | 輸入多個時用分號隔開; URI、PATH最多十個; IP最多三百個; 當ZONE不為GEO、ARGS、HEADER時,為必填項 |
| operator | String | 非必須 | 當ZONE=IP_PORT、URI、REQUEST_URI、PROTOCOL時生效 1、正則:REGEX 2、字符串:STR |
| geoZone | List | 非必須 | geo地區對象,當ZONE=GEO生效 |
| keyName | string | 非必須 | key名稱(當zone為args和header時必須); 1、正則:REGEX 2、字符串:STR |
| keyContent | string | 非必須 | key內容(當zone為args和header時必須) |
| valueName | string | 非必須 | value名稱(當zone為args和header時必須) 1、正則:REGEX 2、字符串:STR |
| valueContent | string | 非必須 | value內容(當zone為args和header時必須) |
3)geoZone參數
| 參數 | 類型 | 是否必傳 | 名稱及描述 |
|---|---|---|---|
| subGeo | List | 非必須 | geo地區 |
4)countGranularity參數
| 參數 | 類型 | 是否必傳 | 名稱及描述 |
|---|---|---|---|
| grading | List | 是 | 統計粒度; IP、UA、CI、COOKIE、HEADER、ARGS、URL(ARGS、HEADER、COOKIE只能同時存在一個); 最多支持兩個粒度,不區分大小寫; |
| message | string | 否 | 統計粒度選擇ARGS、HEADER、COOKIE時必填 |
返回參數說明:
| 參數 | 類型 | 是否必傳 | 名稱及描述 |
|---|---|---|---|
| code | int | 是 | 狀態碼,成功100000 |
| message | string | 是 | 描述信息,成功返回success,其他返回異常信息描述 |
| data | list | 否 | 查詢結果 |
示例:
請求路徑://cdnapi-global.ctapi.daliqc.cn/waf/access-rate-limit/create-access-rate-limit
示例1:
請求參數:
{
"domain": "www.daliqc.cn",
"accessRateLimitInfoList":[ {
"mod": "ON",
"countGranularity": {
"grading": [
"URL"
],
"message": ""
},
"act": "LOG",
"ruleName": "uutest",
"ruleDesc": "123",
"noKey": "TRUE",
"limitTime": 3661,
"maxNumber": 1,
"durationTime": 3661,
"accessRateLimitCondition": [{
"zone": "GEO",
"equal": "TRUE",
"operator": "",
"publicContent": "",
"geoZone": [{
"subGeo": ["EU", "EU_DE"]
}, {
"subGeo": ["EU", "EU_PT"]
}]
}, {
"zone": "IP",
"equal": "TRUE",
"operator": "",
"publicContent": "1.1.1.2",
"geoZone": []
}]
}]
}
返回結果:
{
"code": 100000,
"message": "success",
"request_id": "53ssa889"
}
錯誤碼請參考:API返回參數code和message含義