Manage Interconnects

Stay organized with collections Save and categorize content based on your preferences.

This page describes how to manage Interconnect resources in a Google Distributed Cloud Edge Zone.

For more information on Google Distributed Cloud Edge Interconnects, see How Distributed Cloud Edge works.

List Interconnects

To list the Interconnects in a Distributed Cloud Edge Zone, complete the steps in this section.

To complete this task, you must have the GDCE Network Viewer role in your Google Cloud project. For more information, see Permissions and roles.

gcloud

 gcloud edge-cloud networking interconnects list --location=REGION --zone=ZONE_NAME
 

Replace the following:

  • REGION is the Google Cloud region to which the target Distributed Cloud Edge Zone belongs.
  • ZONE_NAME is the name of the target Distributed Cloud Edge Zone.

API

List Interconnects in the target Google Cloud project by making a GET request to the projects.locations.zones.interconnects.list method as follows:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnects?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Replace the following:

  • PROJECT_ID is the ID of the target Google Cloud project.
  • REGION is the Google Cloud region to which the target Distributed Cloud Edge Zone belongs.
  • ZONE_NAME is the name of the target Distributed Cloud Edge Zone.
  • FILTER is an expression that constrains the returned results to specific values.
  • PAGE_SIZE is the number of results to return per page.
  • SORT_BY is a comma-delimited list of field names by which the returned results are sorted. The default sort order is ascending; for descending sort order, prefix the desired field with ~.
  • PAGE_TOKEN is a token received in the response to the last list request in the nextPageToken field in the response. Send this token to receive the following page of results.

Get information about an Interconnect

To information about an Interconnect in a Distributed Cloud Edge Zone, complete the steps in this section.

To complete this task, you must have the GDCE Network Viewer role in your Google Cloud project. For more information, see Permissions and roles.

gcloud

 gcloud edge-cloud networking interconnects get-diagnostics INTERCONNECT_NAME --location=REGION --zone=ZONE_NAME
 

Replace the following:

  • INTERCONNECT_NAME is the name of the target Interconnect.
  • REGION is the Google Cloud region to which the target Distributed Cloud Edge Zone belongs.
  • ZONE_NAME is the name of the target Distributed Cloud Edge Zone.

API

Get diagnostic information about an Interconnect in the target Google Cloud project by making a GET request to the projects.locations.zones.interconnects.get method as follows:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnects/INTERCONNECT_ID

Replace the following:

  • PROJECT_ID is the ID of the target Google Cloud project.
  • REGION is the Google Cloud region to which the target Distributed Cloud Edge Zone belongs.
  • ZONE_NAME is the name of the target Distributed Cloud Edge Zone.
  • INTERCONNECT_ID is the ID of the target Interconnect.

Get the operational status of an Interconnect

To get the operational status of an Interconnect in a Distributed Cloud Edge Zone, complete the steps in this section.

To complete this task, you must have the GDCE Network Viewer role in your Google Cloud project. For more information, see Permissions and roles.

gcloud

 gcloud edge-cloud networking interconnects get-diagnostics INTERCONNECT_NAME --location=REGION --zone=ZONE_NAME
 

Replace the following:

  • INTERCONNECT_NAME is the name of the target Interconnect.
  • REGION is the Google Cloud region to which the target Distributed Cloud Edge Zone belongs.
  • ZONE_NAME is the name of the target Distributed Cloud Edge Zone.

API

Get the operational status of an Interconnect in the target Google Cloud project by making a GET request to the projects.locations.zones.interconnects.diagnose method as follows:

 GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnects/INTERCONNECT_ID:diagnose

Replace the following:

  • PROJECT_ID is the ID of the target Google Cloud project.
  • REGION is the Google Cloud region to which the target Distributed Cloud Edge Zone belongs.
  • ZONE_NAME is the name of the target Distributed Cloud Edge Zone.
  • INTERCONNECT_ID is the ID of the target Interconnect.

What's next