QueryMediaInfoJobList でメディア情報分析タスクをクエリする - MPS

メディア情報分析ジョブを照会します。

操作説明

非同期モードでは、SubmitMediaInfoJob 操作に対する Message Service (MNS) コールバックが正常に受信された後にのみ、メディア情報の照会が可能です。長期間経過してもメディア情報が照会できない場合、メディア情報分析ジョブが失敗している可能性があります。
1 回のリクエストで照会できるメディア情報分析ジョブは最大 10 件です。
デフォルトでは、返される結果は CreationTime を基準として降順にソートされます。

クエリ/秒 (QPS) の制限

この API 操作のクエリ/秒 (QPS) 制限は、ユーザーあたり 100 です。この制限を超える API 呼び出しはレート制限の対象となり、ビジネスに影響を及ぼす可能性があります。API 呼び出しの計画を適切に立ててください。詳細については、「クエリ/秒 (QPS) の制限」をご参照ください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

mts:QueryMediaInfoJobList

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
MediaInfoJobIds	string	必須	メディア情報分析ジョブの ID。 1 回のリクエストで照会できるジョブは最大 10 件です。複数のジョブ ID はカンマ (,) で区切ります。ジョブ ID は、SubmitMediaInfoJob 操作のレスポンスパラメーターから取得できます。説明このパラメーターを指定しない場合、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	MPS キューの ID。	88c6ca184c0e432bbf5b665e2a15****
Async	boolean	ジョブが非同期であるかどうかを示します。	true
Input	object	ジョブ入力。
Object	string	OSS オブジェクト。	example.mp4
Location	string	OSS リージョン。	oss-cn-hangzhou
Bucket	string	入力ファイルが格納されている OSS バケット。	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 の場合は B フレームなし、1 の場合は B フレームありです。	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	再生時間（秒単位）。	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

コールバックメッセージのフォーマット

メディア情報分析ジョブの実行ステータスが変更されると、ApsaraVideo Media Processing (MPS) は指定したキューにメッセージを送信します。コールバックキューの指定方法については、「UpdatePipeline」API 操作をご参照ください。メッセージ本文は、以下のフィールドを含む 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。

例

成功レスポンス

JSONJSON

{
  "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": ""
        }
      }
    ]
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。