This document provides instructions for creating Cloud Interconnect connection groups; creating and adding Cloud Interconnect connections to a connection group; removing connections from a connection group; and deleting connection groups. For more information about Cloud Interconnect connection groups, see Resiliency and SLA options in the Cloud Interconnect overview.
Create Cloud Interconnect connection groups
Console
In the Google Cloud console, go to the Cloud Interconnect Physical connections tab.
Click Create group.
Specify the details of the Dedicated Interconnect connection group:
- Name: A name for the connection group. This name is displayed
in the Google Cloud console and is used by the Google Cloud CLI to
reference the connection, such as
my-interconnect-group
. - Description: An optional description of the connection group.
- Name: A name for the connection group. This name is displayed
in the Google Cloud console and is used by the Google Cloud CLI to
reference the connection, such as
In the Production SLA field, select the SLA option that you need for your deployment.
Optional: In the Group members field, select Add interconnects.
Optional: In the box, select the Cloud Interconnect connections that you want to add to the connection group. Repeat this step for each Cloud Interconnect connection that you want to add to the connection group.
Click Save.
gcloud
When you create a new connection group, you specify an intended SLA by using
the --intended-topology-capability
flag with a value of PRODUCTION_CRITICAL
,
PRODICTION_NON_CRITICAL
, or NO_SLA
. In the following example
command, you create a connection group called
GROUP_NAME
with an intended SLA of
PRODUCTION_NON_CRITICAL
:
gcloud compute interconnects groups create GROUP_NAME \ --intended-topology-capability PRODUCTION_NON_CRITICAL
Note that this new group doesn't yet satisfy your intended SLA because it doesn't have any Cloud Interconnect connections.
Create Cloud Interconnect connections within a connection group
Console
In the Google Cloud console, go to the Cloud Interconnect Physical connections tab.
Click Set up physical connection.
In the Interconnect type field, select Dedicated interconnect connection.
Click Continue.
Select Order a new Dedicated Interconnect connection.
Click Continue.
In the Intended SLA field, select the SLA option that you need for your deployment.
Select Add this interconnect to an existing group.
In the Interconnect group box, select the Cloud Interconnect connection group to which you want to add the new connection.
Click Next.
Specify the details of the Dedicated Interconnect connection:
- Name: A name for the connection. This name is displayed
in the Google Cloud console and is used by the Google Cloud CLI to
reference the connection, such as
my-interconnect
. - Location: The physical location where the connection is created. When you create a connection group, you only choose the facility. The location is chosen automatically.
Capacity: The total capacity of your connection, which is determined by the number and size of the circuits that you order.
Select one of the following options:
- 1 x 10-Gbps circuit in 10-Gbps increments up to 8 x 10-Gbps (80 Gbps) circuits
- 1 x 100-Gbps (100 Gbps) circuit
- 2 x 100-Gbps (200 Gbps) circuits
- Name: A name for the connection. This name is displayed
in the Google Cloud console and is used by the Google Cloud CLI to
reference the connection, such as
Click Next.
If you require redundancy, specify details for your duplicate connection, and then click Next.
Specify your contact information:
- Company name: The name of your organization to put in the LOA as the party authorized to request a connection.
Technical contact: An email address where notifications about this connection are sent. You don't need to enter your own address; you are included in all notifications. You can specify only one address.
If you are creating a connection through Workforce Identity Federation, specifying a Technical contact is required. Workforce Identity Federation is in Preview.
Review your order. Check that your connection details and contact information are correct. If everything is correct, click Place order. If not, go back and edit the connection details.
On the order confirmation page, review the next steps, and then click Done.
gcloud
In the following example, you create Cloud Interconnect
connections called CONNECTION_1
and
CONNECTION_2
in the connection group called
GROUP_NAME
. You provide the --interconnect
flag, with a
unique interconnect name and an optional description, once for each new
Cloud Interconnect connection that you want to create in the group:
gcloud compute interconnects groups create-members GROUP_NAME \ --interconnect-type dedicated \ --link-type LINK_TYPE \ --facility FACILITY_NAME \ --customer-name NAME \ --noc-contact-email EMAIL_ADDRESS \ --interconnect "name=CONNECTION_1,description='The first interconnect connection'" \ --interconnect "name=CONNECTION_2,description='The second interconnect connection'"
Replace the following values:
GROUP_NAME
: the name of your connection groupLINK_TYPE
:- If you want your Dedicated Interconnect connection to be made up of 10-Gbps
circuits, replace
LINK_TYPE
withLINK_TYPE_ETHERNET_10G_LR
. - If you want your connection to be made up of 100-Gbps
circuits, replace
LINK_TYPE
withLINK_TYPE_ETHERNET_100G_LR
.
- If you want your Dedicated Interconnect connection to be made up of 10-Gbps
circuits, replace
FACILITY_NAME
: the name of the facility in which you want to create the Dedicated Interconnect connections, without-zone1
orzone2
. The Dedicated Interconnectconnection group automatically selects the best zones for each Interconnect to maximize your resiliency. You can find facility names in the colocation facility table.NAME
: the name of your organization to put in the LOA as the party authorized to request a connectionEMAIL_ADDRESS
: an optional email address for the NOC contact. You can specify only one email address—you don't need to enter your own address because you are included in all notifications. If you are creating a connection through Workforce Identity Federation, providing an email address with the‑‑noc-contact-email
flag is required. Workforce Identity Federation is in Preview.CONNECTION_1
: the name of the first Cloud Interconnect connection.CONNECTION_2
: the name of the second Cloud Interconnect connection.
Add existing Cloud Interconnect connections to a group
You can add Cloud Interconnect connections to a connection group by editing the group.
Console
In the Google Cloud console, go to the Cloud Interconnect Physical connections tab.
In the Interconnect groups field, select the connection group that you want to edit.
Click Edit.
In the Group members field, select Add interconnect, then select the Cloud Interconnect connection that you want to add to the connection group. Repeat this step for each Cloud Interconnect connection that you want to add to the group.
Click Save.
gcloud
In the following example command, you add existing connections
CONNECTION_1
and CONNECTION_2
to the
connection group called GROUP_NAME
:
gcloud compute interconnects groups add-members GROUP_NAME \ --interconnects=CONNECTION_1,CONNECTION_2
Remove Cloud Interconnect connections from a group
You can remove Cloud Interconnect connections from a connection group by editing the group.
Console
In the Google Cloud console, go to the Cloud Interconnect Physical connections tab.
In the Interconnect groups field, select the connection group that you want to edit.
Click Edit.
In the Group members field, click the box with the Cloud Interconnect connection that you want to remove from the connection group, and either replace the selected connection with another connection or click
Delete.Click Save.
gcloud
In the following example command, you remove connections
CONNECTION_1
and CONNECTION_2
from the
connection group called GROUP_NAME
:
gcloud compute interconnects groups remove-members GROUP_NAME \ --interconnects=CONNECTION_1,CONNECTION_2
Delete Cloud Interconnect connection groups
Use the instructions in this section to delete a Cloud Interconnect connection group. Note that when you delete a connection group, the Cloud Interconnect connections that are members of the group aren't deleted. To delete Cloud Interconnect connections, see Delete connections.
Console
In the Google Cloud console, go to the Cloud Interconnect Physical connections tab.
In the Interconnect groups field, find the row of the connection group that you want to delete and then click the checkbox next to the group.
Click Delete, then click Delete again in the confirmation box.
Click Save.
gcloud
In the following example command, you delete the connection group named
GROUP_NAME
.
gcloud compute interconnects groups delete GROUP_NAME