UpdateHotIkDicts - Elasticsearch: Central de Documentação do Alibaba Cloud

Antes de chamar esta operação, observe os seguintes pontos:

Se o arquivo de dicionário estiver armazenado em um bucket do Object Storage Service (OSS), verifique se a lista de controle de acesso (ACL) do bucket está definida como leitura pública.
Se você não definir sourceType como ORIGIN para um arquivo de dicionário enviado, o sistema excluirá o arquivo após a execução desta operação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. A ferramenta gera dinamicamente exemplos de código da operação para diferentes SDKs.

Cabeçalhos da requisição

Esta operação utiliza apenas cabeçalhos de requisição comuns. Para mais informações, consulte a seção "Parâmetros de requisição comuns" no tópico Parâmetros comuns.

Sintaxe da requisição

PUT /openapi/instances/{InstanceId}/ik-hot-dict HTTP/1.1

Parâmetros da requisição

Parâmetro	Tipo	Posição	Obrigatório	Exemplo	Detalhes
InstanceId	String	Path	Sim	es-cn-oew1q8bev0002****	ID da instância.
clientToken	String	Query	Não	5A2CFF0E-5718-45B5-9D4D-70B3FF****	Token do cliente usado para garantir a idempotência da requisição. Gere esse token no cliente e assegure que seja único entre diferentes requisições. O token aceita apenas caracteres ASCII e não pode exceder 64 caracteres.
	String	Body	Não	Veja o exemplo em RequestBody	RequestBody

RequestBody

Configure os seguintes parâmetros no corpo da requisição.

Campo	Parâmetro	Obrigatório	Exemplo	Descrição
name	String	Sim	dic_0.dic	Nome do arquivo de dicionário a ser enviado.
ossObject	Array	Sim		Informações sobre o arquivo de dicionário. Este parâmetro é obrigatório quando sourceType for definido como OSS.
└bucketName	String	Sim	search-cloud-test-cn-****	Nome do bucket do OSS que armazena o arquivo de dicionário.
└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 e ORIGIN. Notas de uso: Envie um arquivo local para o OSS e referencie-o por meio do serviço. Se você não incluir ORIGIN na lista de dicionários enviados, o sistema excluirá o dicionário carregado anteriormente.
type	String	Sim	MAIN	Tipo dos dicionários a serem atualizados. Valores válidos: MAIN e STOP.

O símbolo └ indica um parâmetro filho.
Inclua todos os parâmetros da API no parâmetro RequestBody. Por exemplo, ao adicionar stopwords, liste todos os arquivos de dicionário do tesauro padrão ou instalado no RequestBody. No exemplo abaixo, "sourceType":"ORIGIN" representa um arquivo de dicionário existente.

[
    {
        "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	Detalhes
RequestId	String	5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****	ID da requisição.
Result	Array of DictList		Parâmetros da resposta.
fileSize	Long	6	Tamanho do arquivo de dicionário. Unidade: bytes.
sourceType	String	OSS	Tipo de origem do arquivo de dicionário. Valores válidos: OSS ORIGIN
name	String	deploy_0.dic	Nome do arquivo de dicionário.
type	String	MAIN	Tipo do dicionário. Valores válidos: MAIN: dicionário principal do IK STOP: lista de stopwords do IK

Exemplos

Exemplos de requisição

PUT /openapi/instances/es-cn-oew1q8bev0002****/ik-hot-dict HTTP/1.1
Common request parameters
[
    {
        "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"
    }
]

Exemplos de resposta de sucesso

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/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 comuns

Para obter uma lista de códigos de erro, consulte Códigos de erro do serviço.