创建Kubernetes集群

请求信息

请求行 RequestLine

POST /clusters HTTP/1.1

特有请求头 RequestHead

无，请参考公共请求头部。

请求体 RequestBody

{
    "disable_rollback": "失败是否回滚",
    "name": "集群名称",
    "timeout_mins": "集群创建超时时间",
    "cluster_type": "集群类型，Kubernetes",
    "region_id": "地域",
    "vpcid": "VPC ID",
    "master_vswitch_ids": "master节点交换机ID。填写3个vswitchid, 尽量是分别在3个不同az, 保证高可用",
    "master_instance_types": "master节点实例类型。填写3个实例规格",
    "master_count": "master实例个数，支持3|5",
    "container_cidr": "容器POD CIDR",
    "service_cidr": "服务CIDR",
    "ssh_flags": "是否开放公网SSH登录",
    "cloud_monitor_flags":"是否安装云监控插件",
    "login_password": "节点SSH登录密码，和key_pair二选一",
    "key_pair":"keypair名称，和login_password 二选一",
    "master_instance_charge_type":"Master实例付费类型，PostPaid|PrePaid",
    "master_period_unit":"包年包月单位，Month,Year，只有在PrePaid下生效",
    "master_period":"包年包月时长，只有在PrePaid下生效",
    "master_auto_renew":"Master节点是否自动续费",
    "master_auto_renew_period":"Master节点续费周期",
    "master_system_disk_category": "Master系统盘类型",
    "master_system_disk_size":"Master节点系统盘大小",
    "master_data_disk":"Master节点是否挂载数据盘",
    "master_data_disk_category":"Master节点数据盘类型",
    "master_data_disk_size":"Master节点数据盘大小",
    "worker_instance_charge_type":"Worker节点付费类型PrePaid|PostPaid",
    "worker_period_unit":"包年包月单位，Month,Year，只有在PrePaid下生效",
    "worker_period":"包年包月时长，只有在PrePaid下生效",
    "worker_auto_renew":"Worker节点自动续费true|false",
    "worker_auto_renew_period":"Worker节点续费周期",
    "worker_instance_types": "Worker实例规格多实例规格参数",
    "worker_vswitch_ids":  "一台或多台虚拟交换机 ID，N 的取值范围为 [1, 5]",
    "worker_system_disk_category": "Worker系统盘类型",
    "worker_system_disk_size": "Worker节点系统盘大小",
    "worker_data_disk":"Worker节点是否挂载数据盘",
    "worker_data_disk_category":"Worker节点数据盘类型",
    "worker_data_disk_size":"Worker节点数据盘大小",
    "num_of_nodes": "Worker节点数",
    "snat_entry": 是否配置SNATEntry,
    "endpoint_public_access":"是否公网暴露集群endpoint",
    "cpu_policy": "static|none",
    "node_port_range": "节点端口范围,默认30000-65535",
    "proxy_mode": "网络模式, 可选值iptables|ipvs",
    "addons": "选装addon, 数组格式对象", 
    "tags": "给集群打tag标签, 数组格式对象",
    "security_group_id": "安全组ID",
    "taint": "给节点添加taint, 数组格式对象"
}

返回信息

返回行 ResponseLine

HTTP/1.1 202 Accepted

特有返回头 ResponseHead

无，请参考公共返回头部。

示例

请求示例

POST /clusters HTTP/1.1
<公共请求头>
{
"cluster_type":"Kubernetes",
"name":"my-test-Kubernetes-cluster",
"region_id":"cn-beijing",
"disable_rollback":true,
"timeout_mins":60,
"kubernetes_version":"1.12.6-aliyun.1",
"snat_entry":true,
"endpoint_public_access":false,
"cloud_monitor_flags":false,
"node_cidr_mask":"25",
"proxy_mode":"iptables",
"tags":[],
"addons": [{"name": "flannel"},{"name": "aliyun-log-controller","config": "{/"sls_project_name/":/"k8s-log-c64f6eab6a1764d3dbee3dc2b9e41****/"}"},{"name": "nginx-ingress-controller", "config": "{/"IngressSlbNetworkType/":/"internet/"}"}],
"node_port_range":"30000-32767",
"login_password":"test****",
"cpu_policy":"none",
"master_count":3,
"master_vswitch_ids":["vsw-2ze48rkq464rsdts****","vsw-2ze48rkq464rsdts1****","vsw-2ze48rkq464rsdts1****"],
"master_instance_types":["ecs.sn1.medium","ecs.sn1.medium","ecs.sn1.medium"],
"master_system_disk_category":"cloud_efficiency",
"master_system_disk_size":40,
"worker_instance_types":["ecs.sn2.3xlarge"],
"num_of_nodes":3,
"worker_system_disk_category":"cloud_efficiency",
"worker_system_disk_size":120,
"vpcid":"vpc-2zegvl5etah5requ0****",
"worker_vswitch_ids":["vsw-2ze48rkq464rsdts****"],
"container_cidr":"172.20.XX.XX/16",
"service_cidr":"172.21.XX.XX/20",
"taint":[{"key": "special", "value": "true", "effect": "NoSchedule"}]
}

返回示例

HTTP/1.1 202 Accepted
<公共响应头>
{
    "cluster_id": "cb95aa626a47740afbf6aa099b650****",
    "request_id": "687C5BAA-D103-4993-884B-C35E4314A1E1",
    "task_id": "T-5a54309c80282e39ea00002f"
}