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

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

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

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

        $ gcloud alpha 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 alpha 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 alpha 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 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 create

        $ gcloud beta pubsub lite-subscriptions create