Tous les produits
Search
Centre de documentation

Elasticsearch:UpdateAliwsDict

Dernière mise à jour :Aug 09, 2026

Appelez l'opération UpdateAliwsDict pour mettre à jour le fichier de dictionnaire du tokenizer AliNLP (analysis-aliws). Cette opération permet de configurer des dictionnaires personnalisés.

Tenez compte des points suivants lors de l'appel à cette interface :

  • Les clusters Alibaba Cloud Elasticsearch V5.0 ne prennent pas en charge le plug-in analysis-aliws.

  • Si le fichier de dictionnaire provient d'OSS, assurez-vous que le bucket OSS est accessible en lecture publique.

  • Si la configuration ORIGIN n'est pas appliquée à un fichier de dictionnaire précédemment téléchargé, ce fichier sera supprimé après l'exécution de cette opération.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

En-têtes de requête

Cette opération utilise uniquement les paramètres de requête communs et n'implique aucun en-tête de requête spécifique. Pour plus d'informations, consultez la rubrique relative aux paramètres communs.

Syntaxe de la requête

PUT /openapi/instances/[InstanceId]/aliws-dict HTTP/1.1

Paramètres de requête

Paramètre Type Position Obligatoire Exemple Description
InstanceId String Path Oui es-cn-n6w1o1x0w001c****

ID de l'instance.

clientToken String Query Non 5A2CFF0E-5718-45B5-9D4D-70B3FF****

Ce paramètre garantit l'idempotence de la requête. Vous pouvez générer la valeur via le client, mais vous devez vous assurer qu'elle est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et sa longueur ne doit pas dépasser 64 caractères.

RequestBody

Saisissez les paramètres suivants dans le corps de la requête (RequestBody).

Paramètre

Type

Obligatoire

Exemple

Description

name

String

Oui

aliws_ext_dict.txt

Nom du fichier de dictionnaire téléchargé.

ossObject

Array

Oui

Description du fichier de stockage ouvert sur OSS. Ce paramètre est requis lorsque sourceType est défini sur OSS.

└bucketName

String

Oui

search-cloud-test-cn-****

Nom du bucket OSS.

└key

String

Oui

oss/aliws_ext_dict.txt

Chemin de stockage du fichier de dictionnaire dans le bucket OSS.

sourceType

String

Oui

OSS

Type de source du fichier de dictionnaire. Valeurs valides : OSS (service de stockage ouvert utilisant OSS) et ORIGIN (conservation des dictionnaires précédemment téléchargés).

Remarque :

Le fichier local doit être téléchargé sur OSS, puis référencé via OSS.

Si un dictionnaire n'est pas configuré avec ORIGIN lors du téléchargement précédent, il est supprimé par le système.

type

String

Oui

ALI_WS

Type de dictionnaire. Champ statique : ALI_WS (segmentation de mots AliNLP).

Remarque

└ indique un paramètre enfant.

Exemples :

[
    {
        "name":"deploy_0.txt",
        "ossObject":{
            "bucketName":"search-cloud-test-cn-****",
            "key":"user_dict/dict_0.txt"
        },
        "sourceType":"OSS",
        "type":"ALI_WS"
    },
    {
        "name":"aliws_ext_dict.txt",
        "sourceType":"ORIGIN",
       "type":"ALI_WS"
    }
]

Paramètres de réponse

Paramètre Type Exemple Description
RequestId String 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

ID de la requête.

Result Array of DictList

Résultats renvoyés.

fileSize Long 6226

Taille du fichier. Unité : octet.

name String aliws_ext_dict.txt

Nom du fichier téléchargé.

sourceType String OSS

Type de source du fichier de dictionnaire. Valeurs valides :

  • OSS : Utiliser le stockage ouvert OSS.
  • ORIGIN : Conserver les dictionnaires qui ont été téléchargés.
type String ALI_WS

Type de dictionnaire. Valeurs valides : ALI_WS (segmentation de mots AliNLP).

Exemples

Exemple de requête

PUT /openapi/instances/es-cn-n6w1o1x0w001c****/aliws-dict HTTP/1.1
common request header
[
    {
        "name":"deploy_0.txt",
        "ossObject":{
            "bucketName":"search-cloud-test-cn-****",
            "key":"user_dict/dict_0.txt"
        },
        "sourceType":"OSS",
        "type":"ALI_WS"
    },
    {
        "name":"aliws_ext_dict.txt",
        "sourceType":"ORIGIN",
       "type":"ALI_WS"
    }
]

Exemple de réponse en cas de succès

XML format

<Result>
    <name>aliws_ext_dict.txt</name>
    <fileSize>6243</fileSize>
    <sourceType>OSS</sourceType>
    <type>ALI_WS</type>
</Result>
<RequestId>6A185DDB-3E87-448B-8932-8F77E35****</RequestId>

JSON format

{
    "Result":[
        {
            "name":"aliws_ext_dict.txt",
            "fileSize":6243,
            "sourceType":"OSS",
            "type":"ALI_WS"
        }
    ],
    "RequestId":"6A185DDB-3E87-448B-8932-8F77E35****"
}

Code d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.