- NAME
-
- gcloud network-connectivity transports create - create a transport
- SYNOPSIS
-
-
gcloud network-connectivity transports createTRANSPORT--network=NETWORK(--activation-key=ACTIVATION_KEY|--bandwidth=BANDWIDTH--remote-account-id=REMOTE_ACCOUNT_ID--remote-profile=REMOTE_PROFILE) [--advertised-routes=[CIDR_RANGE, …]] [--async] [--description=DESCRIPTION] [--labels=[KEY=VALUE, …]] [--region=REGION] [--stack-type=STACK_TYPE; default="ipv4-only"] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
- Create a transport with the given name to a remote provider.
- EXAMPLES
- To create a transport that generates a key to
.aws-us-east-1gcloud 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 network-connectivity transports create my-cci-aws --activation-key ABC1234 --network default - 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
projectattribute:- provide the argument
transporton the command line with a fully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
regionattribute:- provide the argument
transporton the command line with a fully specified name; - provide the argument
--regionon the command line.
This must be specified.
-
TRANSPORT - ID of the transport or fully qualified identifier for the transport.
To set the
transportattribute:- provide the argument
transporton the command line.
- provide the argument
- provide the argument
- 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.
- REQUIRED FLAGS
-
-
--network=NETWORK - ID of the network or fully qualified identifier for the network.
To set the
networkattribute:- provide the argument
--networkon the command line.
- provide the argument
- 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.
BANDWIDTHmust 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
projectattribute:- provide the argument
--remote-profileon the command line with a fully specified name; - provide the argument
--projecton the command line; - set the property
core/project.
To set the
regionattribute:- provide the argument
--remote-profileon the command line with a fully specified name; - provide the argument
--regionon 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_profileattribute:- provide the argument
--remote-profileon the command line.
- provide the argument
- provide the argument
-
-
- OPTIONAL FLAGS
-
-
--advertised-routes=[CIDR_RANGE,…] - List of routes to advertise from the VPC
networktoward the provider. -
--async - Return immediately, without waiting for the operation in progress to complete.
-
--description=DESCRIPTION - Description of the transport.
-
--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_TYPEmust 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 helpfor details. - API REFERENCE
- This command uses the
networkconnectivity/v1API. The full documentation for this API can be found at: https://cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest - NOTES
- This variant is also available:
gcloud beta network-connectivity transports create
gcloud network-connectivity transports create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

