GetLiveChannelInfo接口用于获取指定LiveChannel的配置信息。
请求语法
GET /ChannelName?live HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
请求头
此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。
响应头
此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)。
响应元素
名称 | 类型 | 示例值 | 描述 |
LiveChannelConfiguration | 容器 | 不涉及 | 保存GetLiveChannelInfo返回结果的容器。 子节点:Description、Status、Target 父节点:无 |
Description | 字符串 | test | LiveChannel的描述信息。 子节点:无 父节点:LiveChannelConfiguration |
Status | 枚举字符串 | enabled | LiveChannel的状态信息。 子节点:无 父节点:LiveChannelConfiguration 有效值:
|
Target | 容器 | 不涉及 | 保存LiveChannel转储配置的容器。 子节点:Type、FragDuration、FragCount、PlaylistName 说明 FragDuration、FragCount、PlaylistName只有当Type取值为HLS时才会返回。 父节点:LiveChannelConfiguration |
Type | 枚举字符串 | HLS | 当Type为HLS时,指定推流时转储文件类型。 子节点:无 父节点:Target 有效值:HLS |
FragDuration | 字符串 | 2 | 当Type为HLS时,指定每个ts文件的时长。 单位:秒 子节点:无 父节点:Target |
FragCount | 字符串 | 3 | 当Type为HLS时,指定m3u8文件中包含ts文件的个数。 子节点:无 父节点:Target |
PlaylistName | 字符串 | playlist.m3u8 | 当Type为HLS时,指定生成的m3u8文件的名称。 子节点:无 父节点:Target |
示例
请求示例
GET /test-channel?live HTTP/1.1
Date: Thu, 25 Aug 2016 05:52:40 GMT
Host: test-bucket.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************
返回示例
HTTP/1.1 200
content-length: 475
server: AliyunOSS
connection: close
x-oss-request-id: 57BE87A8B92475920B00****
date: Thu, 25 Aug 2016 05:52:40 GMT
content-type: application/xml
<?xml version="1.0" encoding="UTF-8"?>
<LiveChannelConfiguration>
<Description></Description>
<Status>enabled</Status>
<Target>
<Type>HLS</Type>
<FragDuration>2</FragDuration>
<FragCount>3</FragCount>
<PlaylistName>playlist.m3u8</PlaylistName>
</Target>
</LiveChannelConfiguration>