gcloud-help/gcloud/beta/network-connectivity/transports/create

NAME
    gcloud beta network-connectivity transports create - create a transport

SYNOPSIS
    gcloud beta network-connectivity transports create TRANSPORT
        (--activation-key=ACTIVATION_KEY | --bandwidth=BANDWIDTH
          --remote-account-id=REMOTE_ACCOUNT_ID
          --remote-profile=REMOTE_PROFILE)
        (--network=NETWORK | [--hub=HUB : --auto-accept --psc-routing-enabled])
        [--advertised-routes=[CIDR_RANGE,...]] [--async]
        [--description=DESCRIPTION] [--no-enable-admin]
        [--labels=[KEY=VALUE,...]] [--region=REGION]
        [--stack-type=STACK_TYPE; default="ipv4-only"] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION
    (BETA) Create a transport with the given name to a remote provider.

EXAMPLES
    To create a transport that generates a key to aws-us-east-1.

        $ gcloud beta network-connectivity transports create my-cci-aws \
            --bandwidth 1G --profile aws-us-east-1 \
            --remote-account-id 12345 --network default \
            --advertised-routes '10.128.0.0/9'

    To accept a key:

        $ gcloud beta network-connectivity transports create my-cci-aws \
            --activation-key ABC1234 --network default

    To create a transport with an NCC hub:

        $ gcloud beta network-connectivity transports create my-cci-aws \
            --bandwidth 1G --profile aws-us-east-1 \
            --remote-account-id 12345 \
            --hub projects/12345/locations/us-central1/hubs/my-hub \
            --auto-accept

POSITIONAL ARGUMENTS
     Transport resource - Name of the Transport to be created. 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 transport on the command line with a fully
        specified name;
      ◆ provide the argument --project on the command line;
      ◆ set the property core/project.

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

     This must be specified.

       TRANSPORT
          ID of the transport or fully qualified identifier for the transport.

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

REQUIRED FLAGS
     Exactly one of these must be specified:

       --activation-key=ACTIVATION_KEY
          Key from the remote provider to establish a connection over the
          Transport.

       Or at least one of these can be specified:

         These values must all be specified if Google is expected to generate
         the key.

         --bandwidth=BANDWIDTH
            Bandwidth of the transport to create. Must be a supported bandwidth
            on the remote profile. BANDWIDTH must be one of: 100g, 100m, 10g,
            1g, 200m, 20g, 2g, 300m, 400m, 500m, 50g, 50m, 5g.

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

         --remote-account-id=REMOTE_ACCOUNT_ID
            Account ID in the remote provider to associate with the generated
            key.

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

         RemoteTransportProfile resource - Remote transport profile
         representing the provider and their location. 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 --remote-profile on the command line with a
            fully specified name;
          ▫ provide the argument --project on the command line;
          ▫ set the property core/project.

         To set the region attribute:
          ▫ provide the argument --remote-profile on the command line with a
            fully specified name;
          ▫ provide the argument --region on the command line.

         This must be specified.

           --remote-profile=REMOTE_PROFILE
              ID of the remoteTransportProfile or fully qualified identifier
              for the remoteTransportProfile.

              To set the remote_transport_profile attribute:
              ◇ provide the argument --remote-profile on the command line.

     Exactly one of these must be specified:

       Network resource - VPC that will be peered to the provider via the
       Transport. 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 --network on the command line with a fully
          specified name;
        ▸ provide the argument --project on the command line;
        ▸ set the property core/project.

       --network=NETWORK
          ID of the network or fully qualified identifier for the network.

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

       Parameters for creating a transport with an NCC hub.

       Hub resource - Hub that the transport will be attached to. 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 --hub 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.

         --hub=HUB
            ID of the hub or fully qualified identifier for the hub.

            To set the hub attribute:
            ▫ provide the argument --hub on the command line.

       --auto-accept
          Whether to auto-accept spoke proposals for this transport.

       --psc-routing-enabled
          Whether a VPC spoke is created for PSC routing over the transport.

OPTIONAL FLAGS
     --advertised-routes=[CIDR_RANGE,...]
        List of routes to advertise from the VPC network toward the provider.

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

     --description=DESCRIPTION
        Description of the transport.

     --enable-admin
        Administrative state of the underlying connectivity. Enabled by
        default, use --no-enable-admin to disable.

     --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.

     --region=REGION
        For resources [transport, remote-profile], provides fallback value for
        resource region attribute. When the resource's full URI path is not
        provided, region will fallback to this flag value.

     --stack-type=STACK_TYPE; default="ipv4-only"
        IP version of the routes to be exchanged. STACK_TYPE must be one of:
        ipv4-ipv6, ipv4-only.

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 transports create