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

使用说明

  • 相关接口:刷新预热类接口包含RefreshDcdnObjectCaches刷新接口和PreloadDcdnObjectCaches预热接口。
  • 请求方式:支持POST请求,参数用form表单显示。
  • URL预热配额(每日):默认情况下,一个账号每日最多可以提交1000条URL预热任务,如果您账号的日带宽峰值大于200 Mbps,可通过提交工单申请提升每日配额,阿里云将根据您业务的实际需求进行评估和配置。
  • 每次最多可以提交100条URL预热任务。
  • 预热队列规则:每个账号的预热队列最大为50000条URL,DCDN根据URL提交的先后顺序进行预热,当预热队列中未完成的任务达到了50000条URL时,阿里云DCDN将会采取排队机制(即完成排序最前的一条URL预热后才可以继续提交下一条URL预热)完成预热。
  • 单用户调用频率:15次/秒。

注意事项

  • 提交预热任务并成功执行后,DCDN节点会立即回源站加载所需资源,因此大批量提交预热任务会生成较多的并发下载任务,导致回源带宽和请求突增,增加源站压力。
  • 预热任务从提交到预热完成,实际执行时间视预热文件大小而定,大约需要5~30分钟,文件平均大小越小,预热速度越快。
  • 使用RAM用户来执行刷新或预热操作的,需要先获得授权,请参见授予RAM用户刷新预热权限完成授权。

调试

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

请求参数

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

系统规定参数。取值:PreloadDcdnObjectCaches

ObjectPath String example.com/examplefile.txt

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

Area String domestic

预热区域,如果不传该参数,默认加速全球区域。

  • domestic:仅中国内地。
  • overseas:全球(不包含中国内地)。
L2Preload Boolean true

是否直接预热到L2节点。取值:

  • true:代表预热的节点层级必须包含L2节点。
  • false:代表仅预热回源层节点(false为默认值,回源层节点可能是L2节点,也可能是L3节点)。

返回数据

名称 类型 示例值 描述
PreloadTaskId String 95248880

预热返回的任务ID。多个ID用逗号(,)分隔。

RequestId String E5BD4B50-7A02-493A-AE0B-97B9024B4135

请求ID。

示例

请求示例

http(s)://dcdn.aliyuncs.com/?Action=PreloadDcdnObjectCaches
&ObjectPath=example.com/examplefile.txt
&Area=domestic
&L2Preload=true
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<PreloadDcdnObjectCachesResponse>
    <PushTaskId>95248880</PushTaskId>
    <RequestId>E5BD4B50-7A02-493A-AE0B-97B9024B4135</RequestId>
</PreloadDcdnObjectCachesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/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个数已经达到上限,请稍后重试。

访问错误中心查看更多错误码。