NAME
    gcloud beta network-connectivity spokes linked-router-appliances create -
        create a new Router appliance spoke

SYNOPSIS
    gcloud beta network-connectivity spokes linked-router-appliances create
        (SPOKE : --region=REGION) --hub=HUB
        --router-appliance=[instance=INSTANCE],[ip=IP] [--async]
        [--description=DESCRIPTION]
        [--exclude-export-ranges=[EXCLUDE_EXPORT_RANGES,...]]
        [--exclude-import-ranges=[EXCLUDE_IMPORT_RANGES,...]] [--group=GROUP]
        [--include-export-ranges=[INCLUDE_EXPORT_RANGES,...]]
        [--include-import-ranges=[INCLUDE_IMPORT_RANGES,...]]
        [--labels=[KEY=VALUE,...]] [--site-to-site-data-transfer]
        [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (BETA) Create a new Router appliance spoke
    (https://cloud.google.com/network-connectivity/docs/network-connectivity-center/how-to/working-with-hubs-spokes#create-ra-spoke).

EXAMPLES
    To create a spoke in region us-central1 that uses data transfer and has two
    router appliance instances, run:

        $ gcloud beta network-connectivity spokes linked-router-appliances \
            create my-spoke \
            --hub="https://www.googleapis.com/networkconnectivity/v1/project\
        s/my-project/locations/global/hubs/my-hub" --region=us-central1 \
            --router-appliance=instance=https://www.googleapis.com/compute/\
        v1/projects/my-project/zones/us-central1-a/instances/vm1,\
        ip=10.10.0.1 \
            --router-appliance=instance=https://www.googleapis.com/compute/\
        v1/projects/my-project/zones/us-central1-a/instances/vm2,\
        ip=10.10.0.2 --site-to-site-data-transfer

POSITIONAL ARGUMENTS
     Spoke resource - Name of the spoke to be created. The arguments in this
     group can be used to specify the attributes of this 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 spoke on the command line with a fully specified
        name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

     This must be specified.

       SPOKE
          ID of the spoke or fully qualified identifier for the spoke.

          To set the spoke attribute:
          ▸ provide the argument spoke on the command line.

          This positional argument must be specified if any of the other
          arguments in this group are specified.

       --region=REGION
          The location Id.

          To set the region attribute:
          ▸ provide the argument spoke on the command line with a fully
            specified name;
          ▸ provide the argument --region on the command line.

REQUIRED FLAGS
     --hub=HUB
        Hub that the spoke will attach to. The hub must already exist.

     --router-appliance=[instance=INSTANCE],[ip=IP]
        Router appliance instance(s) that the spoke provides connectivity to.
        The resources must already exist.

        For example, use --router-appliance=instance=ins_uri_1,ip=10.10.0.1 to
        add a single router appliance instance, or
        --router-appliance=instance=ins_uri_1,ip=10.10.0.1
        --router-appliance=instance=ins_uri_2,ip=10.10.0.2 ... to add multiple
        instances.

OPTIONAL FLAGS
     --async
        Return immediately, without waiting for the operation in progress to
        complete.

     --description=DESCRIPTION
        Description of the spoke to create.

     --exclude-export-ranges=[EXCLUDE_EXPORT_RANGES,...]
        Dynamic routes overlapped/encompassed by exclude export ranges are
        excluded during export to hub.

     --exclude-import-ranges=[EXCLUDE_IMPORT_RANGES,...]
        Hub routes overlapped/encompassed by exclude import ranges are excluded
        during import from hub.

     --group=GROUP
        The group that the spoke will be added to. The group must already
        exist. If unset, the spoke will be added to the ``default`` group.

     --include-export-ranges=[INCLUDE_EXPORT_RANGES,...]
        Dynamic routes fully encompassed by include export ranges are included
        during export to hub. If it's empty, the spoke exports all dynamic
        routes to the hub.

     --include-import-ranges=[INCLUDE_IMPORT_RANGES,...]
        Hub routes fully encompassed by include import ranges are included
        during import from hub. If it's empty, the spoke does not import any
        subnets from the hub. If it's empty and site-to-site-data-transfer is
        true, the spoke imports all IPv4 site-to-site dynamic routes from the
        hub.

     --labels=[KEY=VALUE,...]
        List of label KEY=VALUE pairs to add.

        Keys must start with a lowercase character and contain only hyphens
        (-), underscores (_), lowercase characters, and numbers. Values must
        contain only hyphens (-), underscores (_), lowercase characters, and
        numbers.

     --site-to-site-data-transfer
        Whether to enable site-to-site data transfer for this spoke. Data
        transfer is available only in supported locations
        (https://cloud.google.com/network-connectivity/docs/network-connectivity-center/concepts/locations).

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 networkconnectivity/v1beta API. The full
    documentation for this API can be found at:
    https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest

NOTES
    This command is currently in beta and might change without notice. This
    variant is also available:

        $ gcloud network-connectivity spokes linked-router-appliances create

