Create a managed Kubernetes cluster

Request information

Request line

POST /clusters HTTP/1.1 

Custom request headers

No custom request headers are used. For more information, see Public request headers.

Request body

{
"disable_rollback":"Specifies whether to retain all resources if the operation fails.",
"name":"The name of the cluster.",
"timeout_mins":"The timeout interval for creating a cluster.",
"cluster_type":"The type of the cluster. Set this parameter to ManagedKubernetes.",
"region_id":"The ID of the region.",
"vpcid": "VPC ID",
"worker_vswitch_ids":"The IDs of VSwitches. Specify one to three VSwitch IDs.",
"container_cidr":"The CIDR block of pods.",
"service_cidr":"The service CIDR block.", R",
"cloud_monitor_flags":"Specifies whether to install the CloudMonitor agent.",
"login_password":"The SSH logon password. Set login_password or key_pair.",
"key_pair":"The name of the key pair. You must set key_pair or login_password.",
"worker_instance_charge_type":"The billing method of worker nodes. Valid values: PrePaid and PostPaid.",
"worker_period_unit":"The unit of the subscription duration of worker nodes. Valid values: Month and Year. This parameter takes effect only if worker_instance_charge_type is set to PrePaid.",
"worker_period":"The subscription duration of worker nodes. This parameter takes effect only if worker_instance_charge_type is set to PrePaid.",
"worker_auto_renew":"Specifies whether to enable auto renewal for worker nodes. Valid values: true and false.",
"worker_auto_renew_period":"The auto renewal period for worker nodes.",
"worker_instance_types":"The ECS instance types of worker nodes.", ",
"worker_system_disk_category":"The system disk type of worker nodes.",
"worker_system_disk_size":"The system disk size of a worker node.",
"worker_data_disk":"Specifies whether to mount data disks to worker nodes. Valid values: true and false.",
"worker_data_disks":"The data disk configurations of worker nodes.",
"num_of_nodes":"The number of worker nodes.",
"snat_entry":"Specifies whether to enable Source Network Address Translation (SNAT).",
"endpoint_public_access":"Specifies whether to enable Internet access to the endpoint of the cluster.",
"proxy_mode":"The kube-proxy mode. Valid values: iptables and ipvs.",
"addons":"The add-ons to be installed for the cluster. This parameter must be an array.", 
"tags":"The tags of the cluster. This parameter must be an array.",
"security_group_id":"The ID of the security group to which the ECS instances in the cluster belong.",
"taints":"The taints to be added to nodes in the cluster. This parameter must be an array."
"cpu_policy":"The CPU policy. Valid values: static and none.",
"runtime":"The container runtime. Default value: docker.",
"platform":"The architecture of the nodes that run pods.",
"os_type":"The operating system of the nodes that run pods. For example, Linux and Windows.",
"node_cidr_mask":"The prefix length of the node IP address.",
"kubernetes_version":"The version of the cluster. The default value is the latest version.",
"deletion_protection":"Specifies whether to enable cluster deletion protection. After this option is enabled, the cluster cannot be deleted by operations in the console or API operations."
}

Response information

Response line

HTTP/1.1 202 Accepted

Custom response headers

No custom response headers are used. For more information, see Public response headers.

Response body

{
"cluster_id":"string",
"request_id":"string",
"task_id":"string"
}

Examples

Sample requests

POST /clusters HTTP/1.1
<Common request headers>
{
"name":"test",
"cluster_type":"my-test-Kubernetes-cluster",
"disable_rollback":true,
"timeout_mins":60,
"kubernetes_version":"1.12.6-aliyun.1",
"region_id":"cn-beijing",
"snat_entry":true,
"cloud_monitor_flags":false,
"endpoint_public_access":false,
"node_cidr_mask":"25",
"proxy_mode":"ipvs",
"tags":[],
"addons": [{"name": "flannel"},{"name": "aliyun-log-controller","config": "{\"sls_project_name\":\"k8s-log-c64f6eab6a1764d3dbee3dc2b9e41****\"}"},{"name": "nginx-ingress-controller", "config": "{\"IngressSlbNetworkType\":\"internet\"}"}],
"worker_instance_types":["ecs.hfc5.xlarge"],
"num_of_nodes":3,
"worker_system_disk_category":"cloud_efficiency",
"worker_system_disk_size":120,
"worker_instance_charge_type":"PostPaid",
"vpcid":"vpc-2zegvl5etah5requ09nec",
"container_cidr":"172.20.0.0/16",
"service_cidr":"172.21.0.0/20",
"vswitch_ids":["vsw-2ze48rkq464rsdts1****"],
"worker_data_disks": [{"category": "cloud_ssd", "size": 500}],
"login_password":"test@19****",
"taint":[{"key": "special", "value": "true", "effect": "NoSchedule"}]
}

Sample responses

HTTP/1.1 202 Accepted
<Common response headers>
{
    "cluster_id": "cb95aa626a47740afbf6aa099b65****",
    "request_id": "687C5BAA-D103-4993-884B-C35E4314A1E1",
    "task_id": "T-5a54309c80282e39ea00002f"
}