请求语法GET /?live HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
请求参数
名称 | 描述 | 是否必需 |
marker | 设定结果从marker之后按字母排序的第一个开始返回。 | 否 |
max-keys | 限定此次返回LiveChannel的最大数,如果不设定,默认为100,max-keys取值不能大于1000。 | 否默认值:100 |
prefix | 限定返回的LiveChannel必须以prefix作为前缀。注意使用prefix查询时,返回的key中仍会包含prefix。 | 否 |
名称 | 描述 |
ListLiveChannelResult | 保存ListLiveChannel请求结果的容器。类型:容器字节点:Prefix,Marker,MaxKeys,IsTruncated,NextMarker,LiveChannel父节点:无 |
Prefix | 本次查询结果的开始前缀。 类型:字符串子节点:无父节点:ListLiveChannelResult |
Marker | 本次ListLiveChannel的起点。 类型:字符串子节点:无父节点:ListLiveChannelResult |
MaxKeys | 响应请求内返回结果的最大数目。类型:字符串子节点:无父节点:ListLiveChannelResult |
IsTruncated | 指明是否所有的结果都已经返回; “true”表示本次没有返回全部结果;“false”表示本次已经返回了全部结果。类型:字符串子节点:无父节点:ListLiveChannelResult |
NextMarker | 如果本次没有返回全部结果,响应请求中将包含NextMarker元素,用于标明接下来请求的Marker值。 类型:字符串子节点:无父节点:ListLiveChannelResult |
LiveChannel | 保存返回每个LiveChannel信息的容器。 类型:容器子节点:Name,Description,Status,LastModified,PublishUrls,PlayUrls父节点:ListLiveChannelResult |
Name | LiveChannel的名称。 类型:字符串子节点:无父节点:LiveChannel |
Description | LiveChannel的描述。类型:字符串子节点:无父节点:LiveChannel |
Status | LiveChannel的状态。类型:枚举字符串子节点:无父节点:LiveChannel有效值:disabled,enabled |
LastModified | LiveChannel配置的最后修改时间,使用ISO8601格式表示。类型:字符串子节点:无父节点:LiveChannel |
PublishUrls | 保存LiveChannel对应的推流地址的容器。类型:容器子节点:Url父节点:LiveChannel |
Url | LiveChannel对应的推流地址。类型:字符串子节点:无父节点:PublishUrls |
PlayUrls | 保存LiveChannel对应的播放地址的容器。类型:容器子节点:Url父节点:LiveChannel |
Url | LiveChannel对应的播放地址。 类型:字符串子节点:无父节点:PlayUrls |
GET /?live&max-keys=1 HTTP/1.1
Date: Thu, 25 Aug 2016 07:50:09 GMT
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS YJjHKOKWDWINLKXv:TaX+tlc/Xsgpz6uRuqcbmUJsIHw=
HTTP/1.1 200
content-length: 656
server: AliyunOSS
connection: close
x-oss-request-id: 57BEA331B92475920B00245E
date: Thu, 25 Aug 2016 07:50:09 GMT
content-type: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<ListLiveChannelResult>
<Prefix></Prefix>
<Marker></Marker>
<MaxKeys>1</MaxKeys>
<IsTruncated>true</IsTruncated>
<NextMarker>channel-0</NextMarker>
<LiveChannel>
<Name>channel-0</Name>
<Description></Description>
<Status>disabled</Status>
<LastModified>2016-07-30T01:54:21.000Z</LastModified>
<PublishUrls>
<Url>rtmp://test-bucket.oss-cn-hangzhou.aliyuncs.com/live/channel-0</Url>
</PublishUrls>
<PlayUrls>
<Url>http://test-bucket.oss-cn-hangzhou.aliyuncs.com/channel-0/playlist.m3u8</Url>
</PlayUrls>
</LiveChannel>
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
根据您提供的请求语法和响应元素详情,您似乎是想了解如何使用OSS API来列出(List)指定Bucket中的LiveChannel信息。虽然直接给出的参考资料中没有直接列举ListLiveChannel
操作的文档,但我们可以基于您提供的信息和OSS API的一般模式来构建一个操作指南。
您希望查询某个Bucket中LiveChannel的列表,并获取每个LiveChannel的详细配置信息,包括名称、描述、状态等。
构造请求URL与HTTP方法:
https://BucketName.oss-cn-hangzhou.aliyuncs.com/?live
GET
设置请求头:
Authorization: SignatureValue
,其中SignatureValue
需要根据OSS的签名规则生成,确保请求的安全性。Date
也需正确设置,表示请求时间。可选请求参数:
发送请求并处理响应:
ListLiveChannelResult
容器中,结构如下:
true
或false
)。oss:ListLiveChannel
权限。SignatureValue
。max-keys
值,避免一次性请求过多数据。IsTruncated
为true
,需要通过NextMarker
继续分页查询剩余的LiveChannel。GET /?live HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT date
Authorization: SignatureValueGeneratedByRules
请根据实际情况调整请求参数,并确保使用正确的签名生成方式来完成API调用。