接口描述
FlushOrPushOverall 用于一次性同时刷新或预热境外、大陆资源。
请求域名:
cdn.api.qcloud.com
Note:
提交预热请求前请确保账户已经开通预热白名单。
提交刷新/预热任务时,请确保加速域名已经在指定区域(大陆/境外)接入,并处于“已启用”或“部署中”状态。
提交的 URL 列表需要以 http:// 或是 https:// 开头。
刷新/预热每次、每日使用均有限额,您可以前往 CDN 控制台 查看您的限额情况。
调用频次限制为100次 / 分钟。
接口暂不支持子账号调用。
入参说明
参数名称 | 是否必选 | 类型 | 描述 |
command | 是 | String | 指定要进行的操作<br/> "push":表示预热<br/> "flush 表示刷新 |
urls | 是 | Array | 提交的刷新/预热 URL 清单 |
type | 是 | String | 刷新/预热类型<br/>"dir":表示目录<br/>"url": 表示资源全路径<br/>预热暂时不支持目录方式 |
mainland | 否 | Int | 填充1表示刷新/预热大陆<br/>若不填充则表示大陆无提交操作 |
oversea | 否 | Int | 填充1表示刷新/预热境外<br/>若不填充则表示境外无提交操作 |
详细说明
mainland 和 oversea 参数必须有一个填充1,才可成功提交。
出参说明
调用案例
示例参数
command:flushurls.0:https://www.test.com/1.jpgtype:urlmainland:1
GET 请求
GET 请求需要将所有参数都加在 URL 后(key = value 形式,value 需要进行 URL encode):
https://cdn.api.qcloud.com/v2/index.php?Action=FlushOrPushOverall&SecretId=XXXXXXXXXXXXXXXXXXXXXXXXXXX&Nonce=123456789&Timestamp=1511794466&command=flush&urls.0=https://www.test.com/1.jpg&type=url&mainland=1&Signature=XXXXXXXXXXXXXXXXXXXXXXXXXXX
POST 请求
POST 请求时,参数填充在 HTTP Requestbody 中,请求地址:
https://cdn.api.qcloud.com/v2/index.php
参数支持 formdata 等格式,参数数组如下:
array ('Action' => 'FlushOrPushOverall','SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX','Timestamp' => 1511794466,'Nonce' => 123456789,'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX','command' => 'flush','urls.0' => 'https://www.test.com/1.jpg','type' => 'url','mainland' => '1')
返回示例
{"code": 0,"message": "","codeDesc": "Success"}