REST API改變 · Elasticsearch 5.4 中文文檔

# REST API改變原文鏈接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.0/breaking_50_rest_api_changes.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.0/breaking_50_rest_api_changes.html) 譯文鏈接 : [http://www.apache.wiki/pages/viewpage.action?pageId=4260795](http://www.apache.wiki/pages/viewpage.action?pageId=4260795) 貢獻者 : [片刻](/display/~jiangzhonglian) ## 嚴格的REST查詢字符串參數解析先前版本的Elasticsearch忽略無法識別的URL查詢字符串參數。這意味著Elasticsearch將默認接受包含打印錯誤的無關參數或參數。這從最終用戶的角度是危險的，因為這意味著所提交的請求將以不預期的方式執行。此寬容已刪除，Elasticsearch現在將失敗包含無法識別的查詢字符串參數的任何請求。 ## 超過512字節的ID值被拒絕當指定大于512字節的_id值時，請求將被拒絕。 ## /_optimize終結點刪除已棄用 /_optimize 端點已刪除。應使用 /_forcemerge 端點來代替optimize。 /_forcemerge的GET HTTP動詞不再受支持，請使用POST HTTP動詞。 ## 索引創建端點僅接受PUT 以前可以通過調用PUT index_name或POST index_name來創建索引。只有前者現在支持。 ## HEAD {index} / {type}替換為HEAD {index} / _ mapping / {type} 用于檢查類型是否存在的端點已經從{index}/{type}改為{index} /_ mapping/{type}，以便在使用HEAD {index}/{id}時準備刪除類型以檢查文檔是否存在于索引中。舊的端點將繼續工作，直到6.0。 ## 從 /_cluster/stats響應中刪除了mem部分 mem部分只包含總值，實際上是集群中所有節點可用的內存。該部分現在包含total，free，used，used_percent和free_percent。 ## /_cluster/stats返回的修訂的節點角色聚合客戶機master_only，data_only和master_data字段已被刪除，有利于master，data，ingest和coordinating_only。節點可以貢獻多個計數，因為它可以有多個角色。每個節點都隱式地是協調節點，因此每當節點沒有顯式角色時，它將被計為僅協調。 ## 從 /_cluster/state 路由表中刪除碎片版本信息我們現在在集群狀態中存儲分片的分配ID，并使用它來選擇主分片，而不是版本信息。 ## 節點角色不再是節點屬性的一部分節點角色現在在特定部分返回，稱為角色，作為節點stats和節點信息響應的一部分。新部分是一個數組，包含每個節點實現的所有不同的角色。在數組返回為空的情況下，這意味著該節點是僅協調節點。 ## 禁止未引用的JSON 以前，允許JSON文檔帶有未引用的字段名稱，這不是嚴格的JSON和打破一些Elasticsearch客戶端。如果文檔已在以前的Elasticsearch版本中用非引用字段編入索引，某些操作可能會拋出錯誤。為了伴隨此，已注釋掉的JVM選項已添加到jvm.options文件中：-Delasticsearch.json.allow_unquoted_field_names。請注意，此選項僅用于遷移目的，將在Elasticsearch 6.0.0中刪除。 ## 分析API改變過濾器和char_filters參數已重命名為filter和char_filter。已刪除token_filters參數。請改用濾鏡。 ## DELETE ?/_query端點已刪除刪除按查詢插件提供的DELETE / _query端點已刪除，并被按查詢刪除API替換。 ## 創建存儲腳本端點已刪除之前允許創建索引腳本的PUT / _scripts / {lang} / {id} / _ create端點已刪除。索引腳本已替換為存儲的腳本。 ## 創建存儲的模板端點已刪除以前允許創建索引模板的PUT / _search / template / {id} / _ create端點已刪除。索引模板已被預注冊的模板替換。 ## 刪除屬性支持一些REST端點（例如，集群更新索引設置）支持以Java屬性格式（行分隔鍵=值對）檢測內容。此支持已刪除。 ## wait_for_relocating_shards現在是 /_cluster/health 中的wait_for_no_relocating_shards 用于獲取數字的wait_for_relocating_shards參數現在只是一個布爾標記wait_for_no_relocating_shards，如果設置為true，則意味著請求將等待（直到配置的超時）集群在返回之前沒有分片重定位。默認為false，這意味著操作不會等待。