NAME
    gcloud alpha pubsub snapshots create - creates one or more Cloud Pub/Sub
        snapshots

SYNOPSIS
    gcloud alpha pubsub snapshots create SNAPSHOT [SNAPSHOT ...]
        --subscription=SUBSCRIPTION [--labels=[KEY=VALUE,...]]
        [--subscription-project=SUBSCRIPTION_PROJECT] [--tags=[KEY=VALUE,...]]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (ALPHA) Creates one or more Cloud Pub/Sub snapshots.

POSITIONAL ARGUMENTS
     SNAPSHOT [SNAPSHOT ...]
        One or more snapshot names to create.

REQUIRED FLAGS
     --subscription=SUBSCRIPTION
        The subscription whose backlog the snapshot retains. Specifically, the
        created snapshot is guaranteed to retain a) The existing backlog on the
        subscription, i.e., the set of messages in the subscription that are
        unacknowledged upon the successful completion of the create snapshot
        request, b) Any messages published to the subscription's topic
        following the successful creation of the snapshot.

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

        Keys must start with a lowercase character and contain only hyphens
        (-), underscores (_), lowercase characters, and numbers. Values must
        contain only hyphens (-), underscores (_), lowercase characters, and
        numbers.

     --subscription-project=SUBSCRIPTION_PROJECT
        The name of the project the provided subscription belongs to. If not
        set, it defaults to the currently selected cloud project.

     --tags=[KEY=VALUE,...]
        List of tags KEY=VALUE pairs to bind. Each item must be expressed as
        <tag-key-namespaced-name>=<tag-value-short-name>. Example:
        123/environment=production,123/costCenter=marketing

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.

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. These variants are also available:

        $ gcloud pubsub snapshots create

        $ gcloud beta pubsub snapshots create

