RefreshErObjectCaches - 刷新边缘函数缓存_边缘安全加速(ESA)-阿里云帮助中心

调用RefreshErObjectCaches刷新通过边缘函数 Cache API写入的缓存和通过fetch子请求写入的缓存。支持URL批量刷新。

接口说明

说明

请求方式：支持 POST 请求，参数用 form 表单显示。
相关接口：刷新类接口包含 RefreshDcdnObjectCaches 刷新接口。
URL 刷新配额（每日）：默认情况下，一个账号每日最多可以提交 10000 条 URL 刷新和 100 个目录刷新，目录刷新包含子目录。
每次请求最多支持提交 1000 条 URL 刷新或者 100 个目录刷新。
单个域名每分钟最多支持提交 1000 条 URL 刷新。
单用户调用频率：30 次/秒。

调试

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

调试

授权信息

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

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

dcdn:RefreshErObjectCaches

none

*Domain

acs:dcdn:*:{#accountId}:domain/{#DomainName}

无

请求参数

名称	类型	必填	描述	示例值
ObjectPath	string	是	刷新 URL。说明多个 URL 之间用换行符（\n）或（\r\n）分隔，ObjectPath 的单条长度最长为 1024 个字符。一次请求中的 URL 都必须属于同一个域名。一次请求最多包含 1000 条 URL。	http://example.com/examplefile.txt
ObjectType	string	是	刷新类型。取值范围： File（默认值）：URL。 Directory：目录。 Regex：正则刷新。 IgnoreParams：去参数刷新。去参数指的是去除请求 URL 中`?`及`?`之后的参数，去参数刷新指的是用户先通过接口提交去参数后的 URL，然后用户提交的待刷新 URL 将会与已缓存资源的 URL 进行去参数匹配，如果已缓存资源的 URL 去参数以后与待刷新 URL 匹配，那么 CDN 节点将对缓存资源执行刷新处理。说明目录刷新默认采用标记资源过期的处理方式，不支持删除目录。目录刷新会将节点上对应目录置为过期，后续有用户访问时，DCDN 节点将会回源站校验目录是否更新，有更新时从源站重新拉取新版本返回给用户，未有更新时源站响应 304 状态码。	File
MergeDomainName	string	否	合并刷新域名，刷新的时候会合并域名的调度域节点进行刷新。说明多个域名之间用英文逗号（,）隔开。	a.test.com,b.test.com
RoutineId	string	否	边缘函数脚本的程序 ID，也叫函数 ID，由"Name.Subdomain"组合而成，作为客户边缘函数代码的唯一标识。说明当刷新 Cache API 写入的缓存时，需要指定此字段。当刷新 Fetch 子请求写入的缓存时，不需要指定此字段。	test.mysubdomain
Force	boolean	否	当回源内容和源站资源对比后不一致时，是否刷新对应目录下的资源。默认为 false。 true：刷新对应目录下的全部资源。 false：刷新对应目录下发生变更的资源。	false

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F
RefreshTaskId	string	刷新返回的任务 ID。多个 ID 用逗号（,）分隔。	95248880

示例

正常返回示例

JSON格式

{
  "RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
  "RefreshTaskId": "95248880"
}

错误码

HTTP status code	错误码	错误信息	描述
400	SingleRequest.OverLimit	A maximum of 1000 URLs are supported for each request.
400	InvalidObjectType.Malformed	The specified ObjectType is invalid.	不支持该ObjectType，请重新输入。
400	InvalidObjectPath.Malformed	The specified ObjectPath is invalid.	ObjectPath错误，请填写正确的ObjectPath。
400	InvalidObjectPath.Size.Malformed	The size of ObjectPath is bigger than 1000.
400	QuotaExceeded.Refresh	You've exceeded the prescribed refresh limits.
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.	域名正在刷新的个数已经达到上限，请稍后再试。
400	PreloadQueueFull	Preload queue is full, please try again later!
400	InvalidStations.Malformed	The specified Stations is invalid.
400	InvalidParameters	The parameters you provided are invalid.

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

变更历史

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