- 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.
-
provide the argument
--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.
-
provide the argument
-
provide the argument
-
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.
- 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.
-
At least one of these must be specified:
- 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
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-02-06 UTC.