Skip to content
PAASBOX PAASBOX PAASBOX

Create or update a node pool

PUT
/api/v1/teams/{team_slug}/clusters/{cluster}/node-pools/{pool}/
 
curl --request PUT \
  --url https://example.com/api/v1/teams/example/clusters/example/node-pools/example/ \
  --header 'Content-Type: application/json' \
  --cookie sessionid=<sessionid> \
  --data '{ "spec": { "name": "example", "source": "managed", "machineType": "example", "image": { "additionalProperty": "example" }, "minimum": 0, "maximum": 3, "publicIP": true } }'

/api/v1/teams/{team}/clusters/{cluster}/node-pools (docs/58 §3.5) — node pools as a first-class resource. A change re-renders the cluster’s Shoot and reconciles it.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
cluster
required
string
pool
required
string
team_slug
required
string

Request Body required

Section titled “Request Body required ”
object
spec
required
object
name
required
string
<= 50 characters /^[a-z0-9]([-a-z0-9]{0,61}[a-z0-9])?$/
source
string
Allowed values: managed pooled dedicated onprem
machineType
required
string
<= 20 characters
image
object
key
additional properties
minimum
integer
0
maximum
integer
default: 3
publicIP
boolean
default: true

Responses

Section titled “ Responses ”

200

Section titled “200 ”
Media type application/json
object
name
required
string
source
required
string
machineType
required
string
image
required
object
key
additional properties
minimum
required
integer
maximum
required
integer
publicIP
required
boolean
autoscalerPriority
required
integer
status
required
object
pet
required
boolean
backingReady
required
integer
nullable
Example generated
{
  "name": "example",
  "source": "example",
  "machineType": "example",
  "image": {
    "additionalProperty": "example"
  },
  "minimum": 1,
  "maximum": 1,
  "publicIP": true,
  "autoscalerPriority": 1,
  "status": {
    "pet": true,
    "backingReady": 1
  }
}

409

Section titled “409 ”

RFC 7807 problem document

Media type application/json

RFC 7807 application/problem+json — every non-2xx response (docs/58 §5.10).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
required
string
code
required

Stable machine code clients switch on

string
instance
required
string
nullable
operationId
required
string
nullable
Example generated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "instance": "example",
  "operationId": "example"
}

422

Section titled “422 ”

RFC 7807 problem document

Media type application/json

RFC 7807 application/problem+json — every non-2xx response (docs/58 §5.10).

object
type
required
string format: uri
title
required
string
status
required
integer
detail
required
string
code
required

Stable machine code clients switch on

string
instance
required
string
nullable
operationId
required
string
nullable
Example generated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "code": "example",
  "instance": "example",
  "operationId": "example"
}