调用RefreshObjectCaches刷新节点上的文件内容。
- 刷新指定URL内容至Cache节点,支持URL批量刷新。
- 支持post请求,参数用form表单。
- 刷新预热类接口包含RefreshObjectCaches刷新接口和 PushObjectCache预热接口。
- 同一个ID每天最多提交预热刷新类请求数量如下。
- URL:2000条。
- 目录:100个。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | RefreshObjectCaches |
操作接口名,系统规定参数。取值:RefreshObjectCaches。 |
ObjectPath | String | 是 | abc.com/image/1.png |
刷新URL,格式为加速域名/刷新的文件或目录。 多个URL之间需要用换行符(\n)或(\r\n)分隔。 |
ObjectType | String | 否 | File |
刷新的类型。
说明 当ObjectType值为Directory时,ObjectPath结尾需加正斜线(/)。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RefreshTaskId | String | 704222904 |
刷新返回的任务ID。 |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
请求ID。 |
示例
请求示例
https://cdn.aliyuncs.com?&Action=RefreshObjectCaches
&ObjectPath=test.example.com/test.txt
&ObjectType=File
&<公共请求参数>
正常返回示例
XML
格式
<RefreshObjectCachesResponse>
<RefreshTaskId>704225667</RefreshTaskId>
<RequestId>AB14769A-A5F2-4CCD-B85B-3368DFF63C0A</RequestId>
</RefreshObjectCachesResponse>
JSON
格式
{
"RefreshTaskId":"704222904","RequestId":"D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | QuotaExceeded.Refresh | You've exceeded the prescribed refresh limits. | 超出当日刷新限制。今日刷新数已用完。您可以通过刷新接口查询今日的刷新次数。 |
400 | ObjectPath.Malformed | The specified value of parameter ObjectPath is malformed. | 参数ObjectPath值格式错误。输入示例:abc.com/image/1.png。多个URL之间需要用换行符(\n 或 \r\n)分隔。 |
400 | InvalidObjectPath.Malformed | The specific value of parameter ObjectPath is malformed. | 参数ObjectPath值格式错误。输入示例:abc.com/image/1.png。多个URL之间需要用换行符(\n 或 \r\n)分隔。 |
400 | InvalidExtensiveDomain.ValueNotSupported | Extensive domain not supported. | 该操作不支持泛域名。 |
400 | QuotaPerMinuteExceeded.Refresh | You've exceeded the prescribed refresh limits per minute. | 每分钟刷新频率超过上限。 |
400 | TooMany.Refresh | there is too many refresh task, please wait a moment. | 刷新任务太多,请您稍后再试。 |
访问错误中心查看更多错误码。