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>