Path parameters

• policy_id string | array[string] Required

  Comma-separated list of snapshot lifecycle policies to retrieve

Query parameters

• master_timeout string

  The 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

  The 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

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

    • in_progress object
      Hide in_progress attributes Show in_progress attributes object

      • name string Required
      • start_time_millis number

        Time unit for milliseconds

      • state string Required
      • uuid string Required
    • last_failure object
      Hide last_failure attributes Show last_failure attributes object

      • snapshot_name string Required

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

        string-1 string UnitMillis number

        Time unit for milliseconds

    • last_success object
      Hide last_success attributes Show last_success attributes object

      • snapshot_name string Required

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

        string-1 string UnitMillis number

        Time unit for milliseconds

    • modified_date string | number

      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:

      string-1 string UnitMillis number

      Time unit for milliseconds

    • modified_date_millis number

      Time unit for milliseconds

    • next_execution string | number

      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:

      string-1 string UnitMillis number

      Time unit for milliseconds

    • next_execution_millis number

      Time unit for milliseconds

    • policy object Required
      Hide policy attributes Show policy attributes object

      • config object
        Hide config attributes Show config attributes object

        • ignore_unavailable boolean

          If false, the snapshot fails if any data stream or index in indices is missing or closed. If true, the snapshot ignores missing or closed data streams and indices.

          Default value is false.

        • indices string | array[string]
        • include_global_state boolean

          If true, the current global state is included in the snapshot.

          Default value is true.

        • feature_states array[string]

          A list of feature states to be included in this snapshot. A list of features available for inclusion in the snapshot and their descriptions be can be retrieved using the get features API. Each feature state includes one or more system indices containing data necessary for the function of that feature. Providing an empty array will include no feature states in the snapshot, regardless of the value of include_global_state. By default, all available feature states will be included in the snapshot if include_global_state is true, or no feature states if include_global_state is false.

        • metadata object
          Hide metadata attribute Show metadata attribute object

          • * object Additional properties
        • partial boolean

          If false, the entire snapshot will fail if one or more indices included in the snapshot do not have all primary shards available.

          Default value is false.

      • name string Required
      • repository string Required
      • retention object
        Hide retention attributes Show retention attributes object

        • expire_after string Required

          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.

        • max_count number Required

          Maximum number of snapshots to retain, even if the snapshots have not yet expired. If the number of snapshots in the repository exceeds this limit, the policy retains the most recent snapshots and deletes older snapshots.

        • min_count number Required

          Minimum number of snapshots to retain, even if the snapshots have expired.

      • schedule string Required
    • version number Required
    • stats object Required
      Hide stats attributes Show stats attributes object

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

      • retention_deletion_time_millis number

        Time unit for milliseconds

      • retention_failed number
      • retention_runs number
      • retention_timed_out number
      • policy string
      • total_snapshots_deleted number
      • total_snapshot_deletion_failures number
      • total_snapshots_failed number
      • total_snapshots_taken number