GetTranscodeSummary - - Centre de documentation Alibaba Cloud

Consulte le résumé du transcodage vidéo d'un ou plusieurs fichiers audio ou vidéo par leurs identifiants, y compris l'état du transcodage vidéo et la progression du transcodage.

Description de l'opération

Étant donné qu'un fichier audio ou vidéo peut être transcodé plusieurs fois, cette opération ne renvoie que le résumé de transcodage le plus récent.
Les requêtes par lot sont prises en charge. Vous pouvez interroger les résumés de transcodage de jusqu'à 10 fichiers audio ou vidéo à la fois.
Pour interroger les informations historiques des tâches de transcodage, appelez l'opération ListTranscodeTask.
Cette opération prend en charge l'interrogation des données de tâches de transcodage uniquement pour la dernière année.

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.

vod:GetTranscodeSummary

get

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
VideoIds	string	Oui	Les identifiants audio ou vidéo. Vous pouvez spécifier un maximum de 10 identifiants, séparés par des virgules (,). Vous pouvez obtenir l'identifiant audio ou vidéo en utilisant les méthodes suivantes : Pour les fichiers audio ou vidéo téléversés via la console, connectez-vous à la console ApsaraVideo VOD et choisissez Fichiers multimédias > Audio/Vidéo pour afficher l'identifiant audio ou vidéo. Obtenez l'identifiant vidéo à partir de la valeur du paramètre VideoId renvoyée par l'opération CreateUploadVideo lorsque vous demandez une URL et des informations d'identification de téléversement. Une fois le fichier audio ou vidéo téléversé, appelez l'opération SearchMedia pour interroger l'identifiant audio ou vidéo, qui correspond à la valeur du paramètre VideoId dans la réponse.	"d4860fcc6ae9fed52e8938244**,e1db68cc586644b83e562bcd94**,hhhhhhh"

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	25818875-5F78-4A*****F6-D7393642CA58
NonExistVideoIds	array	Les identifiants des fichiers audio ou vidéo qui n'existent pas.
	string	Les identifiants des fichiers audio ou vidéo qui n'existent pas.	["hhhhhhh"]
TranscodeSummaryList	array<object>	La liste des résumés de transcodage vidéo des fichiers audio ou vidéo.
	array<object>
CreationTime	string	L'heure de création de la tâche de transcodage. L'heure est au format yyyy-MM-ddTHH:mm:ssZ (UTC).	2019-01-23T12:35:12Z
VideoId	string	L'identifiant audio ou vidéo.	e1db68cc586644b83e562bcd94****
CompleteTime	string	L'heure à laquelle la tâche de transcodage s'est terminée. L'heure est au format yyyy-MM-ddTHH:mm:ssZ (UTC).	2019-01-23T12:40:12Z
TranscodeStatus	string	L'état du transcodage. Valeurs valides : Processing : la tâche de transcodage est en cours. Partial : la tâche de transcodage est partiellement terminée. CompleteAllSucc : tous les travaux de transcodage sont terminés et réussis. CompleteAllFail : tous les travaux de transcodage sont terminés mais ont tous échoué. Si le fichier source présente des problèmes, aucun travail de transcodage n'est lancé et l'ensemble de la tâche de transcodage échoue. CompletePartialSucc : tous les travaux de transcodage sont terminés mais seuls certains ont réussi.	Processing
TranscodeTemplateGroupId	string	L'identifiant du groupe de modèles de transcodage utilisé pour le transcodage.	44f9e406bbb*****736a9abe876ecc0
TranscodeJobInfoSummaryList	array<object>	La liste des résumés des travaux de transcodage.
	object
CreationTime	string	The time when the transcoding job was created. The time is in the yyyy-MM-ddTHH:mm:ssZ format (UTC).	2019-02-27T03:34:46Z
ErrorMessage	string	The error message returned when the transcoding job failed.	ErrorMessage
Height	string	The height of the transcoded video output. Unit: px.	960
TranscodeProgress	integer	The transcoding progress. Value range: `[0,100]`.	100
TranscodeTemplateId	string	The ID of the transcoding template used.	57496724ae2*****0968d6e08acc8f6
Bitrate	string	The average bitrate of the transcoded video output. Unit: Kbps.	749
ErrorCode	string	The error code returned when the transcoding job failed.	200
CompleteTime	string	The time when the transcoding job was complete. The time is in the yyyy-MM-ddTHH:mm:ssZ format (UTC).	2019-02-27T03:40:51Z
Width	string	The width of the transcoded video output. Unit: px.	544
Duration	string	The duration of the transcoded video output. Unit: seconds.	12
Fps	string	The frame rate of the transcoded video output. Unit: frames per second.	30
TranscodeJobStatus	string	The status of the transcoding job. Valid values: Transcoding: The transcoding job is in progress. TranscodeSuccess: The transcoding job is successful. TranscodeFail: The transcoding job failed.	Transcoding
Filesize	integer	The file size of the transcoded video output. Unit: bytes.	1144259
Format	string	The container format of the transcoded video output.	mp4
WatermarkIdList	array	The list of watermarks used for transcoding.
	string	The list of watermarks used for transcoding.	["af2afe4761992c*****d947dae97337"]

Exemples

JSON format

{
  "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
  "NonExistVideoIds": [
    "[\"hhhhhhh\"]"
  ],
  "TranscodeSummaryList": [
    {
      "CreationTime": "2019-01-23T12:35:12Z",
      "VideoId": "e1db68cc586644b83e562bcd94****",
      "CompleteTime": "2019-01-23T12:40:12Z",
      "TranscodeStatus": "Processing",
      "TranscodeTemplateGroupId": "44f9e406bbb*****736a9abe876ecc0",
      "TranscodeJobInfoSummaryList": [
        {
          "CreationTime": "2019-02-27T03:34:46Z",
          "ErrorMessage": "ErrorMessage",
          "Height": "960",
          "TranscodeProgress": 100,
          "TranscodeTemplateId": "57496724ae2*****0968d6e08acc8f6",
          "Bitrate": "749",
          "ErrorCode": "200",
          "CompleteTime": "2019-02-27T03:40:51Z",
          "Width": "544",
          "Duration": "12",
          "Fps": "30",
          "TranscodeJobStatus": "Transcoding",
          "Filesize": 1144259,
          "Format": "mp4",
          "WatermarkIdList": [
            "[\"af2afe4761992c*****d947dae97337\"]"
          ]
        }
      ]
    }
  ]
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.