使用QueryMediaList按媒體ID查詢媒體列表-ApsaraVideo for Media Processing-阿里雲

使用媒體ID查詢媒體。

介面說明

本介面一次最多查詢 10 個媒體檔案。

QPS 限制

本介面的單使用者 QPS 限制為 100 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。更多資訊，請參見 QPS 限制。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

mts:QueryMediaList

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
MediaIds	string	是	需要查詢的媒體檔案 ID 列表，可以登入 MPS 控制台，通過媒體管理 > 媒體列表擷取。用半形逗號（,）分隔，一次最多查詢 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 Bucket。	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 Bucket。	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4
SummaryList	object
Summary	array<object>	視頻摘要列表。
	array<object>	視頻摘要資料。
Type	string	摘要類型。取值： Video：視頻類型。 Gif：生動影像類型。	Video
MediaWorkflowId	string	產生摘要的工作流程 ID。	93ab850b4f6f44eab54b6e91d24d****
ActivityName	string	媒體工作流程活動名稱。	example-activity-****
MediaWorkflowName	string	產生摘要的工作流程名稱。	example-mediaworkflow-****
File	object	輸入檔案資訊。
State	string	檔案狀態。範圍： Normal：正常。 Deleted：已刪除。	Normal
URL	string	輸入檔案的 OSS Bucket。	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	編碼訊號解析度比。	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	編碼顯示解析度比。	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 Bucket。	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 Bucket。	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

樣本

正常返回樣本

JSON格式

{
  "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"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。