Skip to content

Kubernetes API

Magnum v1 · K8s 1.25–1.27 · OpenStack Antelope (2023.1)

Base URL: https://container-infra.{region}.rumble.cloud/v1

Upstream reference: OpenStack Container Infra API ↗

All requests require a Keystone token in the X-Auth-Token header. See Authentication for token issuance.
Most Kubernetes workflows are better served by the CLI and console guides or Terraform templates. The Magnum API is primarily useful for custom automation.

Clusters

GET/v1/clusters
POST/v1/clusters
GET/v1/clusters/{cluster_id}
PATCH/v1/clusters/{cluster_id}
DELETE/v1/clusters/{cluster_id}
Examples

List clusters

curl -s -H "X-Auth-Token: $TOKEN" \
  https://container-infra.us-east-1.rumble.cloud/v1/clusters \
  | jq '.clusters[] | {uuid, name, status, node_count}'

Create a cluster: request body

curl -s -X POST -H "X-Auth-Token: $TOKEN" \
  -H "Content-Type: application/json" \
  https://container-infra.us-east-1.rumble.cloud/v1/clusters \
  -d '{
  "cluster_template_id": "{template_id}",
  "name": "my-cluster",
  "master_count": 1,
  "node_count": 3,
  "keypair": "my-keypair"
}'

Cluster Templates

GET/v1/clustertemplates
POST/v1/clustertemplates
GET/v1/clustertemplates/{template_id}
PATCH/v1/clustertemplates/{template_id}
DELETE/v1/clustertemplates/{template_id}
Examples

List cluster templates

curl -s -H "X-Auth-Token: $TOKEN" \
  https://container-infra.us-east-1.rumble.cloud/v1/clustertemplates \
  | jq '.clustertemplates[] | {uuid, name, coe}'

Guides

Create a Kubernetes cluster →Create a cluster template →Manage a cluster →
← Network APIAutomation API →