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] [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.

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