QueryMediaList による ID でのメディアファイルの一括取得 - ApsaraVideo MPS

この操作を呼び出して、メディア ID に基づいてメディアファイルをクエリできます。

操作説明

一度に最大 10 個のメディアファイルをクエリできます。

QPS 制限

この操作のユーザーごとの 1 秒あたりのクエリ数 (QPS) 制限は 100 です。制限を超えると、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:QueryMediaList

get

*All Resource

*

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
MediaIds	string	必須	クエリ対象のメディアファイルの ID。メディア ID を取得するには、MPS コンソールにログインし、[メディア管理] > [メディアリスト] に移動します。複数の ID はコンマ (,) で区切ります。一度に最大 10 個のメディアファイルをクエリできます。	3e1cd21131a94525be55acf65888**,e26cfa29e784402388463f61dbec**
IncludePlayList	boolean	任意	レスポンスに再生情報を含めるかどうかを指定します。有効値：true および false。デフォルト値：false。	true
IncludeSnapshotList	boolean	任意	レスポンスにスナップショット情報を含めるかどうかを指定します。有効値：true および false。デフォルト値：false。	true
IncludeMediaInfo	boolean	任意	レスポンスにメディア情報を含めるかどうかを指定します。有効値：true および false。デフォルト値：false。	true
IncludeSummaryList	boolean	任意	レスポンスに概要を含めるかどうかを指定します。有効値：true および false。デフォルト値：false。	true

レスポンスフィールド

フィールド	型	説明	例
	object	返されるパラメーター。
NonExistMediaIds	object
MediaId	array	存在しないメディア ID のリスト。
	string	存在しないメディア ID。データが存在しない場合、このパラメーターは返されません。	{"MediaId":[e26cfa29e784402388463f61dbec****]}
MediaList	object
Media	array<object>	メディアファイルのリスト。
	array<object>	メディアファイルの詳細。
CreationTime	string	メディアファイルが作成された時刻。	2016-09-14T08:30:33Z
CateId	integer	カテゴリ ID。	1
Height	string	メディアファイルの高さ。	1080
CensorState	string	動画の審査状態。有効値： Initiated：動画はアップロードされましたが、審査は完了していません。 Pass：動画はアップロードされ、承認されました。	Initiated
Tags	object
Tag	array	タグ情報。
	string	タグのリスト。	tag1,tag2
PlayList	object
Play	array<object>	再生リスト。
	array<object>	再生ファイルの詳細。
Encryption	string	暗号化ステータス。有効値： 0：ファイルは暗号化されていません。 1：ファイルは暗号化されています。	0
Height	string	高さ。	1080
Bitrate	string	ビットレート。	2659.326
File	object	再生ファイル。
State	string	ファイルの状態。有効値： Normal：ファイルは正常です。 Deleted：ファイルは削除されました。	Normal
URL	string	出力ファイルの OSS バケット。	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4
MediaWorkflowId	string	再生ファイルを生成するワークフローの ID。	93ab850b4f6f44eab54b6e91d24d****
Width	string	メディアファイルの幅。	760
Size	string	ファイルサイズ。	2647692
Fps	string	フレームレート。	25.0
Duration	string	デュレーション。	7.965000
ActivityName	string	メディアワークフローアクティビティの名前。	example-activity-****
Format	string	エンコード形式。有効値：mov、mp4、m4a、3gp、3g2、および mj2。	mp4
MediaWorkflowName	string	再生ファイルを生成するワークフロー。	example-mediaworkflow-****
Bitrate	string	ビットレート。	2659.326
MediaId	string	メディア ID。	3e1cd21131a94525be55acf65888****
File	object	入力ファイルの詳細。
State	string	状態。有効値： Normal：ファイルは正常です。 Deleted：ファイルは削除されました。	Normal
URL	string	入力ファイルの OSS バケット。	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4
SummaryList	object
Summary	array<object>	ビデオシノプシスのリスト。
	array<object>	ビデオシノプシスデータ。
Type	string	概要タイプ。有効値： Video：ビデオ。 Gif：GIF。	Video
MediaWorkflowId	string	概要を生成するワークフローの ID。	93ab850b4f6f44eab54b6e91d24d****
ActivityName	string	メディアワークフローアクティビティの名前。	example-activity-****
MediaWorkflowName	string	概要を生成するワークフローの名前。	example-mediaworkflow-****
File	object	入力ファイルに関する情報。
State	string	ファイルの状態。有効値： Normal：ファイルは正常です。 Deleted：ファイルは削除されました。	Normal
URL	string	入力ファイルの OSS バケット。	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4
PublishState	string	メディアファイルの公開状態。これはメディアファイルが公開されているかどうかを示します。有効値： Initiated：初期状態。 UnPublish：メディアファイルは公開されていません。OSS 再生ファイルの権限は Private です。 Published：メディアファイルは公開されています。OSS 再生ファイルの権限は Default です。 Deleted：メディアファイルは削除されました。	Published
MediaInfo	object	メディア情報。
Streams	object	ストリーム情報。
VideoStreamList	object
VideoStream	array<object>	ビデオストリームのリスト。
	array<object>	ビデオストリームデータ。
Sar	string	サンプルアスペクト比 (SAR)。	1:1
Height	string	ビデオの高さ。	1080
CodecTagString	string	エンコード形式のタグ。	avc1
NetworkCost	object	ネットワーク帯域幅の消費。
PreloadTime	string	プリロード時間。	0.01
AvgBitrate	string	平均ビットレート。	2659.326
CostBandwidth	string	消費された最大帯域幅。	100
Width	string	ビデオの幅。	100
Index	string	ビデオストリームのシーケンス番号。これは、メディアストリーム内のビデオストリームの位置を示します。	5
Timebase	string	タイムベース。	1/30000
AvgFPS	string	平均フレームレート。	29.97003
PixFmt	string	ピクセルフォーマット。	yuv420p
Lang	string	言語。詳細については、「FFmpeg 言語定義」をご参照ください。	und
CodecLongName	string	エンコード形式の長い名前。	QuickTime/MOV
NumFrames	string	フレームの総数。	12
Rotate	string	ビデオの回転角度。	90
Bitrate	string	ビットレート。	2659.326
HasBFrames	string	B フレームが存在するかどうかを示します。1：はい。2：いいえ。	2
Profile	string	コーデックプロファイル。	High
StartTime	string	開始時刻。	0.000000
Dar	string	アスペクト比の表示 (DAR)。	16:9
CodecName	string	エンコード形式の短い名前。有効値：mov、mp4、m4a、3gp、3g2、および mj2。	mov
Duration	string	デュレーション。	182.683000
Fps	string	フレームレート。	29.97003
CodecTag	string	エンコード形式のタグ。	0x31637661
CodecTimeBase	string	コーデックタイムベース。	1001/60000
Level	string	エンコーディングレベル。	40
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	ビットレート。	160.008
CodecTagString	string	エンコード形式のタグ。	mp4a
StartTime	string	開始時刻。	0.000000
CodecName	string	エンコード形式の短い名前。有効値：H264、mov、aac、avc、および mpeg。	mov
Duration	string	デュレーション。	182.591995
CodecTag	string	エンコード形式のタグ。	0x6134706d
CodecTimeBase	string	コーデックタイムベース。	1/44100
SubtitleStreamList	object
SubtitleStream	array<object>	字幕ストリームのリスト。
	object	字幕ストリームデータ。
Index	string	字幕ストリームのシーケンス番号。これは、メディアストリーム内の字幕ストリームの位置を示します。	3
Lang	string	言語。詳細については、「FFmpeg 言語定義」をご参照ください。	und
Format	object	フォーマット情報。
StartTime	string	開始時刻。	0.000000
NumPrograms	string	プログラムストリームの総数。	2
Size	string	ファイルサイズ。	2647692
NumStreams	string	メディアストリームの総数。	2
FormatLongName	string	コンテナフォーマットの長い名前。	QuickTime/MOV
Duration	string	合計デュレーション。	7.965000
Bitrate	string	ビットレート。	2659.326
FormatName	string	コンテナフォーマットの短い名前。有効値：mov、mp4、m4a、3gp、3g2、および mj2。	mov
Description	string	説明。	This is description ****
Size	string	ファイルサイズ。	2647692
Width	string	幅。	1920
CoverURL	string	サムネイルの OSS バケット。	http://example-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example-**.png
SnapshotList	object
Snapshot	array<object>	スナップショットのリスト。
	array<object>	スナップショットファイルデータ。
Type	string	スナップショットタイプ。有効値： Single：単一のスナップショット。 Sequence：一連のスナップショット。	Sequence
MediaWorkflowId	string	スナップショットファイルを生成するワークフローの ID。	6cc3aa66d1cb4bb2adf14e726c0a****
ActivityName	string	スナップショットファイルを生成するワークフローアクティビティの名前。	example-activity1-****
Count	string	スナップショットの数。このパラメーターは、Type が Sequence に設定されている場合にのみ有効です。	5
MediaWorkflowName	string	スナップショットファイルを生成するワークフロー。	example-workflow-****
File	object	スナップショットファイル。
State	string	ファイルの状態。有効値： Normal：ファイルは正常です。 Deleted：ファイルは削除されました。	Normal
URL	string	スナップショットファイルの OSS バケット。	http://example1-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example111-**.png
RunIdList	object
RunId	array	インスタンスのリスト。
	string	インスタンス ID。	{"RunId":["47b42486019c4f688bf144c1a6ba****"]}
Duration	string	デュレーション。	7.965000
Fps	string	フレームレート。	25.0
Title	string	タイトル。	example-title-****
Format	string	エンコード形式。有効値：mov、mp4、m4a、3gp、3g2、および mj2。	mov
RequestId	string	リクエスト ID。	283DC68C-146F-4489-A2A1-2F88F1472A56

例

成功レスポンス

JSONJSON

{
  "NonExistMediaIds": {
    "MediaId": [
      "{\"MediaId\":[e26cfa29e784402388463f61dbec****]}"
    ]
  },
  "MediaList": {
    "Media": [
      {
        "CreationTime": "2016-09-14T08:30:33Z",
        "CateId": 1,
        "Height": "1080",
        "CensorState": "Initiated",
        "Tags": {
          "Tag": [
            "tag1,tag2"
          ]
        },
        "PlayList": {
          "Play": [
            {
              "Encryption": "0",
              "Height": "1080",
              "Bitrate": "2659.326",
              "File": {
                "State": "Normal",
                "URL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
              },
              "MediaWorkflowId": "93ab850b4f6f44eab54b6e91d24d****",
              "Width": "760",
              "Size": "2647692",
              "Fps": "25.0",
              "Duration": "7.965000",
              "ActivityName": "example-activity-****",
              "Format": "mp4",
              "MediaWorkflowName": "example-mediaworkflow-****"
            }
          ]
        },
        "Bitrate": "2659.326",
        "MediaId": "3e1cd21131a94525be55acf65888****",
        "File": {
          "State": "Normal",
          "URL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
        },
        "SummaryList": {
          "Summary": [
            {
              "Type": "Video",
              "MediaWorkflowId": "93ab850b4f6f44eab54b6e91d24d****",
              "ActivityName": "example-activity-****",
              "MediaWorkflowName": "example-mediaworkflow-****",
              "File": {
                "State": "Normal",
                "URL": "http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
              }
            }
          ]
        },
        "PublishState": "Published",
        "MediaInfo": {
          "Streams": {
            "VideoStreamList": {
              "VideoStream": [
                {
                  "Sar": "1:1",
                  "Height": "1080",
                  "CodecTagString": "avc1",
                  "NetworkCost": {
                    "PreloadTime": "0.01",
                    "AvgBitrate": "2659.326",
                    "CostBandwidth": "100"
                  },
                  "Width": "100",
                  "Index": "5",
                  "Timebase": "1/30000",
                  "AvgFPS": "29.97003",
                  "PixFmt": "yuv420p",
                  "Lang": "und",
                  "CodecLongName": "QuickTime/MOV",
                  "NumFrames": "12",
                  "Rotate": "90",
                  "Bitrate": "2659.326",
                  "HasBFrames": "2",
                  "Profile": "High",
                  "StartTime": "0.000000",
                  "Dar": "16:9",
                  "CodecName": "mov",
                  "Duration": "182.683000",
                  "Fps": "29.97003",
                  "CodecTag": "0x31637661",
                  "CodecTimeBase": "1001/60000",
                  "Level": "40"
                }
              ]
            },
            "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": "160.008",
                  "CodecTagString": "mp4a",
                  "StartTime": "0.000000",
                  "CodecName": "mov",
                  "Duration": "182.591995",
                  "CodecTag": "0x6134706d",
                  "CodecTimeBase": "1/44100"
                }
              ]
            },
            "SubtitleStreamList": {
              "SubtitleStream": [
                {
                  "Index": "3",
                  "Lang": "und"
                }
              ]
            }
          },
          "Format": {
            "StartTime": "0.000000",
            "NumPrograms": "2",
            "Size": "2647692",
            "NumStreams": "2",
            "FormatLongName": "QuickTime/MOV",
            "Duration": "7.965000",
            "Bitrate": "2659.326",
            "FormatName": "mov"
          }
        },
        "Description": "This is description ****",
        "Size": "2647692",
        "Width": "1920",
        "CoverURL": "http://example-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example-****.png",
        "SnapshotList": {
          "Snapshot": [
            {
              "Type": "Sequence",
              "MediaWorkflowId": "6cc3aa66d1cb4bb2adf14e726c0a****",
              "ActivityName": "example-activity1-****",
              "Count": "5",
              "MediaWorkflowName": "example-workflow-****",
              "File": {
                "State": "Normal",
                "URL": "http://example1-bucket1-****.oss-cn-hangzhou.aliyuncs.com//example111-****.png"
              }
            }
          ]
        },
        "RunIdList": {
          "RunId": [
            "{\"RunId\":[\"47b42486019c4f688bf144c1a6ba****\"]}"
          ]
        },
        "Duration": "7.965000",
        "Fps": "25.0",
        "Title": "example-title-****",
        "Format": "mov"
      }
    ]
  },
  "RequestId": "283DC68C-146F-4489-A2A1-2F88F1472A56"
}

エラーコード

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

変更履歴

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