update docs

Author: dunwu

.travis.yml

@@ -5,7 +5,7 @@ language: node_js
 
 sudo: required
 
-node_js: stable
+node_js: '16.13.0'
 
 branches:
   only:

README.md

@@ -75,7 +75,7 @@
 
 - [Elasticsearch 面试总结](docs/nosql/elasticsearch/elasticsearch-interview.md) 💯
 - [ElasticSearch 应用指南](docs/nosql/elasticsearch/elasticsearch-quickstart.md)
-- [ElasticSearch API](docs/nosql/elasticsearch/elasticsearch-api.md)
+- [ElasticSearch API](docs/nosql/elasticsearch/ElasticSearchRestApi.md)
 - [ElasticSearch 运维](docs/nosql/elasticsearch/elasticsearch-ops.md)
 
 #### HBase

docs/README.md

@@ -74,7 +74,7 @@ footer: CC-BY-SA-4.0 Licensed | Copyright © 2018-Now Dunwu
 
 - [Elasticsearch 面试总结](nosql/elasticsearch/elasticsearch-interview.md) 💯
 - [ElasticSearch 应用指南](nosql/elasticsearch/elasticsearch-quickstart.md)
-- [ElasticSearch API](nosql/elasticsearch/elasticsearch-api.md)
+- [ElasticSearch API](nosql/elasticsearch/ElasticSearchRestApi.md)
 - [ElasticSearch 运维](nosql/elasticsearch/elasticsearch-ops.md)
 
 #### HBase

docs/nosql/elasticsearch/elasticsearch-api.md renamed to docs/nosql/elasticsearch/ElasticsearchRestApi.md

@@ -1,22 +1,22 @@
-# Elasticsearch API
+# ElasticSearch Rest API
 
 > **[Elasticsearch](https://github.com/elastic/elasticsearch) 是一个分布式、RESTful 风格的搜索和数据分析引擎**，能够解决不断涌现出的各种用例。 作为 Elastic Stack 的核心，它集中存储您的数据，帮助您发现意料之中以及意料之外的情况。
 >
 > [Elasticsearch](https://github.com/elastic/elasticsearch) 基于搜索库 [Lucene](https://github.com/apache/lucene-solr) 开发。ElasticSearch 隐藏了 Lucene 的复杂性，提供了简单易用的 REST API / Java API 接口（另外还有其他语言的 API 接口）。
 >
 > _以下简称 ES_。
 
-## 一、REST API
-
 > REST API 最详尽的文档应该参考：[ES 官方 REST API](https://www.elastic.co/guide/en/elasticsearch/reference/current/rest-apis.html)
 
-### 索引
+## 索引 API
 
-新建 Index，可以直接向 ES 服务器发出 `PUT` 请求。
+> 参考资料：[Elasticsearch 官方之 cat 索引 API](https://www.elastic.co/guide/en/elasticsearch/reference/current/cat-indices.html)
 
-#### 创建索引
+### 创建索引
+
+新建 Index，可以直接向 ES 服务器发出 `PUT` 请求。
 
-示例：直接创建索引
+（1）直接创建索引
 
 ```bash
 curl -X POST 'localhost:9200/user'
@@ -28,21 +28,23 @@ curl -X POST 'localhost:9200/user'
 {"acknowledged":true,"shards_acknowledged":true,"index":"user"}
 ```
 
-示例：创建索引时指定配置
+（2）创建索引时指定配置
+
+语法格式：
 
 ```bash
-$ curl -X PUT -H 'Content-Type: application/json' 'localhost:9200/user'  -d '
+$ curl -X PUT /my_index
 {
-    "settings" : {
-        "index" : {
-            "number_of_shards" : 3,
-            "number_of_replicas" : 2
-        }
+    "settings": { ... any settings ... },
+    "mappings": {
+        "type_one": { ... any mappings ... },
+        "type_two": { ... any mappings ... },
+        ...
     }
-}'
+}
 ```
 
-示例：创建索引时指定 `mappings`
+示例：
 
 ```bash
 $ curl -X PUT -H 'Content-Type: application/json' 'localhost:9200/user'  -d '
@@ -56,63 +58,72 @@ $ curl -X PUT -H 'Content-Type: application/json' 'localhost:9200/user'  -d '
 }'
 ```
 
-#### 删除索引
+如果你想禁止自动创建索引，可以通过在 `config/elasticsearch.yml` 的每个节点下添加下面的配置：
+
+```js
+action.auto_create_index: false
+```
+
+### 删除索引
 
 然后，我们可以通过发送 `DELETE` 请求，删除这个 Index。
 
 ```bash
 curl -X DELETE 'localhost:9200/user'
 ```
 
-#### 查看索引
+删除多个索引
+
+```js
+DELETE /index_one,index_two
+DELETE /index_*
+```
+
+### 查看索引
 
 可以通过 GET 请求查看索引信息
 
 ```bash
 # 查看索引相关信息
-curl -X GET 'localhost:9200/user'
+GET kibana_sample_data_ecommerce
 
-#查看索引的文档总数
-CURL -X 'localhost:9200/user/_count'
+# 查看索引的文档总数
+GET kibana_sample_data_ecommerce/_count
 
-#查看前10条文档，了解文档格式
-POST user/_search
-{
-}
+# 查看前10条文档，了解文档格式
+GET kibana_sample_data_ecommerce/_search
 
-#_cat indices API
-#查看indices
-CURL -X /_cat/indices/kibana*?v&s=index
+# _cat indices API
+# 查看indices
+GET /_cat/indices/kibana*?v&s=index
 
-#查看状态为绿的索引
-CURL -X /_cat/indices?v&health=green
+# 查看状态为绿的索引
+GET /_cat/indices?v&health=green
 
-#按照文档个数排序
-CURL -X /_cat/indices?v&s=docs.count:desc
+# 按照文档个数排序
+GET /_cat/indices?v&s=docs.count:desc
 
-#查看具体的字段
-CURL -X /_cat/indices/kibana*?pri&v&h=health,index,pri,rep,docs.count,mt
+# 查看具体的字段
+GET /_cat/indices/kibana*?pri&v&h=health,index,pri,rep,docs.count,mt
 
-#How much memory is used per index?
-CURL -X /_cat/indices?v&h=i,tm&s=tm:desc
+# 查看索引占用的内存
+GET /_cat/indices?v&h=i,tm&s=tm:desc
 ```
 
-#### 打开/关闭索引
+### 打开/关闭索引
 
 通过在 `POST` 中添加 `_close` 或 `_open` 可以打开、关闭索引。
-关闭索引
-
-```bash
-curl -X POST 'localhost:9200/user/_close'
-```
 
 打开索引
 
 ```bash
-curl -X POST 'localhost:9200/user/_open'
+# 打开索引
+POST kibana_sample_data_ecommerce/_open
+# 关闭索引
+POST kibana_sample_data_ecommerce/_close
 ```
 
-### 文档
+## 文档
 
 #### 新增记录
 
@@ -372,9 +383,92 @@ $ curl -H 'Content-Type: application/json' 'localhost:9200/user/admin/_search?pr
 }'
 ```
 
-## 二、Java API
+## 集群 API
+
+> [Elasticsearch 官方之 Cluster API](https://www.elastic.co/guide/en/elasticsearch/reference/current/cluster.html)
+
+一些集群级别的 API 可能会在节点的子集上运行，这些节点可以用节点过滤器指定。例如，任务管理、节点统计和节点信息 API 都可以报告来自一组过滤节点而不是所有节点的结果。
 
-TODO：待补充...
+节点过滤器以逗号分隔的单个过滤器列表的形式编写，每个过滤器从所选子集中添加或删除节点。每个过滤器可以是以下之一：
+
+- `_all`：将所有节点添加到子集
+- `_local`：将本地节点添加到子集
+- `_master`：将当前主节点添加到子集
+- 根据节点ID或节点名将匹配节点添加到子集
+- 根据IP地址或主机名将匹配节点添加到子集
+- 使用通配符，将节点名、地址名或主机名匹配的节点添加到子集
+- `master:true`, `data:true`, `ingest:true`, `voting_only:true`, `ml:true` 或 `coordinating_only:true`, 分别意味着将所有主节点、所有数据节点、所有摄取节点、所有仅投票节点、所有机器学习节点和所有协调节点添加到子集中。
+- `master:false`, `data:false`, `ingest:false`, `voting_only:true`, `ml:false` 或 `coordinating_only:false`, 分别意味着将所有主节点、所有数据节点、所有摄取节点、所有仅投票节点、所有机器学习节点和所有协调节点排除在子集外。
+- 配对模式，使用 `*` 通配符，格式为 `attrname:attrvalue`，将所有具有自定义节点属性的节点添加到子集中，其名称和值与相应的模式匹配。自定义节点属性是通过 `node.attr.attrname: attrvalue` 形式在配置文件中设置的。
+
+```bash
+# 如果没有给出过滤器，默认是查询所有节点
+GET /_nodes
+# 查询所有节点
+GET /_nodes/_all
+# 查询本地节点
+GET /_nodes/_local
+# 查询主节点
+GET /_nodes/_master
+# 根据名称查询节点（支持通配符）
+GET /_nodes/node_name_goes_here
+GET /_nodes/node_name_goes_*
+# 根据地址查询节点（支持通配符）
+GET /_nodes/10.0.0.3,10.0.0.4
+GET /_nodes/10.0.0.*
+# 根据规则查询节点
+GET /_nodes/_all,master:false
+GET /_nodes/data:true,ingest:true
+GET /_nodes/coordinating_only:true
+GET /_nodes/master:true,voting_only:false
+# 根据自定义属性查询节点（如：查询配置文件中含 node.attr.rack:2 属性的节点）
+GET /_nodes/rack:2
+GET /_nodes/ra*:2
+GET /_nodes/ra*:2*
+```
+
+### 集群健康 API
+
+```bash
+GET /_cluster/health
+GET /_cluster/health?level=shards
+GET /_cluster/health/kibana_sample_data_ecommerce,kibana_sample_data_flights
+GET /_cluster/health/kibana_sample_data_flights?level=shards
+```
+
+### 集群状态 API
+
+集群状态 API 返回表示整个集群状态的元数据。
+
+```bash
+GET /_cluster/state
+```
+
+
+
+## 节点 API
+
+> [Elasticsearch 官方之 cat Nodes API](https://www.elastic.co/guide/en/elasticsearch/reference/current/cat-nodes.html)——返回有关集群节点的信息。
+
+```bash
+# 查看默认的字段
+GET /_cat/nodes?v=true
+# 查看指定的字段
+GET /_cat/nodes?v=true&h=id,ip,port,v,m
+```
+
+## 分片 API
+
+> [Elasticsearch 官方之 cat Shards API](https://www.elastic.co/guide/en/elasticsearch/reference/current/cat-shards.html)——shards 命令是哪些节点包含哪些分片的详细视图。它会告诉你它是主还是副本、文档数量、它在磁盘上占用的字节数以及它所在的节点。
+
+```bash
+# 查看默认的字段
+GET /_cat/shards
+# 根据名称查询分片（支持通配符）
+GET /_cat/shards/my-index-*
+# 查看指定的字段
+GET /_cat/shards?h=index,shard,prirep,state,unassigned.reason
+```
 
 ## 参考资料