Path parameters

• name string Required

  the name of the autoscaling policy

Query parameters

• master_timeout string

  Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.

  Values are -1 or 0.

• timeout string

  Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.

  Values are -1 or 0.

Responses

• 200 application/json
  Hide response attribute Show response attribute object

  • acknowledged boolean Required

    For a successful response, this value is always true. On failure, an exception is returned instead.

Query parameters

• master_timeout string

  Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.

  Values are -1 or 0.

Responses

• 200 application/json
  Hide response attribute Show response attribute object

  • policies object Required
    Hide policies attribute Show policies attribute object

    • * object Additional properties
      Hide * attributes Show * attributes object

      • required_capacity object Required
        Hide required_capacity attributes Show required_capacity attributes object

        • node object Required
          Hide node attributes Show node attributes object

          • storage number Required
          • memory number Required
        • total object Required
          Hide total attributes Show total attributes object

          • storage number Required
          • memory number Required
      • current_capacity object Required
        Hide current_capacity attributes Show current_capacity attributes object

        • node object Required
          Hide node attributes Show node attributes object

          • storage number Required
          • memory number Required
        • total object Required
          Hide total attributes Show total attributes object

          • storage number Required
          • memory number Required
      • current_nodes array[object] Required
        Hide current_nodes attribute Show current_nodes attribute object

        • name string Required
      • deciders object Required
        Hide deciders attribute Show deciders attribute object

        • * object Additional properties
          Hide * attributes Show * attributes object

          • required_capacity object Required
            Hide required_capacity attributes Show required_capacity attributes object

            • node object Required
            • total object Required
          • reason_summary string
          • reason_details object

Query parameters

• h string | array[string]

  List of columns to appear in the response. Supports simple wildcards.

• s string | array[string]

  List of columns that determine how the table should be sorted. Sorting defaults to ascending and can be changed by setting :asc or :desc as a suffix to the column name.

• local boolean

  If true, the request computes the list of selected nodes from the local cluster state. If false the list of selected nodes are computed from the cluster state of the master node. In both cases the coordinating node will send requests for further information to each selected node.

• master_timeout string

  The period to wait for a connection to the master node.

  Values are -1 or 0.

Responses

• 200 application/json
  Hide response attributes Show response attributes object

  • name string Required

  • version string | null Required

    One of:

    string-1 string string-2 string | null
  • alias_count string Required
  • mapping_count string Required
  • settings_count string Required
  • metadata_count string Required
  • included_in string Required

Path parameters

• index string | array[string] Required

  A comma-separated list of data streams, indices, and aliases used to limit the request. It supports wildcards (*). To target all data streams and indices, omit this parameter or use * or _all.

Query parameters

• h string | array[string]

  List of columns to appear in the response. Supports simple wildcards.

• s string | array[string]

  List of columns that determine how the table should be sorted. Sorting defaults to ascending and can be changed by setting :asc or :desc as a suffix to the column name.

Responses

• 200 application/json
  Hide response attributes Show response attributes object

  • epoch number | string

    Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.

    Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.

    One of:

    UnitSeconds number StringifiedEpochTimeUnitSeconds string

    Time unit for seconds
  • timestamp string

    Time of day, expressed as HH:MM:SS

  • count string

    the document count

Query parameters

• bytes string

  The unit used to display byte values.

  Values are b, kb, mb, gb, tb, or pb.

• full_id boolean | string

  If true, return the full node ID. If false, return the shortened node ID.

• include_unloaded_segments boolean

  If true, the response includes information from segments that are not loaded into memory.

• h string | array[string]

  A comma-separated list of columns names to display. It supports simple wildcards.

  Supported values include:

  • build (or b): The Elasticsearch build hash. For example: 5c03844.
  • completion.size (or cs, completionSize): The size of completion. For example: 0b.
  • cpu: The percentage of recent system CPU used.
  • disk.avail (or d, disk, diskAvail): The available disk space. For example: 198.4gb.
  • disk.total (or dt, diskTotal): The total disk space. For example: 458.3gb.
  • disk.used (or du, diskUsed): The used disk space. For example: 259.8gb.
  • disk.used_percent (or dup, diskUsedPercent): The percentage of disk space used.
  • fielddata.evictions (or fe, fielddataEvictions): The number of fielddata cache evictions.
  • fielddata.memory_size (or fm, fielddataMemory): The fielddata cache memory used. For example: 0b.
  • file_desc.current (or fdc, fileDescriptorCurrent): The number of file descriptors used.
  • file_desc.max (or fdm, fileDescriptorMax): The maximum number of file descriptors.
  • file_desc.percent (or fdp, fileDescriptorPercent): The percentage of file descriptors used.
  • flush.total (or ft, flushTotal): The number of flushes.
  • flush.total_time (or ftt, flushTotalTime): The amount of time spent in flush.
  • get.current (or gc, getCurrent): The number of current get operations.
  • get.exists_time (or geti, getExistsTime): The time spent in successful get operations. For example: 14ms.
  • get.exists_total (or geto, getExistsTotal): The number of successful get operations.
  • get.missing_time (or gmti, getMissingTime): The time spent in failed get operations. For example: 0s.
  • get.missing_total (or gmto, getMissingTotal): The number of failed get operations.
  • get.time (or gti, getTime): The amount of time spent in get operations. For example: 14ms.
  • get.total (or gto, getTotal): The number of get operations.
  • heap.current (or hc, heapCurrent): The used heap size. For example: 311.2mb.
  • heap.max (or hm, heapMax): The total heap size. For example: 4gb.
  • heap.percent (or hp, heapPercent): The used percentage of total allocated Elasticsearch JVM heap. This value reflects only the Elasticsearch process running within the operating system and is the most direct indicator of its JVM, heap, or memory resource performance.
  • http_address (or http): The bound HTTP address.
  • id (or nodeId): The identifier for the node.
  • indexing.delete_current (or idc, indexingDeleteCurrent): The number of current deletion operations.
  • indexing.delete_time (or idti, indexingDeleteTime): The time spent in deletion operations. For example: 2ms.
  • indexing.delete_total (or idto, indexingDeleteTotal): The number of deletion operations.
  • indexing.index_current (or iic, indexingIndexCurrent): The number of current indexing operations.
  • indexing.index_failed (or iif, indexingIndexFailed): The number of failed indexing operations.
  • indexing.index_failed_due_to_version_conflict (or iifvc, indexingIndexFailedDueToVersionConflict): The number of indexing operations that failed due to version conflict.
  • indexing.index_time (or iiti, indexingIndexTime): The time spent in indexing operations. For example: 134ms.
  • indexing.index_total (or iito, indexingIndexTotal): The number of indexing operations.
  • ip (or i): The IP address.
  • jdk (or j): The Java version. For example: 1.8.0.
  • load_1m (or l): The most recent load average. For example: 0.22.
  • load_5m (or l): The load average for the last five minutes. For example: 0.78.
  • load_15m (or l): The load average for the last fifteen minutes. For example: 1.24.
  • mappings.total_count (or mtc, mappingsTotalCount): The number of mappings, including runtime and object fields.
  • mappings.total_estimated_overhead_in_bytes (or mteo, mappingsTotalEstimatedOverheadInBytes): The estimated heap overhead, in bytes, of mappings on this node, which allows for 1KiB of heap for every mapped field.
  • master (or m): Indicates whether the node is the elected master node. Returned values include * (elected master) and - (not elected master).
  • merges.current (or mc, mergesCurrent): The number of current merge operations.
  • merges.current_docs (or mcd, mergesCurrentDocs): The number of current merging documents.
  • merges.current_size (or mcs, mergesCurrentSize): The size of current merges. For example: 0b.
  • merges.total (or mt, mergesTotal): The number of completed merge operations.
  • merges.total_docs (or mtd, mergesTotalDocs): The number of merged documents.
  • merges.total_size (or mts, mergesTotalSize): The total size of merges. For example: 0b.
  • merges.total_time (or mtt, mergesTotalTime): The time spent merging documents. For example: 0s.
  • name (or n): The node name.
  • node.role (or r, role, nodeRole): The roles of the node. Returned values include c (cold node), d (data node), f (frozen node), h (hot node), i (ingest node), l (machine learning node), m (master-eligible node), r (remote cluster client node), s (content node), t (transform node), v (voting-only node), w (warm node), and - (coordinating node only). For example, dim indicates a master-eligible data and ingest node.
  • pid (or p): The process identifier.
  • port (or po): The bound transport port number.
  • query_cache.memory_size (or qcm, queryCacheMemory): The used query cache memory. For example: 0b.
  • query_cache.evictions (or qce, queryCacheEvictions): The number of query cache evictions.
  • query_cache.hit_count (or qchc, queryCacheHitCount): The query cache hit count.
  • query_cache.miss_count (or qcmc, queryCacheMissCount): The query cache miss count.
  • ram.current (or rc, ramCurrent): The used total memory. For example: 513.4mb.
  • ram.max (or rm, ramMax): The total memory. For example: 2.9gb.
  • ram.percent (or rp, ramPercent): The used percentage of the total operating system memory. This reflects all processes running on the operating system instead of only Elasticsearch and is not guaranteed to correlate to its performance.
  • refresh.total (or rto, refreshTotal): The number of refresh operations.
  • refresh.time (or rti, refreshTime): The time spent in refresh operations. For example: 91ms.
  • request_cache.memory_size (or rcm, requestCacheMemory): The used request cache memory. For example: 0b.
  • request_cache.evictions (or rce, requestCacheEvictions): The number of request cache evictions.
  • request_cache.hit_count (or rchc, requestCacheHitCount): The request cache hit count.
  • request_cache.miss_count (or rcmc, requestCacheMissCount): The request cache miss count.
  • script.compilations (or scrcc, scriptCompilations): The number of total script compilations.
  • script.cache_evictions (or scrce, scriptCacheEvictions): The number of total compiled scripts evicted from cache.
  • search.fetch_current (or sfc, searchFetchCurrent): The number of current fetch phase operations.
  • search.fetch_time (or sfti, searchFetchTime): The time spent in fetch phase. For example: 37ms.
  • search.fetch_total (or sfto, searchFetchTotal): The number of fetch operations.
  • search.open_contexts (or so, searchOpenContexts): The number of open search contexts.
  • search.query_current (or sqc, searchQueryCurrent): The number of current query phase operations.
  • search.query_time (or sqti, searchQueryTime): The time spent in query phase. For example: 43ms.
  • search.query_total (or sqto, searchQueryTotal): The number of query operations.
  • search.scroll_current (or scc, searchScrollCurrent): The number of open scroll contexts.
  • search.scroll_time (or scti, searchScrollTime): The amount of time scroll contexts were held open. For example: 2m.
  • search.scroll_total (or scto, searchScrollTotal): The number of completed scroll contexts.
  • segments.count (or sc, segmentsCount): The number of segments.
  • segments.fixed_bitset_memory (or sfbm, fixedBitsetMemory): The memory used by fixed bit sets for nested object field types and type filters for types referred in join fields. For example: 1.0kb.
  • segments.index_writer_memory (or siwm, segmentsIndexWriterMemory): The memory used by the index writer. For example: 18mb.
  • segments.memory (or sm, segmentsMemory): The memory used by segments. For example: 1.4kb.
  • segments.version_map_memory (or svmm, segmentsVersionMapMemory): The memory used by the version map. For example: 1.0kb.
  • shard_stats.total_count (or sstc, shards, shardStatsTotalCount): The number of shards assigned.
  • suggest.current (or suc, suggestCurrent): The number of current suggest operations.
  • suggest.time (or suti, suggestTime): The time spent in suggest operations.
  • suggest.total (or suto, suggestTotal): The number of suggest operations.
  • uptime (or u): The amount of node uptime. For example: 17.3m.
  • version (or v): The Elasticsearch version. For example: 9.0.0.
• s string | array[string]

  A comma-separated list of column names or aliases that determines the sort order. Sorting defaults to ascending and can be changed by setting :asc or :desc as a suffix to the column name.

• master_timeout string

  The period to wait for a connection to the master node.

  Values are -1 or 0.

• time string

  The unit used to display time values.

  Values are nanos, micros, ms, s, m, h, or d.

Responses

• 200 application/json
  Hide response attributes Show response attributes object

  • id string
  • pid string

    The process identifier.

  • ip string

    The IP address.

  • port string

    The bound transport port.

  • http_address string

    The bound HTTP address.

  • version string
  • flavor string

    The Elasticsearch distribution flavor.

  • type string

    The Elasticsearch distribution type.

  • build string

    The Elasticsearch build hash.

  • jdk string

    The Java version.

  • disk.total number | string

    One of:

    ByteSize number ByteSize string

  • disk.used number | string

    One of:

    ByteSize number ByteSize string

  • disk.avail number | string

    One of:

    ByteSize number ByteSize string

  • disk.used_percent string | number

    One of:

    Percentage string Percentage number
  • heap.current string

    The used heap.

  • heap.percent string | number

    One of:

    Percentage string Percentage number
  • heap.max string

    The maximum configured heap.

  • ram.current string

    The used machine memory.

  • ram.percent string | number

    One of:

    Percentage string Percentage number
  • ram.max string

    The total machine memory.

  • file_desc.current string

    The used file descriptors.

  • file_desc.percent string | number

    One of:

    Percentage string Percentage number
  • file_desc.max string

    The maximum number of file descriptors.

  • cpu string

    The recent system CPU usage as a percentage.

  • load_1m string

    The load average for the most recent minute.

  • load_5m string

    The load average for the last five minutes.

  • load_15m string

    The load average for the last fifteen minutes.

  • uptime string

    The node uptime.

  • node.role string

    The roles of the node. Returned values include c(cold node), d(data node), f(frozen node), h(hot node), i(ingest node), l(machine learning node), m (master eligible node), r(remote cluster client node), s(content node), t(transform node), v(voting-only node), w(warm node),and -(coordinating node only).

  • master string

    Indicates whether the node is the elected master node. Returned values include *(elected master) and -(not elected master).

  • name string
  • completion.size string

    The size of completion.

  • fielddata.memory_size string

    The used fielddata cache.

  • fielddata.evictions string

    The fielddata evictions.

  • query_cache.memory_size string

    The used query cache.

  • query_cache.evictions string

    The query cache evictions.

  • query_cache.hit_count string

    The query cache hit counts.

  • query_cache.miss_count string

    The query cache miss counts.

  • request_cache.memory_size string

    The used request cache.

  • request_cache.evictions string

    The request cache evictions.

  • request_cache.hit_count string

    The request cache hit counts.

  • request_cache.miss_count string

    The request cache miss counts.

  • flush.total string

    The number of flushes.

  • flush.total_time string

    The time spent in flush.

  • get.current string

    The number of current get ops.

  • get.time string

    The time spent in get.

  • get.total string

    The number of get ops.

  • get.exists_time string

    The time spent in successful gets.

  • get.exists_total string

    The number of successful get operations.

  • get.missing_time string

    The time spent in failed gets.

  • get.missing_total string

    The number of failed gets.

  • indexing.delete_current string

    The number of current deletions.

  • indexing.delete_time string

    The time spent in deletions.

  • indexing.delete_total string

    The number of delete operations.

  • indexing.index_current string

    The number of current indexing operations.

  • indexing.index_time string

    The time spent in indexing.

  • indexing.index_total string

    The number of indexing operations.

  • indexing.index_failed string

    The number of failed indexing operations.

  • merges.current string

    The number of current merges.

  • merges.current_docs string

    The number of current merging docs.

  • merges.current_size string

    The size of current merges.

  • merges.total string

    The number of completed merge operations.

  • merges.total_docs string

    The docs merged.

  • merges.total_size string

    The size merged.

  • merges.total_time string

    The time spent in merges.

  • refresh.total string

    The total refreshes.

  • refresh.time string

    The time spent in refreshes.

  • refresh.external_total string

    The total external refreshes.

  • refresh.external_time string

    The time spent in external refreshes.

  • refresh.listeners string

    The number of pending refresh listeners.

  • script.compilations string

    The total script compilations.

  • script.cache_evictions string

    The total compiled scripts evicted from the cache.

  • script.compilation_limit_triggered string

    The script cache compilation limit triggered.

  • search.fetch_current string

    The current fetch phase operations.

  • search.fetch_time string

    The time spent in fetch phase.

  • search.fetch_total string

    The total fetch operations.

  • search.open_contexts string

    The open search contexts.

  • search.query_current string

    The current query phase operations.

  • search.query_time string

    The time spent in query phase.

  • search.query_total string

    The total query phase operations.

  • search.scroll_current string

    The open scroll contexts.

  • search.scroll_time string

    The time scroll contexts held open.

  • search.scroll_total string

    The completed scroll contexts.

  • segments.count string

    The number of segments.

  • segments.memory string

    The memory used by segments.

  • segments.index_writer_memory string

    The memory used by the index writer.

  • segments.version_map_memory string

    The memory used by the version map.

  • segments.fixed_bitset_memory string

    The memory used by fixed bit sets for nested object field types and export type filters for types referred in _parent fields.

  • suggest.current string

    The number of current suggest operations.

  • suggest.time string

    The time spend in suggest.

  • suggest.total string

    The number of suggest operations.

  • bulk.total_operations string

    The number of bulk shard operations.

  • bulk.total_time string

    The time spend in shard bulk.

  • bulk.total_size_in_bytes string

    The total size in bytes of shard bulk.

  • bulk.avg_time string

    The average time spend in shard bulk.

  • bulk.avg_size_in_bytes string

    The average size in bytes of shard bulk.

Path parameters

• index string | array[string] Required

  A comma-separated list of data streams, indices, and aliases used to limit the request. Supports wildcards (*). To target all data streams and indices, omit this parameter or use * or _all.

Query parameters

• bytes string

  The unit used to display byte values.

  Values are b, kb, mb, gb, tb, or pb.

• h string | array[string]

  List of columns to appear in the response. Supports simple wildcards.

• s string | array[string]

  List of columns that determine how the table should be sorted. Sorting defaults to ascending and can be changed by setting :asc or :desc as a suffix to the column name.

• local boolean

  If true, the request computes the list of selected nodes from the local cluster state. If false the list of selected nodes are computed from the cluster state of the master node. In both cases the coordinating node will send requests for further information to each selected node.

• master_timeout string

  Period to wait for a connection to the master node.

  Values are -1 or 0.

Responses

• 200 application/json
  Hide response attributes Show response attributes object

  • index string
  • shard string

    The shard name.

  • prirep string

    The shard type: primary or replica.

  • ip string

    The IP address of the node where it lives.

  • id string
  • segment string

    The segment name, which is derived from the segment generation and used internally to create file names in the directory of the shard.

  • generation string

    The segment generation number. Elasticsearch increments this generation number for each segment written then uses this number to derive the segment name.

  • docs.count string

    The number of documents in the segment. This excludes deleted documents and counts any nested documents separately from their parents. It also excludes documents which were indexed recently and do not yet belong to a segment.

  • docs.deleted string

    The number of deleted documents in the segment, which might be higher or lower than the number of delete operations you have performed. This number excludes deletes that were performed recently and do not yet belong to a segment. Deleted documents are cleaned up by the automatic merge process if it makes sense to do so. Also, Elasticsearch creates extra deleted documents to internally track the recent history of operations on a shard.

  • size number | string

    One of:

    ByteSize number ByteSize string

  • size.memory number | string

    One of:

    ByteSize number ByteSize string
  • committed string

    If true, the segment is synced to disk. Segments that are synced can survive a hard reboot. If false, the data from uncommitted segments is also stored in the transaction log so that Elasticsearch is able to replay changes on the next start.

  • searchable string

    If true, the segment is searchable. If false, the segment has most likely been written to disk but needs a refresh to be searchable.

  • version string
  • compound string

    If true, the segment is stored in a compound file. This means Lucene merged all files from the segment in a single file to save file descriptors.

Path parameters

• repository string | array[string] Required

  A comma-separated list of snapshot repositories used to limit the request. Accepts wildcard expressions. _all returns all repositories. If any repository fails during the request, Elasticsearch returns an error.

Query parameters

• ignore_unavailable boolean

  If true, the response does not include information from unavailable snapshots.

• h string | array[string]

  List of columns to appear in the response. Supports simple wildcards.

• s string | array[string]

  List of columns that determine how the table should be sorted. Sorting defaults to ascending and can be changed by setting :asc or :desc as a suffix to the column name.

• master_timeout string

  Period to wait for a connection to the master node.

  Values are -1 or 0.

• time string

  Unit used to display time values.

  Values are nanos, micros, ms, s, m, h, or d.

Responses

• 200 application/json
  Hide response attributes Show response attributes object

  • id string

    The unique identifier for the snapshot.

  • repository string

    The repository name.

  • status string

    The state of the snapshot process. Returned values include: FAILED: The snapshot process failed. INCOMPATIBLE: The snapshot process is incompatible with the current cluster version. IN_PROGRESS: The snapshot process started but has not completed. PARTIAL: The snapshot process completed with a partial success. SUCCESS: The snapshot process completed with a full success.

  • start_epoch number | string

    Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.

    Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.

    One of:

    UnitSeconds number StringifiedEpochTimeUnitSeconds string

    Time unit for seconds

  • start_time string | object

    A time of day, expressed either as hh:mm, noon, midnight, or an hour/minutes structure.

    One of:

    ScheduleTimeOfDay string HourAndMinute object

    Hide attributes Show attributes

    • hour array[number] Required
    • minute array[number] Required

  • end_epoch number | string

    Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior is used to capture this behavior while keeping the semantics of the field type.

    Depending on the target language, code generators can keep the union or remove it and leniently parse strings to the target type.

    One of:

    UnitSeconds number StringifiedEpochTimeUnitSeconds string

    Time unit for seconds
  • end_time string

    Time of day, expressed as HH:MM:SS

  • duration string

    A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.

  • indices string

    The number of indices in the snapshot.

  • successful_shards string

    The number of successful shards in the snapshot.

  • failed_shards string

    The number of failed shards in the snapshot.

  • total_shards string

    The total number of shards in the snapshot.

  • reason string

    The reason for any snapshot failures.

Query parameters

• include_disk_info boolean

  If true, returns information about disk usage and shard sizes.

• include_yes_decisions boolean

  If true, returns YES decisions in explanation.

• master_timeout string

  Period to wait for a connection to the master node.

  Values are -1 or 0.

Responses

• 200 application/json
  Hide response attributes Show response attributes object

  • allocate_explanation string
  • allocation_delay string

    A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.

  • allocation_delay_in_millis number

    Time unit for milliseconds

  • can_allocate string

    Values are yes, no, worse_balance, throttled, awaiting_info, allocation_delayed, no_valid_shard_copy, or no_attempt.

  • can_move_to_other_node string

    Values are yes, no, worse_balance, throttled, awaiting_info, allocation_delayed, no_valid_shard_copy, or no_attempt.

  • can_rebalance_cluster string

    Values are yes, no, worse_balance, throttled, awaiting_info, allocation_delayed, no_valid_shard_copy, or no_attempt.

  • can_rebalance_cluster_decisions array[object]
    Hide can_rebalance_cluster_decisions attributes Show can_rebalance_cluster_decisions attributes object

    • decider string Required
    • decision string Required

      Values are NO, YES, THROTTLE, or ALWAYS.

    • explanation string Required
  • can_rebalance_to_other_node string

    Values are yes, no, worse_balance, throttled, awaiting_info, allocation_delayed, no_valid_shard_copy, or no_attempt.

  • can_remain_decisions array[object]
    Hide can_remain_decisions attributes Show can_remain_decisions attributes object

    • decider string Required
    • decision string Required

      Values are NO, YES, THROTTLE, or ALWAYS.

    • explanation string Required
  • can_remain_on_current_node string

    Values are yes, no, worse_balance, throttled, awaiting_info, allocation_delayed, no_valid_shard_copy, or no_attempt.

  • cluster_info object
    Hide cluster_info attributes Show cluster_info attributes object

    • nodes object Required
      Hide nodes attribute Show nodes attribute object

      • * object Additional properties
        Hide * attributes Show * attributes object

        • node_name string Required
        • least_available object Required
          Hide least_available attributes Show least_available attributes object

          • path string Required
          • total_bytes number Required
          • used_bytes number Required
          • free_bytes number Required
          • free_disk_percent number Required
          • used_disk_percent number Required
        • most_available object Required
          Hide most_available attributes Show most_available attributes object

          • path string Required
          • total_bytes number Required
          • used_bytes number Required
          • free_bytes number Required
          • free_disk_percent number Required
          • used_disk_percent number Required
    • shard_sizes object Required
      Hide shard_sizes attribute Show shard_sizes attribute object

      • * number Additional properties
    • shard_data_set_sizes object
      Hide shard_data_set_sizes attribute Show shard_data_set_sizes attribute object

      • * string Additional properties
    • shard_paths object Required
      Hide shard_paths attribute Show shard_paths attribute object

      • * string Additional properties
    • reserved_sizes array[object] Required
      Hide reserved_sizes attributes Show reserved_sizes attributes object

      • node_id string Required
      • path string Required
      • total number Required
      • shards array[string] Required
  • configured_delay string

    A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.

  • configured_delay_in_millis number

    Time unit for milliseconds

  • current_node object
    Hide current_node attributes Show current_node attributes object

    • id string Required
    • name string Required
    • roles array[string] Required
      • @doc_id node-roles

      Values are master, data, data_cold, data_content, data_frozen, data_hot, data_warm, client, ingest, ml, voting_only, transform, remote_cluster_client, or coordinating_only.

    • attributes object Required
      Hide attributes attribute Show attributes attribute object

      • * string Additional properties
    • transport_address string Required
    • weight_ranking number Required
  • current_state string Required
  • index string Required
  • move_explanation string
  • node_allocation_decisions array[object]
    Hide node_allocation_decisions attributes Show node_allocation_decisions attributes object

    • deciders array[object] Required
      Hide deciders attributes Show deciders attributes object

      • decider string Required
      • decision string Required

        Values are NO, YES, THROTTLE, or ALWAYS.

      • explanation string Required
    • node_attributes object Required
      Hide node_attributes attribute Show node_attributes attribute object

      • * string Additional properties
    • node_decision string Required

      Values are yes, no, worse_balance, throttled, awaiting_info, allocation_delayed, no_valid_shard_copy, or no_attempt.

    • node_id string Required
    • node_name string Required
    • roles array[string] Required
      • @doc_id node-roles

      Values are master, data, data_cold, data_content, data_frozen, data_hot, data_warm, client, ingest, ml, voting_only, transform, remote_cluster_client, or coordinating_only.

    • store object
      Hide store attributes Show store attributes object

      • allocation_id string Required
      • found boolean Required
      • in_sync boolean Required
      • matching_size_in_bytes number Required
      • matching_sync_id boolean Required
      • store_exception string Required
    • transport_address string Required
    • weight_ranking number Required
  • primary boolean Required
  • rebalance_explanation string
  • remaining_delay string

    A duration. Units can be nanos, micros, ms (milliseconds), s (seconds), m (minutes), h (hours) and d (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value.

  • remaining_delay_in_millis number

    Time unit for milliseconds

  • shard number Required
  • unassigned_info object
    Hide unassigned_info attributes Show unassigned_info attributes object

    • at string | number Required

      A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a number of milliseconds since the Epoch. Elasticsearch accepts both as input, but will generally output a string representation.

      One of:

      DateTime string UnitMillis number

      Time unit for milliseconds

    • last_allocation_status string
    • reason string Required

      Values are INDEX_CREATED, CLUSTER_RECOVERED, INDEX_REOPENED, DANGLING_INDEX_IMPORTED, NEW_INDEX_RESTORED, EXISTING_INDEX_RESTORED, REPLICA_ADDED, ALLOCATION_FAILED, NODE_LEFT, REROUTE_CANCELLED, REINITIALIZED, REALLOCATED_REPLICA, PRIMARY_FAILED, FORCED_EMPTY_PRIMARY, or MANUAL_ALLOCATION.

    • details string
    • failed_allocation_attempts number
    • delayed boolean
    • allocation_status string
  • note string

Responses

• 200 application/json

Query parameters

• dry_run boolean

  If true, then the request simulates the operation. It will calculate the result of applying the commands to the current cluster state and return the resulting cluster state after the commands (and rebalancing) have been applied; it will not actually perform the requested changes.

• explain boolean

  If true, then the response contains an explanation of why the commands can or cannot run.

• metric string | array[string]

  Limits the information returned to the specified metrics.

• retry_failed boolean

  If true, then retries allocation of shards that are blocked due to too many subsequent allocation failures.

• master_timeout string

  Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.

  Values are -1 or 0.

• timeout string

  Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.

  Values are -1 or 0.

Responses

• 200 application/json
  Hide response attributes Show response attributes object

  • acknowledged boolean Required
  • explanations array[object]
    Hide explanations attributes Show explanations attributes object

    • command string Required
    • decisions array[object] Required
      Hide decisions attributes Show decisions attributes object

      • decider string Required
      • decision string Required
      • explanation string Required
    • parameters object Required
      Hide parameters attributes Show parameters attributes object

      • allow_primary boolean Required
      • index string Required
      • node string Required
      • shard number Required
      • from_node string
      • to_node string
  • state object

    There aren't any guarantees on the output/structure of the raw cluster state. Here you will find the internal representation of the cluster, which can differ from the external representation.

Path parameters

• metric string | array[string] Required

  Limit the information returned to the specified metrics

Query parameters

• allow_no_indices boolean

  Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes _all string or when no indices have been specified)

• expand_wildcards string | array[string]

  Whether to expand wildcard expression to concrete indices that are open, closed or both.

  Supported values include:

  • all: Match any data stream or index, including hidden ones.
  • open: Match open, non-hidden indices. Also matches any non-hidden data stream.
  • closed: Match closed, non-hidden indices. Also matches any non-hidden data stream. Data streams cannot be closed.
  • hidden: Match hidden data streams and hidden indices. Must be combined with open, closed, or both.
  • none: Wildcard expressions are not accepted.

  Values are all, open, closed, hidden, or none.

• flat_settings boolean

  Return settings in flat format (default: false)

• ignore_unavailable boolean

  Whether specified concrete indices should be ignored when unavailable (missing or closed)

• local boolean

  Return local information, do not retrieve the state from master node (default: false)

• master_timeout string

  Specify timeout for connection to master

  Values are -1 or 0.

• wait_for_metadata_version number

  Wait for the metadata version to be equal or greater than the specified metadata version

• wait_for_timeout string

  The maximum time to wait for wait_for_metadata_version before timing out

  Values are -1 or 0.

Responses

• 200 application/json

Path parameters

• metric string | array[string] Required

  Limit the information returned to the specified metrics

• index string | array[string] Required

  A comma-separated list of index names; use _all or empty string to perform the operation on all indices

Query parameters

• allow_no_indices boolean

  Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes _all string or when no indices have been specified)

• expand_wildcards string | array[string]

  Whether to expand wildcard expression to concrete indices that are open, closed or both.

  Supported values include:

  • all: Match any data stream or index, including hidden ones.
  • open: Match open, non-hidden indices. Also matches any non-hidden data stream.
  • closed: Match closed, non-hidden indices. Also matches any non-hidden data stream. Data streams cannot be closed.
  • hidden: Match hidden data streams and hidden indices. Must be combined with open, closed, or both.
  • none: Wildcard expressions are not accepted.

  Values are all, open, closed, hidden, or none.

• flat_settings boolean

  Return settings in flat format (default: false)

• ignore_unavailable boolean

  Whether specified concrete indices should be ignored when unavailable (missing or closed)

• local boolean

  Return local information, do not retrieve the state from master node (default: false)

• master_timeout string

  Specify timeout for connection to master

  Values are -1 or 0.

• wait_for_metadata_version number

  Wait for the metadata version to be equal or greater than the specified metadata version

• wait_for_timeout string

  The maximum time to wait for wait_for_metadata_version before timing out

  Values are -1 or 0.

Responses

• 200 application/json