GetMediaInfoJob パラメータとレスポンスフィールドの概要 - IMS

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

今すぐお試しください

この 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 ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ice:GetMediaInfoJob

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
JobId	string	任意	タスクの ID。	ab4802364a2e49208c99efab82dfa8e8

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	31E30781-9495-5E2D-A84D-759B0A01E262
MediaInfoJob	object	MediaInfoJobDTO
Name	string	タスク名。	job-name
TriggerSource	string	タスクの発生元。有効な値：API、WorkFlow、およびコンソール。	API
JobId	string	タスク ID。	ab4802364a2e49208c99efab82dfa8e8
Input	object	タスクの入力情報。
Type	string	メディアオブジェクトの種類。有効な値： OSS：Object Storage Service (OSS) オブジェクト。 Media：メディアアセット。	OSS
Media	string	メディアオブジェクト。Type が OSS の場合、OSS オブジェクトの URL が返されます。OSS プロトコルおよび HTTP プロトコルの両方がサポートされています。Type が Media の場合、メディアアセットの ID が返されます。	oss://bucket/path/to/video.mp4
Async	boolean	非同期処理が実行されたかどうかを示します。	true
UserData	string	ユーザー定義データ。	user-data
ScheduleConfig	object	スケジューリング情報。
PipelineId	string	タスクが送信された MPS キューの ID。	e37ebee5d98b4781897f6086e89f9c56
Priority	integer	タスクの優先度。有効な値：1～10。数値が大きいほど優先度が高くなります。	5
Status	string	タスクの状態。有効な値：Init（タスクが送信済み）、Success（タスクが成功）、Fail（タスクが失敗）。	Init
SubmitResultJson	object	タスク送信情報。
MediaInfoProperty	object	メディア情報の詳細。
FileBasicInfo	object	基本ファイル情報。
MediaId	string	メディアアセットの ID。	e520090207114cc7a392d44f0b211574
FileName	string	ファイル名。	file.m3u8
FileStatus	string	ファイルの状態。	Normal
FileType	string	ファイルタイプ。	source_file
FileSize	string	ファイルサイズ。	31737
FileUrl	string	ファイルの URL。	http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8
Region	string	ファイルが存在するリージョン。	cn-shanghai
FormatName	string	動画フォーマット名。	hls,applehttp
Duration	string	動画の持続時間。単位：秒。	403.039999
Bitrate	string	動画ビットレート。	888.563
Width	string	出力動画の幅。	848
Height	string	出力動画の高さ。	478
AudioStreamInfoList	array<object>	音声ストリームの情報。
	object
Index	string	ストリームのシーケンス番号。	1
CodecName	string	エンコード形式。	aac
CodecLongName	string	エンコード形式の名称。	AAC (Advanced Audio Coding)
CodecTimeBase	string	エンコーダーのタイムベース。	1/44100
CodecTagString	string	エンコーダータグの名称。	[15][0][0][0]
CodecTag	string	エンコーダータグ。	0x000f
SampleFmt	string	サンプルフォーマット。	fltp
SampleRate	string	サンプリングレート。単位：Hz。	44100
Channels	string	サウンドチャンネル数。	2
ChannelLayout	string	サウンドチャンネルレイアウト。	stereo
Timebase	string	タイムベース。	1/90000
StartTime	string	ストリームの開始時刻。	1.473556
Duration	string	ストリームの持続時間。単位：秒。	403.039989
Bitrate	string	ビットレート。	0.f
Lang	string	ストリームの言語。	us
VideoStreamInfoList	array<object>	ビデオストリームの情報。
	object
Index	string	ストリームのシーケンス番号。	0
Codec_name	string	エンコード形式。	h264
Codec_long_name	string	エンコード形式の名称。	H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10
Profile	string	エンコーダープロファイル。	High
Codec_time_base	string	エンコーダーのタイムベース。	1/50
Codec_tag_string	string	エンコード形式のタグ文字列。	[27][0][0][0]
Codec_tag	string	エンコード形式のタグ。	0x001b
Width	string	出力動画の幅。	848
Height	string	出力動画の高さ。	478
Has_b_frames	string	ビデオストリームに双方向フレーム（B-フレーム）が含まれているかどうかを示します。有効な値： 0：ストリームに B-フレームは含まれません。 1：ストリームに 1 つの B-フレームが含まれます。 2：ストリームに複数の連続する B-フレームが含まれます。	2
Sar	string	サンプリングポイントが取得されるエリアの縦横比。	478:477
Dar	string	アスペクト比の表示。	16:9
PixFmt	string	ピクセルフォーマット。	yuv420p
Level	string	コーデックレベル。	31
Fps	string	フレームレート。	25.0
Avg_fps	string	平均フレームレート。	25.0
Time_base	string	タイムベース。	1/90000
Start_time	string	ストリームの開始時刻。	1.473556
Duration	string	ファイルの持続時間。	403.039989
Bit_rate	string	ビットレート。	888.563
NumFrames	string	フレーム総数。	10040
Lang	string	ストリームの言語。	zh
Rotate	string	動画画像の回転角度。	0
SubmitTime	string	タスクが送信された時刻。	2022-01-12T08:49:41Z
FinishTime	string	タスクが完了した時刻。	2022-01-12T08:49:41Z
RequestId	string	リクエスト ID。	4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168

例

成功レスポンス

JSONJSON

{
  "RequestId": "31E30781-9495-5E2D-A84D-759B0A01E262",
  "MediaInfoJob": {
    "Name": "job-name",
    "TriggerSource": "API",
    "JobId": "ab4802364a2e49208c99efab82dfa8e8",
    "Input": {
      "Type": "OSS",
      "Media": "oss://bucket/path/to/video.mp4"
    },
    "Async": true,
    "UserData": "user-data",
    "ScheduleConfig": {
      "PipelineId": "e37ebee5d98b4781897f6086e89f9c56",
      "Priority": 5
    },
    "Status": "Init",
    "SubmitResultJson": {
      "test": "test",
      "test2": 1
    },
    "MediaInfoProperty": {
      "FileBasicInfo": {
        "MediaId": "e520090207114cc7a392d44f0b211574",
        "FileName": "file.m3u8",
        "FileStatus": "Normal",
        "FileType": "source_file",
        "FileSize": "31737",
        "FileUrl": "http://bucket.oss-cn-shanghai.aliyuncs.com/path/to/file.m3u8",
        "Region": "cn-shanghai",
        "FormatName": "hls,applehttp",
        "Duration": "403.039999",
        "Bitrate": "888.563",
        "Width": "848",
        "Height": "478"
      },
      "AudioStreamInfoList": [
        {
          "Index": "1",
          "CodecName": "aac",
          "CodecLongName": "AAC (Advanced Audio Coding)",
          "CodecTimeBase": "1/44100",
          "CodecTagString": "[15][0][0][0]",
          "CodecTag": "0x000f",
          "SampleFmt": "fltp",
          "SampleRate": "44100",
          "Channels": "2",
          "ChannelLayout": "stereo",
          "Timebase": "1/90000",
          "StartTime": "1.473556",
          "Duration": "403.039989",
          "Bitrate": "0.f",
          "Lang": "us"
        }
      ],
      "VideoStreamInfoList": [
        {
          "Index": "0",
          "Codec_name": "h264",
          "Codec_long_name": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
          "Profile": "High",
          "Codec_time_base": "1/50",
          "Codec_tag_string": "[27][0][0][0]",
          "Codec_tag": "0x001b",
          "Width": "848",
          "Height": "478",
          "Has_b_frames": "2",
          "Sar": "478:477",
          "Dar": "16:9",
          "PixFmt": "yuv420p",
          "Level": "31",
          "Fps": "25.0",
          "Avg_fps": "25.0",
          "Time_base": "1/90000",
          "Start_time": "1.473556",
          "Duration": "403.039989",
          "Bit_rate": "888.563",
          "NumFrames": "10040",
          "Lang": "zh",
          "Rotate": "0"
        }
      ]
    },
    "SubmitTime": "2022-01-12T08:49:41Z",
    "FinishTime": "2022-01-12T08:49:41Z",
    "RequestId": "4879B9DE-E4B6-19DC-91F5-9D5F4DCE4168"
  }
}

エラーコード

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

変更履歴

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