Tous les produits
Search

Ce produit

    :CreateUploadImage

    Centre de documentation

    :CreateUploadImage

    Dernière mise à jour :Aug 05, 2026

    Obtient l'URL de chargement et les informations d'identification de chargement pour charger une image dans ApsaraVideo VOD, et crée les informations de l'image. ApsaraVideo VOD émet des URL et des informations d'identification de chargement pour garantir l'autorisation et la sécurité, empêcher les chargements malveillants, et prend en charge la création automatique d'un identifiant d'image (ImageId) pour la gestion. Vous pouvez appeler cette opération pour obtenir l'URL et les informations d'identification de chargement et créer les informations de l'image.

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

    • Cette opération obtient uniquement l'URL et les informations d'identification de chargement et crée les informations de base de la ressource multimédia. Elle ne charge pas les fichiers. Pour un exemple complet de chargement de fichiers en appelant des opérations d'API, consultez Charger des fichiers multimédias à l'aide de l'API ApsaraVideo VOD.

    • L'actualisation de l'URL et des informations d'identification de chargement n'est pas prise en charge pour les chargements d'images. Si les informations d'identification de chargement de l'image expirent (la période de validité par défaut est de 3 000 secondes), appelez à nouveau cette opération pour obtenir une nouvelle URL et de nouvelles informations d'identification de chargement.

    • Vous pouvez configurer des rappels pour recevoir des notifications d'événements pour la fin du chargement de l'image afin de déterminer si le chargement a réussi.

    • L'obtention de l'URL et des informations d'identification de chargement est une opération fondamentale d'ApsaraVideo VOD et est requise pour chaque chargement. ApsaraVideo VOD fournit plusieurs méthodes de chargement, chacune ayant des exigences différentes pour l'obtention de l'URL et des informations d'identification de chargement. Pour plus d'informations, consultez URL et informations d'identification 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:CreateUploadImage

    create

    *All Resource

    *

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    Title

    string

    Non

    Le titre de l'image. Règles :

    • Le titre peut comporter jusqu'à 128 caractères.

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

    mytitle
    ImageType

    string

    Oui

    Le type de l'image. Valeurs valides :

    • default (par défaut) : une image courante.

    • cover : une miniature vidéo.

    Remarque

    La console ApsaraVideo VOD prend en charge l'affichage et la gestion uniquement des images de type default.

    default
    ImageExt

    string

    Non

    L'extension de nom de fichier du fichier source de l'image à charger. Valeurs valides :

    • png (par défaut)

    • jpg

    • jpeg

    • gif

    • heic

    • webp

    png
    OriginalFileName

    string

    Non

    L'adresse du fichier source de l'image à charger.

    Remarque

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

    D:\picture_01
    Tags

    string

    Non

    Les balises de l'image. Règles :

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

    • Vous pouvez spécifier jusqu'à 16 balises.

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

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

    Test
    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 > Gestion des médias > Stockage pour afficher l'adresse de stockage.

    Remarque

    Si vous ne spécifiez pas ce paramètre, l'image est chargée à l'adresse de stockage par défaut. Si vous spécifiez ce paramètre, l'image est chargée à l'adresse de stockage spécifiée.

    outin-****..oss-cn-shanghai.aliyuncs.com
    CateId

    integer

    Non

    L'identifiant de la catégorie. Vous pouvez obtenir l'identifiant de la catégorie en utilisant les méthodes suivantes :

    • Connectez-vous à la console ApsaraVideo VOD et choisissez Gestion de la configuration > Gestion des médias > Catégories pour afficher l'identifiant de la catégorie.

    • Obtenez la valeur de CateId à partir de la réponse lorsque vous appelez l'opération AddCategory pour créer une catégorie.

    • Obtenez la valeur de CateId à partir de la réponse lorsque vous appelez l'opération GetCategories pour interroger les catégories.

    100036****
    UserData

    string

    Non

    Les paramètres personnalisés dans une chaîne JSON. Les paramètres prennent en charge les rappels de messages, l'accélération du chargement 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 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 Nous contacter.

    {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
    Description

    string

    Non

    La description de l'image.

    • La description peut comporter jusqu'à 1 024 caractères.

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

    Test de chargement d'image
    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 charger l'image dans l'application spécifiée. Pour plus d'informations, consultez Multi-application.

    app-1000000

    Éléments de réponse

    Élément

    Type

    Description

    Exemple

    object

    Les paramètres de réponse.

    FileURL

    string

    L'URL OSS du fichier image (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.

    http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png
    RequestId

    string

    L'identifiant de la requête.

    25818875-5F78-AEF6-D7393642****
    UploadAddress

    string

    L'URL de chargement.

    Remarque

    L'URL de chargement renvoyée par cette opération est une valeur encodée en Base64. Lorsque vous utilisez un SDK ou une API pour charger des ressources multimédias, décodez la valeur en Base64 avant utilisation. Seuls les chargements utilisant le SDK natif OSS ou l'API OSS nécessitent l'analyse de UploadAddress.

    eyJTZWN1cmuIjoiQ0FJU3p3TjF****
    ImageURL

    string

    L'URL d'accès de l'image.

    Remarque

    Si l'URL ImageURL renvoyée est inaccessible dans un navigateur (erreur 403), l'authentification par URL est activée pour votre nom de domaine VOD. Désactivez l'authentification par URL ou générez une URL signée.

    http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png
    ImageId

    string

    L'identifiant de l'image. Cet identifiant peut être utilisé comme paramètre de requête pour des opérations telles que GetImageInfo, GetImageInfos, UpdateImageInfos et DeleteImage.

    93ab850b4f6f46e91d24d81d4****
    UploadAuth

    string

    Les informations d'identification de chargement.

    Remarque

    Les informations d'identification de chargement renvoyées par cette opération sont une valeur encodée en Base64. Lorsque vous utilisez un SDK ou une API pour charger des ressources multimédias, décodez la valeur en Base64 avant utilisation. Seuls les chargements utilisant le SDK natif OSS ou l'API OSS nécessitent l'analyse de UploadAuth.

    eyJFbmmRCI6Im****

    Exemples

    JSON format

    {
  "FileURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
  "RequestId": "25818875-5F78-AEF6-D7393642****",
  "UploadAddress": "eyJTZWN1cmuIjoiQ0FJU3p3TjF****",
  "ImageURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
  "ImageId": "93ab850b4f6f46e91d24d81d4****",
  "UploadAuth": "eyJFbmmRCI6Im****"
}

    Codes d'erreur

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

    Notes de version

    Consultez Notes de version pour la liste complète.