索引存在
1.0 版引入
索引存在 API 操作返回一个索引是否已存在。
端点
HEAD /<index-name>
查询参数
所有参数都是可选的。
| 参数 | 类型 | 描述 |
|---|---|---|
| allow_no_indices | 布尔型 | 是否忽略不匹配任何索引的通配符。默认值为 true。 |
| expand_wildcards | 字符串 | 将通配符表达式扩展到不同的索引。使用逗号组合多个值。可用值包括 all（匹配所有索引）、open（匹配开放索引）、closed（匹配关闭索引）、hidden（匹配隐藏索引）和 none（不接受通配符表达式）。默认值为 open。 |
| flat_settings | 布尔型 | 是否以扁平形式返回设置，这可以提高可读性，特别是对于深度嵌套的设置。例如，“index”: { “creation_date”: “123456789” } 的扁平形式是 “index.creation_date”: “123456789”。 |
| include_defaults | 布尔型 | 是否在响应中包含默认设置。此参数对于识别您要更新的设置名称和当前值非常有用。 |
| ignore_unavailable | 布尔型 | 如果为 true，OpenSearch 不会搜索缺失或已关闭的索引。默认值为 false。 |
| local | 布尔型 | 是否仅从本地节点而不是从集群管理器节点返回信息。默认值为 false。 |
请求示例
HEAD /sample-index
示例响应
索引存在 API 操作仅返回两种可能的响应代码之一：200 – 索引存在，以及 404 – 索引不存在。