メディアファイルIDに基づいてメディアファイルを照会します。
使用上の注意
この操作では、一度に最大10個のメディアファイルを照会できます。
QPS制限
この操作は、アカウントごとに1秒あたり最大100回呼び出すことができます。 1秒あたりの呼び出し数が制限を超えると、スロットリングがトリガーされます。 その結果、あなたのビジネスが影響を受ける可能性があります。 この操作を呼び出すときは、制限に注意することをお勧めします。 詳細については、「QPS制限」をご参照ください。
デバッグ
リクエストパラメーター
| パラメーター | データ型 | 必須/任意 | 例 | 説明 |
| 操作 | String | 必須 | QueryMediaList | 実行する操作です。 値をQueryMediaListに設定します。 |
| MediaId | String | 必須 | 3e1cd21131a94525be55acf65888 ****,e26cfa29e784402388463f61dbec **** | メディアファイルのID。 メディアファイルのIDを取得するには、ApsaraVideo media Processing (MPS) コンソールで次の操作を実行します。左側のナビゲーションウィンドウで、[メディア管理] > [メディアリスト] を選択します。 必要なビデオを見つけて [管理] をクリックします。 ビデオのIDが [基本] タブに表示されます。 ID が複数ある場合は、カンマ (,) で区切ります。 You can query up to 10 media files at a time. |
| IncludePlayList | Boolean | 任意 | true | 返された結果に再生情報を含めるかどうかを指定します。
|
| IncludeSnapshotList | Boolean | 任意 | true | 返される結果にスナップショット情報を含めるかどうかを指定します。
|
| IncludeMediaInfo | Boolean | 任意 | true | 返される結果にメディア情報を含めるかどうかを指定します。
|
| IncludeSummaryList | Boolean | 任意 | true | 返される結果にサマリを含めるかどうかを指定します。
|
レスポンスパラメーター
| パラメーター | データ型 | 例 | 説明 |
| NonExistMediaIds | 文字列の配列 | {"MediaId":[e26cfa29e784402388463f61dbec ****]} | 存在しないメディアファイルのID。 指定されたすべてのメディアファイルが存在する場合、このパラメーターは返されません。 |
| MediaList | メディアの配列 | メディアファイルのリスト。 |
|
| メディア | |||
| CreationTime | String | 2016-09-14T08:30:33Z | メディアファイルが作成された時刻。 |
| CateId | Long | 1 | メディアファイルが属するカテゴリのID。 |
| Height | String | 1080 | メディアファイルの高さ。 |
| CensorState | String | 開始済み | メディアファイルのレビューステータス。 設定可能な値は以下のとおりです。
|
| タグ | Array of String | tag1,tag2 | メディアファイルのタグ。 |
| プレイリスト | プレイの配列 | プレイリスト。 |
|
| ストリーミング開始 | |||
| Encryption | String | 0 | メディアファイルが暗号化されているかどうかを示します。 設定可能な値は以下のとおりです。
|
| Height | String | 1080 | 高さ。 |
| ビットレート | String | 2659.326 | メディアファイルのビットレート。 |
| File | オブジェクト | 再生ファイル。 |
|
| ステータス | String | 通常 | ファイルのステータス。 設定可能な値は以下のとおりです。
|
| URL | String | http:// example-bucket-**** .oss-cn-hangzhou.aliyuncs.com//example-****.mp4 | 出力ファイルのObject Storage Service (OSS) URL。 |
| MediaWorkflowId | String | 93ab850b4f6f44eab54b6e91d24d **** | 再生ファイルを生成するワークフローのID。 |
| 幅 | String | 760 | メディアファイルの幅。 |
| Size | String | 2647692 | The size of the media file. |
| FPS | String | 25.0 | メディアファイルのフレームレート。 |
| 有効期間 | String | 7.965000 | メディアファイルの長さ。 |
| ActivityName | String | 例-アクティビティ-**** | ワークフローアクティビティの名前。 |
| 形式 | String | mp4 | メディアファイルのエンコード形式。 有効な値: mov、mp4、m4a、3gp、3g2、およびmj2。 |
| MediaWorkflowName | String | 例-mediaworkflow-**** | 再生ファイルを生成するワークフローの名前。 |
| ビットレート | String | 2659.326 | ビットレート。 |
| MediaId | String | 3e1cd21131a94525be55acf65888 **** | メディアファイルのID。 |
| File | オブジェクト | 入力ファイルの詳細。 |
|
| ステータス | String | 通常 | 入力ファイルのステータス。 設定可能な値は以下のとおりです。
|
| URL | String | http:// example-bucket-**** .oss-cn-hangzhou.aliyuncs.com//example-****.mp4 | 入力ファイルのOSS URL。 |
| SummaryList | サマリーの配列 | ビデオ概要のリスト。 |
|
| 要約 | |||
| データ型 | String | ビデオ | The type of the summary. 設定可能な値は以下のとおりです。
|
| MediaWorkflowId | String | 93ab850b4f6f44eab54b6e91d24d **** | The ID of the workflow that generates the summary. |
| ActivityName | String | 例-アクティビティ-**** | ワークフローアクティビティの名前。 |
| MediaWorkflowName | String | 例-mediaworkflow-**** | サマリーを生成するワークフローの名前。 |
| File | オブジェクト | 入力ファイルに関する情報。 |
|
| ステータス | String | 通常 | The status of the file. 設定可能な値は以下のとおりです。
|
| URL | String | http:// example-bucket-**** .oss-cn-hangzhou.aliyuncs.com//example-****.mp4 | The OSS URL of the input file. |
| PublishState | String | Published | メディアファイルの公開ステータス。 設定可能な値は以下のとおりです。
|
| MediaInfo | オブジェクト | メディア情報。 |
|
| ストリーム | オブジェクト | ストリーム情報。 |
|
| VideoStreamList | VideoStreamの配列 | ビデオストリームのリスト。 |
|
| VideoStream | |||
| サー | String | 1:1 | サンプルアスペクト比 (SAR) 。 |
| Height | String | 1080 | ビデオ解像度の後者の番号。 数字はビデオの高さを示します。 |
| CodecTagString | String | avc1 | エンコード形式のタグ文字列。 |
| NetworkCost | オブジェクト | ネットワーク帯域幅の消費。 |
|
| PreloadTime | String | 0.01 | プリロード時間の長さ。 |
| AvgBitrate | String | 2659.326 | The average bitrate. |
| CostBandwidth | String | 100 | 消費された最大帯域幅。 |
| 幅 | String | 100 | ビデオ解像度の元の番号。 数字はビデオの幅を示します。 |
| Index | String | 5 | ビデオストリームのシーケンス番号。 値は、すべてのビデオストリームにおけるビデオストリームの位置を示します。 |
| タイムベース | String | 1/30000 | タイムベース。 |
| AvgFPS | String | 29.97003 | 平均フレームレート。 |
| PixFmt | String | yuv420p | ピクセル形式。 |
| Lang | String | und | 言語。 詳細については、「FFmpegドキュメント」をご参照ください。 |
| CodecLongName | String | QuickTime/MOV | エンコード形式のフルネーム。 |
| NumFrames | String | 12 | フレームの総数。 |
| Rotate | String | 90 | ビデオの回転角度。 |
| ビットレート | String | 2659.326 | ビットレート。 |
| HasBFrames | String | 2 | ビデオストリームに双方向フレーム (Bフレーム) が含まれているかどうかを示します。 1の値は、ビデオストリームがBフレームを含むことを示す。 2の値は、ビデオストリームがBフレームを含まないことを示す。 |
| プロファイル | String | High | コーデックプロファイル。 |
| StartTime | String | 0.000000 | 開始時刻。 |
| ダール | String | 16:9 | ディスプレイアスペクト比 (DAR) 。 |
| CodecName | String | mov | エンコード形式の短い名前。 有効な値: mov、mp4、m4a、3gp、3g2、およびmj2。 |
| 有効期間 | String | 182.683000 | 期間です。 |
| FPS | String | 29.97003 | フレームレート。 |
| CodecTag | String | 0x31637661 | エンコード形式のタグ。 |
| CodecTimeBase | String | 1001/60000 | コーデックのタイムベース。 |
| Level | String | 40 | コーデックのレベル。 |
| AudioStreamList | AudioStreamの配列 | オーディオストリームのリスト。 |
|
| AudioStream | |||
| タイムベース | String | 1/44100 | タイムベース。 |
| Index | String | 1 | オーディオストリームのシーケンス番号。 値は、すべてのオーディオストリームにおけるオーディオストリームの位置を示します。 |
| SampleFmt | String | fltp | サンプリング形式。 |
| ChannelLayout | String | ステレオ | サウンドチャンネルの出力レイアウト。 |
| Lang | String | und | 言語。 詳細については、「FFmpegドキュメント」をご参照ください。 |
| Samplerate | String | 44100 | サンプリングレート。 |
| CodecLongName | String | AAC (高度なオーディオコーディング) | エンコード形式のフルネーム。 |
| Channels | String | 2 | サウンドチャンネルの数。 |
| NumFrames | String | 100 | フレームの総数。 |
| ビットレート | String | 160.008 | ビットレート。 |
| CodecTagString | String | mp4a | エンコード形式のタグ文字列。 |
| StartTime | String | 0.000000 | 開始時刻。 |
| CodecName | String | mov | エンコード形式の短い名前。 有効な値: H264、mov、aac、avc、およびmpeg。 |
| 有効期間 | String | 182.591995 | 期間です。 |
| CodecTag | String | 0x6134706d | エンコード形式のタグ。 |
| CodecTimeBase | String | 1/44100 | コーデックのタイムベース。 |
| SubtitleStreamList | SubtitleStreamの配列 | 字幕ストリームのリスト。 |
|
| SubtitleStream | |||
| Index | String | 3 | 字幕ストリームのシーケンス番号。 この値は、全ての字幕ストリームにおける字幕ストリームの位置を示す。 |
| Lang | String | und | 言語。 詳細については、「FFmpegドキュメント」をご参照ください。 |
| 形式 | オブジェクト | フォーマット情報。 |
|
| StartTime | String | 0.000000 | 開始時刻。 |
| NumPrograms | String | 2 | プログラムストリームの総数。 |
| Size | String | 2647692 | ファイルのサイズ。 |
| NumStreams | String | 2 | メディアストリームの総数。 |
| FormatLongName | String | QuickTime/MOV | コンテナー形式のフルネーム。 |
| 有効期間 | String | 7.965000 | 合計期間。 |
| ビットレート | String | 2659.326 | ビットレート。 |
| FormatName | String | mov | コンテナー形式の短い名前。The short name of the container format. 有効な値: mov、mp4、m4a、3gp、3g2、およびmj2。 |
| 説明 | String | This is description **** | 説明 |
| Size | String | 2647692 | ファイルのサイズ。 |
| 幅 | String | 1920 | 幅。 |
| CoverURL | String | http:// example-bucket1-**** .oss-cn-hangzhou.aliyuncs.com//example-****.png | サムネイルのOSS URL。 |
| SnapshotList | スナップショットの配列 | スナップショットのリスト。 |
|
| スナップショット | |||
| データ型 | String | シーケンス | スナップショットのタイプ。 設定可能な値は以下のとおりです。
|
| MediaWorkflowId | String | 6cc3aa66d1cb4bb2adf14e726c0a **** | スナップショットを生成するワークフローのID。 |
| ActivityName | String | example-activity1-**** | スナップショットを生成するワークフローアクティビティの名前。 |
| Count | String | 5 | スナップショットの数。 このパラメーターは、Typeパラメーターの値がSequenceの場合にのみ有効です。 |
| MediaWorkflowName | String | 例-ワークフロー-**** | スナップショットを生成するワークフローの名前。 |
| File | オブジェクト | スナップショット。 |
|
| ステータス | String | 通常 | ファイルのステータス。 設定可能な値は以下のとおりです。
|
| URL | String | http:// example1-bucket1-**** .oss-cn-hangzhou.aliyuncs.com//example111-****.png | スナップショットのOSS URL。 |
| RunIdList | 文字列の配列 | null | インスタンスの ID。 |
| 有効期間 | String | 7.965000 | 期間です。 |
| FPS | String | 25.0 | フレームレート。 |
| タイトル | String | 例-タイトル-**** | タイトル。 |
| 形式 | String | mov | エンコード形式。 有効な値: mov、mp4、m4a、3gp、3g2、およびmj2。 |
| RequestId | String | 283DC68C-146F-4489-A2A1-2F88F1472A56 | リクエストの ID です。 |
例
リクエストの例
http(s):// mts.cn-shanghai.aliyuncs.com/?Action=AddMedia
&MediaIds=3e1cd21131a94525be55acf65888 ****,e26cfa29e784402388463f61dbec ****
&IncludePlayList=true
&IncludeSnapshotList=true
&IncludeMediaInfo=true
&IncludeSummaryList=true
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML 形式
HTTP/1.1 200 OK
Content-Type:application/xml
<QueryMediaListResponse>
<NonExistMediaIds>{"MediaId":[e26cfa29e784402388463f61dbec ****]}</NonExistMediaIds>
<MediaList>
<CreationTime>2016-09-14T08:30:33Z</CreationTime>
<CateId>1</CateId>
<高さ> 1080</高さ>
<CensorState> 開始 </CensorState>
<タグ> tag1、tag2</タグ>
<プレイリスト>
<暗号化> 0</暗号化>
<高さ> 1080</高さ>
<Bitrate>2659.326</Bitrate>
<ファイル>
<状態> 通常 </状態>
<URL>http:// example-bucket-**** .oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
</ファイル>
<MediaWorkflowId>93ab850b4f6f44eab54b6e91d24d ****</MediaWorkflowId>
<Width>760</Width>
<サイズ> 2647692</サイズ>
<Fps>25.0</Fps>
<期間> 7.965000</期間>
<ActivityName>example-activity-****</ActivityName>
<フォーマット> mp4</フォーマット>
<MediaWorkflowName>example-mediaworkflow-****</MediaWorkflowName>
</プレイリスト>
<Bitrate>2659.326</Bitrate>
<MediaId>3e1cd21131a94525be55acf65888 ****</MediaId>
<ファイル>
<状態> 通常 </状態>
<URL>http:// example-bucket-**** .oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
</ファイル>
<SummaryList>
<タイプ> ビデオ </タイプ>
<MediaWorkflowId>93ab850b4f6f44eab54b6e91d24d ****</MediaWorkflowId>
<ActivityName>example-activity-****</ActivityName>
<MediaWorkflowName>example-mediaworkflow-****</MediaWorkflowName>
<ファイル>
<状態> 通常 </状態>
<URL>http:// example-bucket-**** .oss-cn-hangzhou.aliyuncs.com//example-****.mp4</URL>
</ファイル>
</SummaryList>
<PublishState>Published</PublishState>
<MediaInfo>
<ストリーム>
<VideoStreamList>
<Sar>1:1</Sar>
<高さ> 1080</高さ>
<CodecTagString>avc1</CodecTagString>
<NetworkCost>
<PreloadTime>0.01</PreloadTime>
<AvgBitrate>2659.326</AvgBitrate>
<CostBandwidth>100</CostBandwidth>
</NetworkCost>
<Width>100</Width>
<Index>5</Index>
<Timebase>1/30000</Timebase>
<AvgFPS>29.97003</AvgFPS>
<PixFmt>yuv420p</PixFmt>
<ラング> und</ラング>
<CodecLongName>QuickTime/MOV</CodecLongName>
<NumFrames>12</NumFrames>
<回転> 90</回転>
<Bitrate>2659.326</Bitrate>
<HasBFrames>2</HasBFrames>
<プロファイル> 高 </プロファイル>
<StartTime>0.000000</StartTime>
<ダル> 16:9</ダル>
<CodecName>mov</CodecName>
<期間> 182.683000</期間>
<Fps>29.97003</Fps>
<CodecTag>0x31637661</CodecTag>
<CodecTimeBase>1001/60000</CodecTimeBase>
<レベル> 40</レベル>
</VideoStreamList>
<AudioStreamList>
<Timebase>1/44100</Timebase>
<Index>1</Index>
<SampleFmt>fltp</SampleFmt>
<ChannelLayout> ステレオ </ChannelLayout>
<ラング> und</ラング>
<Samplerate>44100</Samplerate>
<CodecLongName>AAC(Advanced Audio Coding)</CodecLongName>
<チャンネル> 2</チャンネル>
<NumFrames>100</NumFrames>
<Bitrate>160.008</Bitrate>
<CodecTagString>mp4a</CodecTagString>
<StartTime>0.000000</StartTime>
<CodecName>mov</CodecName>
<期間> 182.591995</期間>
<CodecTag>0x6134706d</CodecTag>
<CodecTimeBase>1/44100</CodecTimeBase>
</AudioStreamList>
<SubtitleStreamList>
<Index>3</Index>
<ラング> und</ラング>
</SubtitleStreamList>
</ストリーム>
<形式>
<StartTime>0.000000</StartTime>
<NumPrograms>2</NumPrograms>
<サイズ> 2647692</サイズ>
<NumStreams>2</NumStreams>
<FormatLongName>QuickTime/MOV</FormatLongName>
<期間> 7.965000</期間>
<Bitrate>2659.326</Bitrate>
<FormatName>mov</FormatName>
</フォーマット>
</MediaInfo>
<説明> これはdescirption **** です </Description>
<サイズ> 2647692</サイズ>
<Width>1920</Width>
<CoverURL>http:// example-bucket1-**** .oss-cn-hangzhou.aliyuncs.com//example-****.png</CoverURL>
<SnapshotList>
<タイプ> シーケンス </タイプ>
<MediaWorkflowId>6cc3aa66d1cb4bb2adf14e726c0a ****</MediaWorkflowId>
<ActivityName>example-activity1-****</ActivityName>
<カウント> 5</カウント>
<MediaWorkflowName>example-workflow-****</MediaWorkflowName>
<ファイル>
<状態> 通常 </状態>
<URL>http:// example1-bucket1-**** .oss-cn-hangzhou.aliyuncs.com//example111-****.png</URL>
</ファイル>
</SnapshotList>
<RunIdList>{"RunId":["47b42486019c4f688bf144c1a6ba ****"]}</RunIdList>
<期間> 7.965000</期間>
<Fps>25.0</Fps>
<Title>example-title-****</Title>
<フォーマット> mov</フォーマット>
</MediaList>
<RequestId>283DC68C-146F-4489-A2A1-2F88F1472A56</RequestId>
</QueryMediaListResponse>
JSON 形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"NonExistMediaIds": [ "{\" MediaId\":[e26cfa29e784402388463f61dbec ****]}"] 、
"MediaList" : [ {
"CreationTime" : "2016-09-14T08:30:33Z" 、
"CateId" : 1、
"高さ" : "1080" 、
"CensorState" : "Initiated" 、
"タグ" : [ "tag1、tag2"] 、
"プレイリスト" : [ {
"暗号化" : "0" 、
"高さ" : "1080" 、
"ビットレート" : "2659.326" 、
"ファイル" : {
"状態" : "ノーマル" 、
"URL" : "http:// example-bucket-**** .oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
},
"MediaWorkflowId" : "93ab850b4f6f44eab54b6e91d24d ****" 、
"幅" : "760" 、
"サイズ" : "2647692" 、
"Fps" : "25.0" 、
"期間" : "7.965000" 、
"ActivityName" : "example-activity-****" 、
"フォーマット" : "mp4" 、
"MediaWorkflowName" : "example-mediaworkflow-****"
} ],
"ビットレート" : "2659.326" 、
"MediaId" : "3e1cd21131a94525be55acf65888 ****" 、
"ファイル" : {
"状態" : "ノーマル" 、
"URL" : "http:// example-bucket-**** .oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
},
"SummaryList" : [ {
"タイプ" : "ビデオ" 、
"MediaWorkflowId" : "93ab850b4f6f44eab54b6e91d24d ****" 、
"ActivityName" : "example-activity-****" 、
"MediaWorkflowName" : "example-mediaworkflow-****" 、
"ファイル" : {
"状態" : "ノーマル" 、
"URL" : "http:// example-bucket-**** .oss-cn-hangzhou.aliyuncs.com//example-****.mp4"
}
} ],
"PublishState" : "Published" 、
"MediaInfo" : {
"ストリーム" : {
"VideoStreamList" : [ {
"Sar" : "1:1" 、
"高さ" : "1080" 、
"CodecTagString" : "avc1" 、
"NetworkCost" : {
"PreloadTime" : "0.01" 、
"AvgBitrate" : "2659.326" 、
"CostBandwidth" : "100"
},
"幅" : "100" 、
"インデックス" : "5" 、
"Timebase" : "1/30000" 、
"AvgFPS" : "29.97003" 、
"PixFmt" : "yuv420p" 、
"ラング" : "und" 、
"CodecLongName" : "QuickTime/MOV" 、
"NumFrames" : "12" 、
"Rotate" : "90" 、
"ビットレート" : "2659.326" 、
"HasBFrames" : "2" 、
"プロファイル" : "高" 、
"StartTime" : "0.000000" 、
"ダール" : "16:9" 、
"CodecName" : "mov" 、
"期間" : "182.683000" 、
"Fps" : "29.97003" 、
"CodecTag" : "0x31637661" 、
"CodecTimeBase" : "1001/60000" 、
"レベル" : "40"
} ],
"AudioStreamList" : [ {
"Timebase" : "1/44100" 、
"Index" : "1" 、
"SampleFmt" : "fltp" 、
"ChannelLayout" : "ステレオ" 、
"ラング" : "und" 、
"Samplerate" : "44100" 、
"CodecLongName" : "AAC (高度なオーディオコーディング)" 、
"チャンネル" : "2" 、
"NumFrames" : "100" 、
"ビットレート" : "160.008" 、
"CodecTagString" : "mp4a" 、
"StartTime" : "0.000000" 、
"CodecName" : "mov" 、
"期間" : "182.591995" 、
"CodecTag" : "0x6134706d" 、
"CodecTimeBase" : "1/44100"
} ],
"SubtitleStreamList" : [ {
"インデックス" : "3" 、
"ラング" : "und"
} ]
},
"Format" : {
"StartTime" : "0.000000" 、
"NumPrograms" : "2" 、
"サイズ" : "2647692" 、
"NumStreams" : "2" 、
"FormatLongName" : "QuickTime/MOV" 、
"期間" : "7.965000" 、
"ビットレート" : "2659.326" 、
"FormatName" : "mov"
}
},
"説明" : "これはdescirption **** です" 、
"サイズ" : "2647692" 、
"幅" : "1920" 、
"CoverURL" : "http:// example-bucket1-**** .oss-cn-hangzhou.aliyuncs.com//example-****.png" 、
"SnapshotList" : [ {
"タイプ" : "シーケンス" 、
"MediaWorkflowId" : "6cc3aa66d1cb4bb2adf14e726c0a ****" 、
"ActivityName" : "example-activity1-****" 、
"カウント" : "5" 、
"MediaWorkflowName" : "example-workflow-****" 、
"ファイル" : {
"状態" : "ノーマル" 、
"URL" : "http:// example1-bucket1-**** .oss-cn-hangzhou.aliyuncs.com//example111-****.png"
}
} ],
"RunIdList": [ "{\" RunId\":[\" 47b42486019c4f688bf144c1a6ba ****\"]}"] 、
"期間" : "7.965000" 、
"Fps" : "25.0" 、
"タイトル" : "example-Title-****" 、
"フォーマット" : "mov"
} ],
"RequestId" : "283DC68C-146F-4489-A2A1-2F88F1472A56"
}
エラーコード
エラーコードリストについては、「API エラーセンター」をご参照ください。