> For the complete documentation index, see [llms.txt](https://xiaoxiami.gitbook.io/elasticsearch/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xiaoxiami.gitbook.io/elasticsearch/ji-chu/33-apis/343sou-suo-apis-search-apis/multi-search-api.md).

# 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**将执行的并发搜索的最大数量。此默认值基于数据节点的数量和默认搜索线程池大小。

## 安全 <a href="#multisearchapi-an-quan" id="multisearchapi-an-quan"></a>

请查看 [*URL-based access control*](https://www.elastic.co/guide/en/elasticsearch/reference/current/url-access-control.html)