刷新缓存
更新时间：2023-10-16
接口描述
本接口用于刷新已经缓存的资源，支持批量提交，一次最多提交100个url，24小时之内最多提交2000个url的刷新请求或者200个目录的刷新请求。
请求结构
POST /v2/abroad/cache/purge HTTP/1.1
Host: cdn.baidubce.com
Authorization: authorization string
{
"tasks":[
{
"url":"http://test1.baidu.com/xxx",
"type":"file"
},
{
"url":"http://test2.baidu.com/xxx",
"type":"directory"
}
]
}请求头域
除公共头域外，无其它特殊头域。
请求参数
RequestBody参数
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| tasks | list<PurgeTask> | 是 | 提交的刷新任务列表详情。 |
PurgeTask类型说明：
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| url | string | 是 | 表示需要刷新的url，如果type为directory，必须以/结尾。 |
| type | string | 否 | 可选值为file、directory，默认为file。 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
响应码
| HTTP Status Code | 描述 |
|---|---|
| 201 | 刷新任务接收成功。 |
| 400 | 资源不属于当前用户，urls数量超过1次的限制，（1次最多100条）。 |
| 403 | 额度不够。 |
响应体
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | string | 提交刷新任务后生成的id，可用于查询任务状态。 |
请求示例
POST /v2/abroad/cache/purge HTTP/1.1
Host: cdn.baidubce.com
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-Type: application/json;utf-8
x-bce-request-id: b652b31c-6db8-b248-feee-93de3d37be7
Server: BCE-CDN
{
"id":"eJwFwckNACAMA7CJKpVewI9ZQsP+I2BH6gjTOKg0+LhSjSWwWPJIyvamt09wfvW4C64="
}