Get the snapshot status Added in 7.8.0

GET /_snapshot/{repository}/{snapshot}/_status

Get a detailed description of the current state for each shard participating in the snapshot. Note that this API should be used only to obtain detailed shard-level information for ongoing snapshots. If this detail is not needed or you want to obtain information about one or more existing snapshots, use the get snapshot API.

WARNING: Using the API to return the status of any snapshots other than currently running snapshots can be expensive. The API requires a read from the repository for each shard in each snapshot. For example, if you have 100 snapshots with 1,000 shards each, an API request that includes all snapshots will require 100,000 reads (100 snapshots x 1,000 shards).

Depending on the latency of your storage, such requests can take an extremely long time to return results. These requests can also tax machine resources and, when using cloud storage, incur high processing costs.

Path parameters

  • repository string Required

    A repository name

  • snapshot string | array[string] Required

    A comma-separated list of snapshot names

Query parameters

  • ignore_unavailable boolean

    Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown

  • master_timeout string

    Explicit operation timeout for connection to master node

Responses

  • 200 application/json
    Hide response attribute Show response attribute object
    • snapshots array[object] Required
      Hide snapshots attributes Show snapshots attributes object
      • include_global_state boolean Required
      • indices object Required
        Hide indices attribute Show indices attribute object
        • * object Additional properties

          Additional properties are allowed.

          Hide * attributes Show * attributes object
          • shards object Required
            Hide shards attribute Show shards attribute object
            • * object Additional properties

              Additional properties are allowed.

          • shards_stats object Required

            Additional properties are allowed.

            Hide shards_stats attributes Show shards_stats attributes object
          • stats object Required

            Additional properties are allowed.

            Hide stats attributes Show stats attributes object
            • incremental object Required

              Additional properties are allowed.

            • start_time_in_millis
            • time 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.

            • time_in_millis
            • total object Required

              Additional properties are allowed.

      • repository string Required
      • shards_stats object Required

        Additional properties are allowed.

        Hide shards_stats attributes Show shards_stats attributes object
      • snapshot string Required
      • state string Required
      • stats object Required

        Additional properties are allowed.

        Hide stats attributes Show stats attributes object
        • incremental object Required

          Additional properties are allowed.

          Hide incremental attributes Show incremental attributes object
        • start_time_in_millis number

          Time unit for milliseconds

        • time 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.

        • time_in_millis number

          Time unit for milliseconds

        • total object Required

          Additional properties are allowed.

          Hide total attributes Show total attributes object
      • uuid string Required
GET /_snapshot/{repository}/{snapshot}/_status 
curl \
 -X GET http://api.example.com/_snapshot/{repository}/{snapshot}/_status
Response examples (200) 
{
  "snapshots": [
    {
      "include_global_state": true,
      "indices": {
        "additionalProperty1": {
          "shards": {
            "additionalProperty1": {},
            "additionalProperty2": {}
          },
          "shards_stats": {
            "done": 42.0,
            "failed": 42.0,
            "finalizing": 42.0,
            "initializing": 42.0,
            "started": 42.0,
            "total": 42.0
          },
          "stats": {
            "incremental": {},
            "time": "string",
            "total": {}
          }
        },
        "additionalProperty2": {
          "shards": {
            "additionalProperty1": {},
            "additionalProperty2": {}
          },
          "shards_stats": {
            "done": 42.0,
            "failed": 42.0,
            "finalizing": 42.0,
            "initializing": 42.0,
            "started": 42.0,
            "total": 42.0
          },
          "stats": {
            "incremental": {},
            "time": "string",
            "total": {}
          }
        }
      },
      "repository": "string",
      "shards_stats": {
        "done": 42.0,
        "failed": 42.0,
        "finalizing": 42.0,
        "initializing": 42.0,
        "started": 42.0,
        "total": 42.0
      },
      "snapshot": "string",
      "state": "string",
      "stats": {
        "incremental": {
          "file_count": 42.0,
          "size_in_bytes": 42.0
        },
        "": 42.0,
        "time": "string",
        "total": {
          "file_count": 42.0,
          "size_in_bytes": 42.0
        }
      },
      "uuid": "string"
    }
  ]
}