Manage backups in the Google Cloud console

This page explains how to list, view, and delete backups in the Google Cloud console.

In a data source, each backup represents the state of the protected resource at a specific point in time. These backups are created based on the schedules defined in backup plans. Additionally, you can initiate on-demand backups whenever needed.

Before you begin

To get the permissions that you need to list and view backups, ask your administrator to grant you the Backup and DR Backup Vault Viewer (roles/backupdr.backupvaultViewer) IAM role on your backup vault project. For more information about granting roles, see Manage access to projects, folders, and organizations.

This predefined role contains the permissions required to list and view backups. To see the exact permissions that are required, expand the Required permissions section:

Required permissions

The following permissions are required to list and view backups:

backupdr.bvbackups.list
backupdr.bvbackups.get

You might also be able to get these permissions with custom roles or other predefined roles.

List backups

Use the following instructions to list backups.

Console

In the Google Cloud console, go to the Vaulted resources page.

Go to Vaulted resources
In the list of scheduled backups, click the name of the scheduled backup you want to view the backup details of.

gcloud

List the backups.
```
  gcloud alpha backup-dr backups list \
  --backup-vault=BACKUPVAULT_NAME \
  --project=PROJECT_ID \
  --location=LOCATION \
  --data-source=DATA_SOURCE
```
Replace the following:
- BACKUPVAULT_NAME: the name of the backup vault used to store backups.
- PROJECT_ID: the name of the project.
- LOCATION: the location of the backup vault.
- DATA_SOURCE: the ID of the data source that you want to list backups.

View backups

Use the following instructions to view backups.

Console

In the Google Cloud console, go to the Vaulted resources page.

Go to Vaulted resources
In the list of scheduled backups, click the name of the scheduled backup you want to view the backup details of.

The backup details page displays a list of backups along with their creation times, the backup type - scheduled or on-demand, the associated backup rule, and the backup expiration date.

gcloud

Get the backup ID that is part of a data source.
```
  gcloud alpha backup-dr backups list \
  --backup-vault=BACKUPVAULT_NAME \
  --project=PROJECT_ID \
  --location=LOCATION \
  --data-source=DATA_SOURCE
```
Replace the following:
- BACKUPVAULT_NAME: the name of the backup vault used to store backups.
- PROJECT_ID: the name of the project.
- LOCATION: the location of the backup vault.
- DATA_SOURCE: the ID of the data source for which you want to list backups.
View the backups.
```
  gcloud alpha backup-dr backups describe BACKUP_ID \
  --backup-vault=BACKUPVAULT_NAME \
  --project=PROJECT_ID \
  --location=LOCATION \
  --data-source=DATA_SOURCE
```
Replace the following:
- BACKUP_ID: the ID of the backup.
- PROJECT_ID: the name of the project.
- LOCATION: the location of the backup plan association.
- DATA_SOURCE: the ID of the data source for which you want to view backups.

Delete a backup

You can delete a backup only if the backup has exceeded its minimum enforced retention period. After deletion, the backup is no longer available for restore.

To get the permission that you need to delete a backup, ask your administrator to grant you the Backup Vault Admin (roles/backupdr.backupvaultAdmin) IAM role on your backup vault project. For more information about granting roles, see Manage access to projects, folders, and organizations.

This predefined role contains the backupdr.bvbackups.delete permission, which is required to delete a backup.

You might also be able to get this permission with custom roles or other predefined roles.

Use the following instructions to delete a backup.

Console

In the Google Cloud console, go to the Vaulted resources page.

Go to Vaulted resources
Click the name of the scheduled backup you want to delete.
From the backups section, select a backup and then click the icon.
Select Delete.
In the overlay window that appears, confirm you want to delete the backup.
Click Delete.

gcloud

Get the backup ID that is part of a data source.
```
  gcloud alpha backup-dr backups list \
  --backup-vault=BACKUPVAULT_NAME \
  --project=PROJECT_ID \
  --location=LOCATION \
  --data-source=DATA_SOURCE
```
Replace the following:
- BACKUPVAULT_NAME: the name of the backup vault used to store backups.
- PROJECT_ID: the name of the project.
- LOCATION: the location of the backup vault.
- DATA_SOURCE: the ID of the data source that you want to list backups.
Delete a backup.
```
  gcloud alpha backup-dr backups delete BACKUP_ID \
  --backup-vault=BACKUPVAULT_NAME \
  --project=PROJECT_ID \
  --location=LOCATION \
  --data-source=DATA_SOURCE
```
Replace the following:
- BACKUP_ID: the ID of the backup.
- BACKUPVAULT_NAME: the name of the backup vault where the backups are stored.
- PROJECT_ID: the name of the project.
- LOCATION:the location of the backup.
- DATA_SOURCE: the ID of the data source that you want to delete a backup from.