# Multi Search API **multi search API?**允許在同一API中執行多個搜索請求。它的端點（**endpoint**）是**`?_msearch`**?。 它的請求格式與?**multi API**?相似，結構如下（如果特定搜索最終重定向到另一個節點，則結構被特別優化以減少解析）： | `header\n` `body\n` `header\n` `body\n` | **header**?分包括要搜索的?**index / indices ，可搜索的可選（mapping）types?**，**search_type**，**`?preference`**?和?**`routing`。**?正文包括典型的搜索正文請求（包括**`?query`,?`aggregations`,?`from`,?`size`?**等）。?這里是一個例子： | `$ cat requests` `{``"index"`?`:?``"test"``}` `{``"query"`?`: {``"match_all"`?`: {}},?``"from"`?`:?``0``,?``"size"`?`:?``10``}` `{``"index"`?`:?``"test"``,?``"search_type"`?`:?``"dfs_query_then_fetch"``}` `{``"query"`?`: {``"match_all"`?`: {}}}` `{}` `{``"query"`?`: {``"match_all"`?`: {}}}` `{``"query"`?`: {``"match_all"`?`: {}}}` `{``"search_type"`?`:?``"dfs_query_then_fetch"``}` `{``"query"`?`: {``"match_all"`?`: {}}}` `$ curl -XGET localhost:``9200``/_msearch --data-binary?``"@requests"``; echo` | 注意，上面包括也被支持的空標題（也可以只是沒有任何內容）的示例。 該響應返回一個響應數組，其中包括每個搜索請求的搜索響應和狀態代碼，與其在原始?**multi search?**請求中的順序相匹配。?如果該特定搜索請求的完全失敗，將返回具有錯誤消息和相應狀態代碼的對象，而不是實際的搜索響應。 端點還允許對URI中的?**index/indices?**和?**type/types**?進行搜索，在這種情況下，它將被用作默認值，除非在標題中另有明確定義。?例如： | `$ cat requests` `{}` `{``"query"`?`: {``"match_all"`?`: {}},?``"from"`?`:?``0``,?``"size"`?`:?``10``}` `{}` `{``"query"`?`: {``"match_all"`?`: {}}}` `{``"index"`?`:?``"test2"``}` `{``"query"`?`: {``"match_all"`?`: {}}}` `$ curl -XGET localhost:``9200``/test/_msearch --data-binary?``@requests``; echo` | 上面將針對沒有定義索引的所有請求對?**test**?索引執行搜索，最后一個將針對**?test2**?索引執行。 可以以類似的方式設置**?search_type?**以全局地應用于所有搜索請求。 **msearch?**的?***max_concurrent_searches**?*請求參數可用于控制?**multi search api**?將執行的并發搜索的最大數量。?此默認值基于數據節點的數量和默認搜索線程池大小。 ### 安全 請查看?[](https://www.elastic.co/guide/en/elasticsearch/reference/current/url-access-control.html "URL-based access control")*[URL-based access control](https://www.elastic.co/guide/en/elasticsearch/reference/current/url-access-control.html)*