調用QueryMediaInfoJobList查詢媒體資訊作業的狀態與詳情-ApsaraVideo for Media Processing-阿里雲

查詢媒體資訊作業。

介面說明

非同步模式需要等到**提交媒體資訊作業**的 MNS 回調成功後才能查詢到媒體資訊。如果長時間查詢不到媒體資訊，可能是提交媒體資訊作業執行失敗。
本介面一次最多可查詢 10 個媒體資訊作業。
本介面傳回值預設按 CreationTime 降序排列。

QPS 限制

本介面的單使用者 QPS 限制為 100 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。更多資訊，請參見 QPS 限制。

調試

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

調試

授權資訊

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

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

mts:QueryMediaInfoJobList

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
MediaInfoJobIds	string	是	媒體資訊作業 ID。一次最多查詢 10 個，使用半形逗號（,）分隔。可以從提交媒體資訊作業的返回參數中擷取。說明如果不傳入此參數，則會返回 InvalidParameter（參數無效）錯誤碼。	23ca1d184c0e4341e5b665e2a12****

返回參數

名稱	類型	描述	樣本值
	object
NonExistMediaInfoJobIds	object
String	array	不存在的媒體資訊作業。
	string	不存在的媒體資訊作業 ID 列表，無資料時不返回該參數。	11ce1d184c0e4341e5b665e2a12****
RequestId	string	請求 ID。	46A04AA5-B119-41BB-B750-7C5327AC3E7A
MediaInfoJobList	object
MediaInfoJob	array<object>	媒體資訊作業列表。
	array<object>
CreationTime	string	作業添加時間。	2014-01-10T12:00:00Z
State	string	作業狀態。 Analyzing：分析中。 Success：分析成功。 Fail：分析失敗。	Success
JobId	string	元資訊分析作業 ID。	23ca1d184c0e4341e5b665e2a12****
UserData	string	使用者自訂資料。	testid-001
Code	string	元資訊分析失敗時錯誤碼。	InvalidParameter.JsonObjectFormatInvalid
Message	string	元資訊分析失敗時錯誤資訊。	The parameter ”*” does not conform to the JSON Object specification
PipelineId	string	管道 ID。	88c6ca184c0e432bbf5b665e2a15****
Async	boolean	是否為非同步作業。	true
Input	object	作業輸入。
Object	string	OSS 的 Object。	example.mp4
Location	string	OSS 的服務地區。	oss-cn-hangzhou
Bucket	string	輸入檔案的 OSS Bucket。	example-bucket
MNSMessageResult	object	MNS 通知使用者作業完成的訊息結果。
MessageId	string	成功時訊息 ID。如果失敗則不返回此參數。	123
ErrorMessage	string	失敗時錯誤資訊。如果成功則不返回此參數。	The parameter \"Input\" does not conform to the JSON Object specification
ErrorCode	string	失敗時錯誤碼。如果成功則不返回此參數。	InvalidParameter.JsonObjectFormatInvalid
Properties	object	媒體詳細屬性。更多資訊請參見資料類型 AliyunProperties。
Width	string	視頻像素寬。	1280
Height	string	視頻像素長。	720
Duration	string	時間長度。	17.226000
Fps	string	幀率。	25
Bitrate	string	碼率。	1630.045
FileFormat	string	檔案格式。	QuickTime/MOV
Streams	object	流資訊。
VideoStreamList	object
VideoStream	array<object>	視頻流資訊列表。
	array<object>
Sar	string	編碼訊號解析度比。	1:1
Height	string	視頻解析度長。	1080
CodecTagString	string	編碼格式標記文本。	[0][0][0][0]
NetworkCost	object	網路頻寬消耗。
PreloadTime	string	預先載入時間。	8
AvgBitrate	string	平均碼率。	300.34
CostBandwidth	string	最大消耗頻寬。	10
Width	string	視頻解析度寬。	1920
Index	string	視頻流序號，標識視頻流在整個媒體流中的位置。	1
Timebase	string	時基。	1/1000
AvgFPS	string	平均幀率。	23.976025
PixFmt	string	像素格式。	yuv420p
Lang	string	語言。	eng
CodecLongName	string	編碼格式長述名。	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10
NumFrames	string	總幀數。	100
Rotate	string	視頻旋轉角度。	180
Bitrate	string	碼率。	30541090
HasBFrames	string	是否有 B 幀。0 表示無，1 表示有。	0
Profile	string	編碼預置。	High
StartTime	string	起始時間。	0.042000
Dar	string	編碼顯示解析度比。	16:9
CodecName	string	編碼格式簡述名。可選值： h264 h265 gif webp	h264
Duration	string	時間長度。	100
Fps	string	幀率。	25
CodecTag	string	編碼格式標記。	0x0000
CodecTimeBase	string	編碼時基。	1001/48000
Level	string	編碼等級。	41
ColorRange	string	色彩範圍。	700
ColorTransfer	string	色彩通道。	R255 G83 B170
ColorPrimaries	string	色原。	700
DurationInaccurate	string
DolbyVision	object
Profile	string
Level	string
AudioStreamList	object
AudioStream	array<object>	音頻流資訊列表。
	object
Timebase	string	時基。	1/1000
Index	string	音頻流序號，標識音頻流在整個媒體流中的位置。	1
SampleFmt	string	採樣格式。	fltp
ChannelLayout	string	聲道數。	5.1(side)
Lang	string	語言。更多資訊請參見 FFmpeg 語言定義。	eng
Samplerate	string	採樣率。	48000
CodecLongName	string	編碼格式長述名。	DCA (DTS Coherent Acoustics)
Channels	string	聲道輸出樣式。	2
NumFrames	string	總幀數。	123
Bitrate	string	碼率。	1536000
CodecTagString	string	編碼格式標記文本。	[0][0][0][0]
StartTime	string	起始時間。	0.042000
CodecName	string	編碼格式簡述名。可取值： acc mp3 mp4 ogg flac	acc
Duration	string	時間長度。	123
CodecTag	string	編碼格式標記。	0x0000
CodecTimeBase	string	編碼時基。	1/48000
DurationInaccurate	string
SubtitleStreamList	object
SubtitleStream	array<object>	字幕流資訊列表。
	object
Timebase	string	時基。	1/1000
Index	string	字幕流序號，標識字幕流在整個媒體流中的位置。	3
StartTime	string	起始時間。	0.000000
CodecName	string	編碼格式簡述名。可選值： srt ass	ass
Lang	string	語言。	eng
CodecLongName	string	編碼格式長述名。	ASS (Advanced SSA) subtitle
Duration	string	時間長度，單位秒（s）。	1370.116000
CodecTag	string	編碼格式標記。	0x0000
CodecTimeBase	string	編碼時基。	0/1
CodecTagString	string	編碼格式標記文本。	[0][0][0][0]
Format	object	格式資訊。
StartTime	string	起始時間。	0.042000
NumPrograms	string	節目流總數。	2
Size	string	檔案大小。	3509895
NumStreams	string	媒體流總數。	1
FormatLongName	string	容器、封裝格式長述名。	QuickTime/MOV
Duration	string	總時間長度。	17.226000
Bitrate	string	總碼率。	1630.045
FormatName	string	容器、封裝格式簡述名。	mov
Tags	object
FileSize	string	檔案大小。	3509895
FileMd5	string

回調訊息格式定義

當媒體資訊任務執行狀態改變時，mps 會發送訊息到使用者指定的 queue 中（如何指定回調 queue 詳見 mps 的更新管道介面）。訊息體是一個 JSON 字串，包含欄位如下：

{
  "Type": "MediaInfo",
  "State": "Success",
  "JobId": "bb558c1cc25b45309aab5be44d19****",
  "UserData": "{\"key\":\"value\"}",
  "RequestId": "B52658D4-07AB-43CD-82B0-210958A6****"
}

名稱	類型	描述
Type	String	固定字串“MediaInfo”，表示媒體資訊任務。
JobId	String	任務唯一 ID。
State	String	任務目前狀態，與 QueryMediaInfoJobList 中的 State 一致。
UserData	String	使用者在 SubmitMediaInfoJob 中傳入的 UserData。

樣本

正常返回樣本

JSON格式

{
  "NonExistMediaInfoJobIds": {
    "String": [
      "11ce1d184c0e4341e5b665e2a12****"
    ]
  },
  "RequestId": "46A04AA5-B119-41BB-B750-7C5327AC3E7A",
  "MediaInfoJobList": {
    "MediaInfoJob": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "State": "Success",
        "JobId": "23ca1d184c0e4341e5b665e2a12****",
        "UserData": "testid-001",
        "Code": "InvalidParameter.JsonObjectFormatInvalid",
        "Message": "The parameter ”*” does not conform to the JSON Object specification",
        "PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
        "Async": true,
        "Input": {
          "Object": "example.mp4",
          "Location": "oss-cn-hangzhou",
          "Bucket": "example-bucket"
        },
        "MNSMessageResult": {
          "MessageId": "123",
          "ErrorMessage": "The parameter \\\"Input\\\" does not conform to the JSON Object specification",
          "ErrorCode": "InvalidParameter.JsonObjectFormatInvalid"
        },
        "Properties": {
          "Width": "1280",
          "Height": "720",
          "Duration": "17.226000",
          "Fps": "25",
          "Bitrate": "1630.045",
          "FileFormat": "QuickTime/MOV",
          "Streams": {
            "VideoStreamList": {
              "VideoStream": [
                {
                  "Sar": "1:1",
                  "Height": "1080",
                  "CodecTagString": "[0][0][0][0]",
                  "NetworkCost": {
                    "PreloadTime": "8",
                    "AvgBitrate": "300.34",
                    "CostBandwidth": "10"
                  },
                  "Width": "1920",
                  "Index": "1",
                  "Timebase": "1/1000",
                  "AvgFPS": "23.976025",
                  "PixFmt": "yuv420p",
                  "Lang": "eng",
                  "CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
                  "NumFrames": "100",
                  "Rotate": "180",
                  "Bitrate": "30541090",
                  "HasBFrames": "0",
                  "Profile": "High",
                  "StartTime": "0.042000",
                  "Dar": "16:9",
                  "CodecName": "h264",
                  "Duration": "100",
                  "Fps": "25",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "1001/48000",
                  "Level": "41",
                  "ColorRange": "700",
                  "ColorTransfer": "R255 G83 B170",
                  "ColorPrimaries": "700",
                  "DurationInaccurate": "",
                  "DolbyVision": {
                    "Profile": "",
                    "Level": ""
                  }
                }
              ]
            },
            "AudioStreamList": {
              "AudioStream": [
                {
                  "Timebase": "1/1000",
                  "Index": "1",
                  "SampleFmt": "fltp",
                  "ChannelLayout": "5.1(side)",
                  "Lang": "eng",
                  "Samplerate": "48000",
                  "CodecLongName": "DCA (DTS Coherent Acoustics)",
                  "Channels": "2",
                  "NumFrames": "123",
                  "Bitrate": "1536000",
                  "CodecTagString": "[0][0][0][0]",
                  "StartTime": "0.042000",
                  "CodecName": "acc",
                  "Duration": "123",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "1/48000",
                  "DurationInaccurate": ""
                }
              ]
            },
            "SubtitleStreamList": {
              "SubtitleStream": [
                {
                  "Timebase": "1/1000",
                  "Index": "3",
                  "StartTime": "0.000000",
                  "CodecName": "ass",
                  "Lang": "eng",
                  "CodecLongName": "ASS (Advanced SSA) subtitle",
                  "Duration": "1370.116000",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "0/1",
                  "CodecTagString": "[0][0][0][0]"
                }
              ]
            }
          },
          "Format": {
            "StartTime": "0.042000",
            "NumPrograms": "2",
            "Size": "3509895",
            "NumStreams": "1",
            "FormatLongName": "QuickTime/MOV",
            "Duration": "17.226000",
            "Bitrate": "1630.045",
            "FormatName": "mov",
            "Tags": {
              "test": "test",
              "test2": 1
            }
          },
          "FileSize": "3509895",
          "FileMd5": ""
        }
      }
    ]
  }
}

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。