Manage Zones

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

Due to the structuring of Google Cloud APIs, Distributed Cloud Edge Zones are referred to as "Locations" in the Distributed Cloud Edge 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.

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