OSS ファイル URL によるメディア情報の取得 - MPS

Object Storage Service (OSS) のファイル URL に基づいてメディアファイルをクエリします。

操作説明

一度に最大 10 個のメディアファイルをクエリできます。
この操作を呼び出す前に、AddMedia 操作を呼び出してメディアファイルを追加する必要があります。その後、この操作を呼び出してメディア情報をクエリできます。
この操作は、ワークフローで処理されたファイルの情報のみをクエリできます。新しくアップロードされたメディアファイルの場合、この操作によって返される情報は、ワークフローが実行された後に完全になります。ワークフローで処理されていないビデオの情報を取得するには、SubmitMediaInfoJob 操作を呼び出してメディア情報分析ジョブを送信する必要があります。

QPS 制限

この操作の 1 ユーザーあたりの秒間クエリ数 (QPS) 制限は 100 です。制限を超えるとスロットリングがトリガーされ、ビジネスに影響を与える可能性があります。これに応じて呼び出しを計画してください。詳細については、「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:QueryMediaListByURL

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
FileURLs	string	必須	クエリするメディアファイルの URL。メディアファイルの URL を取得するには、MPS コンソールにログインし、[メディア管理] > [メディアリスト] を選択し、メディアファイルを見つけて、[操作] 列の [管理] をクリックします。[トランスコーディング URL の取得] タブで、メディアファイルの URL を取得できます。複数の URL はコンマ (,) で区切ります。一度に最大 10 個の URL をクエリできます。 URL は RFC 3986 に準拠している必要があります。URL は UTF-8 でエンコードする必要があり、予約文字は URL エンコードする必要があります。詳細については、「URL エンコーディング」をご参照ください。URL の長さは最大 3,200 バイトです。 OSS HTTP URL のみがサポートされています。CDN および HTTPS URL はサポートされていません。	http://example-bucket-****.oss-cn-shanghai.aliyuncs.com/example.mp4
IncludePlayList	boolean	任意	レスポンスに再生情報を含めるかどうかを指定します。有効な値：true および false。デフォルト値：false。	true
IncludeSnapshotList	boolean	任意	レスポンスにスナップショット情報を含めるかどうかを指定します。有効な値：true および false。デフォルト値：false。	true
IncludeMediaInfo	boolean	任意	レスポンスにメディア情報を含めるかどうかを指定します。有効な値：true および false。デフォルト値：false。説明詳細な MediaInfo を取得するには、このパラメーターを true に設定します。	true
IncludeSummaryList	boolean	任意	レスポンスにビデオシノプシスのリストを含めるかどうかを指定します。有効な値：true および false。デフォルト値：false。	true

レスポンスフィールド

フィールド	型	説明	例
	object	返されるパラメーター。
MediaList	object
Media	array<object>	メディアファイルのリスト。
	array<object>	メディアファイルの詳細。
CreationTime	string	メディアファイルが作成された時刻。	2021-07-14T13:05:00Z
CateId	integer	カテゴリの ID。	123
Height	string	メディアファイルの高さ。	360
CensorState	string	ビデオのコンテンツ審査状態。有効な値： Initiated：ビデオは審査中です。 Pass：ビデオは審査に合格しました。	Initiated
Tags	object
Tag	array	タグ情報。
	string	タグのリスト。	tag1,tag2
PlayList	object
Play	array<object>	再生リスト。
	array<object>	再生ファイルの詳細。
Encryption	string	暗号化メソッド。有効な値： 0：暗号化されていません。 1：暗号化されています。	1
Height	string	高さ。	10
Bitrate	string	ビットレート。	25.067
File	object	再生ファイル。
State	string	ファイルの状態。有効な値： Normal：ファイルは通常の状態です。 Deleted：ファイルは削除されました。	Normal
URL	string	OSS バケット内の再生ファイルの URL。	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4l-test/in/1.mp4
MediaWorkflowId	string	再生ファイルを生成したワークフローの ID。	6cc3aa66d1cb4bb2adf14e726c0a****
Width	string	幅。	11
Size	string	サイズ。	100
Fps	string	フレームレート。	25.0
Duration	string	長さ。	7.965000
ActivityName	string	メディアワークフローアクティビティの名前。	test name
Format	string	エンコード形式。有効な値：mov、mp4、m4a、3gp、3g2、mj2。	mov
MediaWorkflowName	string	再生ファイルを生成したワークフローの名前。	example-mediaworkflow-****
Bitrate	string	ビットレート。	593.192
MediaId	string	メディア ID。	52d7e98b05e648199612290bb819****
File	object	入力ファイルの詳細。
State	string	ファイルの状態。有効な値： Normal：ファイルは通常の状態です。 Deleted：ファイルは削除されました。	Normal
URL	string	OSS バケット内の入力ファイルの URL。	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4
SummaryList	object
Summary	array<object>	ビデオシノプシスのリスト。
	array<object>	ビデオシノプシスデータ。
Type	string	シノプシスのタイプ。有効な値： Video：ビデオ。 Gif：アニメーション画像。	Gif
MediaWorkflowId	string	シノプシスを生成したワークフローの ID。	93ab850b4f6f44eab54b6e91d24d****
ActivityName	string	メディアワークフローアクティビティの名前。	example-activity-****
MediaWorkflowName	string	シノプシスを生成したワークフローの名前。	example-mediaworkflow-****
File	object	ソースファイル。
State	string	ファイルの状態。有効な値： Normal：ファイルは通常の状態です。 Deleted：ファイルは削除されました。	Normal
URL	string	OSS バケット内の入力ファイルの URL。	http://example-bucket-****.o
PublishState	string	メディアファイルの公開状態。有効な値： Initiated：メディアファイルは初期状態です。 UnPublish：メディアファイルは公開されていません。OSS 再生ファイルの権限はプライベートに設定されています。 Published：メディアファイルは公開されています。OSS 再生ファイルの権限はデフォルトに設定されています。 Deleted：メディアファイルは削除されました。	Published
MediaInfo	object	メディア情報。
Streams	object	ストリーム情報。
VideoStreamList	object
VideoStream	array<object>	ビデオストリームのリスト。
	array<object>	ビデオストリームデータ。
Sar	string	サンプルアスペクト比 (SAR)。	1:1
Height	string	ビデオの高さ。	360
CodecTagString	string	エンコード形式のタグ。	avc1
NetworkCost	object	ネットワーク帯域幅消費量。
PreloadTime	string	プリロード時間。	0.01
AvgBitrate	string	平均ビットレート。	2659.326
CostBandwidth	string	最大消費帯域幅。	100
Width	string	ビデオの幅。値は負でない数値でなければなりません。	640
Index	string	ビデオストリームのシーケンス番号。これは、メディアストリーム内でのビデオストリームの位置を示します。	5
Timebase	string	タイムベース。	1/15360
AvgFPS	string	平均フレームレート。	15.0
PixFmt	string	ピクセルフォーマット。	yuv420p
Lang	string	言語。詳細については、「FFmpeg 言語定義」をご参照ください。	und
CodecLongName	string	エンコード形式のフルネーム。	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10
NumFrames	string	総フレーム数。	12
Rotate	string	ビデオの回転角度。	90
Bitrate	string	ビットレート。	512.701
HasBFrames	string	B フレームが存在するかどうかを示します。1 は「はい」を、2 は「いいえ」を意味します。	2
Profile	string	コーデックプロファイル。	High
StartTime	string	開始時刻。	0.046029
Dar	string	表示アスペクト比 (DAR)。	16:9
CodecName	string	エンコード形式の短縮名。有効な値：H264、mov、aac、avc、mpeg。	H264
Duration	string	長さ。	79.200000
Fps	string	フレームレート。	15.0
CodecTag	string	エンコード形式のタグ。	0x31637661
CodecTimeBase	string	コーデックタイムベース。	1/30
Level	string	エンコードレベル。	31
AudioStreamList	object
AudioStream	array<object>	オーディオストリームのリスト。
	object	オーディオストリームデータ。
Timebase	string	タイムベース。	1/44100
Index	string	オーディオストリームのシーケンス番号。これは、メディアストリーム内でのオーディオストリームの位置を示します。	1
SampleFmt	string	サンプリングフォーマット。	fltp
ChannelLayout	string	サウンドチャンネルのレイアウト。	stereo
Lang	string	言語。詳細については、「FFmpeg 言語定義」をご参照ください。	und
Samplerate	string	サンプルレート。	44100
CodecLongName	string	エンコード形式のフルネーム。	AAC (Advanced Audio Coding)
Channels	string	サウンドチャンネル数。	2
NumFrames	string	総フレーム数。	100
Bitrate	string	ビットレート。	76.356
CodecTagString	string	エンコード形式のタグ。	mp4a
StartTime	string	開始時刻。	0.000000
CodecName	string	エンコード形式の短縮名。有効な値：H264、mov、aac、avc、mpeg。	aac
Duration	string	長さ。	79.203265
CodecTag	string	エンコード形式のタグ。	0x6134706d
CodecTimeBase	string	コーデックタイムベース。	1/44100
SubtitleStreamList	object
SubtitleStream	array<object>	字幕ストリームのリスト。
	object	字幕ストリームデータ。
Index	string	字幕ストリームのシーケンス番号。これは、メディアストリーム内での字幕ストリームの位置を示します。	1
Lang	string	言語。詳細については、「FFmpeg 言語定義」をご参照ください。	und
Format	object	フォーマット情報。
StartTime	string	開始時刻。	0.000000
NumPrograms	string	総プログラムストリーム数。	0
Size	string	サイズ。	5872904
NumStreams	string	総メディアストリーム数。	2
FormatLongName	string	エンコード形式のフルネーム。	QuickTime/MOV
Duration	string	長さ。	79.204000
Bitrate	string	ビットレート。	593.192
FormatName	string	コンテナフォーマットの短縮名。有効な値：mov、mp4、m4a、3gp、3g2、mj2。	mov
Description	string	説明。	This is description ****
Size	string	ファイルサイズ。	5872904
Width	string	幅。	640
CoverURL	string	OSS バケット内のサムネイルの URL。	http://example-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example-**.png
SnapshotList	object
Snapshot	array<object>	スナップショットのリスト。
	array<object>	スナップショットファイルの詳細。
Type	string	スナップショットのタイプ。有効な値： Single：単一のスナップショット。 Sequence：一連のスナップショット。	Single
MediaWorkflowId	string	スナップショットファイルを生成したワークフローの ID。	6cc3aa66d1cb4bb2adf14e726c0a****
ActivityName	string	スナップショットファイルを生成したワークフローアクティビティの名前。	example-activity1-****
Count	string	スナップショットの数。このパラメーターは、Type が Sequence に設定されている場合にのみ有効です。	3
MediaWorkflowName	string	スナップショットファイルを生成したワークフローの名前。	example-workflow-****
File	object	スナップショットファイル。
State	string	ファイルの状態。有効な値： Normal：ファイルは通常の状態です。 Deleted：ファイルは削除されました。	Normal
URL	string	OSS バケット内のスナップショットファイルの URL。	http://example1-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example111-**.png
RunIdList	object
RunId	array	メディアワークフローのリスト。
	string	メディアワークフロー ID のリスト。	9343bd0e7bb54ae19228529908e5****
Duration	string	長さ。	79.204000
Fps	string	フレームレート。	15.0
Title	string	タイトル。	kled.mp4
Format	string	エンコード形式。有効な値：mov、mp4、m4a、3gp、3g2、mj2。	mov
NonExistFileURLs	object
FileURL	array	存在しないメディアファイルに関する情報。
	string	存在しないメディアファイルの URL。データがない場合、このパラメーターは返されません。	null
RequestId	string	リクエスト ID。	1C8A0AEB-4321-485B-B4CB-DA4E9E6C9B42

例

成功レスポンス

JSONJSON

{
  "MediaList": {
    "Media": [
      {
        "CreationTime": "2021-07-14T13:05:00Z",
        "CateId": 123,
        "Height": "360",
        "CensorState": "Initiated",
        "Tags": {
          "Tag": [
            "tag1,tag2"
          ]
        },
        "PlayList": {
          "Play": [
            {
              "Encryption": "1",
              "Height": "10",
              "Bitrate": "25.067",
              "File": {
                "State": "Normal",
                "URL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4l-test/in/1.mp4"
              },
              "MediaWorkflowId": "6cc3aa66d1cb4bb2adf14e726c0a****",
              "Width": "11",
              "Size": "100",
              "Fps": "25.0",
              "Duration": "7.965000",
              "ActivityName": "test name",
              "Format": "mov",
              "MediaWorkflowName": "example-mediaworkflow-****"
            }
          ]
        },
        "Bitrate": "593.192",
        "MediaId": "52d7e98b05e648199612290bb819****",
        "File": {
          "State": "Normal",
          "URL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
        },
        "SummaryList": {
          "Summary": [
            {
              "Type": "Gif",
              "MediaWorkflowId": "93ab850b4f6f44eab54b6e91d24d****",
              "ActivityName": "example-activity-****",
              "MediaWorkflowName": "example-mediaworkflow-****",
              "File": {
                "State": "Normal",
                "URL": "http://example-bucket-****.o"
              }
            }
          ]
        },
        "PublishState": "Published",
        "MediaInfo": {
          "Streams": {
            "VideoStreamList": {
              "VideoStream": [
                {
                  "Sar": "1:1",
                  "Height": "360",
                  "CodecTagString": "avc1",
                  "NetworkCost": {
                    "PreloadTime": "0.01",
                    "AvgBitrate": "2659.326",
                    "CostBandwidth": "100"
                  },
                  "Width": "640",
                  "Index": "5",
                  "Timebase": "1/15360",
                  "AvgFPS": "15.0",
                  "PixFmt": "yuv420p",
                  "Lang": "und",
                  "CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
                  "NumFrames": "12",
                  "Rotate": "90",
                  "Bitrate": "512.701",
                  "HasBFrames": "2",
                  "Profile": "High",
                  "StartTime": "0.046029",
                  "Dar": "16:9",
                  "CodecName": "H264",
                  "Duration": "79.200000",
                  "Fps": "15.0",
                  "CodecTag": "0x31637661",
                  "CodecTimeBase": "1/30",
                  "Level": "31"
                }
              ]
            },
            "AudioStreamList": {
              "AudioStream": [
                {
                  "Timebase": "1/44100",
                  "Index": "1",
                  "SampleFmt": "fltp",
                  "ChannelLayout": "stereo",
                  "Lang": "und",
                  "Samplerate": "44100",
                  "CodecLongName": "AAC (Advanced Audio Coding)",
                  "Channels": "2",
                  "NumFrames": "100",
                  "Bitrate": "76.356",
                  "CodecTagString": "mp4a",
                  "StartTime": "0.000000",
                  "CodecName": "aac",
                  "Duration": "79.203265",
                  "CodecTag": "0x6134706d",
                  "CodecTimeBase": "1/44100"
                }
              ]
            },
            "SubtitleStreamList": {
              "SubtitleStream": [
                {
                  "Index": "1",
                  "Lang": "und"
                }
              ]
            }
          },
          "Format": {
            "StartTime": "0.000000",
            "NumPrograms": "0",
            "Size": "5872904",
            "NumStreams": "2",
            "FormatLongName": "QuickTime/MOV",
            "Duration": "79.204000",
            "Bitrate": "593.192",
            "FormatName": "mov"
          }
        },
        "Description": "This is description ****",
        "Size": "5872904",
        "Width": "640",
        "CoverURL": "http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png",
        "SnapshotList": {
          "Snapshot": [
            {
              "Type": "Single",
              "MediaWorkflowId": "6cc3aa66d1cb4bb2adf14e726c0a****",
              "ActivityName": "example-activity1-****",
              "Count": "3",
              "MediaWorkflowName": "example-workflow-****",
              "File": {
                "State": "Normal",
                "URL": "http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png"
              }
            }
          ]
        },
        "RunIdList": {
          "RunId": [
            "9343bd0e7bb54ae19228529908e5****"
          ]
        },
        "Duration": "79.204000",
        "Fps": "15.0",
        "Title": "kled.mp4",
        "Format": "mov"
      }
    ]
  },
  "NonExistFileURLs": {
    "FileURL": [
      "null"
    ]
  },
  "RequestId": "1C8A0AEB-4321-485B-B4CB-DA4E9E6C9B42"
}

エラーコード

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

変更履歴

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