阅读本文，您可以获取 Python 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) 的**文档说明**页签查看。 ## 前提条件调用接口前，请先完成 Python SDK 的[安装及初始化](https://www.volcengine.com/docs/6469/1166578)操作。 ## 调用示例本节为您介绍统计分析相关接口的功能和调用示例。 ### 查询区域标识符您可以调用 DescribeLiveRegionData 接口查询区域标识符。详细的参数说明可参见 [DescribeLiveRegionData](https://www.volcengine.com/docs/6469/1133973) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) resp = service.describe_live_region_data() print(resp) ``` ### 查询运营商标识符您可以调用 DescribeLiveISPData 接口查询运营商标识符。详细的参数说明可参见 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) resp = service.describe_live_isp_data() print(resp) ``` ### 查询单路推流监控数据您可以调用 DescribeLivePushStreamMetrics 接口查询单路推流监控数据。详细的参数说明可参见 [DescribeLivePushStreamMetrics](https://www.volcengine.com/docs/6469/1126915) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 推流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看直播流使用的推流域名。 "Domain": "push.example.com", # 应用名称，取值与直播流地址中 AppName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 "App": "live", # 流名称，取值与直播流地址中 StreamName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 "Stream": "example_stream", # 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 # note： # 单次查询最大时间跨度为 1 天，历史查询最大时间范围为 366 天。 "StartTime": "2021-08-16T00:00:00+08:00", # 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 "EndTime": "2021-08-16T00:00:00+08:00", # 数据聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 #

5：5 秒；

30：（默认值）30 秒。

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

5：5 秒；

30：30 秒；

60：（默认值）1 分钟。

"Aggregation": 5, # 数据聚合时间粒度内，动态指标的聚合算法，取值及含义如下所示。 #

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

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

"AggType": "max", } resp = service.describe_live_batch_push_stream_metrics(body) print(resp) ``` ### 查询多路推流监控数据平均值您可以调用 DescribeLiveBatchPushStreamAvgMetrics 接口查询多路推流监控数据平均值。详细的参数说明可参见 [DescribeLiveBatchPushStreamAvgMetrics](https://www.volcengine.com/docs/6469/1215508) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 推流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看直播流使用的推流域名。 "Domain": "push.example.com", # 应用名称，取值与直播流地址中的 AppName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 # note： # 查询流粒度的监控数据时，需同时指定 App 和 Stream 来指定直播流。 "App": "live", # 流名称，预置与直播流地址中的 StreamName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 # note： # 查询流粒度的监控数据时，需同时指定 App 和 Stream 来指定直播流。 "Stream": "example_stream", # 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 # note： # 单次查询最大时间跨度为 1 天，历史查询最大时间范围为 366 天。 "StartTime": "2021-08-16T00:00:00+08:00", # 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 "EndTime": "2021-08-16T00:01:59+08:00", # 数据聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 #

5：5 秒；

30：30 秒；

60：（默认值）1 分钟。

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

30：30 秒；

60：（默认值）1 分钟。

"Aggregation": 30, } resp = service.describe_live_batch_source_stream_metrics(body) print(resp) ``` ### 查询多路回源流监控数据平均值您可以调用 DescribeLiveBatchSourceStreamAvgMetrics 接口查询多路回源流监控数据平均值。详细的参数说明可参见 [DescribeLiveBatchSourceStreamAvgMetrics](https://www.volcengine.com/docs/6469/1215509) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 拉流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看回源流使用的拉流域名。 "Domain": "pull.example.com", # 应用名称，取值与直播流地址中的 AppName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 # note： # 查询流粒度的监控数据时，需同时指定 App 和 Stream 来指定回源流。 "App": "live", # 流名称，预置与直播流地址中的 StreamName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 # note： # 查询流粒度的监控数据时，需同时指定 App 和 Stream 来指定回源流。 "Stream": "example_stream", # 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 # note： # 单次查询最大时间跨度为 1 天，历史查询最大时间范围为 366 天。 "StartTime": "2021-08-16T00:00:00+08:00", # 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 "EndTime": "2021-08-16T00:01:59+08:00", # 数据聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 #

30：30 秒；

60：（默认值）1 分钟。

"Aggregation": 30, } resp = service.describe_live_batch_source_stream_avg_metrics(body) print(resp) ``` ### 查询域名或单个直播流的拉流数据您可以调用 DescribeLiveStreamSessionData 接口查询域名或单个直播流的拉流数据。详细的参数说明可参见 [DescribeLiveStreamSessionData](https://www.volcengine.com/docs/6469/1126919) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 拉流域名列表，默认为空，表示查询所有域名的请求数和在线人数。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 # note： # DomainList 和 Domain 传且仅传一个。 "DomainList": ["pull.example.com"], # 拉流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 # note： # 查询流粒度的请求数和在线人数数据时，需同时指定 Domain 、App 和 Stream 来指定直播流。 "Domain": "pull.example.com", # 应用名称，取值与直播流地址中的 AppName 字段取值相同，查询流粒度数据时必传，且需同时传入 Domain 和 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 # note： # 查询流粒度的回源流量监控数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 "App": "example_app", # 流名称，取值与直播流地址中的 StreamName 字段取值相同，查询流粒度数据时必传，且需同时传入 Domain 和 App。支持由大小写字母（A - Z、a - z）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 # note： # 查询流粒度的回源流量监控数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 "Stream": "example_stream", # 指定拉流请求的 Referer 信息，默认为空，表示不对拉流请求的 Referer 字段进行校验。 "RefererList": ["www.test.com"], # 推拉流协议，缺省情况下表示所有协议类型，支持的协议如下所示。 #

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，不能同时查询其他协议。 "ProtocolList": ["HTTP-FLV", "RTMP"], # 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 #

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数；

other：其他。

# 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 "ISPList": ["telecom"], # CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 "RegionList": [ { # The identifier for the major region in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). "Area": "CN", # The country identifier in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by country, both 'Area' and 'Country' need to be passed in simultaneously. "Country": "CN", # The province identifier in the regional information is currently not supported for countries or regions outside mainland China, Hong Kong, Macao, and Taiwan. You can obtain the identifier information by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by province, you need to simultaneously pass in Area, Country, and Province "Province": "beijing", } ], # 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 "StartTime": "2021-04-13T00:00:00+08:00", # 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 "EndTime": "2021-04-14T00:00:00+08:00", # 数据聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 #

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

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

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

"Aggregation": 300, # 数据拆分的维度，默认为空表示不按维度进行数据拆分，支持的维度如下所示。 #

Domain：域名；

ISP：运营商；

Protocol：推拉流协议；

Referer：请求的 Referer 信息。

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，不能同时查询其他协议。

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

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

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

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数；

other：其他。

# 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 "ISPList": ["telecom"], # CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 "RegionList": [ { # 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 "Area": "CN", # 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 "Country": "CN", # 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 "Province": "beijing", } ], } resp = service.describe_live_batch_stream_session_data(body) print(resp) ``` ### 查询直播流或域名的流量监控数据您可以调用 DescribeLiveMetricTrafficData 接口查询直播流或域名的流量监控数据。详细的参数说明可参见 [DescribeLiveMetricTrafficData](https://www.volcengine.com/docs/6469/1126920) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 域名列表，默认为空，表示查询您视频直播产品下所有域名的流量监控数据。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的域名。 "DomainList": ["push.example.com"], # 应用名称，取值与直播流地址中的 AppName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 # note： # 查询流粒度的流量监控数据时，需同时指定 App 和 Stream 来指定直播流。 "App": "live", # 流名称，取值与直播流地址中的 StreamName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 # note： # 查询流粒度的流量监控数据时，需同时指定 App 和 Stream 来指定直播流。 "Stream": "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 的全新的低延时互联网传输协议。

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数；

other：其他。

# 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 "ISPList": ["telecom"], # CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 # note： # 参数 RegionList和UserRegionList 不支持同时传入。 "RegionList": [ { # The identifier for the major region in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). "Area": "CN", # The country identifier in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by country, both 'Area' and 'Country' need to be passed in simultaneously. "Country": "CN", # The province identifier in the regional information is currently not supported for countries or regions outside mainland China, Hong Kong, Macao, and Taiwan. You can obtain the identifier information by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by province, you need to simultaneously pass in Area, Country, and Province "Province": "beijing", } ], # 客户端 IP 所属区域的列表，缺省情况下表示所有区域。 # note： # 参数 RegionList和UserRegionList 不支持同时传入。 "UserRegionList": [ { # The identifier for the major region in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). "Area": "CN", # The country identifier in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by country, both 'Area' and 'Country' need to be passed in simultaneously. "Country": "CN", # The province identifier in the regional information is currently not supported for countries or regions outside mainland China, Hong Kong, Macao, and Taiwan. You can obtain the identifier information by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by province, you need to simultaneously pass in Area, Country, and Province "Province": "beijing", } ], # 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 "StartTime": "2021-04-13T00:00:00+08:00", # 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 "EndTime": "2021-04-14T00:00:00+08:00", # 聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 #

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

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

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

"Aggregation": 300, # 数据拆分的维度，默认为空表示不按维度进行数据拆分，支持的维度如下所示。 #

Domain：域名；

Protocol：推拉流协议；

ISP：运营商。

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：华数；

other：其他。

# 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 "ISPList": ["telecom"], # CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 # note： # 参数 RegionList和UserRegionList 不支持同时传入。 "RegionList": [ { # 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 "Area": "CN", # 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 "Country": "CN", # 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 "Province": "beijing", } ], # 客户端 IP 所属区域的列表，缺省情况下表示所有区域。 # note： # 参数 RegionList和UserRegionList 不支持同时传入。 "UserRegionList": [ { # 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 "Area": "CN", # 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 "Country": "CN", # 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 "Province": "beijing", } ], } resp = service.describe_live_batch_stream_traffic_data(body) print(resp) ``` ### 查询直播流或域名的带宽监控数据您可以调用 DescribeLiveMetricBandwidthData 接口查询直播流或域名的带宽监控数据。详细的参数说明可参见 [DescribeLiveMetricBandwidthData](https://www.volcengine.com/docs/6469/1126922) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 域名列表，默认为空，表示查询您视频直播产品下所有域名的带宽监控数据。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的域名。 "DomainList": ["push.example.com"], # 应用名称，取值与直播流地址中的 AppName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 # note： # 查询流粒度的带宽监控数据时，需同时指定 App 和 Stream 来指定直播流。 "App": "live", # 流名称，预置与直播流地址中的 StreamName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 # note： # 查询流粒度的带宽监控数据时，需同时指定 App 和 Stream 来指定直播流。 "Stream": "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 的全新的低延时互联网传输协议。

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数；

other：其他。

# 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 "ISPList": ["telecom"], # CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 # note： # 参数 RegionList和UserRegionList 不支持同时传入。 "RegionList": [ { # The identifier for the major region in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). "Area": "CN", # The country identifier in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by country, both 'Area' and 'Country' need to be passed in simultaneously. "Country": "CN", # The province identifier in the regional information is currently not supported for countries or regions outside mainland China, Hong Kong, Macao, and Taiwan. You can obtain the identifier information by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by province, you need to simultaneously pass in Area, Country, and Province "Province": "beijing", } ], # 客户端 IP 所属区域的列表，缺省情况下表示所有区域。 # note： # 参数 RegionList和UserRegionList 不支持同时传入。 "UserRegionList": [ { # The identifier for the major region in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). "Area": "CN", # The country identifier in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by country, both 'Area' and 'Country' need to be passed in simultaneously. "Country": "CN", # The province identifier in the regional information is currently not supported for countries or regions outside mainland China, Hong Kong, Macao, and Taiwan. You can obtain the identifier information by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by province, you need to simultaneously pass in Area, Country, and Province "Province": "beijing", } ], # 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 "StartTime": "2021-04-13T00:00:00+08:00", # 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 "EndTime": "2021-04-14T00:00:00+08:00", # 聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 #

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

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

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

"Aggregation": 300, # 数据拆分的维度，默认为空表示不按维度进行数据拆分，支持的维度如下所示。 #

Domain：域名；

Protocol：推拉流协议；

ISP：运营商。

# note： # 配置数据拆分的维度时，对应的维度参数传入多个值时才会返回按此维度拆分的数据。例如，配置按 Domain 进行数据拆分时， DomainList 传入多个 Domain 值时，才会返回按 Domain 拆分的数据。 "DetailField": ["Domain"], } resp = service.describe_live_metric_bandwidth_data(body) print(resp) ``` ### 查询直播流或域名的回源流量监控数据您可以调用 DescribeLiveSourceTrafficData 接口查询直播流或域名的回源流量监控数据。详细的参数说明可参见 [DescribeLiveSourceTrafficData](https://www.volcengine.com/docs/6469/1126923) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 拉流域名列表，默认为空，表示查询所有域名的回源流量监控数据。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 # note： # DomainList 和 Domain 传且仅传一个。 "DomainList": ["pull.example.com", "pull2.example.com"], # 拉流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 # note： # 查询流粒度的回源流量监控数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 "Domain": "pull.example.com", # 回源流的应用名称，查询流粒度数据时必传，且需同时传入 Domain 和 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 # note： # 查询流粒度的回源流量监控数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 "App": "live", # 回源流的流名称，查询流粒度数据时必传，且需同时传入 Domain 和 App。支持由大小写字母（A - Z、a - z）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 # note： # 查询流粒度的回源流量监控数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 "Stream": "example_stream", # 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 #

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数；

other：其他。

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

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

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

"Aggregation": 300, # 数据拆分的维度，默认为空表示按维度进行数据拆分，支持的维度如下所示。 #

Domain：域名；

ISP：运营商。

# note： # 配置数据拆分的维度时，对应的维度参数传入多个值时才会返回按此维度拆分的数据。例如，配置按 Domain 进行数据拆分时， DomainList 传入多个 Domain 值时，才会返回按 Domain 拆分的数据。 "DetailField": ["Domain"], } resp = service.describe_live_source_traffic_data(body) print(resp) ``` ### 查询直播流或域名的回源带宽监控数据您可以调用 DescribeLiveSourceBandwidthData 接口查询直播流或域名的回源带宽监控数据。详细的参数说明可参见 [DescribeLiveSourceBandwidthData](https://www.volcengine.com/docs/6469/1126924) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 拉流域名列表，默认为空，表示查询所有域名的回源带宽监控数据。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 # note： # DomainList 和 Domain 传且仅传一个。 "DomainList": ["pull.example.com", "pull2.example.com"], # 拉流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 # note： # 查询流粒度的回源带宽监控数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 "Domain": "pull.example.com", # 回源流的应用名称，查询流粒度数据时必传，且需同时传入 Domain 和 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 # note： # 查询流粒度的回源带宽监控数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 "App": "example_app", # 回源流的流名称，查询流粒度数据时必传，且需同时传入 Domain 和 App。支持由大小写字母（A - Z、a - z）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 # note： # 查询流粒度的回源带宽监控数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 "Stream": "example_stream", # 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 #

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数；

other：其他。

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

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

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

"Aggregation": 300, # 数据拆分的维度，默认为空表示不按维度进行数据拆分，支持的维度如下所示。 #

Domain：域名；

ISP：运营商。

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数；

other：其他。

# 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 "ISPList": ["telecom"], # CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 # note： # 参数 RegionList和UserRegionList 不支持同时传入。 "RegionList": [ { # The identifier for the major region in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). "Area": "CN", # The country identifier in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by country, both 'Area' and 'Country' need to be passed in simultaneously. "Country": "CN", # The province identifier in the regional information is currently not supported for countries or regions outside mainland China, Hong Kong, Macao, and Taiwan. You can obtain the identifier information by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by province, you need to simultaneously pass in Area, Country, and Province "Province": "beijing", } ], # 客户端 IP 所属区域的列表，缺省情况下表示所有区域。 # note： # 参数 RegionList和UserRegionList 不支持同时传入。 "UserRegionList": [ { # The identifier for the major region in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). "Area": "CN", # The country identifier in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by country, both 'Area' and 'Country' need to be passed in simultaneously. "Country": "CN", # The province identifier in the regional information is currently not supported for countries or regions outside mainland China, Hong Kong, Macao, and Taiwan. You can obtain the identifier information by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by province, you need to simultaneously pass in Area, Country, and Province "Province": "beijing", } ], # 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 "StartTime": "2024-04-28T14:00:00+08:00", # 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 "EndTime": "2024-04-28T14:00:00+08:00", # 聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 #

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

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

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

"Aggregation": 300, # 数据拆分的维度，默认为空表示不按维度进行数据拆分，支持的维度如下所示。 #

Domain：域名；

ISP：运营商。

# note： # 配置数据拆分的维度时，对应的维度参数传入多个值时才会返回按此维度拆分的数据。例如，配置按 Domain 进行数据拆分时， DomainList 传入多个 Domain 值时，才会返回按 Domain 拆分的数据。 "DetailField": ["Domain"], # 请求类型，取值及含义如下所示。 #

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

Source：回源请求。

"Type": "Access", } resp = service.describe_live_play_status_code_data(body) print(resp) ``` ### 查询 IP 地址归属的 CDN 节点您可以调用 DescribeIpInfo 接口查询 IP 地址归属的 CDN 节点。详细的参数说明可参见 [DescribeIpInfo](https://www.volcengine.com/docs/6469/1126927) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 待查询的 IP 地址列表。支持 IPv4 和 IPv6 地址，一次最多查询 50 个 IP 地址。 "Ips": ["186.199.***.1"], } resp = service.describe_ip_info(body) print(resp) ``` ### 查询峰值流数您可以调用 DescribeLiveStreamCountData 接口查询峰值流数。详细的参数说明可参见 [DescribeLiveStreamCountData](https://www.volcengine.com/docs/6469/1134317) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 直播流使用的域名列表，默认为空，表示查询所有全部域名下的峰值流数。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看直播流使用的域名。 "DomainList": ["push.exmaple.com", "push2.example.com"], # 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 "StartTime": "2021-08-16T00:00:00+08:00", # 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 "EndTime": "2021-08-16T00:01:59+08:00", # 聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 #

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

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

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

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

"Aggregation": 60, # 数据拆分的维度，默认为空表示不按维度进行数据拆分，当前支持填写 Domain 表示按查询的域名为维度进行数据拆分。 # note： # 配置数据拆分的维度时，对应的维度参数传入多个值时才会返回按此维度拆分的数据。例如，配置按 Domain 进行数据拆分时， DomainList 传入多个 Domain 值时，才会返回按 Domain 拆分的数据。 "DetailField": ["Domain"], # 流类型，缺省情况下表示全部类型，支持的流类型取值如下。 #

push：推流；

relay-source：回源流；

transcode：转码流。

"StreamType": ["push"], } resp = service.describe_live_stream_count_data(body) print(resp) ``` ### 查询推流峰值流数您可以调用 DescribeLivePushStreamCountData 接口查询推流峰值流数。详细的参数说明可参见 [DescribeLivePushStreamCountData](https://www.volcengine.com/docs/6469/1134318) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 推流域名列表，默认为空，表示查询所有全部域名下的推流峰值流数。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看直播流使用的推流域名。 "DomainList": ["push.example.com", "push2.example.com"], # 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 "StartTime": "2021-08-16T00:00:00+08:00", # 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 "EndTime": "2021-08-16T00:01:59+08:00", # 数据聚合的时间粒度，单位为秒，支持的时间粒度如下所示。 #

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

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

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

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

"Aggregation": 60, # 数据拆分的维度，默认为空表示不按维度进行数据拆分，当前接口仅支持填写 Domain 表示按查询的域名为维度进行数据拆分。 # note： # 配置数据拆分的维度时，对应的维度参数传入多个值时才会返回按此维度拆分的数据。例如，配置按 Domain 进行数据拆分时， DomainList 传入多个 Domain 值时，才会返回按 Domain 拆分的数据。 "DetailField": ["Domain"], # 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 #

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数；

other：其他。

# 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 "ISPList": ["telecom"], # 客户端 IP 所属区域的列表，缺省情况下表示所有区域。 "UserRegionList": [ { # The identifier for the major region in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). "Area": "CN", # The country identifier in the regional information can be obtained by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by country, both 'Area' and 'Country' need to be passed in simultaneously. "Country": "CN", # The province identifier in the regional information is currently not supported for countries or regions outside mainland China, Hong Kong, Macao, and Taiwan. You can obtain the identifier information by calling [DescribeLiveRegionData](https://docs.byteplus.com/en/docs/byteplus-media-live/describeliveregiondata). When filtering by province, you need to simultaneously pass in Area, Country, and Province "Province": "beijing", } ], } resp = service.describe_live_push_stream_count_data(body) print(resp) ``` ### 查询推流流信息您可以调用 DescribeLivePushStreamInfoData 接口查询推流流信息。详细的参数说明可参见 [DescribeLivePushStreamInfoData](https://www.volcengine.com/docs/6469/1229191) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 直播推流使用的域名列表，缺省为空，表示当前账号下所有域名。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看直播推流使用的域名。 "DomainList": ["push.example.com"], # 应用名称，取值与直播流地址中 AppName 字段取值相同，默认为空，表示查询所有应用名称。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 "App": "example_app", # 流名称，取值与直播流地址中 StreamName 字段取值相同，默认为空表示查询所有流名称。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 "Stream": "example_stream", # 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 # note： # 支持查询最近 93 天以内的推流数据。 "StartTime": "2021-04-13T00:00:00+08:00", # 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 # note： # 支持查询最近 93 天以内的推流数据。 "EndTime": "2021-04-14T00:00:00+08:00", # 查询数据的页码，默认为 1，表示查询第一页的数据，取值范围为正整数。 "PageNum": 1, # 每页显示的数据条数，默认为 20，取值范围为 [1,1000]。 "PageSize": 20, } resp = service.describe_live_push_stream_info_data(body) print(resp) ``` ### 查询直播域名转码数据明细您可以调用 DescribeLiveTranscodeInfoData 接口查询直播域名转码数据明细。详细的参数说明可参见 [DescribeLiveTranscodeInfoData](https://www.volcengine.com/docs/6469/1257355) 接口文档。接口调用示例如下所示。 ```python # coding:utf-8 import os from volcengine.live.v20230101.live_service import LiveService if __name__ == "__main__": # 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 # 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service = LiveService( "live.volcengineapi.com", os.environ["VOLC_ACCESSKEY"], os.environ["VOLC_SECRETKEY"], ) body = { # 域名列表，默认为空，表示查询您视频直播产品下所有域名的转码用量数据。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的域名。 "DomainList": ["push.example.com", "push2.example.com"], # 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 # note： # 历史查询最大时间范围为 366 天。 "StartTime": "2021-04-13T00:00:00+08:00", # 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 "EndTime": "2021-04-14T00:00:00+08:00", # 应用名称，取值与直播流地址中 AppName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 # note： # 查询流粒度数据时，需同时传入 App 和 Stream。 "App": "live", # 流名称，取值与直播流地址中 StreamName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 # note： # 查询流粒度数据时，需同时传入 App 和 Stream。 "Stream": "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：纯音频转码。

"Resolution": ["720P", "1080P"], # 查询数据的页码，默认为 1，表示查询第一页的数据。 "PageNum": 1, # 每页显示的数据条数，默认为 20，最大值为 100000。 "PageSize": 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：纯音频流。

"TranscodeType": ["Normal_H264", "ByteHD_H265"], } resp = service.describe_live_transcode_info_data(body) print(resp) ```