Resolves the specified index expressions to return information about each cluster, including Added in 8.13.0

GET /_resolve/cluster/{name}

the local cluster, if included. Multiple patterns and remote clusters are supported.

Path parameters

  • name string | array[string] Required

    Comma-separated name(s) or index pattern(s) of the indices, aliases, and data streams to resolve. Resources on remote clusters can be specified using the <cluster>:<name> syntax.

Query parameters

  • If false, the request returns an error if any wildcard expression, index alias, or _all value targets only missing or closed indices. This behavior applies even if the request targets other open indices. For example, a request targeting foo*,bar* returns an error if an index starts with foo but no index starts with bar.

  • expand_wildcards string | array[string]

    Type of index that wildcard patterns can match. If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. Supports comma-separated values, such as open,hidden. Valid values are: all, open, closed, hidden, none.

  • If true, concrete, expanded or aliased indices are ignored when frozen. Defaults to false.

  • If false, the request returns an error if it targets a missing or closed index. Defaults to false.

Responses

  • 200 application/json
    Hide response attribute Show response attribute object
    • * object Additional properties

      Additional properties are allowed.

      Hide * attributes Show * attributes object
GET /_resolve/cluster/{name}
curl \
 -X GET http://api.example.com/_resolve/cluster/{name}
Response examples (200)
{
  "additionalProperty1": {
    "connected": true,
    "skip_unavailable": true,
    "matching_indices": true,
    "error": "string",
    "version": {
      "build_flavor": "string",
      "minimum_index_compatibility_version": "string",
      "minimum_wire_compatibility_version": "string",
      "number": "string"
    }
  },
  "additionalProperty2": {
    "connected": true,
    "skip_unavailable": true,
    "matching_indices": true,
    "error": "string",
    "version": {
      "build_flavor": "string",
      "minimum_index_compatibility_version": "string",
      "minimum_wire_compatibility_version": "string",
      "number": "string"
    }
  }
}