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 thenextPageTokenfield 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.
