开发者社区 问答 正文

关于LiveChannel的操作之如何实现GetLiveChannelHistory?

本接口用来获取指定LiveChannel的推流记录。

请求语法GET /ChannelName?live&comp=history HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue





响应元素

名称描述
LiveChannelHistory保存GetLiveChannelHistory返回结果的容器。类型:容器子节点:LiveRecord父节点:无
LiveRecord保存一次推流记录信息的容器。类型:容器子节点:StartTime,EndTime,RemoteAddr父节点:LiveChannelHistory
StartTime推流开始时间,使用ISO8601格式表示。类型:字符串子节点:无父节点:LiveRecord
EndTime推流结束时间,使用ISO8601格式表示。类型:字符串子节点:无父节点:LiveRecord
RemoteAddr推流客户端的ip地址。类型:字符串子节点:无父节点:LiveRecord


细节分析


目前最多会返回指定LiveChannel最近的10次推流记录。

示例



请求示例GET /test-channel?live&comp=history HTTP/1.1
Date: Thu, 25 Aug 2016 07:00:12 GMT
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS YJjHKOKWDWINLKXv:pqgDBP8JXTXAytBoXpvNoZfo68k=





返回实例HTTP/1.1 200
content-length: 1892
server: AliyunOSS
connection: close
x-oss-request-id: 57BE977CB92475920B0022FB
date: Thu, 25 Aug 2016 07:00:12 GMT
content-type: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<LiveChannelHistory>
  <LiveRecord>
    <StartTime>2016-07-30T01:53:21.000Z</StartTime>
    <EndTime>2016-07-30T01:53:31.000Z</EndTime>
    <RemoteAddr>10.101.194.148:56861</RemoteAddr>
  </LiveRecord>
  <LiveRecord>
    <StartTime>2016-07-30T01:53:35.000Z</StartTime>
    <EndTime>2016-07-30T01:53:45.000Z</EndTime>
    <RemoteAddr>10.101.194.148:57126</RemoteAddr>
  </LiveRecord>
  <LiveRecord>
    <StartTime>2016-07-30T01:53:49.000Z</StartTime>
    <EndTime>2016-07-30T01:53:59.000Z</EndTime>
    <RemoteAddr>10.101.194.148:57577</RemoteAddr>
  </LiveRecord>
  <LiveRecord>
    <StartTime>2016-07-30T01:54:04.000Z</StartTime>
    <EndTime>2016-07-30T01:54:14.000Z</EndTime>
    <RemoteAddr>10.101.194.148:57632</RemoteAddr>
  </LiveRecord>
</LiveChannelHistory>



展开
收起
青衫无名 2017-10-23 10:15:32 1597 分享 版权
阿里云 AI 助理回答

要获取指定LiveChannel的推流记录,您需要使用GetLiveChannelHistory接口。该接口允许您查询指定频道最近的推流历史,最多可返回最近的10次推流记录。以下是执行此操作的请求语法及关键要素:

请求语法:

GET /ChannelName?live&comp=history HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

关键要素说明: - ChannelName: 替换为您的实际LiveChannel名称。 - live&comp=history: 固定参数,用于指定此请求是为了获取LiveChannel的推流历史记录。 - Date: 设置为当前的GMT日期时间。 - Host: 设置为您OSS存储空间(Bucket)的完整域名,格式为BucketName.oss-region.aliyuncs.com,其中region需替换为您的Bucket所在地域,例如oss-cn-hangzhou.aliyuncs.com。 - Authorization: 认证签名值,根据OSS的签名规则生成,确保请求的安全性。

执行此请求后,响应将包含一系列的LiveRecord对象,每个对象代表一次推流记录,含有如下信息: - StartTime: 推流开始时间,ISO8601格式。 - EndTime: 推流结束时间,ISO8601格式。 - RemoteAddr: 推流客户端的IP地址。

请确保在发起请求前,已正确配置了OSS的访问密钥和权限,并了解如何生成签名值以完成认证过程。此外,考虑到API调用限制和最佳实践,请合理安排查询频率并处理可能的异常情况。

参考资料: - GetLiveChannelStat接口文档提供了基础的请求结构和认证信息示例。 - Java管理LiveChannel文档展示了如何构建OSS客户端进行相关操作,包括设置凭证提供者等。 - GetLiveChannelHistory接口文档详细描述了获取推流记录的具体响应元素和使用场景。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答