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]
        [--starting-offset=STARTING_OFFSET; default="end"]
        [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

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.

     --starting-offset=STARTING_OFFSET; default="end"
        The offset at which a newly created or seeked subscription will start
        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.

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