You need to enable JavaScript to run this app.
导航
内容分发网络
  • 文档首页
    • /
  • 内容分发网络

获取刷新、预热、封禁、解封的配额

最近更新时间：2024.01.25 20:28:20

首次发布时间：2021.07.15 11:09:03

我的收藏

通过 API 请求查询火山引擎账号下每日的刷新、预热任务配额及实时余量。

使用限制

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

请求说明

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

请求参数

Query

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

响应正文

参数名称
数据类型
参数说明
示例
BlockLimit
Long
表示每次可自助封禁的最大 URL 数量。
100
BlockQuota
Long
表示每日可以自助封禁的 URL 数量。
3000
BlockRemain
Long
表示当天剩余可自助封禁的 URL 数量。
3000
PreloadLimit
Long
表示一次预热的最大 URL 数量。
100
PreloadQuota
Long
表示每日可预热的 URL 数量。
1000
PreloadRemain
Long
表示当日剩余的可预热的 URL 数量。
10
RefreshDirLimit
Long
表示一次刷新的最大目录数量。
100
RefreshDirQuota
Long
表示每日可刷新的目录数量。
50
RefreshDirRemain
Long
表示当日剩余的可刷新的目录数量。
15
RefreshQuota
Long
表示每日可刷新的 URL 数量。
1000
RefreshQuotaLimit
Long
表示一次刷新的最大 URL 数量。
100
RefreshRegexLimit
Long
表示一次正则刷新的最大 URL 数量。
10
RefreshRegexQuota
Long
表示每日可用于正则刷新的 URL 数量。
20
RefreshRegexRemain
Long
表示当日剩余的可用于正则刷新的 URL 数量。
2
RefreshRemain
Long
表示当日剩余的可刷新的 URL 数量。
200
UnblockLimit
Long
表示每次可解封的最大 URL 数量。
100
UnblockQuota
Long
表示每日可解封的 URL 数量。
3000
UnblockRemain
Long
表示当日剩余可解封的 URL 数量。
3000

请求示例

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

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202310271225559FCEDC662FFE48246DCB",
        "Action": "DescribeContentQuota",
        "Version": "2021-03-01",
        "Service": "CDN",
        "Region": "cn-north-1"
    },
    "Result": {
        "BlockLimit": 100,
        "BlockQuota": 3000,
        "BlockRemain": 3000,
        "PreloadLimit": 100,
        "PreloadQuota": 1000,
        "PreloadRemain": 1000,
        "RefreshDirLimit": 100,
        "RefreshDirQuota": 50,
        "RefreshDirRemain": 50,
        "RefreshQuota": 1000,
        "RefreshQuotaLimit": 100,
        "RefreshRegexLimit": 10,
        "RefreshRegexQuota": 20,
        "RefreshRegexRemain": 20,
        "RefreshRemain": 1000,
        "UnblockLimit": 100,
        "UnblockQuota": 3000,
        "UnblockRemain": 3000
    }
}

错误码

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