QueryMediaInfoJobList - - Centre de documentation Alibaba Cloud

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

Description de l'opération

En mode asynchrone, vous ne pouvez interroger les informations multimédias qu'après la réussite du rappel de Message Service (MNS) pour Soumettre une tâche d'analyse des informations multimédias. Si les informations multimédias ne peuvent pas être interrogées pendant une longue période, la tâche d'analyse des informations multimédias soumise a peut-être échoué.
Vous pouvez interroger jusqu'à 10 tâches d'analyse des informations multimédias à la fois.
Par défaut, les résultats renvoyés sont triés par ordre décroissant de CreationTime.

Limite de QPS

La limite de QPS par utilisateur est de 100 appels par seconde. Si cette limite est dépassée, les appels d'API sont limités, ce qui peut affecter vos services. Faites preuve de prudence lors de l'appel de cette opération. Pour plus d'informations, consultez Limites de QPS.

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

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
MediaInfoJobIds	string	Oui	Les identifiants des tâches d'analyse des informations multimédias. Vous pouvez spécifier jusqu'à 10 identifiants. Séparez les identifiants multiples par des virgules (,). Vous pouvez obtenir les identifiants à partir des paramètres de réponse de Soumettre une tâche d'analyse des informations multimédias. 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	L'identifiant d'une tâche d'analyse des informations multimédias inexistante.
	string	La liste des identifiants des tâches d'analyse des informations multimédias inexistantes. 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	L'heure à laquelle la tâche a été ajoutée. L'heure est affichée en UTC et suit la norme ISO 8601 au format AAAA-MM-JJThh:mm:ssZ.	2014-01-10T12:00:00Z
State	string	L'état de la tâche. Valeurs valides : Analyzing : L'analyse est en cours. Success : L'analyse a réussi. Fail : L'analyse a échoué.	Success
JobId	string	L'identifiant de la tâche d'analyse des informations multimédias.	23ca1d184c0e4341e5b665e2a12****
UserData	string	Les données utilisateur personnalisées.	testid-001
Code	string	Le code d'erreur renvoyé lorsque l'analyse des informations multimédias échoue.	InvalidParameter.JsonObjectFormatInvalid
Message	string	Le message d'erreur renvoyé lorsque l'analyse des informations multimédias échoue.	The parameter ”*” does not conform to the JSON Object specification
PipelineId	string	L'identifiant de la file d'attente MPS.	88c6ca184c0e432bbf5b665e2a15****
Async	boolean	Indique si la tâche est asynchrone.	true
Input	object	L'entrée de la tâche.
Object	string	L'objet OSS.	example.mp4
Location	string	La région OSS.	oss-cn-hangzhou
Bucket	string	Le compartiment OSS du fichier d'entrée.	example-bucket
MNSMessageResult	object	Le résultat du message MNS envoyé pour notifier à l'utilisateur la fin de la tâche.
MessageId	string	L'identifiant du message renvoyé lorsque la notification réussit. Ce paramètre n'est pas renvoyé si la notification échoue.	123
ErrorMessage	string	Le message d'erreur renvoyé lorsque la notification échoue. Ce paramètre n'est pas renvoyé si la notification réussit.	The parameter \"Input\" does not conform to the JSON Object specification
ErrorCode	string	Le code d'erreur renvoyé lorsque la notification échoue. Ce paramètre n'est pas renvoyé si la notification réussit.	InvalidParameter.JsonObjectFormatInvalid
Properties	object	Les propriétés détaillées du média. Pour plus d'informations, consultez Type de données AliyunProperties.
Width	string	La largeur de la vidéo en pixels.	1280
Height	string	La hauteur de la vidéo en pixels.	720
Duration	string	La durée.	17.226000
Fps	string	La fréquence d'images.	25
Bitrate	string	Le débit binaire.	1630.045
FileFormat	string	Le format de fichier.	QuickTime/MOV
Streams	object	Les informations de flux.
VideoStreamList	object
VideoStream	array<object>	La liste des informations de flux vidéo.
	array<object>
Sar	string	Le rapport d'aspect de l'échantillon.	1:1
Height	string	La hauteur de la vidéo.	1080
CodecTagString	string	Le texte de la marque du format d'encodage.	[0][0][0][0]
NetworkCost	object	La consommation de bande passante réseau.
PreloadTime	string	Le temps de préchargement.	8
AvgBitrate	string	Le débit binaire moyen.	300.34
CostBandwidth	string	La bande passante maximale consommée.	10
Width	string	La largeur de la vidéo.	1920
Index	string	L'index du flux vidéo, qui identifie la position du flux vidéo dans l'ensemble du flux multimédia.	1
Timebase	string	La base de temps.	1/1000
AvgFPS	string	La fréquence d'images moyenne.	23.976025
PixFmt	string	Le format de pixel.	yuv420p
Lang	string	La langue.	eng
CodecLongName	string	Le nom long du format d'encodage.	H.264/AVC/MPEG-4 AVC/MPEG-4 part 10
NumFrames	string	Le nombre total d'images.	100
Rotate	string	L'angle de rotation de la vidéo.	180
Bitrate	string	Le débit binaire.	30541090
HasBFrames	string	Indique si la vidéo contient des images B. Une valeur de 0 indique que la vidéo ne contient pas d'images B. Une valeur de 1 indique que la vidéo contient des images B.	0
Profile	string	Le profil d'encodage.	High
StartTime	string	L'heure de début.	0.042000
Dar	string	Le rapport d'aspect d'affichage.	16:9
CodecName	string	Le nom court du format d'encodage. Valeurs valides : h264 h265 gif webp	h264
Duration	string	La durée.	100
Fps	string	La fréquence d'images.	25
CodecTag	string	La marque du format d'encodage.	0x0000
CodecTimeBase	string	La base de temps du codec.	1001/48000
Level	string	Le niveau d'encodage.	41
ColorRange	string	La plage de couleurs.	700
ColorTransfer	string	Le transfert de couleurs.	R255 G83 B170
ColorPrimaries	string	Les couleurs primaires.	700
DurationInaccurate	string
DolbyVision	object
Profile	string
Level	string
AudioStreamList	object
AudioStream	array<object>	La liste des informations de flux audio.
	object
Timebase	string	La base de temps.	1/1000
Index	string	L'index du flux audio, qui identifie la position du flux audio dans l'ensemble du flux multimédia.	1
SampleFmt	string	Le format d'échantillonnage.	fltp
ChannelLayout	string	La disposition des canaux.	5.1(side)
Lang	string	La langue. Pour plus d'informations, consultez Définitions des langues FFmpeg.	eng
Samplerate	string	La fréquence d'échantillonnage.	48000
CodecLongName	string	Le nom long du format d'encodage.	DCA (DTS Coherent Acoustics)
Channels	string	La disposition de sortie des canaux.	2
NumFrames	string	Le nombre total d'images.	123
Bitrate	string	Le débit binaire.	1536000
CodecTagString	string	Le texte de la marque du format d'encodage.	[0][0][0][0]
StartTime	string	L'heure de début.	0.042000
CodecName	string	Le nom court du format d'encodage. Valeurs valides : acc mp3 mp4 ogg flac	acc
Duration	string	La durée.	123
CodecTag	string	La marque du format d'encodage.	0x0000
CodecTimeBase	string	La base de temps du codec.	1/48000
DurationInaccurate	string
SubtitleStreamList	object
SubtitleStream	array<object>	La liste des informations de flux de sous-titres.
	object
Timebase	string	La base de temps.	1/1000
Index	string	L'index du flux de sous-titres, qui identifie la position du flux de sous-titres dans l'ensemble du flux multimédia.	3
StartTime	string	L'heure de début.	0.000000
CodecName	string	Le nom court du format d'encodage. Valeurs valides : srt ass	ass
Lang	string	La langue.	eng
CodecLongName	string	Le nom long du format d'encodage.	ASS (Advanced SSA) subtitle
Duration	string	La durée en secondes.	1370.116000
CodecTag	string	La balise du format d'encodage.	0x0000
CodecTimeBase	string	La base de temps du codec.	0/1
CodecTagString	string	La chaîne de la balise du format d'encodage.	[0][0][0][0]
Format	object	Les informations de format.
StartTime	string	L'heure de début.	0.042000
NumPrograms	string	Le nombre total de flux de programme.	2
Size	string	La taille du fichier.	3509895
NumStreams	string	Le nombre total de flux multimédias.	1
FormatLongName	string	Le nom long du format de conteneur ou d'encapsulation.	QuickTime/MOV
Duration	string	La durée totale.	17.226000
Bitrate	string	Le débit binaire total.	1630.045
FormatName	string	Le nom court du format de conteneur ou d'encapsulation.	mov
Tags	object
FileSize	string	La taille du fichier.	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, MPS envoie un message à la file d'attente spécifiée. Pour plus d'informations sur la manière de spécifier une file d'attente de rappel, consultez UpdatePipeline. Le corps du message est une chaîne JSON qui contient 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. La valeur est identique à celle du paramètre State dans QueryMediaInfoJobList.
UserData	String	Le UserData transmis dans la requête 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": "Le paramètre ”*” n'est pas conforme à la spécification d'objet JSON",
        "PipelineId": "88c6ca184c0e432bbf5b665e2a15****",
        "Async": true,
        "Input": {
          "Object": "example.mp4",
          "Location": "oss-cn-hangzhou",
          "Bucket": "example-bucket"
        },
        "MNSMessageResult": {
          "MessageId": "123",
          "ErrorMessage": "Le paramètre \"Input\" n'est pas conforme à la spécification d'objet JSON",
          "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) sous-titre",
                  "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.