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

使用说明

注意事项

  • 提交刷新任务并成功执行后,CDN节点上对应的缓存资源将会失效,当您再次发起访问请求时,节点会回源站拉取所需资源,并重新缓存在节点上,因此大批量提交刷新任务会清空较多缓存,导致回源带宽和请求突增,增加源站压力。
  • 刷新任务从提交到生效,大约需要5~6分钟,如果文件或者目录配置的缓存过期时间少于5分钟,您无需执行刷新操作,等待文件或者目录缓存超时更新即可。
  • 使用RAM用户来执行刷新或预热操作的,需要先获得授权,请参见授予RAM用户刷新预热权限完成授权。
URL刷新配额
  • 默认情况下,一个账号每日最多可以提交10000条URL刷新和100个目录刷新,目录刷新包含子目录。如果您的阿里云账号的日带宽峰值大于200 Mbps,您可以参考配额管理申请提升每日配额,阿里云将根据您业务的实际需求进行评估和配置。
  • 默认情况下,一个账号每日最多可以提交20个正则刷新,如果您的阿里云账号的日带宽峰值大于10 Gbps,您可以通过提交工单来申请提升每日配额。
  • 每次请求最多支持提交1000条URL刷新或者100个目录刷新或者1个正则刷新。
  • 单个域名每分钟最多支持提交1000条URL刷新。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String RefreshObjectCaches

系统规定参数。取值:RefreshObjectCaches

ObjectPath String http://example.com/image/1.png\nhttp://aliyundoc.com/image/2.png

刷新URL,格式为加速域名刷新的文件或目录

多个URL之间使用换行符(\n)或(\r\n)分隔。

ObjectType String File

刷新的类型。取值:

  • File(默认值):文件刷新。
  • Directory:目录刷新。
  • Regex:正则刷新。

文件刷新和目录刷新的功能说明请参考刷新和预热资源,正则刷新的功能说明和操作示例请参考正则刷新说明

目录刷新默认采用标记资源过期的处理方式,不支持删除目录。目录刷新会将节点上对应目录置为过期,后续有用户访问时,CDN节点将会回源站校验目录是否更新,有更新时从源站重新拉取新版本返回给用户,未有更新时源站响应304状态码。

返回数据

名称 类型 示例值 描述
RefreshTaskId String 704222904

刷新返回的任务ID,多个任务ID用半角逗号(,)分隔。刷新返回的任务ID会按照以下两条规则对刷新任务做合并:

  • 同一个域名、同一秒钟提交的刷新任务(URL颗粒度)会被合并为同一个RefreshTaskId。
  • 同一个域名、同一秒钟提交的刷新任务(URL颗粒度)如果超过2000条,那么会按照每2000条合并为一个RefreshTaskId的方式处理。
RequestId String D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C

请求ID。

示例

请求示例

http(s)://cdn.aliyuncs.com/?Action=RefreshObjectCaches
&ObjectPath=http://example.com/image/1.png\nhttp://aliyundoc.com/image/2.png
&ObjectType=File
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RefreshObjectCachesResponse>
<RefreshTaskId>704222904</RefreshTaskId>
<RequestId>D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C</RequestId>
</RefreshObjectCachesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RefreshTaskId" : "704222904",
  "RequestId" : "D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidObjectType.Malformed The specified ObjectType is invalid. 指定的ObjectType无效。

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