提交转码作业接口，一个转码输出会生成一个转码作业，接口返回转码作业列表。作业会添加到管道中被调度执行，执行完成后需要调用查询转码作业接口轮询作业执行结果，也可使用异步通知机制。

说明 使用预置模板对输入文件进行转码，须要先调用提交模板分析作业接口（SubmitAnalysisJob），分析作业成功完成后可以通过调用查询模板分析作业接口（QueryAnalysisJobList）获取该输入文件的可用预置模版列表。若提交的转码作业中指定的预置模板不在可用的预置模板列表中，则转码作业会失败。

请求参数

名称 类型 是否必须 描述
Action String 是 操作接口名，系统规定参数，取值： SubmitJobs
Input String 是 作业输入，JSON对象，Input定义详见参数详情 。例如：{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example.flv"}需在控制台中完成云资源授权。
OutputBucket String 是 输出Bucket，需在控制台中完成云资源授权。
OutputLocation String 否 输出 Bucket 所在数据中心。

默认值：oss-cn-hangzhou
Outputs String 是
  • Outputs由Output列表构成，JSON数组，大小上限为30。
  • Output的定义详见术语表。
  • Output的参数说明见附录 参数Output详情。
例如：[{"OutputObject":"example-output.flv","TemplateId":"S00000000-000010","WaterMarks":[{"InputFile":{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","Object":"example-logo.png"},"WaterMarkTemplateId":"88c6ca184c0e47098a5b665e2a126797"}],"UserData":"testid-001"}]
PipelineId String 是 管道ID。
  • 管道的定义详见术语表；
  • 若需要异步通知，须保证此管道绑定了可用的消息主题。

返回参数

名称 类型 描述
JobResultList AliyunJobResult[ ] 提交转码作业结果列表

示例

请求示例
http://mts.cn-hangzhou.aliyuncs.com/?PipelineId=88c6ca184c0e47098a5b665e2a126799&Action=SubmitJobs&Input=%7b%22Bucket%22%3a%22example-bucket%22%2c%22Location%22%3a%22oss-cn-hangzhou%22%2c%22Object%22%3a%22example.flv%22%7d&Outputs=%5b%7b%22OutputObject%22%3a%22example-output.flv%22%2c%22TemplateId%22%3a%22S00000000-000010%22%2c%22WaterMarks%22%3a%5b%7b%22InputFile%22%3a%7b%22Bucket%22%3a%22example-bucket%22%2c%22Location%22%3a%22oss-cn-hangzhou%22%2c%22Object%22%3a%22example-logo.png%22%7d%2c%22WaterMarkTemplateId%22%3a%2288c6ca184c0e47098a5b665e2a126797%22%7d%5d%7d%5d&OutputBucket=example-bucket&公共参数>

返回示例

XML
<SubmitJobsResponse>
        <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
        <JobResultList list="true">
            <JobResult>
                <Success>true</Success>
                <Code> </Code>
                <Message> </Message>
                <Job>
                    <JobId>31fa3c9ca8134f9cec2b4b0b0f787830</JobId>
                    <Input>
                        <Bucket>example-bucket</Bucket>
                        <Location>oss-cn-hangzhou</Location>
                        <Object>example.flv</Object>
                    </Input>
                    <Output>
                         <OutputFile>
                            <Bucket>example-bucket</Bucket>
                            <Location>oss-cn-hangzhou</Location>
                            <Object>example-output.flv</Object>
                        </OutputFile>
                        <TemplateId>S00000000-000010</TemplateId>
                        <WaterMarkList list="true">
                            <WaterMark>
                                <InputFile>
                                    <Bucket>example-logo-bucket</Bucket>
                                    <Location>0ss-cn-hangzhou</Location>
                                    <Object>example-logo.png</Object>
                                </InputFile>
                                <WaterMarkTemplateId>88c6ca184c0e47098a5b665e2a126797</WaterMarkTemplateId>
                            </WaterMark>
                        </WaterMarkList>
                        <UserData>testid-001</UserData>
                    </Output>
                    <State>Submitted</State>
                    <Code> </Code>
                    <Message> </Message>
                    <Percent>0</Percent>
                    <PipelineId>88c6ca184c0e47098a5b665e2a126797</PipelineId>
                    <CreationTime>2014-01-10T12:00:00Z</CreationTime>
                </Job>
            </JobResult>
        </JobResultList>
    </SubmitJobsResponse>
JSON
{
        "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
        "JobResultList": {
            "JobResult": [{
                "Success": true,
                "Code": "",
                "Message": "",
                "Job": {
                    "JobId": "31fa3c9ca8134f9cec2b4b0b0f787830",
                    "Input": {
                            "Bucket": "example-bucket",
                            "Location": "oss-cn-hangzhou",
                            "Object": "example.flv"
                    },
                    "Output": {
                        "OutputFile": {
                            "Bucket": "example-bucket",
                            "Location": "oss-cn-hangzhou",
                            "Object": "example-output.flv"
                        },
                        "TemplateId": "S00000000-000010",
                        "WaterMarkList": {
                            "WaterMark": [{
                                 "InputFile": {
                                    "Bucket": "example-bucket",
                                    "Location": "oss-cn-hangzhou",
                                    "Object": "example-logo.png"
                                },
                                "WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a126797"
                            }]
                        },
                        "UserData":"testid-001"
                    },
                    "State": "Submitted",
                    "Code": "",
                    "Message": "",
                    "Percent": 0,
                    "PipelineId": "88c6ca184c0e47098a5b665e2a126797",
                    "CreationTime”:”2014-01-10T12:00:00Z"
                }
            }]
        }
    }

转码错误码

错误代码 描述 详细信息
InvalidParameter.ResourceContentBad 转码源文件内容已经损坏导致转码失败 The resource operated is broken.
PermissionDenied.ResourceAccess 授权存在问题 MTS not authorized to operate on the specified resource.
InternalError 内部未识别错误 The operation has failed due to some unknown error, exception or failure.
InvalidParameter.NullValue 参数为Null错误 The specified parameter “%s” cannot be null.
InvalidParameter.EmptyValue 参数为空错误 The specified parameter “%s” can not be empty.
InvalidParameter.UUIDFormatInvalid ID不符合UUID格式 The parameter “%s” is invalid.A uuid must: 1) be comprised of chracters[a-f],numbers[0-9]; 2) be 32 characters long
InvalidParameter.OutOfRange 参数超过范围 The specified parameter “%s” is out of range.
InvalidParameter.ResourceNotFound 资源不存在 The resource operated “%s” cannot be found.
InvalidParameter.ResourceDeleted 资源已经被删除 The resource operated “%s” has been deleted.
InvalidParameter.BucketNameInvalid Bucket名称无效 The bucket name “%s” is invalid. A bucket name must: 1) be comprised of lower-case characters, numbers, underscore(_) or dash(-); 2) start with lower case or numbers; 3) be between 3-255 characters long.
InvalidParameter.LocationInvalid Location无效 The location “%s” is invalid. A location name must be one of the five: oss-cn-hangzhou, oss-cn-shanghai, oss-cn-beijing, oss-us-west-1 and oss-cn-shenzhen.
InvalidParameter.ObjectKeyInvalid Object名称无效 The object key “%s” is invalid. An object name should be between 1 - 1023 bytes long when encoded as UTF-8 and cannot contain LF or CR or unsupported chars in XML1.0
InvalidParameter.JsonArrayFormatInvalid 不是JSON数组 The parameter “%s” does not conform to the JSON Array specification.
Parameters.NotSupported 参数不支持 The Parameters “%s” is not supported the same time,choose one of them.
InvalidParameter.ResourceNotSupported 不支持的资源类型 The resource operated “%s” is not supported.
NotSupportedJob.SystemTemplateJobNotSupported 倍速转码不支持的系统模板 The Template “%s” is a system template,cannot be supported by boost pipeline”.
InvalidParameter.Format 参数格式无效 The format of parameter “%s” is invalid.
InvalidParameter.TemplateNotFound 没有找到模板 The Template operated “%s” cannot be found.
InvalidParameter.TemplateNotSupported 模板不支持 The template operated “%s” is not supported.
InvalidParameter.NumberFormatInvalid 参数不是数字类型 he number format of parameter “%s” is invalid.
ParameterNotBoolean 参数不是布尔类型 ParameterNotBoolean, The Parameter “%s” is not boolean value.
InvalidParameter.DigiWatermark 数字水印参数无效 The specified parameter “%s” must include alternative of “InputFile” or “(NumberMark, StringMark).
InvalidParameter.WaterMarkFileFormatNotSupported 水印文件格式不支持 The resource operated “%s” is not supported, watermark only supports png file.
InvalidParameter.InvalidDigitalWaterMarkType 无效的数字水印类型 The specified parameter “%s” is invalid.
InvalidParameter.ListSizeExceed 参数列表长度超过限制 The specified parameter “%s” size exceed limits.
InvalidParameter.InvalidBase64Format 不符合Base64格式，参数无效 The specified parameter “%s” should be encoded by base64_urlsafe.
InvalidParameter.ServiceNotSupportRegion 功能不支持区域 The parameter region “%s” has not support the open video service.
DataEncryption.ContainerFormatNotSupported 数据加密，容器格式不支持 The container format only support: m3u8.
DataEncryption.CiphertextNotExist 数据加密，密文不存在 The ciphertext does not exist.