gcloud-help/gcloud/pubsub/lite-subscriptions/create

NAME
    gcloud pubsub lite-subscriptions create - create a Pub/Sub Lite
        subscription

SYNOPSIS
    gcloud 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
    Create a Pub/Sub Lite subscription.

EXAMPLES
    To create a Pub/Sub Lite subscription, run:

        $ gcloud 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 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 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
    These variants are also available:

        $ gcloud alpha pubsub lite-subscriptions create

        $ gcloud beta pubsub lite-subscriptions create