# REST Resource: projects.locations.machines

- [Resource: Machine](https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/container/rest/v1/projects.locations.machines#Machine)
  - [JSON representation](https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/container/rest/v1/projects.locations.machines#Machine.SCHEMA_REPRESENTATION)
- [Status](https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/container/rest/v1/projects.locations.machines#Status)
- [Purpose](https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/container/rest/v1/projects.locations.machines#Purpose)
- [Methods](https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/container/rest/v1/projects.locations.machines#METHODS_SUMMARY)

## Resource: Machine

A Google Distributed Cloud Edge machine capable of acting as a Kubernetes node.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "hostedNode": string, "zone": string, "version": string, "disabled": boolean, "status": enum (`https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/container/rest/v1/projects.locations.machines#Status`), "purpose": enum (`https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/container/rest/v1/projects.locations.machines#Purpose`) } ``` |

| Fields ||
|---|---|
| `name` | `string` Required. The resource name of the machine. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when the node pool was created. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when the node pool was last updated. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `labels` | `map (key: string, value: string)` Labels associated with this resource. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `hostedNode` | `string` Canonical resource name of the node that this machine is responsible for hosting e.g. projects/{project}/locations/{location}/clusters/{clusterId}/nodePools/{pool_id}/{node}, Or empty if the machine is not assigned to assume the role of a node. For control plane nodes hosted on edge machines, this will return the following format: "projects/{project}/locations/{location}/clusters/{clusterId}/controlPlaneNodes/{node}". |
| `zone` | `string` The Google Distributed Cloud Edge zone of this machine. |
| `version` | `string` Output only. The software version of the machine. |
| `disabled` | `boolean` Output only. Whether the machine is disabled. If disabled, the machine is unable to enter service. |
| `status` | ``enum (`https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/container/rest/v1/projects.locations.machines#Status`)`` Output only. The current status of the machine. |
| `purpose` | ``enum (`https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/container/rest/v1/projects.locations.machines#Purpose`)`` The type of cluster the machine is used for. |

## Status

Indicates the status of the machine.

| Enums ||
|---|---|
| `STATUS_UNSPECIFIED` | Status unknown. |
| `READY` | The machine is ready to host a node. This is the default. |
| `DISABLED_FOR_REPAIR` | The machine has been disabled for repair by adding 1 or more disable claims. |

## Purpose

Machine purpose can be either VIRTUALIZED_WORKLOAD or BAREMETAL_CLUSTER.

| Enums ||
|---|---|
| `PURPOSE_UNSPECIFIED` | Unspecified purpose. |
| `VIRTUALIZED_WORKLOAD` | Machine is used for virtual workload. |
| `BAREMETAL_CLUSTER` | Machine is used for a baremetal user cluster. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/container/rest/v1/projects.locations.machines/get` | Gets details of a single Machine. |
| ### `https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/container/rest/v1/projects.locations.machines/list` | Lists Machines in a given project and location. |