ClusterNodeGroupsCreateResponse

statusboolean

Whether the request succeeded.

Example: false

messagestring

Human-readable description of the result.

Example: Cluster 1617 is reconciling

node_group object

Worker-node group.

idinteger

Unique numeric identifier for the node group.

Example: 4501

namestring

Name of the node group.

Example: default

rolestring

Role of the node group.

Example: worker

flavor object

Flavor (hardware configuration) of the nodes in the node group.

idinteger

Unique numeric identifier for the flavor.

Example: 4501

namestring

Name of the flavor.

Example: n1-cpu-small

cpuinteger

Number of CPU cores.

Example: 4

ramnumber

Memory allocated to the flavor, in GB.

Example: 4

diskinteger

Root disk capacity, in GB.

Example: 100

ephemeralinteger

Ephemeral disk capacity, in GB. Cleared when the VM is deleted.

Example: 0

gpustring

GPU model name. Empty string if the flavor has no GPU.

Example:

gpu_countinteger

Number of GPUs attached to the flavor.

Example: 0

features object

Feature flags for the flavor, such as high-speed networking and hibernation or snapshot restrictions.

object

labels object[]

Labels associated with the flavor.

Array [

idinteger

Unique numeric identifier for the label.

labelstring

The label name.

]

countinteger

Number of nodes in the node group.

Example: 1

min_countinteger

Minimum number of nodes the group will scale down to.

Example: 1

max_countinteger

Maximum number of nodes the group will scale up to.

Example: 1

firewall_idsinteger[]

Identifiers of the firewalls attached to the nodes in the node group.

firewalls object[]

Firewalls attached to the nodes in the node group.

Array [

idinteger

Unique numeric identifier for the firewall.

namestring

Name of the firewall.

statusstring

Current status of the firewall.

]

created_atstring<date-time>

ISO 8601 UTC timestamp marking when the node group was created.

Example: 2026-05-07T09:21:55Z

updated_atstring<date-time>

ISO 8601 UTC timestamp marking when the node group was last updated.

Example: 2026-05-07T09:21:55Z

nodes object[]

Nodes currently in the cluster.

Array [

idinteger

Unique numeric identifier for the node.

Example: 3287

rolestring

Role of the node within the cluster.

Example: bastion

node_group_idintegernullable

Identifier of the node group the node belongs to.

node_group_namestringnullable

Name of the node group the node belongs to.

instance object

VM instance backing the node.

idinteger

Unique numeric identifier for the VM instance.

Example: 7613

namestring

Name of the VM instance.

Example: example-c1-bastion-0

statusstring

Current status of the VM instance.

Status	Description
CREATING	The VM is being created and initialized.
WAITING	Waiting for public IP assignment to establish connectivity to the VMs through the bastion node.
RECONCILING	Kubernetes components are being installed and configured on the VM.
PRE-ACTIVE	The VM is running, but Kubernetes reconciliation for the cluster is pending. Billing does not begin until the cluster is fully reconciled and the VM enters the ACTIVE state.
ACTIVE	The VM is fully configured and ready to run workloads.

Example: CREATING

fixed_ipstringnullable

Fixed (private) IP address assigned to the VM in its environment.

Example: 192.0.2.42

floating_ipstringnullable

Floating (public) IP address attached to the VM, or null if none.

Example: 192.0.2.91

floating_ip_statusstringnullable

Status of the floating IP address.

Example: ATTACHING

contract_idintegernullable

Identifier of the contract the VM instance is billed under, or null if none.

image_idinteger

Identifier of the operating system image installed on the VM instance.

Example: 7613

statusstring

Provisioning status of the node.

Status	Description
CREATING	The node is being created and initialized.
WAITING	Waiting for public IP assignment to establish connectivity to the VMs through the bastion node.
RECONCILING	Kubernetes components are being installed and configured on the node.
ACTIVE	The node is fully configured and ready to run workloads.

Example: CREATING

status_reasonstring

Human-readable message explaining the node's current status.

Example: VM is creating

is_bastionboolean

Whether the node acts as a bastion host.

Example: true

requires_public_ipboolean

Whether the node is configured to use a public IP.

Example: true

created_atstring<date-time>

ISO 8601 UTC timestamp marking when the node was created.

Example: 2026-05-06T16:04:09Z

updated_atstring<date-time>

ISO 8601 UTC timestamp marking when the node was last updated.

Example: 2026-05-06T16:04:09Z

]

ClusterNodeGroupsCreateResponse

{
  "status": false,
  "message": "Cluster 1617 is reconciling",
  "node_group": {
    "id": 4501,
    "name": "default",
    "role": "worker",
    "flavor": {
      "id": 4501,
      "name": "n1-cpu-small",
      "cpu": 4,
      "ram": 4,
      "disk": 100,
      "ephemeral": 0,
      "gpu": "",
      "gpu_count": 0,
      "features": {},
      "labels": [
        {
          "id": 0,
          "label": "string"
        }
      ]
    },
    "count": 1,
    "min_count": 1,
    "max_count": 1,
    "firewall_ids": [
      0
    ],
    "firewalls": [
      {
        "id": 0,
        "name": "string",
        "status": "string"
      }
    ],
    "created_at": "2026-05-07T09:21:55Z",
    "updated_at": "2026-05-07T09:21:55Z"
  },
  "nodes": [
    {
      "id": 3287,
      "role": "bastion",
      "node_group_id": 0,
      "node_group_name": "string",
      "instance": {
        "id": 7613,
        "name": "example-c1-bastion-0",
        "status": "CREATING",
        "fixed_ip": "192.0.2.42",
        "floating_ip": "192.0.2.91",
        "floating_ip_status": "ATTACHING",
        "contract_id": 0,
        "image_id": 7613
      },
      "status": "CREATING",
      "status_reason": "VM is creating",
      "is_bastion": true,
      "requires_public_ip": true,
      "created_at": "2026-05-06T16:04:09Z",
      "updated_at": "2026-05-06T16:04:09Z"
    }
  ]
}