RefreshDcdnObjectCaches_全站加速_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

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

注意事项

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

流控信息

请求速率为30/1(s)。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

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

请求参数

字段名称字段详情
ObjectPathstring
  • 单次提交多个 URL 或多个目录时,使用换行符(\n)或(\r\n)分隔。展开详情
示例值:example.com/example.txt参考取值来源:
    PreloadDcdnObjectCaches
    RefreshErObjectCaches
ObjectTypestring

刷新类型。取值范围:展开详情

示例值:File参考取值来源:
    RefreshErObjectCaches
Forceboolean

当回源内容和源站资源对比一致时,是否刷新对应范围内的资源。默认为 false。展开详情

示例值:false

返回参数

字段名称字段详情
RefreshTaskIdstring

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

示例值:95248880
RequestIdstring

请求 ID。

示例值:E5BD4B50-7A02-493A-AE0B-97B9024B4135

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
400
SingleRequest.OverLimit
A maximum of 1000 URLs are supported for each request.诊断
400
InvalidObjectType.Malformed
The specified ObjectType is invalid.诊断
400
InvalidObjectPath.Malformed
The specified ObjectPath is invalid.诊断
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
新增请求参数Force
2023-07-03
新增错误码429

相关示例