Required. The instance to list backups from. Values are of the form projects/<project>/instances/<instance>.
Authorization requires the following IAM permission on the specified resource parent:
spanner.backups.list
Query parameters
Parameters
filter
string
An expression that filters the list of returned backups.
A filter expression consists of a field name, a comparison operator, and a value for filtering. The value must be a string, a number, or a boolean. The comparison operator must be one of: <, >, <=, >=, !=, =, or :. Colon : is the contains operator. Filter rules are not case sensitive.
The following fields in the Backup are eligible for filtering:
name
database
state
createTime (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
expireTime (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
versionTime (and values are of the format YYYY-MM-DDTHH:MM:SSZ)
sizeBytes
backupSchedules
You can combine multiple expressions by enclosing each expression in parentheses. By default, expressions are combined with AND logic, but you can specify AND, OR, and NOT logic explicitly.
Here are a few examples:
name:Howl - The backup's name contains the string "howl".
database:prod - The database's name contains the string "prod".
state:CREATING - The backup is pending creation.
state:READY - The backup is fully created and ready for use.
(name:howl) AND (createTime < \"2018-03-28T14:50:00Z\") - The backup name contains the string "howl" and createTime of the backup is before 2018-03-28T14:50:00Z.
expireTime < \"2018-03-28T14:50:00Z\" - The backup expireTime is before 2018-03-28T14:50:00Z.
sizeBytes > 10000000000 - The backup's size is greater than 10GB
backupSchedules:daily - The backup is created from a schedule with "daily" in its name.
pageSize
integer
Number of backups to be returned in the response. If 0 or less, defaults to the server's maximum allowed page size.
pageToken
string
If non-empty, pageToken should contain a nextPageToken from a previous ListBackupsResponse to the same parent and with the same filter.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-07-23 UTC."],[],[],null,["# Method: projects.instances.backups.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListBackupsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists completed and pending backups. Backups returned are ordered by `createTime` in descending order, starting from the most recent `createTime`.\n\n### HTTP request\n\nChoose a location: \nglobal europe-west8 me-central2 us-central1 us-central2 us-east1 us-east4 us-east5 us-south1 us-west1 us-west2 us-west3 us-west4 us-west8 us-east7 \n\n\u003cbr /\u003e\n\nThe URLs use [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nThe response for [backups.list](/spanner/docs/reference/rest/v1/projects.instances.backups/list#google.spanner.admin.database.v1.DatabaseAdmin.ListBackups).\n\nIf successful, the response body contains data with the following structure:\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/spanner.admin`\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]