Creates a OpenStack cloud config's machine pool

POST 
https://api.spectrocloud.com/v1/cloudconfigs/openstack/:configUid/machinePools

Creates a OpenStack cloud config's machine pool

Request

Path Parameters

configUid stringrequired

Cluster's cloud config uid

Header Parameters

ProjectUid string

Scope the request to the specified project uid

application/json

Body

cloudConfig

object

required

azsstring[]

for control plane pool, this will be the failure domains for kcp

diskGiBint32

Root disk size

flavorConfig

required

diskGiBint32

DiskGiB is the size of a virtual machine's disk, in GiB.

memoryMiBint64

MemoryMiB is the size of a virtual machine's memory, in MiB.

namestringrequired

Openstack flavor name

numCPUsint32

NumCPUs is the number of virtual processors in a virtual machine.

subnet

object

idstring

namestring

poolConfig

object

Machine pool configuration for the cluster

additionalLabels

object

Additional labels to be part of the machine pool

property name*string

additionalTags

object

AdditionalTags is an optional set of tags to add to resources managed by the provider, in addition to the ones added by default. For eg., tags for EKS nodeGroup or EKS NodegroupIAMRole

property name*string

isControlPlaneboolean

Whether this pool is for control plane

labelsstring[]required

Labels for this machine pool, example: control-plane/worker, gpu, windows

machinePoolProperties

object

Machine pool specific properties

archTypestring

Possible values: [amd64, arm64]

Default value: amd64

Architecture type of the pool. Default value is 'amd64'

maxSizeint32

Max size of the pool, for scaling

minSizeint32

Min size of the pool, for scaling

namestringrequired

nodeRepaveIntervalint32

Minimum number of seconds a node should be Ready, before the next node is selected for repave. Applicable only for workerpools in infrastructure cluster

sizeint32required

Size of the pool, number of nodes/machines

taints

object[]

control plane or worker taints

Array [

effectstring

Possible values: [NoSchedule, PreferNoSchedule, NoExecute]

keystring

The taint key to be applied to a node

timeAddeddate-time

Time is a wrapper around time.Time which supports correct marshaling to YAML and JSON. Wrappers are provided for many of the factory methods that the time package offers.

valuestring

The taint value corresponding to the taint key.

]

updateStrategy

object

Rolling update strategy for this machine pool if not specified, will use ScaleOut

typestring

Possible values: [RollingUpdateScaleOut, RollingUpdateScaleIn]

update strategy, either ScaleOut or ScaleIn if empty, will default to RollingUpdateScaleOut

useControlPlaneAsWorkerboolean

If IsControlPlane==true && useControlPlaneAsWorker==true, then will remove control plane taint this will not be used for worker pools

Responses

201

Created successfully

Response Headers

• AuditUid

  string

  Audit uid for the request

application/json

Schema

Schema

uidstringrequired

Example (from schema)

{
  "uid": "string"
}

• curl
• python
• go
• nodejs
• java

• CURL

curl -L 'https://api.spectrocloud.com/v1/cloudconfigs/openstack/:configUid/machinePools' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'ApiKey: <API_KEY_VALUE>' \
-d '{
  "cloudConfig": {
    "azs": [
      "string"
    ],
    "diskGiB": 0,
    "flavorConfig": {
      "diskGiB": 0,
      "memoryMiB": 0,
      "name": "string",
      "numCPUs": 0
    },
    "subnet": {
      "id": "string",
      "name": "string"
    }
  },
  "poolConfig": {
    "additionalLabels": {},
    "additionalTags": {},
    "isControlPlane": true,
    "labels": [
      "string"
    ],
    "machinePoolProperties": {
      "archType": "amd64"
    },
    "maxSize": 0,
    "minSize": 0,
    "name": "string",
    "nodeRepaveInterval": 0,
    "size": 0,
    "taints": [
      {
        "effect": "NoSchedule",
        "key": "string",
        "timeAdded": "2024-07-29T15:51:28.071Z",
        "value": "string"
      }
    ],
    "updateStrategy": {
      "type": "RollingUpdateScaleOut"
    },
    "useControlPlaneAsWorker": true
  }
}'

Request Collapse all

Base URL

https://api.spectrocloud.com

Auth

Security Scheme

ApiKeyAuthorization

ApiKey

Parameters

configUid — pathrequired

ProjectUid — header

Body

{
  "cloudConfig": {
    "azs": [
      "string"
    ],
    "diskGiB": 0,
    "flavorConfig": {
      "diskGiB": 0,
      "memoryMiB": 0,
      "name": "string",
      "numCPUs": 0
    },
    "subnet": {
      "id": "string",
      "name": "string"
    }
  },
  "poolConfig": {
    "additionalLabels": {},
    "additionalTags": {},
    "isControlPlane": true,
    "labels": [
      "string"
    ],
    "machinePoolProperties": {
      "archType": "amd64"
    },
    "maxSize": 0,
    "minSize": 0,
    "name": "string",
    "nodeRepaveInterval": 0,
    "size": 0,
    "taints": [
      {
        "effect": "NoSchedule",
        "key": "string",
        "timeAdded": "2024-07-29T15:51:28.071Z",
        "value": "string"
      }
    ],
    "updateStrategy": {
      "type": "RollingUpdateScaleOut"
    },
    "useControlPlaneAsWorker": true
  }
}