刷新缓存
更新时间:2020-06-24
本接口用于清除已经缓存的文件,支持批量提交,一次最多提交1000个url,用户24小时之内最多提交20000个URL刷新请求或者200个目录刷新请求。
Method | Path | 说明 |
---|---|---|
POST | /v2/cache/purge | 提交purge任务 |
请求体(Request Body)
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
tasks | 必选 | list类型,PurgeTask内容项解释如下: - url:必选项,String类型,表示需要purge的URL,如果type为directory,必须以/结尾。 - type:可选项,String类型,可选值为file/directory,默认为file。 |
提交的purge任务列表详情 |
响应码 (Http Status Code)
HTTP Status Code | 说明 |
---|---|
201 | 成功 |
响应体 (Response Body)
参数 | 类型 | 说明 |
---|---|---|
id | String | 本次Purge任务的Id,可用于查询任务状态 |
请求示例
POST /v2/cache/purge HTTP/1.1
Host: cdn.baidubce.com
Content-Length: 145
Content-Type: text/json;utf-8
{
"tasks":
[
{
"url":"http://my.domain.com/path/to/purge/1.data"
},
{
"url":"http://my.domain.com/path/to/purege/dir/",
"type":"directory"
}
]
}
响应示例
HTTP/1.1 201 Created
Content-Length: 91
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"id": "5fea77560ea4451aa703a558b933e274"
}