本接口用来获取指定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 |
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>
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
要获取指定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接口文档详细描述了获取推流记录的具体响应元素和使用场景。