预加载缓存
更新时间:2020-06-24
本接口用于通知CDN提前缓存指定的URL,支持批量提交,一次最多提交1000个url,用户24小时之内最多提交20000个URL。
Method | Path | 说明 |
---|---|---|
POST | /v2/cache/prefetch | 提交prefetch任务 |
请求体(Request Body)
参数 | 可选 | 类型 | 说明 |
---|---|---|---|
tasks | 必选 | list类型,PrefetchTask内容项解释如下: - url:必选项,String类型,表示需要prefetch的URL。 - speed:可选项,Int类型,表示prefetch的限速,单位为byte/s,默认为0(不限制)。 - startTime:可选项,Timestamp类型,UTC 时间,startTime必须是大于当前时间,并且在24小时内的时间,否则失败。格式为:2016-04-16Z23:00:00T, 默认为立即执行。 |
提交的prefetch任务列表详情 |
响应码 (Http Status Code)
HTTP Status Code | 说明 |
---|---|
201 | 成功 |
响应体 (Response Body)
参数 | 类型 | 说明 |
---|---|---|
id | String | 本次Prefetch任务的Id,可用于查询任务状态 |
请求示例
POST /v2/cache/prefetch HTTP/1.1
Host: cdn.baidubce.com
Content-Length: 145
Content-Type: text/json;utf-8
{
"tasks":
[
{
"url":"http://my.domain.com/path/to/prefetch/1.data"
},
{
"url":"http://my.domain.com/path/to/prefetch/2.data"
}
]
}
响应示例
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": "419d6f1e9acb0442341e9b8e1e7fbf9f"
}