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

使用说明

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

注意事项

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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String RefreshDcdnObjectCaches

系统规定参数。取值:RefreshDcdnObjectCaches

ObjectPath String example.com/example.txt

刷新路径,多个URL用换行符(\n)或(\r\n)分隔。

ObjectType String File

刷新类型。取值范围:

  • File(默认值):URL。
  • Directory:目录。

返回数据

名称 类型 示例值 描述
RefreshTaskId String 95248880

刷新返回的任务ID。多个ID用逗号(,)分隔。

RequestId String E5BD4B50-7A02-493A-AE0B-97B9024B4135

请求ID。

示例

请求示例

http(s)://dcdn.aliyuncs.com/?Action=RefreshDcdnObjectCaches
&ObjectPath=example.com/example.txt
&ObjectType=File
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RefreshDcdnObjectCachesResponse>
	<PushTaskId>95248880</PushTaskId>
	<RequestId>E5BD4B50-7A02-493A-AE0B-97B9024B4135</RequestId>
</RefreshDcdnObjectCachesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
400 SingleRequest.OverLimit A maximum of 1000 URLs are supported for each request. 一次最多只能提交1000个url。
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. 域名正在刷新的个数已经达到上限,请稍后再试。

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