Queries media files based on the IDs of media files.
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
Authorization information
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.
| true |
IncludeSnapshotList | boolean | No | Specifies whether to include snapshot information in the returned result.
| true |
IncludeMediaInfo | boolean | No | Specifies whether to include media information in the returned result.
| true |
IncludeSummaryList | boolean | No | Specifies whether to include summaries in the returned result.
| true |
Response parameters
Examples
Sample success responses
JSON
format
{
"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 |
---|