全部产品
对象存储 OSS

ListLiveChannel

更新时间:2017-06-07 13:26:11   分享:   

请求语法

  1. GET /?live HTTP/1.1
  2. Date: GMT date
  3. Host: BucketName.oss-cn-hangzhou.aliyuncs.com
  4. 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

示例

请求示例

  1. GET /?live&max-keys=1 HTTP/1.1
  2. Date: Thu, 25 Aug 2016 07:50:09 GMT
  3. Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
  4. Authorization: OSS YJjHKOKWDWINLKXv:TaX+tlc/Xsgpz6uRuqcbmUJsIHw=

返回示例

  1. HTTP/1.1 200
  2. content-length: 656
  3. server: AliyunOSS
  4. connection: close
  5. x-oss-request-id: 57BEA331B92475920B00245E
  6. date: Thu, 25 Aug 2016 07:50:09 GMT
  7. content-type: application/xml
  8. <?xml version="1.0" encoding="UTF-8"?>
  9. <ListLiveChannelResult>
  10. <Prefix></Prefix>
  11. <Marker></Marker>
  12. <MaxKeys>1</MaxKeys>
  13. <IsTruncated>true</IsTruncated>
  14. <NextMarker>channel-0</NextMarker>
  15. <LiveChannel>
  16. <Name>channel-0</Name>
  17. <Description></Description>
  18. <Status>disabled</Status>
  19. <LastModified>2016-07-30T01:54:21.000Z</LastModified>
  20. <PublishUrls>
  21. <Url>rtmp://test-bucket.oss-cn-hangzhou.aliyuncs.com/live/channel-0</Url>
  22. </PublishUrls>
  23. <PlayUrls>
  24. <Url>http://test-bucket.oss-cn-hangzhou.aliyuncs.com/channel-0/playlist.m3u8</Url>
  25. </PlayUrls>
  26. </LiveChannel>
本文导读目录
本文导读目录
以上内容是否对您有帮助?