Tous les produits
Search
Centre de documentation

Image Search:DeleteImage

Dernière mise à jour :Oct 22, 2026

Cette rubrique décrit la syntaxe et les exemples de l'opération DeleteImage, utilisée pour supprimer les informations d'image d'une instance Image Search.

Description de l'opération

Remarques sur l'utilisation

Cette opération est utilisée pour supprimer les informations d'image d'une instance Image Search.

Remarque
  • Si l'image spécifiée n'existe pas dans l'instance Image Search, cette opération renvoie tout de même une réponse de succès. N'utilisez pas la réponse pour déterminer si l'image existe.

Limite de QPS

La concurrence par défaut pour les opérations de suppression est de 20, ce qui signifie qu'un maximum de 20 requêtes de suppression peuvent être traitées par seconde.

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.

imagesearch:DeleteImage

delete

*All Resource

*

Aucune Aucune

Paramètres de requête

Paramètre

Type

Requis

Description

Exemple

InstanceName

string

Oui

Le nom de l'instance Image Search. Le nom peut comporter jusqu'à 20 caractères. Si vous avez acheté une instance Image Search, connectez-vous à la console Image Search pour afficher le nom de l'instance. Si vous n'avez pas acheté d'instance Image Search, reportez-vous à Activer le service et Créer une instance.

Remarque

Le nom de l'instance n'est pas l'identifiant de l'instance. Le nom de l'instance doit être unique dans la même région. Assurez-vous de bien faire la distinction entre les deux.

demoinstance1

ProductId

string

Non

L'identifiant du produit.

Remarque
  1. Un produit peut avoir plusieurs images. 2. Si IsDeleteByFilter est défini sur false, ce paramètre est requis.

2092061_1

PicName

string

Non

Le nom de l'image.

  • Si vous ne spécifiez pas ce paramètre, toutes les images sous le ProductId spécifié sont supprimées.

  • Si vous spécifiez ce paramètre, l'image spécifiée par ProductId et PicName est supprimée.

2092061_1.jpg

IsDeleteByFilter

boolean

Non

Indique si les images doivent être supprimées en fonction du champ Filter.

Remarque
  1. Si ce paramètre est défini sur true, les images sont supprimées en fonction de Filter ou Filter+ProductId, et Filter est requis. 2. Si ce paramètre est défini sur false, les images sont supprimées en fonction de ProductId ou ProductId+PicName, et ProductId est requis.

false

Filter

string

Non

La condition de filtrage. Le champ int_attr prend en charge les opérateurs suivants : supérieur à (>), supérieur ou égal à (>=), inférieur à (<), inférieur ou égal à (<=) et égal à (=). Le champ str_attr prend en charge les opérateurs suivants : égal à (=) et différent de (!=). Plusieurs conditions peuvent être reliées à l'aide de AND et OR. Exemples :

  • int_attr >= 100.

  • str_attr != "value1".

  • int_attr = 1000 AND str_attr = "value1".

Remarque

Un maximum de 4 096 caractères est pris en charge.

int_attr=1000 AND str_attr="value1"

Éléments de réponse

Élément

Type

Description

Exemple

object

L'objet de réponse.

Message

string

Le message d'erreur.

success

RequestId

string

L'identifiant de la requête.

0703956F-9BCC-48FA-99F7-96C0BF449C69

Code

integer

Le code d'erreur. Valeurs valides :

  • 0 : succès.

  • Valeur non nulle : échec.

0

Success

boolean

Indique si la requête a réussi.

true

Data

object

Le résultat de la suppression.

PicNames

array

Les valeurs PicName supprimées.

5555.jpg

string

Les valeurs PicName supprimées.

xxx.jpg

Exemples

JSON format

{
  "Message": "success",
  "RequestId": "0703956F-9BCC-48FA-99F7-96C0BF449C69",
  "Code": 0,
  "Success": true,
  "Data": {
    "PicNames": [
      "xxx.jpg"
    ]
  }
}

Codes d'erreur

Code de statut HTTP

Code d'erreur

Message d'erreur

Description

400 BadRequest The request has invalid parameters.
400 InstanceStatusError Your instance is unavailable.
400 InvalidInstance The specified instance name is invalid.
400 NoCaretSeperator The body content is missing the ^ separator.
400 EmptyMeta The body content has an empty meta field.
400 InvalidMetaItem The meta field is invalid.
400 InvalidPicList The specified pic_list parameter is invalid.
400 NoSpecifiedPic The content of an image is not specified in the HTTP POST body.
400 NoSpecifiedSearchPic The search image is not specified.
400 InvalidCategory The specified category is invalid.
400 OverflowMaxResultNum The specified number of total results exceeds the maximum of 500.
400 OverflowMaxReturnNum The specified number of results for each request exceeds the maximum of 100.
400 InvalidStartParameter The specified parameter s is inavlid.
400 InvalidNumParameter The specified parameter n is invalid.
400 NoSpecifiedAddPic The image to insert is not specified.
400 NoSpecifiedItemId The item_id parameter is not specified.
400 InvalidIntAttr The specified int_attr field is invalid.
400 UnsupportedPicFormat The specified image format is invalid.
400 InvalidFilterClause The specified filtering condition is invalid.
400 InstanceOverQuota The number of items exceeds the limit.
400 IncorrectOrientation The image contains incorrect rotation flags in the meta data.
400 UnsupportedPicPixels The specified pixels is not supported.
400 SearchTimeout The request is timed out.
400 NoSpecifiedProductId You must specify ProductId.
400 InvalidIntAttr4 The specified parameter IntAttr4 is not valid. Invalid
400 InvalidIntAttr3 The specified parameter IntAttr3 is not valid. Invalid IntAttr3
400 InvalidIntAttr2 The specified parameter IntAttr2 is not valid. Invalid IntAttr2
400 InvalidStrAttr4 The specified parameter StrAttr4 is not valid. Invalid StrAttr4
400 InvalidStrAttr3 The specified parameter StrAttr3 is not valid. Invalid StrAttr3
400 InvalidStrAttr2 The specified parameter StrAttr2 is not valid. Invalid
400 InvalidStrAttr The specified parameter StrAttr is not valid. Invalid StrAttr
400 UnsupportedOperationType The specified action is not supported.
400 UnsupportedInstanceType The instance type is not supported.
500 UnknownlException An internal server error occurred.
500 UnknownException An internal server error occurred.
500 NetworkException A network error occurred.
500 RequestTimeout ​The request is timeout.
500 ExtractFeatureTimeout The request was timed out while extracting features.
500 AccessEngineFailed An error occurred while accessing the search engine.
500 InternalOssError An internal OAS error occurred.
500 InternalSwiftError An internal SWIFT error occurred.
500 InternalTableStoreError An internal Table Store error occurred.
403 NoPermission You are not authorized to perform this operation.
403 DeniedRequest Your request was denied due to instance flow control.

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

Notes de version

Consultez Notes de version pour la liste complète.