获取 CDN 的计费信息--内容分发网络-火山引擎

文档中心

立即注册

导航

获取 CDN 的计费信息

最近更新时间：2024.06.28 19:18:53首次发布时间：2021.11.11 17:40:22

通过 API 接口查询火山引擎账号的开通服务时间、账户服务状态及计费方式等基础信息。

使用限制

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

请求说明

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

请求参数

Query

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

响应正文

参数名称	数据类型	参数说明	示例
ServiceInfos	Object[]	服务详情

计费方式说明：

BillingDesc	BillingCode	BillingCycle	说明
按流量累计小时结	`Byte_sum_hourly`	`hourly`	流量计费, 按小时结算。
按流量累计	`Byte_sum_daily`	`daily`	流量计费, 按日结算。
按流量累计月结	`Byte_sum_monthly`	`Byte_sum_monthly`	流量计费, 按月结算。
按日峰值带宽计费	`cdn_bandwidth_daily`	`daily`	带宽计费, 按日峰值结算。
按月 95 带宽计费	`cdn_bandwidth_monthly`	`monthly`	带宽计费, 按照月 95 带宽结算。
按日峰值月平均	`cdn_peak_bandwidth_avg_monthly`	`monthly`	带宽计费, 按照每日峰值带宽求平均结算。
按月第四峰值	`cdn_peak_bandwidth_fourth_monthly`	`monthly`	带宽计费, 按照每日峰值带宽取第四大结算。

更多计费统计方式详细说明，可前往计费概览查看。

请求示例

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

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20240402121644FED432FD6DA79E0860CD",
        "Action": "DescribeCdnService",
        "Version": "2021-03-01",
        "Service": "CDN",
        "Region": "cn-north-1"
    },
    "Result": {
        "ServiceInfos": [
            {
                "BeginTime": "2022-01-27 18:28:56",
                "BillingCode": "Byte_sum_hourly",
                "BillingCycle": "hourly",
                "BillingData": "1.10",
                "BillingDesc": "按流量累计小时结",
                "CreateTime": "2022-01-27 18:28:56",
                "InstanceCategory": "service",
                "InstanceType": "formal",
                "MetricType": "flux",
                "ServiceRegion": "chinese_mainland",
                "StartTime": "2022-01-27 18:28:57",
                "Status": "running"
            },
            {
                "BeginTime": "2022-10-13 10:28:37",
                "BillingCode": "QUIC_requests_billing_hourly",
                "BillingCycle": "hourly",
                "BillingData": "1.10",
                "BillingDesc": "QUIC请求数计费小时结",
                "CreateTime": "2022-10-13 10:28:37",
                "InstanceCategory": "quic",
                "InstanceType": "formal",
                "MetricType": "request",
                "ServiceRegion": "chinese_mainland",
                "StartTime": "2022-10-13 10:28:37",
                "Status": "running"
            },
            {
                "BeginTime": "2022-10-13 10:28:37",
                "BillingCode": "QUIC_quic_ov_requests_billing_hourly",
                "BillingCycle": "hourly",
                "BillingData": "1.10",
                "BillingDesc": "海外-QUIC请求数计费小时结",
                "CreateTime": "2022-10-13 10:28:37",
                "InstanceCategory": "quic",
                "InstanceType": "formal",
                "MetricType": "request",
                "ServiceRegion": "outside_chinese_mainland",
                "StartTime": "2022-10-13 10:28:37",
                "Status": "running"
            }
        ]
    }
}

错误码

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