使用RefreshVodObjectCaches刷新CDN文件缓存-视频点播-阿里云-视频点播(VOD)-阿里云帮助中心

接口说明

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

vod:RefreshVodObjectCaches

update

*全部资源

*

无

名称	类型	必填	描述	示例值
ObjectPath	string	是	预热文件 URL。多个 URL 使用换行符（\n 或\r\n）分隔。	abc.com/image/1.png
ObjectType	string	否	刷新的类型。取值： File（默认值）：文件刷新。 Directory：目录刷新。 Regex：正则刷新。 IgnoreParams：去参数刷新。去参数指的是去除请求 URL 中?及?之后的参数，去参数刷新指的是用户先通过接口提交去参数后的 URL，然后用户提交的待刷新 URL 将会与已缓存资源的 URL 进行去参数匹配，如果已缓存资源的 URL 去参数以后与待刷新 URL 匹配，那么 CDN 节点将对缓存资源执行刷新处理。	File
Force	boolean	否	当回源内容和源站资源对比后不一致时，是否刷新对应目录下的资源。默认为 false。 true：刷新对应目录下的全部资源。选择 “刷新全部资源” 时，如果用户请求的内容匹配到了目录下的资源，CDN 节点将会直接回源拉取新资源返回给用户，并重新缓存该资源。 false：刷新对应目录下发生变更的资源。选择 “刷新变更资源” 时，如果用户请求的内容匹配到了目录下的资源，CDN 节点将会回源获取资源的 Last-Modified 信息，若与当前缓存资源一致，则直接返回已缓存资源，若不一致，则回源拉取新资源返回给用户，并重新缓存该资源。	false

名称	类型	描述	示例值
	object
RefreshTaskId	string	刷新返回的任务 ID。多个任务 ID 用半角逗号（,）分隔。刷新返回的任务 ID 会按照以下两条规则对刷新任务做合并：同一个域名、同一秒钟提交的刷新任务（URL 颗粒度）会被合并为同一个 RefreshTaskId。同一个域名、同一秒钟提交的刷新任务（URL 颗粒度）如果超过 2000 条，那么会按照每 2000 条合并为一个 RefreshTaskId 的方式处理。	70422*****2904
RequestId	string	请求 ID。	D61E4801-EAFF-4A63-****-FBF6CE1CFD1C

正常返回示例

JSON格式

{
  "RefreshTaskId": "70422*****2904",
  "RequestId": "D61E4801-EAFF-4A63-****-FBF6CE1CFD1C"
}

HTTP status code	错误码	错误信息	描述
400	SingleRequest.OverLimit	A maximum of 1000 URLs are supported for each request.
400	InvalidObjectType.Malformed	The specified ObjectType is invalid.
400	QuotaExceeded.Refresh	Your refresh attempts have exceeded the daily limit.	超出当日刷新额度限制。
400	InvalidObjectPath.Malformed	The specified ObjectPath is invalid.	参数ObjectPath无效。
400	InvalidExtensiveDomain.ValueNotSupported	The specified ExtensiveDomain is not supported.
400	QuotaPerMinuteExceeded.Refresh	You tried to refresh too frequently; please try again later.
400	TooMany.Refresh	The refresh queue is full; please try again later.
404	InvalidDomain.NotFound	The domain provided does not belong to you.
404	InvalidDomain.Offline	The domain provided is offline.

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

更多信息，参考变更详情。