QueryMediaList - ApsaraVideo Media Processing - Alibaba Cloud Documentation Center

Queries media files based on media file IDs.

Operation description

You can call this operation to query up to 10 media files at a time.

QPS limit

You can call this operation up to 100 times per second per account. If the number of calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation. For more information, see QPS limits.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Debug

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

Operation: the value that you can use in the Action element to specify the operation on a resource.
Access level: the access level of each operation. The levels are read, write, and list.
Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
- The required resource types are displayed in bold characters.
- If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
Condition Key: the condition key that is defined by the cloud service.
Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.

Operation	Access level	Resource type	Condition key	Associated operation
mts:QueryMediaList	get	All Resources ``	none	none

Request parameters

Parameter	Type	Required	Description	Example
MediaIds	string	Yes	The IDs of the media files. To obtain the ID of a media file, you can perform the following operations in the ApsaraVideo Media Processing (MPS) console: In the left-side navigation pane, choose Media Management > Media List. Find the required video and click Manage. The ID of the video is displayed on the Basics tab. Separate multiple IDs with commas (,). You can query up to 10 media files at a time.	3e1cd21131a94525be55acf65888**,e26cfa29e784402388463f61dbec**
IncludePlayList	boolean	No	Specifies whether to include playback information in the returned result. Valid values: true and false. Default value: false.	true
IncludeSnapshotList	boolean	No	Specifies whether to include snapshot information in the returned result. Valid values: true and false. Default value: false.	true
IncludeMediaInfo	boolean	No	Specifies whether to include media information in the returned result. Valid values: true and false. Default value: false.	true
IncludeSummaryList	boolean	No	Specifies whether to include summaries in the returned result. Valid values: true and false. Default value: false.	true

Response parameters

Parameter	Type	Description	Example
	object
NonExistMediaIds	array	The IDs of the media files that do not exist. This parameter is not returned when all specified media files exist.
MediaId	string		{"MediaId":[e26cfa29e784402388463f61dbec****]}
MediaList	array<object>	The list of media files.
Media	object
CreationTime	string	The time when the media file was created.	2016-09-14T08:30:33Z
CateId	long	The ID of the category to which the media file belongs.	1
Height	string	The height of the media file.	1080
CensorState	string	The review status of the media file. Valid values: Initiated: The media file is uploaded but not reviewed. Pass: The media file is uploaded and passes the review.	Initiated
Tags	array	The tags of the media file.
Tag	string		tag1,tag2
PlayList	array<object>	The playlist.
Play	object
Encryption	string	Indicates whether the media file is encrypted. Valid values: 0: The media file is not encrypted. 1: The media file is encrypted.	0
Height	string	The height.	1080
Bitrate	string	The bitrate of the media file.	2659.326
File	object	The playback file.
State	string	The status of the file. Valid values: Normal: normal Deleted: deleted	Normal
URL	string	The Object Storage Service (OSS) URL of the output file.	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4
MediaWorkflowId	string	The ID of the workflow that generates the playback file.	93ab850b4f6f44eab54b6e91d24d****
Width	string	The width of the media file.	760
Size	string	The size of the media file.	2647692
Fps	string	The frame rate of the media file.	25.0
Duration	string	The duration of the media file.	7.965000
ActivityName	string	The name of the workflow activity.	example-activity-****
Format	string	The encoding format of the media file. Valid values: mov, mp4, m4a, 3gp, 3g2, and mj2.	mp4
MediaWorkflowName	string	The name of the workflow that generates the playback file.	example-mediaworkflow-****
Bitrate	string	The bitrate.	2659.326
MediaId	string	The ID of the media file.	3e1cd21131a94525be55acf65888****
File	object	The details of the input file.
State	string	The status of the input file. Valid values: Normal: normal Deleted: deleted	Normal
URL	string	The OSS URL of the input file.	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4
SummaryList	array<object>	The list of video summaries.
Summary	object
Type	string	The type of the summary. Valid values: Video: video Gif: dynamic image	Video
MediaWorkflowId	string	The ID of the workflow that generates the summary.	93ab850b4f6f44eab54b6e91d24d****
ActivityName	string	The name of the workflow activity.	example-activity-****
MediaWorkflowName	string	The name of the workflow that generates the summary.	example-mediaworkflow-****
File	object	The information about the input file.
State	string	The status of the file. Valid values: Normal: normal Deleted: deleted	Normal
URL	string	The OSS URL of the input file.	http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com//example-**.mp4
PublishState	string	The publishing status of the media file. Valid values: Initiated: The media file is in the initial state. UnPublish: The media file has not been published, and the playback permission on the OSS object is Private. Published: The media file has been published, and the playback permission on the OSS object is Default. Deleted: The media file has been deleted.	Published
MediaInfo	object	The media information.
Streams	object	The stream information.
VideoStreamList	array<object>	The list of video streams.
VideoStream	object
Sar	string	The sample aspect ratio (SAR).	1:1
Height	string	The latter number in the video resolution. The number indicates the video height.	1080
CodecTagString	string	The tag string of the encoding format.	avc1
NetworkCost	object	The network bandwidth consumption.
PreloadTime	string	The amount of preload time.	0.01
AvgBitrate	string	The average bitrate.	2659.326
CostBandwidth	string	The maximum bandwidth that was consumed.	100
Width	string	The former number in the video resolution. The number indicates the video width.	100
Index	string	The sequence number of the video stream. The value indicates the position of the video stream in all video streams.	5
Timebase	string	The time base.	1/30000
AvgFPS	string	The average frame rate.	29.97003
PixFmt	string	The pixel format.	yuv420p
Lang	string	The language. For more information, see FFmpeg documentation.	und
CodecLongName	string	The full name of the encoding format.	QuickTime/MOV
NumFrames	string	The total number of frames.	12
Rotate	string	The video rotation angle.	90
Bitrate	string	The bitrate.	2659.326
HasBFrames	string	Indicates whether the video stream contains bidirectional frames (B-frames). A value of 1 indicates that the video stream contains B-frames. A value of 2 indicates that the video stream does not contain B-frames.	2
Profile	string	The codec profile.	High
StartTime	string	The start time.	0.000000
Dar	string	The display aspect ratio (DAR).	16:9
CodecName	string	The short name of the encoding format. Valid values: mov, mp4, m4a, 3gp, 3g2, and mj2.	mov
Duration	string	The duration.	182.683000
Fps	string	The frame rate.	29.97003
CodecTag	string	The tag of the encoding format.	0x31637661
CodecTimeBase	string	The codec time base.	1001/60000
Level	string	The codec level.	40
AudioStreamList	array<object>	The list of audio streams.
AudioStream	object
Timebase	string	The time base.	1/44100
Index	string	The sequence number of the audio stream. The value indicates the position of the audio stream in all audio streams.	1
SampleFmt	string	The sampling format.	fltp
ChannelLayout	string	The output layout of the sound channels.	stereo
Lang	string	The language. For more information, see FFmpeg documentation.	und
Samplerate	string	The sampling rate.	44100
CodecLongName	string	The full name of the encoding format.	AAC(Advanced Audio Coding)
Channels	string	The number of sound channels.	2
NumFrames	string	The total number of frames.	100
Bitrate	string	The bitrate.	160.008
CodecTagString	string	The tag string of the encoding format.	mp4a
StartTime	string	The start time.	0.000000
CodecName	string	The short name of the encoding format. Valid values: H264, mov, aac, avc, and mpeg.	mov
Duration	string	The duration.	182.591995
CodecTag	string	The tag of the encoding format.	0x6134706d
CodecTimeBase	string	The codec time base.	1/44100
SubtitleStreamList	array<object>	The list of subtitle streams.
SubtitleStream	object
Index	string	The sequence number of the subtitle stream. The value indicates the position of the subtitle stream in all subtitle streams.	3
Lang	string	The language. For more information, see FFmpeg documentation.	und
Format	object	The format information.
StartTime	string	The start time.	0.000000
NumPrograms	string	The total number of program streams.	2
Size	string	The size of the file.	2647692
NumStreams	string	The total number of media streams.	2
FormatLongName	string	The full name of the container format.	QuickTime/MOV
Duration	string	The total duration.	7.965000
Bitrate	string	The bitrate.	2659.326
FormatName	string	The short name of the container format. Valid values: mov, mp4, m4a, 3gp, 3g2, and mj2.	mov
Description	string	The description.	This is description ****
Size	string	The size of the file.	2647692
Width	string	The width.	1920
CoverURL	string	The OSS URL of the thumbnail.	http://example-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example-**.png
SnapshotList	array<object>	The list of snapshots.
Snapshot	object
Type	string	The type of the snapshot. Valid values: Single Sequence	Sequence
MediaWorkflowId	string	The ID of the workflow that generates the snapshot.	6cc3aa66d1cb4bb2adf14e726c0a****
ActivityName	string	The name of the workflow activity that generates the snapshot.	example-activity1-****
Count	string	The number of snapshots. This parameter is valid only when the value of the Type parameter is Sequence.	5
MediaWorkflowName	string	The name of the workflow that generates the snapshot.	example-workflow-****
File	object	The snapshot.
State	string	The status of the file. Valid values: Normal: normal Deleted: deleted	Normal
URL	string	The OSS URL of the snapshot.	http://example1-bucket1-**.oss-cn-hangzhou.aliyuncs.com//example111-**.png
RunIdList	array	The ID of the instance.
RunId	string		{"RunId":["47b42486019c4f688bf144c1a6ba****"]}
Duration	string	The duration.	7.965000
Fps	string	The frame rate.	25.0
Title	string	The title.	example-title-****
Format	string	The encoding format. Valid values: mov, mp4, m4a, 3gp, 3g2, and mj2.	mov
RequestId	string	The ID of the request.	283DC68C-146F-4489-A2A1-2F88F1472A56

Examples

Sample success responses

JSONformat

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

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change time	Summary of changes	Operation

No change history