ByCloud Docs
GuidesCLIAPISDK
post/v1/kubernetes/clusters

Create Kubernetes cluster

Create a new Kubernetes cluster

Request Body

required

Content-Type: application/json

name

stringrequired

cluster_template_id

string<uuid>required

keypair

stringoptional

SSH keypair name

docker_volume_size

integeroptional

Docker volume size in GB

labels

objectoptional

master_flavor_id

string<uuid>optional

flavor_id

string<uuid>optional

master_count

integeroptional

Default: 1

node_count

integeroptional

Default: 1

create_timeout

integeroptional

fixed_network

string<uuid>optional

fixed_subnet

string<uuid>optional

floating_ip_enabled

booleanoptional

Default: true

master_lb_enabled

booleanoptional

Default: true

Responses

202

Cluster creation initiated

Content-Type: application/json

cluster

objectoptional
400

Invalid request parameters

Content-Type: application/json

error

objectrequired
401

Authentication required or token invalid

Content-Type: application/json

error

objectrequired
403

Insufficient permissions

Content-Type: application/json

error

objectrequired
404

Cluster template not found

Content-Type: application/json

error

objectrequired
500

Internal server error

Content-Type: application/json

error

objectrequired
curl -X POST "https://api.spo1.mycloud.com/v1/kubernetes/clusters" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "production-cluster",
"cluster_template_id": "550e8400-e29b-41d4-a716-446655440000",
"keypair": "string",
"docker_volume_size": 1,
"labels": {},
"master_flavor_id": "550e8400-e29b-41d4-a716-446655440000",
"flavor_id": "550e8400-e29b-41d4-a716-446655440000",
"master_count": 1,
"node_count": 1,
"create_timeout": 1,
"fixed_network": "550e8400-e29b-41d4-a716-446655440000",
"fixed_subnet": "550e8400-e29b-41d4-a716-446655440000",
"floating_ip_enabled": true,
"master_lb_enabled": true
}'