CreateCluster
您可以通过OpenAPI创建ACK集群，包含ACK托管集群、ACK Serverless集群，ACK Edge集群以及注册集群。创建集群时，您将完成集群信息、集群组件以及ACK相关云资源的配置
服务地址：
华东1 金融云
输入参数
只看必填
body请求体参数
name集群名称
region_id集群所在的地域ID
cluster_type- Kubernetes: ACK专有集群
cluster_spec当您选择cluster_type为Ma...
kubernetes_version集群版本
runtime容器引擎
name容器运行时名称
version容器运行时版本
vpcid集群使用的专有网络
pod_vswitch_ids网络插件选择Terway时
0网络插件选择Terway时
添加
container_cidrPod网络地址段
service_cidrService网络地址段
security_group_id使用已有安全组创建集群时需要指定安全组ID
is_enterprise_security_group自动创建企业级安全组
请选择布尔值
snat_entry为专有网络配置SNAT
请选择布尔值
endpoint_public_access是否开启公网访问
请选择布尔值
ssh_flags是否开放公网SSH登录
请选择布尔值
timezone集群使用的时区
node_cidr_mask节点IP数量
user_ca自定义集群CA
user_data自定义节点数据
cluster_domain集群本地域名
node_name_mode【该字段已废弃】节点池配置请使用nod...
custom_san自定义证书SAN
encryption_provider_keyKMS密钥ID
service_account_issuerServiceAccount是Pod和...
api_audiencesServiceAccount是Pod和...
image_id【该字段已废弃】集群控制面配置请使用c...
rds_instances【该字段已废弃】节点池配置请使用nod...
0RDS实例列表
添加
tags节点标签
0标签配置
key标签key值
value标签value值
添加
addons集群组件列表
0集群组件的配置
name组件名称
config组件配置
disabled是否禁止默认安装
请选择布尔值
version组件版本
添加
taints【该字段已废弃】节点池配置请使用nod...
0节点污点配置
key污点key值
value污点value值
effect调度策略
添加
cloud_monitor_flags【该字段已废弃】集群控制面节点配置请使...
请选择布尔值
platform【该字段已废弃】节点池配置请使用nod...
os_type【该字段已废弃】集群控制面节点配置请使...
soc_enabled【该字段已废弃】集群控制面节点配置请使...
请选择布尔值
security_hardening_os【该字段已废弃】集群控制面配置请使用c...
请选择布尔值
cis_enabled【已废弃】集群控制面配置请使用cont...
请选择布尔值
cpu_policy【该字段已废弃】集群控制面配置请使用c...
proxy_modekube-proxy代理模式
node_port_range节点服务端口
master_vswitch_ids【该字段已废弃】请使用vswitch_...
0Master节点交换机ID列表
添加
key_pair【该字段已废弃】集群控制面配置请使用c...
login_password【该字段已废弃】集群控制面配置请使用c...
master_count【该字段已废弃】集群控制面配置请使用c...
master_instance_types【该字段已废弃】集群控制面配置请使用c...
0Master节点实例类型
添加
master_system_disk_category【该字段已废弃】集群控制面配置请使用c...
master_system_disk_size【该字段已废弃】集群控制面配置请使用c...
master_system_disk_performance_level【该字段已废弃】集群控制面配置请使用c...
master_system_disk_snapshot_policy_id【该字段已废弃】集群控制面配置请使用c...
master_instance_charge_type【该字段已废弃】集群控制面配置请使用c...
master_period_unit【该字段已废弃】集群控制面配置请使用c...
master_period【该字段已废弃】集群控制面配置请使用c...
master_auto_renew【该字段已废弃】集群控制面配置请使用c...
请选择布尔值
master_auto_renew_period【该字段已废弃】集群控制面配置请使用c...
num_of_nodes【该字段已废弃】节点池配置请使用nod...
vswitch_ids集群节点所在虚拟交换机
0集群节点所在虚拟交换机
添加
worker_vswitch_ids【该字段已废弃】节点池配置请使用nod...
0Worker节点虚拟交换机列表
添加
worker_instance_types【该字段已废弃】节点池配置请使用nod...
0Worker节点实例规格
添加
worker_system_disk_category【该字段已废弃】节点池配置请使用nod...
worker_system_disk_size【该字段已废弃】节点池配置请使用nod...
worker_system_disk_snapshot_policy_id【该字段已废弃】节点池配置请使用nod...
worker_system_disk_performance_level【该字段已废弃】节点池配置请使用nod...
worker_data_disks【该字段已废弃】节点池配置请使用nod...
0数据盘配置集合
category数据盘类型
encrypted是否对数据盘加密
size数据盘大小
performance_level节点数据盘磁盘性能等级
添加
worker_instance_charge_type【该字段已废弃】节点池配置请使用nod...
worker_period_unit【该字段已废弃】节点池配置请使用nod...
worker_period【该字段已废弃】节点池配置请使用nod...
worker_auto_renew【该字段已废弃】节点池配置请使用nod...
请选择布尔值
worker_auto_renew_period【该字段已废弃】节点池配置请使用nod...
instances【该字段已废弃】创建集群时不支持选择已有节点
0使用已有节点创建集群时
添加
format_disk【该字段已废弃】创建集群时不支持选择已有节点
请选择布尔值
keep_instance_name【该字段已废弃】创建集群时不支持选择已有节点
请选择布尔值
service_discovery_types集群内服务发现类型
0集群内服务发现类型
添加
nat_gateway【已废弃】请使用参数snat_entry
请选择布尔值
zone_id【已废弃】请使用zone_ids替代
profile当您选择cluster_type为Ma...
logging_type集群开启日志服务
controlplane_log_ttl控制平面组件日志保存天数
controlplane_log_project控制平面组件日志服务Project
controlplane_log_components组件名称列表
0组件名称列表
添加
deletion_protection集群删除保护
请选择布尔值
disable_rollback【该字段已废弃】集群创建失败时默认不会...
请选择布尔值
timeout_mins【该字段已废弃】集群创建失败时默认不会...
image_type【该字段已废弃】集群控制面配置请使用c...
load_balancer_spec【该参数已废弃】CLB按使用量计费
enable_rrsa是否启用RRSA功能
请选择布尔值
resource_group_id集群所属资源组ID
charge_type【该字段已废弃】
period_unit【该字段已废弃】
period【该字段已废弃】
auto_renew【该字段已废弃】
请选择布尔值
auto_renew_period【该字段已废弃】
ip_stack集群ip_stack
access_control_list注册集群 API Server SLB...
0注册集群 API Server SLB...
添加
nodepools节点池列表
0节点池
auto_scaling自动伸缩节点池配置
enable是否启用自动伸缩
请选择布尔值
max_instances自动伸缩组最大实例数
min_instances自动伸缩组最小实例数
type自动伸缩类型
is_bond_eip【该字段已废弃】
请选择布尔值
eip_internet_charge_type【该字段已废弃】
eip_bandwidth【该字段已废弃】
kubernetes_config集群相关配置
cms_enabled是否在ECS节点上安装云监控
请选择布尔值
cpu_policy节点CPU管理策略
labels节点标签
0标签配置
key标签key值
value标签value值
添加
runtime容器运行时
runtime_version容器运行时版本
taints污点配置
0节点污点配置
key污点key值
value污点value值
effect调度策略
添加
user_data节点自定义数据
node_name_mode节点名称由三部分组成：前缀 + 节点 ...
nodepool_info节点池配置
name节点池名称
resource_group_id节点池所在资源ID
type节点池类型
scaling_group节点池扩容组配置
auto_renew节点池是否开启自动续费
请选择布尔值
auto_renew_period节点池自动续费周期
data_disks节点池节点数据盘配置
0节点数据盘配置
category数据盘类型
size数据盘大小
encrypted是否对数据盘加密
kms_key_id数据盘对应的KMS密钥ID
auto_snapshot_policy_id选择自动快照策略ID
performance_level节点数据盘磁盘性能等级
provisioned_iops数据盘预配置的读写IOPS
bursting_enabled数据盘是否开启Burst（性能突发）
请选择布尔值
auto_format是否挂载
请选择布尔值
file_system挂载文件系统类型
mount_target挂载路径
disk_name数据盘名称
device数据盘的挂载点
snapshot_id创建数据盘时使用的快照
添加
image_id自定义镜像ID
instance_charge_type节点池节点付费类型
instance_types实例规格
0实例规格
添加
key_pair密钥对名称
login_passwordSSH登录密码
login_as_non_root弹出的ECS实例是否使用以非root用户登录
请选择布尔值
period节点池节点包年包月时长
period_unit节点池节点付费周期
platform操作系统发行版
rds_instancesRDS实例列表
0RDS实例ID
添加
spot_strategy抢占式实例类型
spot_price_limit当前单台抢占式实例规格市场价格区间配置
0
instance_type抢占式实例规格
price_limit单台实例上限价格
添加
scaling_policy伸缩组模式
security_group_id节点池安全组ID
security_group_ids安全组ID列表
0安全组ID
添加
system_disk_category节点系统盘类型
system_disk_categories系统盘的多磁盘类型
0节点系统盘类型
添加
system_disk_size节点系统盘大小
system_disk_performance_level节点系统盘磁盘性能
system_disk_encrypted是否加密系统盘
请选择布尔值
system_disk_kms_key_id节点系统盘使用的KMS密钥ID
system_disk_encrypt_algorithm节点系统盘采用的加密算法
system_disk_provisioned_iops节点系统盘预配置的读写IOPS
system_disk_bursting_enabled节点系统盘是否开启Burst（性能突发）
请选择布尔值
tags仅为ECS实例添加标签
0
key标签的名称
value标签值
添加
vswitch_ids虚拟交换机ID
0虚拟交换机ID
添加
multi_az_policy多可用区伸缩组ECS实例扩缩容策略
on_demand_base_capacity伸缩组所需要按量实例个数的最小值
on_demand_percentage_above_base_capacity伸缩组满足最小按量实例数（ondema...
spot_instance_pools指定可用实例规格的个数
spot_instance_remedy是否开启补齐抢占式实例
请选择布尔值
compensate_with_on_demand当multiazpolicy取值为CO...
请选择布尔值
internet_charge_type公网IP收费类型
internet_max_bandwidth_out节点公网IP出带宽最大值
image_type操作系统镜像类型
deploymentset_id部署集ID
desired_size节点池期望节点数量
private_pool_options私有节点池配置
id私有节点池ID
match_criteria私有节点池类型
ram_role_nameWorker RAM角色名称
tee_config加密计算节点池配置
tee_enable是否为加密计算节点池
请选择布尔值
management托管节点池配置
enable是否开启托管版节点池
请选择布尔值
auto_repair自动修复
请选择布尔值
upgrade_config自动升级配置
auto_upgrade是否启用自动升级
请选择布尔值
surge额外节点数量
surge_percentage额外节点比例
max_unavailable最大不可用节点数量
auto_repair_policy自动修复节点策略
restart_node是否允许重启节点
请选择布尔值
auto_vul_fix是否自动修复CVE
请选择布尔值
auto_vul_fix_policy自动修复CVE策略
restart_node是否允许重启节点
请选择布尔值
vul_level允许自动修复的漏洞级别
auto_upgrade是否自动升级
请选择布尔值
auto_upgrade_policy自动升级策略
auto_upgrade_kubelet是否允许自动升级kubelet
请选择布尔值
count【该字段已废弃
interconnect_mode边缘节点池的网络类型
interconnect_config【该字段已废弃】
cen_id【该字段已废弃】
ccn_id【该字段已废弃】
ccn_region_id【该字段已废弃】
bandwidth【该字段已废弃】
improved_period【该字段已废弃】
max_nodes边缘节点池允许容纳的最大节点数量
node_config节点配置
kubelet_configuration支持的kubelet配置
registryPullQPS镜像仓库的QPS上限
registryBurst突发性镜像拉取的个数上限
eventRecordQPS每秒可生成的事件数量
eventBurst事件记录的个数的突发峰值上限
kubeAPIQPS与API Server通信的每秒查询个数
kubeAPIBurst每秒发送到API Server的突发请...
serializeImagePulls是否逐一拉取镜像
请选择布尔值
cpuManagerPolicyCPU管理器策略
evictionHard触发Pod驱逐操作的一组硬性门限
evictionSoft设置一组驱逐阈值
evictionSoftGracePeriod设置一组驱逐宽限期
systemReserved系统预留的资源配置
kubeReservedkubernetes系统预留的资源配置
readOnlyPort只读端口号
maxPods运行的Pod个数上限
containerLogMaxSize日志文件被轮转之前可以到达的最大大小
containerLogMaxFiles每个容器可以存在的日志文件个数上限
featureGates特性开关
allowedUnsafeSysctls允许的sysctl模式白名单
0允许的sysctl模式白名单
添加
reservedMemory为NUMA节点预留内存
0内存资源限制
numaNodeNUMA 节点
limits内存资源限制
添加
memoryManagerPolicy内存管理器要使用的策略
cpuCFSQuotaCPU CFS配额约束开关
请选择布尔值
cpuCFSQuotaPeriodCPU CFS配额周期值
imageGCHighThresholdPercent镜像用量超过此阈值
imageGCLowThresholdPercent镜像用量低于此阈值时不会执行镜像垃圾回收操作
podPidsLimitPod 中可使用的 PID 个数上限
topologyManagerPolicy使用的拓扑管理器策略名称
clusterDNS集群 DNS 服务器的 IP 地址的列表
0集群 DNS 服务器的 IP 地址
添加
tracingOpenTelemetry 追踪客户端...
endpoint采集器的端点
samplingRatePerMillion每百万 span 要采集的样本数
containerLogMaxWorkers指定执行日志轮换操作所需的并发工作程序...
containerLogMonitorInterval指定监视容器日志以执行日志轮转操作的持续时间
添加
zone_ids集群所属地域的多个可用区ID
0集群所属地域的可用区ID
添加
load_balancer_id指定用于APIServer访问的CLB...
maintenance_window集群维护窗口
enable是否开启维护窗口
请选择布尔值
maintenance_time维护起始时间
duration维护时长
weekly_period维护周期
recurrence使用RFC5545 Recurrenc...
operation_policy集群自动运维策略
cluster_auto_upgrade集群自动升级
enabled是否开启集群自动升级
请选择布尔值
channel集群自动升级频次
control_plane_configACK专有集群控制面配置
charge_type控制面节点付费类型
period控制面节点包年包月时间
period_unit控制面节点包年包月时间单位
auto_renew控制面节点是否自动续费
请选择布尔值
auto_renew_period控制面节点自动续费时长
instance_types节点实例类型
0节点实例规格类型
添加
image_type操作系统镜像类型
image_id镜像ID
key_pair密钥对名称
login_passwordSSH登录密码
system_disk_category节点系统盘类型
system_disk_size节点系统盘大小
system_disk_snapshot_policy_id节点自动快照备份策略
system_disk_performance_level节点系统盘磁盘性能
system_disk_provisioned_iops节点系统盘预配置的读写IOPS
system_disk_bursting_enabled节点系统盘是否开启Burst（性能突发）
请选择布尔值
deploymentset_id部署集ID
cloud_monitor_flags是否为节点安装云监控
请选择布尔值
soc_enabled是否开启等保安全加固
请选择布尔值
security_hardening_os是否开启阿里云OS安全加固
请选择布尔值
cpu_policy节点CPU管理策略
runtime运行时名称
node_port_range节点服务端口范围
size控制面节点数量
插件下载了解更多
VS Code 插件
安装插件之前，确保已安装 VS Code安装插件之前，确保已安装 VS Code
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安 装
JetBrains 插件
安装插件之前，确保已安装 JetBrains IDE安装插件之前，确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
安 装

接口说明

通过控制台生成 OpenAPI 请求参数

调用 CreateCluster 接口创建集群时，如果由于请求参数组合不正确导致接口调用失败，您可以通过控制台生成创建集群所需的请求参数组合。具体操作如下：

  1. 登录容器服务管理控制台，在左侧导航栏选择集群列表。

  2. 在集群列表页面，单击集群模板。

  3. 在对话框，选择需要创建的集群类型，并单击创建，然后在集群配置页面配置集群信息。

  4. 配置完成后，在确认配置页面，单击左上角的生成 OpenAPI 请求参数。

    对话框将展示您创建集群时所需的参数组合，您可以复制使用。

请求语法

POST /clusters HTTP/1.1

请求参数

字段名称字段详情
bodyobject

请求体参数。

示例值:cluster-demo

返回参数

字段名称字段详情
cluster_idstring

集群 ID。

示例值:cb95aa626a47740afbf6aa099b650****
request_idstring

请求 ID。

示例值:687C5BAA-D103-4993-884B-C35E4314****
task_idstring

任务 ID。

示例值:T-5a54309c80282e39ea****
变更历史
变更时间变更内容概要操作
2024-11-19
变更请求参数body
2024-10-15
变更请求参数body
2024-09-13
变更请求参数body
2024-09-11
变更请求参数body
2024-09-04
变更请求参数body