Run:AI

NodePools

Node pools assist in managing heterogeneous resources effectively. A node pool is a set of nodes grouped into a bucket of resources using a predefined (for example, GPU-Type) or administrator-defined label (for example, key & value). For more information, see Node Pools.

Get the node pool metrics data. [Experimental]

Retrieve the node pool metrics data by Universally Unique Identifier (UUID).

SecuritybearerAuth
Request
path Parameters
clusterUuid
required
string <uuid> non-empty

The Universally Unique Identifier (UUID) of the cluster.

Example: 9f55255e-11ed-47c7-acef-fc4054768dbc
nodepoolName
required
string

The unique nodepool name.

Example: default
query Parameters
start
required
string <date-time>

Start date of time range to fetch data in ISO 8601 timestamp format.

Example: start=2023-06-06T12:09:18.211Z
end
required
string <date-time>

End date of time range to fetch data in ISO 8601 timestamp format.

Example: end=2023-06-07T12:09:18.211Z
numberOfSamples
integer [ 0 .. 1000 ]
Default: 20

The number of samples to take in the specified time range.

Example: numberOfSamples=20
metricType
required
Array of strings (MetricsType)

specifies what data to request

Items Enum: "GPU_UTILIZATION" "GPU_MEMORY_UTILIZATION" "CPU_UTILIZATION" "CPU_MEMORY_UTILIZATION" "TOTAL_GPU" "GPU_QUOTA" "ALLOCATED_GPU" "AVG_WORKLOAD_WAIT_TIME"
Responses
200

Executed successfully.

207

Partial success.

400

Bad request.

401

Unauthorized

403

Forbidden

404

The specified resource was not found

500

unexpected error

503

unexpected error

get/api/v1/clusters/{clusterUuid}/nodepools/{nodepoolName}/metrics
Response samples
{
  • "measurements": [
    ]
}

Get the cluster's Node Pools.

Retrieve all the node pools with details from the cluster by Universally Unique Identifier (UUID).

SecuritybearerAuth
Request
path Parameters
clusterId
required
string <uuid>

Unique identifier of the cluster

Responses
200

Node pools returned successfully.

403

Unauthorized

404

The specified resource was not found

default

unexpected error

get/v1/k8s/clusters/{clusterId}/node-pools
Response samples
application/json
[
  • {
    }
]

Create a Node Pool.

Use to create a node pool in a cluster by Universally Unique Identifier (UUID).

SecuritybearerAuth
Request
path Parameters
clusterId
required
string <uuid>

Unique identifier of the cluster

Request Body schema: application/json
name
string

Node Pool Name

overProvisioningRatio
integer
Default: 1
labelKey
string

Label key for associated nodes to the Node Pool (with value as in labelValue)

labelValue
string

Label value for associated nodes to the Node Pool (with key as in labelKey)

object (PlacementStrategy)
Responses
201

Created

400

Bad request.

409

conflict error

default

unexpected error

post/v1/k8s/clusters/{clusterId}/node-pools
Request samples
application/json
{
  • "name": "node-pool-a",
  • "overProvisioningRatio": 1,
  • "labelKey": "node-type",
  • "labelValue": "type-x",
  • "placementStrategy": {
    }
}
Response samples
application/json
{
  • "code": 400,
  • "message": "Bad request - Resource should have a name"
}

Update labels of a Node Pool.

Use to update the labels of a node pool.

SecuritybearerAuth
Request
path Parameters
clusterId
required
string <uuid>

Unique identifier of the cluster

id
required
integer

The unique id identifying the Node Pool.

Request Body schema: application/json
required
labelKey
string

key of node label for pool

labelValue
string

value of node label for pool

Responses
202

Node Pool update accepted.

400

Bad request.

403

Unauthorized

404

The specified resource was not found

503

unexpected error

put/v1/k8s/clusters/{clusterId}/node-pools/{id}/labels
Request samples
application/json
{
  • "labelKey": "node-type",
  • "labelValue": "type-x"
}
Response samples
application/json
{
  • "code": 400,
  • "message": "Bad request - Resource should have a name"
}

Delete a Node Pool by id.§

Use to delete a node pool by Universally Unique Identifier (UUID).

SecuritybearerAuth
Request
path Parameters
clusterId
required
string <uuid>

Unique identifier of the cluster

id
required
integer

The unique id identifying the Node Pool.

Responses
202

Node Pool deletion accepted

400

Bad request.

403

Unauthorized

404

The specified resource was not found

503

unexpected error

delete/v1/k8s/clusters/{clusterId}/node-pools/{id}
Response samples
application/json
{
  • "code": 400,
  • "message": "Bad request - Resource should have a name"
}

Update a Node Pool.

Use to update the details of a node pool by Universally Unique Identifier (UUID).

SecuritybearerAuth
Request
path Parameters
clusterId
required
string <uuid>

Unique identifier of the cluster

id
required
integer

The unique id identifying the Node Pool.

Request Body schema: application/json
required
labelKey
string

key of node label for pool

labelValue
string

value of node label for pool

overProvisioningRatio
integer
Default: 1
object (PlacementStrategy)
Responses
202

Node Pool update accepted.

400

Bad request.

403

Unauthorized

404

The specified resource was not found

503

unexpected error

put/v1/k8s/clusters/{clusterId}/node-pools/{id}
Request samples
application/json
{
  • "labelKey": "node-type",
  • "labelValue": "type-x",
  • "overProvisioningRatio": 1,
  • "placementStrategy": {
    }
}
Response samples
application/json
{
  • "code": 400,
  • "message": "Bad request - Resource should have a name"
}
➔ Next to Nodes