gcloud alpha filestore backups create

NAME
gcloud alpha filestore backups create - create a Filestore backup
SYNOPSIS
gcloud alpha filestore backups createBACKUP--file-share=FILE_SHARE--instance=INSTANCE--instance-zone=INSTANCE_ZONE--region=REGION[--async][--description=DESCRIPTION][--labels=[KEY=VALUE,…]][GCLOUD_WIDE_FLAG …]
DESCRIPTION
(ALPHA) Create a Filestore backup of an instance file share.

This command can fail for the following reasons:

  • A backup with the same name already exists.
  • The active account does not have permission to create backups.
EXAMPLES
To create a backup with the name 'my-backup' and description 'My backupdescription' in a particular region like 'us-central1' from an instance called'my-instance' in 'us-central1-c' and the source file share called 'my-fs', run:
gcloudalphafilestorebackupscreatemy-backup--instance=my-instance--file-share=my-fs--instance-zone=us-central1-c--region=us-central1--description="My backup description"
POSITIONAL ARGUMENTS
BACKUP
Arguments and flags that specify the Filestore backup you want to create.
REQUIRED FLAGS
--file-share=FILE_SHARE
File share name on the Filestore instance to backup.
--instance=INSTANCE
Share name of the Filestore instance you want to backup.
--instance-zone=INSTANCE_ZONE
Zone of the Filestore instance.
--region=REGION
Region (e.g. us-central1) for the backup.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--description=DESCRIPTION
Description for the backup. Limit: 2048 characters.
--labels=[KEY=VALUE,…]
List of label KEY=VALUE pairs to add.
GCLOUD WIDE FLAGS
These flags are available to all commands:--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.

Run$gcloud help for details.

API REFERENCE
This command uses thefile/v1p1alpha1 API. The full documentationfor this API can be found at:https://cloud.google.com/filestore/
NOTES
This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudfilestorebackupscreate
gcloudbetafilestorebackupscreate

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-06-03 UTC.