设置查询字符串配置
更新时间：2026-06-04
接口
本接口用于设置站点的查询字符串配置。
请求接口
| Method | Path | 说明 |
|---|---|---|
| PUT | /v2/geo/site/{site}/config | 设置查询字符串配置接口 |
site：表示要设置的站点。
请求体
| 参数 | 类型 | 可选 | 说明 |
|---|---|---|---|
| cacheKey | List<CacheKey> | 必选 | 查询字符串配置。 |
响应码
| HTTP Status Code | 说明 |
|---|---|
| 200 | 设置查询字符串配置成功 |
| 其他错误码 | 配置参数错误 |
响应体
| 参数 | 类型 | 说明 |
|---|---|---|
| status | String | 表示修改该配置的状态。设置配置成功，其值为“RUNNING”。否则返回报错信息。 |
请求示例1: 全部保留
Plain Text
1PUT /v2/geo/site/test.com/config HTTP/1.1
2Host: geo.baidubce.com
3Content-Length: 46
4Authorization: xxx
5Content-Type: application/json;charset=utf-8
6Accept-Encoding: gzip
7
8{
9 "cacheKey": {
10 "query": true
11 }
12}请求示例2: 全部忽略
Plain Text
1PUT /v2/geo/site/test.com/config HTTP/1.1
2Host: geo.baidubce.com
3Content-Length: 46
4Authorization: xxx
5Content-Type: application/json;charset=utf-8
6Accept-Encoding: gzip
7
8{
9 "cacheKey": {
10 "query": false,
11 "include_args": []
12 }
13}请求示例3:保留指定参数
Plain Text
1PUT /v2/geo/site/test.com/config HTTP/1.1
2Host: geo.baidubce.com
3Content-Length: 46
4Authorization: xxx
5Content-Type: application/json;charset=utf-8
6Accept-Encoding: gzip
7
8{
9 "cacheKey": {
10 "query": false,
11 "include_args": [
12 "test1"
13 ]
14 }
15}请求示例4:忽略指定参数
Plain Text
1PUT /v2/geo/site/test.com/config HTTP/1.1
2Host: geo.baidubce.com
3Content-Length: 46
4Authorization: xxx
5Content-Type: application/json;charset=utf-8
6Accept-Encoding: gzip
7
8{
9 "cacheKey": {
10 "query": false,
11 "exclude_args": [
12 "test1",
13 "test2"
14 ]
15 }
16}响应示例
Plain Text
1HTTP/1.1 200 OK
2Server: nginx/1.16.1
3Content-Type: application/json; charset=utf-8
4Transfer-Encoding: chunked
5Connection: keep-alive
6
7{
8 "status": "RUNNING"
9}评价此篇文章