调用CreateCluster创建一个新的Serverless Kubernetes集群实例。

请求信息

请求行RequestLine

POST /clusters HTTP/1.1

特有请求头RequestHead

无。请参见公共请求头部

请求体RequestBody

{
"cluster_type": "ASK", 
"name": "集群名称",
"region_id": "地域",
"zoneid": "可用区",
"nat_gateway": "true", //是否创建NAT网关。
"private_zone": true, //是否开启privateZone用于服务发现。
"vpc_id": "VPC ID", //不填则自动创建专有网络VPC。
"tags": "给集群打tag标签, 数组格式对象。",
"vswitch_id": "交换机ID。"
}
表 1. 请求体解释
名称 类型 必须 描述
cluster_type string 集群类型。
name string 集群名称, 集群名称可以使用大小写英文字母、中文、数字、中划线。
kubernetes_version string 集群版本号。
private_zone bool 是否开启PrivateZone用于服务发现,取值为true或者false。请参见Serverless集群基于云解析 PrivateZone 的服务发现
region_id string 集群所在地域ID。
endpoint_public_access bool 是否开启API Server公网可访问。
zone_id string 所属地域的可用区。
vswitch_id string 交换机ID,可空。若不设置,系统会自动创建交换机,系统自动创建的交换机网段为192.168.0.0/16。
tags list 给集群打tag标签:
  • key:标签名称。
  • value:标签值。
deletion_protection bool 是否开启集群删除保护。
addons list 集群需要安装的组件。默认需要安装日志组件:[{"name":"logtail-ds"}]。
nat_gateway bool 是否创建NAT网关。取值为true或者false。如果不设置,系统默认为false。
vpc_id string VPC ID,可空。如果不设置,系统会自动创建VPC,系统创建的VPC网段为192.168.0.0/16。
说明 vpc_id和vswitch_ids只能同时为空或者同时都设置对应的值。
vswitch_ids list 虚拟交换机列表,可空。如果不设置,系统会自动创建。
说明 vpc_idvswitch_ids只能同时为空或者同时设置对应的值。
security_group_id string 安全组ID,如果不设置,系统会自动创建。

返回信息

返回行ResponseLine

HTTP/1.1 202 Accepted

特有返回头ResponseHead

无。请参见公共返回头部

表 2. 返回体ResponseBody
名称 类型 描述
cluster_id string 集群实例ID。
request_id string 请求ID。
task_id string 任务ID。系统自动分配,用户查询任务状态。

示例

请求示例

POST /clusters HTTP/1.1
<公共请求头>
{
    "cluster_type":"Ask",
    "name":"ask-cluster",
    "kubernetes_version":"1.16.9-aliyun.1",
    "region_id":"cn-shenzhen",
    "endpoint_public_access":true,
    "private_zone":true,
    "tags":[
        {
            "key":"tier",
            "value":"frontend"
        }
    ],
    "deletion_protection":true,
    "addons":[
        {
            "name":"logtail-ds"
        }
    ],
    "zone_id":"cn-shenzhen-a",
    "vpc_id":"vpc-wz984yvbd6lck22z3****",
    "vswitch_ids":[
        "vsw-wz9uwxhawmtzg7u9h****"
    ],
    "logging_type":"SLS",
    "security_group_id":"sg-wz9b86l4s7nthi1k****"
}

返回示例

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