预热缓存
更新时间：2023-12-22
接口描述
本接口用于通知CDN提前缓存指定的url，支持批量提交，一次最多提交1000个url，24小时之内最多提交20000个url。
请求结构
POST /v2/cache/prefetch HTTP/1.1
Host: cdn.baidubce.com
Authorization: authorization string
{
"tasks":[
{
"url":"http://test1.baidu.com/xxx",
"startTime":"2023-12-22T03:00:00Z"
}
]
}请求头域
除公共头域外，无其它特殊头域。
请求参数
RequestBody参数
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| tasks | list<PrefetchTask> | 是 | 提交的预热任务列表详情。 |
PrefetchTask类型说明：
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| url | string | 是 | 表示需要预热的url，预热请求单连接限速 5MB/s。 |
| startTime | timestamp | 否 | 指定开始预热的时间。UTC时间，必须大于当前时间并且在24小时内，否则失败。格式为：2023-07-16Z23:00:00T, 默认为立即执行。 |
响应参数
响应码
| HTTP Status Code | 描述 |
|---|---|
| 201 | 成功 |
响应体
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | string | 提交预热任务后生成的id，可用于查询任务状态。 |
请求示例
POST /v2/cache/prefetch HTTP/1.1
Host: cdn.baidubce.com
Content-Type: text/json;utf-8
{
"tasks":
[
{
"url":"http://test.baidu.com/path/to/prefetch/1.data"
},
{
"url":"http://test.baidu.com/path/to/prefetch/2.data"
}
]
}响应示例
HTTP/1.1 201 Created
Content-Type: application/json;utf-8
x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
Server: BCE-CDN
{
"id": "419d6f1e9acb0442341e9b8e1e7fbf9f"
}