Get snapshot repository.

Introduced 0.1.0

Retrieves information about a snapshot repository.

To learn more about repositories, see Register repository.

note

You can also get details about a snapshot during and after snapshot creation. See Get snapshot status.

Path parameters

Parameter	Data type	Description
repository	String	A comma-separated list of snapshot repository names to retrieve. Wildcard (*) expressions are supported including combining wildcards with exclude patterns starting with -.

Query parameters

Parameter	Data type	Description
local	Boolean	Whether to get information from the local node. Optional, defaults to false.
cluster_manager_timeout	Time	Amount of time to wait for a connection to the master node. Optional, defaults to 30 seconds.

Example request

The following request retrieves information for the my-lucenia-repo repository:

GET /_snapshot/my-lucenia-repo

Example response

Upon success, the response returns repositry information. This sample is for an s3 repository type.

{
  "my-lucenia-repo" : {
    "type" : "s3",
    "settings" : {
      "bucket" : "my-open-search-bucket",
      "base_path" : "snapshots"
    }
  }
}

Response fields

Field	Data type	Description
type	string	Bucket type: fs (file system) or s3 (s3 bucket)
bucket	string	S3 bucket name.
base_path	string	Folder within the bucket where snapshots are stored.