Tous les produits
Search

Ce produit

    Image Search:UpdateImage

    Centre de documentation

    Image Search:UpdateImage

    Dernière mise à jour :Oct 22, 2026

    Cette rubrique décrit la syntaxe et les exemples de l'opération UpdateImage, qui modifie les informations d'image dans une instance Image Search.

    Description de l'opération

    Description de l'opération

    Cette opération modifie les informations d'image dans une instance Image Search en fonction de l'identifiant du produit et du nom de l'image.

    Remarque

    • Des exigences relatives à la date de création de l'instance s'appliquent.

    • Les instances créées après décembre 2021 dans la région de Singapour sont prises en charge. Les instances dans d'autres régions ne sont actuellement pas prises en charge.

    • Pour plus d'informations sur le produit ou pour obtenir une assistance technique, cliquez sur Consultation en ligne ou contactez-nous via le groupe DingTalk (35035130).

    Limite de QPS

    La concurrence par défaut pour les opérations de mise à jour est de 20, ce qui signifie qu'un maximum de 20 requêtes 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:UpdateImage

    update

    *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. Ne confondez pas les deux.

    demoinstance1
    ProductId

    string

    Oui

    L'identifiant du produit. L'identifiant peut comporter jusqu'à 256 caractères.

    Remarque

    Un produit peut avoir plusieurs images. Définissez ce paramètre en fonction de vos besoins métier. Par exemple : top001, pants002.

    2092061_1
    PicName

    string

    Non

    Le nom de l'image. Le nom peut comporter jusqu'à 256 caractères.

    Remarque

    • ProductId et PicName identifient de manière unique une image. ProductId et PicName ne peuvent pas être modifiés.

    • Si vous ajoutez plusieurs images avec les mêmes ProductId et PicName, seule la dernière image ajoutée est conservée. Les images ajoutées précédemment sont écrasées.

    • Si vous ne spécifiez pas PicName, les informations de l'image sont modifiées en fonction de ProductId.

    • Si vous spécifiez PicName, les informations de l'image sont modifiées en fonction de ProductId et PicName.

    namexxx.jpg
    CustomContent

    string

    Non

    Le contenu personnalisé. Le contenu peut comporter jusqu'à 4 096 caractères.

    Remarque

    Ce champ est renvoyé lorsque vous appelez l'opération SearchImageByPic. Par exemple, vous pouvez ajouter une description textuelle de l'image.

    zidingyi
    IntAttr

    integer

    Non

    L'attribut entier. Cet attribut peut être utilisé pour filtrer les résultats lors des requêtes et est renvoyé dans les résultats de requête.

    2
    StrAttr

    string

    Non

    L'attribut chaîne. La valeur peut comporter jusqu'à 128 caractères. Cet attribut peut être utilisé pour filtrer les résultats lors des requêtes et est renvoyé dans les résultats de requête.

    ss
    IntAttr2

    integer

    Non

    L'attribut entier. Cet attribut peut être utilisé pour filtrer les résultats lors des requêtes et est renvoyé dans les résultats de requête.

    20
    StrAttr2

    string

    Non

    L'attribut chaîne. La valeur peut comporter jusqu'à 128 caractères. Cet attribut peut être utilisé pour filtrer les résultats lors des requêtes et est renvoyé dans les résultats de requête.

    test
    IntAttr3

    integer

    Non

    L'attribut entier. Cet attribut peut être utilisé pour filtrer les résultats lors des requêtes et est renvoyé dans les résultats de requête.

    33
    StrAttr3

    string

    Non

    L'attribut chaîne. La valeur peut comporter jusqu'à 128 caractères. Cet attribut peut être utilisé pour filtrer les résultats lors des requêtes et est renvoyé dans les résultats de requête.

    ss
    IntAttr4

    integer

    Non

    L'attribut entier. Cet attribut peut être utilisé pour filtrer les résultats lors des requêtes et est renvoyé dans les résultats de requête.

    33
    StrAttr4

    string

    Non

    L'attribut chaîne. La valeur peut comporter jusqu'à 128 caractères. Cet attribut peut être utilisé pour filtrer les résultats lors des requêtes et est renvoyé dans les résultats de requête.

    ss

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

    E0845DE6-52AF-4B50-9F15-51ED4044E6AB
    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

    Exemples

    JSON format

    {
  "Message": "success",
  "RequestId": "E0845DE6-52AF-4B50-9F15-51ED4044E6AB",
  "Code": 0,
  "Success": true
}

    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 NoPicList The body content is missing the pic_list parameter.
    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 PicNotExist The search picture does not exist.
    400 NoSpecifiedProductId The parameter ProductId no specified.
    400 NoSpecifiedPicName The parameter PicName no specified.
    400 NoSpecifiedPicContent The parameter PicContent no specified.
    400 InvalidType The specified parameter Type is not valid.
    400 InvalidProductId The specified parameter ProductId is not valid.
    400 InvalidPicName The specified parameter PicName is not valid.
    400 InvalidStrAttr The specified parameter StrAttr is not valid. Invalid StrAttr
    400 InvalidCustomContent The specified parameter CustomContent is not valid.
    400 InvalidPicContent The specified parameter PicContent length greater than 4 * 1024 * 1024.
    400 TimeoutForTransferImage Timeout after 5 seconds waiting for images transfer to complete.
    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 UnsupportedInstanceType The instance type is not supported.
    400 UnsupportedOperationType The specified action is not supported.
    500 InternalError 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.