调用RefreshObjectCaches刷新节点上的文件内容。被刷新的文件缓存将立即失效，新的请求将回源获取最新的文件，支持URL批量刷新。

说明
  • 支持POST请求，参数用form表单。
  • 刷新预热类接口包含RefreshObjectCaches刷新接口和PushObjectCache预热接口。
  • 同一个阿里云账号每天最多可以提交2000条URL刷新和100个目录刷新，目录刷新包含子目录。如果您的阿里云账号的日带宽峰值大于200 Mbps，您可以参考配额管理申请提升每日配额，阿里云将根据您业务的实际需求进行评估和配置。
  • 每次请求最多支持提交1000条URL刷新或者1000条目录刷新。
  • 单个域名每分钟最多支持提交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：文件。
  • Directory：目录。

默认值为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"
}

错误码

HttpCode 错误码 错误信息 描述
400 SingleRequest.OverLimit A maximum of 1000 URLs are supported for each request. 每个请求最多支持1000个URL。
400 InvalidObjectType.Malformed The specified ObjectType is invalid. 指定的ObjectType无效。

访问错误中心查看更多错误码。