Post

/computeclusters/

This endpoint creates a VAST compute cluster.

Security

HTTP

Type basic

Basic authentication using VMS user name and password

API Key: ApiToken

Header parameter nameApiToken

Send current valid API token in an Authorization header with format Api-Token .

Body parameters

Expand All

object

name

string

Compute Cluster name

cnodes

Array of object (ComputeClusterCNodeInput)

List of CNode assignments with resource presets

object

id

integer Required

ID of a CNode allocated to a compute cluster

resource_preset

string Required

The level of resources allocated from the CNode to the compute cluster. There are four preset resource allocation levels. LOW is approx 25% resources. There is no upper limit to the number of CNodes that can be allocated to the cluster with this option. BALANCED allocates approximately 50% resources from allocated CNodes, in a balanced configuration of CPU and RAM. This option requires you to leave at least one CNode not allocated to any compute cluster per every eight and part of eight DBoxes in the VAST cluster. MEM_HEAVY is similar to BALANCED, allocating more RAM and less CPU. This option requires you to leave at least two CNodes not allocated to any compute cluster per every eight and part of eight DBoxes in the VAST Cluster. HIGH_COMPUTE allocates 100% CNode resources from allocated CNodes. It requires you to leave at least two CNodes not allocated to any compute cluster per every eight and part of eight DBoxes in the VAST Cluster.

Valid values[ "LOW", "BALANCED", "MEM_HEAVY", "HIGH_COMPUTE" ]

static_ip_ranges

Array of array

List of IP range pairs [[start1, end1], [start2, end2]] for static IP assignment to CNodes. Must provide enough IPs for all CNodes.

Array of string

Min items2

Max items2

Example[ "10.0.0.10", "10.0.0.20" ]

string

backup_frequency

integer

Backup frequency in minutes

description

string

User-defined description for the compute cluster

tags

Array of string

User-defined tags for the compute cluster

Max items64

string

Max length40

all_tenants

boolean

When true, all existing and newly created tenants are automatically assigned to this compute cluster

netmask

string Required

Network mask for the compute cluster network (e.g., "255.255.255.0" or "24")

default_gateway

string

Default gateway IP address for the compute cluster network (e.g., "10.0.0.1"). Optional.

vlan

integer

VLAN ID for the compute cluster network (1-4095). Optional; omit or set to null to disable.

Minimum1

Maximum4095

cluster_cidr

string

Kubernetes cluster CIDR for pod networking (default is "10.64.0.0/12")

Default"10.64.0.0/12"

service_cidr

string

Kubernetes service CIDR for service networking (default is "10.80.0.0/12")

Default"10.80.0.0/12"

root_certificate

string

RKE2 root certificate. If omitted, certificates will be generated automatically. Must be provided together with intermediate_certificate and intermediate_key.

intermediate_certificate

string

RKE2 intermediate certificate. If omitted, certificates will be generated automatically. Must be provided together with root_certificate and intermediate_key.

intermediate_key

string

RKE2 intermediate private key. If omitted, certificates will be generated automatically. Must be provided together with root_certificate and intermediate_certificate.

Responses

201

Expand All

object

id

integer

The unique identifier for the VAST compute cluster on the specific VAST cluster to which the compute cluster belongs.

guid

string

The globally unique identifier for the VAST compute cluster across all VAST clusters.

name

string

The name of the VAST compute cluster

root_certificate

string

RKE2 root certificate. If omitted, certificates will be generated automatically. Must be provided together with intermediate_certificate and intermediate_key.

intermediate_certificate

string

RKE2 intermediate certificate. If omitted, certificates will be generated automatically. Must be provided together with root_certificate and intermediate_key.

intermediate_key

string

RKE2 intermediate private key. If omitted, certificates will be generated automatically. Must be provided together with root_certificate and intermediate_certificate.

static_ip_ranges

Array of array

List of IP range pairs [[start1, end1], [start2, end2]] for static IP assignment to CNodes. Must provide enough IPs for all CNodes.

Array of string

Min items2

Max items2

Example[ "10.0.0.10", "10.0.0.20" ]

string

netmask

string

Network mask for the compute cluster network (e.g., "255.255.255.0" or "24")

default_gateway

string

Default gateway IP address for the compute cluster network (e.g., "10.0.0.1"). Optional.

vlan

integer

VLAN ID for the compute cluster network (1-4095). Optional; omit or set to null to disable.

Minimum1

Maximum4095

cluster_cidr

string

Kubernetes cluster CIDR for pod networking (default is "10.64.0.0/12")

Default"10.64.0.0/12"

service_cidr

string

Kubernetes service CIDR for service networking (default is "10.80.0.0/12")

Default"10.80.0.0/12"

server_kube_vip_address

string

Kubernetes VIP address for the API server

state

string

Current state of the compute cluster

Valid values[ "CREATING", "UPDATING", "DELETING", "STARTING", "STOPPED", "RUNNING", "STOPPING", "ERROR", "DEGRADED", "PARTIALLY_PROVISIONED" ]

resource_counts

object

Resource counts with state-based breakdowns for this cluster

cnodes

object (ComputeClusterCNodeCountsPerState)

Example{ "total": 50, "ready": 45, "disk_pressure": 2, "memory_pressure": 1, "pid_pressure": 0, "network_unavailable": 2 }

property*

integer additionalProperties

Valid values[ total, ready, disk_pressure, memory_pressure, pid_pressure, network_unavailable ]

pods

object (ComputeClusterPodCountsPerState)

Example{ "total": 200, "running": 180, "pending": 10, "succeeded": 5, "failed": 3, "unknown": 2 }

property*

integer additionalProperties

Valid values[ total, failed, running, pending, succeeded, unknown ]

deployments

object (ComputeClusterDeploymentCountsPerState)

Example{ "total": 50, "running": 45, "degraded": 3, "error": 2 }

property*

integer additionalProperties

Valid values[ total, running, degraded, error ]

service_counts

integer

Total number of services on the compute cluster

namespace_counts

integer

Total number of namespaces on the compute cluster

tenant_counts

integer

Total number of tenants attached to the compute cluster

backup_frequency

integer

Backup frequency in minutes for the compute cluster. This is an automated schedule that dictates how often the compute cluster's state and persistent data is backed up.

Default60

description

string

User-defined description for the compute cluster

tags

Array of string

User-defined tags for the compute cluster

Max items64

string

Max length40

all_tenants

boolean

When true, all existing and newly created tenants are automatically assigned to this compute cluster

Defaultfalse

cnodes

Array of object

List of CNodes assigned to this compute cluster with their static IPs and stats

object

id

integer

CNode ID

ip

string

Static IP address assigned to this CNode

stats

object (ComputeClusterCNodeStats)

Statistics for a CNode in a compute cluster

pods

integer

Number of pods running on this CNode

cpu

object

CPU usage statistics for this CNode, in cores

total

number (float)

CPU limit allocated to this CNode, in cores

used

number (float)

CPU cores currently consumed by this CNode.

memory

object

Memory usage statistics for this CNode, in bytes

total

number (float)

Total memory available on the CNode, in bytes

used

number (float)

Memory currently used on the CNode, in bytes.

type

string

CNode role type in the compute cluster

Valid values[ "WORKER", "MASTER", "UNASSIGNED" ]

message

string

Unhealthy condition messages from the node

state

string

Current state of the CNode in the compute cluster

Valid values[ "INITIALIZING", "DELETING", "UPDATING", "INACTIVE", "RUNNING", "ERROR", "ACTIVATING", "UNKNOWN" ]

resource_preset

string

Resource allocation preset for this CNode

Valid values[ "LOW", "BALANCED", "MEM_HEAVY", "HIGH_COMPUTE" ]

async_task

object

Creation Async task properties

400

The request contains invalid data.

Create a VAST Compute Cluster