NAME

gcloud alpha pubsub lite-subscriptions update - update a Pub/Sub Lite subscription

SYNOPSIS

gcloud alpha pubsub lite-subscriptions update (SUBSCRIPTION : --location=LOCATION) (--delivery-requirement=DELIVERY_REQUIREMENT --export-dead-letter-topic=EXPORT_DEAD_LETTER_TOPIC --export-desired-state=EXPORT_DESIRED_STATE --export-pubsub-topic=EXPORT_PUBSUB_TOPIC) [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(ALPHA) Update a Pub/Sub Lite subscription.

EXAMPLES

To update a Pub/Sub Lite subscription, run:

$ gcloud alpha pubsub lite-subscriptions update mysubscription \ --location=us-central1-a \ --delivery-requirement=DELIVER_IMMEDIATELY

POSITIONAL ARGUMENTS

Subscription resource - Subscription to update. The arguments in this group can

be used to specify the attributes of this resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways. To set the project attribute:

provide the argument subscription on the command line with a fully specified name;

provide the argument --project on the command line;

set the property core/project.

This must be specified.

SUBSCRIPTION

ID of the subscription or fully qualified identifier for the subscription. To set the subscription attribute:

  • provide the argument subscription on the command line.

This positional argument must be specified if any of the other arguments in this group are specified.

--location=LOCATION

ID of the location of the Pub/Sub Lite resource.

To set the location attribute:

  • provide the argument subscription on the command line with a fully specified name;

  • provide the argument --location on the command line;

  • provide the argument --zone on the command line.

REQUIRED FLAGS

At least one of these must be specified:
--delivery-requirement=DELIVERY_REQUIREMENT

When this subscription should send messages to subscribers relative to messages persistence in storage. See https://cloud.google.com/pubsub/lite/docs/subscriptions#creating_lite_subscriptions for more info. DELIVERY_REQUIREMENT must be one of: deliver-after-stored, deliver-immediately.

--export-dead-letter-topic=EXPORT_DEAD_LETTER_TOPIC

The name of the Pub/Sub Lite topic to write messages that cannot be exported. Must be in the same project and location as the subscription to be created. Note that this is a Lite topic.

--export-desired-state=EXPORT_DESIRED_STATE

The desired state of the export. Process messages by setting the value to ACTIVE or pause message processing by setting the value to PAUSED. EXPORT_DESIRED_STATE must be one of: active, paused.

--export-pubsub-topic=EXPORT_PUBSUB_TOPIC

The name of the destination Pub/Sub topic to which messages are exported. Must be the topic's fully specified path if it is not in the same project as the subscription to be created.

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 pubsublite/v1 API. The full documentation for this API can be found at: https://cloud.google.com/pubsub/lite/docs

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 lite-subscriptions update

$ gcloud beta pubsub lite-subscriptions update