Manage interconnects

This page describes how to manage Google Distributed Cloud interconnect resources in a Distributed Cloud zone.

For more information about Distributed Cloud interconnects, see How Distributed Cloud works.

List interconnects

To list the Distributed Cloud interconnects in a Distributed Cloud zone, complete the steps in this section.

To complete this task, you must have the Edge Network Viewer role (roles/edgenetwork.viewer) in your Google Cloud project.

gcloud

Use the gcloud edge-cloud networking interconnects list command:

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

Replace the following:

  • REGION: the Google Cloud region to which the target Distributed Cloud zone belongs.
  • ZONE_NAME: the name of the target Distributed Cloud zone.

API

Make a GET request to the projects.locations.zones.interconnects.list method:

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: the ID of the target Google Cloud project.
  • REGION: the Google Cloud region to which the target Distributed Cloud zone belongs.
  • ZONE_NAME: the name of the target Distributed Cloud zone.
  • FILTER: an expression that constrains the returned results to specific values.
  • PAGE_SIZE: the number of results to return per page.
  • SORT_BY: 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: a token received in the response to the last list request in the nextPageToken field in the response. Send this token to receive a page of results.

Get information about an interconnect

To get information about a Distributed Cloud interconnect in a Distributed Cloud zone, complete the steps in this section.

To complete this task, you must have the Edge Network Viewer role (roles/edgenetwork.viewer) in your Google Cloud project.

gcloud

Use the gcloud edge-cloud networking interconnects describe command:

gcloud edge-cloud networking interconnects describe INTERCONNECT_NAME \
    --location=REGION \
    --zone=ZONE_NAME

Replace the following:

  • INTERCONNECT_NAME: the name of the target interconnect.
  • REGION: the Google Cloud region to which the target Distributed Cloud zone belongs.
  • ZONE_NAME: the name of the target Distributed Cloud zone.

API

Make a GET request to the projects.locations.zones.interconnects.get method:

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

Replace the following:

  • PROJECT_ID: the ID of the target Google Cloud project.
  • REGION: the Google Cloud region to which the target Distributed Cloud zone belongs.
  • ZONE_NAME: the name of the target Distributed Cloud zone.
  • INTERCONNECT_ID: the ID of the target interconnect.

Get the operational status of an interconnect

To get the operational status of a Distributed Cloud interconnect in a Distributed Cloud zone, complete the steps in this section.

To complete this task, you must have the Edge Network Viewer role (roles/edgenetwork.viewer) in your Google Cloud project.

gcloud

Use the gcloud edge-cloud networking interconnects get-diagnostics command:

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

Replace the following:

  • INTERCONNECT_NAME: the name of the target interconnect.
  • REGION: the Google Cloud region to which the target Distributed Cloud zone belongs.
  • ZONE_NAME: the name of the target Distributed Cloud zone.

API

Make a GET request to the projects.locations.zones.interconnects.diagnose method:

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

Replace the following:

  • PROJECT_ID: the ID of the target Google Cloud project.
  • REGION: the Google Cloud region to which the target Distributed Cloud zone belongs.
  • ZONE_NAME: the name of the target Distributed Cloud zone.
  • INTERCONNECT_ID: the ID of the target interconnect.

What's next