功能描述
GetPrivateM3U8 接口用于获取私有 M3U8 ts 资源的下载授权。(此方式通过对象存储转发请求至数据万象)。
授权说明
服务开通
使用该功能需提前开通数据万象,并绑定存储桶。详情请参见 绑定存储桶。
使用该功能需提前通过控制台或接口开通媒体处理服务 。详情请参见 开通媒体处理服务。
使用限制
费用说明
请求
请求示例
GET /<ObjectKey>?ci-process=pm3u8&expires= HTTP/1.1Host: <BucketName-APPID>.cos.<Region>.myqcloud.comDate: <GMT Date>Authorization: <Auth String>Content-Length: <length>
请求参数
参数的具体内容如下:
参数名称 | 描述 | 类型 | 是否必选 |
ci-process | 操作类型,固定使用 pm3u8 | String | 是 |
expires | 私有 ts 资源 url 下载凭证的相对有效期,单位为秒,范围为[3600,43200] | String | 是 |
请求头
请求体
该请求无请求体。
响应
响应头
响应体
该响应体为 m3u8 的内容,其中的 ts 为可下载的链接。
错误码
实际案例
请求
GET /for-test.pm3u8?ci-process=pm3u8&expires=3600 HTTP/1.1Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.comDate: Fri, 10 Mar 2016 09:45:46 GMTAuthorization: q-sign-algorithm=sha1&q-ak=AKIDWtTCBYjM5OwLB9CAwA1Qb2ThTSUjfG****-sign-time=1484213027;32557109027&q-key-time=1484213027;32557109027&q-header-list=host&q-url-param-list=acl&q-signature=dcc1eb2022b79cb2a780bf062d3a40e120b4****Content-Length: 0
响应
HTTP/1.1 200 OKContent-Type: application/x-mpegURLContent-Length: 266005Connection: keep-aliveDate: Fri, 10 Mar 2016 09:45:46 GMTServer: tencent-cix-cos-request-id: NTg3NzRiMjVfYmRjMzVfMTViMl82ZGZm****#EXTM3U#EXT-X-VERSION:3#EXT-X-TARGETDURATION:11#EXT-X-MEDIA-SEQUENCE:0#EXT-X-KEY:METHOD=AES-128,URI="http://website.com/aes.key?Ciphertext=xxxxx&KMSRegion=ap-guangzhou",IV=0x00000000000000000000000000000000#EXTINF:11.333333,test-00000.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=#EXTINF:9.416667,test-00001.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=#EXTINF:9.375000,test-00002.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=#EXTINF:11.291667,test-00003.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=#EXTINF:3.500000,test-00004.ts?q-sign-algorithm=sha1&q-ak=&q-sign-time=&q-key-time=&q-header-list=host&q-url-param-list=&q-signature=&x-cos-security-token=#EXT-X-ENDLIST