调用RefreshDcdnObjectCaches刷新缓存_边缘安全加速(ESA)-阿里云帮助中心

调用RefreshDcdnObjectCaches刷新节点上的文件内容、刷新指定URL内容至Cache节点。支持URL批量刷新。

接口说明

请求方式：支持 POST 请求，参数用 form 表单显示。
相关接口：刷新预热类接口包含 RefreshDcdnObjectCaches 刷新接口和 PreloadDcdnObjectCaches 预热接口。
URL 刷新配额（每日）：默认情况下，一个账号每日最多可以提交 10000 条 URL 刷新和 100 个目录刷新，目录刷新包含子目录。如果您的阿里云账号的日带宽峰值大于 200 Mbps，您可以通过配额管理申请提升每日配额，阿里云将根据您业务的实际需求进行评估和配置。
每次请求最多支持提交 1000 条 URL 刷新或者 100 个目录刷新。
单个域名每分钟最多支持提交 10000 条 URL 刷新。
单用户调用频率：30 次/秒。

注意事项

提交刷新任务并成功执行后，DCDN 节点上对应的缓存资源将会失效，当您再次发起访问请求时，节点会回源站拉取所需资源，并重新缓存在节点上，因此大批量提交刷新任务会清空较多缓存，导致回源带宽和请求突增，增加源站压力。
刷新任务从提交到生效，大约需要 5~6 分钟，如果文件或者目录配置的缓存过期时间少于 5 分钟，您无需执行刷新操作，等待文件或者目录缓存超时更新即可。
使用 RAM 用户来执行刷新或预热操作的，需要先获得授权，请参见授予 RAM 用户刷新预热权限完成授权。

调试

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

调试

授权信息

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

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

操作	访问级别	资源类型	条件关键字	关联操作
dcdn:RefreshDcdnObjectCaches	none	domain `acs:dcdn::{#accountId}:domain/{#domainName}`	无	无

请求参数

名称	类型	必填	描述	示例值
ObjectPath	string	是	单次提交多个 URL 或多个目录时，使用换行符（\n）或（\r\n）分隔。单次提交的任务中所有 URL 的域名个数总和需要在 10 个以内。	example.com/example.txt
ObjectType	string	否	刷新类型。取值范围： File（默认值）：URL。 Directory：目录。 Regex：正则刷新。 IgnoreParams：去参数刷新。去参数指的是去除请求 URL 中`?`及`?`之后的参数，去参数刷新指的是用户先通过接口提交去参数后的 URL，然后用户提交的待刷新 URL 将会与已缓存资源的 URL 进行去参数匹配，如果已缓存资源的 URL 去参数以后与待刷新 URL 匹配，那么 CDN 节点将对缓存资源执行刷新处理。说明 URL 刷新和目录刷新的功能说明请参考刷新和预热资源。文件刷新将直接删除节点上的资源，当有新请求时回源拉取新资源。其它刷新类型默认只刷新发生变更的资源，需要强制刷新请配置 Force 参数为 true，详见 Force 参数说明。	File
Force	boolean	否	当回源内容和源站资源对比一致时，是否刷新对应范围内的资源。默认为 false。 true：刷新对应范围内的全部资源。选择 “刷新全部资源” 时，如果用户请求的内容匹配到了对应范围内的资源，DCDN 节点将会直接回源拉取新资源返回给用户，并重新缓存该资源。 false：刷新对应范围内发生变更的资源。选择 “刷新变更资源” 时，如果用户请求的内容匹配到了对应范围内的资源，DCDN 节点将会回源获取资源的 Last-Modified 信息，若与当前缓存资源一致，则直接返回已缓存资源，若不一致，则回源拉取新资源返回给用户，并重新缓存该资源。说明此参数生效范围：除文件刷新外的刷新类型	false

返回参数

名称	类型	描述	示例值
	object
RefreshTaskId	string	刷新返回的任务 ID。多个 ID 用逗号（,）分隔。	95248880
RequestId	string	请求 ID。	E5BD4B50-7A02-493A-AE0B-97B9024B4135

示例

正常返回示例

JSON格式

{
  "RefreshTaskId": "95248880",
  "RequestId": "E5BD4B50-7A02-493A-AE0B-97B9024B4135"
}

错误码

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	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.	域名正在刷新的个数已经达到上限，请稍后再试。
429	TooManyRequests	Too many requests, please try again later	提交太频繁，请稍候再试

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

变更历史

变更时间	变更内容概要	操作
2023-10-17	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情
2023-07-03	OpenAPI 错误码发生变更	查看变更详情