创建一个新的 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 集群名称, 集群名称可以使用大小写英文字母、中文、数字、中划线。
private_zone bool 是否开启PrivateZone用于服务发现,取值为true或者false。请参见Serverless集群基于云解析 PrivateZone 的服务发现
region_id string 集群所在地域ID。
zoneid string 所属地域的可用区。
vswitch_id string 交换机ID,可空。若不设置,系统会自动创建交换机,系统自定创建的交换机网段为 192.168.0.0/16。
tags list 给集群打tag标签:
  • key:标签名称
  • value:标签值
nat_gateway bool 是否创建NAT网关。取值为true或者false。如果不设置,系统默认为false。
vpc_id string VPC ID,可空。如果不设置,系统会自动创建VPC,系统创建的VPC网段为192.168.0.0/16。
说明 vpcId 和 vswitchid 只能同时为空或者同时都设置对应的值。

返回信息

返回行 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":"my-test-Kubernetes-cluster",
"region_id":"cn-beijing",
"tags":[],
"vpcid":"vpc-2zegvl5etah5requ0****",
"vswitch_ids":["vsw-2ze48rkq464rsdts1****"]
}

返回示例

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