预热缓存
更新时间：2025-08-21
接口描述
本接口用于预热文件，支持批量提交，一次最多提交100个url，用户24小时之内最多提交200个url预热请求。目前不支持对目录的预热。
请求结构
Plain Text
1POST /v2/abroad/cache/prefetch HTTP/1.1
2Host: cdn.baidubce.com
3Authorization: authorization string
4
5{
6 "tasks":[
7 {
8 "url": "http://www.test.com/1.txt"
9 },
10 {
11 "url": "http://www.test.com/2.txt"
12 }
13 ]
14}请求头域
除公共头域外，无其它特殊头域。
请求参数
RequestBody参数
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| tasks | List<PrefetchTask> | 是 | 提交的预热任务列表详情。 |
PrefetchTask类型说明：
| 参数名称 | 类型 | 是否必选 | 描述 |
|---|---|---|---|
| url | String | 是 | 表示需要预热的url。 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
响应体
| 参数名称 | 类型 | 描述 |
|---|---|---|
| id | String | 提交预热任务后生成的id，可用于查询任务状态。 |
请求示例
JSON
1POST /v2/abroad/cache/prefetch HTTP/1.1
2Host: cdn.baidubce.com
3Authorization: authorization string
4
5{
6 "tasks": [
7 {
8 "url": "http://test0131.dunahuiyan.top/1.txt"
9 },
10 {
11 "url": "http://test0131.dunahuiyan.top/2.txt"
12 }
13 ]
14}响应示例
JSON
1HTTP/1.1 200 OK
2Content-Type: application/json; charset=utf-8
3Date: Wed, 21 Jun 2023 06:57:40 GMT
4x-bce-request-id: b5dc6aae-6e06-d8fa-433b-5043dbfbcdd5
5Server: nginx/1.16.1
6
7{
8 "id": "eJwFwdENADAEBcCJJBq89LOr4LH_CL1zcyiOvgo2MkcwCuHdFDcrCXVjbTUZHw25DGI="
9}