阅读本文，您可以获取 Go 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) 的**文档说明**页签查看。 ## 前提条件调用接口前，请先完成 Go SDK 的[安装及初始化](https://www.volcengine.com/docs/6469/1166575)操作。 ## 调用示例本节为您介绍统计分析相关接口的功能和调用示例。 ### 查询区域标识符您可以调用 DescribeLiveRegionData 接口查询区域标识符。详细的参数说明可参见 [DescribeLiveRegionData](https://www.volcengine.com/docs/6469/1133973) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) resp, err := service.DescribeLiveRegionData(context.Background()) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询运营商标识符您可以调用 DescribeLiveISPData 接口查询运营商标识符。详细的参数说明可参见 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) resp, err := service.DescribeLiveISPData(context.Background()) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询单路推流监控数据您可以调用 DescribeLivePushStreamMetrics 接口查询单路推流监控数据。详细的参数说明可参见 [DescribeLivePushStreamMetrics](https://www.volcengine.com/docs/6469/1126915) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func Int32Ptr(v int32) *int32 { return &v } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLivePushStreamMetricsBody{ // 推流域名，您可以调用 [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: Int32Ptr(5), } resp, err := service.DescribeLivePushStreamMetrics(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询多路推流监控数据您可以调用 DescribeLiveBatchPushStreamMetrics 接口查询多路推流监控数据。详细的参数说明可参见 [DescribeLiveBatchPushStreamMetrics](https://www.volcengine.com/docs/6469/1126916) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func StringPtr(v string) *string { return &v } func Int32Ptr(v int32) *int32 { return &v } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLiveBatchPushStreamMetricsBody{ // 推流域名，您可以调用 [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: StringPtr("live"), // 流名称，预置与直播流地址中的 StreamName 字段取值相同，查询流粒度数据时必传，且需同时传入 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 // note： // 查询流粒度的监控数据时，需同时指定 App 和 Stream 来指定直播流。 Stream: StringPtr("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: Int32Ptr(5), // 数据聚合时间粒度内，动态指标的聚合算法，取值及含义如下所示。 //

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

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

AggType: StringPtr("max"), } resp, err := service.DescribeLiveBatchPushStreamMetrics(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询单路回源流监控数据您可以调用 DescribeLiveSourceStreamMetrics 接口查询单路回源流监控数据。详细的参数说明可参见 [DescribeLiveSourceStreamMetrics](https://www.volcengine.com/docs/6469/1126917) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func Int32Ptr(v int32) *int32 { return &v } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLiveSourceStreamMetricsBody{ // 拉流域名，您可以调用 [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: Int32Ptr(30), } resp, err := service.DescribeLiveSourceStreamMetrics(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询多路回源流监控数据您可以调用 DescribeLiveBatchSourceStreamMetrics 接口查询多路回源流监控数据。详细的参数说明可参见 [DescribeLiveBatchSourceStreamMetrics](https://www.volcengine.com/docs/6469/1126918) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func StringPtr(v string) *string { return &v } func Int32Ptr(v int32) *int32 { return &v } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLiveBatchSourceStreamMetricsBody{ // 拉流域名，您可以调用 [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: StringPtr("live"), // 流名称，取值与直播流地址中的 StreamName 字段取值相同，查询流粒度数据时必传，且需同时传入 App。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 // note： // 查询流粒度的监控数据时，需同时指定 App 和 Stream 来指定回源流。 Stream: StringPtr("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: Int32Ptr(30), // 数据聚合时间粒度内，动态指标的聚合算法，取值及含义如下所示。 //

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

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

AggType: StringPtr("max"), } resp, err := service.DescribeLiveBatchSourceStreamMetrics(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询域名或单个直播流的拉流数据您可以调用 DescribeLiveStreamSessionData 接口查询域名或单个直播流的拉流数据。详细的参数说明可参见 [DescribeLiveStreamSessionData](https://www.volcengine.com/docs/6469/1126919) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func StringPtrs(vals []string) []*string { ptrs := make([]*string, len(vals)) for i := 0; i < len(vals); i++ { ptrs[i] = &vals[i] } return ptrs } func StringPtr(v string) *string { return &v } func Int32Ptr(v int32) *int32 { return &v } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLiveStreamSessionDataBody{ // 拉流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 // note： // 查询流粒度的请求数和在线人数数据时，需同时指定 Domain 、App 和 Stream 来指定直播流。 Domain: StringPtr("pull.example.com"), // 应用名称，取值与直播流地址中的 AppName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 // note： // 查询流粒度的请求数和在线人数数据时，需同时指定 Domain 、App 和 Stream 来指定直播流。 App: StringPtr("example_app"), // 流名称，取值与直播流地址中的 StreamName 字段取值相同。支持由大小写字母（A - Z、a - z）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 // note： // 查询流粒度的请求数和在线人数数据时，需同时指定 Domain 、App 和 Stream 来指定直播流。 Stream: StringPtr("example_stream"), // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 历史查询最大时间范围为 366 天，单次查询最大时间跨度与数据拆分维度和数据聚合时间粒度有关，详细如下。 //

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

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

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

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

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

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

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

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

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

60：1 分钟。

300：（默认值）5 分钟。

3600：1 小时。

Aggregation: Int32Ptr(300), // 在线人数统计方式，取值及含义如下所示： //

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

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

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

OnlineUserType: StringPtr("Online"), } // 拉流域名列表，默认为空，表示查询所有域名的请求数和在线人数。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 // note： // DomainList 和 Domain 传且仅传一个。 DomainList := []string{"pull.example.com"} body.DomainList = StringPtrs(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，不能同时查询其他协议。 ProtocolList := []string{"HTTP-FLV", "RTMP"} body.ProtocolList = StringPtrs(ProtocolList) // 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 //

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数。

// 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 ISPList := []string{"telecom"} body.ISPList = StringPtrs(ISPList) // CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 RegionList1 := live.DescribeLiveStreamSessionDataBodyRegionListItem{ // 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 Area: StringPtr("CN"), // 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 Country: StringPtr("CN"), // 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 Province: StringPtr("beijing"), } body.RegionList = append(body.RegionList, &RegionList1) // 数据拆分的维度，默认为空表示不按维度进行数据拆分，支持的维度如下所示。 //

Domain：域名；

ISP：运营商；

Protocol：推拉流协议。

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 := []string{"RTMP"} body.ProtocolList = StringPtrs(ProtocolList) // 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 //

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数。

// 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 ISPList := []string{"telecom"} body.ISPList = StringPtrs(ISPList) // CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 // note： // 参数 RegionList和UserRegionList 不支持同时传入。 RegionList1 := live.DescribeLiveBatchStreamTrafficDataBodyRegionListItem{ // 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 Area: StringPtr("CN"), // 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 Country: StringPtr("CN"), // 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 Province: StringPtr("beijing"), } body.RegionList = append(body.RegionList, &RegionList1) // 客户端 IP 所属区域的列表，缺省情况下表示所有区域。 // note： // 参数 RegionList和UserRegionList 不支持同时传入。 UserRegionList1 := live.DescribeLiveBatchStreamTrafficDataBodyUserRegionListItem{ // 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 Area: StringPtr("CN"), // 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 Country: StringPtr("CN"), // 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 Province: StringPtr("beijing"), } body.UserRegionList = append(body.UserRegionList, &UserRegionList1) resp, err := service.DescribeLiveBatchStreamTrafficData(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询直播流或域名的回源流量监控数据您可以调用 DescribeLiveSourceTrafficData 接口查询直播流或域名的回源流量监控数据。详细的参数说明可参见 [DescribeLiveSourceTrafficData](https://www.volcengine.com/docs/6469/1126923) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func StringPtrs(vals []string) []*string { ptrs := make([]*string, len(vals)) for i := 0; i < len(vals); i++ { ptrs[i] = &vals[i] } return ptrs } func StringPtr(v string) *string { return &v } func Int32Ptr(v int32) *int32 { return &v } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLiveSourceTrafficDataBody{ // 拉流域名，您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 // note： // 查询流粒度数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 Domain: StringPtr("pull.example.com"), // 回源流的应用名称，查询流粒度数据时必传，且需同时传入 Domain 和 Stream。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 // note： // 查询流粒度数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 App: StringPtr("live"), // 回源流的流名称，查询流粒度数据时必传，且需同时传入 Domain 和 App。支持由大小写字母（A - Z、a - z）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 // note： // 查询流粒度数据时，需同时指定 Domain 、App 和 Stream 来指定回源流。 Stream: StringPtr("example_stream"), // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 历史查询最大时间范围为 366 天，单次查询最大时间跨度与数据拆分维度和数据聚合时间粒度有关，详细如下。 //

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

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

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

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

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

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

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

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

60：1 分钟。

300：（默认值）5 分钟。

3600：1 小时。

Aggregation: Int32Ptr(300), } // 拉流域名列表，默认为空，表示查询所有域名的回源流量带宽监控数据。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的拉流域名。 // note： // DomainList 和 Domain 传且仅传一个。 DomainList := []string{"pull.example.com", "pull2.example.com"} body.DomainList = StringPtrs(DomainList) // 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 //

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数。

// 您也可以通过 [DescribeLiveISPData](https://www.volcengine.com/docs/6469/1133974) 接口获取运营商对应的标识符。 ISPList := []string{"telecom"} body.ISPList = StringPtrs(ISPList) // 客户端 IP 所属区域的列表，缺省情况下表示所有区域。 UserRegionList1 := live.DescribeLiveSourceTrafficDataBodyUserRegionListItem{ // 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 Area: StringPtr("CN"), // 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 Country: StringPtr("CN"), // 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 Province: StringPtr("beijing"), } body.UserRegionList = append(body.UserRegionList, &UserRegionList1) // 数据拆分的维度，默认为空表示不按维度进行数据拆分，支持的维度如下所示。 //

Domain：域名；

ISP：运营商。

// note： // 配置数据拆分的维度时，对应的维度参数传入多个值时才会返回按此维度拆分的数据。例如，配置按 Domain 进行数据拆分时， DomainList 传入多个 Domain 值时，才会返回按 Domain 拆分的数据。 DetailField := []string{"Domain"} body.DetailField = StringPtrs(DetailField) resp, err := service.DescribeLiveSourceTrafficData(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询直播流的转码数据您可以调用 DescribeLiveBatchStreamTranscodeData 接口查询直播流的转码数据。详细的参数说明可参见 [DescribeLiveBatchStreamTranscodeData](https://www.volcengine.com/docs/6469/1126925) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func StringPtrs(vals []string) []*string { ptrs := make([]*string, len(vals)) for i := 0; i < len(vals); i++ { ptrs[i] = &vals[i] } return ptrs } func Int32Ptr(v int32) *int32 { return &v } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLiveBatchStreamTranscodeDataBody{ // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 查询历史数据的时间范围为 366 天。 StartTime: "2022-11-10T00:00:00+08:00", // 查询的结束时间，RFC3339 格式的时间戳，精度为秒。 EndTime: "2022-11-11T00:00:00+08:00", // 每页显示的数据条数，默认值为 1000，取值范围为 [100,1000]。 PageSize: Int32Ptr(100), // 查询数据的页码，默认值为 1，表示查询第一页的数据。 PageNum: Int32Ptr(1), } // 域名列表，默认为空表示全部域名。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取直播流使用的域名信息。 DomainList := []string{"pull.example.com", "pull2.example.com"} body.DomainList = StringPtrs(DomainList) resp, err := service.DescribeLiveBatchStreamTranscodeData(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询域名状态码占比您可以调用 DescribeLivePlayStatusCodeData 接口查询域名状态码占比。详细的参数说明可参见 [DescribeLivePlayStatusCodeData](https://www.volcengine.com/docs/6469/1126926) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func StringPtrs(vals []string) []*string { ptrs := make([]*string, len(vals)) for i := 0; i < len(vals); i++ { ptrs[i] = &vals[i] } return ptrs } func StringPtr(v string) *string { return &v } func Int32Ptr(v int32) *int32 { return &v } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLivePlayStatusCodeDataBody{ // 查询的开始时间，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: Int32Ptr(300), // 请求类型，取值及含义如下所示。 //

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

Source：回源请求。

Type: StringPtr("Access"), } // 域名列表，默认为空时表示查询所有域名下产生的请求状态码占比数据。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询请求状态码占比数据的域名。 DomainList := []string{"push.example.com", "pull.example.com"} body.DomainList = StringPtrs(DomainList) // 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 //

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数。

Domain：域名；

ISP：运营商。

// note： // 配置数据拆分的维度时，对应的维度参数传入多个值时才会返回按此维度拆分的数据。例如，配置按 Domain 进行数据拆分时， DomainList 传入多个 Domain 值时，才会返回按 Domain 拆分的数据。 DetailField := []string{"Domain"} body.DetailField = StringPtrs(DetailField) resp, err := service.DescribeLivePlayStatusCodeData(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询 IP 地址归属的 CDN 节点您可以调用 DescribeIpInfo 接口查询 IP 地址归属的 CDN 节点。详细的参数说明可参见 [DescribeIpInfo](https://www.volcengine.com/docs/6469/1126927) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeIPInfoBody{} // 待查询的 IP 地址列表。支持 IPv4 和 IPv6 地址，一次最多查询 50 个 IP 地址。 IPs := []string{"186.199.***.1"} body.IPs = IPs resp, err := service.DescribeIpInfo(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询峰值流数您可以调用 DescribeLiveStreamCountData 接口查询峰值流数。详细的参数说明可参见 [DescribeLiveStreamCountData](https://www.volcengine.com/docs/6469/1134317) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func StringPtrs(vals []string) []*string { ptrs := make([]*string, len(vals)) for i := 0; i < len(vals); i++ { ptrs[i] = &vals[i] } return ptrs } func Int32Ptr(v int32) *int32 { return &v } func StringPtr(v string) *string { return &v } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLiveStreamCountDataBody{ // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 历史查询最大时间范围为 366 天，单次查询最大时间跨度与数据拆分维度和数据聚合时间粒度有关，详细如下。 //

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

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

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

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

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

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

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

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

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

60：1 分钟；

300：（默认值）5 分钟；

3600：1 小时。

Aggregation: Int32Ptr(60), } // 直播流使用的域名列表，默认为空，表示查询所有全部域名下的峰值流数。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看直播流使用的域名。 DomainList := []string{"push.exmaple.com", "push2.example.com"} body.DomainList = StringPtrs(DomainList) // 数据拆分的维度，默认为空表示不按维度进行数据拆分，支持的维度如下所示。 //

Domain：域名；

ISP：运营商。

DetailField := []string{"Domain"} body.DetailField = StringPtrs(DetailField) // 流类型，缺省情况下表示全部类型，支持的流类型取值如下。 //

push：推流；

relay-source：回源流；

transcode：转码流。

StreamType := []string{"push"} body.StreamType = StringPtrs(StreamType) // 提供网络接入服务的运营商标识符，缺省情况下表示所有运营商，支持的运营商如下所示。 //

unicom：联通；

railcom：铁通；

telecom：电信；

mobile：移动；

cernet：教育网；

tianwei：天威；

alibaba：阿里巴巴；

tencent：腾讯；

drpeng：鹏博士；

btvn：广电；

huashu：华数。

// note： //

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

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

ISPList := []string{"telecom"} body.ISPList = StringPtrs(ISPList) // 客户端 IP 所属区域的列表，缺省情况下表示所有区域。 // note： // 当流类型 StreamType 为推流 push 时支持使用客户端 IP 所属的区域对查询数据进行筛选。 UserRegionList1 := live.DescribeLiveStreamCountDataBodyUserRegionListItem{ // 区域信息的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 Area: StringPtr("CN"), // 区域信息的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 Country: StringPtr("CN"), // 区域信息的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 Province: StringPtr("beijing"), } body.UserRegionList = append(body.UserRegionList, &UserRegionList1) resp, err := service.DescribeLiveStreamCountData(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询推流流信息您可以调用 DescribeLivePushStreamInfoData 接口查询推流流信息。详细的参数说明可参见 [DescribeLivePushStreamInfoData](https://www.volcengine.com/docs/6469/1229191) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func StringPtrs(vals []string) []*string { ptrs := make([]*string, len(vals)) for i := 0; i < len(vals); i++ { ptrs[i] = &vals[i] } return ptrs } func StringPtr(v string) *string { return &v } func Int32Ptr(v int32) *int32 { return &v } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLivePushStreamInfoDataBody{ // 应用名称，取值与直播流地址中 AppName 字段取值相同，默认为空，表示查询所有应用名称。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 App: StringPtr("example_app"), // 流名称，取值与直播流地址中 StreamName 字段取值相同，默认为空表示查询所有流名称。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 Stream: StringPtr("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: Int32Ptr(1), // 每页显示的数据条数，默认为 20，取值范围为 [1,1000]。 PageSize: Int32Ptr(20), } // 直播推流使用的域名列表，缺省为空，表示当前账号下所有域名。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，查看直播推流使用的域名。 DomainList := []string{"push.example.com"} body.DomainList = StringPtrs(DomainList) resp, err := service.DescribeLivePushStreamInfoData(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询直播域名转码数据明细您可以调用 DescribeLiveTranscodeInfoData 接口查询直播域名转码数据明细。详细的参数说明可参见 [DescribeLiveTranscodeInfoData](https://www.volcengine.com/docs/6469/1257355) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func StringPtrs(vals []string) []*string { ptrs := make([]*string, len(vals)) for i := 0; i < len(vals); i++ { ptrs[i] = &vals[i] } return ptrs } func StringPtr(v string) *string { return &v } func Int32Ptr(v int32) *int32 { return &v } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLiveTranscodeInfoDataBody{ // 查询的开始时间，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: StringPtr("live"), // 流名称，取值与直播流地址中 StreamName 字段取值相同。支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 // note： // 查询流粒度数据时，需同时传入 App 和 Stream。 Stream: StringPtr("example_stream"), // 查询数据的页码，默认为 1，表示查询第一页的数据。 PageNum: Int32Ptr(1), // 每页显示的数据条数。默认为 20，最大值为 100000。 PageSize: Int32Ptr(20), } // 域名列表，默认为空，表示查询您视频直播产品下所有域名的转码用量数据。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的域名。 DomainList := []string{"push.example.com", "push2.example.com"} body.DomainList = StringPtrs(DomainList) // 转码分辨率档位，默认为空表示不指定转码分辨率档位。以 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 := []string{"720P", "1080P"} body.Resolution = StringPtrs(Resolution) // 视频编码格式，默认为空表示不指定视频编码格式，支持的取值和含义如下所示。 //

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 := []string{"Normal_H264", "ByteHD_H265"} body.TranscodeType = StringPtrs(TranscodeType) resp, err := service.DescribeLiveTranscodeInfoData(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询 TOPN 直播流或域名的流量和带宽信息您可以调用 DescribeLiveTopPlayData 接口查询 TOPN 直播流或域名的流量和带宽信息。详细的参数说明可参见 [DescribeLiveTopPlayData](https://www.volcengine.com/docs/6469/1386117) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func StringPtr(v string) *string { return &v } func StringPtrs(vals []string) []*string { ptrs := make([]*string, len(vals)) for i := 0; i < len(vals); i++ { ptrs[i] = &vals[i] } return ptrs } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLiveTopPlayDataBody{ // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： //

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

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

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

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

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

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

QueryType: StringPtr("Stream"), // TOPN 结果的排序指标，取值及含义如下所示。 //

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

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

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

SortBy: StringPtr("PeakBandwidth"), // 每页显示的数据条数，默认值为 10，取值范围为 [1,1000]。 PageSize: StringPtr("10"), // 查询数据的页码，默认值为 1，表示查询第一页的数据。 // note： // PageSize 为 10，PageNum 为 1 时，表示查询 TOP 10 的数据。 PageNum: StringPtr("1"), } // 域名空间列表，默认为空，表示所有域名空间。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的域名空间信息。 VhostList := []string{"push.example.com"} body.VhostList = StringPtrs(VhostList) // 域名列表，默认为空，表示所有域名。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的域名信息。 DomainList := []string{"push.example.com"} body.DomainList = StringPtrs(DomainList) resp, err := service.DescribeLiveTopPlayData(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ``` ### 查询边缘数据您可以调用 DescribeLiveEdgeStatData 接口查询边缘数据。详细的参数说明可参见 [DescribeLiveEdgeStatData](https://www.volcengine.com/docs/6469/1399004) 接口文档。接口调用示例如下所示。 ```go package main import ( "context" "fmt" "os" "github.com/volcengine/volc-sdk-golang/base" live "github.com/volcengine/volc-sdk-golang/service/live/v20230101" ) func StringPtrs(vals []string) []*string { ptrs := make([]*string, len(vals)) for i := 0; i < len(vals); i++ { ptrs[i] = &vals[i] } return ptrs } func StringPtr(v string) *string { return &v } func Int32Ptr(v int32) *int32 { return &v } func main() { // 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。 // 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY service := live.NewInstance() service.SetCredential(base.Credentials{ AccessKeyID: os.Getenv("VOLC_ACCESSKEY"), SecretAccessKey: os.Getenv("VOLC_SECRETKEY"), }) body := &live.DescribeLiveEdgeStatDataBody{ // 查询的开始时间，RFC3339 格式的时间戳，精度为秒。 // note： // 历史查询最大时间范围为 366 天，单次查询最大时间跨度与数据拆分维度和数据聚合时间粒度有关，详细如下。 //

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

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

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

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

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

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

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

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

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

60：1 分钟。

300：（默认值）5 分钟。

3600：1 小时。

Aggregation: Int32Ptr(300), } // 域名列表，默认为空，表示您添加到视频直播中的所有域名。您可以调用 [ListDomainDetail](https://www.volcengine.com/docs/6469/1126815) 接口或在视频直播控制台的[域名管理](https://console.volcengine.com/live/main/domain/list)页面，获取待查询的域名。 DomainList := []string{"push.example.com", "pull.example.com"} body.DomainList = StringPtrs(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) 接口获取运营商对应的标识符。 ISPList := []string{"unicom", "telecom"} body.ISPList = StringPtrs(ISPList) // CDN 节点 IP 所属区域的列表，缺省情况下表示所有区域。 // note： // 参数 RegionList和UserRegionList 不支持同时传入。 RegionList1 := live.DescribeLiveEdgeStatDataBodyRegionListItem{ // 区域信息中的大区标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。 Area: StringPtr("CN"), // 区域信息中的国家标识符，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按国家筛选，需要同时传入 Area 和 Country。 Country: StringPtr("CN"), // 区域信息中的省份标识符，国外暂不支持该参数，如何获取请参见[查询区域标识符](https://www.volcengine.com/docs/6469/1133973)。如果按省筛选，需要同时传入 Area、Country 和 Province。 Province: StringPtr("beijing"), } body.RegionList = append(body.RegionList, &RegionList1) // 数据拆分的维度，缺省情况下不进行数据拆分，支持的维度如下所示。 //

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 时的数据。 DetailField := []string{"Domain"} body.DetailField = StringPtrs(DetailField) // 直播流地址中的 AppName 字段列表，默认为空表示所有 AppName。每个 AppName 支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 30 个字符。 AppList := []string{"live", "vodlive"} body.AppList = StringPtrs(AppList) // 直播流地址中的 StreamName 字段列表，默认为空表示所有 StreamName。每个 StreamName 支持由大小写字母（A - Z、a - z）、数字（0 - 9）、下划线（_）、短横线（-）和句点（.）组成，长度为 1 到 100 个字符。 StreamList := []string{"stream001", "stream002"} body.StreamList = StringPtrs(StreamList) resp, err := service.DescribeLiveEdgeStatData(context.Background(), body) if err != nil { fmt.Printf("error %v", err) } else { fmt.Printf("success %+v", resp) } } ```