Adding a connection

Adding a connection in the UI

To add a connection to a transit gateway, follow these steps:

1. Open the IBM Cloud console and log in to your account.

2. Select the Navigation Menu icon from the upper left, then click Interconnectivity > Transit Gateway.

3. Click the name of the transit gateway where you want to add a connection.

   If you are in the expanded view, click View full details.

4. In the Connections view, click Add connection.

5. Choose and configure the specific network connections that you want to add to your transit gateway. Choices include:

   • VPC - Allows you to connect to your account's VPC resources, or VPC resources from other accounts as well.

   • Classic infrastructure - Allows you to connect to IBM Cloud classic resources.

   • Redundant GRE allows unbound GRE tunnels to connect to endpoints in either VPC or classic infrastructure networks, thus allowing you to build in redundancy for GRE tunnels. For more information, see Creating a redundant GRE tunnel.

   • Direct Link - Creates a network connection to and from Direct Link gateways so that there is a secure connection to on-premises networks and other resources that are connected to the transit gateway.

     If you select Direct Link, you must also log in to the Direct Link console (that uses the same IBM Cloud account) and specify Transit Gateway as the type of network connection for your direct link.

   • Power Virtual Server - Creates a network connection to and from a Power Virtual Server instance so that there is a secure connection to networks and other resources connected to the transit gateway.

     Location: Select a region for the Power Virtual Server workspace.

     If you select Power Virtual Server, you must have a Power Virtual Server workspace created in a PER-enabled data center.For a list of PER-enabled data centers, see Getting started with the Power Edge Router.

     To find out if your Power Virtual Server workspace is set up correctly, go to the workspace and check the navigation for a Cloud connections page. If there isn't a Cloud connections page, the workspace leverages the Power Edge Router and can be added as a connection to Transit Gateway. Otherwise, you must configure virtual connections with Cloud connections on the Power Virtual Server.

   • Unbound GRE tunnel - Allows a transit gateway to connect to overlay networks hosted on classic infrastructure resources. For prerequisites and detailed instructions, see Creating an unbound GRE tunnel.

6. Click Add to create a connection.

Adding a connection from the CLI

export IBMCLOUD_TG_API_ENDPOINT=private.transit.cloud.ibm.com

ibmcloud tg connection-create|cc GATEWAY_ID --name NAME --network-type [vpc | directlink | classic] --network-id NETWORK_ID --network-account-id NETWORK-ACCOUNT-ID [--output json] [-h, --help]

ibmcloud tg cc $gateway --name vpc-connection --network-id $vpcCRN --network-type vpc

ibmcloud tg cc $gateway --name classic-conn --network-type classic

Adding a connection with the API

To add a connection with the API, follow these steps:

1. Set up your API environment.

2. Store any additional variables to be used in the API commands.

3. Add a connection to the transit gateway. For example:

   curl -X POST --location --header "Authorization: Bearer {iam_token}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \
     --data '{ "network_type": "vpc" }'
     "
   {base_url}/transit_gateways/{transit_gateway_id}/connections?version={version}"
   

For more information, see Adds a connection to a Transit Gateway in the Transit Gateway API reference.

Adding a connection by using Terraform

Review the following argument references that you can specify for your resource when you create a connection for a transit gateway using Terraform:

resource "ibm_tg_connection" "test_ibm_tg_connection" {
  gateway      = ibm_tg_gateway.test_tg_gateway.id
  network_type = "vpc"
  name         = "myconnection"
  network_id   = ibm_is_vpc.test_tg_vpc.resource_crn
}