Chame a API UpdateDict para atualizar offline o plug-in de segmentação de palavras IK da instância do Alibaba Cloud Elasticsearch. Essa operação inclui o dicionário principal de segmentação IK e a biblioteca de stopwords IK.
Ao chamar esta API, observe:
Se o arquivo de dicionário vier do OSS, verifique se o bucket do OSS tem leitura pública habilitada.
Se o dicionário enviado não estiver configurado com ORIGIN, o sistema excluirá o arquivo após a chamada desta API.
Depuração
Cabeçalhos da requisição
Esta operação usa apenas o cabeçalho de requisição comum. Para mais informações, consulte Parâmetros comuns de requisição.
Sintaxe da requisição
PUT /openapi/instances/[InstanceId]/dict HTTP/1.1
Parâmetros da requisição
|
Parâmetro |
Tipo |
Posição |
Obrigatório |
Exemplo |
Descrição |
|
InstanceId |
String |
Path |
Sim |
es-cn-nif1q9o8r0008**** |
ID da instância. |
|
clientToken |
String |
Query |
Não |
5A2CFF0E-5718-45B5-9D4D-70B3FF**** |
Garante a idempotência da requisição. Gere o valor no cliente e assegure que seja único entre requisições diferentes. O token aceita apenas caracteres ASCII e deve ter no máximo 64 caracteres. |
RequestBody
Preencha os seguintes parâmetros no RequestBody.
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
name |
String |
Sim |
dic_0.dic |
Nome do arquivo de dicionário enviado. |
|
ossObject |
Array |
Sim |
Descrição do arquivo no OSS. Obrigatório quando sourceType for OSS. |
|
|
└bucketName |
String |
Sim |
search-cloud-test-cn-**** |
Nome do bucket do OSS. |
|
└key |
String |
Sim |
oss/dic_0.dic |
Caminho do arquivo de dicionário no bucket do OSS. |
|
sourceType |
String |
Sim |
OSS |
Tipo de origem do arquivo de dicionário. Valores válidos: OSS (OSS Open Storage) e ORIGIN (manter dicionários enviados anteriormente). Nota: Envie arquivos locais ao OSS antes de referenciá-los. Se um dicionário enviado anteriormente não estiver configurado com ORIGIN, o sistema o excluirá. |
|
type |
String |
Sim |
MAIN |
Tipo de dicionário a atualizar. Valores válidos: MAIN (dicionário principal de segmentação IK) ou STOP (biblioteca de stopwords IK). |
└ indica um parâmetro filho.
Exemplo de instruções para referência:
[ { "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" } ]
Parâmetros de resposta
| Parâmetro | Tipo | Exemplo | Descrição |
| RequestId | String | 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1D**** |
ID da requisição. |
| Result | Array of DictList |
Resultados retornados. |
|
| fileSize | Long | 2782602 |
Tamanho do arquivo de dicionário, em bytes. |
| name | String | SYSTEM_MAIN.dic |
Nome do arquivo de dicionário. |
| sourceType | String | ORIGIN |
Tipo de origem do arquivo de dicionário. Valores válidos:
|
| type | String | MAIN |
Tipo de dicionário. Valores válidos:
|
Exemplos
Exemplo de requisição
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" } ]
Exemplo de resposta de sucesso
Formato JSON
{ "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****" }
Códigos de erro
Para obter uma lista de códigos de erro, visite a Central de Erros de API.