存在 API
编辑存在 API
编辑检查数据流、索引或别名是否存在。
resp = client.indices.exists( index="my-data-stream", ) print(resp)
response = client.indices.exists( index: 'my-data-stream' ) puts response
const response = await client.indices.exists({ index: "my-data-stream", }); console.log(response);
HEAD my-data-stream
请求
编辑HEAD <目标>
路径参数
编辑-
<目标>
- (可选,字符串)逗号分隔的数据流、索引和别名列表。支持通配符(
*
)。
查询参数
编辑-
allow_no_indices
-
(可选,布尔值)如果为
false
,则当任何通配符表达式、索引别名或_all
值仅以缺失或关闭的索引为目标时,请求将返回错误。即使请求以其他打开的索引为目标,也会应用此行为。例如,如果一个索引以foo
开头,但没有索引以bar
开头,则以foo*,bar*
为目标的请求将返回错误。默认为
true
。 -
expand_wildcards
-
(可选,字符串)通配符模式可以匹配的索引类型。如果请求可以以数据流为目标,则此参数确定通配符表达式是否匹配隐藏的数据流。支持逗号分隔的值,例如
open,hidden
。有效值为-
all
- 匹配任何数据流或索引,包括隐藏的那些。
-
open
- 匹配打开的、非隐藏的索引。也匹配任何非隐藏的数据流。
-
closed
- 匹配关闭的、非隐藏的索引。也匹配任何非隐藏的数据流。数据流无法关闭。
-
hidden
- 匹配隐藏的数据流和隐藏的索引。必须与
open
、closed
或两者结合使用。 -
none
- 不接受通配符模式。
默认为
open
。 -
-
flat_settings
- (可选,布尔值)如果为
true
,则以扁平格式返回设置。默认为false
。 -
include_defaults
- (可选,布尔值)如果为
true
,则在响应中返回所有默认设置。默认为false
。 -
ignore_unavailable
- (可选,布尔值)如果为
false
,则当请求以缺失或关闭的索引为目标时,会返回错误。默认为false
。 -
local
- (可选,布尔值)如果为
true
,则请求仅从本地节点检索信息。默认为false
,这意味着信息是从主节点检索的。
响应代码
编辑-
200
- 所有目标都存在。
-
404
- 一个或多个指定的目标不存在。