QueryMediaInfoJobList-阿里云帮助中心

Queries media information analysis jobs.

Operation description

In asynchronous mode, you can query media information only after the Message Service (MNS) callback for Submit a media information analysis job succeeds. If the media information cannot be queried for a long time, the submitted media information analysis job may have failed.
You can query up to 10 media information analysis jobs at a time.
By default, the returned results are sorted in descending order of CreationTime.

QPS limit

The QPS limit per user is 100 calls per second. If this limit is exceeded, API calls are throttled, which may affect your services. Exercise caution when you call this operation. For more information, see QPS limits.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

mts:QueryMediaInfoJobList

get

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
MediaInfoJobIds	string	Yes	The IDs of the media information analysis jobs. You can specify up to 10 IDs. Separate multiple IDs with commas (,). You can obtain the IDs from the response parameters of Submit a media information analysis job. Note If you do not specify this parameter, the InvalidParameter error code is returned.	23ca1d184c0e4341e5b665e2a12****

Response elements

Element	Type	Description	Example
	object
NonExistMediaInfoJobIds	object
String	array	The ID of a non-existent media information analysis job.
	string	The list of IDs of non-existent media information analysis jobs. This parameter is not returned if no data is available.	11ce1d184c0e4341e5b665e2a12****
RequestId	string	The request ID.	46A04AA5-B119-41BB-B750-7C5327AC3E7A
MediaInfoJobList	object
MediaInfoJob	array<object>	The list of media information analysis jobs.
	array<object>
CreationTime	string	The time when the job was added. The time is displayed in UTC and follows the ISO 8601 standard in the YYYY-MM-DDTHH:mm:ssZ format.	2014-01-10T12:00:00Z
State	string	The job status. Valid values: Analyzing: The analysis is in progress. Success: The analysis is successful. Fail: The analysis failed.	Success
JobId	string	The ID of the media information analysis job.	23ca1d184c0e4341e5b665e2a12****
UserData	string	The custom user data.	testid-001
Code	string	The error code returned when the media information analysis fails.	InvalidParameter.JsonObjectFormatInvalid
Message	string	The error message returned when the media information analysis fails.	The parameter ”*” does not conform to the JSON Object specification
PipelineId	string	The ID of the MPS queue.	88c6ca184c0e432bbf5b665e2a15****
Async	boolean	Specifies whether the job is asynchronous.	true
Input	object	The job input.
Object	string	The OSS object.	example.mp4
Location	string	The OSS region.	oss-cn-hangzhou
Bucket	string	The OSS bucket of the input file.	example-bucket
MNSMessageResult	object	The result of the MNS message sent to notify the user of job completion.
MessageId	string	The message ID returned when the notification is successful. This parameter is not returned if the notification fails.	123
ErrorMessage	string	The error message returned when the notification fails. This parameter is not returned if the notification is successful.	The parameter \"Input\" does not conform to the JSON Object specification
ErrorCode	string	The error code returned when the notification fails. This parameter is not returned if the notification is successful.	InvalidParameter.JsonObjectFormatInvalid
Properties	object	The detailed media properties. For more information, see AliyunProperties data type.
Width	string	The width of the video in pixels.	1280
Height	string	The height of the video in pixels.	720
Duration	string	The duration.	17.226000
Fps	string	The frame rate.	25
Bitrate	string	The bitrate.	1630.045
FileFormat	string	The file format.	QuickTime/MOV
Streams	object	The stream information.
VideoStreamList	object
VideoStream	array<object>	The list of video stream information.
	array<object>
Sar	string	The sample aspect ratio.	1:1
Height	string	The height of the video.	1080
CodecTagString	string	The text of the encoding format mark.	[0][0][0][0]
NetworkCost	object	The network bandwidth consumption.
PreloadTime	string	The preload time.	8
AvgBitrate	string	The average bitrate.	300.34
CostBandwidth	string	The maximum consumed bandwidth.	10
Width	string	The width of the video.	1920
Index	string	The index of the video stream, which identifies the position of the video stream in the entire media stream.	1
Timebase	string	The timebase.	1/1000
AvgFPS	string	The average frame rate.	23.976025
PixFmt	string	The pixel format.	yuv420p
Lang	string	The language.	eng
CodecLongName	string	The long name of the encoding format.	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10
NumFrames	string	The total number of frames.	100
Rotate	string	The video rotation angle.	180
Bitrate	string	The bitrate.	30541090
HasBFrames	string	Specifies whether the video contains B-frames. A value of 0 indicates that the video does not contain B-frames. A value of 1 indicates that the video contains B-frames.	0
Profile	string	The encoding profile.	High
StartTime	string	The start time.	0.042000
Dar	string	The display aspect ratio.	16:9
CodecName	string	The short name of the encoding format. Valid values: h264 h265 gif webp	h264
Duration	string	The duration.	100
Fps	string	The frame rate.	25
CodecTag	string	The encoding format mark.	0x0000
CodecTimeBase	string	The codec timebase.	1001/48000
Level	string	The encoding level.	41
ColorRange	string	The color range.	700
ColorTransfer	string	The color transfer.	R255 G83 B170
ColorPrimaries	string	The color primaries.	700
DurationInaccurate	string
DolbyVision	object
Profile	string
Level	string
AudioStreamList	object
AudioStream	array<object>	The list of audio stream information.
	object
Timebase	string	The timebase.	1/1000
Index	string	The index of the audio stream, which identifies the position of the audio stream in the entire media stream.	1
SampleFmt	string	The sample format.	fltp
ChannelLayout	string	The channel layout.	5.1(side)
Lang	string	The language. For more information, see FFmpeg language definitions.	eng
Samplerate	string	The sample rate.	48000
CodecLongName	string	The long name of the encoding format.	DCA (DTS Coherent Acoustics)
Channels	string	The channel output layout.	2
NumFrames	string	The total number of frames.	123
Bitrate	string	The bitrate.	1536000
CodecTagString	string	The text of the encoding format mark.	[0][0][0][0]
StartTime	string	The start time.	0.042000
CodecName	string	The short name of the encoding format. Valid values: acc mp3 mp4 ogg flac	acc
Duration	string	The duration.	123
CodecTag	string	The encoding format mark.	0x0000
CodecTimeBase	string	The codec timebase.	1/48000
DurationInaccurate	string
SubtitleStreamList	object
SubtitleStream	array<object>	The list of caption stream information.
	object
Timebase	string	The timebase.	1/1000
Index	string	The index of the caption stream, which identifies the position of the caption stream in the entire media stream.	3
StartTime	string	The start time.	0.000000
CodecName	string	The short name of the encoding format. Valid values: srt ass	ass
Lang	string	The language.	eng
CodecLongName	string	The long name of the encoding format.	ASS (Advanced SSA) subtitle
Duration	string	The duration in seconds.	1370.116000
CodecTag	string	The encoding format tag.	0x0000
CodecTimeBase	string	The codec timebase.	0/1
CodecTagString	string	The string of the encoding format tag.	[0][0][0][0]
Format	object	The format information.
StartTime	string	The start time.	0.042000
NumPrograms	string	The total number of program streams.	2
Size	string	The file size.	3509895
NumStreams	string	The total number of media streams.	1
FormatLongName	string	The long name of the container or encapsulation format.	QuickTime/MOV
Duration	string	The total duration.	17.226000
Bitrate	string	The total bitrate.	1630.045
FormatName	string	The short name of the container or encapsulation format.	mov
Tags	object
FileSize	string	The file size.	3509895
FileMd5	string

Callback message format

When the execution status of a media information analysis job changes, MPS sends a message to the specified queue. For more information about how to specify a callback queue, see UpdatePipeline. The message body is a JSON string that contains the following fields:

{
 "Type": "MediaInfo",
 "State": "Success",
 "JobId": "bb558c1cc25b45309aab5be44d19****",
 "UserData": "{\"key\":\"value\"}",
 "RequestId": "B52658D4-07AB-43CD-82B0-210958A6****"
}

Name	Type	Description
Type	String	The fixed string "MediaInfo", which indicates a media information analysis job.
JobId	String	The unique ID of the job.
State	String	The current status of the job. The value is the same as the State parameter in QueryMediaInfoJobList.
UserData	String	The UserData passed in the SubmitMediaInfoJob request.

Examples

Success response

JSON format

{
  "NonExistMediaInfoJobIds": {
    "String": [
      "11ce1d184c0e4341e5b665e2a12****"
    ]
  },
  "RequestId": "46A04AA5-B119-41BB-B750-7C5327AC3E7A",
  "MediaInfoJobList": {
    "MediaInfoJob": [
      {
        "CreationTime": "2014-01-10T12:00:00Z",
        "State": "Success",
        "JobId": "23ca1d184c0e4341e5b665e2a12****",
        "UserData": "testid-001",
        "Code": "InvalidParameter.JsonObjectFormatInvalid",
        "Message": "The parameter ”*” does not conform to the JSON Object specification",
        "PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
        "Async": true,
        "Input": {
          "Object": "example.mp4",
          "Location": "oss-cn-hangzhou",
          "Bucket": "example-bucket"
        },
        "MNSMessageResult": {
          "MessageId": "123",
          "ErrorMessage": "The parameter \\\"Input\\\" does not conform to the JSON Object specification",
          "ErrorCode": "InvalidParameter.JsonObjectFormatInvalid"
        },
        "Properties": {
          "Width": "1280",
          "Height": "720",
          "Duration": "17.226000",
          "Fps": "25",
          "Bitrate": "1630.045",
          "FileFormat": "QuickTime/MOV",
          "Streams": {
            "VideoStreamList": {
              "VideoStream": [
                {
                  "Sar": "1:1",
                  "Height": "1080",
                  "CodecTagString": "[0][0][0][0]",
                  "NetworkCost": {
                    "PreloadTime": "8",
                    "AvgBitrate": "300.34",
                    "CostBandwidth": "10"
                  },
                  "Width": "1920",
                  "Index": "1",
                  "Timebase": "1/1000",
                  "AvgFPS": "23.976025",
                  "PixFmt": "yuv420p",
                  "Lang": "eng",
                  "CodecLongName": "H.264/AVC/MPEG-4 AVC/MPEG-4 part 10",
                  "NumFrames": "100",
                  "Rotate": "180",
                  "Bitrate": "30541090",
                  "HasBFrames": "0",
                  "Profile": "High",
                  "StartTime": "0.042000",
                  "Dar": "16:9",
                  "CodecName": "h264",
                  "Duration": "100",
                  "Fps": "25",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "1001/48000",
                  "Level": "41",
                  "ColorRange": "700",
                  "ColorTransfer": "R255 G83 B170",
                  "ColorPrimaries": "700",
                  "DurationInaccurate": "",
                  "DolbyVision": {
                    "Profile": "",
                    "Level": ""
                  }
                }
              ]
            },
            "AudioStreamList": {
              "AudioStream": [
                {
                  "Timebase": "1/1000",
                  "Index": "1",
                  "SampleFmt": "fltp",
                  "ChannelLayout": "5.1(side)",
                  "Lang": "eng",
                  "Samplerate": "48000",
                  "CodecLongName": "DCA (DTS Coherent Acoustics)",
                  "Channels": "2",
                  "NumFrames": "123",
                  "Bitrate": "1536000",
                  "CodecTagString": "[0][0][0][0]",
                  "StartTime": "0.042000",
                  "CodecName": "acc",
                  "Duration": "123",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "1/48000",
                  "DurationInaccurate": ""
                }
              ]
            },
            "SubtitleStreamList": {
              "SubtitleStream": [
                {
                  "Timebase": "1/1000",
                  "Index": "3",
                  "StartTime": "0.000000",
                  "CodecName": "ass",
                  "Lang": "eng",
                  "CodecLongName": "ASS (Advanced SSA) subtitle",
                  "Duration": "1370.116000",
                  "CodecTag": "0x0000",
                  "CodecTimeBase": "0/1",
                  "CodecTagString": "[0][0][0][0]"
                }
              ]
            }
          },
          "Format": {
            "StartTime": "0.042000",
            "NumPrograms": "2",
            "Size": "3509895",
            "NumStreams": "1",
            "FormatLongName": "QuickTime/MOV",
            "Duration": "17.226000",
            "Bitrate": "1630.045",
            "FormatName": "mov",
            "Tags": {
              "test": "test",
              "test2": 1
            }
          },
          "FileSize": "3509895",
          "FileMd5": ""
        }
      }
    ]
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.