UpdateHotIkDicts - Elasticsearch

調用此介面時，請注意：

如果詞典檔案來源於OSS，需要確保OSS儲存空間為公用可讀。
如果已經上傳的詞典不加ORIGIN配置，調用此介面後，詞典檔案會被刪除。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

要求標頭

該介面使用公用要求標頭，無特殊要求標頭。請參見公用請求參數文檔。

請求文法

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

請求參數

名稱	類型	位置	是否必選	樣本值	描述
InstanceId	String	Path	是	es-cn-oew1q8bev0002****	執行個體ID。
clientToken	String	Query	否	5A2CFF0E-5718-45B5-9D4D-70B3FF****	用於保證請求的等冪性。由用戶端產生該參數值，要保證在不同請求間唯一，最大不超過64個ASCII字元。
	String	Body	否	請參見RequestBody中的樣本	RequestBody

RequestBody

RequestBody中還需填入以下參數。

參數	類型	是否必須	樣本值	描述
name	String	是	dic_0.dic	上傳的詞典檔案名稱。
ossObject	Array	是		OSS的開放隱藏檔描述。當sourceType為OSS時，必填。
└bucketName	String	是	search-cloud-test-cn-****	OSS儲存空間（Bucket）名稱。
└key	String	是	oss/dic_0.dic	詞典檔案在OSS Bucket中的儲存路徑。
sourceType	String	是	OSS	詞典檔案來源類型，可選值：OSS（使用OSS開放儲存）、ORIGIN（保留之前已經上傳的詞典）。注意：本地檔案需要先上傳至OSS，再通過OSS引用。如果之前已經完成上傳的詞典不加ORIGIN進行配置，會被系統刪除。
type	String	是	MAIN	要更新的詞典類型。可選值：MAIN（IK主分詞詞庫）、STOP（IK停用詞庫）。

└表示子參數。
RequestBody要添加全量API參數。例如，添加停用詞時，預設或已安裝詞庫中的詞典檔案都需要寫入RequestBody，以下樣本中"sourceType":"ORIGIN"就是存量詞典檔案。

[
    {
        "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	String	5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****	請求ID。
Result	Array of DictList		返回結果。
fileSize	Long	6	詞典檔案大小，單位：Byte。
sourceType	String	OSS	詞典檔案來源類型，支援： OSS：使用OSS開放儲存 ORIGIN：保留之前已經上傳的詞典
name	String	deploy_0.dic	詞典檔案名稱。
type	String	MAIN	詞典類型，支援： MAIN：IK主分詞詞庫 STOP：IK停用詞詞庫

樣本

請求樣本

PUT /openapi/instances/es-cn-oew1q8bev0002****/ik-hot-dict HTTP/1.1
公用要求標頭
[
    {
        "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"
    }
]

正常返回樣本

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。