Elasticsearch7.15中的REST APIs

Index APIs

如果想让一个JSON文档能够被搜索到，必须使用“Index”系列API添加这个JSON文档到特定的数据流或是索引中。如果API语法中的target是一个索引，并且文档已经存在的话，这个请求会更新已存在文档的内容，同时增加版本号。

请求语法（Request）

PUT /<target>/_doc/<_id>
POST /<target>/_doc/
PUT /<target>/_create/<_id>
POST /<target>/_create/<_id>

说明：PUT /<ｔａｒｇｅｔ>/_doc/<_id>请求不能用了更新数据流中已经存在的文档。

先决条件

• 如果Elasticsearch的安全特性启用的话，目标数据流、索引或是索引别名必须具备以下索引权限。
  -使用 PUT /<ｔａｒｇｅｔ>/_doc/<_id> 请求样式添加或更新文档时，必须有create、index或是write的索引权限
  -利用POST /<ｔａｒｇｅｔ>/_doc/、PUT /<ｔａｒｇｅｔ>/_create/<_id>或是POST /<ｔａｒｇｅｔ>/_create/<_id>请求样式添加文档时,必须有create_doc、create、index或是write的索引权限。
  -利用index API请求自动创建数据流或是索引时，必须具有auto_configure、create_index或是manage的索引权限
• 自动的数据流创建需要由一个匹配的索引模板。

路径参数

<ｔａｒｇｅｔ>

（必选、字符串）保存文档的数据流、索引的名称。
如果定义的名称在Elasticsearch中不存在，但是命名规则符合一个数据流定义的索引模板的名称或是通配符（*）样式，那么这个请求将创建一个数据流。
如果定义的名称在Elasticsearch中不存在，并且不符合数据流模板，那么这个请求将创建一个索引。

<_id>

（可选，字符串）文档的唯一标识符。

PUT /<ｔａｒｇｅｔ>_doc/<_id>
PUT /<ｔａｒｇｅｔ>/_create/<_id>
POST /<ｔａｒｇｅｔ>/_create/<_id>

这三个命令显示创建id。

POST /<ｔａｒｇｅｔ>/_doc/

这个命令是Elasticsearch自动生存ID。

Cat API

二级目录

三级目录