All Products
Search
Document Center

DescribeVodRefreshQuota

Last Updated: Jul 11, 2019

Description

You can call this operation to query the maximum number and remaining number of requests to refresh URLs and directories or preload URLs on the current day.

You can call the RefreshVodObjectCaches operation to refresh content of a specific URL and call the PreloadVodObjectCaches operation to preload resources from a URL to a node.

Request parameters

Parameter Type Required Description
Action String Yes The operation that you want to perform. Set this parameter to DescribeVodRefreshQuota.

Response parameters

Parameter Type Description
RequestId String The ID of the request.
UrlQuota String The maximum number of requests to refresh URLs on the current day.
DirQuota String The maximum number of requests to refresh directories on the current day.
UrlRemain String The remaining number of requests to refresh URLs on the current day.
DirRemain String The remaining number of requests to refresh directories on the current day.
PreloadQuota String The maximum number of requests to preload URLs on the current day.
PreloadRemain String The remaining number of requests to preload URLs on the current day.

Examples

Sample request

http://vod.cn-shanghai.aliyuncs.com?Action=DescribeVodRefreshQuota
&<Common request parameters>

Note: For more information about common request parameters, see Common parameters.

Sample response

JSON format

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

XML format

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

Error codes

Error code Error message HTTP status code Description
Throttling Request was denied due to request throttling. 503 The error message returned because the request is denied due to throttling.
OperationDenied Your account does not open VOD service yet. 403 The error message returned because ApsaraVideo for VOD has not been activated for your account.
OperationDenied.Suspended Your VOD service is suspended. 403 The error message returned because your account has overdue payments. Recharge your account.