开发者社区 问答 正文

如何刷新缓存?



描述


刷新节点上的文件内容。刷新指定URL内容至Cache节点,支持URL批量刷新。
限制:

  • 同一个 ID 每天最多提交预热刷新类请求数量:URL:2000条;目录:100个。
  • 刷新预热类接口包含 RefreshObjectCaches 刷新接口和 PushObjectCache 预热接口


请求参数

参数类型必要描述
ActionString操作接口名,系统规定参数,取值:RefreshObjectCaches
ObjectPathString输入示例:abc.com/image/1.png,多个URL之间需要用换行符(\n或\r\n)分隔
ObjectTypeString可选, 刷新的类型, 其值可以为File | Directory,默认是File。


返回参数

名称类型描述
RefreshTaskIdString刷新返回的任务ID,多个任务ID用逗号(半角)分隔


特定错误码

ErrorCode 错误码Message 错误信息HTTP 状态语义
ThrottlingRequest was denied due to request throttling.503请求被流量控制限制
IllegalOperationIllegal domain operate is not permitted.403非法域名, 无法操作
OperationDeniedYour account does not open CDN service yet.403未开通CDN服务
OperationDeniedYour CDN service is suspended.403CDN服务已被停止
InvalidDomain.NotFoundThe domain provided does not belong to you.404域名不存在或不属于当前用户
InvalidDomain.OfflineThe domain provided is offline.404域名已下线
QuotaExceeded.RefreshYou’ve exceeded the prescribed refresh limits.400超出当日刷新限制
ServiceBusyThe specified Domain is configuring, please retry later.403域名正在配置中, 请稍后再试
InvalidDomain.Configure_failedFailed to configure the provided domain.500域名配置失败, 无法刷新
MissingParameterThe input parameter “ObjectPath” that is mandatory for processing this request is not supplied.400缺少ObjectPath参数
InvalidObjectType.ValueNotSupportedThe specified value of "<ObjectType>" is not supported.400ObjectType值不支持
InvalidObjectPath.MalformedThe specific value of parameter ObjectPath is malformed.400ObjectPath值格式错误
InvalidExtensiveDomain.ValueNotSupportedExtensive domain not supported.400不支持泛域名


示例


请求示例 https://cdn.aliyuncs.com?&Action=RefreshObjectCaches&ObjectPath=test.test.com/test.txt&ObjectType=File&<公共请求参数>

返回示例
JSON格式: {
"RefreshTaskId":"704222904","RequestId":"D61E4801-EAFF-4A63-AAE1-FBF6CE1CFD1C"
}


XML格式: <?xml version="1.0" encoding="utf-8"?>
<RefreshObjectCachesResponse>
  <RefreshTaskId>704225667</RefreshTaskId>
  <RequestId>AB14769A-A5F2-4CCD-B85B-3368DFF63C0A</RequestId>
</RefreshObjectCachesResponse>

展开
收起
青衫无名 2017-10-24 10:18:31 4465 分享 版权
阿里云 AI 助理回答

根据您提供的信息,这是关于阿里云CDN(内容分发网络)服务中刷新节点文件内容的接口描述。下面是对该接口使用的详细说明:

接口功能

此接口用于将指定的URL内容更新到CDN的缓存节点上,支持单个URL或目录的批量刷新操作,确保用户访问时获取的是最新的内容。

请求参数

  • Action: 必填参数,固定值为RefreshObjectCaches,表示执行刷新操作。
  • ObjectPath: 必填参数,输入需要刷新的URL或目录路径,多个URL之间需要用换行符(\n\r\n)分隔。例如:abc.com/image/1.png
  • ObjectType: 可选参数,指定刷新类型,可选值为File(文件)或Directory(目录),默认为File

返回参数

  • RefreshTaskId: 刷新操作返回的任务ID,如果提交了多个刷新请求,任务ID之间用逗号分隔。您可以使用这个ID来追踪刷新任务的状态。

限制

  • 每个账号每天针对同一ID最多能提交2000条URL刷新请求和100个目录刷新请求。

特定错误码

列举了一些可能遇到的错误码及其含义,例如: - Throttling: 请求被流量控制限制,HTTP状态码503。 - IllegalOperation: 非法域名操作,403错误。 - QuotaExceeded.Refresh: 超出当日刷新限制,400错误等。

示例请求

完整的请求示例应包含所有必要的请求头、认证信息(如AccessKeyId、Signature等)以及上述提到的请求参数。一个基本的请求URL结构如下,但请注意,实际请求还需通过签名等处理以符合阿里云API调用规范:

https://cdn.aliyuncs.com/?Action=RefreshObjectCaches&ObjectPath=abc.com/image/1.png%0Aabc.com/image/2.png&<其他必要参数及签名信息>

请确保在实际调用前,阅读并遵循阿里云CDN API文档中的安全与认证要求,正确构造签名字符串,并处理好字符编码等问题。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答
问答标签:
问答地址: