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

调用DescribeVodRefreshQuota查询刷新预热URL及目录的最大限制数量和当日剩余数量。

接口说明

说明

目前服务地址仅支持：华东2（上海）。

刷新预热类接口包含RefreshVodObjectCaches刷新接口和PreloadVodObjectCaches预热接口。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值

当前API无需请求参数

返回参数

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

示例

请求示例

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

正常返回示例

JSON格式

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

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>

错误码

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

接口错误码

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

错误代码	错误信息	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	账号已欠费，请充值。