閱讀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使用手冊_媒體轉碼-阿裏雲