ListLiveChannel接口用于列举指定的LiveChannel。
请求语法
GET /?live HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue请求元素
名称 | 类型 | 是否必选 | 描述 |
marker | 字符串 | 否 | 设定结果从marker之后按字母排序的第一个开始返回。 |
max-keys | 字符串 | 否 | 限定此次返回LiveChannel的最大数。 取值：大于0小于等于1000 默认值：100 |
prefix | 字符串 | 否 | 限定返回的LiveChannel必须以prefix作为前缀。使用prefix查询时，返回的key中仍会包含prefix。 |
此接口还需要包含Host、Date等公共请求头。更多信息，请参见公共请求头（Common Request Headers）。
响应元素
名称 | 类型 | 描述 |
ListLiveChannelResult | 容器 | 保存ListLiveChannel请求结果的容器。 子节点：Prefix、Marker、MaxKeys、IsTruncated、NextMarker、LiveChannel 父节点：无 |
Prefix | 字符串 | 本次查询结果的开始前缀。 子节点：无 父节点：ListLiveChannelResult |
Marker | 字符串 | 本次ListLiveChannel的起点。 子节点：无 父节点：ListLiveChannelResult |
MaxKeys | 字符串 | 响应请求内返回结果的最大数目。 子节点：无 父节点：ListLiveChannelResult |
IsTruncated | 字符串 | 是否已返回所有的结果。
子节点：无 父节点：ListLiveChannelResult |
NextMarker | 字符串 | 如果本次没有返回全部结果，响应请求中将包含NextMarker元素，用于标明接下来请求的Marker值。 子节点：无 父节点：ListLiveChannelResult |
LiveChannel | 容器 | 保存返回每个LiveChannel信息的容器。 子节点：Name、Description、Status、LastModified、PublishUrls、PlayUrls 父节点：ListLiveChannelResult |
Name | 字符串 | LiveChannel的名称。 子节点：无 父节点：LiveChannel |
Description | 字符串 | LiveChannel的描述信息。 子节点：无 父节点：LiveChannel |
Status | 枚举字符串 | LiveChannel的状态。 子节点：无 父节点：LiveChannel 有效值：
|
LastModified | 字符串 | LiveChannel配置的最后修改时间。 格式：ISO8601 子节点：无 父节点：LiveChannel |
PublishUrls | 容器 | 保存LiveChannel对应的推流地址的容器。 子节点：Url 父节点：LiveChannel |
Url | 字符串 | LiveChannel对应的推流地址。 子节点：无 父节点：PublishUrls |
PlayUrls | 容器 | 保存LiveChannel对应的播放地址的容器。 子节点：Url 父节点：LiveChannel |
Url | 字符串 | LiveChannel对应的播放地址。 子节点：无 父节点：PlayUrls |
此接口还包含ETag、x-oss-request-id等公共响应头。更多信息，请参见公共响应头（Common Response Headers）。
示例
请求示例
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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e返回示例
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>
</ListLiveChannelResult>