QueryMediaInfoJobList - - Centre de documentation Alibaba Cloud

Consulte les tâches d'analyse des informations multimédias.

Description de l'opération

En mode asynchrone, les informations multimédias ne peuvent être consultées qu'après la réception d'un rappel réussi de Message Service (MNS) pour l'opération SubmitMediaInfoJob. Si les informations multimédias ne peuvent pas être consultées après un long délai, la tâche d'analyse des informations multimédias a peut-être échoué.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

mts:QueryMediaInfoJobList

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
MediaInfoJobIds	string	Oui	L'identifiant de la tâche d'analyse des informations multimédias. Vous pouvez interroger jusqu'à 10 tâches à la fois. Séparez les identifiants de plusieurs tâches par des virgules (,). Vous pouvez obtenir l'identifiant de la tâche à partir des paramètres de réponse de l'opération SubmitMediaInfoJob. Remarque Si vous ne spécifiez pas ce paramètre, le code d'erreur InvalidParameter est renvoyé.	23ca1d184c0e4341e5b665e2a12****

Éléments de réponse

Élément	Type	Description	Exemple
	object
NonExistMediaInfoJobIds	object
String	array	Les tâches d'analyse des informations multimédias qui n'existent pas.
	string	Une liste des identifiants des tâches d'analyse des informations multimédias qui n'existent pas. Ce paramètre n'est pas renvoyé si aucune donnée n'est disponible.	11ce1d184c0e4341e5b665e2a12****
RequestId	string	L'identifiant de la requête.	46A04AA5-B119-41BB-B750-7C5327AC3E7A
MediaInfoJobList	object
MediaInfoJob	array<object>	La liste des tâches d'analyse des informations multimédias.
	array<object>
CreationTime	string	The time when the job was created.	2014-01-10T12:00:00Z
State	string	The status of the job. Analyzing: The job is being analyzed. 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	Indicates 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 where the input file is stored.	example-bucket
MNSMessageResult	object	The result of the MNS message that is sent to notify the user that the job is complete.
MessageId	string	The message ID. This parameter is returned if the operation is successful. It is not returned if the operation fails.	123
ErrorMessage	string	The error message. This parameter is returned if the operation fails. It is not returned if the operation is successful.	The parameter \"Input\" does not conform to the JSON Object specification
ErrorCode	string	The error code. This parameter is returned if the operation fails. It is not returned if the operation is successful.	InvalidParameter.JsonObjectFormatInvalid
Properties	object	The detailed properties of the media. 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 tag.	[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 bandwidth consumed.	10
Width	string	The width of the video.	1920
Index	string	The sequence number of the video stream. It indicates the position of the video stream in the entire media stream.	1
Timebase	string	The time base.	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 rotation angle of the video.	180
Bitrate	string	The bitrate.	30541090
HasBFrames	string	Indicates whether B-frames exist. A value of 0 means no B-frames. A value of 1 means B-frames exist.	0
Profile	string	The codec 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 tag.	0x0000
CodecTimeBase	string	The codec time base.	1001/48000
Level	string	The encoding level.	41
ColorRange	string	The color range.	700
ColorTransfer	string	The color transfer characteristic.	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 time base.	1/1000
Index	string	The sequence number of the audio stream. It indicates the position of the audio stream in the entire media stream.	1
SampleFmt	string	The sampling format.	fltp
ChannelLayout	string	The number of sound channels.	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 sound channel output style.	2
NumFrames	string	The total number of frames.	123
Bitrate	string	The bitrate.	1536000
CodecTagString	string	The text of the encoding format tag.	[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 tag.	0x0000
CodecTimeBase	string	The codec time base.	1/48000
DurationInaccurate	string
SubtitleStreamList	object
SubtitleStream	array<object>	The list of caption stream information.
	object
Timebase	string	The time base.	1/1000
Index	string	The sequence number of the caption stream. It indicates 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 (s).	1370.116000
CodecTag	string	The encoding format tag.	0x0000
CodecTimeBase	string	The codec time base.	0/1
CodecTagString	string	The text 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 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 format.	mov
Tags	object
FileSize	string	The file size.	3509895
FileMd5	string

Format du message de rappel

Lorsque l'état d'exécution d'une tâche d'analyse des informations multimédias change, ApsaraVideo Media Processing (MPS) envoie un message à la file d'attente que vous spécifiez. Pour plus d'informations sur la manière de spécifier une file d'attente de rappel, consultez l'opération d'API UpdatePipeline. Le corps du message est une chaîne JSON contenant les champs suivants :

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

Nom	Type	Description
Type	String	La chaîne fixe "MediaInfo", qui indique une tâche d'analyse des informations multimédias.
JobId	String	L'identifiant unique de la tâche.
State	String	L'état actuel de la tâche. Il est identique au paramètre State dans QueryMediaInfoJobList.
UserData	String	Les UserData que vous transmettez dans SubmitMediaInfoJob.

Exemples

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": ""
        }
      }
    ]
  }
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.