REST Resource: projects.locations.machines

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 (Status),
  "purpose": enum (Purpose)
}
Fields
name

string

Required. The resource name of the machine.

createTime

string (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 (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 (Status)

Output only. The current status of the machine.

purpose

enum (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

get

Gets details of a single Machine.

list

Lists Machines in a given project and location.