开发者社区 问答 正文

如何查询操作余量?



描述

  • 刷新(包含预热)URL及目录的最大限制数量
  • 当日剩余刷新(含预热)URL及目录的次数

限制:
  • 刷新预热类接口包含 RefreshObjectCaches 刷新接口和 PushObjectCache 预热接口


请求参数

参数类型必要描述
ActionString操作接口名,系统规定参数,取值:DescribeRefreshQuota


返回参数

名称类型描述
RequestIdString请求ID
UrlQuotaString刷新(含预热)URL次数上限
DirQuotaString刷新目录次数上限
UrlRemainString当日剩余刷新(含预热)URL次数
DirRemainString当日剩余刷新目录次数


错误码

ErrorCode 错误码Message 错误信息HTTP 状态语义
ThrottlingRequest was denied due to request throttling.503请求被流量控制限制
OperationDeniedYour account does not open CDN service yet.403未开通CDN服务
OperationDeniedYour CDN service is suspended.403CDN服务已被停止


示例


请求示例: http://cdn.aliyuncs.com?Action=DescribeRefreshQuota&<公共请求参数>

返回示例:
JSON格式 {
    "DirQuota": "100",
    "DirRemain": "99",
    "RequestId": "42E0554B-80F4-4921-AED6-ACFB22CAAAD0",
    "UrlQuota": "2000",
    "UrlRemain": "1996"
}


XML格式: <DescribeRefreshQuotaResponse>
  <DirQuota>100</DirQuota>
  <DirRemain>99</DirRemain>
  <RequestId>A56FC7F8-CA97-482E-9649-F77C2135BD22</RequestId>
  <UrlQuota>2000</UrlQuota>
  <UrlRemain>1996</UrlRemain>
</DescribeRefreshQuotaResponse>

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

这个描述是关于阿里云CDN(内容分发网络)服务中刷新和预热功能的接口使用说明,以及相关参数、限制、返回值和可能遇到的错误码。下面我将为您详细解释这些内容:

刷新与预热概念

  • 刷新:当您有静态资源(如图片、CSS、JavaScript文件等)更新时,通过刷新操作可以立即使CDN节点上的旧版本内容失效,并从源站获取最新内容,确保用户访问到的是最新的资源。
  • 预热:预热是指在内容正式发布前或预见高流量访问前,提前将静态资源加载到CDN边缘节点上,减少用户首次访问时的延迟。

接口说明

  • RefreshObjectCaches:用于刷新单个URL指向的资源。
  • PushObjectCache:用于预热指定的URL或目录,即将其内容预先加载到CDN节点。

请求参数

  • Action: 必填参数,指定要执行的操作,例如DescribeRefreshQuota用于查询刷新和预热的配额及剩余次数。

返回参数

  • RequestId:请求的唯一标识。
  • UrlQuota:允许的最大刷新(含预热)URL次数上限。
  • DirQuota:允许的最大刷新目录次数上限。
  • UrlRemain:当日剩余可使用的刷新(含预热)URL次数。
  • DirRemain:当日剩余可刷新目录的次数。

错误码示例

  • Throttling:503状态码,表示请求因流量控制被拒绝,即请求过于频繁,需降低请求频率。
  • OperationDenied: Your account does not open CDN service yet.:403状态码,表示您的账号尚未开通CDN服务。
  • OperationDenied: Your CDN service is suspended.:403状态码,表示您的CDN服务已被暂停。

示例请求

http://cdn.aliyuncs.com?Action=DescribeRefreshQuota

此请求用于查询当前账户的刷新和预热配额及剩余次数。

综上所述,如果您需要管理阿里云CDN资源的刷新和预热操作,可以通过调用相应接口并关注返回的配额信息及错误提示来高效地进行内容更新和优化用户体验。记得根据实际需求合理安排刷新和预热策略,避免因请求过多导致限流。

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