调用PreloadScdnObjectCaches将源站的内容主动预热到L2 Cache节点上,用户首次访问可直接命中缓存,缓解源站压力。
限制:
- 一个ID每天最多可提交500条URL预热请求。
- 目前不支持目录级别的预热。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | PreloadScdnObjectCaches |
系统规定参数,取值:PreloadScdnObjectCaches。 |
ObjectPath | String | 是 | example.aliyundoc.com/examplefile.txt |
多个URL之间需要用换行符( |
Area | String | 否 | overseas |
预热区域,取值:domestic, overseas。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
PreloadTaskId | String | 9524**** |
预热返回的任务ID,多个任务ID用逗号(半角)分隔 |
RequestId | String | E5BD4B50-7A02-493A-AE0B-97B9024B413 |
请求ID |
示例
请求示例
http(s)://scdn.aliyuncs.com/?Action=PreloadScdnObjectCaches
&ObjectPath=example.aliyundoc.com/examplefile.txt
&<公共请求参数>
正常返回示例
XML
格式
<RequestId>E5BD4B50-7A02-493A-AE0B-97B9024B413</RequestId>
<PreloadTaskId>9524****</PreloadTaskId>
JSON
格式
{
"RequestId": "E5BD4B50-7A02-493A-AE0B-97B9024B413",
"PreloadTaskId": "9524****"
}