动态与公告

产品动态

安全公告

产品公告

产品简介

产品概述

产品优势

应用场景

EdgeOne 与 CDN 等产品功能对比

使用限制

购买指南

试用套餐体验权益说明

免费版套餐使用说明

计费概述

计费项目

购买指引

续费指引

欠费与退款说明

套餐选型对比

关于“干净流量”计费说明

DDoS 防护容量说明

快速入门

选择业务场景

快速接入网站安全加速

通过 Pages 快速部署网站

域名服务与源站配置

域名服务

HTTPS 证书

源站配置

站点加速

概述

访问控制

智能加速

缓存配置

文件优化

网络优化

URL 重写

修改头部

修改应答内容

规则引擎

图片与视频处理

单连接下载限速

DDoS 与 Web 防护

概述

DDoS 防护

Web 防护

Bot 管理

API 资产识别（Beta）

边缘函数

概述

快速指引

操作指引

Runtime APIs

示例函数

实践教程

Pages

四层代理

概述

新建四层代理实例

修改四层代理实例配置

停用/删除四层代理实例

批量配置转发规则

获取客户端真实IP

数据分析与日志服务

日志服务

数据分析

告警服务

站点与计费管理

计费管理

站点管理

版本管理

通用策略

通用参考

配置语法

请求与响应行为

国家/地区及对应代码枚举

Terraform

Terraform 简介

安装和配置 Terraform

实践教程

自动预热/清除缓存

防盗刷/盗链实践

HTTPS 相关实践

加速优化

流量调度

数据分析与告警

第三方日志平台集成实践

对象存储类源站（例如：COS）配置实践

跨域响应配置

API 文档

History

Introduction

API Category

Making API Requests

Site APIs

Acceleration Domain Management APIs

Site Acceleration Configuration APIs

Edge Function APIs

Alias Domain APIs

Security Configuration APIs

Layer 4 Application Proxy APIs

Content Management APIs

Data Analysis APIs

Log Service APIs

Billing APIs

Certificate APIs

Origin Protection APIs

Load Balancing APIs

Diagnostic Tool APIs

Custom Response Page APIs

API Security APIs

DNS Record APIs

Content Identifier APIs

Legacy APIs

Ownership APIs

Image and Video Processing APIs

Multi-Channel Security Gateway APIs

Version Management APIs

Data Types

Error Codes

常见问题

产品特性相关问题

DNS 记录相关问题

域名配置相关问题

站点加速相关问题

数据与日志相关问题

安全防护相关问题

源站配置相关问题

排障指南

异常状态码参考

EdgeOne 4XX/5XX 状态码排障指南

520/524状态码排障指南

521/522 状态码排障指南

工具指南

DescribeBillingData

PDF

聚焦模式

字号

最后更新时间： 2025-10-30 22:03:02

1. API Description

Domain name for API request: teo.intl.tencentcloudapi.com.

This API is used to query billing data.

A maximum of 50 requests can be initiated per second for this API.

We recommend you to use API Explorer

Try it

API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name	Required	Type	Description
Action	Yes	String	Common Params. The value used for this API: DescribeBillingData.
Version	Yes	String	Common Params. The value used for this API: 2022-09-01.
Region	No	String	Common Params. This parameter is not required.
StartTime	Yes	Timestamp ISO8601	The start time. Data will be returned according to the timezone of the input timestamp.
EndTime	Yes	Timestamp ISO8601	The end time. The query time range (`EndTime` - `StartTime`) must be less than or equal to 31 days. The timezone of the end timestamp must be consistent with the start timestamp, and data will be returned according to the timezone of the input timestamps.
ZoneIds.N	Yes	Array of String	Site ID set. This parameter is required. A maximum of 100 site ids can be imported. Use `*` to query data for all sites under the Tencent Cloud root account. Querying account-level data requires permissions for all site resources in this API.
MetricName	Yes	String	Metric list. Values as follows:. L4/L7 acceleration traffic: acc_flux: specifies content acceleration traffic in bytes. smt_flux: specifies smart acceleration traffic in bytes. l4_flux: specifies layer 4 acceleration traffic in bytes. sec_flux: specifies independent protection traffic in bytes. zxctg_flux: specifies network optimization traffic in the chinese mainland in bytes. L4/L7 acceleration bandwidth: acc_bandwidth: specifies content acceleration bandwidth in bps. smt_bandwidth: specifies intelligent acceleration bandwidth in bps. l4_bandwidth: specifies layer 4 acceleration bandwidth in bps. sec_bandwidth: specifies exclusive protection bandwidth in bps. zxctg_bandwidth: specifies network optimization bandwidth in the chinese mainland in bps. HTTP/HTTPS security requests: sec_request_clean: specifies HTTP/HTTPS requests by count. Value-added service usage: smt_request_clean: specifies intelligent acceleration requests by count. quic_request: specifies quic requests by count. bot_request_clean: specifies bot requests by count. cls_count: specifies the number of real-time log pushes by count. ddos_bandwidth: specifies elastic ddos protection bandwidth in bps. Edge computing usage: edgefunction_request: specifies the number of edge function requests by count. edgefunction_cpu_time: specifies edge function cpu processing time in milliseconds. Media processing usage: total_transcode: all specification audio, video jit transcoding, repackaging duration, in seconds; remux: repackaging duration, in seconds; transcode_audio: audio transcoding duration, in seconds; transcode_H264_SD: H.264 encoded standard-definition video (short side less than or equal to 480 px) duration, in seconds; transcode_H264_HD: H.264 encoded high-definition video (short side less than or equal to 720 px) duration, in seconds; transcode_H264_FHD: H.264 encoded full HD video (short side less than or equal to 1080 px) duration, in seconds; transcode_H264_2K: H.264 encoded 2K video (short side less than or equal to 1440 px) duration, in seconds.
Interval	Yes	String	Time granularity of the query. Valid values: 5min: 5 minutes; hour: 1 hour; day: 1 day.
Filters.N	No	Array of BillingDataFilter	Filter criteria. The detailed values of filter criteria are as follows: host: Specifies the domain name to filter by. Example value: test.example.com proxy-id: Specifies the L4 proxy instance ID for filtering. Example value: sid-2rugn89bkla9. region-id: Filter by billing region. Options: CH: Chinese mainland AF: Africa AS1: Asia-Pacific Region 1 AS2: Asia-Pacific Region 2 AS3: Asia-Pacific Region 3 EU: Europe MidEast: Middle East NA: North America SA: South America Note: `BillingDataFilter` with the same `Type` have an "or" relationship with each other, while those with different `Type` have an "and" relationship between them.
GroupBy.N	No	Array of String	Aggregation dimensions for grouping. You are allowed to group by up to two dimensions at the same time. Valid values are as follows: zone-id: Group by zone ID. If the content identifier feature is used, it will take precedence and group by content identifier first; host: Group by domain name; proxy-id: Group by L4 proxy instance ID; region-id: Group by billing region. Note: The output parameter's default maximum value for the number of groups is 200. If you encounter an error related to this limit, you should reduce the number of groups in the final output by narrowing down the query scope using `ZoneIds.N` or `Filters.N` parameters, or by decreasing the number of dimensions specified in the `GroupBy.N` parameter.

3. Output Parameters

Parameter Name	Type	Description
Data	Array of BillingData	Data point list. Note: This field may return null, which indicates a failure to obtain a valid value.
RequestId	String	The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Querying Content Acceleration Traffic for Specified Site in Specified Billing Region

This example shows you how to query the billing usage of content acceleration traffic for a specified zone-id in a designated region-id with daily granularity.

Input Example

POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeBillingData
<Common request parameters>

{
    "StartTime": "2024-01-01T00:00:00+08:00",
    "EndTime": "2024-01-24T03:20:00+08:00",
    "Interval": "day",
    "MetricName": "acc_flux",
    "Filters": [
        {
            "Type": "region-id",
            "Value": "MidEast"
        }
    ],
    "ZoneIds": [
        "zone-2smdfso9dr58"
    ]
}

Output Example

{
    "Response": {
        "RequestId": "457e8933-4296-4878-9a7f-fb888559e29e",
        "Data": [
            {
                "Time": "2023-12-31T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-01T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-02T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-03T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-04T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-05T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-06T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-07T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-08T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-09T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-10T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-11T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-12T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-13T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-14T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-15T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-16T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-17T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-18T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-19T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-20T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-21T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-22T16:00:00Z",
                "Value": 0
            },
            {
                "Time": "2024-01-23T16:00:00Z",
                "Value": 0
            }
        ]
    }
}

Example2 Querying Content Acceleration Traffic of Specified Sites Grouped by Site ID

This example shows you how to query the billing usage of content acceleration traffic for a specified zone-id, grouping by zone-id with daily granularity.

Input Example

POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeBillingData
<Common request parameters>

{
    "StartTime": "2025-07-01T00:00:00+08:00",
    "EndTime": "2025-07-02T23:59:59+08:00",
    "Interval": "day",
    "MetricName": "acc_flux",
    "ZoneIds": [
        "zone-2m2gq4dnpmd2",
        "zone-30hqppzribht"
    ],
    "GroupBy": [
        "zone-id"
    ]
}

Output Example

{
    "Response": {
        "RequestId": "d2174285-8aac-4cdc-bc06-d81f2f6520da",
        "Data": [
            {
                "Time": "2025-06-30T16:00:00Z",
                "Value": 0,
                "ZoneId": "zone-2m2gq4dnpmd2"
            },
            {
                "Time": "2025-07-01T16:00:00Z",
                "Value": 2751240612,
                "ZoneId": "zone-2m2gq4dnpmd2"
            },
            {
                "Time": "2025-06-30T16:00:00Z",
                "Value": 0,
                "ZoneId": "zone-30hqppzribht"
            },
            {
                "Time": "2025-07-01T16:00:00Z",
                "Value": 68443435,
                "ZoneId": "zone-30hqppzribht"
            }
        ]
    }
}

Example3 Querying Content Acceleration Traffic for Specified Site by Domain Group

This example shows you how to query specified content acceleration traffic billing volume by domain name with daily granularity for a given zone-id.

Input Example

POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeBillingData
<Common request parameters>

{
    "StartTime": "2025-07-01T00:00:00+08:00",
    "EndTime": "2025-07-02T23:59:59+08:00",
    "Interval": "day",
    "MetricName": "acc_flux",
    "ZoneIds": [
        "zone-2m2gq4dnpmd2",
        "zone-30hqppzribht"
    ],
    "GroupBy": [
        "host"
    ]
}

Output Example

{
    "Response": {
        "RequestId": "d2174285-8aac-4cdc-bc06-d81f2f6520da",
        "Data": [
            {
                "Host": "test1.example.com",
                "Time": "2025-06-30T16:00:00Z",
                "Value": 1387001003,
                "ZoneId": "zone-2m2gq4dnpmd2"
            },
            {
                "Host": "test1.example.com",
                "Time": "2025-07-01T16:00:00Z",
                "Value": 1390529805,
                "ZoneId": "zone-2m2gq4dnpmd2"
            },
            {
                "Host": "test2.example.com",
                "Time": "2025-06-30T16:00:00Z",
                "Value": 2879078,
                "ZoneId": "zone-2m2gq4dnpmd2"
            },
            {
                "Host": "test2.example.com",
                "Time": "2025-07-01T16:00:00Z",
                "Value": 2889084,
                "ZoneId": "zone-2m2gq4dnpmd2"
            }
        ]
    }
}

Example4 Querying Content Acceleration Traffic of Specified Site and Grouping by Site ID and Billing Region

This example shows you how to query specified zone-id content acceleration traffic billing volume, grouping by zone-id and billing region with daily granularity.

Input Example

POST / HTTP/1.1
Host: teo.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeBillingData
<Common request parameters>

{
    "StartTime": "2025-07-01T00:00:00+08:00",
    "EndTime": "2025-07-02T23:59:59+08:00",
    "Interval": "day",
    "MetricName": "acc_flux",
    "ZoneIds": [
        "zone-2m2gq4dnpmd2",
        "zone-30hqppzribht"
    ],
    "GroupBy": [
        "zone-id",
        "region-id"
    ]
}

Output Example

{
    "Response": {
        "RequestId": "d2174285-8aac-4cdc-bc06-d81f2f6520da",
        "Data": [
            {
                "RegionId": "SA",
                "Time": "2025-06-30T16:00:00Z",
                "Value": 549591531,
                "ZoneId": "zone-2m2gq4dnpmd2"
            },
            {
                "RegionId": "SA",
                "Time": "2025-07-01T16:00:00Z",
                "Value": 549591531,
                "ZoneId": "zone-2m2gq4dnpmd2"
            },
            {
                "RegionId": "MidEast",
                "Time": "2025-06-30T16:00:00Z",
                "Value": 549591531,
                "ZoneId": "zone-30hqppzribht"
            },
            {
                "RegionId": "MidEast",
                "Time": "2025-07-01T16:00:00Z",
                "Value": 549591531,
                "ZoneId": "zone-30hqppzribht"
            }
        ]
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

Tencent Cloud CLI 3.0

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code	Description
InternalError.ProxyServer	An unknown error occurred in the backend server.
InvalidParameter.GroupByLimitExceeded	GroupBy parameter exceeds the quantity limit.
InvalidParameter.InvalidInterval	Invalid interval. The value should be either [min 5min hour day].
InvalidParameter.InvalidMetric	The query dimension is invalid.
InvalidParameter.ZoneHasNotBeenBoundToPlan	The zone is not bound to a package.

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

边缘安全加速平台 EO

DescribeBillingData

1. API Description

2. Input Parameters

3. Output Parameters

4. Example

Example1 Querying Content Acceleration Traffic for Specified Site in Specified Billing Region

Input Example

Output Example

Example2 Querying Content Acceleration Traffic of Specified Sites Grouped by Site ID

Input Example

Output Example

Example3 Querying Content Acceleration Traffic for Specified Site by Domain Group

Input Example

Output Example

Example4 Querying Content Acceleration Traffic of Specified Site and Grouping by Site ID and Billing Region

Input Example

Output Example

5. Developer Resources

SDK

Command Line Interface

6. Error Code

帮助和支持