Standard backups are managed by Filestore and let you back up your data manually on an on-demand basis. For differences between standard and enhanced backups, see Backup options .
Before you start
Ensure you have enabled the APIs for Filestore and Backup and DR Service. For the list of required roles and permissions, see Prerequisites for using Filestore Enhanced Backups .
To create a standard, on-demand backup, follow these steps:
gcloud
- Install
gcloud. -
Update
gcloud components:gcloud components update
-
Run the following
gcloud filestore backups createcommand in a terminal window on your local machine. The--kms-keyflag is optional:gcloud filestore backups create BACKUP_NAME \ --instance= INSTANCE_NAME \ --file-share= FILE_SHARE_NAME \ --instance-zone= ZONE \ --region= BACKUP_LOCATION \ --kms-key=projects/ KMS_PROJECT /locations/ KMS_LOCATION /keyRings/ KEYRING /cryptoKeys/ CRYPTO_KEY
Where:
- BACKUP_NAME is the name you want to give the backup.
- INSTANCE_NAME is the name of the Filestore instance to back up.
- FILE_SHARE_NAME is the name of the file share on the Filestore instance.
- ZONE is the zone where the Filestore instance is located.
- BACKUP_LOCATION is the region where the backup will be stored. If a region is not indicated, the backup is created in the same region as the Filestore instance.
- KMS_PROJECT is the project name where the KMS key resource is stored.
- KMS_LOCATION is the region of the KMS key resource.
- KEYRING is the name of the key ring.
- CRYPTO_KEY is the KMS key resource.
Example
The following command creates a backup of file share vol1
on the Filestore
instance nfs-server
, which is located in zone us-central1-c
. The backup is
named mybackup
, is located in region asia-east2
, and has an associated
encryption key that will encrypt the instance when restored:
gcloud filestore backups create mybackup \
--instance=nfs-server \
--file-share=vol1 \
--instance-zone=us-central1-c \
--region=asia-east2 \
--kms-key=projects/purple-project/locations/us-central1/keyRings/filestore-keyring/cryptoKeys/filestore-key
View backups
To view on-demand backups and their details, follow these steps:
gcloud
List all backups in your current project
To view a list of backups for your current project, run the backups list
command:
gcloud filestore backups list
View information about a backup
To view information about a backup, run the backups describe
command:
gcloud filestore backups describe BACKUP_NAME
\
--region= BACKUP_LOCATION
Where:
- BACKUP_NAME is the name of the backup whose information you want to view.
- BACKUP_LOCATION is the region where the backup is stored.
What's next
- Learn how to create an enhanced backup .
- Learn how to schedule enhanced backups .
- Learn how to restore standard and enhanced backups .
- Explore differences between standard and enhanced backups .
- Learn how to create backup vaults and plans with Backup and DR Service .

