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

调用RefreshErObjectCaches刷新通过边缘函数 Cache API写入的缓存。支持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"组合而成，作为客户边缘函数代码的唯一标识。	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	错误码	错误信息	描述

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	QuotaExceeded.Refresh	Your refresh attempts have exceeded the daily limit.	超出当日刷新限制。今日刷新数已用完。您可以通过刷新接口查询今日的刷新次数。
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	InvalidExtensiveDomain.ValueNotSupported	Extensive domain not supported.	-
400	PreloadQueueFull	Preload queue is full, please try again later!	-
400	QuotaPerMinuteExceeded.Refresh	You've exceeded the prescribed refresh limits per minute.	-
400	InvalidStations.Malformed	The specified Stations is invalid.	-
400	InvalidParameters	The parameters you provided are invalid.	-

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

变更历史

变更时间	变更内容概要	操作

变更时间	变更内容概要	操作

暂无变更历史