ListTranscodeTask - - Centre de documentation Alibaba Cloud

Consulte les informations historiques sur les tâches de transcodage d'un fichier audio ou vidéo à partir de son identifiant. Cette opération ne renvoie pas les détails spécifiques des travaux.

Description de l'opération

Remarques sur l'utilisation

Pour interroger les informations détaillées sur les travaux de transcodage, appelez l'opération GetTranscodeTask.
Cette opération prend uniquement en charge l'interrogation des données de tâches de transcodage de l'année écoulée.

Limite de QPS

La limite de QPS par utilisateur pour cette opération est de 15 appels par seconde. Si cette limite est dépassée, l'appel d'API est limité, ce qui peut affecter votre activité. Appelez cette opération de manière appropriée. Pour plus d'informations, consultez Limite 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.

vod:ListTranscodeTask

list

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
VideoId	string	Oui	L'identifiant audio ou vidéo. Vous pouvez obtenir cet identifiant en utilisant l'une des méthodes suivantes : Pour les fichiers audio ou vidéo téléversés via la console, connectez-vous à la console ApsaraVideo VOD et sélectionnez Fichiers multimédias > Audio/Vidéo pour afficher l'identifiant. Obtenez l'identifiant de la vidéo à partir du paramètre de réponse VideoId lorsque vous appelez l'opération CreateUploadVideo pour obtenir l'URL et l'identifiant 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 VideoId dans la réponse.	d4860fcc6a5*****bce9fed52e893824
StartTime	string	Non	L'heure de début. Spécifiez l'heure au format yyyy-MM-ddTHH:mm:ssZ (UTC).	2019-01-23T12:35:12Z
EndTime	string	Non	L'heure de fin, qui doit être postérieure à l'heure de début. Spécifiez l'heure au format yyyy-MM-ddTHH:mm:ssZ (UTC).	2019-01-23T12:40:12Z
PageSize	integer	Non	Le nombre d'entrées par page. Valeur maximale : 50. Valeur par défaut : 10.	10
PageNo	integer	Non	Le numéro de page. Spécifiez ce paramètre pour renvoyer les données à partir de la page indiquée. Valeur par défaut : 1.	1

Éléments de réponse

Élément	Type	Description	Exemple
	object
RequestId	string	L'identifiant de la requête.	25818875-5F78-4A*****F6-D7393642CA58
TranscodeTaskList	array<object>	La liste des informations sur les tâches de transcodage.
	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
Trigger	string	Le type de déclencheur. Valeurs valides : Auto : déclenché automatiquement après le téléversement d'une vidéo. Manual : déclenché en appelant l'opération SubmitTranscodeJobs.	Auto
TaskStatus	string	L'état de la tâche de transcodage. Processing : en cours. Partial : partiellement terminé. 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
VideoId	string	L'identifiant audio ou vidéo.	d4860fcc6a5*****bce9fed52e893824
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
TranscodeTemplateGroupId	string	L'identifiant du groupe de modèles de transcodage utilisé pour le transcodage.	b500c7094bd24*****f3e9900752d7c3
TranscodeTaskId	string	L'identifiant de la tâche de transcodage.	b1b65ab107*****ba3dbb900f6c1fe0

Exemples

JSON format

{
  "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
  "TranscodeTaskList": [
    {
      "CreationTime": "2019-01-23T12:35:12Z",
      "Trigger": "Auto",
      "TaskStatus": "Processing",
      "VideoId": "d4860fcc6a5*****bce9fed52e893824",
      "CompleteTime": "2019-01-23T12:40:12Z",
      "TranscodeTemplateGroupId": "b500c7094bd24*****f3e9900752d7c3",
      "TranscodeTaskId": "b1b65ab107*****ba3dbb900f6c1fe0"
    }
  ]
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.