すべてのプロダクト
Search
ドキュメントセンター

Elasticsearch:UpdateAliwsDict

最終更新日:Mar 17, 2025

UpdateAliwsDict を呼び出して、AliNLP Word Breaker(analysis-aliws)の辞書ファイルを更新します。カスタム辞書構成をサポートします。

このインターフェイスを呼び出すときは、次の点に注意してください。

  • Alibaba Cloud Elasticsearch V5.0 クラスターは、analysis-aliws プラグインをサポートしていません。
  • 辞書ファイルが OSS から取得された場合は、OSS バケットが公開読み取り可能であることを確認してください。
  • ORIGIN 構成がアップロードされた辞書ファイルに追加されていない場合、この操作を呼び出した後に辞書ファイルは削除されます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。 OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

リクエストヘッダー

この操作は共通のリクエストパラメーターのみを使用し、特別なリクエストヘッダーは必要ありません。詳細については、共通パラメーターに関するトピックをご参照ください。

リクエスト構文

PUT /openapi/instances/[InstanceId]/aliws-dict HTTP/1.1

リクエストパラメーター

パラメータータイプ位置必須説明
InstanceIdStringPathはいes-cn-n6w1o1x0w001c****

インスタンスの ID。

clientTokenStringQueryいいえ5A2CFF0E-5718-45B5-9D4D-70B3FF****

このパラメーターは、リクエストのべき等性を確保するために使用されます。クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

RequestBody

RequestBody に次のパラメーターを入力します。

パラメーター

タイプ

必須

説明

name

String

はい

aliws_ext_dict.txt

アップロードされた辞書ファイルの名前。

ossObject

Array

はい

OSS のオープンストレージファイルの説明。sourceType が OSS に設定されている場合、このパラメーターは必須です。

└bucketName

String

はい

search-cloud-test-cn-****

OSS バケットの名前。

└key

String

はい

oss/aliws_ext_dict.txt

OSS バケット内の辞書ファイルのストレージパス。

sourceType

String

はい

OSS

辞書ファイルソースのタイプ。有効な値:OSS(OSS を使用するオープンストレージサービス)および ORIGIN(以前にアップロードされた辞書を保持)。

注:

ローカルファイルは OSS にアップロードしてから、OSS を介して参照する必要があります。

辞書が前回のアップロードで ORIGIN で構成されていない場合、システムによって削除されます。

type

String

はい

ALI_WS

辞書のタイプ。静的フィールド:ALI_WS(AliNLP 単語セグメンテーション)。

説明 └ は子パラメーターを示します。

例:

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

レスポンスパラメーター

パラメータータイプ説明
RequestIdString5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

リクエストの ID。

ResultDictList の配列

戻り結果。

fileSizeLong6226

ファイルのサイズ。単位:バイト。

nameStringaliws_ext_dict.txt

アップロードされたファイルの名前。

sourceTypeStringOSS

辞書ファイルのソースタイプ。有効な値:

  • OSS:OSS オープンストレージを使用します。
  • ORIGIN:アップロードされた辞書を保持します。
typeStringALI_WS

辞書タイプ。有効な値:ALI_WS(AliNLP 単語セグメンテーション)。

リクエストの例

PUT /openapi/instances/es-cn-n6w1o1x0w001c****/aliws-dict HTTP/1.1
共通リクエストヘッダー
[
    {
        "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"
    }
]

成功レスポンスの例

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>

JSON 形式

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

エラーコード

エラーコードのリストについては、API エラーセンターをご覧ください。