Queries the daily quotas and remaining counts for URL and directory refresh, content prefetch, URL blocking, and parameter-ignored refresh operations.
Debugging
DebugRun this operation directly in OpenAPI Explorer. OpenAPI Explorer automatically generates SDK code samples after a successful run.
Authorization information
The following table shows the authorization information for this operation. Use the values in the Operation column in Action policy elements to grant a RAM user or RAM role permission to call this operation.
| Operation | Access level | Resource type | Condition key | Associated operation |
|---|---|---|---|---|
| cdn:DescribeRefreshQuota | get | *All Resources* | none | none |
Request parameters
No request parameters are required for this operation.
Response parameters
| Parameter | Type | Description | Example |
|---|---|---|---|
| PreloadRemain | string | The remaining number of times that you can preload content to L1 nodes on the current day. | 400 |
| BlockRemain | string | The remaining number of URLs that can be blocked on the current day. | 100 |
| RegexRemain | string | The remaining number of URLs that can be refreshed by using regular expressions on the current day. | 10 |
| UrlRemain | string | The remaining number of URLs that can be refreshed on the current day. | 1996 |
| DirRemain | string | The remaining number of directories that can be refreshed on the current day. | 99 |
| UrlQuota | string | The maximum number of URLs that can be refreshed on the current day. | 2000 |
| BlockQuota | string | The maximum number of URLs that can be blocked on the current day. | 300 |
| RequestId | string | The request ID. | 42E0554B-80F4-4921-AED6-ACFB22CAAAD0 |
| DirQuota | string | The maximum number of directories that can be refreshed on the current day. | 100 |
| PreloadEdgeQuota | string | The maximum number of times that you can preload content to L1 points of presence (POPs) on the current day. | 20 |
| PreloadEdgeRemain | string | The remaining number of times that you can preload content to L1 POPs on the current day. | 20 |
| PreloadQuota | string | The maximum number of times that you can preload content to L2 POPs on the current day. | 500 |
| RegexQuota | string | The maximum number of URLs that can be refreshed by using regular expressions on the current day. | 20 |
| IgnoreParamsQuota | string | The maximum number of URLs or directories with parameters ignored that can be refreshed on the current day. | 100 |
| IgnoreParamsRemain | string | The remaining number of URLs or directories with parameters ignored that can be refreshed on the current day. | 10 |
Examples
Sample success responses
JSON format
{
"PreloadRemain": "400",
"BlockRemain": "100",
"RegexRemain": "10",
"UrlRemain": "1996",
"DirRemain": "99",
"UrlQuota": "2000",
"BlockQuota": "300",
"RequestId": "42E0554B-80F4-4921-AED6-ACFB22CAAAD0",
"DirQuota": "100",
"PreloadEdgeQuota": "20",
"PreloadEdgeRemain": "20",
"PreloadQuota": "500",
"RegexQuota": "20",
"IgnoreParamsQuota": "100",
"IgnoreParamsRemain": "10"
}Error codes
For a list of error codes, visit the Service error codes.
Change history
| Change time | Summary of changes | Operation |
|---|---|---|
| 2024-12-18 | API description update | View change details |
| 2023-03-29 | The response structure of the API has changed | View change details |