UploadMediaByURL - - Centre de documentation Alibaba Cloud

Récupère les fichiers multimédias audio et vidéo pour les charger en fonction des URL des fichiers sources. Le chargement par lot est pris en charge.

Description de l'opération

Avant d'utiliser cette opération, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'ApsaraVideo VOD. Le chargement de fichiers multimédias vers ApsaraVideo VOD entraîne des frais de stockage. Pour plus de détails sur la facturation, consultez Facturation du stockage des ressources multimédias. Si vous avez activé l'accélération du transfert de stockage, le chargement de fichiers multimédias vers ApsaraVideo VOD entraîne également des frais d'accélération du chargement. Pour plus de détails sur la facturation, consultez Facturation de l'accélération du transfert de stockage.
Pour les formats de fichiers multimédias pris en charge par cette opération, consultez Formats multimédias.
Cette opération s'applique principalement aux scénarios où les fichiers ne sont pas stockés sur un serveur local ou un terminal et doivent être chargés via une URL avec un accès au réseau public.
Cette opération est une opération de chargement asynchrone. Elle n'est pas en temps réel et ne garantit pas la rapidité d'exécution. Généralement, le chargement par migration est effectué en quelques heures, voire quelques jours, après la soumission du nœud. Si vous avez des exigences strictes en matière de rapidité, utilisez plutôt le SDK de chargement.
Si un rappel est configuré, vous recevrez la notification d'événement Chargement de la vidéo par URL terminé une fois le chargement terminé. Vous pouvez appeler l'opération GetURLUploadInfos pour interroger l'état du chargement.
Une fois un nœud de chargement soumis, un nœud asynchrone est généré dans le cloud pour exécution. Tous les nœuds de chargement par URL soumis par les utilisateurs dans la région de service correspondante sont mis en file d'attente pour exécution. Le temps d'achèvement est affecté par le nombre de nœuds existants. Une fois le chargement terminé, vous pouvez associer l'URL à l'identifiant de la vidéo en fonction des informations renvoyées dans la notification d'événement (rappel de message).
Cette opération prend actuellement en charge uniquement les régions Chine (Shanghai), Chine (Pékin), Chine (Shenzhen), Singapour et États-Unis (Silicon Valley).
Chaque fois que vous soumettez un nœud de chargement pour la même URL de fichier multimédia, une nouvelle ressource multimédia est générée dans ApsaraVideo VOD (c'est-à-dire qu'un nouvel identifiant de média est généré).
Si un fichier unique dépasse 20 Go, le chargement échoue. Si vous devez charger un fichier unique de plus de 20 Go, utilisez le SDK de chargement. Pour plus d'informations, consultez Présentation du SDK de chargement.

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

create

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
UploadURLs	string	Oui	Les URL des fichiers sources multimédias. L'URL doit inclure une extension de nom de fichier. Par exemple, mp4 est l'extension de nom de fichier dans `https://**.mp4`. Si l'URL n'inclut pas d'extension de nom de fichier, vous pouvez spécifier le paramètre FileExtension dans `UploadMetadatas`. Si l'URL inclut une extension de nom de fichier et que le paramètre `FileExtension` est également spécifié, la valeur de `FileExtension` est prioritaire. Pour les extensions de nom de fichier prises en charge, consultez Présentation du chargement. Remarque** Séparez plusieurs URL par des virgules (,). Un maximum de 20 URL est pris en charge. Pour éviter les échecs de chargement causés par des caractères spéciaux, codez chaque URL en format URL avant de les joindre avec des virgules.	https://****.mp4
TemplateGroupId	string	Non	L'identifiant du groupe de modèles de transcodage. Vous pouvez obtenir l'identifiant en utilisant l'une des méthodes suivantes : Connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Traitement des médias > Groupes de modèles de transcodage pour afficher l'identifiant du groupe de modèles de transcodage. Obtenez la valeur de TranscodeTemplateGroupId à partir de la réponse lorsque vous appelez l'opération AddTranscodeTemplateGroup. Obtenez la valeur de TranscodeTemplateGroupId à partir de la réponse lorsque vous appelez l'opération ListTranscodeTemplateGroup. Remarque Si vous ne spécifiez pas d'identifiant de groupe de modèles de transcodage, le groupe de modèles de transcodage par défaut est utilisé. Si vous spécifiez un identifiant de groupe de modèles de transcodage, le groupe de modèles spécifié est utilisé. Vous pouvez également définir ce paramètre dans `UploadMetadatas`. Si TemplateGroupId est défini à la fois dans UploadMetadatas et dans ce paramètre, la valeur dans UploadMetadatas est prioritaire.	ca3a8f6e4957b65806709586****
StorageLocation	string	Non	L'adresse de stockage du fichier multimédia. Connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Gestion des ressources multimédias > Stockage pour afficher l'adresse de stockage. Si vous ne spécifiez pas ce paramètre, l'adresse de stockage par défaut est utilisée.	outin-bfefbb90a47c******163e1c7426.oss-cn-shanghai.aliyuncs.com
UploadMetadatas	string	Non	Les métadonnées des fichiers multimédias à charger. La valeur est une chaîne JSON. Les métadonnées prennent effet uniquement lorsqu'elles correspondent à une URL dans UploadURLs. Format JSON : `[UploadMetadata, UploadMetadata,…]`. La valeur doit être convertie en chaîne JSON. Pour plus d'informations, consultez le tableau UploadMetadata ci-dessous.	[{"SourceURL":"https://example.aliyundoc.com/video01.mp4","Title":"urlUploadTest"}]
UserData	string	Non	Les paramètres personnalisés. La valeur est une chaîne JSON qui prend en charge les paramètres de rappel de message et d'accélération du chargement. Pour plus d'informations, consultez UserData. Remarque Pour utiliser les rappels 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. Pour plus d'informations sur la configuration des rappels HTTP dans la console, consultez Paramètres de rappel. Pour utiliser la fonctionnalité d'accélération du chargement, soumettez un ticket pour l'activer. Pour plus d'informations, consultez Instructions de chargement. Pour plus d'informations sur la soumission d'un ticket, consultez Contactez-nous.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
AppId	string	Non	L'identifiant de l'application. Valeur par défaut : app-1000000. Pour plus d'informations, consultez Multi-application.	app-****
WorkflowId	string	Non	L'identifiant du flux de travail. Connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Traitement des médias > Flux de travail pour afficher l'identifiant du flux de travail. Remarque Si WorkflowId et TemplateGroupId sont tous deux spécifiés, WorkflowId est prioritaire. Pour les instructions d'utilisation, consultez Flux de travail.	e1e243b42548248197d6f74f9****
SessionId	string	Non	L'identifiant de déduplication personnalisé. Si ce paramètre est spécifié et qu'une requête avec le même identifiant a été envoyée au cours des 10 dernières minutes, une erreur est renvoyée pour la requête en cours. Remarque Cet identifiant de déduplication est défini de manière personnalisée. Il peut contenir jusqu'à 50 caractères et peut contenir des lettres majuscules et minuscules, des chiffres, des traits d'union (-) et des traits de soulignement (_). Si ce paramètre n'est pas spécifié ou est défini sur une chaîne vide, aucune déduplication n'est effectuée.	5c62d40299034bbaa4c195da330****
EnableFirstFrameCover	boolean	Non
GenerateThumbnail	boolean	Non

UploadMetadata

Nom	Type	Requis	Description
SourceURL	String	Oui	L'URL du fichier source multimédia à charger.
Title	String	Non	Le titre du fichier multimédia. Le titre peut contenir jusqu'à 128 octets. L'encodage UTF-8 est utilisé.
FileSize	String	Non	La taille du fichier.
Description	String	Non	La description. La description peut contenir jusqu'à 1024 octets. L'encodage UTF-8 est utilisé.
CoverURL	String	Non	L'URL personnalisée de la miniature vidéo.
CateId	String	Non	L'identifiant de la catégorie. Connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Gestion des ressources multimédias > Catégories pour afficher l'identifiant de la catégorie.
Tags	String	Non	Les balises. Chaque balise peut contenir jusqu'à 32 octets. Un maximum de 16 balises est pris en charge. Séparez plusieurs balises par des virgules (,). L'encodage UTF-8 est utilisé.
TemplateGroupId	String	Non	L'identifiant du groupe de modèles de transcodage. Cette valeur remplace le TemplateGroupId spécifié dans le paramètre externe.
WorkflowId	String	Non	L'identifiant du flux de travail. Si WorkflowId et TemplateGroupId sont tous deux spécifiés, WorkflowId est prioritaire. Pour plus d'informations, consultez Flux de travail.
FileExtension	String	Non	L'extension de nom de fichier du fichier multimédia. Pour les extensions de nom de fichier prises en charge, consultez Présentation du chargement.
ReferenceId	String	Non	L'identifiant personnalisé. Seules les lettres minuscules, les lettres majuscules, les chiffres, les traits d'union (-) et les traits de soulignement (_) sont pris en charge. La valeur doit comporter de 6 à 64 caractères. La valeur doit être unique au sein d'un compte utilisateur.

Remarque

Les paramètres dans UploadMetadata (tels que Title, Description et Tags) ne peuvent pas contenir de caractères emoji.
Pour garantir une lecture normale, lorsque vous chargez des fichiers vidéo avec TemplateGroupId défini sur "VOD_NO_TRANSCODE" (pas de transcodage), seuls les formats suivants prennent en charge la lecture directe sans transcodage : MP4, FLV, MP3, M3U8 et WEBM. Les autres formats prennent uniquement en charge le stockage (faites attention à l'extension de nom de fichier de FileName). Si vous utilisez Alibaba Cloud Player, la version doit être 3.1.0 ou ultérieure.
Si vous spécifiez un groupe de modèles sans transcodage (TemplateGroupId défini sur "VOD_NO_TRANSCODE"), seule la notification d'événement chargement de la vidéo terminé est envoyée après le chargement de la vidéo. La notification d'événement transcodage de flux unique terminé n'est pas envoyée.
Si un rappel est configuré, une fois le chargement de la vidéo terminé, en plus des notifications de chargement et de transcodage, la notification d'événement chargement de la vidéo par URL terminé est également envoyée.
Lorsque vous soumettez des tâches par lots, chaque SourceURL dispose d'une notification indépendante.

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les paramètres de réponse.
RequestId	string	L'identifiant de la requête.	25818875-5F78-4AF6-D7393642CA58****
UploadJobs	array<object>	La liste des tâches de chargement.
	object	Les détails d'une tâche de chargement.
SourceURL	string	L'URL du fichier source de la tâche de chargement.	http://example****.mp4
JobId	string	L'identifiant de la tâche de chargement.	ad90a501b1b94fb72374ad005046****

Exemples

JSON format

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****",
  "UploadJobs": [
    {
      "SourceURL": "http://example****.mp4",
      "JobId": "ad90a501b1b94fb72374ad005046****"
    }
  ]
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.