帮你快速理解、总结文档立即下载
文档中心>对象存储>API 文档>数据处理接口>媒体处理>HLS 加密视频播放>更新 HLS 播放密钥

更新 HLS 播放密钥

最近更新时间：2025-08-11 17:23:13
我的收藏

本页目录：

功能描述

该接口用于更新 HLS 播放密钥。

授权说明

通过子账号使用时，需要在 授权策略 的 action 中添加 ci:UpdatePlayKey 权限。数据万象支持的所有操作接口请参见 CI action。

服务开通

使用该功能需提前 绑定存储桶，开通数据万象服务。
使用该功能需提前通过 控制台 或 接口 开通媒体处理服务 。
注意：
数据万象绑定后，如果您手动对存储桶进行数据万象的解绑操作，将无法继续使用该功能。

使用限制

使用该接口时，请先确认相关限制条件。详情请参见 使用限制。

请求

请求示例

PUT /playKey HTTP/1.1
Host: <BucketName-APPID>.ci.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
Content-Type: application/xml

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

请求头

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

请求参数

参数的具体内容如下：
节点名称（关键字）
父节点
描述
类型
是否必选
masterPlayKey
无
主播放密钥
长度限制：6～40字符
String
否（masterPlayKey 与 backupPlayKey 必须存在一个）
backupPlayKey
无
备播放密钥
长度限制：6～40字符
String
否

请求体

该请求的请求体为空。

响应

响应头

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

响应体

该响应体返回为 application/xml 数据，包含完整节点数据的内容展示如下：
<Response>
    <RequestId></RequestId>
    <PlayKeyList>
        <MasterPlayKey></MasterPlayKey>
        <BackupPlayKey></BackupPlayKey>
    </PlayKeyList>
</Response>
具体的数据内容如下：
节点名称（关键字）
父节点
描述
类型
Response
无
保存结果的容器
Container

Container 节点 Response 的内容
：
节点名称（关键字）
父节点
描述
类型
RequestId
Response
请求的唯一 ID
String
PlayKeyList
Response
保存播放密钥的容器
Container

Container 节点 PlayKeyList 的内容
：
节点名称（关键字）
父节点
描述
类型
MasterPlayKey
Response.PlayKeyList
主播放密钥
String
BackupPlayKey
Response.PlayKeyList
备播放密钥
String

错误码

该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

实际案例

请求

PUT /playKey?masterPlayKey=abdcfeafdavdaa&backupPlayKey=fqefefdavdaedfdsfva HTTP/1.1
Authorization: q-sign-algorithm=sha1&q-ak=************************************&q-sign-time=1497530202;1497610202&q-key-time=1497530202;1497610202&q-header-list=&q-url-param-list=&q-signature=****************************************
Host: test-1234567890.ci.ap-beijing.myqcloud.com
Content-Length: 0
Content-Type: application/xml


响应

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: 100
Connection: keep-alive
Date: Thu, 14 Jul 2022 12:37:29 GMT
Server: tencent-ci
x-ci-request-id: NTk0MjdmODlfMjQ4OGY3XzYzYzhf****

<Response>
    <RequestId>NjQ0NGNlNDZfMThhYTk0MGFfY*********</RequestId>
    <PlayKeyList>
        <MasterPlayKey>abdcfeafdavdaa</MasterPlayKey>
        <BackupPlayKey>fqefefdavdaedfdsfva</BackupPlayKey>
    </PlayKeyList>
</Response>

中国站