Pour téléverser des fichiers réseau, automatiser les transferts ou réaliser des migrations par lots, appelez les API Intelligent Media Services (IMS) afin d'obtenir une URL et un identifiant de téléversement, puis utilisez les API natives Object Storage Service (OSS) pour finaliser le transfert.
Prérequis
Vous connaissez les formats de fichier pris en charge. Pour plus d'informations, consultez la rubrique Formats de fichier pris en charge.
Vous avez activé Object Storage Service (OSS). Pour plus d'informations, consultez la rubrique Activer OSS.
Contexte
Avant de téléverser un média via une API OSS, vous devez obtenir une URL et un identifiant de téléversement auprès d'IMS. L'URL indique l'adresse de stockage dans OSS, tandis que l'identifiant autorise l'opération de transfert. IMS délivre ces deux éléments pour garantir la sécurité et prévenir les téléversements malveillants. Lors de la génération de l'URL et de l'identifiant, IMS crée également automatiquement un ID de ressource multimédia, utilisable pour la gestion du cycle de vie des médias ou pour ApsaraVideo Media Processing.
Notes
La taille maximale d'un fichier audio ou vidéo unique est de 5 Go.
Les extensions de fichier ne sont pas sensibles à la casse lors du téléversement. Si l'extension n'est pas prise en charge, le transfert échoue car le format du fichier ne correspond pas à l'identifiant de téléversement.
Étape 1 : Obtenir une URL et un identifiant de téléversement
Appelez l'opération CreateUploadMedia pour récupérer l'URL et l'identifiant de téléversement d'une ressource multimédia. Intégrez le SDK côté serveur (recommandé) ou construisez votre propre requête HTTP(S). Pour plus de détails, reportez-vous aux rubriques Mécanisme RPC.
Chaque URL et identifiant de téléversement est valable pour une seule ressource multimédia. Ne les réutilisez pas pour plusieurs ressources afin d'éviter l'écrasement des fichiers.
Si vous demandez plusieurs fois une URL et un identifiant pour la même ressource, une paire différente vous sera retournée à chaque requête.
Intelligent Media Services attribue automatiquement les URL de téléversement. Les URL personnalisées ne sont pas prises en charge.
Un identifiant de téléversement reste valide pendant 3000 secondes. Pour les fichiers vidéo volumineux, il peut expirer durant le transfert. Dans ce cas, appelez l'opération RefreshUploadMedia pour le renouveler. Le nouvel identifiant est également valide pendant 3000 secondes, tandis que l'URL de téléversement demeure inchangée.
Pour les fichiers de plus petite taille, tels que les images et les ressources annexes (sous-titres, polices), vous devez obtenir un nouvel identifiant si celui en cours expire.
Étape 2 : Appeler une API OSS pour téléverser la ressource multimédia
Décodez en Base64 l'URL et l'identifiant de téléversement. Ensuite, appelez une API de téléversement OSS pour transférer la ressource. Consultez les rubriques En-têtes HTTP courants et Téléverser des fichiers vers OSS pour plus d'informations.