Appelez l'opération UpdateDict pour mettre à jour à froid le plug-in de segmentation IK d'une instance Alibaba Cloud Elasticsearch, y compris le dictionnaire principal IK et la liste des mots vides IK.
Lors de l'appel à cette interface, tenez compte des points suivants :
Si le fichier de dictionnaire provient d'OSS, assurez-vous que le bucket OSS est accessible en lecture publique.
Si le dictionnaire téléchargé n'est pas configuré avec la valeur ORIGIN, le fichier de dictionnaire sera supprimé après l'appel à cette interface.
Débogage
En-têtes de requête
Cette opération utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez la section Paramètres de requête communs.
Syntaxe de la requête
PUT /openapi/instances/[InstanceId]/dict HTTP/1.1
Paramètres de requête
| Paramètre | Type | Position | Obligatoire | Exemple | Description |
| InstanceId | String | Path | Oui | es-cn-nif1q9o8r0008**** |
L'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 à partir du 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
Les paramètres suivants doivent être renseignés dans le corps de la requête (RequestBody).
|
Paramètre |
Type |
Obligatoire |
Exemple |
Description |
|
name |
String |
Oui |
dic_0.dic |
Le nom du fichier de dictionnaire téléchargé. |
|
ossObject |
Array |
Oui |
La description du fichier de stockage ouvert OSS. Ce paramètre est requis lorsque sourceType est défini sur OSS. |
|
|
└bucketName |
String |
Oui |
search-cloud-test-cn-**** |
Le nom du bucket OSS. |
|
└key |
String |
Oui |
oss/dic_0.dic |
Le chemin d'accès où le fichier de dictionnaire est stocké dans le bucket OSS. |
|
sourceType |
String |
Oui |
OSS |
Le type de source du fichier de dictionnaire. Valeurs possibles : OSS (stockage ouvert OSS) et ORIGIN (conserver les dictionnaires précédemment téléchargés). Remarque : Les fichiers locaux doivent être téléchargés vers OSS avant d'être référencés via OSS. Si le dictionnaire précédemment téléchargé n'est pas configuré avec la valeur ORIGIN, il sera supprimé par le système. |
|
type |
String |
Oui |
MAIN |
Le type de dictionnaire à mettre à jour. Valeurs possibles : MAIN (dictionnaire de segmentation principal IK) ou STOP (liste des mots vides IK). |
└ indique un paramètre enfant.
Les exemples de requêtes suivants sont fournis à titre de référence :
[ { "name":"deploy_0.dic", "ossObject":{ "bucketName":"search-cloud-test-cn-****", "key":"user_dict/dict_0.dic" }, "sourceType":"OSS", "type":"MAIN" }, { "name":"deploy_2.dic", "ossObject":{ "bucketName":"search-cloud-test-cn-****", "key":"user_dict/dict_2.dic" }, "sourceType":"OSS", "type":"STOP" }, { "name":"SYSTEM_MAIN.dic", "sourceType":"ORIGIN", "type":"MAIN" }, { "name":"SYSTEM_STOPWORD.dic", "sourceType":"ORIGIN", "type":"STOP" } ]
Paramètres de réponse
| Paramètre | Type | Exemple | Description |
| RequestId | String | 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1D**** |
L'ID de la requête. |
| Result | Array of DictList |
Les résultats renvoyés. |
|
| fileSize | Long | 2782602 |
La taille du fichier de dictionnaire, en octets. |
| name | String | SYSTEM_MAIN.dic |
Le nom du fichier de dictionnaire. |
| sourceType | String | ORIGIN |
Le type de source du fichier de dictionnaire. Valeurs prises en charge :
|
| type | String | MAIN |
Le type de dictionnaire. Valeurs prises en charge :
|
Exemples
Exemple de requête
PUT /openapi/instances/es-cn-oew1q8bev0002 ****/dict HTTP/1.1 public request header [ { "name":"deploy_0.dic", "ossObject":{ "bucketName":"search-cloud-test-cn-****", "key":"user_dict/dict_0.dic" }, "sourceType":"OSS", "type":"MAIN" }, { "name":"deploy_2.dic", "ossObject":{ "bucketName":"search-cloud-test-cn-****", "key":"user_dict/dict_2.dic" }, "sourceType":"OSS", "type":"STOP" }, { "name":"SYSTEM_MAIN.dic", "sourceType":"ORIGIN", "type":"MAIN" }, { "name":"SYSTEM_STOPWORD.dic", "sourceType":"ORIGIN", "type":"STOP" } ]
Exemple de réponse réussie
JSON format
{ "Result": [ { "name": "deploy_0.dic", "ossObject": { "bucketName": "search-cloud-test-cn-****", "key": "user_dict/dict_0.dic" }, "sourceType": "OSS", "type": "MAIN" }, { "name": "deploy_2.dic", "ossObject": { "bucketName": "search-cloud-test-cn-****", "key": "user_dict/dict_2.dic" }, "sourceType": "OSS", "type": "STOP" }, { "name": "SYSTEM_MAIN.dic", "sourceType": "ORIGIN", "type": "MAIN" }, { "name": "SYSTEM_STOPWORD.dic", "sourceType": "ORIGIN", "type": "STOP" } ], "RequestId": "E1F6991B-1F77-47EA-9666-593F11E3****" }
Code d'erreur
Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.