UploadMediaByURL - - Centre de documentation Alibaba Cloud

Récupère et téléverse des fichiers multimédias audio et vidéo à partir d'URL sources. Prend en charge le téléversement par lot.

Description de l'opération

Avant d'appeler cette opération, assurez-vous de bien comprendre les méthodes de facturation et la tarification d'ApsaraVideo VOD. Le téléversement de ressources 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 téléversement de ressources multimédias vers ApsaraVideo VOD entraîne également des frais d'accélération de téléversement. 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 des serveurs ou terminaux locaux et doivent être téléversés via des URL accessibles sur le réseau public.
Cette opération est une opération de téléversement asynchrone. Elle n'est pas en temps réel et ne garantit pas la rapidité d'exécution. Généralement, la migration et le téléversement sont effectués en quelques heures, voire quelques jours après la soumission. Si vous avez des exigences strictes en matière de rapidité, utilisez le SDK de téléversement.
Si un rappel est configuré, vous recevrez une notification d'événement Téléversement de vidéo par URL terminé une fois le téléversement terminé. Vous pouvez interroger l'état du téléversement en appelant l'opération Obtenir les informations de téléversement par URL.
Une fois une tâche de téléversement soumise, une tâche exécutée de manière asynchrone est générée dans le cloud. Les tâches de téléversement par URL soumises par tous les utilisateurs dans la région de service correspondante sont mises en file d'attente pour exécution. Le temps d'achèvement dépend du nombre de tâches existantes. Une fois le téléversement terminé, vous pouvez associer la tâche en fonction de l'URL et de l'identifiant de vidéo renvoyés dans la notification d'événement (rappel de message).
Cette opération n'est actuellement prise en charge que dans les régions Chine (Shanghai), Chine (Pékin), Chine (Shenzhen), Singapour et États-Unis (Silicon Valley).
Pour une même URL de fichier multimédia, chaque tâche de téléversement soumise génère une nouvelle ressource multimédia dans ApsaraVideo VOD (c'est-à-dire qu'un nouvel identifiant de ressource est généré).
Si un fichier unique dépasse 20 Go, le téléversement échouera. Si vous devez téléverser un fichier unique de plus de 20 Go, utilisez le SDK de téléversement. Pour plus d'informations, consultez Présentation du SDK de téléversement.

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

*Toutes les ressources.

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
UploadURLs	string	Oui	Les URL des fichiers multimédias sources. L'URL doit inclure une extension de nom de fichier. Par exemple, dans `https://**.mp4`, mp4 est l'extension de nom de fichier. Si l'URL ne contient pas d'extension de nom de fichier, vous pouvez la spécifier en passant FileExtension dans UploadMetadatas. Si l'URL contient une extension de nom de fichier et que FileExtension est également passé, le FileExtension passé prévaut. Pour les extensions de nom de fichier prises en charge, consultez Présentation du téléversement. Remarque Les URL doivent être encodées en URL. Séparez plusieurs URL par des virgules (,). Vous pouvez spécifier jusqu'à 20 URL. Pour éviter les échecs de téléversement causés par des caractères spéciaux, encodez en URL** les URL avant de les concaténer 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 > Configuration du traitement des médias > Groupes de modèles de transcodage pour afficher l'identifiant du groupe de modèles de transcodage. Lorsque vous créez un groupe de modèles de transcodage en appelant l'opération Créer un groupe de modèles de transcodage, l'identifiant du groupe de modèles de transcodage est la valeur du paramètre de réponse TranscodeTemplateGroupId. Lorsque vous interrogez des groupes de modèles de transcodage en appelant l'opération Interroger des groupes de modèles de transcodage, l'identifiant est la valeur du paramètre de réponse TranscodeTemplateGroupId. Remarque Si vous ne spécifiez pas l'identifiant d'un groupe de modèles de transcodage, le groupe de modèles de transcodage par défaut est utilisé pour le transcodage. Si vous spécifiez l'identifiant d'un groupe de modèles de transcodage, le groupe de modèles spécifié est utilisé pour le transcodage. Vous pouvez également définir ce paramètre dans UploadMetadatas. Si TemplateGroupId est défini à la fois dans UploadMetadatas et ici, le TemplateGroupId défini dans UploadMetadatas prévaut.	ca3a8f6e4957b65806709586****
StorageLocation	string	Non	L'adresse de stockage du fichier multimédia. Connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Configuration de la gestion des ressources multimédias > Gestion du 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 à téléverser. La valeur est une chaîne JSON. Les métadonnées ne prennent effet que lorsqu'elles correspondent à l'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. Vous pouvez configurer des paramètres tels que les rappels de message et l'accélération de téléversement. Pour plus d'informations, consultez UserData. Remarque Pour utiliser la fonction de 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. Pour plus d'informations sur la configuration des rappels HTTP dans la console, consultez Paramètres de rappel. Pour utiliser la fonction d'accélération de téléversement, vous devez soumettre un ticket pour demander son activation. Pour plus d'informations, consultez Instructions de téléversement. 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 workflow. Vous pouvez vous connecter à la console ApsaraVideo VOD et choisir Gestion de la configuration > Configuration du traitement des médias > Gestion des workflows pour afficher l'identifiant du workflow. Remarque Si WorkflowId et TemplateGroupId sont tous deux transmis, WorkflowId prévaut. Pour les instructions d'utilisation, consultez Workflows.	e1e243b42548248197d6f74f9****
SessionId	string	Non	L'identifiant de déduplication personnalisé. Si ce paramètre est transmis dans une requête et qu'une requête avec le même identifiant a été détectée au cours des 10 dernières minutes, une erreur est renvoyée pour la requête en cours. Remarque L'identifiant de déduplication est personnalisé. Il peut comporter jusqu'à 50 caractères et prend en charge les lettres majuscules et minuscules, les chiffres, les traits d'union (-) et les traits de soulignement (_). Si vous ne transmettez pas ce paramètre ou si vous transmettez une chaîne vide, aucune déduplication n'est effectuée.	5c62d40299034bbaa4c195da330****
EnableFirstFrameCover	boolean	Non	Indique si la première image de la vidéo doit être utilisée comme couverture.
GenerateThumbnail	boolean	Non	Indique si une miniature doit être générée pour la vidéo.

UploadMetadata

Nom	Type	Requis	Description
SourceURL	String	Oui	L'URL du fichier multimédia source à téléverser.
Title	String	Non	Le titre du média. La valeur peut comporter jusqu'à 128 octets et doit être encodée en UTF-8.
FileSize	String	Non	La taille du fichier.
Description	String	Non	La description. La valeur peut comporter jusqu'à 1 024 octets et doit être encodée en UTF-8.
CoverURL	String	Non	L'URL personnalisée de la couverture vidéo.
CateId	String	Non	L'identifiant de la catégorie. Vous pouvez vous connecter à la console ApsaraVideo VOD et choisir Gestion de la configuration > Configuration de la gestion des ressources multimédias > Gestion des catégories pour afficher l'identifiant de la catégorie.
Tags	String	Non	Les balises. Une seule balise peut comporter jusqu'à 32 octets. Vous pouvez spécifier jusqu'à 16 balises. Séparez plusieurs balises par des virgules (,). Encodez la valeur en UTF-8.
TemplateGroupId	String	Non	L'identifiant du groupe de modèles de transcodage. Cette valeur remplace le TemplateGroupId transmis au niveau supérieur.
WorkflowId	String	Non	L'identifiant du workflow. Si WorkflowId et TemplateGroupId sont tous deux transmis, WorkflowId prévaut. Pour plus d'informations, consultez Workflows.
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 téléversement.
ReferenceId	String	Non	L'identifiant personnalisé. La valeur peut comporter de 6 à 64 caractères et prend uniquement en charge les lettres minuscules, les lettres majuscules, les chiffres, les traits d'union (-) et les traits de soulignement (_). L'identifiant doit être unique par utilisateur.

Remarque

Les paramètres dans UploadMetadata (tels que Title, Description et Tags) ne peuvent pas contenir d'émojis.
Pour garantir une lecture normale, si vous définissez TemplateGroupId sur "VOD_NO_TRANSCODE" pour téléverser des fichiers vidéo sans transcodage, seuls les fichiers aux formats suivants prennent en charge la lecture directe sans transcodage : MP4, FLV, MP3, M3U8 et WEBM. Les fichiers dans d'autres formats sont uniquement stockés (faites attention à l'extension de nom de fichier de FileName). Si vous utilisez le lecteur Alibaba Cloud, la version doit être 3.1.0 ou ultérieure.
Si vous spécifiez un groupe de modèles qui ne transcode pas (TemplateGroupId est défini sur "VOD_NO_TRANSCODE"), seule la notification d'événement Téléversement de vidéo terminé est générée après le téléversement de la vidéo. La notification d'événement Transcodage en définition unique terminé n'est pas générée.
Si un rappel est configuré, après le téléversement de la vidéo, vous recevrez la notification d'événement Téléversement de vidéo par URL terminé en plus des notifications de téléversement et de transcodage.
Lorsque vous soumettez des tâches par lot, chaque SourceURL dispose d'une notification indépendante.

Éléments de réponse

Élément	Type	Description	Exemple
	object	La réponse.
RequestId	string	L'identifiant de la requête.	25818875-5F78-4AF6-D7393642CA58****
UploadJobs	array<object>	La liste des tâches de téléversement.
	object	Les détails de la tâche de téléversement.
SourceURL	string	L'URL du fichier source correspondant à la tâche de téléversement.	http://example****.mp4
JobId	string	L'identifiant de la tâche de téléversement.	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.