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
In the Google Cloud console, go to the Edge Zones page.
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 thenextPageToken
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
In the Google Cloud console, go to the Edge Zones page.
Click the desired zone.
The Google Cloud console displays detailed information about the selected zone, including a list of machines present in that zone.
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
- Deploy workloads on Distributed Cloud Edge
- Manage zones
- Manage clusters
- Manage node pools
- Manage VPN connections
- Manage virtual machines
- Manage GPU workloads