使用阿里云OpenAPI創(chuàng)建ACK Serverless集群
調(diào)用CreateCluster創(chuàng)建一個新的ACK Serverless集群實例。
請求語法
POST /clusters HTTP/1.1
Content-Type:application/json
{
"cluster_type" : "String",
"profile": "String",
"cluster_spec" : "String",
"name" : "String",
"kubernetes_version" : "String",
"private_zone" : Boolean,
"region_id" : "String",
"endpoint_public_access" : Boolean,
"service_discovery_types" : [ "String" ],
"zoneid" : "String",
"logging_type" : "String",
"tags" : [ {
"key" : "String",
"value" : "String"
} ],
"deletion_protection" : Boolean,
"service_cidr" : "String",
"timezone" : "String",
"addons" : [ {
"name" : "String",
"config" : "String",
"disabled" : Boolean
} ],
"snat_entry" : Boolean,
"vpcid" : "String",
"vswitch_ids" : [ "String" ],
"security_group_id" : "String"
}
請求參數(shù)
表 1. 請求Body參數(shù)
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
cluster_type | String | 是 | ManagedKubernetes | 集群類型。可選值為ManagedKubernetes,同時profile配置為 |
profile | String | 是 | Serverless | 集群標(biāo)識。參數(shù)cluster_type取值為 |
cluster_spec | String | 否 | ack.pro.small | ACK Serverless集群類型。取值:
默認(rèn)值: 更多信息,請參見ACK Serverless Pro版集群概述。 |
name | String | 是 | cluster-demo | 集群名稱。 命名規(guī)則:由數(shù)字、漢字、英文字符或短劃線(-)組成,長度范圍1~63個字符,且不能以短劃線(-)開頭。 |
kubernetes_version | String | 否 | 1.30.1-aliyun.1 | 集群版本,與Kubernetes社區(qū)基線版本保持一致。建議選擇最新版本,若不指定,默認(rèn)使用最新版本。 目前您可以在ACK控制臺創(chuàng)建兩種最新版本的集群。您可以通過API創(chuàng)建其他Kubernetes版本集群。關(guān)于ACK支持的Kubernetes版本,請參見Kubernetes版本概覽及機(jī)制。 |
private_zone | Boolean | 否 | false | 是否開啟ACK Serverless集群的PrivateZone用于服務(wù)發(fā)現(xiàn)。取值:
更多信息,請參見ACK Serverless集群基于云解析PrivateZone的服務(wù)發(fā)現(xiàn)。 |
region_id | String | 是 | cn-beijing | 集群所在地域ID。 |
endpoint_public_access | Boolean | 否 | true | 是否開啟公網(wǎng)API Server。取值:
默認(rèn)值: |
service_discovery_types | Array of String | 否 | PrivateZone | 集群內(nèi)服務(wù)發(fā)現(xiàn)類型,用于指定服務(wù)發(fā)現(xiàn)方式。
默認(rèn)值:不開啟。 |
zoneid | String | 否 | cn-beiji**** | 集群所屬地域的可用區(qū)ID。 重要 如果不指定 |
logging_type | String | 否 | SLS | 集群開啟日志服務(wù),只針對ACK Serverless集群生效,且取值必須是 |
tags | Array of tag | 否 | [{"key": "env", "value": "prod"}] | 給集群打tag標(biāo)簽。包含以下信息:
|
deletion_protection | Boolean | 否 | true | 集群是否開啟集群刪除保護(hù),防止通過控制臺或API誤刪除集群。取值:
默認(rèn)值: |
service_cidr | String | 否 | 172.21.0.0/20 | Service網(wǎng)絡(luò)地址段,可選范圍:10.0.0.0/16-24,172.16-31.0.0/16-24,192.168.0.0/16-24 不能與VPC網(wǎng)段10.1.0.0/21及VPC內(nèi)已有Kubernetes集群使用的網(wǎng)段重復(fù),創(chuàng)建成功后無法修改。 默認(rèn)使用172.19.0.0/20網(wǎng)段。 |
timezone | String | 否 | Asia/Shanghai | 集群使用的時區(qū)。更多信息,請參見支持時區(qū)。 |
addons | Array of addon | 否 | [{"name":"logtail-ds","config":"{\"sls_project_name\":\"your_sls_project_name\"}"}] | Kubernetes集群安裝的組件列表。組件的結(jié)構(gòu)包括:
網(wǎng)絡(luò)組件:必選,包含F(xiàn)lannel和Terway兩種網(wǎng)絡(luò)類型,創(chuàng)建集群時二選一:
存儲組件:可選,僅支持
日志組件:可選。 說明 如果不開啟日志服務(wù),將無法使用集群審計功能。
Ingress組件:可選,ACK專有版集群默認(rèn)安裝Ingress組件nginx-ingress-controller。
事件中心:可選,默認(rèn)開啟。事件中心提供對Kubernetes事件的存儲、查詢、告警等能力。Kubernetes事件中心關(guān)聯(lián)的Logstore在90天內(nèi)免費。關(guān)于免費策略的更多信息,請參見創(chuàng)建并使用K8s事件中心。 開啟事件中心:[{"name":"ack-node-problem-detector","config":"{\"sls_project_name\":\" your_sls_project_name\"}"}]。 |
snat_entry | Boolean | 否 | true | 創(chuàng)建ACK Serverless集群時,是否在VPC中創(chuàng)建NAT網(wǎng)關(guān)并配置SNAT規(guī)則。取值:
默認(rèn)值: |
vpcid | String | 否 | vpc-2zeik9h3ahvv2zz95**** | 集群使用的專有網(wǎng)絡(luò),創(chuàng)建集群時必須為集群提供。 說明
|
vswitch_ids | Array of String | 否 | ["vsw-2ze97jwri7cei0mpw****"] | 交換機(jī)ID。List長度范圍為[1,3]。 |
security_group_id | String | 否 | sg-bp1bdue0qc1g7k**** | 使用已有安全組創(chuàng)建集群時需要指定安全組ID,和 |
resource_group_id | String | 否 | rg-acfm3mkrure**** | 集群所屬資源組ID,實現(xiàn)不同資源的隔離。 |
響應(yīng)體語法
HTTP/1.1 200
Content-Type:application/json
{
"cluster_id" : "String",
"request_id" : "String",
"task_id" : "String"
}
響應(yīng)參數(shù)
表 2. 響應(yīng)Body參數(shù)
名稱 | 類型 | 示例值 | 描述 |
cluster_id | String | cb95aa626a47740afbf6aa099b650**** | 集群ID。 |
request_id | String | 687C5BAA-D103-4993-884B-C35E4314A1E1 | 請求ID。 |
task_id | String | T-5a54309c80282e39ea00002f | 任務(wù)ID。 |
示例1 使用自動創(chuàng)建VPC方式創(chuàng)建ACK Serverless集群基礎(chǔ)版
請求示例
POST /clusters HTTP/1.1
<公共請求頭>
{
"cluster_type":"ManagedKubernetes",
"profile":"Serverless",
"cluster_spec":"ack.standard",
"name":"test-ask",
"region_id":"cn-hangzhou",
"endpoint_public_access":false,
"logging_type" : "SLS",
"private_zone":false,
"snat_entry":true,
"tags":[
{
"key":"k-aa",
"value":"v-aa"
}
],
"deletion_protection":false,
"addons":[
{
"name":"logtail-ds"
}
],
"zoneid":"cn-hangzhou-i"
}
返回示例
{
"cluster_id": "cb95aa626a47740afbf6aa099b650****",
"RequestId": "687C5BAA-D103-4993-884B-C35E4314A1E1",
"task_id": "T-5a54309c80282e39ea00002f",
}
示例2 使用已有VPC方式創(chuàng)建ACK Serverless集群Pro版
請求示例
POST /clusters HTTP/1.1
<公共請求頭>
{
"cluster_type":"ManagedKubernetes",
"profile":"Serverless",
"cluster_spec":"ack.pro.small",
"name":"ask-cluster",
"region_id":"cn-shenzhen",
"endpoint_public_access":true,
"logging_type": "SLS",
"private_zone":true,
"tags":[
{
"key":"tier",
"value":"frontend"
}
],
"deletion_protection":true,
"addons":[
{
"name":"logtail-ds"
}
],
"vpcid":"vpc-wz984yvbd6lck22z3****",
"vswitch_ids":[
"vsw-wz9uwxhawmtzg7u9h****"
],
"security_group_id":"sg-wz9b86l4s7nthi1k****"
}
返回示例
{
"cluster_id": "cb95aa626a47740afbf6aa099b650****",
"RequestId": "687C5BAA-D103-4993-884B-C35E4314A1E1",
"task_id": "T-5a54309c80282e39ea00002f",
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
開發(fā)者資源
阿里云為您提供多種語言的SDK,幫助您快速通過API集成阿里云的產(chǎn)品和服務(wù),推薦您使用SDK調(diào)用API,以免除您手動簽名驗證,詳情請參見SDK參考文檔鏈接。
快速檢索,可視化調(diào)試API,在線命令行工具,同步動態(tài)生成可執(zhí)行的SDK代碼示例。
阿里云資產(chǎn)管理和配置工具,可通過命令方式同時管理多個阿里云產(chǎn)品和服務(wù),簡單快捷,是您上云好幫手。