接口描述
CdnPusherV2 将指定 URL 资源主动推送至 CDN 节点。
请求域名:
cdn.api.qcloud.com
默认情况下,每一个账号每日可预热资源1000条,每次最多可提交20条。
内测用户子账号可使用自有 SecretId、SecretKey 预热有权限的资源。
提交的 URL 必须以
http://
或 https://
开头。提交的 URL 中域名的状态需要为【已启动】或【部署中】。
预热会导致回源带宽较高,请根据源站带宽来拆分提交预热任务。
调用频次限制为10000次/分钟。
接口已支持子账号调用。
入参说明
参数名称 | 是否必选 | 类型 | 描述 |
urls.n | 是 | Array | 需要进行预热的资源 URL 列表 |
limitRate | 否 | Int | 预热限速(单位为Mbps)<br/>最小限速为1Mbps |
详细说明
限速是针对域名维度进行,若设置了限速为1Mbps,假设预热资源
http://www.abc.com/1.mkv
时,向域名 www.abc.com
配置的源站拉取资源时,全网节点总回源速度会控制在1Mbps左右。提交的 URL 会根据域名聚合为不同的 task,返回多个 task_id。
出参说明
data 详细说明
参数名称 | 类型 | 描述 |
task_ids | Object | 提交的任务 ID 信息。 |
task_ids 详细说明
参数名称 | 类型 | 描述 |
task_id | Int | 提交的任务 ID。 |
date | String | 提交任务的日期。 |
调用案例
示例参数
> urls.0: http://www.test.com/1.jpg> urls.1: http://www.abc.com/1.jpg> limitRate: 1
GET 请求
GET 请求需要将所有参数都加在 URL 后:
https://cdn.api.qcloud.com/v2/index.php?Action=CdnPusherV2&SecretId=XXXXXXXXXXXXXXXXXXXXXXXXXXXXX&Timestamp=1462436277&Nonce=123456789&Signature=XXXXXXXXXXXXXXXXXXXXX&urls.0=http://www.test.com/1.jpg&urls.1=http://www.abc.com/1.jpg&limitRate=1
Note:
GET 请求大小限制为32KB,超出大小限制则会返回状态码501。若需提交较多 URL,可采用 POST 请求。
POST请求
POST 请求时,参数填充在 HTTP Requestbody 中,请求地址:
https://cdn.api.qcloud.com/v2/index.php
参数支持 form-data 等格式,参数数组如下:
array ('Action' => 'CdnPusherV2','SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX','Timestamp' => 1462782282,'Nonce' => 123456789,'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX','urls.0' => 'http://www.test.com/1.jpg','urls.1' => 'http://www.abc.com/1.jpg','limitRate' => 1)
Note:
POST 请求大小限制为1MB,超出大小限制则会返回状态码501。若需提交较多 URL,请拆分为多批次提交。
返回示例
{"code": 0,"message": "","codeDesc": "Success","data": {"task_ids": [{"task_id": 41773,"date": "20180327"},{"task_id": 41774,"date": "20180327"}]}}