提交转码作业 - 媒体处理

说明使用预置模板对输入文件进行转码，须要先调用提交模板分析作业接口（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.