Stay organized with collections
Save and categorize content based on your preferences.
This page describes how to manage Google Distributed Cloud connected zone
resources in a Distributed Cloud connected deployment. Due to
the structuring of Google Cloud APIs, Distributed Cloud connected zone
resources are referred to as locations in the
Distributed Cloud Edge Container API.
Use the gcloud edge-cloud container zones list command:
gcloud edge-cloud container zones list \
--project=PROJECT_ID
Replace PROJECT_ID with the ID of the target
Google Cloud project.
API
Make a GET request to the projects.locations.list method:
GET /v1/PROJECT_ID/locations?filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN
Replace the following:
PROJECT_ID: the ID of the target Google Cloud project.
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.
Initialize the network configuration of a zone
To initialize the network configuration of a
Distributed Cloud connected zone, complete the steps
in this section.
To complete this task, you must have the
Edge Network Admin role
(roles/edgenetwork.admin) in your Google Cloud project.
You must initialize the network configuration of each of your
Distributed Cloud connected zones in the following cases:
Immediately after your Distributed Cloud connected hardware is
installed on your premises.
You upgraded to Distributed Cloud connected version 1.3.0 on an
existing Distributed Cloud connected deployment but did not
participate in the private preview of the
Distributed Cloud Edge Network API.
Initializing the network configuration of a zone creates a default router named
default. The default router is then configured to peer with all of the
interconnects that you requested when you ordered the
Distributed Cloud connected hardware by creating corresponding
interconnect attachments. This provides your
Distributed Cloud connected deployment with basic uplink connectivity
to your local network.
This is a run-once procedure. Subsequent runs do not alter your existing
Distributed Cloud networking settings.
gcloud
Use the gcloud edge-cloud networking zones init command:
gcloud edge-cloud networking zones init ZONE_NAME \
--project=PROJECT_ID \
--location=REGION
Replace the following:
ZONE_NAME: the name of the target
Distributed Cloud connected zone.
PROJECT_ID: the ID of the target Google Cloud project.
REGION: the Google Cloud region in which the target
Distributed Cloud connected zone is created.
API
Make a POST request to the projects.locations.zones.initialize method:
POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME:init
Replace the following:
PROJECT_ID: the ID of the target Google Cloud project.
REGION: the Google Cloud region in which the target
Distributed Cloud connected zone is created.
ZONE_NAME: the name of the target
Distributed Cloud connected zone.
Get information about a zone
To get information about a Distributed Cloud connected zone,
complete the steps in this section.
To complete this task, you must have the
Edge Container Viewer role
(roles/edgecontainer.viewer) in your Google Cloud project.
Console
In the Google Cloud console, go to the Edge Zones page.
[[["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-09-03 UTC."],[[["\u003cp\u003eThis page outlines how to manage Google Distributed Cloud connected zone resources, which are referred to as "locations" within the Distributed Cloud Edge Container API.\u003c/p\u003e\n"],["\u003cp\u003eYou can list available Distributed Cloud connected zones in your Google Cloud project through the Google Cloud console, \u003ccode\u003egcloud\u003c/code\u003e CLI, or by using the API.\u003c/p\u003e\n"],["\u003cp\u003eInitializing a zone's network configuration, a one-time procedure, creates a default router and configures interconnect attachments to establish basic uplink connectivity for the Distributed Cloud connected deployment.\u003c/p\u003e\n"],["\u003cp\u003eGetting detailed information about a specific Distributed Cloud connected zone can be done through the Google Cloud console, \u003ccode\u003egcloud\u003c/code\u003e CLI, or via API requests.\u003c/p\u003e\n"],["\u003cp\u003eTo perform these actions, you must have either the Edge Container Viewer role, or the Edge Network Admin role in your Google Cloud project, depending on the task.\u003c/p\u003e\n"]]],[],null,["# Manage zones\n\nThis page describes how to manage Google Distributed Cloud connected zone\nresources in a Distributed Cloud connected deployment. Due to\nthe structuring of Google Cloud APIs, Distributed Cloud connected zone\nresources are referred to as *locations* in the\nDistributed Cloud Edge Container API.\n\nFor more information about Distributed Cloud connected zones, see\n[How Distributed Cloud connected works](/distributed-cloud/edge/1.7.1/docs/how-it-works).\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 zones\n----------\n\nTo list the Distributed Cloud connected zone in your Google Cloud project,\ncomplete the steps in this section.\n\nTo complete this task, you must have the\n[Edge Container Viewer role](/distributed-cloud/edge/1.7.1/docs/permissions#edge-viewer)\n(`roles/edgecontainer.viewer`) in your Google Cloud project. \n\n### Console\n\n1. In the Google Cloud console, go to the **Edge Zones** page.\n\n [Go to Edge Zones](https://console.cloud.google.com/distributed-cloud/edgezones/list)\n2. Examine the list of zones and their details.\n\n### gcloud\n\nUse the `gcloud edge-cloud container zones list` command: \n\n```\ngcloud edge-cloud container zones list \\\n --project=PROJECT_ID\n \n```\n\nReplace \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e with the ID of the target\nGoogle Cloud project.\n\n### API\n\nMake a `GET` request to the `projects.locations.list` method: \n\n```\nGET /v1/PROJECT_ID/locations?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\"\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\nInitialize the network configuration of a zone\n----------------------------------------------\n\nTo initialize the network configuration of a\nDistributed Cloud connected zone, complete the steps\nin this section.\n\nBefore you can initialize the network configuration of a zone, you must first\n[enable the Distributed Cloud Edge Network API](/distributed-cloud/edge/1.7.1/docs/networking#network-api-enable).\n\nTo complete this task, you must have the\n[Edge Network Admin role](/distributed-cloud/edge/1.7.1/docs/permissions#edge-network-admin)\n(`roles/edgenetwork.admin`) in your Google Cloud project.\n\nYou must initialize the network configuration of each of your\nDistributed Cloud connected zones in the following cases:\n\n- Immediately after your Distributed Cloud connected hardware is installed on your premises.\n- You upgraded to Distributed Cloud connected version 1.3.0 on an existing Distributed Cloud connected deployment but did not participate in the private preview of the Distributed Cloud Edge Network API.\n\nInitializing the network configuration of a zone creates a default router named\n`default`. The `default` router is then configured to peer with all of the\ninterconnects that you requested when you ordered the\nDistributed Cloud connected hardware by creating corresponding\ninterconnect attachments. This provides your\nDistributed Cloud connected deployment with basic uplink connectivity\nto your local network.\n\nThis is a run-once procedure. Subsequent runs do not alter your existing\nDistributed Cloud networking settings. \n\n### gcloud\n\nUse the `gcloud edge-cloud networking zones init` command: \n\n```\ngcloud edge-cloud networking zones init ZONE_NAME \\\n --project=PROJECT_ID \\\n --location=REGION\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud connected zone.\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 in which the target Distributed Cloud connected zone is created.\n\n### API\n\nMake a `POST` request to the `projects.locations.zones.initialize` method: \n\n```\nPOST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME:init\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 in which the target Distributed Cloud connected zone is created.\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud connected zone.\n\nGet information about a zone\n----------------------------\n\nTo get information about a Distributed Cloud connected zone,\ncomplete the steps in this section.\n\nTo complete this task, you must have the\n[Edge Container Viewer role](/distributed-cloud/edge/1.7.1/docs/permissions#edge-viewer)\n(`roles/edgecontainer.viewer`) in your Google Cloud project. \n\n### Console\n\n1. In the Google Cloud console, go to the **Edge Zones** page.\n\n [Go to Edge Zones](https://console.cloud.google.com/distributed-cloud/edgezones/list)\n2. Click the desired zone.\n\n The Google Cloud console displays detailed information about the\n selected zone.\n\n### gcloud\n\nUse the `gcloud edge-cloud container zones describe` command: \n\n```\ngcloud edge-cloud container zones describe ZONE_NAME \\\n --project=PROJECT_ID\n```\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eZONE_NAME\u003c/var\u003e: the name of the target Distributed Cloud connected zone.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of the target Google Cloud project.\n\n### API\n\nMake a `GET` request to the `projects.locations.get` method: \n\n```\nGET /v1/PROJECT_ID/locations/REGION\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 in which the target Distributed Cloud connected zone is created.\n\nWhat's next\n-----------\n\n- [Deploy workloads on Google Distributed Cloud connected](/distributed-cloud/edge/1.7.1/docs/deploy)\n- [Manage machines](/distributed-cloud/edge/1.7.1/docs/machines)\n- [Create and manage clusters](/distributed-cloud/edge/1.7.1/docs/clusters)\n- [Create and manage networks](/distributed-cloud/edge/1.7.1/docs/networks)\n- [Create and manage node pools](/distributed-cloud/edge/1.7.1/docs/nodepools)"]]
