To list the Distributed Cloud Edge interconnects in a Distributed Cloud Edge 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 Edge zone belongs.
ZONE_NAME: the name of the target
Distributed Cloud Edge 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 Edge zone belongs.
ZONE_NAME: the name of the target
Distributed Cloud Edge 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 Edge interconnect
in a Distributed Cloud Edge 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:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-29 UTC."],[[["\u003cp\u003eThis page details the management of Google Distributed Cloud Edge interconnect resources, which are exclusively available on Distributed Cloud Edge Racks, not Servers.\u003c/p\u003e\n"],["\u003cp\u003eYou can list all interconnects within a Distributed Cloud Edge zone using the \u003ccode\u003egcloud\u003c/code\u003e CLI or the API, requiring the Edge Network Viewer role.\u003c/p\u003e\n"],["\u003cp\u003eYou can retrieve information about a specific interconnect using the \u003ccode\u003egcloud\u003c/code\u003e CLI or API by providing the interconnect's name or ID, respectively.\u003c/p\u003e\n"],["\u003cp\u003eYou are able to get the operational status of an interconnect in a Distributed Cloud Edge zone via the \u003ccode\u003egcloud\u003c/code\u003e command or an API call, each requiring the interconnect name or id.\u003c/p\u003e\n"],["\u003cp\u003eTo perform any of the operations outlined on this page, it requires you to have the Edge Network Viewer role in your Google Cloud project.\u003c/p\u003e\n"]]],[],null,["# Manage interconnects\n\nThis page describes how to manage Google Distributed Cloud Edge interconnect\nresources in a Distributed Cloud Edge zone.\n\nThis functionality is only available on Distributed Cloud Edge Racks.\nDistributed Cloud Edge Servers don't support interconnect resources.\n\nFor more information about Distributed Cloud Edge interconnects,\nsee [How Distributed Cloud Edge\nworks](/distributed-cloud/edge/1.6.0/docs/how-it-works#networking).\n| **Note:** The Google Cloud CLI instructions on this page assume that you are using [Cloud Shell](/shell/docs) or another environment with `bash` installed.\n\nList interconnects\n------------------\n\nTo list the Distributed Cloud Edge interconnects in a Distributed Cloud Edge zone,\ncomplete the steps in this section.\n\nTo complete this task, you must have the\n[Edge Network Viewer role](/distributed-cloud/edge/1.6.0/docs/permissions#edge-network-viewer)\n(`roles/edgenetwork.viewer`) in your Google Cloud project. \n\n### gcloud\n\nUse the `gcloud edge-cloud networking interconnects list` command: \n\n```\ngcloud edge-cloud networking interconnects list \\\n --location=REGION \\\n --zone=ZONE_NAME\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n\n### API\n\nMake a `GET` request to the `projects.locations.zones.interconnects.list`\nmethod: \n\n```\nGET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnects?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the target Google Cloud project.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n- \u003cvar translate=\"no\"\u003eFILTER\u003c/var\u003e: an expression that constrains the returned results to specific values.\n- \u003cvar translate=\"no\"\u003ePAGE_SIZE\u003c/var\u003e: the number of results to return per page.\n- \u003cvar translate=\"no\"\u003eSORT_BY\u003c/var\u003e: 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 `~`.\n- \u003cvar translate=\"no\"\u003ePAGE_TOKEN\u003c/var\u003e: 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.\n\nGet information about an interconnect\n-------------------------------------\n\nTo get information about a Distributed Cloud Edge interconnect\nin a Distributed Cloud Edge zone, complete the steps in this\nsection.\n\nTo complete this task, you must have the\n[Edge Network Viewer role](/distributed-cloud/edge/1.6.0/docs/permissions#edge-network-viewer)\n(`roles/edgenetwork.viewer`) in your Google Cloud project. \n\n### gcloud\n\nUse the `gcloud edge-cloud networking interconnects describe`\ncommand: \n\n```\ngcloud edge-cloud networking interconnects describe INTERCONNECT_NAME \\\n --location=REGION \\\n --zone=ZONE_NAME\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eINTERCONNECT_NAME\u003c/var\u003e: the name of the target interconnect.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n\n### API\n\nMake a `GET` request to the `projects.locations.zones.interconnects.get`\nmethod: \n\n```\nGET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnects/INTERCONNECT_ID\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the target Google Cloud project.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n- \u003cvar translate=\"no\"\u003eINTERCONNECT_ID\u003c/var\u003e: the ID of the target interconnect.\n\nGet the operational status of an interconnect\n---------------------------------------------\n\nTo get the operational status of a Distributed Cloud Edge\ninterconnect in a Distributed Cloud Edge zone, complete the steps\nin this section.\n\nTo complete this task, you must have the\n[Edge Network Viewer role](/distributed-cloud/edge/1.6.0/docs/permissions#edge-network-viewer)\n(`roles/edgenetwork.viewer`) in your Google Cloud project. \n\n### gcloud\n\nUse the `gcloud edge-cloud networking interconnects get-diagnostics`\ncommand: \n\n```\ngcloud edge-cloud networking interconnects get-diagnostics INTERCONNECT_NAME \\\n --location=REGION \\\n --zone=ZONE_NAME\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eINTERCONNECT_NAME\u003c/var\u003e: the name of the target interconnect.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n\n### API\n\nMake a `GET` request to the `projects.locations.zones.interconnects.diagnose`\nmethod: \n\n```\n GET /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME/interconnects/INTERCONNECT_ID:diagnose\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the target Google Cloud project.\n- \u003cvar translate=\"no\"\u003eREGION\u003c/var\u003e: the Google Cloud region to which the target Distributed Cloud Edge zone belongs.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud Edge zone.\n- \u003cvar translate=\"no\"\u003eINTERCONNECT_ID\u003c/var\u003e: the ID of the target interconnect.\n\nWhat's next\n-----------\n\n- [Deploy workloads on Distributed Cloud Edge](/distributed-cloud/edge/1.6.0/docs/deploy)\n- [Manage interconnect attachments](/distributed-cloud/edge/1.6.0/docs/attachments)\n- [Manage networks](/distributed-cloud/edge/1.6.0/docs/networks)\n- [Manage routers](/distributed-cloud/edge/1.6.0/docs/routers)\n- [Manage subnetworks](/distributed-cloud/edge/1.6.0/docs/subnetworks)\n- [Manage VPN connections](/distributed-cloud/edge/1.6.0/docs/vpn-connections)\n- [Manage zones](/distributed-cloud/edge/1.6.0/docs/zones)"]]
