Reference

Create Cluster input fields

Field	Type	Required	Notes
name	string	Yes	1-128 chars, alphanumeric + hyphens. Used as CloudFormation stack name for AWS. Must be unique within the org.
cluster_type	enum	Yes	Must be slurm.
cloud_account_id	int	No	Omit for on-premises or LXD clusters.
description	string	No	Human-readable description.
secret	string	No	24-32 chars. Keycloak client secret. Auto-generated if omitted.
partitions	[PartitionInput]	AWS only	At least one partition required for AWS Slurm clusters.
node_type	string	AWS only	EC2 instance type (e.g., p3.2xlarge).
instance_key_pair_name	string	AWS only	EC2 key pair name for SSH access.
subnet_id	string	AWS only	VPC subnet for cluster nodes.
region_name	string	AWS only	AWS region (e.g., us-east-1).
vpc_id	string	AWS only	Optional; inferred from subnet if omitted.
min_node_count	int	AWS only	Autoscaler minimum.
max_node_count	int	AWS only	Autoscaler maximum.

Partition input fields

Field	Type	Required	Notes
name	string	Yes	Partition name (maps to Slurm PartitionName).
node_type	string	Yes	EC2 instance type for worker nodes.
min_node_count	int	No	Autoscaler minimum. Default: 0.
max_node_count	int	Yes	Autoscaler ceiling.
is_default	bool	No	Whether this is the default partition. Default: false.

Limits

Limit	Value	Notes
Cluster name length	1-128 chars	Max 27 chars recommended for AWS (CloudFormation stack name limit).
Cluster name characters	Alphanumeric + hyphens	Must start and end with alphanumeric.
Partitions per cluster	20	Contact support to increase.
Max nodes per partition	100	Contact support to increase.
Cluster limit per tier	Varies by subscription tier	Check your subscription settings.
Secret length	24-32 chars	Only required if you need a specific Keycloak client secret.

Error codes

Condition	Error type	Phase
Name already in use	ClusterNameInUse	Validation
Cluster limit reached	SubscriptionLimitReached	Validation
Invalid cluster type/provider combo	ValidationError	Validation
Keycloak client creation fails	UnexpectedBehavior	Synchronous (cluster not created)
CloudFormation stack creation fails	ClusterCouldNotBeDeployed	Background (cluster stays in preparing)
Node registration timeout	ClusterCouldNotBeDeployed	Background (cluster transitions to failed)

Database operations

Table	Operation	When
cluster	INSERT	Always
slurm_cluster	INSERT	Always
cluster_partitions	INSERT (N rows)	AWS Slurm, one per partition
cloud_account	SELECT	Fetch provider + credentials

External service calls

Service	Call	When
Keycloak	Create OAuth2 client	All paths
AWS CloudFormation	create_stack	AWS Slurm
AWS IAM	Role ARN validation	AWS paths