查询刷新状态
更新时间：2022-03-09
查询指定条件的刷新任务状态，精确查询返回所有记录，范围查询最多返回100条记录。
| Method | Path | Action |
|---|---|---|
| GET | /v2/cache/purge | 查询purge任务 |
URL参数：
| 参数 | 类型 | 可选 | 说明 |
|---|---|---|---|
| id | String | 是 | 查询指定purge task id |
| endTime | Timestamp | 是 | 查询的时间范围结束值，默认为当前时间，UTC时间 |
| startTime | Timestamp | 是 | 查询的时间范围起始值，默认为endTime前推24小时，UTC时间。endTime与startTime最大时间跨度30天 |
| url | String | 是 | 查询指定url的purge请求 |
| marker | String | 是 | 用户上次调用本接口返回的nextMarker值，作为本次查询的起点。注：传该参数时，时间参数和上次查询保持一致，不传id参数 |
查询类型：
- 精确查询：指定任务id，返回该任务所有记录。无需指定时间，不支持url和marker参数。
- 范围查询：指定时间参数，url参数可选，返回该时间范围内的任务记录。当需要返回下一页时，查询的时间范围不可改变，marker参数必填。
响应体 (Response Body)
| 参数 | 类型 | 说明 |
|---|---|---|
| details | list类型，PurgeStatus内容项详细解释如下： - status：String类型，取值为in-progress / completed / failed - task：PurgeTask类型，表示task信息。 - createdAt：Timestamp类型，表示purge任务的创建时间，UTC时间。 - startedAt：Timestamp类型，表示purge任务开始执行的时间，UTC时间。 - finishedAt：Timestamp类型，表示purge任务的结束时间，UTC时间，结束可能是Completed/Failed。如果任务未结束，则不返回该项。 - progress：Int类型，表示进度百分比。 |
提交的purge任务详情 |
| isTruncated | Bool | true表示该查询范围内后面还有数据，false表示已经是最后一页。 |
| nextMarker | String | 当isTruncated为false时，该域不出现。用户通过在下次调用本接口时指定该marker标记来获取后续的列表。 |
请求示例
精确查询
GET /v2/cache/purge?id=eJwNyMERABAMBMCKMnPicH5aiQz9l8A+l61VAFwqk9ToFrjbiBIWqbT0n76lQ3/vTArw HTTP/1.1
Host: cdn.baidubce.com范围查询
GET /v2/cache/purge?startTime=2022-03-06T02:00:00Z&endTime=2022-03-07T02:00:00Z HTTP/1.1
Host: cdn.baidubce.com查询指定时间范围的下一页
GET /v2/cache/purge?startTime=2022-03-06T02:00:00Z&endTime=2022-03-07T02:00:00Z&marker=eJwFwcERwCAIBMCKmBG5yPmzFROO/kvILuCRDh5Wv1S0YTANpTau8Vls1AwnIJ7ufDijpJ3p3veT2rnuJVWpHxiZFRk= HTTP/1.1
Host: cdn.baidubce.com响应示例
HTTP/1.1 200 OK
Content-Length: 190
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"details":
[
{
"status": "completed",
"createdAt": "2015-08-24T12:20:32Z",
"finishedAt": "2015-08-24T12:21:45Z",
"progress": 100,
"task":
{
"url": "http://my.domain.com/path/to/purge/1.data"
}
}
{
"status": "in-process",
"createdAt": "2015-08-24T12:20:32Z",
"finishedAt": "2015-08-24T12:21:49Z",
"progress": 87,
"task":
{
"url": "http://my.domain.com/path/to/purge/dir",
"type": "directory"
}
}
]，
"isTruncated": true,
"nextMarker":"eJwFwcERwCAIBMCKmBG5yPmzFROO/kvILuCRDh5Wv1S0YTANpTau8Vls1AwnIJ7ufDijpJ3p3veT2rnuJVWpHxiZFRk="
}