NAME
    gcloud filestore backups create - create a Filestore backup

SYNOPSIS
    gcloud filestore backups create BACKUP --file-share=FILE_SHARE
        --instance=INSTANCE --region=REGION
        (--instance-location=INSTANCE_LOCATION | --instance-zone=INSTANCE_ZONE)
        [--async] [--description=DESCRIPTION] [--kms-key=KMS_KEY]
        [--labels=[KEY=VALUE,...]] [--tags=[KEY=VALUE,...]]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    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 backup
    description' 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:

        $ gcloud filestore backups create my-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.

     --region=REGION
        Region (e.g. us-central1) for the backup.

     Exactly one of these must be specified:

       --instance-location=INSTANCE_LOCATION
          Region of the Filestore instance.

       --instance-zone=INSTANCE_ZONE
          Zone of the Filestore instance.

OPTIONAL FLAGS
     --async
        Return immediately, without waiting for the operation in progress to
        complete.

     --description=DESCRIPTION
        Description for the backup. Limit: 2048 characters.

     --kms-key=KMS_KEY
        CMEK for backup in the form of
        projects/{project}/locations/{location}/keyRings/{key-ring}/cryptoKeys/{crypto-key}

     --labels=[KEY=VALUE,...]
        List of label KEY=VALUE pairs to add.

     --tags=[KEY=VALUE,...]
        List of tag 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 the file/v1 API. The full documentation for this API can
    be found at: https://cloud.google.com/filestore/

NOTES
    These variants are also available:

        $ gcloud alpha filestore backups create

        $ gcloud beta filestore backups create