ListTranscodeTask - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Pour obtenir les détails des jobs de transcodage, appelez l'opération GetTranscodeTask.
Cette opération répertorie uniquement les tâches de transcodage créées au cours de l'année écoulée.

Limite QPS

Vous pouvez appeler cette opération jusqu'à 15 fois par seconde par compte. Les requêtes dépassant cette limite sont rejetées, ce qui entraîne des interruptions de service. Tenez compte de cette limite lors de l'appel à cette opération. Pour plus d'informations, consultez la rubrique Limites QPS des opérations API dans ApsaraVideo VoD.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	ListTranscodeTask	Opération à effectuer. Définissez la valeur sur ListTranscodeTask.
VideoId	String	Yes	d4860fcc6a5*****bce9fed52e893824	ID du fichier audio ou vidéo. Obtenez cet identifiant par l'une des méthodes suivantes : Connectez-vous à la console ApsaraVideo VOD. Dans le volet de navigation de gauche, choisissez Media Files > Audio/Video. Sur la page Video and Audio, consultez l'ID du fichier audio ou vidéo. Cette méthode s'applique aux fichiers téléchargés via la console ApsaraVideo VOD. Récupérez la valeur de VideoId dans la réponse de l'opération CreateUploadVideo, appelée pour obtenir l'URL de téléchargement et les informations d'identification. Obtenez la valeur de VideoId en appelant l'opération SearchMedia. Cette méthode s'applique aux fichiers déjà téléchargés.
StartTime	String	No	2019-01-23T12:35:12Z	Début de la plage de temps à interroger. Spécifiez l'heure au format ISO 8601 : yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC.
EndTime	String	No	2019-01-23T12:40:12Z	Fin de la plage de temps à interroger. L'heure de fin doit être postérieure à l'heure de début. Spécifiez l'heure au format ISO 8601 : yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC.
PageSize	Integer	No	10	Nombre d'entrées à renvoyer par page. Valeur maximale : 50. Valeur par défaut : 10.
PageNo	Integer	No	1	Numéro de la page à renvoyer. Spécifiez un numéro de page pour récupérer les données correspondantes. Valeur par défaut : 1.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	25818875-5F78-4A*****F6-D7393642CA58	ID de la requête.
TranscodeTaskList	Array of TranscodeTask		Détails des tâches de transcodage.
CreationTime	String	2019-01-23T12:35:12Z	Heure de création de la tâche de transcodage. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
Trigger	String	Auto	Mode de déclenchement de la tâche de transcodage. Valeurs possibles : Auto : La tâche de transcodage est déclenchée automatiquement lors du téléchargement de la vidéo. Manual : La tâche de transcodage est déclenchée par un appel à l'opération SubmitTranscodeJobs.
TaskStatus	String	Processing	État de la tâche de transcodage. Valeurs possibles : Processing : En cours. Partial : Certains jobs de transcodage sont terminés. CompleteAllSucc : Tous les jobs de transcodage ont réussi. CompleteAllFail : Tous les jobs de transcodage ont échoué. Si une exception survient dans le fichier source, aucun job de transcodage n'est initié et la tâche de transcodage échoue. CompletePartialSucc : Tous les jobs de transcodage sont terminés, mais seuls certains ont réussi.
VideoId	String	d4860fcc6a5*****bce9fed52e893824	ID du fichier audio ou vidéo.
CompleteTime	String	2019-01-23T12:40:12Z	Heure de fin de la tâche de transcodage. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
TranscodeTemplateGroupId	String	b500c7094bd24*****f3e9900752d7c3	ID du groupe de modèles de transcodage.
TranscodeTaskId	String	b1b65ab107*****ba3dbb900f6c1fe0	ID de la tâche de transcodage.

Exemples

Exemple de requête

https://vod.{ApiRegion}.aliyuncs.com/?Action=ListTranscodeTask
&VideoId=d4860fcc6a5*****bce9fed52e893824
&<Common request parameters>

Exemple de réponse

Format XML

HTTP/1.1 200 OK
Content-Type:application/xml

<ListTranscodeTaskResponse>
    <RequestId>25818875-5F78-4A*****F6-D7393642CA58</RequestId>
	<TranscodeTaskList>
		<TranscodeTaskId>b1b65ab107*****ba3dbb900f6c1fe0</TranscodeTaskId>
		<VideoId>d4860fcc6a5*****bce9fed52e893824</VideoId>
		<TaskStatus>Processing</TaskStatus>
		<TranscodeTemplateGroupId>b500c7094bd24*****f3e9900752d7c3</TranscodeTemplateGroupId>
		<CreationTime>2019-01-23T12:35:12Z</CreationTime>
		<CompleteTime>2019-01-23T12:40:12Z</CompleteTime>
	</TranscodeTaskList>
	<TranscodeTaskList>
		<TranscodeTaskId>91449a74a9d7*****31e179a1ec1e</TranscodeTaskId>
		<VideoId>d4860fcc6a5*****bce9fed52e893824</VideoId>
		<TaskStatus>CompeleteAllSucc</TaskStatus>
		<TranscodeTemplateGroupId>947b9f5b0eb*****3d985df69d76b7</TranscodeTemplateGroupId>
		<CreationTime>2019-01-23T12:35:12Z</CreationTime>
		<CompleteTime>2019-01-23T12:40:12Z</CompleteTime>
	</TranscodeTaskList>
</ListTranscodeTaskResponse>

Format JSON

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "25818875-5F78-4A*****F6-D7393642CA58",
  "TranscodeTaskList" : [ {
    "TranscodeTaskId" : "b1b65ab107*****ba3dbb900f6c1fe0",
    "VideoId" : "d4860fcc6a5*****bce9fed52e893824",
    "TaskStatus" : "Processing",
    "TranscodeTemplateGroupId" : "b500c7094bd24*****f3e9900752d7c3",
    "CreationTime" : "2019-01-23T12:35:12Z",
    "CompleteTime" : "2019-01-23T12:40:12Z"
  }, {
    "TranscodeTaskId" : "91449a74a9d7*****31e179a1ec1e",
    "VideoId" : "d4860fcc6a5*****bce9fed52e893824",
    "TaskStatus" : "CompeleteAllSucc",
    "TranscodeTemplateGroupId" : "947b9f5b0eb*****3d985df69d76b7",
    "CreationTime" : "2019-01-23T12:35:12Z",
    "CompleteTime" : "2019-01-23T12:40:12Z"
  } ]
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le API Error Center.