.TH "GCLOUD_ALPHA_PUBSUB_LITE\-SUBSCRIPTIONS_CREATE" 1



.SH "NAME"
.HP
gcloud alpha pubsub lite\-subscriptions create \- create a Pub/Sub Lite subscription



.SH "SYNOPSIS"
.HP
\f5gcloud alpha pubsub lite\-subscriptions create\fR \fISUBSCRIPTION\fR \fB\-\-topic\fR=\fITOPIC\fR [\fB\-\-delivery\-requirement\fR=\fIDELIVERY_REQUIREMENT\fR;\ default="deliver\-immediately"] [\fB\-\-location\fR=\fILOCATION\fR] [\fB\-\-event\-time\fR=\fIEVENT_TIME\fR\ |\ \fB\-\-publish\-time\fR=\fIPUBLISH_TIME\fR\ |\ \fB\-\-starting\-offset\fR=\fISTARTING_OFFSET\fR;\ default="end"] [\fB\-\-export\-pubsub\-topic\fR=\fIEXPORT_PUBSUB_TOPIC\fR\ :\ \fB\-\-export\-dead\-letter\-topic\fR=\fIEXPORT_DEAD_LETTER_TOPIC\fR\ \fB\-\-export\-desired\-state\fR=\fIEXPORT_DESIRED_STATE\fR;\ default="active"] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR Create a Pub/Sub Lite subscription.



.SH "EXAMPLES"

To create a Pub/Sub Lite subscription, run:

.RS 2m
$ gcloud alpha pubsub lite\-subscriptions create mysubscription \e
  \-\-location=us\-central1\-a \-\-topic=mytopic
.RE

To create a Pub/Sub Lite subscription at the offset of the oldest retained
message, run:

.RS 2m
$ gcloud alpha pubsub lite\-subscriptions create mysubscription \e
  \-\-location=us\-central1\-a \-\-topic=mytopic \e
  \-\-starting\-offset=beginning
.RE

To create a Pub/Sub Lite subscription that exports messages from a Pub/Sub Lite
topic to a Pub/Sub topic, run:

.RS 2m
$ gcloud alpha pubsub lite\-subscriptions create mysubscription \e
  \-\-location=us\-central1\-a \-\-topic=mytopic \e
  \-\-export\-pubsub\-topic=pubsubtopic
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fISUBSCRIPTION\fR

Subscription ID.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m
\fB\-\-topic\fR=\fITOPIC\fR

Topic ID associated with the subscription.


.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-delivery\-requirement\fR=\fIDELIVERY_REQUIREMENT\fR; 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. \fIDELIVERY_REQUIREMENT\fR must be one of:
\fBdeliver\-after\-stored\fR, \fBdeliver\-immediately\fR.

.TP 2m

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 \f5project\fR attribute:
.RS 2m
.IP "\(em" 2m
provide the argument \f5\-\-location\fR on the command line with a fully
specified name;
.IP "\(em" 2m
provide the argument \f5\-\-zone\fR on the command line with a fully specified
name;
.IP "\(em" 2m
provide the argument \f5\-\-project\fR on the command line;
.IP "\(em" 2m
set the property \f5core/project\fR.
.RE
.sp


.RS 2m
.TP 2m
\fB\-\-location\fR=\fILOCATION\fR

ID of the location or fully qualified identifier for the location.

To set the \f5location\fR attribute:
.RS 2m
.IP "\(bu" 2m
provide the argument \f5\-\-location\fR on the command line;
.IP "\(bu" 2m
provide the argument \f5\-\-zone\fR on the command line.
.RE
.sp

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-event\-time\fR=\fIEVENT_TIME\fR

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.

.TP 2m
\fB\-\-publish\-time\fR=\fIPUBLISH_TIME\fR

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.

.TP 2m
\fB\-\-starting\-offset\fR=\fISTARTING_OFFSET\fR; 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 (\f5beginning\fR), or at the current HEAD offset (\f5end\fR).
\fISTARTING_OFFSET\fR must be one of: \fBbeginning\fR, \fBend\fR.

.RE
.sp
.TP 2m
\fB\-\-export\-pubsub\-topic\fR=\fIEXPORT_PUBSUB_TOPIC\fR

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.

.TP 2m
\fB\-\-export\-dead\-letter\-topic\fR=\fIEXPORT_DEAD_LETTER_TOPIC\fR

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.

.TP 2m
\fB\-\-export\-desired\-state\fR=\fIEXPORT_DESIRED_STATE\fR; 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.
\fIEXPORT_DESIRED_STATE\fR must be one of: \fBactive\fR, \fBpaused\fR.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "API REFERENCE"

This command uses the \fBpubsublite/v1\fR API. The full documentation for this
API can be found at: https://cloud.google.com/pubsub/lite/docs



.SH "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:

.RS 2m
$ gcloud pubsub lite\-subscriptions create
.RE

.RS 2m
$ gcloud beta pubsub lite\-subscriptions create
.RE