Create a cross-site network Stay organized with collections Save and categorize content based on your preferences.
You can create cross-site networksover connections that havepassed all testsand are ready to use.
Billing for a cross-site network starts when you create wires andstops when you delete them.
Permissions required for this task
To perform this task, you must have been granted the following permissionsor the following Identity and Access Management (IAM) roles.
Permissions
compute.interconnects.usecompute.crossSiteNetworks.createcompute.wireGroups.create
Roles
- Owner (
roles/owner) - Editor (
roles/editor) - Compute Network Admin (
roles/compute.networkAdmin)
To create a cross-site network, follow these steps:
Console
In the Google Cloud console, go to theInterconnect page.
On theCross-site networks tab, clickCreate cross-site network.
Specify the details of the cross-site network:
- Name: a name for the cross-site network
- Description: an optional description of the cross-site network
ClickNext.
Specify the basic details of the wire group to add to the cross-sitenetwork:
- Name: a name for the wire group.
- Description: an optional description of the wire group.
Select eitherVLAN mode orPort mode for your wire group. If necessary, reviewTraffic modes in the Cross-Site Interconnect overview.
In theUnmetered bandwidth field, enter the unmetered bandwidth,in Gbps, for the wire group.
You can't configure bandwidth that exceeds the following:
- Your quota between a given pair of metros or the limit for a given wire.If you haven't already, follow the instructions tocheck quotas and limits for bandwidth.
- The Cross-Site Interconnect connection capacity.
For additional considerations for configuringthis field, seeWire bandwidth.
If you configuredPort mode, review theFailure detectionfield. To enable failure detection, select theDisable portcheckbox.
When you enable failure detection,Google Cloud continuously monitors each wire and disables a wireif it loses connectivity so that you can failover to an alternatepath, such as another healthy wire in the group.
Choose whether to allocate the wire group's bandwidth setting to eachwire or to share the bandwidth between all wires in the group.
- Allocate per wire. The unmetered bandwidth is allocated to eachwire in the group. Consider the cost implications, because per-wireallocation reserves double the total bandwidth compared to sharedallocation.
- Shared with wire group. The unmetered bandwidth is divided equallybetween each wire in the group. However, dynamic throttling allocatesunused unmetered bandwidth to other wires in the group.
ClickNext.
Specify the Cross-Site Interconnect connections over which to createyour cross-site network.
- Depending on your topology, select the connection or redundant connections that you created for your first site,Site A.
- Depending on your topology, select the connection or redundant connections that you created for your second site,Site B.
ClickNext.
If you configuredVLAN mode, specifyVLAN tags for eachwire in your wire group by entering an integer from
2to4093.You can't enter a VLAN tag value that is already in use on the sameCross-Site Interconnect connection.
Review the configuration of your cross-site network, and then clickCreate network.
If necessary, create additional wire groups in the cross-site networkby following the instructions toadd a wire group.You might want to add a wire group for the following reasons:
To add more bandwidth between site A and site B.
To connect additional sites. For example, you can add wiregroups that connect an additional site, site C, to site A and site B.
gcloud
Google Cloud CLI procedure overview
To complete the procedure for creating a cross-site network by usingthe Google Cloud CLI, do the following:
- Create a cross-site network
- Add a wire group to the cross-site network
- Add an endpoint and connections for site A to the wire group:
- Add an endpoint and connections for site B to the wire group:
You can create additional wire groups in the cross-site network dependingon your use case:
To add more bandwidth between site A and site B, repeat the stepsfor creating a wire group and adding endpoints and connections.
To connect additional sites, repeat the steps for each pair of sitesthat you want to connect. For example, you can create an additional wiregroup that connects site A to site C, and another that connects site B to site C.
You can alsoadd more wire groups later.
1. Create a cross-site network
To create a cross-site network, use thegcloud compute interconnects cross-site-networks create command.
gcloud compute interconnects cross-site-networks createCROSS_SITE_NETWORK_NAME \ [--description=DESCRIPTION]
Replace the following values:
CROSS_SITE_NETWORK_NAME: the name of the cross-site networkDESCRIPTION: an optional description for the cross-sitenetwork
2. Add a wire group
To add a wire group, use thegcloud compute interconnects wire-groups create command.
gcloud compute interconnects wire-groups createWIRE_GROUP_NAME \ --cross-site-network=CROSS_SITE_NETWORK_NAME \ --bandwidth-unmetered=UNMETERED_BANDWIDTH \ --bandwidth-allocation=BANDWIDTH_ALLOCATION \ --fault-response=FAILURE_DETECTION \ [--description=DESCRIPTION]
Replace the following values:
WIRE_GROUP_NAME: the name of the wire groupCROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork to add the wire group to
UNMETERED_BANDWIDTH: the unmetered bandwidthfor the wire group in Gbps. The bandwidth that you specify is allocatedto each wire in the group.You can't configure bandwidth that exceeds the following:
- Your quota between a given pair of metros or the limit for a given wire.If you haven't already, follow the instructions tocheck quotas and limits for bandwidth.
- The Cross-Site Interconnect connection capacity.
For additional considerations for configuringthis field, seeWire bandwidth.
BANDWIDTH_ALLOCATION: use this flag to set thebandwidth allocation scope, which can have either of the following values:ALLOCATE_PER_WIRE, which provides a separate unmetered bandwidthallocation for each wire in the group.SHARED_WITH_WIRE_GROUP, which has one unmetered bandwidth allocationthat is divided across each wire in the group. Dynamic throttlingreallocates unused bandwidth from unutilized or underutilized wires toother wires in the group.
FAILURE_DETECTION: use this flag for port modeconfigurations only. To enable failure detection, enterDISABLE_PORT.Otherwise, enterNONE.When you enable failure detection,Google Cloud continuously monitors each wire and disables a wireif it loses connectivity so that you can failover to an alternatepath, such as another healthy wire in the group.
DESCRIPTION: an optional description of the wire group.
3a. Add an endpoint for site A
To add an endpoint to the wire group that represents your first site, orsite A, use thegcloud compute interconnects wire-groups add-endpoint command.
gcloud compute interconnects wire-groups add-endpointWIRE_GROUP_NAME \ --cross-site-network=CROSS_SITE_NETWORK_NAME \ --endpoint-label=ENDPOINT_A_LABEL
Replace the following values:
WIRE_GROUP_NAME: the name of the wire group that youcreated previouslyCROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork to which you are adding a wire groupENDPOINT_A_LABEL: a label for the endpoint, suchasashburn
3b. Add connection A1
To add the first Cross-Site Interconnect connection to thewire group for site A, orconnection A1, use thegcloud compute interconnects wire-groups add-interconnect command.
gcloud compute interconnects wire-groups add-interconnectWIRE_GROUP_NAME \ --cross-site-network=CROSS_SITE_NETWORK_NAME \ --endpoint-label=ENDPOINT_A_LABEL \ --interconnect-label=INTERCONNECT_CONNECTION_A1_LABEL \ --interconnect=INTERCONNECT_CONNECTION_A1 \ --vlan-tags=TRAFFIC_MODE
Replace the following values:
WIRE_GROUP_NAME: the name of the wire group that youcreated previouslyCROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork to which you are adding a wire groupENDPOINT_A_LABEL: the existing label that you specifiedwhen you created the endpoint for site AINTERCONNECT_CONNECTION_A1_LABEL: a new labelfor the first Cross-Site Interconnect connection that youcreated for site AINTERCONNECT_CONNECTION_A1: the connectionthat you created for site A. You can specify the connection by its name,partial URI, or full URI. See the following examples:my-connectionprojects/my-project/global/interconnects/my-connectionhttps://compute.googleapis.com/compute/v1/projects/my-project/global/interconnects/my-connection
TRAFFIC_MODE: the traffic mode configuration for the wiresthat use this Cross-Site Interconnect connection:- To configure port mode, enter
-1. To configure VLAN mode, choose one of the following:
- To auto-allocate VLAN tag values, enter
0. - To specify your own VLAN tag values, enter an integer from
2to4093. VLAN tags must be the same for both endpoints of a wire. Youcan't enter a VLAN tag value that is already in use on theCloud Interconnect connection.
- To auto-allocate VLAN tag values, enter
- To configure port mode, enter
3c. Add connection A2
gcloud compute interconnects wire-groups add-interconnectWIRE_GROUP_NAME \ --cross-site-network=CROSS_SITE_NETWORK_NAME \ --endpoint-label=ENDPOINT_A_LABEL \ --interconnect-label=INTERCONNECT_CONNECTION_A2_LABEL \ --interconnect=INTERCONNECT_CONNECTION_A2 \ --vlan-tags=TRAFFIC_MODE
Replace the following values:
WIRE_GROUP_NAME: the name of the wire group that youcreated previouslyCROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork to which you are adding a wire groupENDPOINT_A_LABEL: the existing label that you specifiedwhen you created the endpoint for site AINTERCONNECT_CONNECTION_A2_LABEL: a new labelfor the redundant Cross-Site Interconnect connection that youcreated for site AINTERCONNECT_CONNECTION_A2: the redundant connectionthat you created for site A. You can specify the connection by its name,partial URI, or full URI. See the following examples:my-connectionprojects/my-project/global/interconnects/my-connectionhttps://compute.googleapis.com/compute/v1/projects/my-project/global/interconnects/my-connection
TRAFFIC_MODE: the traffic mode configuration for the wiresthat use this Cross-Site Interconnect connection:- To configure port mode, enter
-1. To configure VLAN mode, choose one of the following:
- To auto-allocate VLAN tag values, enter
0. - To specify your own VLAN tag values, enter an integer from
2to4093. VLAN tags must be the same for both endpoints of a wire. Youcan't enter a VLAN tag value that is already in use on theCloud Interconnect connection.
- To auto-allocate VLAN tag values, enter
- To configure port mode, enter
4a. Add an endpoint for site B
To add an endpoint to the wire group that represents your second site, orsite B, use thegcloud compute interconnects wire-groups add-endpoint command.
gcloud compute interconnects wire-groups add-endpointWIRE_GROUP_NAME \ --cross-site-network=CROSS_SITE_NETWORK_NAME \ --endpoint-label=ENDPOINT_B_LABEL
Replace the following values:
WIRE_GROUP_NAME: the name of the wire group that youcreated previouslyCROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork to which you are adding a wire groupENDPOINT_B_LABEL: a label for the endpoint, suchaschicago
4b. Add connection B1
To add a Cross-Site Interconnect connection to the wire groupfor site B, orInterconnect connection B1, use thegcloud compute interconnects wire-groups add-interconnect command.
gcloud compute interconnects wire-groups add-interconnectWIRE_GROUP_NAME \ --cross-site-network=CROSS_SITE_NETWORK_NAME \ --endpoint-label=ENDPOINT_B_LABEL \ --interconnect-label=INTERCONNECT_CONNECTION_B1_LABEL \ --interconnect=INTERCONNECT_CONNECTION_B1 \ --vlan-tags=TRAFFIC_MODE
Replace the following values:
WIRE_GROUP_NAME: the name of the wire group that youcreated previouslyCROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork to which you are adding a wire groupENDPOINT_B_LABEL: the existing label that you specifiedwhen you created the endpoint for site BINTERCONNECT_CONNECTION_B1_LABEL: a new labelfor the Cross-Site Interconnect connection that youcreated for site BINTERCONNECT_CONNECTION_B1: the connectionthat you created for site B. You can specify the connection by its name,partial URI, or full URI. See the following examples:my-connectionprojects/my-project/global/interconnects/my-connectionhttps://compute.googleapis.com/compute/v1/projects/my-project/global/interconnects/my-connection
TRAFFIC_MODE: the traffic mode configuration for the wiresthat use this Cross-Site Interconnect connection:- To configure port mode, enter
-1. To configure VLAN mode, choose one of the following:
- To auto-allocate VLAN tag values, enter
0. - To specify your own VLAN tag values, enter an integer from
2to4093. VLAN tags must be the same for both endpoints of a wire. Youcan't enter a VLAN tag value that is already in use on theCloud Interconnect connection.
- To auto-allocate VLAN tag values, enter
- To configure port mode, enter
4c. Add connection B2
Note: Adding connections to site B can take several minutes to complete.gcloud compute interconnects wire-groups add-interconnectWIRE_GROUP_NAME \ --cross-site-network=CROSS_SITE_NETWORK_NAME \ --endpoint-label=ENDPOINT_B_LABEL \ --interconnect-label=INTERCONNECT_CONNECTION_B2_LABEL \ --interconnect=INTERCONNECT_CONNECTION_B2 \ --vlan-tags=TRAFFIC_MODE
Replace the following values:
WIRE_GROUP_NAME: the name of the wire group that youcreated previously.CROSS_SITE_NETWORK_NAME: the name of the cross-sitenetwork to add the wire group to.ENDPOINT_B_LABEL: the existing label that you specifiedwhen you created the endpoint for site A.INTERCONNECT_CONNECTION_B2_LABEL: a new labelfor the redundant Cross-Site Interconnect connection that youcreated for site B.INTERCONNECT_CONNECTION_B2: the redundant connectionthat you created for site B. You can specify the connection by its name,partial URI, or full URI. See the following examples:my-connectionprojects/my-project/global/interconnects/my-connectionhttps://compute.googleapis.com/compute/v1/projects/my-project/global/interconnects/my-connection
TRAFFIC_MODE: the traffic mode configuration for the wiresthat use this Cross-Site Interconnect connection:- To configure port mode, enter
-1. To configure VLAN mode, choose one of the following:
- To auto-allocate VLAN tag values, enter
0. - To specify your own VLAN tag values, enter an integer from
2to4093. VLAN tags must be the same for both endpoints of a wire. Youcan't enter a VLAN tag value that is already in use on theCloud Interconnect connection.
- To auto-allocate VLAN tag values, enter
- To configure port mode, enter
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 2026-02-19 UTC.