Manage machines

This page describes how to manage Google Distributed Cloud Edge machine resources in a Distributed Cloud Edge zone.

For more information about Distributed Cloud Edge machines, see How Distributed Cloud Edge works.

List machines in a zone

To list the Distributed Cloud Edge machines in a Distributed Cloud Edge 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

  1. In the Google Cloud console, go to the Edge Zones page.

    Go to Edge Zones

  2. 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

Use the gcloud edge-cloud container machines list command:

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

Replace the following:

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

API

Make a GET request to the projects.locations.machines.list method:

GET /v1/PROJECT_ID/locations/REGION?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 in which the target Distributed Cloud Edge zone has been created.
  • 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 a machine

To get information about a Distributed Cloud Edge machine in a Distributed Cloud Edge 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

  1. In the Google Cloud console, go to the Edge Zones page.

    Go to Edge Zones

  2. Click the desired zone.

    The Google Cloud console displays detailed information about the selected zone, including a list of machines present in that zone.

  3. In the list of machines, click the desired machine.

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

gcloud

Use the gcloud edge-cloud container machines describe command:

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

Replace the following:

  • MACHINE_ID: the ID of the target machine resource.
  • REGION: the Google Cloud region in which the target Distributed Cloud Edge zone has been created.
  • PROJECT_ID: the ID of the target Google Cloud project.

API

Make a GET request to the projects.locations.machines.get method:

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

Replace the following:

  • PROJECT_ID: the ID of the target Google Cloud project.
  • REGION: the Google Cloud region in which the target Distributed Cloud Edge zone has been created.
  • MACHINE_NAME: the name of the target machine resource.

What's next