You need to enable JavaScript to run this app.
导航
按云服务商查询刷新与预热任务配额
最近更新时间:2024.04.22 11:04:22首次发布时间:2022.07.28 21:39:27

调用本接口查询指定云服务商账号的刷新和预热任务配额及余量。
多云CDN调用云服务商提供的刷新与预热任务配额查询接口,以获取相关数据。

使用说明

每个请求中必须包含鉴权信息。该鉴权信息用以验证请求者的身份。参见签名机制

使用限制

  • 节流限制:您每秒最多可以提交 30 个 API 请求。
  • 云服务商平台接口限制:
    以下云服务商产品不支持刷新与预热任务配额查询功能:
    • 腾讯云—EdgeOne
    • Google Cloud—Media CDN

请求说明

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

请求参数

Query

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

Body

参数名称
数据类型
是否必选
参数说明
示例
CloudAccountId
String

指定要查询的云服务商账号的 ID。您可以指定一个或多个账号 ID。多个账号 ID 之间使用半角逗号(,)分隔。

说明

您可以调用 ListCloudAccounts 接口查询多云CDN中的所有云服务商账号 ID。

655372daa21faa599668****

响应正文

参数名称
数据类型
参数说明
示例
Quotas
Object[]
从云服务商平台获得的刷新和预热任务配额信息。
VendorsMetaData
Object[]
多云CDN未能从云服务商平台获得任务配额信息的情形下,所返回的原始请求信息。

请求示例

POST https://open.volcengineapi.com/?Action=DescribeContentQuota&Version=2022-03-01&<其他公共请求参数> 
{
    "CloudAccountId": "655372daa21faa599668****"
}

返回示例

{
    "ResponseMetadata": {
        "RequestID": "202402191705048E2CAAFB495BA25A9170",
        "Action": "DescribeContentQuota",
        "Version": "2022-03-01",
        "Service": "mcdn",
        "Region": "cn-north-1"
    },
    "Result": {
        "Quotas": [
            {
                "RefreshUrlQuota": 2000000,
                "RefreshUrlRemain": 1999096,
                "RefreshDirQuota": 10000,
                "RefreshDirRemain": 9370,
                "PreloadQuota": 10000000,
                "PreloadRemain": 9999536,
                "Area": "",
                "Vendor": "volcengine",
                "CloudAccountId": "655372daa21faa599668****",
                "CloudAccountName": "volctest",
                "ProductType": "cdn",
                "SubProduct": "cdn"
            },
            {
                "RefreshUrlQuota": 10000,
                "RefreshUrlRemain": 10000,
                "RefreshDirQuota": 100,
                "RefreshDirRemain": 100,
                "PreloadQuota": 1000,
                "PreloadRemain": 1000,
                "Area": "",
                "Vendor": "volcengine",
                "CloudAccountId": "655372daa21faa599668****",
                "CloudAccountName": "volctest",
                "ProductType": "dcdn",
                "SubProduct": "dcdn"
            }
        ],
        "VendorsMetaData": []
    }
}

错误码

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