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

Observe os pontos abaixo ao chamar esta API:

Clusters do Alibaba Cloud Elasticsearch V5.0 não suportam o plug-in analysis-aliws.
Se o arquivo de dicionário for obtido do OSS, verifique se o bucket do OSS tem leitura pública.
Caso a configuração ORIGIN não esteja presente em um arquivo de dicionário enviado, o sistema excluirá esse arquivo após a execução desta operação.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos usar esta ferramenta para chamar a operação, pois ela gera dinamicamente códigos de exemplo para diferentes SDKs.

Cabeçalhos da requisição

Esta operação usa apenas parâmetros comuns de requisição e não requer cabeçalhos especiais. Para mais informações, consulte o tópico sobre parâmetros comuns.

Sintaxe da requisição

PUT /openapi/instances/[InstanceId]/aliws-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-n6w1o1x0w001c****	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 diferentes requisições. O token aceita apenas caracteres ASCII e deve ter no máximo 64 caracteres.

RequestBody

Insira os seguintes parâmetros no RequestBody.

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
name	String	Sim	aliws_ext_dict.txt	Nome do arquivo de dicionário enviado.
ossObject	Array	Sim		Descrição do arquivo no OSS. Obrigatório quando sourceType é definido como OSS.
└bucketName	String	Sim	search-cloud-test-cn-****	Nome do bucket do OSS.
└key	String	Sim	oss/aliws_ext_dict.txt	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 (armazenamento via OSS) e ORIGIN (mantém dicionários enviados anteriormente). Nota: Envie o arquivo local para o OSS e referencie-o pelo serviço. Se um dicionário não tiver a configuração ORIGIN no envio anterior, o sistema o excluirá.
type	String	Sim	ALI_WS	Tipo do dicionário. Campo estático: ALI_WS (segmentação de palavras AliNLP).

Nota

└ indica um parâmetro filho.

Exemplos:

[
    {
        "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"
    }
]

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****	ID da requisição.
Result	Array of DictList		Resultados retornados.
fileSize	Long	6226	Tamanho do arquivo. Unidade: bytes.
name	String	aliws_ext_dict.txt	Nome do arquivo enviado.
sourceType	String	OSS	Tipo de origem do arquivo de dicionário. Valores válidos: OSS: usa armazenamento do OSS. ORIGIN: mantém dicionários já enviados.
type	String	ALI_WS	Tipo do dicionário. Valor válido: ALI_WS (segmentação de palavras AliNLP).

Exemplos

Exemplo de requisição

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"
    }
]

Exemplo de resposta de sucesso

Formato XML

<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>

Formato JSON

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

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.