PreloadDcdnObjectCaches_全站加速_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • 相关接口:刷新预热类接口包含 RefreshDcdnObjectCaches 刷新接口和 PreloadDcdnObjectCaches 预热接口。

  • 请求方式:支持 POST 请求,参数用 form 表单显示。

  • URL 预热配额(每日):默认情况下,一个账号每日最多可以提交 1000 条 URL 预热任务,如果您账号的日带宽峰值大于 200 Mbps,可通过配额管理申请提升每日配额,阿里云将根据您业务的实际需求进行评估和配置。

  • 每次最多可以提交 100 条 URL 预热任务。

  • 预热队列规则:每个账号的预热队列最大为 100,000 条 URL,DCDN 根据 URL 提交的先后顺序进行预热,当预热队列中未完成的任务达到了 100,000 条 URL 时,阿里云 DCDN 将会采取排队机制(即完成排序最前的一条 URL 预热后才可以继续提交下一条 URL 预热)完成预热。

  • 单用户调用频率:15 次/秒。

注意事项

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

流控信息

请求速率为15/1(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
dcdn:PreloadDcdnObjectCaches
None
domain
acs:dcdn:*:{#accountId}:domain/{#domainName}

请求参数

字段名称字段详情
ObjectPathstring

预热 URL,格式为加速域名/预热的文件展开详情

示例值:example.com/examplefile.txt参考取值来源:
    RefreshErObjectCaches
Areastring

预热区域,取值:展开详情

示例值:domestic枚举值:domesticoverseas
L2Preloadboolean

是否直接预热到 L2 节点。取值:展开详情

示例值:true
WithHeaderstring

支持用户自定义预热 Header,用 JSON 串格式提交。

示例值:{ "Accept-Encoding": [ "gzip" ] }
QueryHashkeyboolean

配置了某些规则(如 URL 重写、参数过滤等)开启使用。该参数用于控制执行预热任务时是否开启 hashkey 查询模式。取值范围:展开详情

示例值:true

返回参数

字段名称字段详情
PreloadTaskIdstring

预热返回的任务 ID,多个任务 ID 用半角逗号(,)分隔。预热返回的任务 ID 会按照以下两条规则对预热任务做合并:展开详情

示例值:95248880
RequestIdstring

请求 ID。

示例值:E5BD4B50-7A02-493A-AE0B-97B9024B4135

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
SingleRequest.OverLimit
A maximum of 1000 URLs are supported for each request.诊断
400
QuotaExceeded.Preload
Your refresh attempts have exceeded the daily limit.诊断
400
InvalidObjectPath.Malformed
The specified ObjectPath is invalid.诊断
400
InvalidExtensiveDomain.ValueNotSupported
The specified ExtensiveDomain is not supported.诊断
400
PreloadQueueFull
The warming queue is full; please try again later.诊断
400
InvalidObjectPath.ExceedsMaximum
The maximum number of urls is exceeded.诊断

变更历史

变更时间变更内容概要操作
2024-11-21
变更错误码400
2024-11-03
新增请求参数QueryHashkey
2023-07-25
删除返回参数
2023-01-11
新增请求参数Headers
新增返回参数

相关示例