解析索引 API

编辑

解析指定的索引、别名和数据流的名称和/或索引模式。支持多个模式和远程集群。

resp = client.indices.resolve_index(
    name="my-index-*",
)
print(resp)
response = client.indices.resolve_index(
  name: 'my-index-*'
)
puts response
const response = await client.indices.resolveIndex({
  name: "my-index-*",
});
console.log(response);
GET /_resolve/index/my-index-*

请求

编辑

GET /_resolve/index/<名称>

先决条件

编辑
  • 如果启用了 Elasticsearch 安全功能,您必须拥有目标数据流、索引或索引别名的 view_index_metadatamanage 索引权限

路径参数

编辑
<名称>

(必需,字符串)要解析的索引、别名和数据流的逗号分隔的名称或索引模式,使用 多目标语法。可以使用 <集群>:<名称> 语法指定 远程集群上的资源。

查询参数

编辑
expand_wildcards

(可选,字符串)通配符模式可以匹配的索引类型。如果请求可以定位数据流,则此参数确定通配符表达式是否匹配隐藏的数据流。支持逗号分隔的值,例如 open,hidden。有效值包括

all
匹配任何数据流或索引,包括隐藏的数据流或索引。
open
匹配打开的、非隐藏的索引。也匹配任何非隐藏的数据流。
closed
匹配关闭的、非隐藏的索引。也匹配任何非隐藏的数据流。数据流不能被关闭。
hidden
匹配隐藏的数据流和隐藏的索引。必须与 openclosed 或两者结合使用。
none
不接受通配符模式。

默认为 open

ignore_unavailable

(可选,布尔值)如果 false,则请求如果目标是丢失或关闭的索引会返回错误。默认为 false

默认为 false

allow_no_indices

(可选,布尔值)如果 false,则如果任何通配符表达式、索引别名_all 值仅目标是丢失或关闭的索引,则请求会返回错误。即使请求目标是其他打开的索引,此行为也适用。例如,如果一个索引以 foo 开头,但没有索引以 bar 开头,则以 foo*,bar* 为目标的请求将返回错误。

默认为 true

ignore_throttled

(可选,布尔值)如果 true,则当冻结时,会忽略具体的、展开的或别名的索引。默认为 false

[7.16.0] 在 7.16.0 中已弃用。

示例

编辑
resp = client.indices.resolve_index(
    name="f*,remoteCluster1:bar*",
    expand_wildcards="all",
)
print(resp)
response = client.indices.resolve_index(
  name: 'f*,remoteCluster1:bar*',
  expand_wildcards: 'all'
)
puts response
const response = await client.indices.resolveIndex({
  name: "f*,remoteCluster1:bar*",
  expand_wildcards: "all",
});
console.log(response);
GET /_resolve/index/f*,remoteCluster1:bar*?expand_wildcards=all

API 返回以下响应

{
  "indices": [                                 
    {
      "name": "foo_closed",
      "attributes": [
        "closed"                               
      ]
    },
    {
      "name": "freeze-index",
      "aliases": [
        "f-alias"
      ],
      "attributes": [
        "open"
      ]
    },
    {
      "name": "remoteCluster1:bar-01",
      "attributes": [
        "open"
      ]
    }
  ],
  "aliases": [                                 
    {
      "name": "f-alias",
      "indices": [
        "freeze-index",
        "my-index-000001"
      ]
    }
  ],
  "data_streams": [                            
    {
      "name": "foo",
      "backing_indices": [
        ".ds-foo-2099.03.07-000001"
      ],
      "timestamp_field": "@timestamp"
    }
  ]
}

所有匹配所提供的名称或表达式的索引

可能的索引属性包括 openclosedhiddensystemfrozen

所有匹配所提供的名称或表达式的别名

所有匹配所提供的名称或表达式的数据流