Method: projects.locations.backups.list

Lists all the backups.

HTTP request

GET https://firestore.googleapis.com/v1/{parent=projects/*/locations/*}/backups

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The location to list backups from.

Format is projects/{project}/locations/{location}. Use {location} = '-' to list backups from all locations for the given project. This allows listing backups from a single location or from all locations.

Request body

The request body must be empty.

Response body

The response for FirestoreAdmin.ListBackups.

If successful, the response body contains data with the following structure:

JSON representation
{
  "backups": [
    {
      object (Backup)
    }
  ],
  "unreachable": [
    string
  ]
}
Fields
backups[]

object (Backup)

List of all backups for the project.

unreachable[]

string

List of locations that existing backups were not able to be fetched from.

Instead of failing the entire requests when a single location is unreachable, this response returns a partial result set and list of locations unable to be reached here. The request can be retried against a single location to get a concrete error.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.