ListLiveChannel接口用于列举指定的LiveChannel。

请求语法

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

请求元素

名称 类型 是否必选 描述
Marker 字符串 否 设定结果从marker之后按字母排序的第一个开始返回。
Max-keys 字符串 否 限定此次返回LiveChannel的最大数。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：表示禁用LiveChannel。
  • enabled：表示启用LiveChannel。
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 YJjHKOKWDWIN****:TaX+tlc/Xsgpz6uRuqcbmUJs****

返回示例

HTTP/1.1 200
content-length: 656
server: AliyunOSS
connection: close
x-oss-request-id: 57BEA331B92475920B00****
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>

SDK