容器服务 Kubernetes 版 ACK：通过OpenAPI创建ACK Edge集群

名称

类型

是否必选

示例值

描述

name

String

是

demo-edge-cluster

集群名称。

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

cluster_type

String

是

ManagedKubernetes

集群类型。取值ManagedKubernetes创建边缘托管版集群。

disable_rollback

Boolean

否

true

集群创建失败是否回滚。取值：

• true：当集群创建失败时，进行回滚操作。

• false：当集群创建失败时，不进行回滚操作。

默认值：false。

timeout_mins

Long

否

60

集群资源栈创建超时时间，以分钟为单位，默认值60分钟。

kubernetes_version

String

否

1.30.1-aliyun.1

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

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

runtime

Array of runtime

否

{"name": "containerd", "version": "1.6.20"}

容器运行时，支持containerd和docker两种运行时。

包括以下信息：

• name：容器运行时名称。

• version：容器运行时版本。

region_id

String

是

cn-beijing

集群所在地域ID。

key_pair

String

是

demo-key

密钥对名称，和login_password二选一。

login_password

String

是

HelloWorld123

SSH登录密码，和key_pair二选一。密码规则为8~30个字符，且至少同时包含三项（大小写字母、数字和特殊符号）。

num_of_nodes

Long

是

1

Worker节点数。范围是[0,100]。

profile

String

是

Edge

ACK Edge集群标识，默认取值：Edge。

logging_type

String

否

SLS

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

snat_entry

Boolean

否

true

是否为网络配置SNAT：

• 当已有VPC能访问公网环境时，设置为false。

• 当已有VPC无法访问公网环境时：

  • 设置为true，表示配置SNAT，此时可以访问公网环境。

  • 设置为false，表示不配置SNAT，此时无法访问公网环境。

如果您的应用需要访问公网，建议配置为true。

默认值：false。

vswitch_ids

Array of String

是

vsw-2ze48rkq464rsdts1****

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

worker_system_disk_category

String

是

cloud_efficiency

Worker节点系统盘类型，取值：

• cloud_efficiency：高效云盘。

• cloud_ssd：SSD云盘。

默认值：cloud_ssd。

worker_system_disk_size

Long

是

100

Worker节点系统盘大小，单位为GiB。

取值范围：[40,500]。

该参数的取值必须大于或者等于max{40, ImageSize}。

默认值：120。

container_cidr

String

否

172.20.0.0

Pod网络地址段，不能和VPC网段冲突。当选择系统自动创建VPC时，默认使用172.16.0.0/16网段。

cloud_monitor_flags

Boolean

否

true

集群是否安装云监控插件。取值：

• true：安装云监控插件。

• false：不安装云监控插件。

默认值：false。

endpoint_public_access

Boolean

否

true

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

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

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

默认值：true。

service_cidr

String

是

172.21.0.0

Service网络地址段，不能和VPC网段及Pod网络网段冲突。当选择系统自动创建VPC时，默认使用172.19.0.0/20网段。

addons

Array of addon

否

[{"name":"flannel","config":""},{"name":"logtail-ds-docker","config":""},{"name":"alibaba-log-controller","config":"{"IngressDashboardEnabled":"false"}"}]

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\"}"}]。

tags

Array of tag

否

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

给集群打tag标签：

• key：标签名称。

• value：标签值。

vpcid

String

是

vpc-2zeik9h3ahvv2zz95****

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

worker_data_disks

Array of data_disk

否

Worker节点数据盘类型、大小等配置的组合。

deletion_protection

Boolean

否

true

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

• true：启用集群删除保护，将不能通过控制台或API删除集群。

• false：不启用集群删除保护，则能通过控制台或API删除集群。

默认值：false。

node_cidr_mask

String

否

25

节点IP数量，通过指定网络的CIDR来确定IP的数量，只对于Flannel网络类型集群生效。

默认值：25。

worker_instance_types

Array of String

是

ecs.n4.large

Worker节点实例规格，至少要指定一个实例规格。更多信息，请参见实例规格族。

worker_instance_charge_type

String

是

PrePaid

Worker节点付费类型，取值：

• PrePaid：包年包月。

• PostPaid：按量付费。

默认值：按量付费。

security_group_id

String

否

sg-bp1bdue0qc1g7k****

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

is_enterprise_security_group

Boolean

否

true

自动创建企业级安全组，当security_group_id为空的时生效。

• true：创建并使用企业级安全组。

• false：不使用企业级安全组。

默认值：true。

rds_instances

rds_instances

否

rm-2zev748xi27xc****

RDS实例名称。

cluster_spec

String

否

ack.pro.small

托管版集群类型，面向托管集群。取值：

• ack.pro.small：专业托管集群，即：ACK Edge集群Pro版。

• ack.standard：标准托管集群，即ACK Edge集群基础版。

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

更多信息，请参见ACK Edge集群Pro版介绍。

resource_group_id

String

否

rg-acfm3mkrure****

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

名称

类型

示例值

描述