阅读681 返回首页    go 阿里云

提交转码作业__转码接口_API使用手册_媒体转码-阿里云

描述

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

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

请求参数

名称 类型 必填项 描述
Action String 是 操作接口名，系统规定参数，取值： SubmitJobs
Input String 是 作业输入,JSON对象，Input定义详见附录-参数详情-19 转码作业输入详情 。例如：
{
"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[ ] 提交转码作业结果列表

示例

请求示例

  1.     https://mts.aliyuncs.com/?PipelineId=88c6ca184c0e47098a5b665e2a126799&Action=SubmitJobs&Input=%7B%22MediaId%22%3A%2288c6ca184c0e47098a5b665e2a126797%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&公共参数>

返回示例

XML格式:

  1.     <SubmitJobsResponse>
  2.         <RequestId>25818875-5F78-4A13-BEF6-D7393642CA58</RequestId>
  3.         <JobResultList list="true">
  4.             <JobResult>
  5.                 <Success>true</Success>
  6.                 <Code> </Code>
  7.                 <Message> </Message>
  8.                 <Job>
  9.                     <JobId>31fa3c9ca8134f9cec2b4b0b0f787830</JobId>
  10.                     <Input>
  11.                         <Bucket>example-bucket</Bucket>
  12.                         <Location>oss-cn-hangzhou</Location>
  13.                         <Object>example.flv</Object>
  14.                     </Input>
  15.                     <Output>
  16.                          <OutputFile>
  17.                             <Bucket>example-bucket</Bucket>
  18.                             <Location>oss-cn-hangzhou</Location>
  19.                             <Object>example-output.flv</Object>
  20.                         </OutputFile>
  21.                         <TemplateId>S00000000-000010</TemplateId>
  22.                         <WaterMarkList list="true">
  23.                             <WaterMark>
  24.                                 <InputFile>
  25.                                     <Bucket>example-logo-bucket</Bucket>
  26.                                     <Location>0ss-cn-hangzhou</Location>
  27.                                     <Object>example-logo.png</Object>
  28.                                 </InputFile>
  29.                                 <WaterMarkTemplateId>88c6ca184c0e47098a5b665e2a126797</WaterMarkTemplateId>
  30.                             </WaterMark>
  31.                         </WaterMarkList>
  32.                         <UserData>testid-001</UserData>
  33.                     </Output>
  34.                     <State>Submitted</State>
  35.                     <Code> </Code>
  36.                     <Message> </Message>
  37.                     <Percent>0</Percent>
  38.                     <PipelineId>88c6ca184c0e47098a5b665e2a126797</PipelineId>
  39.                     <CreationTime>2014-01-10T12:00:00Z</CreationTime>
  40.                 </Job>
  41.             </JobResult>
  42.         </JobResultList>
  43.     </SubmitJobsResponse>

Json格式：

  1.     {
  2.         "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3.         "JobResultList": {
  4.             "JobResult": [{
  5.                 "Success": true,
  6.                 "Code": "",
  7.                 "Message": "",
  8.                 "Job": {
  9.                     "JobId": "31fa3c9ca8134f9cec2b4b0b0f787830",
  10.                     "Input": {
  11.                             "Bucket": "example-bucket",
  12.                             "Location": "oss-cn-hangzhou",
  13.                             "Object": "example.flv"
  14.                     },
  15.                     "Output": {
  16.                         "OutputFile": {
  17.                             "Bucket": "example-bucket",
  18.                             "Location": "oss-cn-hangzhou",
  19.                             "Object": "example-output.flv"
  20.                         },
  21.                         "TemplateId": "S00000000-000010",
  22.                         "WaterMarkList": {
  23.                             "WaterMark": [{
  24.                                  "InputFile": {
  25.                                     "Bucket": "example-bucket",
  26.                                     "Location": "oss-cn-hangzhou",
  27.                                     "Object": "example-logo.png"
  28.                                 },
  29.                                 "WaterMarkTemplateId": "88c6ca184c0e47098a5b665e2a126797"
  30.                             }]
  31.                         },
  32.                         "UserData":"testid-001"
  33.                     },
  34.                     "State": "Submitted",
  35.                     "Code": "",
  36.                     "Message": "",
  37.                     "Percent": 0,
  38.                     "PipelineId": "88c6ca184c0e47098a5b665e2a126797",
  39.                     "CreationTime”:”2014-01-10T12:00:00Z"
  40.                 }
  41.             }]
  42.         }
  43.     }

最后更新：2016-11-23 16:04:03

  上一篇：go 查询模板分析作业__预置智能模版推荐接口_API使用手册_媒体转码-阿里云
  下一篇：go 取消转码作业__转码接口_API使用手册_媒体转码-阿里云