Manage Zones

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

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

Due to the structuring of Google Cloud APIs, Distributed Cloud Edge Zones are referred to as "Locations" in the Distributed Cloud Edge Container API.

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

List Zones

To list the Distributed Cloud Edge Zones in your Google Cloud project, complete the steps in this section.

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

console

  1. Log into the Google Cloud console and select your Distributed Cloud Edge project.

  2. Go to the Edge Zones page.

    Go to Edge Zones

    1. In the Edge Zones page that appears, examine the list of Zones and their details.

gcloud 

gcloud edge-cloud container zones list --project=PROJECT_ID

Replace PROJECT_ID with the ID of the target Google Cloud project.

API

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

GET /v1/PROJECT_ID/locations?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.
  • 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.

Initialize the network configuration of a Zone

To initialize the network configuration of a Distributed Cloud Edge Zone, complete the steps in this section.

Before you can initialize the network configuration of a Zone, you must first enable the Distributed Cloud Edge Network API.

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

You must initialize the network configuration of each of your Distributed Cloud Edge Zones in the following cases:

  • Immediately after your Distributed Cloud Edge hardware has been installed on your premises.
  • You have upgraded to Distributed Cloud Edge version 1.3.0 on an existing Distributed Cloud Edge 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, a default Network named default, and configures the default Router to peer with all of the Interconnects you requested when you ordered the Distributed Cloud Edge hardware by creating corresponding InterconnectAttachments. This provides your Distributed Cloud Edge deployment with basic uplink connectivity to your local network.

This is a run-once procedure. Subsequent runs do not alter your existing Distributed Cloud Edge networking settings.

gcloud 

gcloud edge-cloud networking zones init ZONE_NAME \
    --project=PROJECT_ID

Replace the following:

  • ZONE_NAME is the name of the target Distributed Cloud Edge Zone.
  • PROJECT_ID is the ID of the target Google Cloud project.

API

Initialize the network configuration of a Distributed Cloud Edge Zone by making a POST request to the projects.locations.zones.initialize method as follows:

POST /v1/projects/PROJECT_ID/locations/REGION/zones/ZONE_NAME:init

Replace the following:

  • PROJECT_ID is the ID of the target Google Cloud project.
  • REGION is the Google Cloud region in which the target Distributed Cloud Edge Zone has been created.
  • ZONE_NAME is the name of the target Distributed Cloud Edge Zone.

Get information about a Zone

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

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

console

  1. Log into the Google Cloud console and select your Distributed Cloud Edge project.

  2. Go to the Edge Zones page.

    Go to Edge Zones

    1. In the Edge Zones page that appears, click the desired Zone.

    The Google Cloud console displays detailed information about the selected Zone.

gcloud 

gcloud edge-cloud container zones describe ZONE_NAME \
    --project=PROJECT_ID

Replace the following:

  • ZONE_NAME is the name of the target Distributed Cloud Edge Zone.
  • PROJECT_ID is the ID of the target Google Cloud project.

API

Get information about the target Distributed Cloud Edge Zone by making a GET request to the projects.locations.get method as follows:

GET /v1/PROJECT_ID/locations/REGION

Replace the following:

  • PROJECT_ID is the ID of the target Google Cloud project.
  • REGION is the Google Cloud region in which the target Distributed Cloud Edge Zone has been created.

What's next