gcloud compute network-attachments create NAME --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 …]
gcloud compute network-attachments create is 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.
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'NAME--subnets=SUBNETS,[SUBNETS,…]--connection-preference=CONNECTION_PREFERENCE; default="ACCEPT_AUTOMATIC"CONNECTION_PREFERENCE must be one of:
ACCEPT_AUTOMATIC, ACCEPT_MANUAL.
--description=DESCRIPTION--producer-accept-list=[ACCEPT_LIST,…]--producer-reject-list=[REJECT_LIST,…]--region=REGION
To avoid prompting when this flag is omitted, you can set the
property:
compute/region
gcloud 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/regionCLOUDSDK_COMPUTE_REGION.
--subnets-region=SUBNETS_REGIONcompute/region property value for this command invocation.
--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.
gcloud alpha compute network-attachments creategcloud beta compute network-attachments creategcloud preview 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.