SubmitTranscodeJobs - - Centre de documentation Alibaba Cloud

Soumet une tâche de transcodage de média pour démarrer un transcodage asynchrone.

Description de l'opération

Remarques sur l'utilisation

Avant d'utiliser cette opération, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'ApsaraVideo VOD. Le transcodage est une fonctionnalité payante. Pour plus d'informations sur la facturation, consultez Facturation du transcodage.
Il s'agit d'une opération asynchrone. Après avoir soumis une tâche, l'identifiant de la tâche est renvoyé. La tâche n'est pas encore terminée à ce stade et entre dans une file d'attente pour une exécution asynchrone. Le résultat final est envoyé via une notification de rappel. Vous pouvez également appeler GetTranscodeTask pour interroger l'état de la tâche.
Seules les vidéos dans l'état UploadSucc, Normal ou Checking peuvent être transcodées.
Pour obtenir les résultats du transcodage, configurez les messages de rappel : SingleCompleteEvent et AllCompleteEvent.
Cette opération prend en charge le remplacement dynamique des URL de sous-titres dans les tâches de packaging de streaming à débit adaptatif HLS. Si la tâche de packaging n'implique pas le packaging de sous-titres, n'utilisez pas cette opération pour initier la tâche. Spécifiez plutôt l'identifiant du groupe de modèles de transcodage correspondant lors du téléchargement de la vidéo pour déclencher automatiquement le processus de packaging.

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:SubmitTranscodeJobs

create

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
VideoId	string	Non	L'identifiant de la vidéo. Vous pouvez obtenir l'identifiant de la vidéo en utilisant l'une des méthodes suivantes : Connectez-vous à la console ApsaraVideo VOD et choisissez Fichiers multimédias > Audio/Vidéo pour afficher l'identifiant de la vidéo. Obtenez la valeur de VideoId à partir de la réponse à l'opération CreateUploadVideo. Une fois la vidéo téléchargée, appelez l'opération SearchMedia pour interroger l'identifiant de la vidéo. L'identifiant de la vidéo correspond à la valeur de VideoId dans la réponse.	142710f878bd42508932f660d7b1****
TemplateGroupId	string	Oui	L'identifiant du groupe de modèles de transcodage utilisé pour le transcodage vidéo. Pour afficher l'identifiant du groupe de modèles, connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Traitement des médias > Groupe de modèles de transcodage.	0e408c803baf658ee637790c5d9f****
PipelineId	string	Non	L'identifiant du pipeline.	d3e680e618708erf45fbf2cae7c****
EncryptConfig	string	Non	La configuration de chiffrement. Ce paramètre est une chaîne JSON et n'est requis que lorsque vous utilisez le chiffrement HLS. Remarque Le paramètre CipherText dans la structure EncryptConfig doit être une clé de texte chiffré AES_128 générée en appelant GenerateKMSDataKey. Sinon, le transcodage avec chiffrement HLS échoue. Pour plus d'informations sur le processus de chiffrement HLS, consultez Chiffrement HLS. Que vous utilisiez le chiffrement HLS ou un chiffrement propriétaire, les modèles associés à TemplateGroupId doivent avoir l'option de chiffrement HLS sélectionnée. Sinon, le contenu n'est pas chiffré.	{"CipherText":"ZjJmZGViNzUtZWY1Mi00Y2RlLTk3**", "DecryptKeyUri":"http://demo.aliyundoc.com?CipherText=ZjJmZGViNzUtZWY1Mi00Y2RlLTk3**","KeyServiceType":"KMS"}
OverrideParams	string	Non	Les paramètres de substitution au format JSON. Vous pouvez utiliser ce paramètre pour substituer le fichier de filigrane d'image, le contenu du filigrane textuel, l'URL du fichier de sous-titres et le format d'encodage du fichier de sous-titres associés au modèle de transcodage. Pour plus d'informations sur la structure des paramètres, consultez OverrideParams.	{"Watermarks":[{"WatermarkId":"af2afe4761992c47dae973374**","FileUrl":"http://developer.aliyundoc.com/image/image.png"},{"WatermarkId":"e8e5b8038d7ada85b376c2707**","Content":"test de filigrane"}]}
Priority	string	Non	La priorité de la tâche de transcodage actuelle parmi toutes les tâches en file d'attente. Valeurs valides : 1 à 10. Priorité la plus élevée : 10. Valeur par défaut : 6. Remarque Le paramètre Priority affecte uniquement la priorité de la tâche de transcodage actuelle parmi toutes les tâches en file d'attente. Il n'affecte pas les tâches qui sont déjà en cours de transcodage.	6
UserData	string	Non	Les paramètres personnalisés au format JSON. Ce paramètre prend en charge des configurations telles que les rappels de messages. Pour plus d'informations, consultez UserData. Remarque Pour utiliser le rappel de message dans ce paramètre, vous devez configurer une URL de rappel HTTP et sélectionner les types d'événements de rappel correspondants dans la console. Sinon, les paramètres de rappel ne prennent pas effet.	{"Extend":{"localId":"**","test":"*"}}
SessionId	string	Non	L'identifiant de déduplication personnalisé. Si une requête avec le même identifiant a été soumise au cours des 7 derniers jours, la requête actuelle renvoie une erreur. La valeur peut comporter jusqu'à 50 caractères et peut contenir des lettres majuscules, des lettres minuscules, des chiffres, des traits d'union (-) et des traits de soulignement (_). Si ce paramètre n'est pas spécifié ou s'il est défini sur une chaîne vide, aucune déduplication n'est effectuée.	5c62d40299034bbaa4c195da330****
ReferenceId	string	Non	L'identifiant personnalisé. La valeur ne peut contenir que des lettres minuscules, des lettres majuscules, des chiffres, des traits d'union (-) et des traits de soulignement (_), et doit comporter entre 6 et 64 caractères. La valeur doit être unique pour chaque utilisateur.	123-123

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
TranscodeTaskId	string	L'identifiant de la tâche de transcodage soumise.	9f4a0df7da2c8a81c8c0408c84****
RequestId	string	L'identifiant de la requête.	E4EBD2BF-5EB0-4476-8829-9D94E1B1****
TranscodeJobs	object
TranscodeJob	array<object>	Les informations sur la tâche multimédia. Remarque Ce paramètre n'est pas renvoyé pour les tâches de packaging de streaming à débit adaptatif HLS. Vous devez recevoir le rappel de manière asynchrone pour obtenir le résultat du traitement.
	object	Les détails de la tâche multimédia.
JobId	string	The job ID. Remarque This parameter is not returned for HLS adaptive bitrate streaming packaging tasks. You must asynchronously receive the callback to obtain the processing result.	d8921ce8505716cfe86fb112c4****

Exemples

JSON format

{
  "TranscodeTaskId": "9f4a0df7da2c8a81c8c0408c84****",
  "RequestId": "E4EBD2BF-5EB0-4476-8829-9D94E1B1****",
  "TranscodeJobs": {
    "TranscodeJob": [
      {
        "JobId": "d8921ce8505716cfe86fb112c4****"
      }
    ]
  }
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.