Method: backupRuns.list

Lists all backup runs associated with the project or a given instance and configuration in the reverse chronological order of the backup initiation time.

HTTP request

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/{project}/instances/{instance}/backupRuns

The URL usesgRPC Transcoding syntax.

Path parameters

Parameters
project

string

Project ID of the project that contains the instance.

instance

string

Cloud SQL instance ID, or "-" for all instances. This does not include the project ID.

Query parameters

Parameters
maxResults

integer

Maximum number of backup runs per response.

pageToken

string

A previously-returned page token representing part of the larger set of results to view.

Request body

The request body must be empty.

Response body

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

Backup run list results.

JSON representation
{"kind":string,"items":[{object (BackupRun)}],"nextPageToken":string}
Fields
kind

string

This is alwayssql#backupRunsList.

items[]

object (BackupRun)

A list of backup runs in reverse chronological order of the enqueued time.

nextPageToken

string

The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results.

Authorization Scopes

Requires one of the following OAuth scopes:

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

For more information, see theAuthentication Overview.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-30 UTC.