- NAME
-
- gcloud compute network-attachments create - create a Google Compute Engine network attachment
- SYNOPSIS
-
-
gcloud compute network-attachments createNAME--subnets=SUBNETS, [SUBNETS, …] [--connection-preference=CONNECTION_PREFERENCE; default="ACCEPT_AUTOMATIC"] [--description=DESCRIPTION] [--producer-accept-list=[ACCEPT_LIST, …]] [--producer-reject-list=[REJECT_LIST, …]] [--region=REGION] [--subnets-region=SUBNETS_REGION] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
gcloud compute network-attachments createis used to create network attachments. A service consumer creates network attachments and makes it available to producers. Service producers then use a multi-NIC VM to form a bi-directional, non-NAT'd communication channel. - EXAMPLES
-
gcloud compute network-attachments create NETWORK_ATTACHMENT_NAME --region = us-central1 --subnets = MY_SUBNET --connection-preference = ACCEPT_MANUAL --producer-accept-list = PROJECT1,PROJECT2 --producer-reject-list = PROJECT3,PROJECT4To create a network attachment with a textual description, run:
gcloud compute network-attachments create NETWORK_ATTACHMENT_NAME --region = us-central1 --subnets = MY_SUBNET --connection-preference = ACCEPT_MANUAL --producer-accept-list = PROJECT1,PROJECT2 --producer-reject-list = PROJECT3,PROJECT4 --description = 'default network attachment' - POSITIONAL ARGUMENTS
-
-
NAME - Name of the network attachment to create.
-
- REQUIRED FLAGS
-
-
--subnets=SUBNETS,[SUBNETS,…] - The subnetworks provided by the consumer for the producers
-
- OPTIONAL FLAGS
-
-
--connection-preference=CONNECTION_PREFERENCE; default="ACCEPT_AUTOMATIC" - The connection preference of network attachment. The value can be set to
ACCEPT_AUTOMATIC or ACCEPT_MANUAL. An ACCEPT_AUTOMATIC network attachment is one
that always accepts the connection from producer NIC. An ACCEPT_MANUAL network
attachment is one that requires an explicit addition of the producer project id
or project number to the producer accept list.
CONNECTION_PREFERENCEmust be one of:ACCEPT_AUTOMATIC,ACCEPT_MANUAL. -
--description=DESCRIPTION - An optional, textual description for the network attachment.
-
--producer-accept-list=[ACCEPT_LIST,…] - Projects that are allowed to connect to this network attachment.
-
--producer-reject-list=[REJECT_LIST,…] - Projects that are not allowed to connect to this network attachment.
-
--region=REGION - Region of the network attachment to create. If not specified, you might be
prompted to select a region (interactive mode only).
To avoid prompting when this flag is omitted, you can set the
compute/regiongcloud config set compute/region REGIONA list of regions can be fetched by running:
gcloud compute regions listTo unset the property, run:
gcloud config unset compute/regionAlternatively, the region can be stored in the environment variable
CLOUDSDK_COMPUTE_REGION -
--subnets-region=SUBNETS_REGION - Region of the subnetworks to operate on. Overrides the default
compute/regionproperty value for this command invocation.
-
- 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. - NOTES
- These variants are also available:
gcloud alpha compute network-attachments creategcloud beta compute network-attachments creategcloud preview compute network-attachments create
gcloud compute network-attachments 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.
