Tous les produits
Search

Ce produit

    :CreateUploadAttachedMedia

    Centre de documentation

    :CreateUploadAttachedMedia

    Dernière mise à jour :Aug 05, 2026

    L'URL et les informations d'identification de téléversement sont fournies par ApsaraVideo VOD pour répondre aux exigences d'autorisation et de sécurité, empêcher les téléversements malveillants et permettre la création automatique d'un identifiant de ressource média (MediaId) pour la gestion et le traitement. Pour les ressources média auxiliaires telles que les filigranes et les sous-titres, appelez cette opération pour obtenir les informations d'identification de téléversement et créer les informations de ressource média correspondantes.

    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 téléversement de fichiers média vers ApsaraVideo VOD entraîne des frais de stockage. Pour plus d'informations, consultez Facturation du stockage des ressources média. Si vous avez activé l'accélération du transfert de stockage, le téléversement de fichiers média vers ApsaraVideo VOD entraîne également des frais d'accélération du téléversement. Pour plus d'informations, consultez Facturation de l'accélération du transfert de stockage.

    • Cette opération permet uniquement d'obtenir l'URL et les informations d'identification de téléversement et de créer les informations de base de la ressource média. Elle ne téléverse pas de fichiers. Pour un exemple complet de téléversement de fichiers à l'aide de l'API, consultez Téléverser des fichiers média à l'aide de l'API ApsaraVideo VOD.

    • Si les informations d'identification de téléversement expirent (valides pendant 3 000 secondes), appelez à nouveau cette opération pour obtenir une nouvelle URL et de nouvelles informations d'identification de téléversement.

    • Vous pouvez configurer des rappels pour recevoir des notifications d'événements pour la fin du téléversement de la ressource média auxiliaire afin de déterminer si le téléversement a réussi.

    • L'obtention de l'URL et des informations d'identification de téléversement est un principe fondamental d'ApsaraVideo VOD et une étape obligatoire pour chaque opération de téléversement. ApsaraVideo VOD fournit diverses méthodes de téléversement, chacune ayant des exigences différentes pour l'obtention de l'URL et des informations d'identification de téléversement. Pour plus d'informations, consultez les instructions dans URL et informations d'identification 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:CreateUploadAttachedMedia

    create

    *All Resource

    *

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    Title

    string

    Non

    Le titre de la ressource média auxiliaire. Règles :

    • Le titre peut comporter jusqu'à 128 octets.

    • Le titre doit être encodé en UTF-8.

    Test
    BusinessType

    string

    Oui

    Le type de la ressource média auxiliaire. Valeurs valides :

    • watermark : filigrane.

    • subtitle : sous-titre.

    • material : matériau.

    watermark
    MediaExt

    string

    Non

    L'extension de nom de fichier du fichier source de la ressource média auxiliaire à téléverser. Valeurs valides :

    • Filigrane : png, gif, apng, mov.

    • Sous-titre : srt, ass, stl, ttml, vtt.

    • Matériau : jpg, gif, png, mp4, mat, zip, apk.

    Valeurs valides :

    • ass :

      ass.

    • jpg :

      jpg.

    • zip :

      zip.

    • mat :

      mat.

    • gif :

      gif.

    • apng :

      apng.

    • png :

      png.

    • ttml :

      ttml.

    • stl :

      stl.

    • mp4 :

      mp4

    • srt :

      srt.

    • mov :

      mov.

    • vtt :

      vtt.

    • apk :

      apk.

    png
    FileName

    string

    Non

    L'adresse du fichier source de la ressource média auxiliaire à téléverser.

    Remarque

    L'extension de nom de fichier est facultative. Si une extension de nom de fichier est spécifiée ici et qu'elle est différente de l'extension spécifiée dans MediaExt, la valeur de MediaExt prévaut.

    D:\test.png
    FileSize

    string

    Non

    La taille du fichier. Unité : octets.

    123
    Tags

    string

    Non

    Les balises. Règles :

    • Un maximum de 16 balises est pris en charge.

    • Séparez les balises multiples par des virgules (,).

    • Chaque balise peut comporter jusqu'à 32 caractères ou caractères chinois.

    • Les balises doivent être encodées en UTF-8.

    tag1,tag2
    StorageLocation

    string

    Non

    L'adresse de stockage. Vous pouvez obtenir l'adresse de stockage en utilisant la méthode suivante :

    Connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Configuration de la gestion des ressources média > Gestion du stockage pour afficher l'adresse de stockage.

    Remarque

    Si vous ne spécifiez pas ce paramètre, la ressource média auxiliaire est téléversée vers l'adresse de stockage par défaut. Si vous spécifiez ce paramètre, la ressource média auxiliaire est téléversée vers l'adresse de stockage spécifiée.

    out-****.oss-cn-shanghai.aliyuncs.com
    Description

    string

    Non

    La description de la ressource média. Règles :

    • La description peut comporter jusqu'à 1 024 octets.

    • La description doit être encodée en UTF-8.

    uploadTest
    UserData

    string

    Non

    Les paramètres personnalisés, qui correspondent à une chaîne JSON. Les paramètres prennent en charge les rappels de messages, l'accélération du téléversement et d'autres configurations. Pour plus d'informations, consultez UserData.

    Remarque

    • Pour utiliser les rappels de messages 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 téléversement, soumettez un ticket pour l'activer. 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"}}
    CateIds

    string

    Non

    Les identifiants de catégorie. Séparez les identifiants multiples par des virgules (,). Un maximum de 5 identifiants est pris en charge. Vous pouvez obtenir les identifiants de catégorie en utilisant les méthodes suivantes :

    • Connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Configuration de la gestion des ressources média > Gestion des catégories pour afficher les identifiants de catégorie.

    • L'identifiant de catégorie est renvoyé lorsque vous appelez l'opération AddCategory pour créer une catégorie.

    • L'identifiant de catégorie est renvoyé lorsque vous appelez l'opération GetCategories pour interroger des catégories.

    1298****,0813****
    AppId

    string

    Non

    L'identifiant de l'application. Valeur par défaut : app-1000000. Si vous avez activé le service multi-applications, spécifiez l'identifiant de l'application pour téléverser la ressource média auxiliaire vers l'application spécifiée. Pour plus d'informations, consultez Multi-application.

    app-****

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    Les paramètres de réponse.

    FileURL

    string

    L'URL OSS du fichier de la ressource média auxiliaire (sans authentification).

    Lorsque vous ajoutez un modèle de filigrane d'image, cette URL peut être utilisée comme paramètre de requête FileUrl de l'opération AddWatermark.

    https://****.oss-cn-shanghai.aliyuncs.com/watermark/****.mov
    RequestId

    string

    L'identifiant de la requête.

    73254DE5-F260-4720-D06856B63C01****
    UploadAddress

    string

    L'URL de téléversement.

    Remarque

    L'URL de téléversement renvoyée par l'opération est une valeur encodée en Base64. Lorsque vous utilisez le SDK ou l'API pour téléverser des ressources média, vous devez décoder la valeur en Base64 avant de l'utiliser. Seuls les téléversements utilisant le SDK natif OSS ou l'API OSS nécessitent que vous analysiez vous-même UploadAddress.

    LWNuLXNoYW5naGFpLmFsaXl1b****
    MediaId

    string

    L'identifiant de la ressource média.

    97dc17a5abc3668489b84ce9****
    MediaURL

    string

    L'URL d'accès de la ressource média.

    Si un nom de domaine CDN est configuré, une URL CDN est renvoyée. Sinon, une URL OSS est renvoyée.

    Remarque

    Si l'URL MediaURL renvoyée est inaccessible dans un navigateur (403), vous avez activé l'authentification d'URL pour le nom de domaine VOD. Vous pouvez désactiver l'authentification d'URL ou générer vous-même une signature d'authentification.

    http://example.aliyundoc.com/watermark/****.mov?auth_key=****
    UploadAuth

    string

    Les informations d'identification de téléversement.

    Remarque

    Les informations d'identification de téléversement renvoyées par l'opération sont une valeur encodée en Base64. Lorsque vous utilisez le SDK ou l'API pour téléverser des ressources média, vous devez décoder la valeur en Base64 avant de l'utiliser. Seuls les téléversements utilisant le SDK natif OSS ou l'API OSS nécessitent que vous analysiez vous-même UploadAuth.

    UzFnUjFxNkZ0NUIZTaklyNWJoQ00zdHF****

    Exemples

    JSON format

    {
  "FileURL": "https://****.oss-cn-shanghai.aliyuncs.com/watermark/****.mov",
  "RequestId": "73254DE5-F260-4720-D06856B63C01****",
  "UploadAddress": "LWNuLXNoYW5naGFpLmFsaXl1b****",
  "MediaId": "97dc17a5abc3668489b84ce9****",
  "MediaURL": "http://example.aliyundoc.com/watermark/****.mov?auth_key=****",
  "UploadAuth": "UzFnUjFxNkZ0NUIZTaklyNWJoQ00zdHF****"
}

    Codes d'erreur

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

    Notes de version

    Consultez Notes de version pour la liste complète.