Tous les produits
Search

Ce produit

    :UploadMediaByURL

    Centre de documentation

    :UploadMediaByURL

    Dernière mise à jour :Aug 06, 2026

    Appelle l'opération UploadMediaByURL pour récupérer des fichiers multimédias audio et vidéo à partir d'URL de fichiers sources afin de les téléverser. Les téléversements par lot sont pris en charge. Cette opération s'applique principalement aux scénarios où les fichiers ne sont pas stockés sur un service ou un terminal local et doivent être téléversés via une URL prenant en charge l'accès au réseau public.

    Description de l'opération

    Description de l'opération

    • Si un rappel est configuré, vous recevez une notification d'événement concernant la fin du téléversement de vidéo par URL une fois le téléversement terminé. Vous pouvez appeler l'opération d'obtention des informations de téléversement par URL pour interroger l'état du téléversement.

    • Une fois qu'une tâche de téléversement est soumise avec succès, une tâche asynchrone est générée dans le cloud et mise en file d'attente pour exécution. Une fois le téléversement 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).

    Limites

    • Cette opération prend uniquement en charge le téléversement vers le stockage VOD, et non vers le stockage Object Storage Service (OSS) appartenant à l'utilisateur. Si vous utilisez votre propre stockage OSS, récupérez d'abord le fichier sur un appareil local, téléversez le fichier vers OSS en utilisant le SDK OSS, puis appelez l'opération RegisterMediaInfo pour enregistrer le fichier OSS dans la bibliothèque de ressources multimédias.

    • Cette opération n'est actuellement prise en charge que dans les régions Chine (Shanghai), Chine (Pékin) et Chine (Shenzhen).

    • Cette opération prend uniquement en charge le téléversement de fichiers audio et vidéo.

    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.

    ice:UploadMediaByURL

    create

    *All Resource

    *

    		 Aucune Aucune

    Paramètres de requête

    Paramètre

    Type

    Requis

    Description

    Exemple
    UploadURLs

    string

    Non

    L'URL du fichier source multimédia.

    • L'URL doit inclure une extension de fichier. Par exemple, mp4 est l'extension de fichier dans https://****.mp4.

      • Si l'URL n'inclut pas d'extension de fichier, vous pouvez spécifier le paramètre FileExtension dans UploadMetadatas.

      • Si l'URL inclut une extension de fichier et que le paramètre FileExtension est également spécifié, la valeur de FileExtension est prioritaire.

    • Encodez les URL. Séparez plusieurs URL par des virgules (,). Un maximum de 20 URL est pris en charge.

    • Pour éviter les échecs de téléversement causés par des caractères spéciaux, encodez chaque URL avant de les concaténer avec des virgules.

    https://diffurl.mp4
    AppId

    string

    Non

    L'identifiant de l'application.

    app-1000000
    UserData

    string

    Non

    Les paramètres personnalisés. La valeur est une chaîne JSON qui prend en charge des paramètres tels que les rappels de message.

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

    string

    Non

    L'adresse de stockage de destination.

    • StorageType : seul oss est pris en charge.

    • StorageLocation : seul le stockage VOD est pris en charge. Le stockage OSS appartenant à l'utilisateur n'est pas pris en charge.

    {"StorageType":"oss","StorageLocation":"outin-***.oss-cn-shanghai.aliyuncs.com"}
    MediaMetaData

    string

    Non

    Les métadonnées du fichier multimédia à téléverser. La valeur est une chaîne JSON.

    • Les métadonnées ne prennent effet que 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"}]
    PostProcessConfig

    string

    Non

    L'action de traitement post-téléversement lorsque Type est défini sur video ou audio.

    Valeurs valides de ProcessType : Workflow.

    {"ProcessType": "Workflow","ProcessID":"b72a06c6beeb4dcdb898feef067b1***"}
    EntityId

    string

    Non

    L'identifiant de l'entité. Vous pouvez appeler l'opération CreateEntity pour créer une entité et définir une structure de métadonnées dynamiques personnalisée.

    d67281da3c8743b8823ad12976187***

    UploadMetadata

    NomTypeObligatoireDescription
    SourceURLStringOuiL'URL du fichier source multimédia à téléverser.
    TitleStringOuiLe titre du média. Le titre peut comporter jusqu'à 128 octets. Encodé en UTF-8.
    FileSizeStringNonLa taille du fichier.
    DescriptionStringNonLa description. La description peut comporter jusqu'à 1024 octets. Encodée en UTF-8.
    CoverURLStringNonL'URL de la miniature vidéo personnalisée.
    CateIdStringNonL'identifiant de la catégorie.
    TagsStringNonLes balises. Chaque balise peut comporter jusqu'à 32 octets. Un maximum de 16 balises est pris en charge. Séparez plusieurs balises par des virgules (,). Encodées en UTF-8.
    WorkflowIdStringNonL'identifiant du flux de travail.
    FileExtensionStringNonL'extension de fichier du fichier multimédia.
    DynamicMetaDataStringNonLes métadonnées dynamiques. Exemple : "{"Uploader": "xxx"}".
    EntityIdStringNonL'identifiant de l'entité.
    Remarque

    • La tâche du paramètre WorkflowId est une tâche asynchrone. Après soumission, la tâche n'est pas immédiatement terminée et est mise en file d'attente pour une exécution asynchrone en arrière-plan.

    • Les paramètres dans UploadMetadata (tels que Title, Description et Tags) ne peuvent pas contenir de caractères emoji.

    • Si un rappel est configuré, une fois le téléversement de la vidéo terminé, vous recevez une notification de fin de téléversement de vidéo par URL en plus des notifications de téléversement et de transcodage.

    • Lorsque les tâches sont soumises par lot, 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.

    ****83B7-7F87-4792-BFE9-63CD2137****
    UploadJobs

    array<object>

    Les informations sur plusieurs tâches.

    object

    Les détails de la tâche de téléversement.

    JobId

    string

    L'identifiant de la tâche de téléversement.

    20ce1e05dba64576b96e9683879f0***
    SourceURL

    string

    L'URL du fichier source de la tâche de téléversement.

    http://example****.mp4
    MediaId

    string

    L'identifiant de la ressource multimédia.

    f476988629f54a7b8a4ba90d1a6c7***

    Exemples

    JSON format

    {
  "RequestId": "****83B7-7F87-4792-BFE9-63CD2137****",
  "UploadJobs": [
    {
      "JobId": "20ce1e05dba64576b96e9683879f0***",
      "SourceURL": "http://example****.mp4\n",
      "MediaId": "f476988629f54a7b8a4ba90d1a6c7***"
    }
  ]
}

    Codes d'erreur

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

    Notes de version

    Consultez Notes de version pour la liste complète.