gcloud beta pubsub lite-subscriptions create

NAME
gcloud beta pubsub lite-subscriptions create - create a Pub/Sub Lite subscription
SYNOPSIS
gcloud beta pubsub lite-subscriptions create SUBSCRIPTION --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 
 = 
mytopic 

To 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 
 = 
beginning 

To 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_REQUIREMENT must 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 project attribute:

  • provide the argument --location on the command line with a fully specified name;
  • provide the argument --zone on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project .
--location = LOCATION
ID of the location or fully qualified identifier for the location.

To set the location attribute:

  • provide the argument --location on the command line;
  • provide the argument --zone on the command line.
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_OFFSET must 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_STATE must 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 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 beta and might change without notice. These variants are also available:
  gcloud  
pubsub  
lite-subscriptions  
create 
 
  gcloud  
alpha  
pubsub  
lite-subscriptions  
create 
 
Create a Mobile Website
View Site in Mobile | Classic
Share by: