新建独立加密任务

功能介绍

支持独立加密，包括创建、查询、删除独立加密任务。

约束：

只支持转码后的文件进行加密。
加密的文件必须是m3u8或者mpd结尾的文件。

调试

您可以在API Explorer中调试该接口。

URI

POST /v1/{project_id}/encryptions

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取方法请参考获取项目ID

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	否	String	用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。
Authorization	否	String	使用AK/SK方式认证时必选，携带的鉴权信息。
X-Project_Id	否	String	使用AK/SK方式认证时必选，携带项目ID信息, 与路径参数中的项目ID相同。
X-Sdk-Date	否	String	使用AK/SK方式认证时必选，请求的发生时间。

表3 请求Body参数
参数	是否必选	参数类型	描述
input	否	ObsObjInfo object	输入存储位置
output	否	ObsObjInfo object	输出存储位置
encryption	否	Encryption object	加密信息
user_data	否	String	用户自定义数据。

表4 ObsObjInfo
参数	是否必选	参数类型	描述
bucket	是	String	OBS的bucket名称。
location	是	String	OBS桶所在的区域，且必须与使用的MPC区域保持一致。
object	是	String	OBS对象路径，遵守OSS Object定义。当用于指示input时,需要指定到具体对象。当用于指示output时, 只需指定到转码结果期望存放的路径。
file_name	否	String	文件名，仅用于转封装指定输出名称。当指定了此参数时，输出的对象名为object/file_name 。当不指定此参数时，输出的对象名为object/xxx，其中xxx由MPC指定。

表5 Encryption
参数	是否必选	参数类型	描述
hls_encrypt	否	HlsEncrypt object	视频加密控制参数。

表6 HlsEncrypt
参数	是否必选	参数类型	描述
key	是	String	内容加密秘钥
url	是	String	秘钥获取服务的地址
iv	否	String	初始向量，base64binary，随机数
algorithm	否	String	加密算法。 AES-128-CTR AES-128-CBC SM4CBC 默认值：AES-128-CTR

响应参数

状态码： 202

表7 响应Body参数
参数	参数类型	描述
task_id	String	加密任务Id

状态码： 400

表8 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误描述。

请求示例

POST https://{endpoint}/v1/{project_id}/encryptions
{
    "output": {
        "bucket": "obs-bucket06",
        "location": "region1",
        "object": "sswoutput"
    },
    "input": {
        "bucket": "vostest",
        "location": "region1",
        "object": "vos_video/hls/index.m3u8"
    },
    "encryption": {
        "hls_encrypt": {
            "iv": "kadGyMP9MbMkB1IfIKCNaA==",
            "key": "NqdGyMP9MbMiB1IfIKCNeQ==",
            "url": "xxxxxxx",
            "algorithm": "AES-128-CBC"
        },
        "preview_duration": 2,
        "multidrm": {
            "emi": 16420,
            "content_id": "jjJr6K",
            "streaming_mode": "HLS",
            "drm_list": [
                "PLAYREADY"
            ],
            "encrypt_audio": 0
        }
    }
}

响应示例

状态码： 202

新建独立加密任务成功。

{
  "task_id" : 100211
}

状态码： 400

新建独立加密任务失败。

{
  "error_code" : "MPC.10202",
  "error_msg" : "Invalid request parameter"
}

状态码

状态码	描述
202	新建独立加密任务成功。
400	新建独立加密任务失败。

错误码

请参见错误码。

父主题： 独立加密接口

新建独立加密任务

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

相关产品

意见反馈

文档内容是否对您有帮助？

售前咨询热线