文档中心>对象存储

GET VodPlaylist

最近更新时间:2020-12-15 11:40:48

我的收藏

功能描述

GET VodPlaylist 接口用于查询指定通道(Live Channel)在指定时间段推流生成的播放列表。COS 会查询请求参数中时间范围内由该 LiveChannel 推流生成的 ts 文件,拼接出一个临时的 m3u8播放列表,并将其内容直接返回给客户端。

请求

请求示例

GET /<ChannelName>?vod&starttime=StartTime&endtime=EndTime HTTP 1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: GMT date
Content-Length: Content Size
Content-Md5: Content MD5
Authorization: Auth String

说明
Authorization: Auth String (详情请参见 请求签名 文档)。

请求参数

名称
描述
类型
是否必选
ChannelName
指定 LiveChannel 名称,该 LiveChannel 必须存在
String
StartTime
指定查询 ts 文件的起始时间,格式为 Unix timestamp,单位:秒
String
EndTime
指定查询 ts 文件的终止时间,单位:秒。
注意:EndTime 必须大于 StartTime,且时间跨度不能大于1天
String

请求头

此接口仅使用公共请求头部,详情请参见 公共请求头部 文档。

请求体

该请求的请求体为空。

响应

响应头

此接口仅返回公共响应头部,详情请参见 公共响应头部 文档。

响应体

此接口响应体即为点播播放列表内容。

错误码

此接口遵循统一的错误响应和错误码,详情请参见 错误码 文档。

实际案例

请求

GET /test-channel-0?vod\\&starttime=1606523814\\&endtime=1606552614 HTTP 1.1
Host: examplebucket-1250000000.cos.ap-guangzhou.myqcloud.com
Date: GMT date
Content-Length:Content Size
Content-Md5:Content MD5
Authorization: Auth String


响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 0
Connection: keep-alive
Date: Wed, 23 Aug 2020 08:14:53 GMT
Server: tencent-cos
x-cos-request-id: NTk5ZDM5N2RfMjNiMjM1MGFfMmRiX2Y0****

#EXTM3U
#EXT-X-VERSION:3
#EXT-X-MEDIA-SEQUENCE:0
#EXT-X-TARGETDURATION:3
#EXTINF:3,
1606549744437_1_3000.ts
#EXTINF:3,
1606549747445_1_3000.ts
#EXTINF:3,
1606549750431_1_3000.ts
#EXTINF:3,
1606549753441_1_3000.ts
#EXTINF:3,
1606549756447_1_3000.ts
#EXTINF:3,
1606549759438_1_3000.ts
#EXTINF:3,
1606549762443_1_3000.ts
#EXTINF:0.947,
1606549763773_1_947.ts
#EXTINF:3,
1606551019369_1_3000.ts
#EXTINF:2.307,
1606551021973_1_2307.ts
#EXTINF:1.957,
1606551134831_1_1957.ts