- NAME
-
- gcloud beta pubsub lite-subscriptions create - create a Pub/Sub Lite subscription
- SYNOPSIS
-
-
gcloud beta pubsub lite-subscriptions createSUBSCRIPTION--topic=TOPIC[--delivery-requirement=DELIVERY_REQUIREMENT; default="deliver-immediately"] [--location=LOCATION] [--event-time=EVENT_TIME|--publish-time=PUBLISH_TIME|--starting-offset=STARTING_OFFSET; default="end"] [--export-pubsub-topic=EXPORT_PUBSUB_TOPIC:--export-dead-letter-topic=EXPORT_DEAD_LETTER_TOPIC--export-desired-state=EXPORT_DESIRED_STATE; default="active"] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)Create a Pub/Sub Lite subscription. - EXAMPLES
- To create a Pub/Sub Lite subscription, run:
gcloud beta pubsub lite-subscriptions create mysubscription --location = us-central1-a --topic = mytopicTo create a Pub/Sub Lite subscription at the offset of the oldest retained message, run:
gcloud beta pubsub lite-subscriptions create mysubscription --location = us-central1-a --topic = mytopic --starting-offset = beginningTo create a Pub/Sub Lite subscription that exports messages from a Pub/Sub Lite topic to a Pub/Sub topic, run:
gcloud beta pubsub lite-subscriptions create mysubscription --location = us-central1-a --topic = mytopic --export-pubsub-topic = pubsubtopic - POSITIONAL ARGUMENTS
-
-
SUBSCRIPTION - Subscription ID.
-
- REQUIRED FLAGS
-
-
--topic=TOPIC - Topic ID associated with the subscription.
-
- OPTIONAL FLAGS
-
-
--delivery-requirement=DELIVERY_REQUIREMENT; default="deliver-immediately" - 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_REQUIREMENTmust be one of:deliver-after-stored,deliver-immediately. - Location resource - Identifies the Cloud zone this command will be executed on.
This represents a Cloud resource. (NOTE) Some attributes are not given arguments
in this group but can be set in other ways.
To set the
projectattribute:- provide the argument
--locationon the command line with a fully specified name; - provide the argument
--zoneon the command line with a fully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
- provide the argument
-
--location=LOCATION - ID of the location or fully qualified identifier for the location.
To set the
locationattribute:- provide the argument
--locationon the command line; - provide the argument
--zoneon the command line.
- provide the argument
- At most one of these can be specified:
-
--event-time=EVENT_TIME - The event time to which you seek a subscription. The subscription seeks to the first message with event time greater than or equal to the specified event time. Messages missing an event time use publish time as a fallback. As event times are user supplied, subsequent messages may have event times less than the specified event time and must be filtered by the client, if necessary. Run $ gcloud topic datetimes for information on time formats.
-
--publish-time=PUBLISH_TIME - The publish time to which you seek a subscription. Messages with publish time greater than or equal to the specified time are delivered after the seek operation. Run $ gcloud topic datetimes for information on time formats.
-
--starting-offset=STARTING_OFFSET; default="end" - The offset at which a newly created or seeked subscription starts receiving
messages. A subscription can be initialized at the offset of the oldest retained
message (
beginning), or at the current HEAD offset (end).STARTING_OFFSETmust be one of:beginning,end.
-
-
--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.
-
--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; default="active" - 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_STATEmust be one of:active,paused.
-
- 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 helpfor details. - API REFERENCE
- This command uses the
pubsublite/v1API. The full documentation for this API can be found at: https://cloud.google.com/pubsub/lite/docs - NOTES
- This command is currently in beta and might change without notice. These
variants are also available:
gcloud pubsub lite-subscriptions creategcloud alpha pubsub lite-subscriptions create
gcloud beta pubsub lite-subscriptions create
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 2026-05-27 UTC.

