Skip to navigation

Get a node pool

View as Markdown
Returns one node pool.

Authentication

AuthorizationBearer

A JWT from an issuer the Operator has configured, carried as Authorization: Bearer <token>.

Path parameters

nodePoolIDstringRequiredformat: "uuid"
Node pool ID.

Response

The requested node pool
idstringformat: "uuid"
Node pool ID.
clusterIDstringformat: "uuid"
Parent cluster.
namestring
Node pool name. Unique within the cluster. Immutable.
nodeNamePrefixstring>=1 character

Node names are <cluster>-<prefix>-<NNNN> (four-digit suffix), at most 63 characters in total.

kubernetesVersionstring
Desired Kubernetes version for the pool's nodes. Inherits the cluster's version on create.
nodeLabelsmap from strings to strings
Labels applied to the pool's nodes, as a map of keys to values. Set at creation.
nodeTaintslist of objects
Taints applied to the pool's nodes. Set at creation.
conditionsobject

Lifecycle conditions: provisioning, provisioned, deleting.

desiredNodeCountinteger>=0
Number of nodes.
autoProvisionDisabledboolean
Disables automatic provisioning for the pool.
currentNodeSetIDstring or nullformat: "uuid"
The active NodeSet.
autoModeDisabledboolean

Disables auto-mode (automatic node recycling).

provisioningMonitorDisabledbooleanDefaults to false
When true, nodes stuck in provisioning past the timeout are not recycled automatically.
recycleBudgetinteger>=0
Maximum number of nodes recycled at once.
systemReservedMemorystringOptionalDefaults to 16Gi
Memory reserved for system daemons. Nodes reserve 16Gi when omitted.
kubeReservedMemorystringOptional
Memory reserved for Kubernetes components. Empty when the 2Gi default applies.
machineAnnotationsmap from strings to stringsOptional

Annotations set on CAPI Machines only when they are created, including Machines created during scale-out or replacement. Fixed at node-pool creation. Not reconciled after provisioning. Keys under nke.nvidia.com, nke.io, nvke.nvidia.com, kubernetes.io, k8s.io, cluster.x-k8s.io and their subdomains require an explicit deployment allowlist entry for this metadata type.

machineLabelsmap from strings to stringsOptional

Labels set on CAPI Machines only when they are created, including Machines created during scale-out or replacement. Fixed at node-pool creation. Not reconciled after provisioning. Keys under nke.nvidia.com, nke.io, nvke.nvidia.com, kubernetes.io, k8s.io, cluster.x-k8s.io and their subdomains require an explicit deployment allowlist entry for this metadata type.

descriptionstringOptional

Free-text description.

maxSurgeintegerOptional>=0Defaults to 0

Nodes allowed above desiredNodeCount during a rollout. 0 means sequential: each node is torn down before its replacement is provisioned.

nicoobjectOptional
NICo settings for the pool.
launchLayerobjectOptional
LaunchLayer settings for the pool.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error