NAME
    gcloud alpha filestore snapshots create - create a Filestore snapshot

SYNOPSIS
    gcloud alpha filestore snapshots create SNAPSHOT --file-share=FILE_SHARE
        --instance=INSTANCE --instance-zone=INSTANCE_ZONE [--async]
        [--labels=[KEY=VALUE,...]] [--region=REGION] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Take a Filestore snapshot of an instance file share.

    This command can fail for the following reasons:
      ▪ An instance with the same name already exists.
      ▪ The active account does not have permission to create snapshots.

EXAMPLES
    To create a snapshot with the name 'my-snapshot' from an instance called
    'my-instance' in 'us-central1-c' and the source file share called 'my-fs',
    run:

        $ gcloud alpha filestore snapshots create my-snapshot \
            --instance=my-instance --file-share=my-fs \
            --instance-zone=us-central1-c

    To create a snapshot with the name 'my-snapshot' 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 alpha filestore snapshots create my-snapshot \
            --instance=my-instance --file-share=my-fs \
            --instance-zone=us-central1-c --region=us-central1

POSITIONAL ARGUMENTS
     SNAPSHOT
        Arguments and flags that specify the Filestore snapshot you want to
        create.

REQUIRED FLAGS
     --file-share=FILE_SHARE
        File share name on the Filestore instance to snapshot.

     --instance=INSTANCE
        Share name of the Filestore instance you want to snapshot.

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

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

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

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

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/v1p1alpha1 API. The full documentation for this
    API can be found at: https://cloud.google.com/filestore/

NOTES
    This command is currently in alpha and might change without notice. If this
    command fails with API permission errors despite specifying the correct
    project, you might be trying to access an API with an invitation-only early
    access allowlist.

