创建Kubernetes托管版集群

请求信息

请求行RequestLine

POST /clusters HTTP/1.1 

特有请求头RequestHead

该接口使用公共请求头，无特殊请求头。请参见公共请求和返回结果文档。

请求体RequestBody

{
"disable_rollback": "失败是否回滚。",
"name": "集群名称。",
"timeout_mins": "集群创建超时时间。",
"cluster_type": "集群类型，ManagedKubernetes。",
"region_id": "地域。",
"vpcid": "VPC ID",
"vswitch_ids": "一台或多台虚拟交换机ID，交换机个数的取值范围为[1,3]。",
"container_cidr": "容器POD CIDR。",
"service_cidr": "服务CIDR。",
"cloud_monitor_flags":"是否安装云监控插件。",
"login_password": "节点SSH登录密码，和key_pair二选一。",
"key_pair":"keypair名称，和login_password二选一。",
"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_system_disk_category": "Worker系统盘类型。",
"worker_system_disk_size": "Worker节点系统盘大小。",
"worker_data_disk":"是否挂载数据盘true|false。",
"worker_data_disks":"Worker节点数据盘配置。",
"num_of_nodes": "Worker节点数。",
"snat_entry": "是否配置SNATEntry",
"endpoint_public_access":"是否公网暴露集群endpoint。",
"proxy_mode": "网络模式, 可选值iptables|ipvs。",
"addons": "选装addon, 数组格式对象", 
"tags": "给集群打tag标签, 数组格式对象。",
"security_group_id": "安全组ID，和is_enterprise_security_group二选一",
"is_enterprise_security_group": "是否自动创建安全组，security_group_id如果没设置，那么该参数必填，值为true",
"taints": "给节点添加taint, 数组格式对象。",
"cpu_policy":"cpu的策略，static|none。",
"runtime":"容器的运行时环境，默认为docker。例如："runtime":{"name":"docker","version":"19.03.5"}"。",
"platform":"运行Pod的主机的平台架构。",
"os_type":"运行Pod的主机的操作系统类型，例如：linux，Windows等。",
"node_cidr_mask":"节点网络的网络ID的位数。",
"kubernetes_version":"kubernetes集群的版本，默认最新版本。",
"deletion_protection":"是否开启集群删除保护，防止通过控制台或API误删除集群。"
}

返回信息

返回行ResponseLine

HTTP/1.1 202 Accepted

特有返回头ResponseHead

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

返回体ResponseBody

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

示例

请求示例

POST /clusters HTTP/1.1
<公共请求头>
{
    "name":"amk-cluster",
    "cluster_type":"ManagedKubernetes",
    "disable_rollback":true,
    "timeout_mins":60,
    "kubernetes_version":"1.16.9-aliyun.1",
    "region_id":"cn-beijing",
    "snat_entry":true,
    "cloud_monitor_flags":true,
    "endpoint_public_access":true,
    "deletion_protection":true,
    "node_cidr_mask":"26",
    "proxy_mode":"ipvs",
    "tags":[
        {
            "key":"tier",
            "value":"backend"
        }
    ],
    "addons":[{"name":"flannel"},{"name":"csi-plugin"},{"name":"csi-provisioner"},{"name":"logtail-ds","config":"{\"IngressDashboardEnabled\":\"true\"}"},{"name":"ack-node-problem-detector","config":"{\"sls_project_name\":\"\"}"},{"name":"nginx-ingress-controller","config":"{\"IngressSlbNetworkType\":\"internet\"}"},{"name":"arms-prometheus"}],
    "os_type":"Linux",
    "platform":"CentOS",
    "runtime":{
        "name":"docker",
        "version":"19.03.5"
    },
    "worker_instance_types":[
        "ecs.i2.2xlarge"
    ],
    "num_of_nodes":3,
    "worker_system_disk_category":"cloud_efficiency",
    "worker_system_disk_size":120,
    "worker_data_disks":[
        {
            "category":"cloud_efficiency",
            "size":"40",
            "encrypted":"true",
            "auto_snapshot_policy_id":""
        }
    ],
    "worker_instance_charge_type":"PrePaid",
    "worker_period_unit":"Month",
    "worker_period":1,
    "worker_auto_renew":true,
    "worker_auto_renew_period":1,
    "vpcid":"vpc-2zemm8mo5rmdppgqm****",
    "container_cidr":"172.20.0.0/16",
    "service_cidr":"172.21.0.0/20",
    "vswitch_ids":[
        "vsw-2zej67xyhh61oqn7i****"
    ],
    "login_password":"Hello1234",
    "logging_type":"SLS",
    "cpu_policy":"none",
    "taints":[
        {
            "key":"key1",
            "value":"value1",
            "effect":"NoSchedule"
        }
    ],
    "security_group_id":"sg-2zeg3u73kkhtixda****"
}

返回示例

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