GetLiveChannelInfo - Query LiveChannel configuration | OSS - Object Storage Service

Request structure

GET /ChannelName? live HTTP/1.1
Date: GMT date
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue

Request headers

This operation uses only common request headers. For more information, see Common request headers.

Response headers

This operation returns only common response headers. For more information, see Common response headers.

Response elements

Element	Type	Example	Description
LiveChannelConfiguration	Container	N/A	Container for GetLiveChannelInfo response data. Child nodes: Description, Status, and Target Parent node: none
Description	String	test	Description of the LiveChannel. Child node: none Parent node: LiveChannelConfiguration
Status	Enumerated string	enabled	Status of the LiveChannel. Child node: none Parent node: LiveChannelConfiguration Valid values: enabled: The LiveChannel is enabled. disabled: The LiveChannel is disabled.
Target	Container	N/A	Configuration for storing uploaded data in the LiveChannel. Child nodes: Type, FragDuration, FragCount, and PlaylistName Note FragDuration, FragCount, and PlaylistName are returned only when the value of Type is HLS. Parent node: LiveChannelConfiguration
Type	Enumerated string	HLS	Format for storing uploaded data. Child node: none Parent node: Target Valid value: HLS
FragDuration	String	2	Duration of each TS segment when Type is HLS. Unit: seconds Child node: none Parent node: Target
FragCount	String	3	Number of TS segments in the M3U8 playlist when Type is HLS. Child node: none Parent node: Target
PlaylistName	String	playlist.m3u8	Name of the generated M3U8 playlist when Type is HLS. Child node: none Parent node: Target

Examples

Sample request

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: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Sample response

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>