add nodes_feature_usage.md

Author: dev2007

README.md

@@ -9,8 +9,8 @@
 后续计划如下：
 
 1. 继续翻译 8.x 版本的文档内容
-1. 完成后，将已完成内容将放到**历史**目录下
-1. 翻译官方 9.x 版本文档内容作为主要内容
+2. 完成后，将已完成内容将放到**历史**目录下
+3. 翻译官方 9.x 版本文档内容作为主要内容
 
 ## 目录
 
@@ -27,7 +27,7 @@
 
 从官方 7.11 文档开始，翻译为中文，并发布在网站。
 
-由于官方版本更新比较快(当前为 **8.16**)，文档虽然是基于 7.11 开始翻译，但实际翻译时，都是翻译当前的最新版本文档。
+由于官方版本更新比较快(当前为 **8.18**)，文档虽然是基于 7.11 开始翻译，但实际翻译时，都是翻译当前的最新版本文档。
 
 ### 计划
 
@@ -902,7 +902,7 @@ npm run docs:dev
     - :heavy_check_mark: 集群状态 API [:link:](https://elasticsearch.bookhub.techrest_apis/cluster_apis/cluster_state)
     - :heavy_check_mark: 集群统计 API [:link:](https://elasticsearch.bookhub.techrest_apis/cluster_apis/cluster_stats)
     - :heavy_check_mark: 集群更新设置 API [:link:](https://elasticsearch.bookhub.techrest_apis/cluster_apis/cluster_update_settings)
-    - Nodes feature usage
+    - :heavy_check_mark: 节点功能使用情况 API [:link:](https://elasticsearch.bookhub.techrest_apis/cluster_apis/nodes_feature_usage)
     - Nodes hot threads
     - Nodes info
     - Nodes reload secure settings

docs/intro.md

@@ -12,7 +12,7 @@ slug: /
 - 2024.03.29 增加搜索功能
 - 2023.11.08 变更文档框架为 Docusaurus
 
-从官方版本 7.11 文档开始，当前版本为 8.13。由于官方版本更新比较快，文档虽然是基于 7.11 开始翻译，，实际翻译过程中，后续的文档都是翻译当前的最新版本。
+从官方版本 7.11 文档开始，当前版本为 8.18。由于官方版本更新比较快，文档虽然是基于 7.11 开始翻译，，实际翻译过程中，后续的文档都是翻译当前的最新版本。
 
 ## 注意 ❗
 
@@ -21,8 +21,8 @@ slug: /
 后续计划如下：
 
 1. 继续翻译 8.x 版本的文档内容
-1. 完成后，将已完成内容将放到**历史**目录下
-1. 翻译官方 9.x 版本文档内容作为主要内容
+2. 完成后，将已完成内容将放到**历史**目录下
+3. 翻译官方 9.x 版本文档内容作为主要内容
 
 ## 微信公众号
 

docs/rest_apis/cluster_apis/nodes_feature_usage.md

@@ -0,0 +1,93 @@
+# 节点功能使用情况 API
+
+返回功能使用情况的信息。
+
+:::info 新 API 参考
+有关最新的 API 详细信息，请参阅[集群 API](https://www.elastic.co/docs/api/doc/elasticsearch/v8/group/endpoint-cluster)。
+:::
+
+## 请求
+
+```bash
+GET /_nodes/usage
+```
+
+```bash
+GET /_nodes/<node_id>/usage
+```
+
+```bash
+GET /_nodes/usage/<metric>
+```
+
+```bash
+GET /_nodes/<node_id>/usage/<metric>
+```
+
+## 先决条件
+
+- 如果启用了 Elasticsearch 安全功能，您必须拥有 `monitor` 或 `manage` [集群权限](/secure_the_elastic_statck/user_authorization/security_privileges#集群权限)才能使用此 API。
+
+## 描述
+
+集群节点使用情况 API 允许您检索每个节点功能使用情况的信息。所有节点选择选项的说明请参见[此处](/rest_apis/cluster_apis)。
+
+## 路径参数
+
+- `<metric>`
+  （可选，字符串）限制返回的信息为特定指标。逗号分隔的以下选项列表：
+
+  - `_all`
+    返回所有统计信息。
+  - `rest_actions`
+    返回 REST 动作类名及该动作在节点上被调用的次数。
+
+- `<node_id>`
+  （可选，字符串）用于限制返回信息的节点 ID 或名称的逗号分隔列表。
+
+## 查询参数
+
+- `timeout`
+
+  （可选，[时间单位](/rest_apis/api_convention/common_options.html#时间单位)）等待每个节点响应的时长。如果节点在超时到期前未响应，则响应中不包含其信息。但超时的节点会包含在响应的 `_nodes.failed` 属性中。默认为无超时。
+
+## 示例
+
+REST 动作示例：
+
+```bash
+GET _nodes/usage
+```
+
+API 返回以下响应：
+
+```json
+{
+  "_nodes": {
+    "total": 1,
+    "successful": 1,
+    "failed": 0
+  },
+  "cluster_name": "my_cluster",
+  "nodes": {
+    "pQHNt5rXTTWNvUgOrdynKg": {
+      "timestamp": 1492553961812,
+      "since": 1492553906606,
+      "rest_actions": {
+        "nodes_usage_action": 1,
+        "create_index_action": 1,
+        "document_get_action": 1,
+        "search_action": 19,
+        "nodes_info_action": 36
+      },
+      "aggregations": { ... }
+    }
+  }
+}
+```
+
+- 1. `"timestamp": 1492553961812`：执行此节点使用情况请求的时间戳。
+- 2. `"since": 1492553906606`：开始记录使用情况信息的时间戳。这相当于节点启动的时间。
+- 3. `"since": 1492553906606`：此节点的搜索动作已被调用 19 次。
+
+> [原文链接](https://www.elastic.co/guide/en/elasticsearch/reference/8.18/cluster-nodes-usage.html)

sidebars.js

@@ -179,6 +179,7 @@ const sidebars = {
             "rest_apis/cluster_apis/cluster_state",
             "rest_apis/cluster_apis/cluster_stats",
             "rest_apis/cluster_apis/cluster_update_settings",
+            "rest_apis/cluster_apis/nodes_feature_usage",
           ],
         },
         {