すべてのプロダクト
Search
ドキュメントセンター

:QueryMediaList

最終更新日:May 08, 2025

メディアファイルIDに基づいてメディアファイルを照会します。

使用上の注意

この操作では、一度に最大10個のメディアファイルを照会できます。

QPS制限

この操作は、アカウントごとに1秒あたり最大100回呼び出すことができます。 1秒あたりの呼び出し数が制限を超えると、スロットリングがトリガーされます。 その結果、あなたのビジネスが影響を受ける可能性があります。 この操作を呼び出すときは、制限に注意することをお勧めします。 詳細については、「QPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 例 説明
操作 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

返された結果に再生情報を含めるかどうかを指定します。

  • 有効な値は、true および false です。
  • デフォルト値は、 false です。
IncludeSnapshotList Boolean 任意 true

返される結果にスナップショット情報を含めるかどうかを指定します。

  • 有効な値は、true および false です。
  • デフォルト値は、 false です。
IncludeMediaInfo Boolean 任意 true

返される結果にメディア情報を含めるかどうかを指定します。

  • 有効な値は、true および false です。
  • デフォルト値は、 false です。
IncludeSummaryList Boolean 任意 true

返される結果にサマリを含めるかどうかを指定します。

  • 有効な値は、true および false です。
  • デフォルト値は、 false です。

レスポンスパラメーター

パラメーター データ型 例 説明
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

メディアファイルが暗号化されているかどうかを示します。 設定可能な値は以下のとおりです。

  • 0: メディアファイルは暗号化されていません。
  • 1: メディアファイルは暗号化されています。
Height String 1080

高さ。

ビットレート String 2659.326

メディアファイルのビットレート。

File オブジェクト

再生ファイル。

ステータス String 通常

ファイルのステータス。 設定可能な値は以下のとおりです。

  • Normal: normal
  • 削除済み: 削除済み
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 通常

入力ファイルのステータス。 設定可能な値は以下のとおりです。

  • Normal: normal
  • 削除済み: 削除済み
URL String http:// example-bucket-**** .oss-cn-hangzhou.aliyuncs.com//example-****.mp4

入力ファイルのOSS URL。

SummaryList サマリーの配列

ビデオ概要のリスト。

要約
データ型 String ビデオ

The type of the summary. 設定可能な値は以下のとおりです。

  • ビデオ: ビデオ
  • Gif: ダイナミックイメージ
MediaWorkflowId String 93ab850b4f6f44eab54b6e91d24d ****

The ID of the workflow that generates the summary.

ActivityName String 例-アクティビティ-****

ワークフローアクティビティの名前。

MediaWorkflowName String 例-mediaworkflow-****

サマリーを生成するワークフローの名前。

File オブジェクト

入力ファイルに関する情報。

ステータス String 通常

The status of the file. 設定可能な値は以下のとおりです。

  • Normal: normal
  • Deleted: deleted
URL String http:// example-bucket-**** .oss-cn-hangzhou.aliyuncs.com//example-****.mp4

The OSS URL of the input file.

PublishState String Published

メディアファイルの公開ステータス。 設定可能な値は以下のとおりです。

  • 開始済み: メディアファイルは初期状態です。
  • UnPublish: メディアファイルは公開されておらず、OSSオブジェクトの再生権限はPrivateです。
  • Published: メディアファイルは公開されており、OSSオブジェクトの再生権限はデフォルトです。
  • Deleted: メディアファイルが削除されました。
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 通常

ファイルのステータス。 設定可能な値は以下のとおりです。

  • Normal: normal
  • 削除済み: 削除済み
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 エラーセンター」をご参照ください。