刷新节点上的文件内容 - CDN

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

使用说明

请求方式：支持POST请求，参数用form表单显示。
相关接口：刷新预热类接口包含RefreshObjectCaches刷新接口和PushObjectCache预热接口。
单用户调用频率：50次/秒。
如果您需要自动化刷新或预热，请参见刷新预热自动化脚本。

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：正则刷新。文件刷新和目录刷新的功能说明请参考刷新和预热资源，正则刷新的功能说明和操作示例请参考正则刷新说明。

返回数据


名称	类型	示例值	描述
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无效。

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