Tous les produits
Search
Centre de documentation

:DeleteImage

Dernière mise à jour :Aug 05, 2026

Supprime les images téléchargées par les utilisateurs ou les images générées à partir d'instantanés vidéo.

Description de l'opération

  • Lorsque vous appelez cette opération pour supprimer des images, les fichiers source sont définitivement supprimés. Cette action est irréversible. Une fois supprimées, les images ne peuvent pas être récupérées. Procédez avec prudence.

  • Lorsque DeleteImageType est défini sur VideoId, VideoId et ImageType sont disponibles et requis.

  • Lorsque DeleteImageType est défini sur ImageURL, ImageIds et ImageURLs sont disponibles et requis.

  • Après avoir appelé cette opération pour supprimer des images, des caches CDN peuvent encore exister dans certains cas, ce qui signifie que les URL des images peuvent ne pas devenir invalides immédiatement.

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:DeleteImage

delete

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

DeleteImageType

string

Oui

Le type d'opération de suppression d'image. Valeurs valides :

  • ImageURL : supprime les images en fonction des URL d'image.

  • ImageId : supprime les images en fonction des identifiants d'image.

  • VideoId : supprime les images associées à une vidéo en fonction de l'identifiant de la vidéo.

VideoId

ImageURLs

string

Non

Les URL des images. La valeur est le paramètre ImageURL renvoyé par l'opération CreateUploadImage. Séparez plusieurs URL par des virgules (,). Un maximum de 20 URL est pris en charge.

Remarque

Ce paramètre est disponible et requis uniquement lorsque DeleteImageType est défini sur ImageURL.

https://example.aliyundoc.com/image/default/41AE7ADABBE*****.png

ImageIds

string

Non

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

  • Connectez-vous à la console ApsaraVideo VOD et choisissez Fichiers multimédias > Image pour afficher les identifiants.

  • Obtenez les identifiants à partir de la réponse de l'opération CreateUploadImage appelée pour obtenir l'URL et les informations d'identification de téléchargement.

  • Obtenez les identifiants à partir de la réponse de l'opération SearchMedia appelée pour interroger les images.

Remarque

Ce paramètre est disponible et requis uniquement lorsque DeleteImageType est défini sur ImageId.

bbc65bba53fed90de118a7849****,594228cdd14b4d069fc17a8c4a****

VideoId

string

Non

L'identifiant de la vidéo. Un seul identifiant de vidéo est pris en charge. Vous pouvez obtenir l'identifiant de la vidéo en utilisant les méthodes suivantes :

  • Connectez-vous à la console ApsaraVideo VOD et choisissez Fichiers multimédias > Audio/Vidéo pour afficher l'identifiant de la vidéo.

  • Obtenez l'identifiant à partir de la réponse de l'opération CreateUploadVideo appelée pour obtenir l'URL et les informations d'identification de téléchargement.

  • Obtenez l'identifiant à partir de la réponse de l'opération SearchMedia appelée pour interroger les vidéos.

Remarque

Ce paramètre est disponible et requis uniquement lorsque DeleteImageType est défini sur VideoId.

eb1861d2c9a8842340e989dd56****

ImageType

string

Non

Le type d'images associées à la vidéo que vous souhaitez supprimer. Valeurs valides :

  • CoverSnapshot : instantané de miniature.

  • NormalSnapshot : instantané standard.

  • SpriteSnapshot : instantané de sprite.

  • SpriteOriginSnapshot : image source de sprite.

  • All : tous les types d'images précédents. Si la valeur n'est pas All, vous pouvez spécifier plusieurs types d'images. Séparez les différentes valeurs par des virgules (,).

Remarque

Ce paramètre est disponible et requis uniquement lorsque DeleteImageType est défini sur VideoId.

All

É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.

25818875-5F78-4AF6-D7393642CA58****

Exemples

JSON format

{
  "RequestId": "25818875-5F78-4AF6-D7393642CA58****"
}

Codes d'erreur

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

Notes de version

Consultez Notes de version pour la liste complète.