华为云用户手册

请求示例 创建视频解析任务，解析视频元数据。 POST https://{endpoint}/v1/{project_id}/extract-metadata { "input" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-path/input.flv" }, "output" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-path/output" }, "sync" : 0 }

响应参数 状态码：200 表7 响应Body参数 参数 参数类型 描述 task_id String 任务ID status String 任务状态 create_time String 任务创建时间 output ObsObjInfo object 输出文件信息 output_file_name String 解析文件名称 description String 任务描述，如当任务异常时，此字段为异常的具体信息 metadata MetaData object 视频文件元数据 表8 ObsObjInfo 参数 参数类型 描述 bucket String OBS的bucket名称。 location String OBS桶所在的区域，且必须与使用的MPC区域保持一致。 object String OBS对象路径，遵守OSS Object定义。 当用于指示input时，需要指定到具体对象。 当用于指示output时，只需指定到转码结果期望存放的路径。 在字幕场景下，字幕文件名称中禁止携带特殊符号，否则会导致转码任务失败，如：[ 正确示例: demo.srt 错误示例: [demo.srt file_name String 文件名，文件名长度不能超过180个字符。 当指定了此参数时，输出的对象名为object/file_name。 当不指定此参数时，输出的对象名为object/xxx，其中xxx由MPC指定。 在作为输出文件名时： 在转封装场景有效，需要指定输出文件名称 在转码场景下，如果需要指定输出的文件名称，请使用output_filenames参数 在解析场景有效，解析场景如果指定文件名，则将解析参数写入指定文件名，通过查询接口响应json数据获取文件元数据信息 在截图场景无效 在转动图场景无效 输出文件为HLS格式时，文件名称不能命名为index，示例：index.m3u8，否则会导致播放失败。 表9 MetaData 参数 参数类型 描述 size Long 文件大小。 单位：byte。 duration_ms Double 视频时长，带小数位显示。 单位：秒。 duration Long 视频时长。 单位：秒。 format String 文件封装格式。 md5 String 视频的 md5 值。 bitrate Long 总码率。 单位：bit/秒 video Array of VideoInfo objects 视频流元数据。 audio Array of AudioInfo objects 音频流元数据。 表10 VideoInfo 参数 参数类型 描述 width Integer 视频宽度 height Integer 视频高度 bitrate Integer 视频码率。 单位: kbit/s 说明： 视频解析接口2024年8月7日做了如下变更： 变更前：视频解析任务，如果为同步解析，即sync参数配置为1时，解析响应VideoInfo中的参数bitrate单位实际为bit/s。 变更后：视频解析任务同步解析响应VideoInfo中的参数bitrate单位变更为kbit/s。 上述更新，可能会影响历史用户的转码业务判断，请关注并及时调整业务。 bitrate_bps Long 视频码率。 单位: bit/s frame_rate Integer 帧率。 取值范围：0或[5,60]，0表示自适应。 单位：帧每秒。 说明： 若设置的帧率不在取值范围内，则自动调整为0，若设置的帧率高于片源帧率，则自动调整为片源帧率。 codec String 视频编码格式 duration String 视频流时长，单位：秒 duration_ms String 视频流时长，单位：毫秒 rotate Float 视频拍摄时的选择角度，单位：度。 表11 AudioInfo 参数 参数类型 描述 codec String 音频编码格式 sample Integer 音频采样率 channels Integer 音频信道 bitrate Integer 音频码率。 单位: kbit/s bitrate_bps Long 音频码率。 单位: bit/s duration String 音频流时长，单位：秒 duration_ms String 音频流时长，单位：毫秒 状态码：400 表12 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表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 源文件信息。 说明： 在转动图、同步解析、同步截图等场景，暂不支持m3u8格式的视频。 output 否 ObsObjInfo object 输出文件信息。 user_data 否 String 用户自定义数据。 sync 否 Integer 是否同步处理, 0：排队处理 1：同步处理 默认值：0 encryption 否 Encryption object 视频加密控制参数。 表4 ObsObjInfo 参数 是否必选 参数类型 描述 bucket 是 String OBS的bucket名称。 location 是 String OBS桶所在的区域，且必须与使用的MPC区域保持一致。 object 是 String OBS对象路径，遵守OSS Object定义。 当用于指示input时，需要指定到具体对象。 当用于指示output时，只需指定到转码结果期望存放的路径。 在字幕场景下，字幕文件名称中禁止携带特殊符号，否则会导致转码任务失败，如：[ 正确示例: demo.srt 错误示例: [demo.srt file_name 否 String 文件名，文件名长度不能超过180个字符。 当指定了此参数时，输出的对象名为object/file_name。 当不指定此参数时，输出的对象名为object/xxx，其中xxx由MPC指定。 在作为输出文件名时： 在转封装场景有效，需要指定输出文件名称 在转码场景下，如果需要指定输出的文件名称，请使用output_filenames参数 在解析场景有效，解析场景如果指定文件名，则将解析参数写入指定文件名，通过查询接口响应json数据获取文件元数据信息 在截图场景无效 在转动图场景无效 输出文件为HLS格式时，文件名称不能命名为index，示例：index.m3u8，否则会导致播放失败。 表5 Encryption 参数 是否必选 参数类型 描述 hls_encrypt 否 HlsEncrypt object 视频加密控制参数。 表6 HlsEncrypt 参数 是否必选 参数类型 描述 key 是 String 使用base64编码的内容加密密钥 url 是 String 密钥获取服务的地址，用于播放hls分片时解密使用。 iv 否 String 初始向量，base64binary，随机数 algorithm 否 String 加密算法。 AES-128-CTR AES-128-CBC 默认值：AES-128-CTR

请求参数 表3 请求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方式认证时必选，请求的发生时间。

操作步骤 获取用户Token，用于MPC接口调用时的认证鉴权。 在“我的凭证”页面获取username、password、domainname、projectname，调用如下接口 获取Token 。详细信息请参见构造请求。 POST https://iam.cn-north-4.myhuaweicloud.com/v3/auth/tokens Content-Type: application/json { "auth": { "identity": { "methods": [ "password" ], "password": { "user": { "name": "********", //用户名。 "password": "********", //用户登录密码。 "domain": { "name": "domainname" //用户所属的账号名称。 } } } }, "scope": { "project": { "name": "*******" //项目名称。 } } } } 如图1所示，红框中的信息为获取用户Token。 图1 获取用户Token 创建视频转码模板，获取转码模板ID，具体API调用方法请参见示例1：新建转码模板。 创建水印模板。 选择POST请求方法并输入URI。 https://{endpoint}/v1/{project_id}/template/watermark 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。 Request Body中传入参数如下： { "template_name": "watermark_1920*1080_10*10_ BottomLeft", "type": "Image", "image_process": "Grayed", "width": "1920", "height": "1080", "dx": "10", "dy": "10", "referpos": "BottomLeft", "timeline_start": "6", "timeline_duration": "8" } 请求响应成功后，返回水印模板ID。 { "template_id":242 } 提交视频转码任务。 选择POST请求方法并输入URI。 https://{endpoint}/v1/{project_id}/transcodings 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。 Request Body中传入参数如下： { "input": { "bucket": "example-bucket", "location": "region01", "object": "/mpc/input/sample.MP4" }, "output": { "bucket": "example-bucket", "location": "region01", "object": "/mpc/output/" }, "trans_template_id":[1002], "watermarks": [{ "input": { "bucket": "example-bucket", "location": "region01", "object": "meipai.jpg" }, "template_id":242 }], "priority":"9", "audit":{ "position":2, "index":2 } } 请求响应成功后，返回转码任务ID。 { "task_id":100211 } 查询视频转码执行情况。 选择GET请求方法并输入URI。 https://{endpoint}/v1/{project_id}/transcodings?task_id=100211 请求消息头中增加“X-Auth-Token”，值设置为步骤1中获取的用户Token。 请求响应成功后，返回视频转码的详细信息。

基本概念 账号 用户注册时的账号，账号对其所拥有的资源及云服务具有完全的访问权限，可以重置用户密码、分配用户权限等。由于账号是付费主体，为了确保账号安全，建议您不要直接使用账号进行日常管理工作，而是创建用户并使用创建的用户进行日常管理工作。 用户 由账号在IAM中创建的用户，是云服务的使用人员，具有身份凭证（密码和访问密钥）。 在我的凭证下，您可以查看账号ID和用户ID。通常在调用API的鉴权过程中，您需要用到账号、用户和密码等信息。 区域 指云资源所在的物理位置，同一区域内可用区间内网互通，不同区域间内网不互通。通过在不同地区创建云资源，可以将应用程序设计的更接近特定客户的要求，或满足不同地区的法律或其他要求。 可用区 一个可用区是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 项目 区域默认对应一个项目，这个项目由系统预置，用来隔离物理区域间的资源（计算资源、存储资源和网络资源），以默认项目为单位进行授权，用户可以访问您账号中该区域的所有资源。如果您希望进行更加精细的权限控制，可以在区域默认的项目中创建子项目，并在子项目中购买资源，然后以子项目为单位进行授权，使得用户仅能访问特定子项目中资源，使得资源的权限控制更加精确。 图1 项目隔离模型

约束与限制 媒体处理 服务设置了API流量控制，避免因短时间内重复调用API导致服务中断的情况出现。 目前转码的流控限制规则如下： 单租户接口流控：100次/分钟。 接口总体流控：1000次/分钟。 调用IAM接口的区域需与调用媒体处理接口的区域一致，如调用“cn-north-4”区域的IAM接口获取用户Token，则该Token仅能用于调用“cn-north-4”区域媒体处理接口的鉴权。 不支持处理跨区域的媒资文件，如使用“华北-北京一”的媒体处理服务不能处理存储在“华北-北京四”OBS桶中的视频文件。 在请求参数中填写Integer数据类型时，使用小数，只有小数点之前的数字有效。 更详细的限制请参见具体API的说明。

请求参数 表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参数 参数 是否必选 参数类型 描述 task_id 否 String 任务ID。

请求参数 表3 请求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方式认证时必选，请求的发生时间。

错误码 当您调用API时，如果遇到“APIGW”开头的错误码，请参见API网关错误码进行处理。 状态码 错误码 错误信息 描述 处理措施 400 MPC.10089 The template file does not exist. 模板文件不存在 模板文件不存在，请检查 400 MPC.10090 The template file does not exist. 模板文件不存在 模板文件不存在，请检查 400 MPC.10091 The template name already exists. 模板名字重复 模板名字重复，请检查 400 MPC.10155 The subtitle file list and M3U8 file do not contain the specified default language. 字幕文件列表和M3U8文件中均不存在指定默认语言 字幕文件列表和M3U8文件中均不存在指定默认语言 400 MPC.10156 File deletion failed. 文件删除失败 文件删除失败 400 MPC.10202 Invalid request parameter. MPC 请求参数非法 请检查参数是否正确 400 MPC.10204 Incorrect request method. MPC 请求方式不正确 请检查请求方式 400 MPC.10205 Incorrect request content type. MPC 请求内容类型不正确 请检查请求内容类型 400 MPC.10223 An agency has been created. 委托授权已创建 委托授权已创建，请检查 400 MPC.10224 The agency has been deleted. 委托授权已被删除 委托授权已被删除，请检查 400 MPC.10230 The template group already exists. 模板组已存在 模板组已存在，请检查 400 MPC.10231 The template group does not exist. 模板组不存在 模板组不存在，请检查 401 MPC.10203 Identity authentication failed. MPC 认证失败 请检查Token等认证参数是否正确 401 MPC.10206 You have not completed real-name authentication. MPC 用户未实名认证 请检查用户是否实名认证 401 MPC.10207 Your account is in an abnormal state. MPC 用户处于异常状态 请检查用户状态是否正确 401 MPC.10208 Tenant ID verification failed, please check. MPC 租户ID校验失败 请检查租户ID是否正确 403 MPC.10211 The task does not exist. 任务不存在 转码任务不存在，请检查 403 MPC.10212 Operation failed. The task is in progress or has been completed. MPC 操作失败，任务处理中或已经处理完成 任务处理中或已经处理完成，请检查 403 MPC.10214 The topic does not exist. MPC 主题不存在 主题不存在，请检查 403 MPC.10215 The topic already exists. MPC 主题已经存在 主题已经存在，请检查 403 MPC.10226 The resource does not exist. 资源不存在 资源不存在，请检查 403 MPC.10240 Failed to obtain the basic information about the media file. 获取媒体文件基本信息失败。 请检查是否已授权桶，且obs桶未配置kms加密。 403 MPC.10243 Due to security reasons, your account has been restricted from purchasing certain pay-per-use cloud service resources according to the CLOUD Customer Agreement. If you have any questions, contact customer service. 您的账号可能存在风险，已根据《云用户协议》限制您购买部分按需计费的云服务资源。如有疑问，请联系客服咨询处理。 您的账号可能存在风险，已根据《云用户协议》限制您购买部分按需计费的云服务资源。如有疑问，请联系客服咨询处理。 403 MPC.10244 Insufficient account balance. Top up your account. 您的账户余额不足，无法开通资源，请立即充值。 您的账户余额不足，无法开通资源，请立即充值。 406 MPC.10051 The selected template is a super-resolution template and is not supported. 所选模板为超分辨率模板，暂不支持 请检查转码模板是否正确 406 MPC.10052 Failed to obtain the input file. 无法获取源文件，请检查路径 无法获取源文件，请检查路径 406 MPC.10053 The input file does not exist. 源文件不存在 源文件不存在，请检查 406 MPC.10054 Failed to obtain the subtitle file. 无法获取字幕文件 无法获取字幕文件，请检查路径 406 MPC.10055 The audio sampling rate 7,350 is not supported. 输出音频AAC时，不支持采样率为7350，请修改 不支持采样率为7350，请修改 406 MPC.10056 This type of output frame rate is not supported. 不支持该类输出帧率 不支持该类输出帧率，请修改 406 MPC.10057 This type of output bitrate is not supported. 不支持该类输出视码率 不支持该类输出视码率，请修改 406 MPC.10058 This type of output video width is not supported. 不支持该类输出视频宽度 不支持该类输出视频宽度，请修改 406 MPC.10059 This type of output video height is not supported. 不支持该类输出视频高度 不支持该类输出视频高度，请修改 406 MPC.10060 This type of I-frame interval is not supported. 不支持该类输出视频I帧间隔 不支持该类输出视频I帧间隔，请修改 406 MPC.10061 Capturing snapshots at non-fixed intervals is not supported. 不支持非固定时间间隔截图，请修改为固定时间间隔截图 请修改为固定时间间隔截图 406 MPC.10062 Invalid video codec. 截图场景下视频codec错误 截图场景下视频codec错误，请修改 406 MPC.10063 Invalid video format. 截图场景下视频format错误 截图场景下视频format错误，请修改 406 MPC.10064 Multiple watermarks are not supported. 不支持水印多路输入，目前仅支持2路输入 不支持水印多路输入，目前仅支持2路输入，请修改 406 MPC.10065 Invalid output file format. 不支持该类输出文件格式 不支持该类输出文件格式，请检查 406 MPC.10066 The input file format does not match the actual format. 输入文件格式与实际格式不符，请检查 输入文件格式与实际格式不符，请检查 406 MPC.10067 Failed to obtain the ID of the video codec. 获取视频CODEC ID 失败 获取视频CODEC ID 失败，请检查 406 MPC.10068 Failed to obtain the ID of the audio codec. 获取音频CODEC ID 失败 获取音频CODEC ID 失败，请检查 406 MPC.10069 Failed to obtain the ID of the subtitle codec. 获取字幕CODEC ID 失败 获取字幕CODEC ID 失败，请检查 406 MPC.10070 Failed to obtain the encoding/decoding format. 获取编解码格式失败 获取编解码格式失败，请检查 406 MPC.10071 Failed to obtain the parameters of the input video stream. 无法获取输入视频流的相关参数信息 无法获取输入视频流的相关参数信息，请检查 406 MPC.10072 Invalid frame rate of the video stream. 视频流帧率信息错误 视频流帧率信息错误，请检查 406 MPC.10080 Invalid frame rate of the input file. 输入文件视频帧率错误 输入文件视频帧率错误，请检查 406 MPC.10081 The file does not contain audio streams. 文件缺失音频流，请检查输入文件 文件缺失音频流，请检查输入文件 406 MPC.10082 Failed to obtain the input audio or video stream. 无法获取输入视频流（音频或视频），请自检 无法获取输入视频流（音频或视频），请检查 406 MPC.10083 This type of codec is not supported. 不支持该类编码类型 不支持该类编码类型，请检查 406 MPC.10084 This chroma subsampling format is not supported. 不支持此种色度采样格式 不支持此种色度采样格式，请检查 406 MPC.10085 The file format is not supported. 文件格式不支持 文件格式不支持，请检查 406 MPC.10086 Failed to obtain the input file. 无法获取源文件，请检查路径 无法获取源文件，请检查路径 406 MPC.10087 Invalid task parameters. 查询任务参数错误 查询任务参数错误，请检查 406 MPC.10088 The image file does not exist. 图片文件不存在 图片文件不存在，请检查 406 MPC.10092 The image file does not exist. 图片文件不存在 图片文件不存在，请检查 406 MPC.10093 The file name exceeds the maximum length. 文件名过长 文件名过长，请检查 406 MPC.10094 Invalid file format. 文件格式异常 文件格式异常，请检查 406 MPC.10095 The watermark is placed in a wrong position. 水印的位置错误 水印的位置错误，请检查 406 MPC.10096 Invalid watermark size. 水印的大小错误 水印的大小错误，请检查 406 MPC.10097 Invalid watermark scaling ratio. 水印缩放比例错误 水印缩放比例错误，请检查 406 MPC.10098 Invalid watermark duration. 水印持续时长错误 水印持续时长错误，请检查 406 MPC.10099 The media stream type is not supported. 不支持的媒体流类型 不支持的媒体流类型，请检查 406 MPC.10100 An error occurred when parsing the video frame rate information. 解析视频帧率信息错误 解析视频帧率信息错误，请检查 406 MPC.10101 Invalid input parameters. 输入参数错误 输入参数错误，请检查 406 MPC.10102 Failed to open the input file. 源文件打开异常，请检查 源文件打开异常，请检查 406 MPC.10103 Open GOP is not supported. 不支持OPEN GOP素材 不支持OPEN GOP素材，请检查 406 MPC.10104 Internal error. 服务内部异常，请重试或联系工程师 服务内部异常，请重试或联系工程师 406 MPC.10105 An error occurred during transcoding. 转码进程异常 转码进程异常，请重试或联系工程师 406 MPC.10106 The audio sampling rate is lower than 12,000. The audio will be discarded. 音频采样率低于12000，音频被丢弃 音频采样率低于12000，音频被丢弃 406 MPC.10107 Invalid input video resolution. 原始视频分辨率错误 原始视频分辨率错误 406 MPC.10108 The audio sampling rate of the input video is incorrect. 原始视频的音频采样率错误 原始视频的音频采样率错误 406 MPC.10109 Invalid resolution in the template. 模板分辨率错误 模板分辨率错误 406 MPC.10110 The video encoding format of the input file is not supported. 片源视频编码格式特殊，暂不不支持 片源视频编码格式特殊，暂不不支持 406 MPC.10111 Failed to obtain the file from OBS. 获取obs文件失败 获取obs文件失败 406 MPC.10112 The video or audio format of the input file is not supported. 片源的视频或音频格式不支持 片源的视频或音频格式不支持 406 MPC.10113 The DTS of the input file is not supported. 片源的dts异常，暂不支持 片源的dts异常，暂不支持 406 MPC.10114 The header information of the input file is incorrect. 片源文件头信息有误，请检查 片源文件头信息有误，请检查 406 MPC.10115 The watermark cannot be scaled down by more than 256 times. 水印图片缩小倍数超过256倍,暂不支持 水印图片缩小倍数超过256倍,暂不支持 406 MPC.10116 The audio encoding format of the input file is not supported. 片源的音频编码格式，暂不支持 片源的音频编码格式，暂不支持 406 MPC.10117 The audio and video in the input file are not synchronized. 片源的音频和视频不同步 片源的音频和视频不同步 406 MPC.10118 Failed to upload files to the OBS path. 上传文件到obs失败 上传文件到obs失败，请重试或联系工程师 406 MPC.10119 Invalid input data. 片源数据无效 片源数据无效，请检查 406 MPC.10120 The task does not exist. 任务不存在 任务不存在，请检查 406 MPC.10121 The subtitle file does not exist. 字幕文件不存在，请检查 字幕文件不存在，请检查 406 MPC.10122 The resolution in the template is greater than the input video resolution. 模板分辨率大于原视频分辨率 模板分辨率大于原视频分辨率，请检查 406 MPC.10123 The header information of the input file is incorrect. 片源文件头信息有误，请检查 片源文件头信息有误，请检查 406 MPC.10124 Some data in the input file are missing. 片源部分数据缺失，请检查片源是否可以完整 片源部分数据缺失，请检查片源是否可以完整 406 MPC.10125 Input data error. 片源数据问题，请检查片源能否播放 片源数据问题，请检查片源能否播放 406 MPC.10126 Input data error. 片源数据问题，请检查片源能否播放 片源数据问题，请检查片源能否播放 406 MPC.10127 Failed to obtain the level-1 m3u8 when an HLS media file is encrypted with DRM. DRM加密，HLS格式获取一级m3u8失败 DRM加密，HLS格式获取一级m3u8失败，请检查 406 MPC.10128 Failed to obtain the level-2 m3u8 when an HLS media file is encrypted with DRM. DRM加密，HLS格式获取二级m3u8失败 DRM加密，HLS格式获取二级m3u8失败，请检查 406 MPC.10129 Failed to obtain the index file when a DASH media file is encrypted with DRM. DRM加密，DASH格式获取索引文件失败 DRM加密，DASH格式获取索引文件失败，请检查 406 MPC.10130 The HLS content fails to be encrypted using DRM. DRM加密，HLS格式加密失败 DRM加密，HLS格式加密失败，请检查 406 MPC.10131 Failed to modify the index file when an HLS media file is encrypted with DRM. DRM加密，HLS格式更新索引文件失败 DRM加密，HLS格式更新索引文件失败，请检查 406 MPC.10132 Failed to obtain the IV during DRM encryption. DRM加密,DASH获取iv失败 DRM加密,DASH获取iv失败，请检查 406 MPC.10133 The DASH content fails to be encrypted using DRM. DRM加密,DASH格式加密失败 DRM加密,DASH格式加密失败，请检查 406 MPC.10134 Failed to modify the index file when a DASH media file is encrypted with DRM. DRM加密,DASH格式更新索引文件失败 DRM加密,DASH格式更新索引文件失败，请检查 406 MPC.10135 Failed to package the digital watermark due to the incorrect xformat configuration. 数字水印转封装失败，配置xformat的错误 数字水印转封装失败，配置xformat的错误，请检查 406 MPC.10136 Failed to package the digital watermark because xformat fails to be started. 数字水印转封装失败，启动xformat失败 数字水印转封装失败，启动xformat失败，请检查 406 MPC.10137 Failed to package the digital watermark because xformat fails to create a task. 数字水印转封装失败，xformat创建task失败 数字水印转封装失败，xformat创建task失败，请检查 406 MPC.10138 Failed to package the digital watermark because xformat fails to query the task. 数字水印转封装失败，xformat查询任务失败 数字水印转封装失败，xformat查询任务失败，请检查 406 MPC.10139 Failed to package the digital watermark because the xformat task timed out. 数字水印转封装失败，xformat任务超时 数字水印转封装失败，xformat任务超时，请重试或联系工程师 406 MPC.10140 The I-frame interval exceeds 500. 输出i帧间隔超过500，暂不支持 输出i帧间隔超过500，暂不支持，请修改 406 MPC.10141 The input file is an audio file. The selected template contains video parameters. 片源为纯音频文件，选择模板包含视频参数，暂不支持 片源为纯音频文件，选择模板包含视频参数，请检查 406 MPC.10143 Invalid index file content. 输入的索引文件内容非法 输入的索引文件内容非法 406 MPC.10144 Black bars seem to be on the input video. 无法确定片源黑边的具体位置, 片源的四周疑似有黑边, 需要对片源进行人工审核 无法确定片源黑边的具体位置, 片源的四周疑似有黑边, 需要对片源进行人工审核 406 MPC.10145 Data frames imported to the detection module seem to be not enough for identifying the specific position of the black bar. 无法确定片源黑边的具体位置，疑似没有足够的数据帧输入至黑边检测模块，需要对片源进行人工审核 无法确定片源黑边的具体位置， 疑似没有足够的数据帧输入至黑边检测模块，需要对片源进行人工审核 406 MPC.10146 The black bar seems to overlap with subtitles. 无法确定片源黑边的具体位置，疑似片源的下黑边和字幕存在重叠，需要对片源进行人工审核 无法确定片源黑边的具体位置，疑似片源的下黑边和字幕存在重叠，需要对片源进行人工审核 406 MPC.10147 The black bar seems to overlap with the watermark. 无法确定片源黑边的具体位置，疑似片源的上黑边和水印存在重叠，需要对片源进行人工审核 无法确定片源黑边的具体位置，疑似片源的上黑边和水印存在重叠，需要对片源进行人工审核 406 MPC.10148 The black bars seem to be asymmetric. 无法确定片源黑边的具体位置，疑似片源的左右黑边不对称，需要对片源进行人工审核 无法确定片源黑边的具体位置，疑似片源的左右黑边不对称，需要对片源进行人工审核 406 MPC.10149 The specific position of the black bar cannot be identified. 无法确定片源黑边的具体位置, 需要对片源进行人工审核 无法确定片源黑边的具体位置, 需要对片源进行人工审核 406 MPC.10150 The cropped black bar size exceeds the input video size. 强制黑边裁剪值超出原视频大小, 请人工审核 强制黑边裁剪值超出原视频大小, 请人工审核 406 MPC.10151 Failed to download the subtitle file in the slicing phase. 切片阶段下载字幕文件失败 切片阶段下载字幕文件失败，请检查 406 MPC.10152 The video encoding format of the input file is not supported. 片源视频编码格式特殊，暂不不支持 片源视频编码格式特殊，暂不不支持 406 MPC.10153 Input file error. 片源问题，请确认片源是否能完整播放 片源问题，请确认片源是否能完整播放 406 MPC.10154 Failed to open the input file. 输入文件无法打开，请检查输入片源是否能播放 输入文件无法打开，请检查输入片源是否能播放 406 MPC.10200 System error. MPC 服务异常，通用状态码 请联系工程师解决 406 MPC.10201 Internal communication error. 服务内部通信异常 请联系工程师解决 406 MPC.10209 Invalid input or output OBS path. MPC 对象存储源地址或者目的地址不正确 请检查对象存储源地址或者目的地址 406 MPC.10210 Failed to obtain the input file from OBS. MPC 获取对象存储源文件失败 对象存储源文件获取失败，请检查 406 MPC.10213 Operation failed. The task is not in the final state. MPC 操作失败，任务未进入终态 任务未进入终态，请检查 406 MPC.10216 Failed to set event notifications. You do not have the permission to publish messages to the topic. MPC 设置 消息通知 失败，无权限发布消息到主题 设置消息通知失败，无权限发布消息到主题，请检查 406 MPC.10217 The usage exceeds the OBT quota. MPC 公测限额，用量超过阈值 用量超过阈值，请检查 406 MPC.10218 The task has completed. MPC 任务处理成功 任务处理成功，请检查 406 MPC.10219 Invalid request parameter. 请求参数非法 请求参数非法，请检查 406 MPC.10220 The task has expired. MPC 任务已过期 任务已过期，请检查 406 MPC.10221 Internal service error. 内部服务异常 请检查模板并重试 406 MPC.10222 Key parameters in the template are inconsistent. 自定义模板参数错误 对象存储源文件获取错误，请检查 406 MPC.10225 KMS service error. HW_KMS 服务处理异常 请联系工程师解决 406 MPC.10227 You do not have the permission to access the requested resource. 没有权限访问 没有权限访问，请检查 406 MPC.10228 Your account is in arrears. Top up your account. 用户已冻结，请尽快充值 用户已冻结，请尽快充值 406 MPC.10229 You do not have the permission to perform this operation. 无角色权限执行该的操作 无角色权限执行该的操作，请检查 406 MPC.10232 GIF task failed. gif任务失败 gif任务失败，请检查 406 MPC.10233 Packaging task failed. 转封装任务失败 转封装任务失败，请检查 406 MPC.10234 The function is temporarily brought offline. 功能下线 功能下线，请检查 406 MPC.10235 Identity authentication failed due to an invalid token. 请求Token为Domain级别，Token无效 请检查Token是否正确 406 MPC.10236 You do not have permission to access the OBS bucket. 账号桶操作无权限 请联系租户管理员进行桶授权或者租户管理员给子账号赋予OBS权限 406 MPC.10237 API Gateway rate limiting APIGW 流控 服务APIGW流控，请检查 500 MPC.10001 IAM service exception. IAM 服务处理异常 请联系工程师解决 500 MPC.10002 OBS service exception. OBS 服务处理异常 请联系工程师解决 500 MPC.10003 SMN service exception. SMN 服务处理异常 请联系工程师解决 500 MPC.10004 CBC service exception. CBC 服务处理异常 请联系工程师解决 500 MPC.10005 SDR service exception. SDR 服务处理异常 请联系工程师解决 500 MPC.10006 ZK service exception. ZK 服务处理异常 请联系工程师解决 500 MPC.10007 MONGO service exception. MONGO 服务处理异常 请联系工程师解决 500 MPC.10008 MPE service exception. MPE处理错误 请联系工程师解决 500 MPC.10050 XCODE service exception. XCODE 服务处理异常 请联系工程师解决 父主题： 附录

请求示例 更新转码模板组。 PUT https://{endpoint}/v1/{project_id}/template_group/transcodings { "group_id" : "bd55741ccdf04e678f800c010aa12b68", "name" : "test_group", "videos" : [ { "width" : 480, "height" : 270, "bitrate" : 200 }, { "width" : "1280", "height" : "720", "bitrate" : "700" } ], "audio" : { "codec" : 1, "sample_rate" : 1, "channels" : 2, "bitrate" : 0 }, "video_common" : { "codec" : 1, "black_cut" : 0, "profile" : 3, "level" : 15, "preset" : 3, "max_iframes_interval" : 5, "bframes_count" : 4, "frame_rate" : 0 }, "common" : { "PVC" : false, "pack_type" : 1, "hls_interval" : 5, "dash_interval" : 5 } }

请求参数 表3 请求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方式认证时必选，请求的发生时间。

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 is_open 否 Boolean 是否已开通服务 false：未开通 true：已开通 agreement_version 否 Integer 服务协议版本

修订记录 表1 修订记录 发布日期 修订记录 2023-05-04 第三十一次正式发布 本次变更如下： 修改新建转码模板组接口示例代码。 2023-02-02 第三十次正式发布 本次变更如下： 删除新建转码任务接口中的“asset_id”和“dynamic_range”参数。 新建转动图任务接口中增加源文件格式说明，在转动图、同步解析和同步截图场景下，暂不支持m3u8格式的视频。 2023-01-03 第二十九次正式发布 本次变更如下： 修改新建转码任务接口中的“language”参数。 修改新建转码任务、查询转码任务、新建转码模板、更新转码模板、查询转码模板、新建转码模板组、更新转码模板组和查询转码模板组接口中的“level”和“channels”参数。 2022-12-09 第二十八次正式发布 本次变更如下： 删除新建转码模板、更新转码模板和查询转码模板接口中的“black_cut”参数。 删除新建转码模板组、更新转码模板组和查询转码模板组接口中的“ref_frames_count”和“aspect_ratio”参数。 删除新建转码任务接口中的“audio_track”、“multi_audio”和“video_process”参数。 2022-11-30 第二十七次正式发布 本次变更如下： 媒资转码接口组新增删除转码任务记录、查询点播概览信息接口。 转封装接口组新增删除转封装任务记录接口。 新增授权与配置接口组。 2022-08-26 第二十六次正式发布 本次变更如下： 修改新建截图任务、新建转码模板组和更新水印模板接口的格式错误。 修改新建转码任务、新建转码模板、更新转码模板、查询转码模板、查询转码模板组和新建独立加密任务接口的响应参数错误。 2022-06-21 第二十五次正式发布 本次变更如下： 修改新建转码任务接口中的“preset”编码质量等级。 2022-06-02 第二十四次正式发布 本次变更如下： 修改新建独立加密任务接口“Key”字段的描述和请求示例代码。 2022-03-17 第二十三次正式发布 本次变更如下： 修改新建转码任务接口示例代码。 2021-12-27 第二十二次正式发布 本次变更如下： 修改查询转封装任务接口“size”字段的描述，增加单位byte。 水印模板接口组中新增字段“template_id”，表示水印模板ID。 2021-11-24 第二十一次正式发布 本次变更如下： 新建水印模板接口新增创建数量上限的说明，默认支持创建100000个水印模板。 2021-11-10 第二十次正式发布 本次变更如下： 新建转码任务接口中“font_name”字段删除msyh字体，当前仅支持fzyouh。 结构体“VideoProcess”中新增字段“hls_init_count”，表示需要单独设置时长的HLS起始分片数量。 结构体“VideoProcess”中新增字段“hls_init_interval”，表示HLS分片的时长。 删除查询视频解析任务接口中的“font_name”字段。 删除重复的错误码。 2021-10-29 第十九次正式发布 本次变更如下： “使用前必读”中新增接口调用区域的相关约束与限制。 2020-12-10 第十八次正式发布 本次变更如下： 新增错误码说明。 2020-10-14 第十七次正式发布 本次变更如下： 优化字段描述，ObsObjInfo结构中“file_name”仅用于转封装接口，表示指定输出转封装文件的名称。 媒资转码接口、转封装接口和转动图接口中新增字段“user_data”，表示用户自定义数据。 结构体“MetaData”和“SourceInfo”中新增字段“duration_ms”，表示片源时长。 结构体“VideoInfo”中新增字段“dynamic_range”，表示片源动态范围类型。 2020-06-20 第十六次正式发布 本次变更如下： 新增应用示例：提交转码任务。 新增应用示例：提交截图任务。 2020-01-21 第十五次正式发布 本次变更如下： 新增自定义转码模板组接口。 2019-07-02 第十四次正式发布 本次变更如下： 增加应用示例章节，提供新建转码模板接口的调用示例。 2019-06-28 第十三次正式发布 本次变更如下： 新增动图管理接口。 新增视频解析接口。 2019-6-26 第十二次正式发布 本次变更如下： 新增转封装接口。 2019-04-29 第十一次正式发布 本次变更如下： 查询转码任务接口添加片源和输出文件信息。 2019-03-21 第十次正式发布 本次变更如下： 修改新建转码模板接口中的“pack_type”的描述。 2019-03-21 第九次正式发布 本次变更如下： 调整概述部分的结构，优化相关描述。 2018-10-25 第八次正式发布 本次变更如下： 修改转码模板id参数类型为Long类型。 2018-10-16 第七次正式发布 本次变更如下： 查询转码任务接口返回字段增加“TaskInfo”的异常描述“description”参数。 2018-09-30 第六次正式发布 本次变更如下： 新建转码接口和新建截图任务接口去除模板ID，改为截图信息结构。 2018-09-21 第五次正式发布 本次变更如下： 查询转码任务接口将原先的“detail_error”字段换成“transcode_detail”、“transcode_detail”，包含“Multitask_info”。 2018-05-16 第四次正式发布 本次变更如下： 在创建转码任务接口增加了水印相关参数。 增加水印模板接口。 2019-04-26 第三次正式发布 本次变更如下： 修改转码模板参数及范围。 2018-04-24 第二次正式发布 本次变更如下： 创建拼接任务接口中“format”字段增加“HLS_DASH”类型。 2018-03-31 第一次正式发布。

请求示例 POST https://{endpoint}/v1/{project_id}/encryptions { "output" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-path/output" }, "input" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-hls-path/index.m3u8" }, "encryption" : { "hls_encrypt" : { "iv" : "******", "key" : "******", "url" : "http://{your-keyserver}", "algorithm" : "AES-128-CBC" } } }

请求参数 表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时，只需指定到转码结果期望存放的路径。 在字幕场景下，字幕文件名称中禁止携带特殊符号，否则会导致转码任务失败，如：[ 正确示例: demo.srt 错误示例: [demo.srt file_name 否 String 文件名，文件名长度不能超过180个字符。 当指定了此参数时，输出的对象名为object/file_name。 当不指定此参数时，输出的对象名为object/xxx，其中xxx由MPC指定。 在作为输出文件名时： 在转封装场景有效，需要指定输出文件名称 在转码场景下，如果需要指定输出的文件名称，请使用output_filenames参数 在解析场景有效，解析场景如果指定文件名，则将解析参数写入指定文件名，通过查询接口响应json数据获取文件元数据信息 在截图场景无效 在转动图场景无效 输出文件为HLS格式时，文件名称不能命名为index，示例：index.m3u8，否则会导致播放失败。 表5 Encryption 参数 是否必选 参数类型 描述 hls_encrypt 否 HlsEncrypt object 视频加密控制参数。 表6 HlsEncrypt 参数 是否必选 参数类型 描述 key 是 String 使用base64编码的内容加密密钥 url 是 String 密钥获取服务的地址，用于播放hls分片时解密使用。 iv 否 String 初始向量，base64binary，随机数 algorithm 否 String 加密算法。 AES-128-CTR AES-128-CBC 默认值：AES-128-CTR

调用API获取项目ID 您还能通过调用查询指定条件下的项目信息API获取项目ID。 获取项目ID的接口为“GET https://{Endpoint}/v3/projects/”，其中{Endpoint}为IAM的终端节点可以从地区和终端节点获取。接口的认证鉴权请参见认证鉴权。 响应示例如下，其中projects下的“id”即为项目ID。 { "projects": [ { "domain_id": "65382450e8f64ac0870cd180d14e684b", "is_domain": false, "parent_id": "65382450e8f64ac0870cd180d14e684b", "name": "region01", "description": "", "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects/a4a5d4098fb4474fa22cd05f897d6b99" }, "id": "a4a5d4098fb4474fa22cd05f897d6b99", "enabled": true } ], "links": { "next": null, "previous": null, "self": "https://www.example.com/v3/projects" } }

请求示例 新建转码模板组，最多支持一进六出。 POST https://{endpoint}/v1/{project_id}/template_group/transcodings { "name" : "my_templateGroup", "videos" : [ { "width" : "480", "height" : "270", "bitrate" : "200" } ], "audio" : { "codec" : 1, "sample_rate" : 1, "channels" : 2, "bitrate" : 0 }, "video_common" : { "codec" : 1, "black_cut" : 0, "profile" : 3, "level" : 15, "preset" : 3, "max_iframes_interval" : 5, "bframes_count" : 4, "frame_rate" : 0 }, "common" : { "PVC" : false, "pack_type" : 1, "hls_interval" : 5, "dash_interval" : 5 } }

响应示例 状态码：201 新建转码模板组成功。 { "template_group" : { "group_id" : "f7fc420b17db414fb11652671581bb6d", "name" : "my_templateGroup", "template_ids" : [ 286548 ], "videos" : [ { "template_id" : 286548, "width" : 480, "height" : 270, "bitrate" : 200 } ], "audio" : { "output_policy" : "transcode", "codec" : 1, "bitrate" : 0, "sample_rate" : 1, "channels" : 2 }, "video_common" : { "output_policy" : "transcode", "codec" : 1, "profile" : 3, "level" : 15, "preset" : 1, "max_iframes_interval" : 5, "bframes_count" : 4, "frame_rate" : 0, "black_cut" : 0 }, "common" : { "PVC" : false, "hls_interval" : 5, "dash_interval" : 5, "pack_type" : 1 } } } 状态码：400 新建转码模板组失败。 { "error_code" : "MPC.10202", "error_msg" : "Invalid request parameter." }

状态码 调用媒体处理API时，可能返回的状态码如表1所示。 表1 状态码 返回值 说明 200 OK 请求正常。 201 Created 创建类的请求完全成功。 202 Accepted 已经接受请求，但未处理完成。 204 No Content 请求完全成功，同时HTTP响应不包含响应体。 400 Bad Request 非法请求。 建议直接修改该请求，不要重试该请求。 401 Unauthorized 在客户端提供认证信息后，返回该状态码，表明服务端指出客户端所提供的认证信息不正确或非法。 403 Forbidden 请求被拒绝访问。 返回该状态码，表明请求能够到达服务端，且服务端能够理解用户请求，但是拒绝做更多的事情，因为该请求被设置为拒绝访问，建议直接修改该请求，不要重试该请求。 404 Not Found 所请求的资源不存在。 建议直接修改该请求，不要重试该请求。 405 Method Not Allowed 请求中带有该资源不支持的方法。 建议直接修改该请求，不要重试该请求。 406 Not Acceptable 服务器无法根据客户端请求的内容特性完成请求。 407 Proxy Authentication Required 请求要求代理的身份认证，与401类似，但请求者应当使用代理进行授权。 408 Request Timeout 服务器等候请求时发生超时。 客户端可以随时再次提交该请求而无需进行任何更改。 409 Conflict 服务器在完成请求时发生冲突。 返回该状态码，表明客户端尝试创建的资源已经存在，或者由于冲突请求的更新操作不能被完成。 500 Internal Server Error 表明服务端能被请求访问到，但是不能理解用户的请求。 501 Not Implemented 服务器不支持请求的功能，无法完成请求。 502 Bad Gateway 充当网关或代理的服务器，从远端服务器接收到了一个无效的请求。 503 Service Unavailable 被请求的服务无效。 建议直接修改该请求，不要重试该请求。 504 Gateway Timeout 网关超时。 父主题： 附录

请求消息体（可选） 该部分可选。请求消息体通常以结构化格式（如JSON或XML）发出，与请求消息头中Content-Type对应，传递除请求消息头之外的内容。若请求消息体中的参数支持中文，则中文字符必须为UTF-8编码。 每个接口的请求消息体内容不同，也并不是每个接口都需要有请求消息体（或者说消息体为空），GET、DELETE操作类型的接口就不需要消息体，消息体具体内容需要根据具体接口而定。 对于管理员创建IAM用户接口，您可以从接口的请求部分看到所需的请求参数及参数说明，将消息体加入后的请求如下所示，其中加粗的字段需要根据实际值填写。 accountid为IAM用户所属的账号ID。 username为要创建的IAM用户名。 email为IAM用户的邮箱。 **********为IAM用户的登录密码。 POST https://iam.cn-north-4.myhuaweicloud.com/v3.0/OS-USER/users Content-Type: application/json X-Sdk-Date: 20240416T095341Z Authorization: SDK-HMAC-SHA256 Access=****************, SignedHeaders=content-type;host;x-sdk-date, Signature=**************** { "user": { "domain_id": "accountid", "name": "username", "password": "**********", "email": "email", "description": "IAM User Description" } } 到这里为止这个请求需要的内容就具备齐全了，您可以使用curl、Postman或直接编写代码等方式发送请求调用API。对于获取用户Token接口，返回的响应消息头中的“X-Subject-Token”就是需要获取的用户Token。有了Token之后，您就可以使用Token认证调用其他API。

请求消息头 附加请求头字段，如指定的URI和HTTP方法所要求的字段。例如定义消息体类型的请求头“Content-Type”，请求鉴权信息等。 详细的公共请求消息头字段请参见表3。 表3 公共请求消息头 名称 描述 是否必选 示例 Host 请求的服务器信息，从服务API的URL中获取。值为hostname[:port]。端口缺省时使用默认的端口，https的默认端口为443。 否 使用AK/SK认证时该字段必选。 code.test.com or code.test.com:443 Content-Type 消息体的类型（格式）。推荐用户使用默认值application/json，有其他取值时会在具体接口中专门说明。 是 application/json Content-Length 请求body长度，单位为Byte。 否 3495 X-Project-Id project id，项目编号。请参考获取项目ID章节获取项目编号。 否 如果是专属云场景采用AK/SK认证方式的接口请求，或者多project场景采用AK/SK认证的接口请求，则该字段必选。 e9993fc787d94b6c886cbaa340f9c0f4 X-Auth-Token 用户Token。 用户Token也就是调用获取用户Token接口的响应值，该接口是唯一不需要认证的接口。 请求响应成功后在响应消息头（Headers）中包含的“X-Subject-Token”的值即为Token值。 否 使用Token认证时该字段必选。 注：以下仅为Token示例片段。 MIIPAgYJKoZIhvcNAQcCo...ggg1BBIINPXsidG9rZ API同时支持使用AK/SK认证，AK/SK认证使用SDK对请求进行签名，签名过程会自动往请求中添加Authorization（签名认证信息）和X-Sdk-Date（请求发送的时间）请求头。 AK/SK认证的详细说明请参见认证鉴权的“AK/SK认证”。 对于管理员创建IAM用户接口，使用AK/SK方式认证时，添加消息头后的请求如下所示。 1 2 3 4 POST https://iam.cn-north-4.myhuaweicloud.com/v3.0/OS-USER/users Content-Type: application/json X-Sdk-Date: 20240416T095341Z Authorization: SDK-HMAC-SHA256 Access=****************, SignedHeaders=content-type;host;x-sdk-date, Signature=****************

请求URI 请求URI由如下部分组成： {URI-scheme}://{Endpoint}/{resource-path}?{query-string} 尽管请求URI包含在请求消息头中，但大多数语言或框架都要求您从请求消息中单独传递它，所以在此单独强调。 表1 URI中的参数说明 参数 描述 URI-scheme 表示用于传输请求的协议，当前所有API均采用HTTPS协议。 Endpoint 指定承载REST服务端点的服务器 域名 或IP，不同服务不同区域的Endpoint不同，您可以从地区和终端节点获取。 例如IAM服务在“华北-北京四”区域的Endpoint为“iam.cn-north-4.myhuaweicloud.com”。 resource-path 资源路径，即API访问路径。从具体API的URI模块获取，例如“获取用户Token”API的resource-path为“/v3/auth/tokens”。 query-string 查询参数，是可选部分，并不是每个API都有查询参数。查询参数前面需要带一个“?”，形式为“参数名=参数取值”，例如“?limit=10”，表示查询不超过10条数据。 例如您需要创建IAM用户，由于IAM为全局服务，则使用任一区域的Endpoint，比如“华北-北京四”区域的Endpoint（iam.cn-north-4.myhuaweicloud.com），并在管理员创建IAM用户的URI部分找到resource-path（/v3.0/OS-USER/users），拼接起来如下所示。 1 https://iam.cn-north-4.myhuaweicloud.com/v3.0/OS-USER/users 图1 URI示意图 为方便查看，在每个具体API的URI部分，只给出resource-path部分，并将请求方法写在一起。这是因为URI-scheme都是HTTPS，而Endpoint在同一个区域也相同，所以简洁起见将这两部分省略。

请求方法 HTTP请求方法（也称为操作或动词），它告诉服务您正在请求什么类型的操作。 表2 HTTP方法 方法 说明 GET 请求服务器返回指定资源。 PUT 请求服务器更新指定资源。 POST 请求服务器新增资源或执行特殊操作。 DELETE 请求服务器删除指定资源，如删除对象等。 HEAD 请求服务器资源头部。 PATCH 请求服务器更新资源的部分内容。 当资源不存在的时候，PATCH可能会去创建一个新的资源。 在管理员创建IAM用户的URI部分，您可以看到其请求方法为“POST”，则其请求为： 1 POST https://iam.cn-north-4.myhuaweicloud.com/v3.0/OS-USER/users

请求示例 新建转码任务，可以将视频进行转码。 POST https://{endpoint}/v1/{project_id}/transcodings { "input" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-path/input.mp4" }, "output" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-path/output" }, "trans_template_id" : [ 1002, 1003, 1004, 1005 ], "priority" : "9", "subtitle" : { "subtitle_type" : 1, "input" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example-subtitle.srt" } }, "encryption" : { "hls_encrypt" : { "iv" : "******", "key" : "******", "url" : "http://{your-keyserver}", "algorithm" : "AES-128-CBC" } }, "thumbnail" : { "out" : { "bucket" : "example-bucket", "location" : "region01", "object" : "example/path" }, "tar" : 1, "params" : { "time" : 2, "format" : 1, "max_length" : 480 } } }

请求参数 表3 请求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方式认证时必选，请求的发生时间。

请求参数 表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方式认证时必选，请求的发生时间。

响应示例 状态码：200 查询桶列表成功。 { "buckets" : [ { "bucket" : "example-bucket", "creation_date" : 20221026152511, "is_authorized" : 1 }, { "bucket" : "example-bucket", "creation_date" : 20221026104736, "is_authorized" : 0 } ] } 状态码：403 查询桶列表失败。 { "error_code" : "MPC.10208", "error_msg" : "Failed to verify the tenant ID." }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 buckets Array of ObsBucket objects 桶列表 表4 ObsBucket 参数 参数类型 描述 bucket String 桶名称 creation_date String 桶的创建时间 is_authorized Integer 授权结果 取值范围为[0,1] 0：表示未授权给转码服务 1：表示已授权转码服务 状态码：403 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码。 error_msg String 错误描述。

请求参数 表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参数 参数 是否必选 参数类型 描述 task_id 否 String 任务ID。