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

For more information about Distributed Cloud connected machines, see
[How Distributed Cloud connected works](https://docs.cloud.google.com/distributed-cloud/connected/latest/docs/how-it-works).

> [!NOTE]
> **Note:** The Google Cloud CLI instructions on this page assume that you are using [Cloud Shell](https://docs.cloud.google.com/shell/docs) or another environment with `bash` installed.

## List machines in a zone

To list the Distributed Cloud connected machines in a
Distributed Cloud connected zone, complete the steps in this section.

To complete this task, you must have the
[Edge Container Viewer role](https://docs.cloud.google.com/distributed-cloud/connected/latest/docs/permissions#edge-viewer)
(`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](https://console.cloud.google.com/distributed-cloud/edgezones/list)

   <br />

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 connected 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 connected 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 connected machine in a
Distributed Cloud connected zone, complete the steps in this section.

To complete this task, you must have the
[Edge Container Viewer role](https://docs.cloud.google.com/distributed-cloud/connected/latest/docs/permissions#edge-viewer)
(`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](https://console.cloud.google.com/distributed-cloud/edgezones/list)

   <br />

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 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 connected zone has been created.
- `MACHINE_NAME`: the name of the target machine resource.

## What's next

- [Deploy workloads on Distributed Cloud connected](https://docs.cloud.google.com/distributed-cloud/connected/latest/docs/deploy)
- [Manage zones](https://docs.cloud.google.com/distributed-cloud/connected/latest/docs/zones)
- [Manage clusters](https://docs.cloud.google.com/distributed-cloud/connected/latest/docs/clusters)
- [Manage node pools](https://docs.cloud.google.com/distributed-cloud/connected/latest/docs/nodepools)
- [Manage virtual machines](https://docs.cloud.google.com/distributed-cloud/connected/latest/docs/virtual-machines)
- [Manage GPU workloads](https://docs.cloud.google.com/distributed-cloud/connected/latest/docs/gpu)