Skip to content
Aether Docs

Update a node pool

PUT
/api/v1/organizations/{orgID}/clusters/{clusterID}/nodepools/{poolID}
curl --request PUT \
  --url https://api.aetherplatform.cloud/api/v1/organizations/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/clusters/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/nodepools/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "vcpus": 1, "memory_gb": 1, "disk_gb": 1, "min_nodes": 1, "max_nodes": 1, "desired_nodes": 1, "min_vcpus": 1, "max_vcpus": 1, "min_memory_gb": 1, "max_memory_gb": 1, "drain_timeout_seconds": 1, "scale_down_delay_seconds": 1, "scale_down_utilization_percent": 1 }'

Partial update. Any omitted field keeps its stored value. The merged result must satisfy min_nodes <= desired_nodes <= max_nodes.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
orgID
required
string format: uuid

Organization UUID.

clusterID
required
string format: uuid

Cluster UUID.

poolID
required
string format: uuid

Node pool UUID.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
name
string
vcpus
integer
>= 1 <= 128
memory_gb
integer
>= 1 <= 512
disk_gb
integer
>= 1 <= 2048
min_nodes
integer
max_nodes
integer
desired_nodes
integer
min_vcpus

Optional per-pool CPU autoscaling budget (total pool vCPUs); max > min ⇒ autoscaling. A non-zero minimum must cover at least one node; set BOTH min_vcpus and min_memory_gb to 0 (with the maxima set) to let the pool scale to zero nodes.

integer
max_vcpus

Optional per-pool CPU autoscaling budget (total pool vCPUs); max > min ⇒ autoscaling.

integer
>= 1
min_memory_gb

Optional per-pool memory autoscaling budget (total pool GB); max > min ⇒ autoscaling. A non-zero minimum must cover at least one node; set BOTH min_vcpus and min_memory_gb to 0 (with the maxima set) to let the pool scale to zero nodes.

integer
max_memory_gb

Optional per-pool memory autoscaling budget (total pool GB); max > min ⇒ autoscaling.

integer
>= 1
drain_timeout_seconds

How long to drain a node in this pool before deleting it anyway. Omitting the field leaves whatever the pool already has, and an explicit null is accepted but treated identically (no change) rather than as a reset — a configured timeout cannot be cleared back to the platform default through this endpoint. 0 is rejected — see CreateNodePoolRequest.

integer | null
>= 30 <= 3600
scale_down_delay_seconds

How long a node in this pool must stay underutilised before the autoscaler removes it. Omitting the field leaves whatever the pool already has, and an explicit null is accepted but treated identically (no change) rather than as a reset — a configured value cannot be cleared back to the platform default through this endpoint. See CreateNodePoolRequest for the meaning and the accepted range.

integer | null
>= 60 <= 3600
scale_down_utilization_percent

A node counts as underutilised when its CPU and memory requests are both below this share of allocatable capacity. Omitting the field (or sending null) leaves whatever the pool already has; there is no way to clear back to the platform default through this endpoint.

integer | null
>= 10 <= 90
Examplegenerated
{
  "name": "example",
  "vcpus": 1,
  "memory_gb": 1,
  "disk_gb": 1,
  "min_nodes": 1,
  "max_nodes": 1,
  "desired_nodes": 1,
  "min_vcpus": 1,
  "max_vcpus": 1,
  "min_memory_gb": 1,
  "max_memory_gb": 1,
  "drain_timeout_seconds": 1,
  "scale_down_delay_seconds": 1,
  "scale_down_utilization_percent": 1
}

Responses

Section titled “Responses”

200

Section titled “200”

The updated node pool.

Media typeapplication/json
object
id
required
string format: uuid
cluster_id
required
string format: uuid
name
required
string
vcpus
required
integer
memory_gb
required
integer
disk_gb
required
integer
min_nodes
required
integer
max_nodes
required
integer
desired_nodes
required
integer
min_vcpus

Optional per-pool CPU autoscaling budget (total pool vCPUs); max > min ⇒ autoscaling. A non-zero minimum must cover at least one node; set BOTH min_vcpus and min_memory_gb to 0 (with the maxima set) to let the pool scale to zero nodes.

integer
max_vcpus

Optional per-pool CPU autoscaling budget (total pool vCPUs); max > min ⇒ autoscaling.

integer
min_memory_gb

Optional per-pool memory autoscaling budget (total pool GB); max > min ⇒ autoscaling. A non-zero minimum must cover at least one node; set BOTH min_vcpus and min_memory_gb to 0 (with the maxima set) to let the pool scale to zero nodes.

integer
max_memory_gb

Optional per-pool memory autoscaling budget (total pool GB); max > min ⇒ autoscaling.

integer
node_labels

Labels applied to the pool’s nodes at bootstrap.

object
key
additional properties
string
node_taints

Taints applied to the pool’s nodes at bootstrap (set at create; immutable).

Array<object>
object
key
required
string
value
string
effect
required
string
Allowed values: NoSchedule PreferNoSchedule NoExecute
drain_timeout_seconds

How long the platform drains a node in this pool before deleting it anyway. Omitted when the pool has none configured, which means the platform default of 600s applies (and keeps applying if that default changes).

integer
>= 30 <= 3600
scale_down_delay_seconds

How long a node in this pool must stay underutilised before the autoscaler removes it. Omitted when the pool has none configured, which means the platform default of 600s applies (and keeps applying if that default changes). Acts on the scale-down DECISION; drain_timeout_seconds bounds the removal once it is decided. Only autoscaling pools have an autoscaler node group, so on a fixed pool the value is stored and reported but has no effect.

integer
>= 60 <= 3600
scale_down_utilization_percent

A node counts as underutilised when its CPU and memory requests are both below this share of allocatable capacity. Omitted when the pool has none configured, which means the platform default of 50 applies.

integer
>= 10 <= 90
current_nodes
required
integer
first_ready_at
string | null format: date-time
status
required
string
Allowed values: provisioning ready scaling deleting failed
status_message
string | null
created_at
required
string format: date-time
updated_at
required
string format: date-time
Example
{
  "node_taints": [
    {
      "effect": "NoSchedule"
    }
  ],
  "status": "provisioning"
}

401

Section titled “401”

Missing or invalid credentials.

Media typeapplication/json
object
error
required
object
code
required

A stable, machine-readable error code.

string
message
required
string
details
Array<object>
object
field
required
string
code
required
string
message
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}

404

Section titled “404”

The requested resource was not found.

Media typeapplication/json
object
error
required
object
code
required

A stable, machine-readable error code.

string
message
required
string
details
Array<object>
object
field
required
string
code
required
string
message
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}

422

Section titled “422”

Request validation failed.

Media typeapplication/json
object
error
required
object
code
required

A stable, machine-readable error code.

string
message
required
string
details
Array<object>
object
field
required
string
code
required
string
message
required
string
Examplegenerated
{
  "error": {
    "code": "example",
    "message": "example",
    "details": [
      {
        "field": "example",
        "code": "example",
        "message": "example"
      }
    ]
  }
}