Query Refresh Status
Last Updated：2020-09-17
| Method | Path | Action |
|---|---|---|
| GET | /v2/cache/purge | Query the purge task |
URL parameters:
| Parameter | Type | Optional | Description |
|---|---|---|---|
| id | String | Yes | Query the assigned purge task id |
| endTime | Timestamp | Yes | End value of the time range queried, the default is the current time, UTC time. |
| startTime | Timestamp | Yes | Start time of the time range queried, the default is 24 hours ahead of the endTime, UTC time. The maximum time span between endTime and startTime is 30 days. |
| url | String | Yes | Query the purge request of the specified url |
| marker | String | Yes | The nextMarker value returned when the user recalls this interface last time is taken as the starting point of query this time. |
Response body
| Parameter | Type | Description |
|---|---|---|
| details | list type, PurgeStatus content items are explained in detail as follows: - status： String type, value is in-progress/completed/failed -task: PurgeTask type, indicating the task information. - createdAt： Timestamp type, indicating the time to create the purge task, UTC time. - startedAt： Timestamp type, indicating the time to start the purge task, UTC time. - finishedAt： Timestamp type, indicating the time to end the purge task, UTC time. The end may be Completed/Failed. If task is not completed, it does not return this item. - progress： Int type, indicating the progress percentage. |
Details of the purge task submitted |
| isTruncated | Bool | True means there are additional data in the following pages and false means the current page is the last page. |
| nextMarker | String | The domain doesn't appear when isTruncated is false. The user can access the subsequent lists by specifying the marker the next time this interface is called. |
Request example
GET /v2/cache/purge?id=eJwNyMERABAMBMCKMnPicH5aiQz9l8A+l61VAFwqk9ToFrjbiBIWqbT0n76lQ3/vTArw HTTP/1.1
Host: cdn.baidubce.com Response example
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"
}
}
]
}