容器服务 Kubernetes 版 ACK：使用阿里云OpenAPI创建ACK Serverless集群

名称

类型

是否必选

示例值

描述

cluster_type

String

是

ManagedKubernetes

集群类型。可选值为ManagedKubernetes，同时profile配置为Serverless，表示创建ACK Serverless集群。

profile

String

是

Serverless

集群标识。参数cluster_type取值为ManagedKubernetes，同时该参数配置为Serverless，表示创建ACK Serverless集群。

cluster_spec

String

否

ack.pro.small

默认值：ack.standard。取值可以为空，为空时则创建ACK Serverless集群基础版。

更多信息，请参见ACK Serverless Pro版集群概述。

name

String

是

cluster-demo

集群名称。

命名规则：由数字、汉字、英文字符或短划线（-）组成，长度范围1~63个字符，且不能以短划线（-）开头。

kubernetes_version

String

否

1.30.1-aliyun.1

集群版本，与Kubernetes社区基线版本保持一致。建议选择最新版本，若不指定，默认使用最新版本。

目前您可以在ACK控制台创建两种最新版本的集群。您可以通过API创建其他Kubernetes版本集群。关于ACK支持的Kubernetes版本，请参见Kubernetes版本概览及机制。

private_zone

Boolean

否

false

是否开启ACK Serverless集群的PrivateZone用于服务发现。取值：

• true：开启PrivateZone用于服务发现。

• false：不开启PrivateZone用于服务发现。

更多信息，请参见ACK Serverless集群基于云解析PrivateZone的服务发现。

region_id

String

是

cn-beijing

集群所在地域ID。

endpoint_public_access

Boolean

否

true

是否开启公网API Server。取值：

• true：表示开放公网API Server。

• false：表示不会创建公网的API Server，仅创建私网的API Server。

默认值：true。

service_discovery_types

Array of String

否

PrivateZone

集群内服务发现类型，用于指定服务发现方式。

• CoreDNS：使用Kubernetes原生标准服务发现组件CoreDNS，需要在集群部署一组容器用于DNS解析。默认采用两个0.25 Core 512 MiB规格的ECI实例。

• PrivateZone：使用阿里云PrivateZone产品提供服务发现能力，需要开启PrivateZone服务。

默认值：不开启。

zoneid

String

否

cn-beiji****

logging_type

String

否

SLS

集群开启日志服务，只针对ACK Serverless集群生效，且取值必须是SLS。

tags

Array of tag

否

[{"key": "env", "value": "prod"}]

给集群打tag标签。包含以下信息：

• key：标签名称。

• value：标签值。

deletion_protection

Boolean

否

true

集群是否开启集群删除保护，防止通过控制台或API误删除集群。取值：

• true：集群开启集群删除保护。

• false：集群不开启集群删除保护。

默认值：false。

service_cidr

String

否

172.21.0.0/20

Service网络地址段，可选范围：10.0.0.0/16-24，172.16-31.0.0/16-24，192.168.0.0/16-24

不能与VPC网段10.1.0.0/21及VPC内已有Kubernetes集群使用的网段重复，创建成功后无法修改。

默认使用172.19.0.0/20网段。

timezone

String

否

Asia/Shanghai

集群使用的时区。更多信息，请参见支持时区。

addons

Array of addon

否

[{"name":"logtail-ds","config":"{\"sls_project_name\":\"your_sls_project_name\"}"}]

Kubernetes集群安装的组件列表。组件的结构包括：

• name：必填，组件名称。

• config：可选，取值为空时表示无需配置。

• disabled：可选，是否禁止默认安装。

网络组件：必选，包含Flannel和Terway两种网络类型，创建集群时二选一：

• Flannel网络：[{"name":"flannel","config":""}]。

• Terway网络：[{"name": "terway-eniip","config": ""}] 。

存储组件：可选，仅支持csi类型：

csi：[{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}]。

日志组件：可选。

• 使用已有SLS Project：[{"name": "logtail-ds","config": "{\"IngressDashboardEnabled\":\"true\",\"sls_project_name\":\"your_sls_project_name\"}"}] 。

• 创建新的SLS Project：[{"name": "logtail-ds","config": "{\"IngressDashboardEnabled\":\"true\"}"}] 。

Ingress组件：可选，ACK专有版集群默认安装Ingress组件nginx-ingress-controller。

• 安装Ingress并且开启公网：[{"name":"nginx-ingress-controller","config":"{\"IngressSlbNetworkType\":\"internet\"}"}] 。

• 不安装Ingress：[{"name": "nginx-ingress-controller","config": "","disabled": true}] 。

事件中心：可选，默认开启。事件中心提供对Kubernetes事件的存储、查询、告警等能力。Kubernetes事件中心关联的Logstore在90天内免费。关于免费策略的更多信息，请参见创建并使用K8s事件中心。

开启事件中心：[{"name":"ack-node-problem-detector","config":"{\"sls_project_name\":\"

your_sls_project_name\"}"}]。

snat_entry

Boolean

否

true

创建ACK Serverless集群时，是否在VPC中创建NAT网关并配置SNAT规则。取值：

• true：将为您创建NAT网关并自动配置SNAT规则，集群VPC将具备公网访问能力。

• false：不为您创建NAT网关及SNAT规则。集群VPC将不具备公网访问能力。

默认值：false。

vpcid

String

否

vpc-2zeik9h3ahvv2zz95****

集群使用的专有网络，创建集群时必须为集群提供。

vswitch_ids

Array of String

否

["vsw-2ze97jwri7cei0mpw****"]

交换机ID。List长度范围为[1,3]。

security_group_id

String

否

sg-bp1bdue0qc1g7k****

使用已有安全组创建集群时需要指定安全组ID，和is_enterprise_security_group二选一，集群节点会自动加入到此安全组。

resource_group_id

String

否

rg-acfm3mkrure****

集群所属资源组ID，实现不同资源的隔离。

名称

类型

示例值

描述