全部產品
Search
文件中心

:GetLiveChannelInfo

更新時間:Jun 19, 2024

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

有效值:

  • enabled:啟用狀態

  • disabled:禁用狀態

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>