Get snapshot repository.

Get snapshot repository.

Introduced 1.0

Retrieves information about a snapshot repository.

To learn more about repositories, see Register repository.

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

Path and HTTP methods

GET /_snapshot/<repository>

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 cluster manager node. Optional, defaults to 30 seconds.

Example request

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

GET /_snapshot/my-opensearch-repo

copy

Example response

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

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

Response body 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.