Manage Machines

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

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

List Machines in a Zone

To list the Machines in 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, including a list of Machines present in that Zone.

gcloud

gcloud edge-cloud container machines list \
    --project=PROJECT_ID \
    --location=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.

API

List Machines in the target Distributed Cloud Edge Zone by making a GET request to the projects.locations.machines.list method as follows:

GET /v1/PROJECT_ID/locations/REGION?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.
  • REGION is the Google Cloud region in which the target Distributed Cloud Edge Zone .
  • 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 Machine

To get information about a Machine in 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, including a list of Machines present in that Zone.

    1. In the list of Machines, click the desired Machine.

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

gcloud

gcloud edge-cloud container machines describe MACHINE_ID \
    --location=REGION \
    --project=PROJECT_ID

Replace the following:

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

API

Get information about a Machine by making a GET request to the projects.locations.machines.get method as follows:

GET /v1/PROJECT_ID/locations/REGION/machines/MACHINE_NAME

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.
  • MACHINE_NAME is the name of the target Machine resource.

What's next