REST Resource: projects.locations.bareMetalClusters.bareMetalNodePools

Resource: BareMetalNodePool

Resource that represents a bare metal node pool.

JSON representation
{
  "name": string,
  "displayName": string,
  "uid": string,
  "state": enum (State),
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "nodePoolConfig": {
    object (BareMetalNodePoolConfig)
  },
  "status": {
    object (ResourceStatus)
  },
  "upgradePolicy": {
    object (BareMetalNodePoolUpgradePolicy)
  }
}
Fields
name

string

Immutable. The bare metal node pool resource name.

displayName

string

The display name for the bare metal node pool.

uid

string

Output only. The unique identifier of the bare metal node pool.

state

enum (State)

Output only. The current state of the bare metal node pool.

reconciling

boolean

Output only. If set, there are currently changes in flight to the bare metal node pool.

createTime

string (Timestamp format)

Output only. The time at which this bare metal node pool was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The time at which this bare metal node pool was last updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

deleteTime

string (Timestamp format)

Output only. The time at which this bare metal node pool was deleted. If the resource is not deleted, this must be empty

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

etag

string

This checksum is computed by the server based on the value of other fields, and may be sent on update and delete requests to ensure the client has an up-to-date value before proceeding. Allows clients to perform consistent read-modify-writes through optimistic concurrency control.

annotations

map (key: string, value: string)

Annotations on the bare metal node pool. This field has the same restrictions as Kubernetes annotations. The total size of all keys and values combined is limited to 256k. Key can have 2 segments: prefix (optional) and name (required), separated by a slash (/). Prefix must be a DNS subdomain. Name must be 63 characters or less, begin and end with alphanumerics, with dashes (-), underscores (_), dots (.), and alphanumerics between.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

nodePoolConfig

object (BareMetalNodePoolConfig)

Required. Node pool configuration.

status

object (ResourceStatus)

Output only. ResourceStatus representing the detailed node pool status.

upgradePolicy

object (BareMetalNodePoolUpgradePolicy)

The worker node pool upgrade policy.

State

The lifecycle state of the bare metal node pool.

Enums
STATE_UNSPECIFIED Not set.
PROVISIONING The PROVISIONING state indicates the bare metal node pool is being created.
RUNNING The RUNNING state indicates the bare metal node pool has been created and is fully usable.
RECONCILING The RECONCILING state indicates that the bare metal node pool is being updated. It remains available, but potentially with degraded performance.
STOPPING The STOPPING state indicates the bare metal node pool is being deleted.
ERROR The ERROR state indicates the bare metal node pool is in a broken unrecoverable state.
DEGRADED The DEGRADED state indicates the bare metal node pool requires user action to restore full functionality.

BareMetalNodePoolUpgradePolicy

BareMetalNodePoolUpgradePolicy defines the node pool upgrade policy.

JSON representation
{
  "parallelUpgradeConfig": {
    object (BareMetalParallelUpgradeConfig)
  }
}
Fields
parallelUpgradeConfig

object (BareMetalParallelUpgradeConfig)

The parallel upgrade settings for worker node pools.

BareMetalParallelUpgradeConfig

BareMetalParallelUpgradeConfig defines the parallel upgrade settings for worker node pools.

JSON representation
{
  "concurrentNodes": integer,
  "minimumAvailableNodes": integer
}
Fields
concurrentNodes

integer

The maximum number of nodes that can be upgraded at once.

minimumAvailableNodes

integer

The minimum number of nodes that should be healthy and available during an upgrade. If set to the default value of 0, it is possible that none of the nodes will be available during an upgrade.

Methods

create

Creates a new bare metal node pool in a given project, location and Bare Metal cluster.

delete

Deletes a single bare metal node pool.

enroll

Enrolls an existing bare metal node pool to the Anthos On-Prem API within a given project and location.

get

Gets details of a single bare metal node pool.

list

Lists bare metal node pools in a given project, location and bare metal cluster.

patch

Updates the parameters of a single bare metal node pool.