Apache CloudStack 4.17.0.0 Root Admin API Reference
createKubernetesCluster
Creates a Kubernetes cluster
Request parameters
| Parameter Name | Description | Required |
| description | description for the Kubernetes cluster | true |
| kubernetesversionid | Kubernetes version with which cluster to be launched | true |
| name | name for the Kubernetes cluster | true |
| serviceofferingid | the ID of the service offering for the virtual machines in the cluster. | true |
| size | number of Kubernetes cluster worker nodes | true |
| zoneid | availability zone in which Kubernetes cluster to be launched | true |
| account | an optional account for the virtual machine. Must be used with domainId. | false |
| controlnodes | number of Kubernetes cluster control nodes, default is 1 | false |
| dockerregistrypassword | password for the docker image private registry | false |
| dockerregistryurl | URL for the docker image private registry | false |
| dockerregistryusername | user name for the docker image private registry | false |
| domainid | an optional domainId for the virtual machine. If the account parameter is used, domainId must also be used. | false |
| externalloadbalanceripaddress | external load balancer IP address while using shared network with Kubernetes HA cluster | false |
| keypair | name of the ssh key pair used to login to the virtual machines | false |
| masternodes | number of Kubernetes cluster master nodes, default is 1. This option is deprecated, please use 'controlnodes' parameter. | false |
| networkid | Network in which Kubernetes cluster is to be launched | false |
| noderootdisksize | root disk size in GB for each node | false |
| projectid | Deploy cluster for the project | false |
Response Tags
| Response Name | Description |
| id | the id of the Kubernetes cluster |
| account | the account associated with the Kubernetes cluster |
| associatednetworkname | the name of the network of the Kubernetes cluster |
| autoscalingenabled | Whether autoscaling is enabled for the cluster |
| consoleendpoint | URL end point for the Kubernetes cluster dashboard UI |
| controlnodes | the control nodes count for the Kubernetes cluster |
| cpunumber | the cpu cores of the Kubernetes cluster |
| description | the description of the Kubernetes cluster |
| domain | the name of the domain in which the Kubernetes cluster exists |
| domainid | the ID of the domain in which the Kubernetes cluster exists |
| endpoint | URL end point for the Kubernetes cluster |
| ipaddress | Public IP Address of the cluster |
| ipaddressid | Public IP Address ID of the cluster |
| keypair | keypair details |
| kubernetesversionid | the ID of the Kubernetes version for the Kubernetes cluster |
| kubernetesversionname | the name of the Kubernetes version for the Kubernetes cluster |
| masternodes | the master nodes count for the Kubernetes cluster. This parameter is deprecated, please use 'controlnodes' parameter. |
| maxsize | Maximum size of the cluster |
| memory | the memory the Kubernetes cluster |
| minsize | Minimum size of the cluster |
| name | the name of the Kubernetes cluster |
| networkid | the ID of the network of the Kubernetes cluster |
| project | the project name of the Kubernetes cluster |
| projectid | the project id of the Kubernetes cluster |
| serviceofferingid | the ID of the service offering of the Kubernetes cluster |
| serviceofferingname | the name of the service offering of the Kubernetes cluster |
| size | the size (worker nodes count) of the Kubernetes cluster |
| state | the state of the Kubernetes cluster |
| templateid | the ID of the template of the Kubernetes cluster |
| virtualmachines | the list of virtualmachine associated with this Kubernetes cluster |
| zoneid | the name of the zone of the Kubernetes cluster |
| zonename | the name of the zone of the Kubernetes cluster |