调用RefreshObjectCaches刷新节点上的文件内容。被刷新的文件缓存将立即失效,新的请求将回源获取最新的文件,支持URL批量刷新。
说明
- 支持POST请求,参数用form表单。
- 刷新预热类接口包含RefreshObjectCaches刷新接口和PushObjectCache预热接口。
- 同一个阿里云账号每天最多可以提交2000条URL刷新和100个目录刷新,目录刷新包含子目录。
- 每次请求最多支持提交1000条URL刷新。
- 单个域名每分钟最多支持提交1000条URL刷新。
- 单用户调用频率为50次/秒。
- 如果您需要自动化刷新或预热,请参见刷新预热自动化脚本。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | RefreshObjectCaches |
操作接口名,系统规定参数。取值:RefreshObjectCaches。 |
ObjectPath | String | 是 | abc.com/image/1.png\nabc.com/image/2.png |
刷新URL,格式为加速域名/刷新的文件或目录。 多个URL之间使用换行符(\n)或(\r\n)分隔。 |
ObjectType | String | 否 | File |
刷新的类型。取值:
默认值为File。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RefreshTaskId | String | 704222904 |
刷新返回的任务ID,多个任务ID用英文逗号(,)分隔。 |
RequestId | String | D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C |
请求ID。 |
示例
请求示例
http(s)://cdn.aliyuncs.com/?Action=RefreshObjectCaches
&ObjectPath=abc.com/image/1.png\nabc.com/image/2.png
&ObjectType=File
&<公共请求参数>
正常返回示例
XML
格式
<RefreshObjectCachesResponse>
<RefreshTaskId>704222904</RefreshTaskId>
<RequestId>D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C</RequestId>
</RefreshObjectCachesResponse>
JSON
格式
{
"RefreshTaskId":"704222904",
"RequestId":"D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C"
}
错误码
访问错误中心查看更多错误码。