调用PreloadDcdnObjectCaches将源站的内容主动预热到L2 Cache节点上,用户首次访问可直接命中缓存,缓解源站压力。
- 每个账户每天最多可提交500条URL预热请求。
- 目前不支持目录级别的预热。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | PreloadDcdnObjectCaches |
操作接口名。系统规定参数,取值:PreloadDcdnObjectCaches。 |
ObjectPath | String | 是 | example.com/image/1.png |
多个URL用换行符(\n)或(\r\n)分隔。 |
Area | String | 否 | domestic |
预热区域,如果不传该参数,默认加速全球区域。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
PreloadTaskId | String | 95248880 |
预热返回的任务ID。多个ID用逗号(,)分隔。 |
RequestId | String | E5BD4B50-7A02-493A-AE0B-97B9024B4135 |
请求ID。 |
示例
请求示例
http://dcdn.aliyuncs.com?Action=PreloadDcdnObjectCaches
&ObjectPath=test.test.com/test.txt
&<公共请求参数>
正常返回示例
XML
格式
<PreloadDcdnObjectCachesResponse>
<PushTaskId>95248880</PushTaskId>
<RequestId>E5BD4B50-7A02-493A-AE0B-97B9024B4135</RequestId>
</PreloadDcdnObjectCachesResponse>
JSON
格式
{
"PushTaskId": "95248880",
"RequestId": "E5BD4B50-7A02-493A-AE0B-97B9024B4135"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | SingleRequest.OverLimit | A maximum of 1000 URLs are supported for each request. | 一次最多只能提交1000个url。 |
400 | QuotaExceeded.Preload | Your refresh attempts have exceeded the daily limit. | 超出当日刷新预热限制。 |
400 | InvalidObjectPath.Malformed | The specified ObjectPath is invalid. | ObjectPath错误,请填写正确的ObjectPath。 |
400 | InvalidExtensiveDomain.ValueNotSupported | The specified ExtensiveDomain is not supported. | 不支持泛域名。 |
400 | PreloadQueueFull | The warming queue is full; please try again later. | 域名正在预热的URL个数已经达到上限,请稍后重试。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交