gcloud compute networks peerings create

NAME
gcloud compute networks peerings create - create a Compute Engine network peering
SYNOPSIS
gcloud compute networks peerings createNAME--network=NETWORK--peer-network=PEER_NETWORK[--async][--auto-create-routes][--export-custom-routes][--export-subnet-routes-with-public-ip][--import-custom-routes][--import-subnet-routes-with-public-ip][--peer-project=PEER_PROJECT][--stack-type=STACK_TYPE][--update-strategy=UPDATE_STRATEGY][GCLOUD_WIDE_FLAG …]
DESCRIPTION
gcloud compute networks peerings create is used to create peeringsbetween virtual networks. Each side of a peering association is set upindependently. Peering will be active only when the configuration from bothsides matches.
EXAMPLES
To create a network peering with the name 'peering-name' between the network'local-network' and the network 'peer-network' which exports and imports customroutes and subnet routes with public IPs, run:
gcloudcomputenetworkspeeringscreatepeering-name--network=local-network--peer-network=peer-network--export-custom-routes--import-custom-routes--export-subnet-routes-with-public-ip--import-subnet-routes-with-public-ip
POSITIONAL ARGUMENTS
NAME
The name of the peering.
REQUIRED FLAGS
--network=NETWORK
The name of the network in the current project to be peered with the peernetwork.
--peer-network=PEER_NETWORK
The name of the network to be peered with the current network.
OPTIONAL FLAGS
--async
Return immediately, without waiting for the operation in progress to complete.
--auto-create-routes
(DEPRECATED) If set, will automatically create routes for the network peering.Flag auto-create-routes is deprecated. Peer network subnet routes are alwayscreated in a network when peered.

Flag --auto-create-routes is deprecated and will be removed in a future release.

--export-custom-routes
If set, the network will export custom routes to peer network. Use--no-export-custom-routes to disable it.
--export-subnet-routes-with-public-ip
If set, the network will export subnet routes with addresses in the public IPranges to peer network. Use --no-export-subnet-routes-with-public-ip to disableit.
--import-custom-routes
If set, the network will import custom routes from peer network. Use--no-import-custom-routes to disable it.
--import-subnet-routes-with-public-ip
If set, the network will import subnet routes with addresses in the public IPranges from peer network. Use --no-import-subnet-routes-with-public-ip todisable it.
--peer-project=PEER_PROJECT
The name of the project for the peer network. If not specified, defaults tocurrent project.
--stack-type=STACK_TYPE
Stack type of the peering. If not specified, defaults to IPV4_ONLY.

STACK_TYPE must be one of:

IPV4_ONLYOnlyIPv4trafficandrouteswillbeexchangedacrossthispeering.
IPV4_IPV6IPv4trafficandrouteswillbeexchangedacrossthispeering.IPv6trafficandrouteswillbeexchangedifthematchingpeeringconfigurationalsohasstack_typesettoIPV4_IPV6.
--update-strategy=UPDATE_STRATEGY
Update strategy of the peering. If not specified, defaults to INDEPENDENT.

UPDATE_STRATEGY must be one of:

INDEPENDENT Updates and deletes to the peering connection can be performed byeither network admin.

CONSENSUS Updates and deletes to the peering connection must be agreed upon byboth network admins.

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.

NOTES
These variants are also available:
gcloudalphacomputenetworkspeeringscreate
gcloudbetacomputenetworkspeeringscreate

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-08-26 UTC.