调用PreloadScdnObjectCaches将源站的内容主动预热到L2 Cache节点上,用户首次访问可直接命中缓存,缓解源站压力。

限制:

  • 一个ID每天最多可提交500条URL预热请求。
  • 目前不支持目录级别的预热。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String PreloadScdnObjectCaches

系统规定参数,取值:PreloadScdnObjectCaches

ObjectPath String example.aliyundoc.com/examplefile.txt

多个URL之间需要用换行符(\n或\r\n)分隔。

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****"
}