ListLiveChannel
ListLiveChannel接口用于列舉指定的LiveChannel。
請(qǐng)求語(yǔ)法
GET /?live HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
請(qǐng)求元素
名稱 | 類型 | 是否必選 | 描述 |
Marker | 字符串 | 否 | 設(shè)定結(jié)果從marker之后按字母排序的第一個(gè)開(kāi)始返回。 |
Max-keys | 字符串 | 否 | 限定此次返回LiveChannel的最大數(shù)。 取值:大于0小于等于1000 默認(rèn)值:100 |
Prefix | 字符串 | 否 | 限定返回的LiveChannel必須以prefix作為前綴。使用prefix查詢時(shí),返回的key中仍會(huì)包含prefix。 |
此接口還需要包含Host、Date等公共請(qǐng)求頭。更多信息,請(qǐng)參見(jiàn)公共請(qǐng)求頭(Common Request Headers)。
響應(yīng)元素
名稱 | 類型 | 描述 |
ListLiveChannelResult | 容器 | 保存ListLiveChannel請(qǐng)求結(jié)果的容器。 子節(jié)點(diǎn):Prefix、Marker、MaxKeys、IsTruncated、NextMarker、LiveChannel 父節(jié)點(diǎn):無(wú) |
Prefix | 字符串 | 本次查詢結(jié)果的開(kāi)始前綴。 子節(jié)點(diǎn):無(wú) 父節(jié)點(diǎn):ListLiveChannelResult |
Marker | 字符串 | 本次ListLiveChannel的起點(diǎn)。 子節(jié)點(diǎn):無(wú) 父節(jié)點(diǎn):ListLiveChannelResult |
MaxKeys | 字符串 | 響應(yīng)請(qǐng)求內(nèi)返回結(jié)果的最大數(shù)目。 子節(jié)點(diǎn):無(wú) 父節(jié)點(diǎn):ListLiveChannelResult |
IsTruncated | 字符串 | 是否已返回所有的結(jié)果。
子節(jié)點(diǎn):無(wú) 父節(jié)點(diǎn):ListLiveChannelResult |
NextMarker | 字符串 | 如果本次沒(méi)有返回全部結(jié)果,響應(yīng)請(qǐng)求中將包含NextMarker元素,用于標(biāo)明接下來(lái)請(qǐng)求的Marker值。 子節(jié)點(diǎn):無(wú) 父節(jié)點(diǎn):ListLiveChannelResult |
LiveChannel | 容器 | 保存返回每個(gè)LiveChannel信息的容器。 子節(jié)點(diǎn):Name、Description、Status、LastModified、PublishUrls、PlayUrls 父節(jié)點(diǎn):ListLiveChannelResult |
Name | 字符串 | LiveChannel的名稱。 子節(jié)點(diǎn):無(wú) 父節(jié)點(diǎn):LiveChannel |
Description | 字符串 | LiveChannel的描述信息。 子節(jié)點(diǎn):無(wú) 父節(jié)點(diǎn):LiveChannel |
Status | 枚舉字符串 | LiveChannel的狀態(tài)。 子節(jié)點(diǎn):無(wú) 父節(jié)點(diǎn):LiveChannel 有效值:
|
LastModified | 字符串 | LiveChannel配置的最后修改時(shí)間。 格式:ISO8601 子節(jié)點(diǎn):無(wú) 父節(jié)點(diǎn):LiveChannel |
PublishUrls | 容器 | 保存LiveChannel對(duì)應(yīng)的推流地址的容器。 子節(jié)點(diǎn):Url 父節(jié)點(diǎn):LiveChannel |
Url | 字符串 | LiveChannel對(duì)應(yīng)的推流地址。 子節(jié)點(diǎn):無(wú) 父節(jié)點(diǎn):PublishUrls |
PlayUrls | 容器 | 保存LiveChannel對(duì)應(yīng)的播放地址的容器。 子節(jié)點(diǎn):Url 父節(jié)點(diǎn):LiveChannel |
Url | 字符串 | LiveChannel對(duì)應(yīng)的播放地址。 子節(jié)點(diǎn):無(wú) 父節(jié)點(diǎn):PlayUrls |
此接口還包含ETag、x-oss-request-id等公共響應(yīng)頭。更多信息,請(qǐng)參見(jiàn)公共響應(yīng)頭(Common Response Headers)。
示例
請(qǐng)求示例
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 qn6q**************:77Dv****************
返回示例
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>