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
Log into the Google Cloud console and select your Distributed Cloud Edge project.
Go to the Edge Zones page.
- 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 thenextPageToken
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
Log into the Google Cloud console and select your Distributed Cloud Edge project.
Go to the Edge Zones page.
- 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.
- 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
- Deploy workloads on Google Distributed Cloud Edge
- Manage Zones
- Manage Clusters
- Manage NodePools
- Manage VPN Connections
- Manage Kubernetes virtual machines