查询指定视频流在某个时间段的推流记录信息。
使用 GET 方式发起请求。
下表仅列出了接口特有的请求参数和部分公共参数。完整的公共参数列表,参考「公共参数」。
字段 | 位置 | 类型 | 必填 | 说明 | 值 |
---|---|---|---|---|---|
Action | Query | String | 是 | 公共参数,OpenAPI 接口名称 | StreamLogs |
Version | Query | String | 是 | 公共参数,OpenAPI 接口版本 | 2021-01-01 |
StreamID | Query | String | 是 | 视频流 ID | 可通过调用 ListStreams 接口获取 |
StartTs | Query | String | 是 | 查询的起始时间 | 例如:1662014220 |
EndTs | Query | String | 是 | 查询的结束时间 | 例如:1663137420 |
通用返回参数,请参考 ResponseMetadata 结构体说明。
Result 字段包含以下参数:
字段 | 类型 | 说明 |
---|---|---|
PageNumber | Int | 查询结果分页参数,页码 |
PageSize | Int | 查询结果分页参数,单页数据量 |
TotalCount | Int | 查询到的结果总数 |
StreamRecords | Array of objects | 查询到的推流记录列表,参考以下 List<StreamRecords> 结构说明 |
List<StreamRecords>
结构说明字段 | 类型 | 说明 |
---|---|---|
StreamID | String | 视频流 ID |
RecordID | String | 推流记录 ID |
StartTime | Int | 推流开始时间,例如:1662432095 |
EndTime | Int | 推流结束时间,例如:1662796332 |
Duration | Int | 推流时长,单位:秒,例如:364237 |
GET https://open.volcengineapi.com?Action=StreamLogs &Version=2021-01-01 &StreamID=2a772f0b-753c-4496-b535-a8df0fxxxxxx &StartTs=1662014220 &EndTs=1663137420 &<公共请求参数>
{ "ResponseMetadata": { "RequestId": "202209141449260102020891370D037571", "Action": "StreamLogs", "Version": "2021-01-01", "Service": "aiotvideo", "Region": "cn-north-1" }, "Result": { "PageNumber": 1, "PageSize": 20, "TotalCount": 3, "StreamRecords": [ { "RecordID": "363283ed-8920-4a31-b3e3-682bd5xxxxxx", "StreamID": "2a772f0b-753c-4496-b535-a8df0fxxxxxx", "StartTime": 1662796440, "EndTime": 0, "Duration": 0 }, { "RecordID": "c3c640dc-fe37-485f-bea1-49276exxxxxx", "StreamID": "2a772f0b-753c-4496-b535-a8df0fxxxxxx", "StartTime": 1662432095, "EndTime": 1662796332, "Duration": 364237 }, { "RecordID": "7da3b2f2-6d81-4fcc-a867-c9f818xxxxxx", "StreamID": "2a772f0b-753c-4496-b535-a8df0fxxxxxx", "StartTime": 1662103415, "EndTime": 1662432087, "Duration": 328672 } ] } }