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
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). |
└ 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 :
|
| 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.