CAT 分片
1.0 版引入
CAT 分片操作列出所有主分片和副本分片的状态以及它们的分布方式。
端点
GET /_cat/shards
GET /_cat/shards/{index}
查询参数
下表列出了可用的查询参数。所有查询参数都是可选的。
| 参数 | 数据类型 | 描述 | 默认值 |
|---|---|---|---|
bytes（字节） | 字符串 | 用于显示字节值的单位。 有效值包括： b、kb、k、mb、m、gb、g、tb、t、pb 和 p。 | 不适用 |
cluster_manager_timeout | 字符串 | 允许与集群管理器节点建立连接的时间量。 | 不适用 |
格式 | 字符串 | Accept 标头的简短版本，例如 json 或 yaml。 | 不适用 |
h | 列表 | 要显示的列名的逗号分隔列表。 | 不适用 |
帮助 | 布尔型 | 返回帮助信息。 | false |
本地 | 布尔型 | 返回本地信息，但不从集群管理器节点检索状态。 | false |
s | 列表 | 用于排序的列名或列别名的逗号分隔列表。 | 不适用 |
时间 | 字符串 | 指定时间单位，例如 5d 或 7h。更多信息请参阅支持的单位。有效值包括： nanos、micros、ms、s、m、h 和 d。 | 不适用 |
v | 布尔型 | 启用详细模式，该模式显示列标题。 | false |
示例请求
以下示例请求返回有关分片的信息
GET _cat/shards?v
要只查看特定索引的分片信息，请在查询后添加索引名称。
GET _cat/shards/<index>?v
如果要获取多个索引的信息，请用逗号分隔索引
GET _cat/shards/index1,index2,index3
示例响应
index | shard | prirep | state | docs | store | ip | | node
plugins | 0 | p | STARTED | 0 | 208b | 172.18.0.4 | odfe-node1
plugins | 0 | r | STARTED | 0 | 208b | 172.18.0.3 | odfe-node2
限制响应大小
要限制返回的分片数量，请配置 cat.shards.response.limit.number_of_shards 设置。更多信息请参阅集群级别 CAT 响应限制设置。