全部產品
Search
文件中心

Intelligent Media Services:GetMediaConvertJob - 查詢媒體轉碼任務

更新時間:May 01, 2026

擷取 MediaConvert 任務詳情

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ice:GetMediaConvertJob

get

*全部資源

*

請求文法

GET  HTTP/1.1

請求參數

名稱

類型

必填

描述

樣本值

JobId

string

媒體轉碼任務 ID。

****d80e4e4044975745c14b****

返回參數

名稱

類型

描述

樣本值

object

返回結果。

RequestId

string

請求 ID。

4BAEA8E8-1C16-5CD3-AC50-CCBA81A53402

Job

object

媒體轉碼任務。

RequestId

string

建立媒體轉碼任務的請求 ID。

******11-DB8D-4A9A-875B-275798******

ClientToken

string

建立媒體轉碼工作要求的等冪參數。

780018cb-55ba-466d-8acc-946c0c319a0e

JobId

string

媒體轉碼任務 ID,32 位字串

******4579b5e748b99a27f6d6******

Config

object

媒體轉碼任務配置。

Inputs

array

媒體轉碼任務輸入列表。

MediaConvertInput

媒體轉碼任務輸入。

Outputs

array

媒體轉碼任務輸出配置列表。

MediaConvertOutput

媒體轉碼任務輸出配置。

OutputGroups

array

媒體轉碼任務輸出組配置列表。

MediaConvertOutputGroup

媒體轉碼任務輸出組配置。

JobName

string

任務名稱。

job-1-20241205-102045

PipelineId

string

管道 ID。

83500cb2a3b94fabb0956e38d64bd16d

UserData

string

使用者資料。

{"videoId":"ddd333"}

Code

string

媒體轉碼失敗碼。

InvalidParameter.ResourceContentBad

Message

string

媒體轉碼失敗詳細資料。

The resource operated InputFile is bad

State

string

媒體轉碼任務狀態,值列表:

  • Inited : 初始化;

  • Running : 運行中;

  • Complete : 轉碼完成;

  • Error : 轉碼錯誤;

  • Cancelled : 已取消。

Complete

OutputDetails

array

媒體轉碼輸出結果詳情列表,對應轉碼配置中轉碼輸出資料行表的執行結果。

MediaConvertOutputDetail

媒體轉碼輸出結果。

OutputGroupDetails

array

媒體轉碼輸出組結果清單,對應轉碼配置中轉碼輸出組列表的執行結果。

MediaConvertOutputGroupDetail

媒體轉碼輸出組結果。

Percent

integer

任務完成百分比。

0

CreateTime

string

任務建立時間,格式為 yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。

2024-12-07T13:01:07Z

FinishTime

string

任務完成時間,格式為 yyyy-MM-ddTHH:mm:ssZ(UTC 時間)。

2024-12-07T13:01:07Z

樣本

正常返回樣本

JSON格式

{
  "RequestId": "4BAEA8E8-1C16-5CD3-AC50-CCBA81A53402",
  "Job": {
    "RequestId": "******11-DB8D-4A9A-875B-275798******",
    "ClientToken": "780018cb-55ba-466d-8acc-946c0c319a0e  ",
    "JobId": "******4579b5e748b99a27f6d6******",
    "Config": {
      "Inputs": [
        {
          "Name": "InputVideo",
          "InputFile": {
            "Type": "OSS",
            "Media": "http://bucket.loction.aliyuncs.com/path/to/video.mp4"
          }
        }
      ],
      "Outputs": [
        {
          "OutputFile": {
            "Type": "OSS",
            "Media": "http://bucket.loction.aliyuncs.com/path/to/video.mp4"
          },
          "Priority": 6,
          "OverrideParams": "{}",
          "Features": "{}",
          "TemplateId": "****96e8864746a0b6f3****",
          "Name": "output-video"
        }
      ],
      "OutputGroups": [
        {
          "GroupConfig": {
            "OutputFileBase": {
              "Type": "OSS",
              "Media": "http://bucket.loction.aliyuncs.com/path/to/video.mp4"
            },
            "ManifestName": "manifest",
            "Type": "Hls"
          },
          "Outputs": [
            {
              "Priority": 6,
              "OverrideParams": "{}",
              "Features": "{}",
              "OutputFileName": "720p.mp4",
              "TemplateId": "****96e8864746a0b6f3****\n",
              "Name": "group-output"
            }
          ],
          "Name": "hls-group"
        }
      ],
      "JobName": "job-1-20241205-102045"
    },
    "PipelineId": "83500cb2a3b94fabb0956e38d64bd16d",
    "UserData": "{\"videoId\":\"ddd333\"}",
    "Code": "InvalidParameter.ResourceContentBad",
    "Message": "The resource operated InputFile is bad",
    "State": "Complete",
    "OutputDetails": [
      {
        "Status": "Success",
        "TaskId": "******4215e042b3966ca5441e******",
        "Message": "The resource operated InputFile is bad\n",
        "FinishTime": "2024-12-07T13:01:07Z",
        "CreateTime": "2024-12-07T06:06:58Z",
        "Code": "InvalidParameter.ResourceContentBad\n",
        "Name": "720P-mp4",
        "Result": {
          "OutputFile": {
            "Type": "OSS",
            "Media": "oss://bucket/path/to/video.mp4\n",
            "Url": "oss://bucket/path/to/video.mp4"
          },
          "OutFileMeta": {
            "VideoStreamInfoList": [
              {
                "Rotate": "0",
                "Codec_tag": "0x001b",
                "Sar": "478:477",
                "Start_time": "1.473556",
                "Fps": "25.0",
                "Index": "0",
                "Duration": "403.039989",
                "Lang": "cn",
                "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                "PixFmt": "yuv420p",
                "Bit_rate": "888.563",
                "Profile": "High",
                "Has_b_frames": "2",
                "Codec_time_base": "1/50",
                "Dar": "16:9",
                "Avg_fps": "25.0",
                "Codec_tag_string": "[27][0][0][0]",
                "Codec_name": "h264",
                "Height": "478",
                "Level": "31",
                "Time_base": "1/90000",
                "Width": "848",
                "NumFrames": "10040"
              }
            ],
            "AudioStreamInfoList": [
              {
                "CodecTag": "0x000f",
                "CodecTimeBase": "1/44100",
                "ChannelLayout": "stereo",
                "StartTime": "1.473556",
                "Index": "1",
                "Duration": "403.039989",
                "Lang": "cn",
                "SampleFmt": "fltp",
                "CodecName": "aac",
                "Bitrate": "0.f",
                "Channels": "2",
                "Timebase": "1/90000",
                "CodecTagString": "[15][0][0][0]",
                "SampleRate": "44100",
                "CodecLongName": "AAC (Advanced Audio Coding)"
              }
            ],
            "FileBasicInfo": {
              "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
              "FileStatus": "Normal",
              "MediaId": "9066406c306771f0bfa35107e0c90102",
              "FileType": "source_file",
              "FileName": "file.m3u8",
              "Region": "cn-shanghai",
              "FormatName": "hls,applehttp",
              "Duration": "403.039999",
              "Height": "478",
              "Bitrate": "888.563",
              "Width": "848",
              "FileSize": "31737"
            }
          }
        }
      }
    ],
    "OutputGroupDetails": [
      {
        "Status": "Success",
        "TaskId": "******22dad741d086a50325f9******",
        "Message": "The resource operated \"InputFile\" is bad",
        "FinishTime": "2025-03-21T01:48:41Z\n",
        "CreateTime": "2025-03-21T01:48:41Z",
        "Outputs": [
          {
            "Status": "Success",
            "TaskId": "******4215e042b3966ca5441e******",
            "Message": "The resource operated InputFile is bad\n",
            "FinishTime": "2024-12-07T13:01:07Z",
            "CreateTime": "2024-12-07T06:06:58Z",
            "Code": "InvalidParameter.ResourceContentBad\n",
            "Name": "720P-mp4",
            "Result": {
              "OutputFile": {
                "Type": "OSS",
                "Media": "oss://bucket/path/to/video.mp4\n",
                "Url": "oss://bucket/path/to/video.mp4"
              },
              "OutFileMeta": {
                "VideoStreamInfoList": [
                  {
                    "Rotate": "0",
                    "Codec_tag": "0x001b",
                    "Sar": "478:477",
                    "Start_time": "1.473556",
                    "Fps": "25.0",
                    "Index": "0",
                    "Duration": "403.039989",
                    "Lang": "cn",
                    "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                    "PixFmt": "yuv420p",
                    "Bit_rate": "888.563",
                    "Profile": "High",
                    "Has_b_frames": "2",
                    "Codec_time_base": "1/50",
                    "Dar": "16:9",
                    "Avg_fps": "25.0",
                    "Codec_tag_string": "[27][0][0][0]",
                    "Codec_name": "h264",
                    "Height": "478",
                    "Level": "31",
                    "Time_base": "1/90000",
                    "Width": "848",
                    "NumFrames": "10040"
                  }
                ],
                "AudioStreamInfoList": [
                  {
                    "CodecTag": "0x000f",
                    "CodecTimeBase": "1/44100",
                    "ChannelLayout": "stereo",
                    "StartTime": "1.473556",
                    "Index": "1",
                    "Duration": "403.039989",
                    "Lang": "cn",
                    "SampleFmt": "fltp",
                    "CodecName": "aac",
                    "Bitrate": "0.f",
                    "Channels": "2",
                    "Timebase": "1/90000",
                    "CodecTagString": "[15][0][0][0]",
                    "SampleRate": "44100",
                    "CodecLongName": "AAC (Advanced Audio Coding)"
                  }
                ],
                "FileBasicInfo": {
                  "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
                  "FileStatus": "Normal",
                  "MediaId": "9066406c306771f0bfa35107e0c90102",
                  "FileType": "source_file",
                  "FileName": "file.m3u8",
                  "Region": "cn-shanghai",
                  "FormatName": "hls,applehttp",
                  "Duration": "403.039999",
                  "Height": "478",
                  "Bitrate": "888.563",
                  "Width": "848",
                  "FileSize": "31737"
                }
              }
            }
          }
        ],
        "Code": "InvalidParameter.ResourceContentBad",
        "Name": "hls-group"
      }
    ],
    "Percent": 0,
    "CreateTime": "2024-12-07T13:01:07Z\n",
    "FinishTime": "2024-12-07T13:01:07Z\n"
  }
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情