调用PushObjectCache将源站的内容主动预热到L2缓存节点上。您首次访问可直接命中缓存,缓解源站压力。
说明
- 请求方式:支持POST请求,参数用form表单显示。
- 相关接口:刷新预热类接口包含RefreshObjectCaches刷新接口和PushObjectCache预热接口。
- URL预热配额(每日):默认情况下,一个账号每日最多可以提交1000条URL预热任务,如果您账号的日带宽峰值大于200 Mbps,可通过配额管理申请提升每日配额,阿里云将根据您业务的实际需求进行评估和配置。
- 每次最多可以提交100条URL预热任务。
- 预热队列规则:每个账号的预热队列最大为50000条URL,CDN根据URL提交的先后顺序进行预热,当预热队列中未完成的任务达到了50000条URL时,阿里云CDN将会采取排队机制(即完成排序最前的一条URL预热后才可以继续提交下一条URL预热)完成预热。
- 预热速度:预热任务的执行速度与需要预热资源的文件平均大小有关,文件平均大小越小,预热速度越快,反之越慢。
- 单用户调用频率:50次/秒。
- 如果您需要自动化刷新或预热,请参见刷新预热批处理脚本。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | PushObjectCache |
系统规定参数。取值:PushObjectCache。 |
ObjectPath | String | 是 | example.com/image/1.png\example.org/image/2.png |
预热URL,格式为加速域名或预热的文件。 说明 多个URL之间用换行符(\n)或(\r\n)分隔,ObjectPath的单条长度最长为1024个字符。
|
Area | String | 否 | domestic |
预热区域。取值:
如果不传该参数,默认的预热区域为您的域名所配置的CDN加速区域。具体如下:
|
L2Preload | Boolean | 否 | true |
是否直接预热到L2节点。取值:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
PushTaskId | String | 9524xxxx |
预热返回的任务ID,多个任务ID用半角逗号(,)分隔。预热返回的任务ID会按照以下两条规则对预热任务做合并:
|
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
请求ID。 |
示例
请求示例
http(s)://cdn.aliyuncs.com/?Action=PushObjectCache
&ObjectPath=example.com/image/1.png\example.org/image/2.png
&<公共请求参数>
正常返回示例
XML
格式
<PushObjectCacheResponse>
<PushTaskId>9524xxxx</PushTaskId>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</PushObjectCacheResponse>
JSON
格式
{
"PushTaskId": "9524xxxx",
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | SingleRequest.OverLimit | A maximum of 1000 URLs are supported for each request. | 每个请求最多支持1000个URL。 |
400 | QuotaExceeded.Preload | Your preload attempts have exceeded the daily limit. | 超出当日预热额度限制。 |
访问错误中心查看更多错误码。