You need to enable JavaScript to run this app.
内容分发网络

内容分发网络

请输入
  • 文档首页
    • 内容分发网络API 参考内容管理接口DescribeContentQuota - 获取刷新、预热、封禁、解封的配额
复制全文
我的收藏
内容管理接口
DescribeContentQuota - 获取刷新、预热、封禁、解封的配额
复制全文
我的收藏
DescribeContentQuota - 获取刷新、预热、封禁、解封的配额

获取您火山引擎账号下每日的刷新、预热、封禁和解封任务的配额及配额余量。

说明

目录封禁和目录解封的相关配额默认为 0，请 提交工单 提升配额。

使用限制

节流限制：您每秒最多可以发送 20 个请求。

请求说明

  • 请求方式：POST
  • 请求地址：https://cdn.volcengineapi.com/?Action=DescribeContentQuota&Version=2021-03-01

请求参数

Query

参数名称
数据类型
是否必选
参数说明
Action
String
是
接口名称。当前 API 的名称为 DescribeContentQuota。
Version
String
是
接口版本。当前 API 的版本为 2021-03-01。

返回参数

参数名称
数据类型
参数说明
示例
BlockQuota
Long
表示每日可封禁的 URL 数量。
3000
BlockLimit
Long
表示每次可封禁的最大 URL 数量。
100
BlockRemain
Long
表示当天可封禁的 URL 剩余数量。
3000
BlockDirQuota
Long
表示每日可封禁的目录数量。默认值为 0，请提交工单提升额度。
10
BlockDirLimit
Long
目录封禁提交单次限制。
2
BlockDirRemain
Long
表示当天可封禁的目录剩余数量。
3
UnblockQuota
Long
表示每日可解封的 URL 数量。
3000
UnblockLimit
Long
表示每次可解封的最大 URL 数量。
100
UnblockRemain
Long
表示当天可解封的 URL 剩余数量。
3000
UnblockDirQuota
Long
表示每日可解封的目录数量。
10
UnblockDirLimit
Long
表示每次可解封的最大目录数量。
2
UnblockDirRemain
Long
表示当天可解封的目录剩余数量。
3
PreloadQuota
Long
表示每日可预热的 URL 数量。
1000
PreloadLimit
Long
表示每次可预热的最大 URL 数量。
100
PreloadRemain
Long
表示当天可预热的 URL 剩余数量。
10
RefreshDirQuota
Long
表示每日可刷新的目录数量。
50
RefreshDirLimit
Long
表示每次可刷新的最大目录数量。
100
RefreshDirRemain
Long
表示当天可刷新的目录剩余数量。
15
RefreshQuota
Long
表示每日可刷新的 URL 数量。
10000
RefreshQuotaLimit
Long
表示每次可刷新的最大 URL 数量。
100
RefreshRemain
Long
表示当天可刷新的 URL 剩余数量。
200
RefreshRegexQuota
Long
表示每日可使用正则表达式刷新的 URL 数量。
20
RefreshRegexLimit
Long
表示每次可使用正则表达式刷新的最大 URL 数量。
10
RefreshRegexRemain
Long
表示当天可使用正则表达式刷新的 URL 剩余数量。
2

请求示例 

POST https://cdn.volcengineapi.com/?Action=DescribeContentQuota&Version=2021-03-01

返回示例 

{
    "ResponseMetadata": {
        "RequestId": "2026012914181527169F18F2D86056F058",
        "Action": "DescribeContentQuota",
        "Version": "2021-03-01",
        "Service": "CDN",
        "Region": "cn-north-1"
    },
    "Result": {
        "BlockDirLimit": 0,
        "BlockDirQuota": 0,
        "BlockDirRemain": 0,
        "BlockLimit": 100,
        "BlockQuota": 3000,
        "BlockRemain": 3000,
        "PreloadLimit": 100,
        "PreloadQuota": 1001,
        "PreloadRemain": 1001,
        "RefreshDirLimit": 100,
        "RefreshDirQuota": 50,
        "RefreshDirRemain": 50,
        "RefreshQuota": 10000,
        "RefreshQuotaLimit": 100,
        "RefreshRegexLimit": 10,
        "RefreshRegexQuota": 20,
        "RefreshRegexRemain": 20,
        "RefreshRemain": 10000,
        "UnblockDirLimit": 0,
        "UnblockDirQuota": 0,
        "UnblockDirRemain": 0,
        "UnblockLimit": 100,
        "UnblockQuota": 3000,
        "UnblockRemain": 3000
    }
}

错误码

如果响应正文的 ResponseMetadata 字段中包含 Error 字段，则表示 API 请求失败。更多关于错误码的信息，参见错误码。

最近更新时间：2026.01.29 19:01:02
这个页面对您有帮助吗？
有用
有用
无用
无用