Manage connections

This page describes the steps to view, update, and delete Partner Cross-Cloud Interconnect for Amazon Web Services (AWS) connections. To view, update, or delete a connection, use the transport resource.

View connections

To view connections, follow these steps.

gcloud

Use the gcloud network-connectivity transports list command.

gcloud beta network-connectivity transports list \
    --region=LOCATION

Your output is similar to the following:

gcloud network-connectivity transport list --region us-east4

| Name              | Profile              | Bandwidth | State  |
|===================|======================|===========|========|
| my-cci-aws        | aws-us-east-1        | 1 Gb/s    | Active |
| my-cci-aws-123456 | aws-us-east-1        | 1 Gb/s    | Active |

Replace the following values:

  • TRANSPORT_NAME: the name of the transport for which you want to view details
  • LOCATION: the location where the connection resides

To get details of a single transport, use the gcloud beta network-connectivity transports describe command.

gcloud beta network-connectivity transports describe TRANSPORT_NAME \
    --region=LOCATION

Replace the following values:

  • TRANSPORT_NAME: the name of the transport for which you want to view details
  • LOCATION: the location where the connection resides

API

To list all the transports in a specific project and location, use the networkconnectivity.transports.list method with an empty request body.

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://networkconnectivity.googleapis.com/v1beta/projects/PROJECT/locations/LOCATION/transports"

Replace the following values:

  • PROJECT: the name of the project
  • LOCATION: the location where the connection resides

To get details of a single transport, use the networkconnectivity.transports.get method.

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://networkconnectivity.googleapis.com/v1beta/projects/PROJECT/locations/LOCATION/transports/TRANSPORT_NAME"

Replace the following values:

  • PROJECT: the name of the project
  • LOCATION: the location where the connection resides
  • TRANSPORT_NAME: the name of the transport for which you want to view details

Update connections

You can update the following two parameters of the transport resource:

  • description
  • advertisedRoutes

Changing the advertised routes changes the routes reachable from AWS. You must provide the updated fields in a mask on the query parameter.

API

Use the networkconnectivity.transports.patch method.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://networkconnectivity.googleapis.com/v1beta/projects/PROJECT/locations/LOCATION/transports/TRANSPORT_NAME" --data '{
"advertisedRoutes": ["IP_RANGE"]
}'

Replace the following values:

  • PROJECT: the name of the project
  • LOCATION: the location where the connection resides
  • TRANSPORT_NAME: the name of the transport that you want to update
  • IP_RANGE: the IP range of the advertised routes, such as 10.128.0.0/9

The response looks similar to the following: 

{
  {
      "advertisedRoutes": [
       "10.128.0.0/9"
      ],
      "description": NEW_DESCRIPTION,
      "updateTime": TIME
  }
}

Delete connections

Deleting a transport doesn't delete your resource on the AWS side, so make sure to clean up both sides of the connection.

gcloud

Use the gcloud beta network-connectivity transports delete command.

gcloud beta network-connectivity transports delete TRANSPORT_NAME
    --region=LOCATION

Replace the following values:

  • TRANSPORT_NAME: the name of the transport that you want to delete
  • LOCATION: the location where the transport resides

API

To delete a single transport, use the networkconnectivity.transports.delete method with an empty request body.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
https://networkconnectivity.googleapis.com/v1beta/projects/PROJECT/locations/LOCATION/transports/TRANSPORT_NAME

Replace the following values:

  • PROJECT: the name of the project
  • LOCATION: the location where the connection resides
  • TRANSPORT_NAME: the name of the transport that you want to delete

What's next