阅读本文，您可以获取 Java SDK 统计分析的接口调用示例，实现快速开发。 :::tip 本文的调用示例包含接口的部分参数。由于参数间可能存在互斥关系，在调用时，请您参考注释，进行调整。 ::: ## 调用说明 - 本文提供的接口调用示例均通过 AK 和 SK 初始化实例。 - 接口的参数说明和错误码等信息可通过[接口文档](https://www.volcengine.com/docs/6469/1126914)或打开 [API Explorer](https://api.volcengine.com/api-explorer/debug?serviceCode=live&groupName=统计分析&action=DescribeLiveRegionData&version=2023-01-01) 的**文档说明**页签查看。 ## 前提条件调用接口前，请先完成 Java SDK 的[安装及初始化](https://www.volcengine.com/docs/6469/1166572)操作。 ## 调用示例本节为您介绍统计分析相关接口的功能和调用示例。 ### 查询区域标识符您可以调用 DescribeLiveRegionData 接口查询区域标识符。详细的参数说明可参见 [DescribeLiveRegionData](https://www.volcengine.com/docs/6469/1133973) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; public class DescribeLiveRegionDataDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); try { DescribeLiveRegionDataRes resp = service.describeLiveRegionData(); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询运营商标识符您可以调用 DescribeLiveISPData 接口查询运营商标识符。详细的参数说明可参见 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; public class DescribeLiveISPDataDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); try { DescribeLiveISPDataRes resp = service.describeLiveISPData(); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询单路推流监控数据您可以调用 DescribeLivePushStreamMetrics 接口查询单路推流监控数据。详细的参数说明可参见 [DescribeLivePushStreamMetrics](https://www.volcengine.com/docs/6469/1126915) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; public class DescribeLivePushStreamMetricsDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLivePushStreamMetricsBody body = new DescribeLivePushStreamMetricsBody(); // 推流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看直播流使用的推流域名。 body.setDomain("push.example.com"); // 应用名称，取值与直播流地址中 AppName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 body.setApp("live"); // 流名称，取值与直播流地址中 StreamName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 body.setStream("example_stream"); // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 单次查询最大时间跨度为 1 天，历史查询最大时间范围为 366 天。 body.setStartTime("2021-08-16T00:00:00+08:00"); // 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 body.setEndTime("2021-08-16T00:00:00+08:00"); // 数据聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 //

5：5 秒；

30：（默认值）30 秒。

body.setAggregation(5); try { DescribeLivePushStreamMetricsRes resp = service.describeLivePushStreamMetrics(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询多路推流监控数据您可以调用 DescribeLiveBatchPushStreamMetrics 接口查询多路推流监控数据。详细的参数说明可参见 [DescribeLiveBatchPushStreamMetrics](https://www.volcengine.com/docs/6469/1126916) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; public class DescribeLiveBatchPushStreamMetricsDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLiveBatchPushStreamMetricsBody body = new DescribeLiveBatchPushStreamMetricsBody(); // 推流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看直播流使用的推流域名。 body.setDomain("push.example.com"); // 应用名称，取值与直播流地址中的 AppName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 // note： // 查询流粒度的监控数据时，需同时指定 App 和 Stream 来指定直播流。 body.setApp("live"); // 流名称，预置与直播流地址中的 StreamName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 // note： // 查询流粒度的监控数据时，需同时指定 App 和 Stream 来指定直播流。 body.setStream("example_stream"); // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 单次查询最大时间跨度为 1 天，历史查询最大时间范围为 366 天。 body.setStartTime("2021-08-16T00:00:00+08:00"); // 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 body.setEndTime("2021-08-16T00:01:59+08:00"); // 数据聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 //

5：5 秒；

30：30 秒；

60：（默认值）1 分钟。

body.setAggregation(5); // 数据聚合时间粒度内，动态指标的聚合算法，取值及含义如下所示。 //

max：（默认值）计算聚合时间粒度内的最大值；

avg：计算聚合时间粒度内的平均值。

body.setAggType("max"); try { DescribeLiveBatchPushStreamMetricsRes resp = service.describeLiveBatchPushStreamMetrics(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询单路回源流监控数据您可以调用 DescribeLiveSourceStreamMetrics 接口查询单路回源流监控数据。详细的参数说明可参见 [DescribeLiveSourceStreamMetrics](https://www.volcengine.com/docs/6469/1126917) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; public class DescribeLiveSourceStreamMetricsDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLiveSourceStreamMetricsBody body = new DescribeLiveSourceStreamMetricsBody(); // 拉流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看回源流使用的拉流域名。 body.setDomain("pull.example.com"); // 应用名称，取值与直播流地址中 AppName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 body.setApp("live"); // 流名称，取值与直播流地址中 StreamName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 body.setStream("example_stream"); // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 单次查询最大时间跨度为 1 天，历史查询最大时间范围为 366 天。 body.setStartTime("2021-08-16T00:00:00+08:00"); // 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 body.setEndTime("2021-08-16T00:01:59+08:00"); // 数据聚合的时间粒度，单位为秒，当前接口默认且仅支持按 30 秒进行数据聚合。 body.setAggregation(30); try { DescribeLiveSourceStreamMetricsRes resp = service.describeLiveSourceStreamMetrics(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询多路回源流监控数据您可以调用 DescribeLiveBatchSourceStreamMetrics 接口查询多路回源流监控数据。详细的参数说明可参见 [DescribeLiveBatchSourceStreamMetrics](https://www.volcengine.com/docs/6469/1126918) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; public class DescribeLiveBatchSourceStreamMetricsDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLiveBatchSourceStreamMetricsBody body = new DescribeLiveBatchSourceStreamMetricsBody(); // 拉流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看回源流使用的拉流域名。 body.setDomain("pull.example.com"); // 应用名称，取值与直播流地址中的 AppName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 // note： // 查询流粒度的监控数据时，需同时指定 App 和 Stream 来指定回源流。 body.setApp("live"); // 流名称，预置与直播流地址中的 StreamName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 // note： // 查询流粒度的监控数据时，需同时指定 App 和 Stream 来指定回源流。 body.setStream("example_stream"); // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 单次查询最大时间跨度为 1 天，历史查询最大时间范围为 366 天。 body.setStartTime("2021-08-16T00:00:00+08:00"); // 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 body.setEndTime("2021-08-16T00:01:59+08:00"); // 数据聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 //

30：30 秒；

60：（默认值）1 分钟。

body.setAggregation(30); // 数据聚合时间粒度内，动态指标的聚合算法，取值及含义如下所示。 //

max：（默认值）计算聚合时间粒度内的最大值；

avg：计算聚合时间粒度内的平均值。

body.setAggType("max"); try { DescribeLiveBatchSourceStreamMetricsRes resp = service.describeLiveBatchSourceStreamMetrics(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询域名或单个直播流的拉流数据您可以调用 DescribeLiveStreamSessionData 接口查询域名或单个直播流的拉流数据。详细的参数说明可参见 [DescribeLiveStreamSessionData](https://www.volcengine.com/docs/6469/1126919) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; import java.util.ArrayList; import java.util.List; public class DescribeLiveStreamSessionDataDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLiveStreamSessionDataBody body = new DescribeLiveStreamSessionDataBody(); // 拉流域名列表，默认为空，表示查询所有域名的请求数和在线人数。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 // note： // DomainList 和 Domain 传且仅传一个。 List DomainList = new ArrayList<>(); DomainList.add("pull.example.com"); body.setDomainList(DomainList); // 拉流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 // note： // 查询流粒度的请求数和在线人数数据时，需同时指定 Domain 、App 和 Stream 来指定直播流。 body.setDomain("pull.example.com"); // 应用名称，取值与直播流地址中的 AppName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 // note： // 查询流粒度的请求数和在线人数数据时，需同时指定 Domain 、App 和 Stream 来指定直播流。 body.setApp("example_app"); // 流名称，取值与直播流地址中的 StreamName 字段取值相同。支持由大小写字母（A - Z、a - z）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 // note： // 查询流粒度的请求数和在线人数数据时，需同时指定 Domain 、App 和 Stream 来指定直播流。 body.setStream("example_stream"); // 推拉流协议，缺省情况下表示所有协议类型，支持的协议如下所示。 //

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

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

RTMP：Real Time Message Protocol，实时信息传输协议。

RTM：Real Time Media，超低延时直播协议。

SRT：Secure Reliable Transport，安全可靠传输协议。

QUIC：Quick UDP Internet Connections，一种基于 UDP 的全新的低延时互联网传输协议。

// note： // 如果查询推拉流协议为 QUIC，不能同时查询其他协议。 List ProtocolList = new ArrayList<>(); ProtocolList.add("HTTP-FLV"); ProtocolList.add("RTMP"); body.setProtocolList(ProtocolList); // 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 //

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数。

// 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 List ISPList = new ArrayList<>(); ISPList.add("telecom"); body.setISPList(ISPList); // CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 List RegionList = new ArrayList<>(); DescribeLiveStreamSessionDataBodyRegionListItem RegionList1 = new DescribeLiveStreamSessionDataBodyRegionListItem(); // 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 RegionList1.setArea("CN"); // 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 RegionList1.setCountry("CN"); // 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 RegionList1.setProvince("beijing"); RegionList.add(RegionList1); body.setRegionList(RegionList); // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 历史查询最大时间范围为 366 天，单次查询最大时间跨度与数据拆分维度和数据聚合时间粒度有关，详细如下。 //

当不进行维度拆分或只使用一个维度拆分数据时：

数据以 60 秒聚合时，单次查询最大时间跨度为 24 小时；

数据以 300 秒聚合时，单次查询最大时间跨度为 31 天；

数据以 3600 秒聚合时，单次查询最大时间跨度为 31 天。

当使用两个或两个以上维度拆分数据时：

数据以 60 秒聚合时，单次查询最大时间跨度为 3 小时；

数据以 300 秒聚合时，单次查询最大时间跨度为 24 小时；

数据以 3600 秒聚合时，单次查询最大时间跨度为 7 天。

body.setStartTime("2021-04-13T00:00:00+08:00"); // 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 body.setEndTime("2021-04-14T00:00:00+08:00"); // 数据聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 //

60：1 分钟。

300：（默认值）5 分钟。

3600：1 小时。

body.setAggregation(300); // 数据拆分的维度，默认为空表示不按维度进行数据拆分，支持的维度如下所示。 //

Domain：域名；

ISP：运营商；

Protocol：推拉流协议。

Online（默认值）：以 1 分钟瞬时连接的 session 数作为 1 分钟粒度的在线人数数量；

Viewer：以 1 分钟内的 session 链接总数作为 1 分钟粒度的在线人数数量；

ClientIP：以 1 分钟内的进行拉流请求的客户端 IP 总数作为 1 分钟粒度的在线人数数量。

body.setOnlineUserType("Online"); try { DescribeLiveStreamSessionDataRes resp = service.describeLiveStreamSessionData(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询域名下所有直播流的拉流数据您可以调用 DescribeLiveBatchStreamSessionData 接口查询域名下所有直播流的拉流数据。详细的参数说明可参见 [DescribeLiveBatchStreamSessionData](https://www.volcengine.com/docs/6469/1283731) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; import java.util.ArrayList; import java.util.List; public class DescribeLiveBatchStreamSessionDataDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLiveBatchStreamSessionDataBody body = new DescribeLiveBatchStreamSessionDataBody(); // 拉流域名列表，默认为空，表示查询所有域名的请求数和在线人数。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 List DomainList = new ArrayList<>(); DomainList.add("example.com"); DomainList.add("example2.com"); body.setDomainList(DomainList); // 推拉流协议，缺省情况下表示所有协议类型，支持的协议如下所示。 //

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

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

RTMP：Real Time Message Protocol，实时信息传输协议。

RTM：Real Time Media，超低延时直播协议。

SRT：Secure Reliable Transport，安全可靠传输协议。

QUIC：Quick UDP Internet Connections，一种基于 UDP 的全新的低延时互联网传输协议。

// note： //

如果查询推拉流协议为 QUIC，不能同时查询其他协议。

缺省情况下，查询的总流量数据为实际产生的上下行流量。

如果传入单个协议进行查询，并对各协议的流量求和，结果将大于实际总流量。

List ProtocolList = new ArrayList<>(); ProtocolList.add("RTMP"); body.setProtocolList(ProtocolList); // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 单次查询最大时间跨度为 24 小时，查询历史数据的时间范围为 366 天。 body.setStartTime("2021-04-13T00:00:00+08:00"); // 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 body.setEndTime("2021-04-14T00:00:00+08:00"); // 查询数据的页码，默认值为 1，表示查询第一页的数据。 body.setPageNum(1); // 每页显示的数据条数，默认值为 1000，取值范围为 [100,1000]。 body.setPageSize(100); // 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 //

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数。

// 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 List ISPList = new ArrayList<>(); ISPList.add("telecom"); body.setISPList(ISPList); // CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 List RegionList = new ArrayList<>(); DescribeLiveBatchStreamSessionDataBodyRegionListItem RegionList1 = new DescribeLiveBatchStreamSessionDataBodyRegionListItem(); // 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 RegionList1.setArea("CN"); // 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 RegionList1.setCountry("CN"); // 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 RegionList1.setProvince("beijing"); RegionList.add(RegionList1); body.setRegionList(RegionList); // 在线人数统计方式，取值及含义如下所示： //

Online：以 1 分钟瞬时连接的 session 数作为 1 分钟粒度的在线人数数量；

Viewer（默认值）：以 1 分钟内的 session 链接总数作为 1 分钟粒度的在线人数数量。

body.setOnlineUserType("Viewer"); try { DescribeLiveBatchStreamSessionDataRes resp = service.describeLiveBatchStreamSessionData(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询直播流的流量数据您可以调用 DescribeLiveBatchStreamTrafficData 接口查询直播流的流量数据。详细的参数说明可参见 [DescribeLiveBatchStreamTrafficData](https://www.volcengine.com/docs/6469/1126921) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; import java.util.ArrayList; import java.util.List; public class DescribeLiveBatchStreamTrafficDataDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLiveBatchStreamTrafficDataBody body = new DescribeLiveBatchStreamTrafficDataBody(); // 域名列表，默认为空，表示查询所有域名下的流量数据。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的域名。 List DomainList = new ArrayList<>(); DomainList.add("push.example.com"); DomainList.add("push2.example.com"); body.setDomainList(DomainList); // 推拉流协议，缺省情况下表示所有协议类型，支持的协议如下所示。 //

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

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

RTMP：Real Time Message Protocol，实时信息传输协议。

RTM：Real Time Media，超低延时直播协议。

SRT：Secure Reliable Transport，安全可靠传输协议。

QUIC：Quick UDP Internet Connections，一种基于 UDP 的全新的低延时互联网传输协议。

// note： //

如果查询推拉流协议为 QUIC，不能同时查询其他协议。

缺省情况下，查询的总流量数据为实际产生的上下行流量。

如果传入单个协议进行查询，并对各协议的流量求和，结果将大于实际总流量。

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数。

// 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 List ISPList = new ArrayList<>(); ISPList.add("telecom"); body.setISPList(ISPList); // CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 // note： // 参数 RegionList和UserRegionList 不支持同时传入。 List RegionList = new ArrayList<>(); DescribeLiveBatchStreamTrafficDataBodyRegionListItem RegionList1 = new DescribeLiveBatchStreamTrafficDataBodyRegionListItem(); // 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 RegionList1.setArea("CN"); // 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 RegionList1.setCountry("CN"); // 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 RegionList1.setProvince("beijing"); RegionList.add(RegionList1); body.setRegionList(RegionList); // 客户端 IP 所属区域的列表，缺省情况下表示所有区域。 // note： // 参数 RegionList和UserRegionList 不支持同时传入。 List< DescribeLiveBatchStreamTrafficDataBodyUserRegionListItem > UserRegionList = new ArrayList<>(); DescribeLiveBatchStreamTrafficDataBodyUserRegionListItem UserRegionList1 = new DescribeLiveBatchStreamTrafficDataBodyUserRegionListItem(); // 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 UserRegionList1.setArea("CN"); // 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 UserRegionList1.setCountry("CN"); // 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 UserRegionList1.setProvince("beijing"); UserRegionList.add(UserRegionList1); body.setUserRegionList(UserRegionList); try { DescribeLiveBatchStreamTrafficDataRes resp = service.describeLiveBatchStreamTrafficData(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询直播流或域名的回源流量监控数据您可以调用 DescribeLiveSourceTrafficData 接口查询直播流或域名的回源流量监控数据。详细的参数说明可参见 [DescribeLiveSourceTrafficData](https://www.volcengine.com/docs/6469/1126923) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; import java.util.ArrayList; import java.util.List; public class DescribeLiveSourceTrafficDataDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLiveSourceTrafficDataBody body = new DescribeLiveSourceTrafficDataBody(); // 拉流域名列表，默认为空，表示查询所有域名的回源流量带宽监控数据。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 // note： // DomainList 和 Domain 传且仅传一个。 List DomainList = new ArrayList<>(); DomainList.add("pull.example.com"); DomainList.add("pull2.example.com"); body.setDomainList(DomainList); // 拉流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 // note： // 查询流粒度数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 body.setDomain("pull.example.com"); // 回源流的应用名称，查询流粒度数据时必传，且需同时传入 Domain 和 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 // note： // 查询流粒度数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 body.setApp("live"); // 回源流的流名称，查询流粒度数据时必传，且需同时传入 Domain 和 App。支持由大小写字母（A - Z、a - z）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 // note： // 查询流粒度数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 body.setStream("example_stream"); // 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 //

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数。

// 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 List ISPList = new ArrayList<>(); ISPList.add("telecom"); body.setISPList(ISPList); // 客户端 IP 所属区域的列表，缺省情况下表示所有区域。 List UserRegionList = new ArrayList<>(); DescribeLiveSourceTrafficDataBodyUserRegionListItem UserRegionList1 = new DescribeLiveSourceTrafficDataBodyUserRegionListItem(); // 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 UserRegionList1.setArea("CN"); // 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 UserRegionList1.setCountry("CN"); // 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 UserRegionList1.setProvince("beijing"); UserRegionList.add(UserRegionList1); body.setUserRegionList(UserRegionList); // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 历史查询最大时间范围为 366 天，单次查询最大时间跨度与数据拆分维度和数据聚合时间粒度有关，详细如下。 //

当不进行维度拆分或只使用一个维度拆分数据时：

数据以 60 秒聚合时，单次查询最大时间跨度为 24 小时；

数据以 300 秒聚合时，单次查询最大时间跨度为 31 天；

数据以 3600 秒聚合时，单次查询最大时间跨度为 31 天。

当使用两个或两个以上维度拆分数据时：

数据以 60 秒聚合时，单次查询最大时间跨度为 3 小时；

数据以 300 秒聚合时，单次查询最大时间跨度为 24 小时；

数据以 3600 秒聚合时，单次查询最大时间跨度为 7 天。

60：1 分钟。

300：（默认值）5 分钟。

3600：1 小时。

body.setAggregation(300); // 数据拆分的维度，默认为空表示不按维度进行数据拆分，支持的维度如下所示。 //

Domain：域名；

ISP：运营商。

// note： // 配置数据拆分的维度时，对应的维度参数传入多个值时才会返回按此维度拆分的数据。例如，配置按 Domain 进行数据拆分时， DomainList 传入多个 Domain 值时，才会返回按 Domain 拆分的数据。 List DetailField = new ArrayList<>(); DetailField.add("Domain"); body.setDetailField(DetailField); try { DescribeLiveSourceTrafficDataRes resp = service.describeLiveSourceTrafficData(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询域名状态码占比您可以调用 DescribeLivePlayStatusCodeData 接口查询域名状态码占比。详细的参数说明可参见 [DescribeLivePlayStatusCodeData](https://www.volcengine.com/docs/6469/1126926) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; import java.util.ArrayList; import java.util.List; public class DescribeLivePlayStatusCodeDataDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLivePlayStatusCodeDataBody body = new DescribeLivePlayStatusCodeDataBody(); // 域名列表，默认为空时表示查询所有域名下产生的请求状态码占比数据。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询请求状态码占比数据的域名。 List DomainList = new ArrayList<>(); DomainList.add("push.example.com"); DomainList.add("pull.example.com"); body.setDomainList(DomainList); // 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 //

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数。

60：（默认值）1 分钟。时间粒度为 1 分钟时，单次查询最大时间跨度为 24 小时，历史查询时间范围为 366 天；

300：5 分钟。时间粒度为 5 分钟时，单次查询最大时间跨度为 31 天，历史查询时间范围为 366 天；

3600：1 小时。时间粒度为 1 小时时，单次查询最大时间跨度为 93 天，历史查询时间范围为 366 天。

body.setAggregation(300); // 数据拆分的维度，默认为空表示不按维度进行数据拆分，支持的维度如下所示。 //

Domain：域名；

ISP：运营商。

Access：（默认值）推流请求和拉流请求；

Source：回源请求。

body.setType("Access"); try { DescribeLivePlayStatusCodeDataRes resp = service.describeLivePlayStatusCodeData(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询 IP 地址归属的 CDN 节点您可以调用 DescribeIpInfo 接口查询 IP 地址归属的 CDN 节点。详细的参数说明可参见 [DescribeIpInfo](https://www.volcengine.com/docs/6469/1126927) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; import java.util.ArrayList; import java.util.List; public class DescribeIpInfoDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeIpInfoBody body = new DescribeIpInfoBody(); // 待查询的 IP 地址列表。支持 IPv4 和 IPv6 地址，一次最多查询 50 个 IP 地址。 List Ips = new ArrayList<>(); Ips.add("186.199.***.1"); body.setIps(Ips); try { DescribeIpInfoRes resp = service.describeIpInfo(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询峰值流数您可以调用 DescribeLiveStreamCountData 接口查询峰值流数。详细的参数说明可参见 [DescribeLiveStreamCountData](https://www.volcengine.com/docs/6469/1134317) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; import java.util.ArrayList; import java.util.List; public class DescribeLiveStreamCountDataDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLiveStreamCountDataBody body = new DescribeLiveStreamCountDataBody(); // 直播流使用的域名列表，默认为空，表示查询所有全部域名下的峰值流数。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看直播流使用的域名。 List DomainList = new ArrayList<>(); DomainList.add("push.exmaple.com"); DomainList.add("push2.example.com"); body.setDomainList(DomainList); // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 历史查询最大时间范围为 366 天，单次查询最大时间跨度与数据拆分维度和数据聚合时间粒度有关，详细如下。 //

当不进行维度拆分或只使用一个维度拆分数据时：

数据以 60 秒聚合时，单次查询最大时间跨度为 24 小时；

数据以 300 秒聚合时，单次查询最大时间跨度为 31 天；

数据以 3600 秒聚合时，单次查询最大时间跨度为 31 天。

当使用两个或两个以上维度拆分数据时：

数据以 60 秒聚合时，单次查询最大时间跨度为 3 小时；

数据以 300 秒聚合时，单次查询最大时间跨度为 24 小时；

数据以 3600 秒聚合时，单次查询最大时间跨度为 7 天。

body.setStartTime("2021-08-16T00:00:00+08:00"); // 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 body.setEndTime("2021-08-16T00:01:59+08:00"); // 聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 //

60：1 分钟；

300：（默认值）5 分钟；

3600：1 小时。

body.setAggregation(60); // 数据拆分的维度，默认为空表示不按维度进行数据拆分，支持的维度如下所示。 //

Domain：域名；

ISP：运营商。

List DetailField = new ArrayList<>(); DetailField.add("Domain"); body.setDetailField(DetailField); // 流类型，缺省情况下表示全部类型，支持的流类型取值如下。 //

push：推流；

relay-source：回源流；

transcode：转码流。

List StreamType = new ArrayList<>(); StreamType.add("push"); body.setStreamType(StreamType); // 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 //

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数。

// note： //

当流类型 StreamType 为推流 push 时支持使用运营商对查询数据进行筛选。

您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。

List ISPList = new ArrayList<>(); ISPList.add("telecom"); body.setISPList(ISPList); // 客户端 IP 所属区域的列表，缺省情况下表示所有区域。 // note： // 当流类型 StreamType 为推流 push 时支持使用客户端 IP 所属的区域对查询数据进行筛选。 List UserRegionList = new ArrayList<>(); DescribeLiveStreamCountDataBodyUserRegionListItem UserRegionList1 = new DescribeLiveStreamCountDataBodyUserRegionListItem(); // 区域信息的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 UserRegionList1.setArea("CN"); // 区域信息的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 UserRegionList1.setCountry("CN"); // 区域信息的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 UserRegionList1.setProvince("beijing"); UserRegionList.add(UserRegionList1); body.setUserRegionList(UserRegionList); try { DescribeLiveStreamCountDataRes resp = service.describeLiveStreamCountData( body ); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询推流流信息您可以调用 DescribeLivePushStreamInfoData 接口查询推流流信息。详细的参数说明可参见 [DescribeLivePushStreamInfoData](https://www.volcengine.com/docs/6469/1229191) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; import java.util.ArrayList; import java.util.List; public class DescribeLivePushStreamInfoDataDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLivePushStreamInfoDataBody body = new DescribeLivePushStreamInfoDataBody(); // 直播推流使用的域名列表，缺省为空，表示当前账号下所有域名。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看直播推流使用的域名。 List DomainList = new ArrayList<>(); DomainList.add("push.example.com"); body.setDomainList(DomainList); // 应用名称，取值与直播流地址中 AppName 字段取值相同，默认为空，表示查询所有应用名称。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 body.setApp("example_app"); // 流名称，取值与直播流地址中 StreamName 字段取值相同，默认为空表示查询所有流名称。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 body.setStream("example_stream"); // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 支持查询最近 93 天以内的推流数据。 body.setStartTime("2021-04-13T00:00:00+08:00"); // 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 // note： // 支持查询最近 93 天以内的推流数据。 body.setEndTime("2021-04-14T00:00:00+08:00"); // 查询数据的页码，默认为 1，表示查询第一页的数据，取值范围为正整数。 body.setPageNum(1); // 每页显示的数据条数，默认为 20，取值范围为 [1,1000]。 body.setPageSize(20); try { DescribeLivePushStreamInfoDataRes resp = service.describeLivePushStreamInfoData(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询直播域名转码数据明细您可以调用 DescribeLiveTranscodeInfoData 接口查询直播域名转码数据明细。详细的参数说明可参见 [DescribeLiveTranscodeInfoData](https://www.volcengine.com/docs/6469/1257355) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; import java.util.ArrayList; import java.util.List; public class DescribeLiveTranscodeInfoDataDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLiveTranscodeInfoDataBody body = new DescribeLiveTranscodeInfoDataBody(); // 域名列表，默认为空，表示查询您视频直播产品下所有域名的转码用量数据。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的域名。 List DomainList = new ArrayList<>(); DomainList.add("push.example.com"); DomainList.add("push2.example.com"); body.setDomainList(DomainList); // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 历史查询最大时间范围为 366 天。 body.setStartTime("2021-04-13T00:00:00+08:00"); // 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 body.setEndTime("2021-04-14T00:00:00+08:00"); // 应用名称，取值与直播流地址中 AppName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 // note： // 查询流粒度数据时，需同时传入 App 和 Stream。 body.setApp("live"); // 流名称，取值与直播流地址中 StreamName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 // note： // 查询流粒度数据时，需同时传入 App 和 Stream。 body.setStream("example_stream"); // 转码分辨率档位，默认为空表示不指定转码分辨率档位。以 720P 为例，表示转码配置的长边 x 短边计算而出的面积大于 480P（640 × 480）且小于等于 720P 档位（1280 x 720）。支持的取值和含义如下所示。 //

480P：640 × 480；

720P：1280 × 720；

1080P：1920 × 1088；

2K：2560 × 1440；

4K：4096 × 2160；

8K：> 4096 x 2160；

0P：纯音频转码。

List Resolution = new ArrayList<>(); Resolution.add("720P"); Resolution.add("1080P"); body.setResolution(Resolution); // 查询数据的页码，默认为 1，表示查询第一页的数据。 body.setPageNum(1); // 每页显示的数据条数。默认为 20，最大值为 100000。 body.setPageSize(20); // 视频编码格式，默认为空表示不指定视频编码格式，支持的取值和含义如下所示。 //

Normal_H264：H.264 标准转码；

Normal_H265：H.265 标准转码；

Normal_H266：H.266 标准转码；

ByteHD_H264：H.264 极智超清；

ByteHD_H265：H.265 极智超清；

ByteHD_H266：H.266 极智超清；

ByteQE：画质增强；

Audio：纯音频流。

List TranscodeType = new ArrayList<>(); TranscodeType.add("Normal_H264"); TranscodeType.add("ByteHD_H265"); body.setTranscodeType(TranscodeType); try { DescribeLiveTranscodeInfoDataRes resp = service.describeLiveTranscodeInfoData(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询 TOPN 直播流或域名的流量和带宽信息您可以调用 DescribeLiveTopPlayData 接口查询 TOPN 直播流或域名的流量和带宽信息。详细的参数说明可参见 [DescribeLiveTopPlayData](https://www.volcengine.com/docs/6469/1386117) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; import java.util.ArrayList; import java.util.List; public class DescribeLiveTopPlayDataDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLiveTopPlayDataBody body = new DescribeLiveTopPlayDataBody(); // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： //

单次查询最大时间跨度为 31 天。

历史查询时间范围是 366 天。

带宽和流量数据按照整小时进行聚合。在此建议您，查询开始时间和查询结束时间应涵盖您所要查询的时间段的整点小时。

body.setStartTime("2024-11-16T00:00:00+08:00"); // 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 body.setEndTime("2024-11-20T00:00:00+08:00"); // 查询类型，取值及含义如下所示。 //

Domain ：查询 TOPN 域名的的流量带宽信息。

Stream（默认值）：查询 TOPN 直播流的流量带宽信息。

body.setQueryType("Stream"); // TOPN 结果的排序指标，取值及含义如下所示。 //

PeakBandwidth（默认值）：以峰值带宽值降序展示查询结果。

AvgBandwidth：以平均带宽值降序展示查询结果。

TotalTraffic：以流量加值降序展示查询结果。

body.setSortBy("PeakBandwidth"); // 域名空间列表，默认为空，表示所有域名空间。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的域名空间信息。 List VhostList = new ArrayList<>(); VhostList.add("push.example.com"); body.setVhostList(VhostList); // 域名列表，默认为空，表示所有域名。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的域名信息。 List DomainList = new ArrayList<>(); DomainList.add("push.example.com"); body.setDomainList(DomainList); // 每页显示的数据条数，默认值为 10，取值范围为 [1,1000]。 body.setPageSize("10"); // 查询数据的页码，默认值为 1，表示查询第一页的数据。 // note： // PageSize 为 10，PageNum 为 1 时，表示查询 TOP 10 的数据。 body.setPageNum("1"); try { DescribeLiveTopPlayDataRes resp = service.describeLiveTopPlayData(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ``` ### 查询边缘数据您可以调用 DescribeLiveEdgeStatData 接口查询边缘数据。详细的参数说明可参见 [DescribeLiveEdgeStatData](https://www.volcengine.com/docs/6469/1399004) 接口文档。接口调用示例如下所示。 ```java package com.volcengine.live.demo; import com.volcengine.model.live.v20230101.*; import com.volcengine.service.live.v20230101.LiveService; import java.util.ArrayList; import java.util.List; public class DescribeLiveEdgeStatDataDemo { public static void main(String[] args) { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY LiveService service = LiveService.getInstance(); service.setAccessKey(System.getenv("VOLC_ACCESSKEY")); service.setSecretKey(System.getenv("VOLC_SECRETKEY")); DescribeLiveEdgeStatDataBody body = new DescribeLiveEdgeStatDataBody(); // 域名列表，默认为空，表示您添加到视频直播中的所有域名。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的域名。 List DomainList = new ArrayList<>(); DomainList.add("push.example.com"); DomainList.add("pull.example.com"); body.setDomainList(DomainList); // 推拉流协议，缺省情况下表示所有协议类型，支持的协议如下所示。 //

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

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

RTMP：Real Time Message Protocol，实时信息传输协议。

RTM：Real Time Media，超低延时直播协议。

SRT：Secure Reliable Transport，安全可靠传输协议。

QUIC：Quick UDP Internet Connections，一种基于 UDP 的全新的低延时互联网传输协议。

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数。

// 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 List ISPList = new ArrayList<>(); ISPList.add("unicom"); ISPList.add("telecom"); body.setISPList(ISPList); // CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 // note： // 参数 RegionList和UserRegionList 不支持同时传入。 List RegionList = new ArrayList<>(); DescribeLiveEdgeStatDataBodyRegionListItem RegionList1 = new DescribeLiveEdgeStatDataBodyRegionListItem(); // 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 RegionList1.setArea("CN"); // 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 RegionList1.setCountry("CN"); // 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 RegionList1.setProvince("beijing"); RegionList.add(RegionList1); body.setRegionList(RegionList); // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 历史查询最大时间范围为 366 天，单次查询最大时间跨度与数据拆分维度和数据聚合时间粒度有关，详细如下。 //

当不进行维度拆分或只使用一个维度拆分数据时：

数据以 60 秒聚合时，单次查询最大时间跨度为 24 小时；

数据以 300 秒聚合时，单次查询最大时间跨度为 31 天；

数据以 3600 秒聚合时，单次查询最大时间跨度为 31 天。

当使用两个或两个以上维度拆分数据时：

数据以 60 秒聚合时，单次查询最大时间跨度为 3 小时；

数据以 300 秒聚合时，单次查询最大时间跨度为 24 小时；

数据以 3600 秒聚合时，单次查询最大时间跨度为 7 天。

body.setStartTime("2024-12-12T00:00:00+08:00"); // 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 body.setEndTime("2024-12-12T01:00:00+08:00"); // 数据聚合的时间粒度，单位为秒，支持以下取值。 //

60：1 分钟。

300：（默认值）5 分钟。

3600：1 小时。

body.setAggregation(300); // 数据拆分的维度，缺省情况下不进行数据拆分，支持的维度如下所示。 //

Domain：域名；

Protocol：推拉流协议；

ISP：运营商；

Area：CDN 节点 IP 所属大区。

Country：CDN 节点 IP 所属国家。

Province：CDN 节点 IP 所属省份。

UserArea：客户端 IP 所属大区。

UserCountry：客户端 IP 所属国家。

UserProvince：客户端 IP 所属省份。

// note： // 中国（Country 或 UserCountry 为 CN）以外区域无 Province 字段，如果按 Province 或 UserProvince 字段拆分数据时，默认只返回 Country 为 CN 时的数据。 List DetailField = new ArrayList<>(); DetailField.add("Domain"); body.setDetailField(DetailField); // 直播流地址中的 AppName 字段列表，默认为空表示所有 AppName。每个 AppName 支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 List AppList = new ArrayList<>(); AppList.add("live"); AppList.add("vodlive"); body.setAppList(AppList); // 直播流地址中的 StreamName 字段列表，默认为空表示所有 StreamName。每个 StreamName 支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 List StreamList = new ArrayList<>(); StreamList.add("stream001"); StreamList.add("stream002"); body.setStreamList(StreamList); try { DescribeLiveEdgeStatDataRes resp = service.describeLiveEdgeStatData(body); System.out.println(resp); } catch (Exception e) { e.printStackTrace(); } } } ```