查询刷新状态
更新时间:2023-10-16
接口描述
本接口用于查询指定条件的刷新任务状态。
请求结构
GET /v2/abroad/cache/purge?id=xxx&startTime=xxx&endTime=xxx&url=xxx&marker=xxx HTTP/1.1
Host: cdn.baidubce.com
Authorization: authorization string
请求头域
除公共头域外,无其它特殊头域。
请求参数
Query参数
参数名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
id | string | 否 | 查询指定刷新任务的id。 |
endTime | timestamp | 否 | 查询的时间范围结束值。默认为当前时间,UTC时间。 |
startTime | timestamp | 否 | 查询的时间范围起始值。默认为endTime前推15天,UTC时间。 |
url | string | 否 | 查询指定url的刷新请求。 |
marker | string | 否 | 用户上次调用本接口返回的nextMarker值,作为本次查询的起点。 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
响应体
参数名称 | 类型 | 描述 |
---|---|---|
details | list<PurgeStatus> | 提交的刷新任务详情。 |
isTruncated | bool | true表示该查询范围内后面还有数据,false表示已经是最后一页。 |
nextMarker | string | 当isTruncated为false时,该域不出现。用户通过在下次调用本接口时指定该marker标记来获取后续的列表。 |
PurgeStatus类型说明:
参数名称 | 类型 | 描述 |
---|---|---|
status | string | 取值为in-progress、completed、failed。 |
task | list<PurgeTask> | task信息。 |
createdAt | timestamp | 表示刷新任务的创建时间,UTC时间。 |
finishedAt | timestamp | 表示刷新任务的结束时间,UTC时间。 |
PurgeTask类型说明:
参数名称 | 类型 | 描述 |
---|---|---|
url | string | 刷新的url。 |
type | string | 刷新的类型:file、directory,默认为file。 |
说明: 和国内版不同,此处没有进度的概念,只有completed、failed和in-progress这3个状态。
请求示例
GET /v2/abroad/cache/purge HTTP/1.1
Host: cdn.baidubce.com
响应示例
HTTP/1.1 200 OK
Server: nginx/1.1.10
Date: Fri, 13 Oct 2023 08:16:57 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunked
Connection: keep-alive
x-bce-request-id: b63d9e7d-6dd7-9f29-1cc1-9727e3bd2c97
{
"details": [
{
"task": {
"url": "http://www.example.com/test.jpg",
"type": "file"
},
"createdAt": "2020-07-07T09:46:58Z",
"finishedAt": "2020-07-07T09:46:58Z",
"status": "completed"
},
{
"task": {
"url": "http://www.example.com/a/",
"type": "file"
},
"createdAt": "2020-07-07T09:45:32Z",
"finishedAt": "2020-07-07T09:45:32Z",
"status": "completed"
}
],
"isTruncated": false
}