v27

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-22216424765.0 KB

gateway.openapi_Gateway

Create Node Pool

post/v1/accounts/{account_id}/nodePools

Path parameters

account_idstring required

The Account Id

Request body

nodePoolIdstring required

Response

A successful response.

namestring

displayNamestring

Human-readable display name of the node pool. e.g. "My Node Pool" Must be fewer than 64 characters long.

createTimestring date-time

The creation time of the node pool.

minNodeCountinteger

https://cloud.google.com/kubernetes-engine/quotas Minimum number of nodes in this node pool. Must be a non-negative integer less than or equal to max_node_count. If not specified, the default is 0.

maxNodeCountinteger

https://cloud.google.com/kubernetes-engine/quotas Maximum number of nodes in this node pool. Must be a positive integer greater than or equal to min_node_count. If not specified, the default is 1.

overprovisionNodeCountinteger

The number of nodes to overprovision by the autoscaler. Must be a non-negative integer and less than or equal to min_node_count and max_node_count-min_node_count. If not specified, the default is 0.

annotationsobject

Arbitrary, user-specified metadata. Keys and values must adhere to Kubernetes constraints: https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations/#syntax-and-character-set Additionally, the "fireworks.ai/" prefix is reserved.

state'STATE_UNSPECIFIED' | 'CREATING' | 'READY' | 'DELETING' | 'FAILED'

CREATING: The cluster is still being created.
READY: The node pool is ready to be used.
DELETING: The node pool is being deleted.
FAILED: Node pool is not operational. Consult 'status' for detailed messaging. Node pool needs to be deleted and re-created.

updateTimestring date-time

The update time for the node pool.