查询刷新预热次数限制和余量 - 视频点播

说明

目前服务地址仅支持：华东2（上海）。
刷新预热类接口包含RefreshVodObjectCaches刷新接口和PreloadVodObjectCaches预热接口。

调试

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

请求参数


名称	类型	是否必选	示例值	描述
Action	String	是	DescribeVodRefreshQuota	系统规定参数。取值：DescribeVodRefreshQuota。

返回数据


名称	类型	示例值	描述
BlockQuota	String	500	当日存储刷新数量上限。
PreloadRemain	String	500	当天剩余预热数量。
RequestId	String	42E0554B-80F4-4921-****-ACFB22CAAAD0	请求ID。
blockRemain	String	500	当日剩余存储刷新数量。
DirRemain	String	99	当日剩余目录刷新数量。
UrlRemain	String	1996	当日剩余URL刷新数量。
DirQuota	String	100	当日路径刷新数量上限。
UrlQuota	String	2000	当日URL刷新数量上限。
PreloadQuota	String	500	当天预热数量上限。

示例

请求示例

https://vod.{ApiRegion}.aliyuncs.com/?Action=DescribeVodRefreshQuota
&<公共请求参数>

正常返回示例

XML格式

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

<DescribeVodRefreshQuotaResponse>
    <DirQuota>100</DirQuota>
    <DirRemain>99</DirRemain>
    <RequestId>A56FC7F8-CA97-482E-****-F77C2135BD22</RequestId>
    <UrlQuota>2000</UrlQuota>
    <UrlRemain>1996</UrlRemain>
    <PreloadQuota>500</PreloadQuota>
    <PreloadRemain>500</PreloadRemain>
</DescribeVodRefreshQuotaResponse>

JSON格式

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

{
  "DirQuota" : "100",
  "DirRemain" : "99",
  "RequestId" : "42E0554B-80F4-4921-****-ACFB22CAAAD0",
  "UrlQuota" : "2000",
  "UrlRemain" : "1996",
  "PreloadQuota" : "500",
  "PreloadRemain" : "500"
}

错误码

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

接口错误码

下表列举了本接口特有的错误码。


错误代码	错误信息	HTTP 状态码	说明
Throttling	Request was denied due to request throttling.	503	请求被流量控制限制。
OperationDenied	Your account does not open VOD service yet.	403	账号未开通视频点播服务。
OperationDenied.Suspended	Your VOD service is suspended.	403	账号已欠费，请充值。