url封禁相关接口
更新时间：2025-08-21
quota查询接口
本接口用于查询当前用户的url封禁容量以及使用了多少
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/firewalls/forbidden/quota | 查询当前用户的url封禁容量以及使用了多少 |
请求示例：
Plain Text
1GET /v2/firewalls/forbidden/quota HTTP/1.1
2Host: cdn.baidubce.com响应体 (Response Body)
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| quota | 必选 | unsigned int | url封禁总容量 |
| count | 必选 | unsigned int | 当前封禁的url数目 |
响应示例：
Plain Text
1HTTP/1.1 200 OK
2Server: nginx/1.1.10
3Date: Thu, 17 Dec 2020 12:14:38 GMT
4Content-Type: application/json; charset=utf-8
5Transfer-Encoding: chunked
6Connection: keep-alive
7X-Powered-By: PHP/7.2.28
8x-bce-request-id: b1c22e2f-6a28-2f7b-a06a-df4de49cee98
9
10
11{"quota":50,"count":5}url封禁列表查询接口
本接口用于查询url封禁列表——查询的结果不带协议，不带url参数，支持分页
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/firewalls/forbidden/urls | 查询url封禁列表 |
url参数
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| pageSize | 可选 | unsigned int | 分页查询页面大小，默认值为10，最大不超过100 |
| pageNo | 可选 | unsigned int | 指定查询第几页，默认值为1 |
| orderBy | 可选 | string | 值为desc或asc，指定时间倒序输出还是时间顺序输出。默认为desc，时序倒序输出。设置为asc时按时序顺序输出 |
| url | 可选 | string | 指定的url查询，url path不能超过1024字符 |
请求示例：
Plain Text
1GET /v2/firewalls/forbidden/urls HTTP/1.1
2Host: cdn.baidubce.com响应体 (Response Body)
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| count | 必选 | unsigned int | 查询结果总条数，用于分页 |
| urlRecords | 必选 | list<urlRecord> | 查询结果 |
urlRecord类型说明
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| url | 必选 | string | 封禁的url |
| time | 必选 | string | 封禁的时间，北京时间 |
响应示例：
Plain Text
1HTTP/1.1 200 OK
2Server: nginx/1.1.10
3Date: Thu, 17 Dec 2020 12:02:36 GMT
4Content-Type: application/json; charset=utf-8
5Transfer-Encoding: chunked
6Connection: keep-alive
7X-Powered-By: PHP/7.2.28
8x-bce-request-id: 847dd852-5f97-d906-e2c8-af6fd1231b97
9
10
11{
12 "count": "5",
13 "urlRecords": [
14 {
15 "url": "test.aaa.baidu.com\/1.html",
16 "time": "2020-08-18 16:31:13"
17 },
18 {
19 "url": "test.aaa.baidu.com\/3.html",
20 "time": "2020-08-18 16:31:13"
21 },
22 {
23 "url": "test.aaa.baidu.com\/a.html",
24 "time": "2020-08-18 16:31:13"
25 },
26 {
27 "url": "test.aaa.baidu.com\/b.html",
28 "time": "2020-08-18 16:31:13"
29 },
30 {
31 "url": "test.aaa.baidu.com\/c.html",
32 "time": "2020-08-18 16:31:13"
33 }
34 ]
35}url封禁操作记录查询
本接口用于查询url封禁操作记录——查询的结果url不带协议，不带参数，支持分页
| Method | Path | 说明 |
|---|---|---|
| GET | /v2/firewalls/forbidden/operateHistories | 查询url封禁操作记录 |
url参数
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| pageSize | 可选 | unsigned int | 分页查询页面大小，默认值为10，最大不超过100 |
| pageNo | 可选 | unsigned int | 指定查询第几页，默认值为1 |
| startTime | 可选 | string | 指定时间范围查询，开始时间，距当前时间点不能超过90天，北京时间 |
| endTime | 可选 | string | 指定时间范围查询，截止时间，不能大于当前时间，北京时间 |
| orderBy | 可选 | string | 值为desc或asc，指定时间倒序输出还是时间顺序输出。默认为desc，时序倒序输出。设置为asc时按时序顺序输出 |
| url | 可选 | string | 指定的url查询，url path不能超过1024字符 |
请求示例：
Plain Text
1GET /v2/firewalls/forbidden/operateHistories HTTP/1.1
2Host: cdn.baidubce.com响应体 (Response Body)
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| count | 必选 | unsigned int | 查询结果总条数，用于分页 |
| operateHistories | 必选 | list<operateHistory> | 查询结果 |
operateHistory类型说明
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| url | 必选 | string | 封禁的url |
| action | 必选 | unsigned int | 执行的操作，1表ban操作，0表unban操作 |
| time | 必选 | string | 封禁的时间，北京时间 |
响应示例：
Plain Text
1HTTP/1.1 200 OK
2Server: nginx/1.1.10
3Date: Thu, 17 Dec 2020 12:05:17 GMT
4Content-Type: application/json; charset=utf-8
5Transfer-Encoding: chunked
6Connection: keep-alive
7X-Powered-By: PHP/7.2.28
8x-bce-request-id: 88a24d76-5348-4c22-60d1-d31ddfc8f12
9
10
11{
12 "count": "7",
13 "urlHistories": [
14 {
15 "url": "test.aaa.baidu.com\/1.html",
16 "action": 1,
17 "time": "2020-08-18 16:31:13"
18 },
19 {
20 "url": "test.aaa.baidu.com\/3.html",
21 "action": 1,
22 "time": "2020-08-18 16:31:13"
23 },
24 {
25 "url": "test.aaa.baidu.com\/a.html",
26 "action": 1,
27 "time": "2020-08-18 16:31:13"
28 },
29 {
30 "url": "test.aaa.baidu.com\/7.html",
31 "action": 0,
32 "time": "2020-08-18 12:52:55"
33 },
34 {
35 "url": "test.aaa.baidu.com\/4.html",
36 "action": 0,
37 "time": "2020-08-18 12:52:55"
38 },
39 {
40 "url": "test.aaa.baidu.com\/b.html",
41 "action": 1,
42 "time": "2020-08-18 16:31:13"
43 },
44 {
45 "url": "test.aaa.baidu.com\/c.html",
46 "action": 1,
47 "time": "2020-08-18 16:31:13"
48 }
49 ]
50}url封禁接口
本接口用于提交url封禁，默认封禁时间为30天。
| Method | Path | 说明 |
|---|---|---|
| POST | /v2/firewalls/forbidden/ban | url封禁操作 |
请求体
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| urls | 必选 | list<string> | 要封禁的url列表，封禁时是忽略协议以及参数的。urls列表不能超过10条。url path不能超过1024字符 |
请求示例：
Plain Text
1POST /v2/firewalls/forbidden/ban HTTP/1.1
2Host: cdn.baidubce.com
3
4{
5 "urls": [
6 "www.test.com/case.xml",
7 "https://www.test.com/case.index",
8 "http://www.test.com/case.xml"
9 ]
10}响应体 (Response Body)
空
url解封禁接口
本接口用于执行url解封禁操作
| Method | Path | 说明 |
|---|---|---|
| POST | /v2/firewalls/forbidden/unban | url解封禁操作 |
请求体
| 参数 | 可选 | 类型 | 说明 |
|---|---|---|---|
| urls | 必选 | list<string> | 要解封禁的url列表，封禁时是忽略协议以及参数的。urls列表不能超过10条。url path不能超过1024字符 |
请求示例：
Plain Text
1GET /v2/firewalls/forbidden/unban HTTP/1.1
2Host: cdn.baidubce.com
3
4{
5 "urls": [
6 "www.test.com/case.xml",
7 "https://www.test.com/case.index",
8 "http://www.test.com/case.xml"
9 ]
10}响应体 (Response Body)
空