通过 DescribeWTNStreamTrafficData 查询每条 WTN 流的上行/下行流量数据，支持按业务 ID 过滤。

使用说明

流量数据单位换算进制为 1000，例如，1 GB = 1000 MB。

请求说明

请求方式：POST

请求地址：https://rtc.volcengineapi.com?Action=DescribeWTNStreamTrafficData&Version=2023-11-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

Query

Action String 必选示例值：DescribeWTNStreamTrafficData

接口名称。当前 API 的名称为 DescribeWTNStreamTrafficData。

Version String 必选示例值：2023-11-01

接口版本。当前 API 的版本为 2023-11-01。

Body

AppID String 必选示例值：661****543cf

应用 ID。在 WTN 控制台上获取。

StartTime String 必选示例值：2025-11-07T16:00:00+08:00

查询的开始时间，RFC3339 格式的时间戳，精度为秒。

EndTime String 必选示例值：2025-11-07T16:30:00+08:00

查询的结束时间，RFC3339 格式的时间戳，精度为秒。

BusinessIDList String[] 可选示例值：["live.a.com", "live.b.com"]

业务 ID 列表。若不传入，则查询指定 AppID 下所有业务 ID 的流量数据。最多支持传入 5 个业务 ID。

注意

请确保已创建业务 ID，并在创建发布/订阅流时传入了业务 ID，否则不支持按业务 ID 统计流量。详细操作，请参见使用 Business ID 统计流量。

ProtocolList String[] 可选示例值：["HTTP-FLV", "WebRTC"]

需要查询的推拉流协议列表。不填表示所有协议类型。支持的取值如下：

HTTP-FLV：基于 HTTP 协议的推拉流协议，使用 FLV 格式传输视频格式。

WebRTC：基于 WHIP/WHEP 的超低延时互动协议。

RegionList String[] 可选示例值：["中国"]

WTN 节点 IP 所属区域的列表。不填表示所有区域。

支持的取值：中国大陆、亚太一区、亚太二区、亚太三区、北美、南美、欧洲、中东、其他。

PageNum Integer 可选示例值：1

分页查询的页码。默认值为 1，表示查询第一页的数据。

PageSize Integer 可选示例值：100

分页查询时每页的数据条数。默认值为 100，取值范围为 [100, 1000]。

返回参数

AppID String 示例值：68abcf6cb7da8a0f84573380

应用的唯一标识符，用于标识查询流量用量所对应的应用。

BusinessIDList String[] 示例值：["live.a.com"]

业务 ID 列表。

ProtocolList String[] 示例值：["HTTP-FLV", "WebRTC"]

推拉流协议列：

HTTP-FLV：基于 HTTP 协议的推拉流协议，使用 FLV 格式传输视频格式。

WebRTC：基于 WHIP/WHEP 的超低延时互动协议。

RegionList String[] 示例值：["中国"]

WTN 节点 IP 所属区域的列表。

StartTime String 示例值：2025-11-07T16:00:00+08:00

查询的开始时间，RFC3339 格式的时间戳，精度为秒。

EndTime String 示例值：2025-11-07T16:30:00+08:00

查询的结束时间，RFC3339 格式的时间戳，精度为秒。

TotalUpTraffic Float 示例值：150

当前查询条件下，所有流的上行总流量，单位为 GB。

TotalDownTraffic Float 示例值：1000

当前查询条件下，所有流的下行总流量，单位为 GB。

StreamInfoList Object[] 示例值：-

流维度的流量用量信息详情。

StreamID String 可选示例值：stream-alpha-001

WTN 流 ID。

BusinessID String 可选示例值：live.a.com

该流所属的业务 ID。

UpTraffic Float 可选示例值：50

当前流在查询时间范围内的上行总流量，单位为 GB。

DownTraffic Float 可选示例值：500

当前流在查询时间范围内的下行总流量，单位为 GB。

Pagination Object 示例值：-

数据分页的信息。

PageNum Integer 示例值：1

当前所在分页的页码。

PageSize Integer 示例值：100

每页显示的数据条数。

TotalCount Integer 示例值：100

查询结果的数据总条数。

请求示例

查询 AppID 661****543cf 下，与业务标识（BusinessID）live.a.com 关联的所有流，在 2025-11-03 内的总流量用量清单。

返回示例

WebRTC 传输网络