@alicloud/cs20151215 6.6.4 → 6.6.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (269) hide show
  1. package/dist/client.d.ts +202 -124
  2. package/dist/client.js +202 -124
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/AttachInstancesRequest.d.ts +2 -2
  5. package/dist/models/AttachInstancesResponseBody.d.ts +1 -1
  6. package/dist/models/AttachInstancesToNodePoolRequest.d.ts +1 -1
  7. package/dist/models/AttachInstancesToNodePoolResponseBody.d.ts +1 -1
  8. package/dist/models/ContainerdConfig.d.ts +22 -2
  9. package/dist/models/ContainerdConfig.js.map +1 -1
  10. package/dist/models/CreateAutoRepairPolicyRequest.d.ts +63 -0
  11. package/dist/models/CreateAutoRepairPolicyRequest.js.map +1 -1
  12. package/dist/models/CreateAutoRepairPolicyResponseBody.d.ts +6 -0
  13. package/dist/models/CreateAutoRepairPolicyResponseBody.js.map +1 -1
  14. package/dist/models/CreateAutoscalingConfigRequest.d.ts +77 -40
  15. package/dist/models/CreateAutoscalingConfigRequest.js.map +1 -1
  16. package/dist/models/CreateClusterNodePoolRequest.d.ts +123 -25
  17. package/dist/models/CreateClusterNodePoolRequest.js +2 -0
  18. package/dist/models/CreateClusterNodePoolRequest.js.map +1 -1
  19. package/dist/models/CreateClusterRequest.d.ts +585 -353
  20. package/dist/models/CreateClusterRequest.js.map +1 -1
  21. package/dist/models/CreateClusterResponseBody.d.ts +5 -5
  22. package/dist/models/CreateTriggerResponseBody.d.ts +1 -1
  23. package/dist/models/DeleteAlertContactRequest.d.ts +1 -1
  24. package/dist/models/DeleteAlertContactShrinkRequest.d.ts +1 -1
  25. package/dist/models/DeleteAutoRepairPolicyResponseBody.d.ts +3 -0
  26. package/dist/models/DeleteAutoRepairPolicyResponseBody.js.map +1 -1
  27. package/dist/models/DeleteClusterNodepoolResponseBody.d.ts +2 -2
  28. package/dist/models/DeleteClusterNodesRequest.d.ts +1 -1
  29. package/dist/models/DeleteClusterNodesResponseBody.d.ts +3 -3
  30. package/dist/models/DeleteClusterRequest.d.ts +26 -18
  31. package/dist/models/DeleteClusterRequest.js.map +1 -1
  32. package/dist/models/DeleteClusterResponseBody.d.ts +2 -2
  33. package/dist/models/DeleteClusterShrinkRequest.d.ts +12 -9
  34. package/dist/models/DeleteClusterShrinkRequest.js.map +1 -1
  35. package/dist/models/DeployPolicyInstanceRequest.d.ts +7 -6
  36. package/dist/models/DeployPolicyInstanceRequest.js.map +1 -1
  37. package/dist/models/DeployPolicyInstanceResponseBody.d.ts +1 -1
  38. package/dist/models/DescribeAddonsRequest.d.ts +1 -1
  39. package/dist/models/DescribeAutoRepairPolicyResponseBody.d.ts +71 -0
  40. package/dist/models/DescribeAutoRepairPolicyResponseBody.js.map +1 -1
  41. package/dist/models/DescribeClusterAttachScriptsRequest.d.ts +21 -18
  42. package/dist/models/DescribeClusterAttachScriptsRequest.js.map +1 -1
  43. package/dist/models/DescribeClusterDetailResponseBody.d.ts +243 -110
  44. package/dist/models/DescribeClusterDetailResponseBody.js.map +1 -1
  45. package/dist/models/DescribeClusterEventsRequest.d.ts +8 -4
  46. package/dist/models/DescribeClusterEventsRequest.js.map +1 -1
  47. package/dist/models/DescribeClusterEventsResponseBody.d.ts +49 -39
  48. package/dist/models/DescribeClusterEventsResponseBody.js.map +1 -1
  49. package/dist/models/DescribeClusterLogsResponse.d.ts +3 -3
  50. package/dist/models/DescribeClusterNodePoolDetailResponseBody.d.ts +473 -220
  51. package/dist/models/DescribeClusterNodePoolDetailResponseBody.js +2 -0
  52. package/dist/models/DescribeClusterNodePoolDetailResponseBody.js.map +1 -1
  53. package/dist/models/DescribeClusterNodePoolsResponseBody.d.ts +425 -262
  54. package/dist/models/DescribeClusterNodePoolsResponseBody.js +2 -0
  55. package/dist/models/DescribeClusterNodePoolsResponseBody.js.map +1 -1
  56. package/dist/models/DescribeClusterNodesRequest.d.ts +1 -1
  57. package/dist/models/DescribeClusterNodesResponseBody.d.ts +5 -5
  58. package/dist/models/DescribeClusterResourcesRequest.d.ts +5 -1
  59. package/dist/models/DescribeClusterResourcesRequest.js.map +1 -1
  60. package/dist/models/DescribeClusterResourcesResponse.d.ts +51 -33
  61. package/dist/models/DescribeClusterResourcesResponse.js.map +1 -1
  62. package/dist/models/DescribeClusterTasksResponseBody.d.ts +9 -9
  63. package/dist/models/DescribeClusterUserKubeconfigRequest.d.ts +1 -1
  64. package/dist/models/DescribeClusterUserKubeconfigResponseBody.d.ts +1 -1
  65. package/dist/models/DescribeClusterVulsResponseBody.d.ts +2 -2
  66. package/dist/models/DescribeClustersForRegionRequest.d.ts +32 -16
  67. package/dist/models/DescribeClustersForRegionRequest.js.map +1 -1
  68. package/dist/models/DescribeClustersForRegionResponseBody.d.ts +85 -56
  69. package/dist/models/DescribeClustersForRegionResponseBody.js.map +1 -1
  70. package/dist/models/DescribeClustersV1request.d.ts +33 -17
  71. package/dist/models/DescribeClustersV1request.js.map +1 -1
  72. package/dist/models/DescribeClustersV1responseBody.d.ts +98 -72
  73. package/dist/models/DescribeClustersV1responseBody.js.map +1 -1
  74. package/dist/models/DescribeEventsForRegionRequest.d.ts +6 -2
  75. package/dist/models/DescribeEventsForRegionRequest.js.map +1 -1
  76. package/dist/models/DescribeEventsForRegionResponseBody.d.ts +22 -15
  77. package/dist/models/DescribeEventsForRegionResponseBody.js.map +1 -1
  78. package/dist/models/DescribeEventsRequest.d.ts +53 -20
  79. package/dist/models/DescribeEventsRequest.js.map +1 -1
  80. package/dist/models/DescribeEventsResponseBody.d.ts +53 -29
  81. package/dist/models/DescribeEventsResponseBody.js.map +1 -1
  82. package/dist/models/DescribeKubernetesVersionMetadataRequest.d.ts +2 -2
  83. package/dist/models/DescribeKubernetesVersionMetadataResponse.d.ts +8 -8
  84. package/dist/models/DescribeNodePoolVulsResponseBody.d.ts +11 -0
  85. package/dist/models/DescribeNodePoolVulsResponseBody.js.map +1 -1
  86. package/dist/models/DescribePolicyDetailsResponseBody.d.ts +1 -1
  87. package/dist/models/DescribePolicyGovernanceInClusterResponseBody.d.ts +235 -7
  88. package/dist/models/DescribePolicyGovernanceInClusterResponseBody.js.map +1 -1
  89. package/dist/models/DescribeResourcesDeleteProtectionResponse.d.ts +1 -1
  90. package/dist/models/DescribeSubaccountK8sClusterUserConfigRequest.d.ts +1 -1
  91. package/dist/models/DescribeSubaccountK8sClusterUserConfigResponseBody.d.ts +2 -2
  92. package/dist/models/DescribeTaskInfoResponseBody.d.ts +35 -31
  93. package/dist/models/DescribeTaskInfoResponseBody.js.map +1 -1
  94. package/dist/models/DescribeTemplateAttributeResponse.d.ts +2 -2
  95. package/dist/models/DescribeTemplatesResponseBody.d.ts +4 -4
  96. package/dist/models/DescribeTriggerResponse.d.ts +1 -1
  97. package/dist/models/DescribeUserPermissionResponse.d.ts +1 -1
  98. package/dist/models/DescribeUserQuotaResponseBody.d.ts +0 -35
  99. package/dist/models/DescribeUserQuotaResponseBody.js.map +1 -1
  100. package/dist/models/GetClusterAddonInstanceResponseBody.d.ts +1 -1
  101. package/dist/models/GetClusterInspectReportDetailResponseBody.d.ts +9 -0
  102. package/dist/models/GetClusterInspectReportDetailResponseBody.js.map +1 -1
  103. package/dist/models/GrantPermissionsRequest.d.ts +28 -20
  104. package/dist/models/GrantPermissionsRequest.js.map +1 -1
  105. package/dist/models/InstallClusterAddonsRequest.d.ts +2 -2
  106. package/dist/models/InstanceMetadataOptions.d.ts +17 -0
  107. package/dist/models/InstanceMetadataOptions.js.map +1 -1
  108. package/dist/models/KubeletConfig.d.ts +10 -0
  109. package/dist/models/KubeletConfig.js.map +1 -1
  110. package/dist/models/ListAddonsRequest.d.ts +1 -1
  111. package/dist/models/ListAutoRepairPoliciesResponseBody.d.ts +75 -0
  112. package/dist/models/ListAutoRepairPoliciesResponseBody.js.map +1 -1
  113. package/dist/models/ListClusterChecksResponseBody.d.ts +2 -2
  114. package/dist/models/ListClusterKubeconfigStatesRequest.d.ts +10 -0
  115. package/dist/models/ListClusterKubeconfigStatesRequest.js.map +1 -1
  116. package/dist/models/ListClusterKubeconfigStatesResponseBody.d.ts +39 -0
  117. package/dist/models/ListClusterKubeconfigStatesResponseBody.js.map +1 -1
  118. package/dist/models/ListOperationPlansForRegionRequest.d.ts +9 -0
  119. package/dist/models/ListOperationPlansForRegionRequest.js.map +1 -1
  120. package/dist/models/ListOperationPlansForRegionResponseBody.d.ts +52 -0
  121. package/dist/models/ListOperationPlansForRegionResponseBody.js.map +1 -1
  122. package/dist/models/ListUserKubeConfigStatesResponseBody.d.ts +1 -1
  123. package/dist/models/MaintenanceWindow.d.ts +1 -1
  124. package/dist/models/MigrateClusterResponseBody.d.ts +3 -3
  125. package/dist/models/ModifyAutoRepairPolicyRequest.d.ts +58 -0
  126. package/dist/models/ModifyAutoRepairPolicyRequest.js.map +1 -1
  127. package/dist/models/ModifyAutoRepairPolicyResponseBody.d.ts +3 -0
  128. package/dist/models/ModifyAutoRepairPolicyResponseBody.js.map +1 -1
  129. package/dist/models/ModifyClusterNodePoolRequest.d.ts +358 -228
  130. package/dist/models/ModifyClusterNodePoolRequest.js +2 -0
  131. package/dist/models/ModifyClusterNodePoolRequest.js.map +1 -1
  132. package/dist/models/ModifyClusterNodePoolResponseBody.d.ts +1 -1
  133. package/dist/models/ModifyClusterRequest.d.ts +186 -123
  134. package/dist/models/ModifyClusterRequest.js.map +1 -1
  135. package/dist/models/ModifyNodePoolNodeConfigRequest.d.ts +8 -0
  136. package/dist/models/ModifyNodePoolNodeConfigRequest.js.map +1 -1
  137. package/dist/models/ModifyNodePoolNodeConfigResponseBody.d.ts +2 -2
  138. package/dist/models/Nodepool.d.ts +274 -180
  139. package/dist/models/Nodepool.js +2 -0
  140. package/dist/models/Nodepool.js.map +1 -1
  141. package/dist/models/OpenAckServiceResponseBody.d.ts +1 -1
  142. package/dist/models/RemoveClusterNodesRequest.d.ts +0 -10
  143. package/dist/models/RemoveClusterNodesRequest.js.map +1 -1
  144. package/dist/models/RemoveNodePoolNodesResponseBody.d.ts +1 -1
  145. package/dist/models/RepairClusterNodePoolRequest.d.ts +1 -1
  146. package/dist/models/RepairClusterNodePoolResponseBody.d.ts +2 -2
  147. package/dist/models/RunClusterCheckRequest.d.ts +2 -2
  148. package/dist/models/RunClusterCheckResponseBody.d.ts +2 -2
  149. package/dist/models/Runtime.d.ts +2 -2
  150. package/dist/models/ScaleOutClusterRequest.d.ts +8 -131
  151. package/dist/models/ScaleOutClusterRequest.js.map +1 -1
  152. package/dist/models/ScaleOutClusterResponseBody.d.ts +0 -21
  153. package/dist/models/ScaleOutClusterResponseBody.js.map +1 -1
  154. package/dist/models/ScanClusterVulsResponseBody.d.ts +1 -1
  155. package/dist/models/UnInstallClusterAddonsResponseBody.d.ts +3 -3
  156. package/dist/models/UpdateClusterAuditLogConfigResponseBody.d.ts +1 -1
  157. package/dist/models/UpdateK8sClusterUserConfigExpireRequest.d.ts +1 -1
  158. package/dist/models/UpgradeClusterAddonsRequest.d.ts +3 -3
  159. package/dist/models/UpgradeClusterAddonsResponseBody.d.ts +1 -1
  160. package/dist/models/UpgradeClusterNodepoolRequest.d.ts +5 -5
  161. package/dist/models/UpgradeClusterNodepoolResponseBody.d.ts +1 -1
  162. package/dist/models/UpgradeClusterRequest.d.ts +3 -3
  163. package/package.json +1 -1
  164. package/src/client.ts +202 -124
  165. package/src/models/AttachInstancesRequest.ts +2 -2
  166. package/src/models/AttachInstancesResponseBody.ts +1 -1
  167. package/src/models/AttachInstancesToNodePoolRequest.ts +1 -1
  168. package/src/models/AttachInstancesToNodePoolResponseBody.ts +1 -1
  169. package/src/models/ContainerdConfig.ts +22 -2
  170. package/src/models/CreateAutoRepairPolicyRequest.ts +63 -0
  171. package/src/models/CreateAutoRepairPolicyResponseBody.ts +6 -0
  172. package/src/models/CreateAutoscalingConfigRequest.ts +77 -40
  173. package/src/models/CreateClusterNodePoolRequest.ts +125 -25
  174. package/src/models/CreateClusterRequest.ts +585 -353
  175. package/src/models/CreateClusterResponseBody.ts +5 -5
  176. package/src/models/CreateTriggerResponseBody.ts +1 -1
  177. package/src/models/DeleteAlertContactRequest.ts +1 -1
  178. package/src/models/DeleteAlertContactShrinkRequest.ts +1 -1
  179. package/src/models/DeleteAutoRepairPolicyResponseBody.ts +3 -0
  180. package/src/models/DeleteClusterNodepoolResponseBody.ts +2 -2
  181. package/src/models/DeleteClusterNodesRequest.ts +1 -1
  182. package/src/models/DeleteClusterNodesResponseBody.ts +3 -3
  183. package/src/models/DeleteClusterRequest.ts +26 -18
  184. package/src/models/DeleteClusterResponseBody.ts +2 -2
  185. package/src/models/DeleteClusterShrinkRequest.ts +12 -9
  186. package/src/models/DeployPolicyInstanceRequest.ts +7 -6
  187. package/src/models/DeployPolicyInstanceResponseBody.ts +1 -1
  188. package/src/models/DescribeAddonsRequest.ts +1 -1
  189. package/src/models/DescribeAutoRepairPolicyResponseBody.ts +71 -0
  190. package/src/models/DescribeClusterAttachScriptsRequest.ts +21 -18
  191. package/src/models/DescribeClusterDetailResponseBody.ts +243 -110
  192. package/src/models/DescribeClusterEventsRequest.ts +8 -4
  193. package/src/models/DescribeClusterEventsResponseBody.ts +49 -39
  194. package/src/models/DescribeClusterLogsResponse.ts +3 -3
  195. package/src/models/DescribeClusterNodePoolDetailResponseBody.ts +475 -220
  196. package/src/models/DescribeClusterNodePoolsResponseBody.ts +427 -262
  197. package/src/models/DescribeClusterNodesRequest.ts +1 -1
  198. package/src/models/DescribeClusterNodesResponseBody.ts +5 -5
  199. package/src/models/DescribeClusterResourcesRequest.ts +5 -1
  200. package/src/models/DescribeClusterResourcesResponse.ts +51 -33
  201. package/src/models/DescribeClusterTasksResponseBody.ts +9 -9
  202. package/src/models/DescribeClusterUserKubeconfigRequest.ts +1 -1
  203. package/src/models/DescribeClusterUserKubeconfigResponseBody.ts +1 -1
  204. package/src/models/DescribeClusterVulsResponseBody.ts +2 -2
  205. package/src/models/DescribeClustersForRegionRequest.ts +32 -16
  206. package/src/models/DescribeClustersForRegionResponseBody.ts +85 -56
  207. package/src/models/DescribeClustersV1request.ts +33 -17
  208. package/src/models/DescribeClustersV1responseBody.ts +98 -72
  209. package/src/models/DescribeEventsForRegionRequest.ts +6 -2
  210. package/src/models/DescribeEventsForRegionResponseBody.ts +22 -15
  211. package/src/models/DescribeEventsRequest.ts +53 -20
  212. package/src/models/DescribeEventsResponseBody.ts +53 -29
  213. package/src/models/DescribeKubernetesVersionMetadataRequest.ts +2 -2
  214. package/src/models/DescribeKubernetesVersionMetadataResponse.ts +8 -8
  215. package/src/models/DescribeNodePoolVulsResponseBody.ts +11 -0
  216. package/src/models/DescribePolicyDetailsResponseBody.ts +1 -1
  217. package/src/models/DescribePolicyGovernanceInClusterResponseBody.ts +235 -7
  218. package/src/models/DescribeResourcesDeleteProtectionResponse.ts +1 -1
  219. package/src/models/DescribeSubaccountK8sClusterUserConfigRequest.ts +1 -1
  220. package/src/models/DescribeSubaccountK8sClusterUserConfigResponseBody.ts +2 -2
  221. package/src/models/DescribeTaskInfoResponseBody.ts +35 -31
  222. package/src/models/DescribeTemplateAttributeResponse.ts +2 -2
  223. package/src/models/DescribeTemplatesResponseBody.ts +4 -4
  224. package/src/models/DescribeTriggerResponse.ts +1 -1
  225. package/src/models/DescribeUserPermissionResponse.ts +1 -1
  226. package/src/models/DescribeUserQuotaResponseBody.ts +0 -35
  227. package/src/models/GetClusterAddonInstanceResponseBody.ts +1 -1
  228. package/src/models/GetClusterInspectReportDetailResponseBody.ts +9 -0
  229. package/src/models/GrantPermissionsRequest.ts +28 -20
  230. package/src/models/InstallClusterAddonsRequest.ts +2 -2
  231. package/src/models/InstanceMetadataOptions.ts +17 -0
  232. package/src/models/KubeletConfig.ts +10 -0
  233. package/src/models/ListAddonsRequest.ts +1 -1
  234. package/src/models/ListAutoRepairPoliciesResponseBody.ts +75 -0
  235. package/src/models/ListClusterChecksResponseBody.ts +2 -2
  236. package/src/models/ListClusterKubeconfigStatesRequest.ts +10 -0
  237. package/src/models/ListClusterKubeconfigStatesResponseBody.ts +39 -0
  238. package/src/models/ListOperationPlansForRegionRequest.ts +9 -0
  239. package/src/models/ListOperationPlansForRegionResponseBody.ts +52 -0
  240. package/src/models/ListUserKubeConfigStatesResponseBody.ts +1 -1
  241. package/src/models/MaintenanceWindow.ts +1 -1
  242. package/src/models/MigrateClusterResponseBody.ts +3 -3
  243. package/src/models/ModifyAutoRepairPolicyRequest.ts +58 -0
  244. package/src/models/ModifyAutoRepairPolicyResponseBody.ts +3 -0
  245. package/src/models/ModifyClusterNodePoolRequest.ts +361 -229
  246. package/src/models/ModifyClusterNodePoolResponseBody.ts +1 -1
  247. package/src/models/ModifyClusterRequest.ts +186 -123
  248. package/src/models/ModifyNodePoolNodeConfigRequest.ts +8 -0
  249. package/src/models/ModifyNodePoolNodeConfigResponseBody.ts +2 -2
  250. package/src/models/Nodepool.ts +276 -180
  251. package/src/models/OpenAckServiceResponseBody.ts +1 -1
  252. package/src/models/RemoveClusterNodesRequest.ts +0 -10
  253. package/src/models/RemoveNodePoolNodesResponseBody.ts +1 -1
  254. package/src/models/RepairClusterNodePoolRequest.ts +1 -1
  255. package/src/models/RepairClusterNodePoolResponseBody.ts +2 -2
  256. package/src/models/RunClusterCheckRequest.ts +2 -2
  257. package/src/models/RunClusterCheckResponseBody.ts +2 -2
  258. package/src/models/Runtime.ts +2 -2
  259. package/src/models/ScaleOutClusterRequest.ts +8 -131
  260. package/src/models/ScaleOutClusterResponseBody.ts +0 -21
  261. package/src/models/ScanClusterVulsResponseBody.ts +1 -1
  262. package/src/models/UnInstallClusterAddonsResponseBody.ts +3 -3
  263. package/src/models/UpdateClusterAuditLogConfigResponseBody.ts +1 -1
  264. package/src/models/UpdateK8sClusterUserConfigExpireRequest.ts +1 -1
  265. package/src/models/UpgradeClusterAddonsRequest.ts +3 -3
  266. package/src/models/UpgradeClusterAddonsResponseBody.ts +1 -1
  267. package/src/models/UpgradeClusterNodepoolRequest.ts +5 -5
  268. package/src/models/UpgradeClusterNodepoolResponseBody.ts +1 -1
  269. package/src/models/UpgradeClusterRequest.ts +3 -3
@@ -10,7 +10,29 @@ import { InstanceMetadataOptions } from "./InstanceMetadataOptions";
10
10
 
11
11
 
12
12
  export class CreateClusterRequestAuditLogConfig extends $dara.Model {
13
+ /**
14
+ * @remarks
15
+ * Whether to enable cluster audit logging.
16
+ *
17
+ * - true: Enable.
18
+ *
19
+ * - false: Disable.
20
+ *
21
+ * @example
22
+ * true
23
+ */
13
24
  enabled?: boolean;
25
+ /**
26
+ * @remarks
27
+ * The [SLS Project](https://help.aliyun.com/document_detail/48873.html) containing the [Logstore](https://help.aliyun.com/document_detail/48873.html) for cluster audit logs.
28
+ *
29
+ * - Default value: `k8s-log-{clusterid}`.
30
+ *
31
+ * - When audit logging is enabled, a Logstore for audit logs is created in the specified SLS Project.
32
+ *
33
+ * @example
34
+ * k8s-log-c2345xxxxxxxxxxxx
35
+ */
14
36
  slsProjectName?: string;
15
37
  static names(): { [key: string]: string } {
16
38
  return {
@@ -36,6 +58,17 @@ export class CreateClusterRequestAuditLogConfig extends $dara.Model {
36
58
  }
37
59
 
38
60
  export class CreateClusterRequestAutoMode extends $dara.Model {
61
+ /**
62
+ * @remarks
63
+ * Whether to enable Intelligent Managed Mode.
64
+ *
65
+ * - true: Enable.
66
+ *
67
+ * - false: Disable.
68
+ *
69
+ * @example
70
+ * true
71
+ */
39
72
  enable?: boolean;
40
73
  static names(): { [key: string]: string } {
41
74
  return {
@@ -61,7 +94,13 @@ export class CreateClusterRequestAutoMode extends $dara.Model {
61
94
  export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
62
95
  /**
63
96
  * @remarks
64
- * Specifies whether to enable auto-renewal for the node.
97
+ * Whether to enable auto-renewal for control plane nodes. Valid only when charge_type is `PrePaid`.
98
+ *
99
+ * - true: Enable auto-renewal.
100
+ *
101
+ * - false: Disable auto-renewal.
102
+ *
103
+ * Default value: true.
65
104
  *
66
105
  * @example
67
106
  * true
@@ -69,7 +108,11 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
69
108
  autoRenew?: boolean;
70
109
  /**
71
110
  * @remarks
72
- * The auto-renewal duration for the node.
111
+ * Auto-renewal duration for control plane nodes in months.
112
+ *
113
+ * Valid values: {1, 2, 3, 6, 12}.
114
+ *
115
+ * Default value: 1.
73
116
  *
74
117
  * @example
75
118
  * 1
@@ -77,23 +120,41 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
77
120
  autoRenewPeriod?: number;
78
121
  /**
79
122
  * @remarks
80
- * The billing method of the node.
123
+ * Control plane node billing type.
124
+ *
125
+ * - `PrePaid`: Subscription.
126
+ *
127
+ * - `PostPaid`: Pay-as-you-go.
128
+ *
129
+ * Default value: `PostPaid`.
81
130
  *
82
131
  * @example
83
- * PrePaid
132
+ * PostPaid
84
133
  */
85
134
  chargeType?: string;
86
135
  /**
87
136
  * @remarks
88
- * Specifies whether to install CloudMonitor on the node.
137
+ * Whether to install Cloud Monitor on nodes.
138
+ *
139
+ * - true: Install the CloudMonitor agent.
140
+ *
141
+ * - false: Do not install the CloudMonitor agent.
142
+ *
143
+ * Default value: false.
89
144
  *
90
145
  * @example
91
- * true
146
+ * false
92
147
  */
93
148
  cloudMonitorFlags?: boolean;
94
149
  /**
95
150
  * @remarks
96
- * The CPU management policy of the node.
151
+ * Node CPU management policy.
152
+ *
153
+ * - static: Enhances CPU affinity and exclusivity for pods with specific resource characteristics on the node.
154
+ *
155
+ * - none: Uses the default CPU affinity scheme.
156
+ *
157
+ * Default value: none.
97
158
  *
98
159
  * @example
99
160
  * none
@@ -101,7 +162,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
101
162
  cpuPolicy?: string;
102
163
  /**
103
164
  * @remarks
104
- * The ID of the deployment set.
165
+ * Deployment set ID.
105
166
  *
106
167
  * @example
107
168
  * ds-bp10b35imuam5amw****
@@ -109,7 +170,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
109
170
  deploymentsetId?: string;
110
171
  /**
111
172
  * @remarks
112
- * The image ID.
173
+ * Image ID.
113
174
  *
114
175
  * @example
115
176
  * aliyun_3_x64_20G_alibase_20240819.vhd
@@ -117,21 +178,25 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
117
178
  imageId?: string;
118
179
  /**
119
180
  * @remarks
120
- * The type of the OS image.
181
+ * Operating system image type.
121
182
  *
122
183
  * @example
123
184
  * AliyunLinux3
124
185
  */
125
186
  imageType?: string;
187
+ /**
188
+ * @remarks
189
+ * ECS instance metadata access configuration.
190
+ */
126
191
  instanceMetadataOptions?: InstanceMetadataOptions;
127
192
  /**
128
193
  * @remarks
129
- * The instance types of the nodes.
194
+ * Node instance types.
130
195
  */
131
196
  instanceTypes?: string[];
132
197
  /**
133
198
  * @remarks
134
- * The name of the key pair. You must set this parameter or login_password.
199
+ * Key pair name. Choose either this parameter or login_password.
135
200
  *
136
201
  * @example
137
202
  * ack
@@ -139,15 +204,15 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
139
204
  keyPair?: string;
140
205
  /**
141
206
  * @remarks
142
- * The SSH logon password. The password must be 8 to 30 characters in length and contain a minimum of three of the following character types: uppercase letters, lowercase letters, digits, and special characters. You must set this parameter or key_pair.
207
+ * SSH login password. Password rules: 830 characters, containing at least three of the following: uppercase letters, lowercase letters, digits, and special characters. Choose either this parameter or key_pair.
143
208
  *
144
209
  * @example
145
- * ack@Test
210
+ * ********
146
211
  */
147
212
  loginPassword?: string;
148
213
  /**
149
214
  * @remarks
150
- * The node port range.
215
+ * **[Deprecated]** Node service port range.
151
216
  *
152
217
  * @example
153
218
  * 30000-32767
@@ -155,7 +220,11 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
155
220
  nodePortRange?: string;
156
221
  /**
157
222
  * @remarks
158
- * The subscription duration of the node.
223
+ * Subscription duration for control plane nodes in months. Required and valid only when charge_type is `PrePaid`.
224
+ *
225
+ * Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.
226
+ *
227
+ * Default value: 1.
159
228
  *
160
229
  * @example
161
230
  * 1
@@ -163,7 +232,9 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
163
232
  period?: number;
164
233
  /**
165
234
  * @remarks
166
- * The unit of the subscription duration of the node.
235
+ * Billing cycle unit for control plane nodes. Required and valid only when charge_type is `PrePaid`.
236
+ *
237
+ * Valid value: `Month`. Only monthly billing is supported.
167
238
  *
168
239
  * @example
169
240
  * Month
@@ -171,7 +242,9 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
171
242
  periodUnit?: string;
172
243
  /**
173
244
  * @remarks
174
- * The container runtime.
245
+ * **[Deprecated]** Control plane node runtime name. Valid value:
246
+ *
247
+ * containerd: Containerd runtime, supported for all cluster versions.
175
248
  *
176
249
  * @example
177
250
  * containerd
@@ -179,15 +252,23 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
179
252
  runtime?: string;
180
253
  /**
181
254
  * @remarks
182
- * Specifies whether to enable Alibaba Cloud Linux Security Hardening.
255
+ * Whether to enable Alibaba Cloud OS security hardening.
256
+ *
257
+ * - true: Enable Alibaba Cloud OS security hardening.
258
+ *
259
+ * - false: Disable Alibaba Cloud OS security hardening.
260
+ *
261
+ * Default value: false.
183
262
  *
184
263
  * @example
185
- * true
264
+ * false
186
265
  */
187
266
  securityHardeningOs?: boolean;
188
267
  /**
189
268
  * @remarks
190
- * The number of control plane nodes.
269
+ * Number of control plane nodes.
270
+ *
271
+ * Valid values: `3` or `5`.
191
272
  *
192
273
  * @example
193
274
  * 3
@@ -195,15 +276,27 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
195
276
  size?: number;
196
277
  /**
197
278
  * @remarks
198
- * Specifies whether to enable MLPS security hardening.
279
+ * Whether to enable MLPS 2.0 security hardening.
280
+ *
281
+ * - true: Enable MLPS 2.0 security hardening.
282
+ *
283
+ * - false: Disable MLPS 2.0 security hardening.
284
+ *
285
+ * Default value: false.
199
286
  *
200
287
  * @example
201
- * true
288
+ * false
202
289
  */
203
290
  socEnabled?: boolean;
204
291
  /**
205
292
  * @remarks
206
- * Specifies whether to enable the burst feature for the system disk.
293
+ * Whether to enable performance burst for node system disks.
294
+ *
295
+ * - true: Enable.
296
+ *
297
+ * - false: Disable.
298
+ *
299
+ * This parameter is supported only when `system_disk_category` is `cloud_auto`.
207
300
  *
208
301
  * @example
209
302
  * true
@@ -211,15 +304,29 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
211
304
  systemDiskBurstingEnabled?: boolean;
212
305
  /**
213
306
  * @remarks
214
- * The system disk category for the node.
307
+ * Node system disk type.
308
+ *
309
+ * - `cloud_efficiency`: Ultra disk.
310
+ *
311
+ * - `cloud_ssd`: Standard SSD.
312
+ *
313
+ * - `cloud_essd`: ESSD.
314
+ *
315
+ * - `cloud_auto`: ESSD AutoPL.
316
+ *
317
+ * - `cloud_essd_entry`: ESSD Entry.
318
+ *
319
+ * Default value: `cloud_ssd`. The default may vary by zone.
215
320
  *
216
321
  * @example
217
- * cloud_essd
322
+ * cloud_ssd
218
323
  */
219
324
  systemDiskCategory?: string;
220
325
  /**
221
326
  * @remarks
222
- * The PL of the system disk that you want to use for the node. This parameter takes effect only for ESSDs.
327
+ * Node system disk performance level. Applies only to ESSD disks.
328
+ *
329
+ * Disk performance levels depend on disk size. For more information, see [ESSD](https://help.aliyun.com/document_detail/122389.html).
223
330
  *
224
331
  * @example
225
332
  * PL1
@@ -227,7 +334,11 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
227
334
  systemDiskPerformanceLevel?: string;
228
335
  /**
229
336
  * @remarks
230
- * The preset read/write IOPS of the system disk.
337
+ * Provisioned read/write IOPS for node system disks.
338
+ *
339
+ * Valid range: 0 to min{50,000, 1000 × capacity - baseline performance}. Baseline performance = min{1,800 + 50 × capacity, 50,000}.
340
+ *
341
+ * This parameter is supported only when `system_disk_category` is `cloud_auto`.
231
342
  *
232
343
  * @example
233
344
  * 1000
@@ -235,7 +346,11 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
235
346
  systemDiskProvisionedIops?: number;
236
347
  /**
237
348
  * @remarks
238
- * The system disk size of the node. The value must be at least 40 GB.
349
+ * Node system disk size in GiB.
350
+ *
351
+ * Valid range: [40,500].
352
+ *
353
+ * Default value: `120`.
239
354
  *
240
355
  * @example
241
356
  * 120
@@ -243,7 +358,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
243
358
  systemDiskSize?: number;
244
359
  /**
245
360
  * @remarks
246
- * The automatic snapshot policy of the node.
361
+ * Automatic snapshot backup policy for node system disks.
247
362
  *
248
363
  * @example
249
364
  * sp-2zej1nogjvovnz4z****
@@ -325,6 +440,10 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
325
440
  }
326
441
 
327
442
  export class CreateClusterRequestControlPlaneEndpointsConfigInternalDnsConfig extends $dara.Model {
443
+ /**
444
+ * @remarks
445
+ * VPCs where the internal domain name resolution takes effect.
446
+ */
328
447
  bindVpcs?: string[];
329
448
  static names(): { [key: string]: string } {
330
449
  return {
@@ -351,6 +470,10 @@ export class CreateClusterRequestControlPlaneEndpointsConfigInternalDnsConfig ex
351
470
  }
352
471
 
353
472
  export class CreateClusterRequestControlPlaneEndpointsConfig extends $dara.Model {
473
+ /**
474
+ * @remarks
475
+ * Internal domain name configuration for the cluster, applicable to ACK managed clusters. Internal domain names allow node-side system components such as kubelet and kube-proxy to access the API Server. Without internal domain name access, node-side components access the API Server through the CLB IP address.
476
+ */
354
477
  internalDnsConfig?: CreateClusterRequestControlPlaneEndpointsConfigInternalDnsConfig;
355
478
  static names(): { [key: string]: string } {
356
479
  return {
@@ -379,19 +502,25 @@ export class CreateClusterRequestControlPlaneEndpointsConfig extends $dara.Model
379
502
  export class CreateClusterRequestOperationPolicyClusterAutoUpgrade extends $dara.Model {
380
503
  /**
381
504
  * @remarks
382
- * The automatic update frequency. Valid values:
505
+ * Cluster automatic upgrade frequency. Valid values:
506
+ *
507
+ * - patch: Automatically upgrade to the latest patch version within the current minor version. New Kubernetes versions do not include breaking changes.
508
+ *
509
+ * - stable: Automatically upgrade to the latest patch version of the second-newest minor version. New Kubernetes versions may include API and feature changes but have undergone extensive stability validation.
383
510
  *
384
- * * patch
385
- * * stable
386
- * * rapid
511
+ * - rapid: Automatically upgrade to the latest patch version of the newest minor version to quickly access new Kubernetes community features.
387
512
  *
388
513
  * @example
389
- * patch
514
+ * stable
390
515
  */
391
516
  channel?: string;
392
517
  /**
393
518
  * @remarks
394
- * Specifies whether to enable auto cluster update.
519
+ * Whether to enable cluster automatic upgrade.
520
+ *
521
+ * - true: Enable.
522
+ *
523
+ * - false: Disable.
395
524
  *
396
525
  * @example
397
526
  * true
@@ -423,7 +552,7 @@ export class CreateClusterRequestOperationPolicyClusterAutoUpgrade extends $dara
423
552
  export class CreateClusterRequestOperationPolicy extends $dara.Model {
424
553
  /**
425
554
  * @remarks
426
- * The configurations of auto cluster upgrade.
555
+ * Cluster automatic upgrade.
427
556
  */
428
557
  clusterAutoUpgrade?: CreateClusterRequestOperationPolicyClusterAutoUpgrade;
429
558
  static names(): { [key: string]: string } {
@@ -451,6 +580,17 @@ export class CreateClusterRequestOperationPolicy extends $dara.Model {
451
580
  }
452
581
 
453
582
  export class CreateClusterRequestRrsaConfig extends $dara.Model {
583
+ /**
584
+ * @remarks
585
+ * Whether to enable RRSA.
586
+ *
587
+ * - true: Enable.
588
+ *
589
+ * - false: Disable.
590
+ *
591
+ * @example
592
+ * true
593
+ */
454
594
  enabled?: boolean;
455
595
  static names(): { [key: string]: string } {
456
596
  return {
@@ -476,7 +616,7 @@ export class CreateClusterRequestRrsaConfig extends $dara.Model {
476
616
  export class CreateClusterRequestWorkerDataDisks extends $dara.Model {
477
617
  /**
478
618
  * @remarks
479
- * The data disk category.
619
+ * Data disk type.
480
620
  *
481
621
  * This parameter is required.
482
622
  *
@@ -486,10 +626,11 @@ export class CreateClusterRequestWorkerDataDisks extends $dara.Model {
486
626
  category?: string;
487
627
  /**
488
628
  * @remarks
489
- * Specifies whether to encrypt the data disk. Valid values:
629
+ * Whether to encrypt the data disk. Valid values:
630
+ *
631
+ * - `true`: Encrypt the data disk.
490
632
  *
491
- * * `true`: encrypts the data disk.
492
- * * `false`: does not encrypt the data disk.
633
+ * - `false`: Do not encrypt the data disk.
493
634
  *
494
635
  * Default value: `false`.
495
636
  *
@@ -499,7 +640,7 @@ export class CreateClusterRequestWorkerDataDisks extends $dara.Model {
499
640
  encrypted?: string;
500
641
  /**
501
642
  * @remarks
502
- * The PL of the data disk. This parameter takes effect only for ESSDs. You can specify a higher PL if you increase the size of a data disk. For more information, see [Enterprise SSDs](https://help.aliyun.com/document_detail/122389.html).
643
+ * Data disk performance level. Applies only to [ESSD](https://help.aliyun.com/document_detail/122389.html).
503
644
  *
504
645
  * @example
505
646
  * PL1
@@ -507,7 +648,7 @@ export class CreateClusterRequestWorkerDataDisks extends $dara.Model {
507
648
  performanceLevel?: string;
508
649
  /**
509
650
  * @remarks
510
- * The data disk size. Valid values: 40 to 32767. Unit: GiB.
651
+ * Data disk size in GiB. Valid range: 4032767.
511
652
  *
512
653
  * This parameter is required.
513
654
  *
@@ -545,65 +686,77 @@ export class CreateClusterRequestWorkerDataDisks extends $dara.Model {
545
686
  export class CreateClusterRequest extends $dara.Model {
546
687
  /**
547
688
  * @remarks
548
- * The network access control list (ACL) rule of the SLB instance associated with the API server if the cluster is a registered cluster.
689
+ * **[Deprecated]** Access control list for the registered cluster API Server SLB.
549
690
  *
550
691
  * @deprecated
551
692
  */
552
693
  accessControlList?: string[];
553
694
  /**
554
695
  * @remarks
555
- * The components that you want to install in the cluster. When you create a cluster, you can configure the `addons` parameter to specify the components that you want to install.
696
+ * List of cluster components. Specify components to install during cluster creation using the `addons` parameter.
697
+ *
698
+ * **Network components**: Required. Choose between Flannel and Terway:
556
699
  *
557
- * **Network plug-in**: required. The Flannel and Terway plug-ins are supported. Select one of the plug-ins for the cluster.
700
+ * - Flannel network: [{"name":"flannel","config":""}].
558
701
  *
559
- * * If you want to use the Terway component, specify the network plug-in in the [{"name":"flannel","config":""}] format.
560
- * * If you want to use the Terway component, specify the value network plug-in in the [{"name": "terway-eniip","Config": ""}] format.
702
+ * - Terway network: [{"name": "terway-eniip","config": ""}].
561
703
  *
562
- * **Volume plug-in**: optional. Only the `Container Storage Interface (CSI)` plug-in is supported.
704
+ * **Storage components**: Optional. Only `csi` is supported:
563
705
  *
564
- * Specify the `CSI` plug-in in the following format: [{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}].
706
+ * `csi`: [{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}].
565
707
  *
566
- * **Simple Log Service component**: optional. We recommend that you enable Simple Log Service. If Simple Log Service is disabled, you cannot use the cluster auditing feature.
708
+ * **Logging components**: Optional. We recommend enabling this. Without SLS, you cannot use cluster audit features.
567
709
  *
568
- * * Specify an existing `Simple Log Service project` in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}].
569
- * * To create a `Simple Log Service project`, specify the component in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true"}"}].
710
+ * - Use an existing `SLS Project`: [{"name": "loongcollector","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}].
570
711
  *
571
- * **Ingress controller**: optional. By default, the `nginx-ingress-controller` component is installed in ACK dedicated clusters.
712
+ * - Create a new `SLS Project`: [{"name": "loongcollector","config": "{"IngressDashboardEnabled":"true"}"}].
572
713
  *
573
- * * To install nginx-ingress-controller and enable Internet access, specify the Ingress controller in the following format: [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}].
574
- * * To disable the automatic installation of nginx-ingress-controller, specify the Ingress controller in the following format: [{"name": "nginx-ingress-controller","config": "","disabled": true}].
714
+ * **Ingress components**: Optional. ACK dedicated clusters install the `nginx-ingress-controller` by default.
575
715
  *
576
- * **Event center**: optional. By default, the event center feature is enabled.
716
+ * - Install Ingress with public network access: [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}].
577
717
  *
578
- * You can use ACK event centers to store and query events and configure alerts. You can use the Logstores that are associated with ACK event centers free of charge within 90 days. For more information, see [Create and use an event center](https://help.aliyun.com/document_detail/150476.html).
718
+ * - Disable default Ingress installation: [{"name": "nginx-ingress-controller","config": "","disabled": true}].
579
719
  *
580
- * To enable the event center feature, specify the event center component in the following format: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}].
720
+ * **Event Hub**: Optional. Enabled by default.
721
+ *
722
+ * Event Hub provides storage, querying, and alerting for Kubernetes events. The associated Logstore is free for 90 days. For more information about the free policy, see [Create and use Kubernetes Event Hub](https://help.aliyun.com/document_detail/150476.html).
723
+ *
724
+ * Example to enable Event Hub: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}].
581
725
  */
582
726
  addons?: Addon[];
583
727
  /**
584
728
  * @remarks
585
- * Service accounts provide identities for pods when pods communicate with the `API server` of the cluster. The `api-audiences` parameter validates `tokens` and is used by the `API server` to check whether the `tokens` of requests are valid. Separate multiple values with commas (,).``
729
+ * ServiceAccount is the access credential used by pods to communicate with the cluster API Server. The `api-audiences` specifies valid `token` identities for authenticating requests on the `apiserver` side. You can configure multiple `audience` values separated by commas (,).
586
730
  *
587
- * For more information about `service accounts`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
731
+ * For more information about `ServiceAccount`, see [Deploy service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
588
732
  *
589
733
  * @example
590
734
  * kubernetes.default.svc
591
735
  */
592
736
  apiAudiences?: string;
737
+ /**
738
+ * @remarks
739
+ * Cluster audit log configuration.
740
+ */
593
741
  auditLogConfig?: CreateClusterRequestAuditLogConfig;
742
+ /**
743
+ * @remarks
744
+ * [Intelligent Managed Mode](https://help.aliyun.com/document_detail/2938898.html) configuration.
745
+ */
594
746
  autoMode?: CreateClusterRequestAutoMode;
595
747
  /**
596
748
  * @remarks
597
- * [**Deprecated**]
749
+ * **[Deprecated]**
750
+ *
751
+ * Whether to enable auto-renewal. Valid only when `charge_type` is `PrePaid`. Valid values:
598
752
  *
599
- * Specifies whether to enable auto-renewal. This parameter takes effect only when `charge_type` is set to `PrePaid`. Valid values:
753
+ * - `true`: Enable auto-renewal.
600
754
  *
601
- * * `true`: enables auto-renewal.
602
- * * `false`: disables auto-renewal.
755
+ * - `false`: Disable auto-renewal.
603
756
  *
604
757
  * Default value: `false`.
605
758
  *
606
- * This parameter was changed on October 15, 2024. For more information, see [Announcement on changes to the parameter behavior of the CreateCluster operation](https://help.aliyun.com/document_detail/2849194.html).
759
+ * This parameter changed on October 15, 2024. For more information, see [Announcement on Changes to CreateCluster API Parameters](https://help.aliyun.com/document_detail/2849194.html).
607
760
  *
608
761
  * @example
609
762
  * true
@@ -613,13 +766,13 @@ export class CreateClusterRequest extends $dara.Model {
613
766
  autoRenew?: boolean;
614
767
  /**
615
768
  * @remarks
616
- * [**Deprecated**]
769
+ * **[Deprecated]**
617
770
  *
618
- * The auto-renewal duration. This parameter takes effect only if charge_type is set to PrePaid and auto_renew is set to true. If you set `period_unit` to Month, the valid values of auto_renew_period are 1, 2, 3, 6, and 12.
771
+ * Auto-renewal period in months. Valid only when prepaid and auto-renewal are enabled. When `PeriodUnit=Month`, valid values are {1, 2, 3, 6, 12}.
619
772
  *
620
773
  * Default value: 1.
621
774
  *
622
- * This parameter was changed on October 15, 2024. For more information, see [Announcement on changes to the parameter behavior of the CreateCluster operation](https://help.aliyun.com/document_detail/2849194.html).
775
+ * This parameter changed on October 15, 2024. For more information, see [Announcement on Changes to CreateCluster API Parameters](https://help.aliyun.com/document_detail/2849194.html).
623
776
  *
624
777
  * @example
625
778
  * 1
@@ -629,30 +782,32 @@ export class CreateClusterRequest extends $dara.Model {
629
782
  autoRenewPeriod?: number;
630
783
  /**
631
784
  * @remarks
632
- * [**Deprecated**]
785
+ * **[Deprecated]**
786
+ *
787
+ * Billing type for the CLB instance used by the API Server. Default value: PostPaid. Valid values:
633
788
  *
634
- * The billing method of the CLB instance that is used by the API server. Default value: PostPaid. Valid values:
789
+ * - PostPaid: Pay-as-you-go.
635
790
  *
636
- * * PostPaid: pay-as-you-go.
637
- * * PrePaid: subscription. This billing method is not supported by newly created CLB instances. Existing CLB instances are not affected.
791
+ * - PrePaid: Subscription. New CLB instances no longer support subscription billing, but existing instances are unaffected.
638
792
  *
639
- * >
793
+ * >Notice:
640
794
  *
641
- * * This parameter was changed on October 15, 2024. For more information, see [Announcement on changes to the parameter behavior of the CreateCluster operation](https://help.aliyun.com/document_detail/2849194.html).
795
+ * - This parameter changed on October 15, 2024. For more information, see [Announcement on Changes to CreateCluster API Parameters](https://help.aliyun.com/document_detail/2849194.html).
642
796
  *
643
- * * Starting from December 1, 2024, newly created CLB instances no longer support the subscription billing method, and an instance fee will be charged for newly created CLB instances
797
+ * - Starting December 1, 2024, new CLB instances will no longer support subscription billing and will incur an instance fee.
644
798
  *
645
- * For more information, see [CLB billing adjustments](https://help.aliyun.com/document_detail/2839797.html).
799
+ * <props="china">For details, see [[Product Announcement\\] Discontinuation of Subscription Billing for API Server CLB in New Clusters](~~2851191~~) and [Adjustment of Classic Load Balancer Billing Items](https://help.aliyun.com/document_detail/2839797.html).
800
+ * <props="intl">For details, see [Adjustment of Classic Load Balancer Billing Items](https://help.aliyun.com/document_detail/2839797.html).
646
801
  *
647
802
  * @example
648
- * 1
803
+ * PostPaid
649
804
  *
650
805
  * @deprecated
651
806
  */
652
807
  chargeType?: string;
653
808
  /**
654
809
  * @remarks
655
- * [Deprecated] When you configure the control plane, use the `security_hardening_os` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `security_hardening_os` parameter of the `scaling_group` field in the `nodepool` section instead.
810
+ * **[Deprecated]** For control plane configuration, use the `security_hardening_os` parameter under `control_plane_config`. For node pool configuration, use the `security_hardening_os` parameter under `scaling_group` in `nodepool`.
656
811
  *
657
812
  * @example
658
813
  * false
@@ -662,26 +817,27 @@ export class CreateClusterRequest extends $dara.Model {
662
817
  cisEnabled?: boolean;
663
818
  /**
664
819
  * @remarks
665
- * [**Deprecated**] When you configure the control plane, use the `cloud_monitor_flags` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `cms_enabled` parameter of the `kubernetes_config` field in the nodepool section instead.
820
+ * **[Deprecated]** For control plane node configuration, use the cloud_monitor_flags parameter under `control_plane_config`. For node pool configuration, use the `cms_enabled` parameter under `kubernetes_config` in `nodepool`.
821
+ *
822
+ * Whether to install the CloudMonitor agent on the cluster. Valid values:
666
823
  *
667
- * Specifies whether to install the CloudMonitor agent. Valid values:
824
+ * - `true`: Install the CloudMonitor agent.
668
825
  *
669
- * * `true`: installs the CloudMonitor agent.
670
- * * `false`: does not install the CloudMonitor agent.
826
+ * - `false`: Do not install the CloudMonitor agent.
671
827
  *
672
828
  * Default value: `false`.
673
829
  *
674
830
  * @example
675
- * true
831
+ * false
676
832
  *
677
833
  * @deprecated
678
834
  */
679
835
  cloudMonitorFlags?: boolean;
680
836
  /**
681
837
  * @remarks
682
- * The domain name of the cluster.
838
+ * Cluster local domain name.
683
839
  *
684
- * The domain name can contain one or more parts that are separated by periods (.). Each part cannot exceed 63 characters in length, and can contain lowercase letters, digits, and hyphens (-). Each part must start and end with a lowercase letter or digit.
840
+ * Naming rules: The domain name consists of one or more parts separated by dots (.). Each part can be up to 63 characters long and can contain lowercase letters, digits, and hyphens (-). Each part must start and end with a lowercase letter or digit.
685
841
  *
686
842
  * @example
687
843
  * cluster.local
@@ -689,10 +845,21 @@ export class CreateClusterRequest extends $dara.Model {
689
845
  clusterDomain?: string;
690
846
  /**
691
847
  * @remarks
692
- * If you set `cluster_type` to `ManagedKubernetes` and specify `profile`, you can further specify the edition of the cluster. Valid values:
848
+ * When you set `cluster_type` to `ManagedKubernetes` and configure `profile`, you can further specify the cluster specification. Valid values:
849
+ *
850
+ * - `ack.standard`: Basic Edition (default when this parameter is empty)
851
+ *
852
+ * - `ack.pro.small`: Pro Edition
853
+ *
854
+ * - `ack.pro.xlarge`: Pro XL
855
+ *
856
+ * - `ack.pro.2xlarge`: Pro 2XL
857
+ *
858
+ * - `ack.pro.4xlarge`: Pro 4XL (requires whitelist approval from customer service)
693
859
  *
694
- * * `ack.pro.small`: Pro Edition.
695
- * * `ack.standard`: Basic Edition. If you leave the parameter empty, an ACK Basic cluster is created.
860
+ * Pro XL, Pro 2XL, and Pro 4XL are three tiers provided by <props="china">[ACK Pro Provisioned Control Plane](https://help.aliyun.com/ack/ack-managed-and-ack-dedicated/user-guide/ack-pro-provisioned-control-plane)<props="intl">[ACK Pro Provisioned Control Plane](https://www.alibabacloud.com/help/ack/ack-managed-and-ack-dedicated/user-guide/ack-pro-provisioned-control-plane). These tiers pre-allocate and dedicate control plane resources to ensure consistently high API concurrency and pod scheduling performance. They are suitable for AI training and inference, ultra-large-scale clusters, and mission-critical workloads.
861
+ *
862
+ * For cluster management fees for Pro Edition and provisioned control plane clusters, see <props="china">[Cluster management fees](https://help.aliyun.com/ack/ack-managed-and-ack-dedicated/product-overview/cluster-management-fee)<props="intl">[Cluster management fees](https://www.alibabacloud.com/help/ack/ack-managed-and-ack-dedicated/product-overview/cluster-management-fee).
696
863
  *
697
864
  * @example
698
865
  * ack.pro.small
@@ -700,9 +867,11 @@ export class CreateClusterRequest extends $dara.Model {
700
867
  clusterSpec?: string;
701
868
  /**
702
869
  * @remarks
703
- * * `Kubernetes`: ACK dedicated cluster.
704
- * * `ManagedKubernetes`: ACK managed cluster. ACK managed clusters include ACK Basic clusters, ACK Pro clusters, ACK Serverless clusters (Basic Edition and Pro Edition), ACK Edge clusters (Basic Edition and Pro Edition), and ACK Lingjun clusters (Pro Edition).
705
- * * `ExternalKubernetes`: registered cluster.
870
+ * - `Kubernetes`: ACK dedicated cluster.
871
+ *
872
+ * - `ManagedKubernetes`: ACK managed clusters, including ACK managed clusters (Pro Edition, Basic Edition), ACK serverless clusters (Pro Edition, Basic Edition), ACK Edge clusters (Pro Edition, Basic Edition), and ACK LINGJUN clusters (Pro Edition).
873
+ *
874
+ * - `ExternalKubernetes`: registered cluster.
706
875
  *
707
876
  * @example
708
877
  * Kubernetes
@@ -710,11 +879,11 @@ export class CreateClusterRequest extends $dara.Model {
710
879
  clusterType?: string;
711
880
  /**
712
881
  * @remarks
713
- * The pod CIDR block. You can specify 10.0.0.0/8, 172.16-31.0.0/12-16, 192.168.0.0/16, or their subnets as the pod CIDR block. The pod CIDR block cannot overlap with the CIDR block of the VPC in which the cluster is deployed and the CIDR blocks of existing clusters in the VPC. You cannot modify the pod CIDR block after you create the cluster.
882
+ * Pod network CIDR block. It must be a valid private CIDR block: 10.0.0.0/8, 172.16.0.0/12 to 172.31.0.0/16, or 192.168.0.0/16. It cannot overlap with the VPC or existing Kubernetes cluster CIDR blocks in the VPC. This cannot be modified after cluster creation.
714
883
  *
715
- * For more information about how to plan the network of an ACK cluster, see [Plan the network of an ACK cluster](https://help.aliyun.com/document_detail/86500.html).
884
+ * For cluster network planning, see [Network planning for ACK managed clusters](https://help.aliyun.com/document_detail/86500.html).
716
885
  *
717
- * > This parameter is required if the cluster uses the Flannel plug-in.
886
+ * > This field is required for Flannel clusters.
718
887
  *
719
888
  * @example
720
889
  * 172.20.0.0/16
@@ -722,20 +891,24 @@ export class CreateClusterRequest extends $dara.Model {
722
891
  containerCidr?: string;
723
892
  /**
724
893
  * @remarks
725
- * The control plane configurations of an ACK dedicated cluster.
894
+ * Control plane configuration for ACK dedicated clusters.
726
895
  */
727
896
  controlPlaneConfig?: CreateClusterRequestControlPlaneConfig;
897
+ /**
898
+ * @remarks
899
+ * Cluster connection configuration.
900
+ */
728
901
  controlPlaneEndpointsConfig?: CreateClusterRequestControlPlaneEndpointsConfig;
729
902
  /**
730
903
  * @remarks
731
- * The control plane components for which you want to enable log collection.
904
+ * List of component names specifying which control plane component logs to collect.
732
905
  *
733
- * By default, the logs of kube-apiserver, kube-controller-manager, and kube-scheduler are collected.
906
+ * By default, logs are collected for kube-apiserver, kube-controller-manager, kube-scheduler, and cloud-controller-manager.
734
907
  */
735
908
  controlplaneLogComponents?: string[];
736
909
  /**
737
910
  * @remarks
738
- * The Simple Log Service project that is used to store the logs of control plane components. You can use an existing project or create one. If you choose to create a Simple Log Service project, the created project is named in the `k8s-log-{ClusterID}` format.
911
+ * SLS Project for control plane component logs. You can use an existing Project for log storage or let the system automatically create one. If auto-created, the Project name will be `k8s-log-{ClusterID}`.
739
912
  *
740
913
  * @example
741
914
  * k8s-log-xxx
@@ -743,7 +916,7 @@ export class CreateClusterRequest extends $dara.Model {
743
916
  controlplaneLogProject?: string;
744
917
  /**
745
918
  * @remarks
746
- * The retention period of control plane logs in days.
919
+ * Number of days to retain control plane component logs.
747
920
  *
748
921
  * @example
749
922
  * 30
@@ -751,12 +924,13 @@ export class CreateClusterRequest extends $dara.Model {
751
924
  controlplaneLogTtl?: string;
752
925
  /**
753
926
  * @remarks
754
- * [**Deprecated**] When you configure the control plane, use the `cpu_policy` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `cpu_policy` parameter of the `kubernetes_config` field in the `nodepool` section instead.
927
+ * **[Deprecated]** For control plane configuration, use the `cpu_policy` parameter under `control_plane_config`. For node pool configuration, use the `cpu_policy` parameter under `kubernetes_config` in `nodepool`.
755
928
  *
756
- * The CPU management policy of the node. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
929
+ * Node CPU management policy. Supported for cluster versions 1.12.6 and later:
757
930
  *
758
- * * `static`: allows pods with specific resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.
759
- * * `none`: specifies that the default CPU affinity is used.
931
+ * - `static`: Enhances CPU affinity and exclusivity for pods with specific resource characteristics on the node.
932
+ *
933
+ * - `none`: Uses the default CPU affinity scheme.
760
934
  *
761
935
  * Default value: `none`.
762
936
  *
@@ -768,7 +942,9 @@ export class CreateClusterRequest extends $dara.Model {
768
942
  cpuPolicy?: string;
769
943
  /**
770
944
  * @remarks
771
- * The custom subject alternative names (SANs) for the API server certificate to accept requests from specified IP addresses or domain names. Separate multiple IP addresses and domain names with commas (,).
945
+ * **[Deprecated]** Use the `extra_sans` parameter instead.
946
+ *
947
+ * Custom certificate SAN. Separate multiple IP addresses or domain names with commas (,).
772
948
  *
773
949
  * @example
774
950
  * cs.aliyun.com
@@ -778,10 +954,11 @@ export class CreateClusterRequest extends $dara.Model {
778
954
  customSan?: string;
779
955
  /**
780
956
  * @remarks
781
- * Specifies whether to enable cluster deletion protection. If you enable this option, the cluster cannot be deleted in the console or by calling API operations. Valid values:
957
+ * Cluster deletion protection prevents accidental cluster deletion through the console or API. Valid values:
958
+ *
959
+ * - `true`: Enable deletion protection. You cannot delete the cluster through the console or API.
782
960
  *
783
- * * `true`: enables cluster deletion protection.
784
- * * `false`: disables cluster deletion protection.
961
+ * - `false`: Disable deletion protection. You can delete the cluster through the console or API.
785
962
  *
786
963
  * Default value: `false`.
787
964
  *
@@ -791,12 +968,13 @@ export class CreateClusterRequest extends $dara.Model {
791
968
  deletionProtection?: boolean;
792
969
  /**
793
970
  * @remarks
794
- * [**Deprecated**] By default, the system does not perform a rollback when the cluster fails to be created. You must manually delete the cluster that fails to be created.
971
+ * **[Deprecated]** By default, clusters are not rolled back on creation failure. You must manually clean up failed clusters.
795
972
  *
796
- * Specifies whether to perform a rollback when the cluster fails to be created. Valid values:
973
+ * Whether to roll back on cluster creation failure. Valid values:
797
974
  *
798
- * * `true`: performs a rollback when the cluster fails to be created.
799
- * * `false`: does not perform a rollback when the cluster fails to be created.
975
+ * - `true`: Roll back on failure.
976
+ *
977
+ * - `false`: Do not roll back on failure.
800
978
  *
801
979
  * Default value: `true`.
802
980
  *
@@ -808,19 +986,25 @@ export class CreateClusterRequest extends $dara.Model {
808
986
  disableRollback?: boolean;
809
987
  /**
810
988
  * @remarks
811
- * Specifies whether to enable the RAM Roles for Service Accounts (RRSA) feature.
989
+ * **[Deprecated]** Use the `rrsa_config` parameter instead.
990
+ *
991
+ * Whether to enable RRSA.
992
+ *
993
+ * - true: Enable.
994
+ *
995
+ * - false: Disable.
812
996
  *
813
997
  * @example
814
- * true
998
+ * false
815
999
  *
816
1000
  * @deprecated
817
1001
  */
818
1002
  enableRrsa?: boolean;
819
1003
  /**
820
1004
  * @remarks
821
- * The ID of the Key Management Service (KMS) key that is used to encrypt the system disk. For more information, see [What is KMS?](https://help.aliyun.com/document_detail/28935.html)
1005
+ * KMS key ID used to encrypt data disks. For more information, see [Key Management Service](https://help.aliyun.com/document_detail/28935.html).
822
1006
  *
823
- * > The key can be used only in ACK Pro clusters.
1007
+ * > This feature is available only for professional managed clusters (ACK Pro clusters).
824
1008
  *
825
1009
  * @example
826
1010
  * 0fe64791-55eb-4fc7-84c5-c6c7cdca****
@@ -828,10 +1012,11 @@ export class CreateClusterRequest extends $dara.Model {
828
1012
  encryptionProviderKey?: string;
829
1013
  /**
830
1014
  * @remarks
831
- * Specifies whether to enable Internet access for the cluster. You can use an elastic IP address (EIP) to expose the API server. This way, you can access the cluster over the Internet. Valid values:
1015
+ * Whether to enable public network access. Expose the API Server through an EIP to allow public network access to the cluster.
832
1016
  *
833
- * * `true`: enables Internet access for the cluster.
834
- * * `false`: disables Internet access for the cluster. If you set the value to false, the API server cannot be accessed over the Internet.
1017
+ * - `true`: Enable public network access.
1018
+ *
1019
+ * - `false`: Disable public network access. If disabled, you cannot access the cluster API Server from external networks.
835
1020
  *
836
1021
  * Default value: `false`.
837
1022
  *
@@ -839,22 +1024,28 @@ export class CreateClusterRequest extends $dara.Model {
839
1024
  * true
840
1025
  */
841
1026
  endpointPublicAccess?: boolean;
1027
+ /**
1028
+ * @remarks
1029
+ * Custom API Server certificate SAN (Subject Alternative Name).
1030
+ */
842
1031
  extraSans?: string[];
843
1032
  /**
844
1033
  * @remarks
845
- * [**Deprecated**] When you configure a node pool, you cannot add existing nodes to the cluster. If you want to add existing nodes, you must first create a node pool and then call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) operation.
1034
+ * **[Deprecated]** Adding existing nodes during cluster creation is not supported. To add existing nodes to a cluster, first create a node pool and then call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) API.
1035
+ *
1036
+ * When using existing instances to create a cluster, whether to mount data disks. Valid values:
846
1037
  *
847
- * Specifies whether to mount a data disk to a node that is created based on an existing ECS instance. Valid values:
1038
+ * - `true`: Store containers and images on the data disk. Existing data on the data disk will be lost. Back up your data.
848
1039
  *
849
- * * `true`: stores the data of containers and images on a data disk. The existing data stored in the data disk is lost. Back up the existing data first.
850
- * * `false`: does not store the data of containers and images on a data disk.
1040
+ * - `false`: Do not store containers and images on the data disk.
851
1041
  *
852
1042
  * Default value: `false`.
853
1043
  *
854
- * How data disks are mounted:
1044
+ * Data disk mounting rules:
1045
+ *
1046
+ * - If the ECS instance has a mounted data disk and the file system of the last data disk is uninitialized, the system automatically formats it as ext4 to store /var/lib/docker and /var/lib/kubelet.
855
1047
  *
856
- * * If an ECS instance has data disks mounted and the file system of the last data disk is not initialized, the system automatically formats the data disk to ext4. Then, the system mounts the data disk to /var/lib/docker and /var/lib/kubelet.
857
- * * If no data disk is mounted to the ECS instance, the system does not purchase a new data disk.
1048
+ * - If the ECS instance has no mounted data disks, no new data disks are mounted.
858
1049
  *
859
1050
  * @example
860
1051
  * false
@@ -864,9 +1055,9 @@ export class CreateClusterRequest extends $dara.Model {
864
1055
  formatDisk?: boolean;
865
1056
  /**
866
1057
  * @remarks
867
- * [**Deprecated**] When you configure the control plane, use the `image_id` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `image_id` parameter of the `scaling_group` field in the `nodepool` section instead.
1058
+ * **[Deprecated]** For control plane configuration, use the `image_id` parameter under `control_plane_config`. For node pool configuration, use the `image_id` parameter under `scaling_group` in `nodepool`.
868
1059
  *
869
- * The custom image for nodes. By default, the image provided by ACK is used. You can select a custom image to replace the default image. For more information, see [Use a custom image to create an ACK cluster](https://help.aliyun.com/document_detail/146647.html).
1060
+ * Custom node image. By default, the system image is used. When you select a custom image, it replaces the default system image. See [Custom images](https://help.aliyun.com/document_detail/146647.html).
870
1061
  *
871
1062
  * @example
872
1063
  * m-bp16z7xko3vvv8gt****
@@ -876,19 +1067,27 @@ export class CreateClusterRequest extends $dara.Model {
876
1067
  imageId?: string;
877
1068
  /**
878
1069
  * @remarks
879
- * [**Deprecated**] When you configure the control plane, use the `image_type` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `image_type` parameter of the `scaling_group` field in the `nodepool` section instead.
1070
+ * **[Deprecated]** For control plane configuration, use the `image_type` parameter under `control_plane_config`. For node pool configuration, use the `image_type` parameter under `scaling_group` in `nodepool`.
1071
+ *
1072
+ * Operating system distribution type. We recommend using this parameter to specify the node operating system. Valid values:
1073
+ *
1074
+ * - CentOS
1075
+ *
1076
+ * - AliyunLinux
880
1077
  *
881
- * The type of OS distribution that you want to use. To specify the node OS, we recommend that you use this parameter. Valid values:
1078
+ * - AliyunLinux Qboot
882
1079
  *
883
- * * CentOS
884
- * * AliyunLinux
885
- * * AliyunLinux Qboot
886
- * * AliyunLinuxUEFI
887
- * * AliyunLinux3
888
- * * Windows
889
- * * WindowsCore
890
- * * AliyunLinux3Arm64
891
- * * ContainerOS
1080
+ * - AliyunLinuxUEFI
1081
+ *
1082
+ * - AliyunLinux3
1083
+ *
1084
+ * - Windows
1085
+ *
1086
+ * - WindowsCore
1087
+ *
1088
+ * - AliyunLinux3Arm64
1089
+ *
1090
+ * - ContainerOS
892
1091
  *
893
1092
  * Default value: `CentOS`.
894
1093
  *
@@ -900,32 +1099,34 @@ export class CreateClusterRequest extends $dara.Model {
900
1099
  imageType?: string;
901
1100
  /**
902
1101
  * @remarks
903
- * [**Deprecated**] When you configure a node pool, you cannot add existing nodes to the cluster. If you want to add existing nodes, you must first create a node pool and then call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) operation.
1102
+ * **[Deprecated]** Adding existing nodes during cluster creation is not supported. To add existing nodes to a cluster, first create a node pool and then call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) API.
904
1103
  *
905
- * The existing ECS instances that are specified as worker nodes for the cluster.
1104
+ * When using existing nodes to create a cluster, specify the ECS instance list. These instances are added as worker nodes to the cluster.
906
1105
  *
907
- * > This parameter is required if you create worker nodes on existing ECS instances.
1106
+ * > This field is required when using existing instances to create a cluster.
908
1107
  *
909
1108
  * @deprecated
910
1109
  */
911
1110
  instances?: string[];
912
1111
  /**
913
1112
  * @remarks
914
- * The IP stack of the cluster.
1113
+ * Cluster IP stack.
915
1114
  *
916
1115
  * @example
917
- * Optional value: ipv4 (Single stack) or ipv6 (Dual Stack)
918
- * Default value: IPV4
1116
+ * 可选值:
1117
+ * ipv4(单栈)
1118
+ * dual(双栈),默认值为ipv4。
919
1119
  */
920
1120
  ipStack?: string;
921
1121
  /**
922
1122
  * @remarks
923
- * Specifies whether to create an advanced security group. This parameter takes effect only if `security_group_id` is left empty.
1123
+ * Automatically create an advanced security group. This takes effect when `security_group_id` is empty.
1124
+ *
1125
+ * > With basic security groups, the total number of nodes and Terway pods in a cluster cannot exceed 2,000. We recommend using advanced security groups for Terway network clusters.
924
1126
  *
925
- * > To use a basic security group, make sure that the sum of the number of nodes in the cluster and the number of pods that use Terway does not exceed 2,000. Therefore, we recommend that you specify an advanced security group for a cluster that uses Terway.
1127
+ * - `true`: Create and use an advanced security group.
926
1128
  *
927
- * * `true`: creates an advanced security group.
928
- * * `false`: does not create an advanced security group.
1129
+ * - `false`: Use a basic security group.
929
1130
  *
930
1131
  * Default value: `true`.
931
1132
  *
@@ -935,12 +1136,13 @@ export class CreateClusterRequest extends $dara.Model {
935
1136
  isEnterpriseSecurityGroup?: boolean;
936
1137
  /**
937
1138
  * @remarks
938
- * [**Deprecated**] When you configure a node pool, you cannot add existing nodes to the cluster. If you want to add existing nodes, you must first create a node pool and then call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) operation.
1139
+ * **[Deprecated]** Adding existing nodes during cluster creation is not supported. To add existing nodes to a cluster, first create a node pool and then call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) API.
939
1140
  *
940
- * Specifies whether to retain the names of existing ECS instances that are used in the cluster. Valid values:
1141
+ * When using existing instances to create a cluster, whether to keep the instance names.
941
1142
  *
942
- * * `true`: retains the names.
943
- * * `false`: does not retain the names. The system assigns new names.
1143
+ * - `true`: Keep.
1144
+ *
1145
+ * - `false`: Replace with system-generated names.
944
1146
  *
945
1147
  * Default value: `true`.
946
1148
  *
@@ -952,31 +1154,33 @@ export class CreateClusterRequest extends $dara.Model {
952
1154
  keepInstanceName?: boolean;
953
1155
  /**
954
1156
  * @remarks
955
- * [**Deprecated**] When you configure the control plane, use the `key_pair` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `key_pair` parameter of the `scaling_group` field in the `nodepool` section instead.
1157
+ * **[Deprecated]** For control plane configuration, use the `key_pair` parameter under `control_plane_config`. For node pool configuration, use the `key_pair` parameter under `scaling_group` in `nodepool`.
956
1158
  *
957
- * The name of the key pair. You must configure this parameter or `login_password`.
1159
+ * Key pair name. Choose either this parameter or `login_password`.
958
1160
  *
959
1161
  * @example
960
- * secrity-key
1162
+ * security-key
961
1163
  *
962
1164
  * @deprecated
963
1165
  */
964
1166
  keyPair?: string;
965
1167
  /**
966
1168
  * @remarks
967
- * The Kubernetes version of the cluster. The Kubernetes versions supported by ACK are the same as the Kubernetes versions supported by open source Kubernetes. We recommend that you specify the latest Kubernetes version. If you do not specify this parameter, the latest Kubernetes version is used.
1169
+ * Cluster version, aligned with the Kubernetes community baseline version. We recommend selecting the latest version. If not specified, the latest version is used by default.
1170
+ *
1171
+ * You can create clusters using any of the three most recent versions. Use the [DescribeKubernetesVersionMetadata](https://help.aliyun.com/document_detail/2667899.html) API to query supported cluster versions.
968
1172
  *
969
- * You can create ACK clusters of the latest three Kubernetes versions in the ACK console. If you want to create clusters that run earlier Kubernetes versions, use the ACK API. For more information about the Kubernetes versions supported by ACK, see [Support for Kubernetes versions](https://help.aliyun.com/document_detail/185269.html).
1173
+ * For more information about Kubernetes versions supported by ACK, see [Overview of Kubernetes version releases](https://help.aliyun.com/document_detail/185269.html).
970
1174
  *
971
1175
  * @example
972
- * 1.16.9-aliyun.1
1176
+ * 1.32.1-aliyun.1
973
1177
  */
974
1178
  kubernetesVersion?: string;
975
1179
  /**
976
1180
  * @remarks
977
- * Specifies the ID of the CLB instance for accessing the API server. If this parameter is specified, the system does not automatically create a CLB instance for the API server.
1181
+ * Specify the CLB instance ID for API Server access. If specified, no new API Server CLB is automatically created.
978
1182
  *
979
- * > Make sure that the CLB instance does not have other dependencies, such as listeners and backend servers. You cannot specify shared-resource or Internet-facing CLB instances.
1183
+ * > Ensure the CLB instance has no dependencies (such as listeners or backend servers). Shared and public CLB instances are not supported.
980
1184
  *
981
1185
  * @example
982
1186
  * lb-wz9t256gqa3vbouk****
@@ -984,16 +1188,21 @@ export class CreateClusterRequest extends $dara.Model {
984
1188
  loadBalancerId?: string;
985
1189
  /**
986
1190
  * @remarks
987
- * [**Deprecated**] The pay-as-you-go billing method is used by Classic Load Balancer (CLB) instances. This parameter does not take effect.
1191
+ * **[Deprecated]** CLB is billed based on usage. This parameter has no effect.
1192
+ *
1193
+ * Load Balancer specification. Valid values:
1194
+ *
1195
+ * - slb.s1.small
1196
+ *
1197
+ * - slb.s2.small
1198
+ *
1199
+ * - slb.s2.medium
1200
+ *
1201
+ * - slb.s3.small
988
1202
  *
989
- * The specification of the Server Load Balancer (SLB) instance. Valid values:
1203
+ * - slb.s3.medium
990
1204
  *
991
- * * slb.s1.small
992
- * * slb.s2.small
993
- * * slb.s2.medium
994
- * * slb.s3.small
995
- * * slb.s3.medium
996
- * * slb.s3.large
1205
+ * - slb.s3.large
997
1206
  *
998
1207
  * Default value: `slb.s2.small`.
999
1208
  *
@@ -1005,7 +1214,7 @@ export class CreateClusterRequest extends $dara.Model {
1005
1214
  loadBalancerSpec?: string;
1006
1215
  /**
1007
1216
  * @remarks
1008
- * Enables Simple Log Service for the cluster. This parameter takes effect only for ACK Serverless clusters. Set the value to `SLS`.
1217
+ * **[Deprecated]** Enables SLS for the cluster. Applies only to ACK Serverless clusters and must be set to `SLS`.
1009
1218
  *
1010
1219
  * @example
1011
1220
  * SLS
@@ -1015,29 +1224,30 @@ export class CreateClusterRequest extends $dara.Model {
1015
1224
  loggingType?: string;
1016
1225
  /**
1017
1226
  * @remarks
1018
- * [**Deprecated**] When you configure the control plane, use the `login_password` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `login_password` parameter of the `scaling_group` field in the `nodepool` section instead.
1227
+ * **[Deprecated]** For control plane configuration, use the `login_password` parameter under `control_plane_config`. For node pool configuration, use the `login_password` parameter under `scaling_group` in `nodepool`.
1019
1228
  *
1020
- * The password for SSH logon. You must set this parameter or `key_pair`. The password must be 8 to 30 characters in length, and must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.
1229
+ * SSH login password. Choose either this parameter or `key_pair`. Password rules: 830 characters, containing at least three of the following: uppercase letters, lowercase letters, digits, and special characters.
1021
1230
  *
1022
1231
  * @example
1023
- * Hello@1234
1232
+ * null
1024
1233
  *
1025
1234
  * @deprecated
1026
1235
  */
1027
1236
  loginPassword?: string;
1028
1237
  /**
1029
1238
  * @remarks
1030
- * The configurations of the cluster maintenance window.
1239
+ * Cluster maintenance window.
1031
1240
  */
1032
1241
  maintenanceWindow?: MaintenanceWindow;
1033
1242
  /**
1034
1243
  * @remarks
1035
- * [**Deprecated**] When you configure the control plane, use the `auto-renew` parameter in the `control_plane_config` section instead.
1244
+ * **[Deprecated]** For control plane configuration, use the `auto_renew` parameter under `control_plane_config`.
1036
1245
  *
1037
- * Specifies whether to enable auto-renewal for master nodes. This parameter takes effect only when `master_instance_charge_type` is set to `PrePaid`. Valid values:
1246
+ * Whether to enable auto-renewal for master nodes. Valid only when `master_instance_charge_type` is `PrePaid`. Valid values:
1038
1247
  *
1039
- * * `true`: enables auto-renewal.
1040
- * * `false`: disables auto-renewal.
1248
+ * - `true`: Enable auto-renewal.
1249
+ *
1250
+ * - `false`: Disable auto-renewal.
1041
1251
  *
1042
1252
  * Default value: `true`.
1043
1253
  *
@@ -1049,11 +1259,11 @@ export class CreateClusterRequest extends $dara.Model {
1049
1259
  masterAutoRenew?: boolean;
1050
1260
  /**
1051
1261
  * @remarks
1052
- * [**Deprecated**] When you configure the control plane, use the `auto-renew_period` parameter in the `control_plane_config` section instead.
1262
+ * **[Deprecated]** For control plane configuration, use the `auto_renew_period` parameter under `control_plane_config`.
1053
1263
  *
1054
- * The auto-renewal duration. This parameter takes effect and is required only when the subscription billing method is selected for master nodes.
1264
+ * Auto-renewal period for master nodes in months. Required and valid only when subscription billing is selected.
1055
1265
  *
1056
- * Valid values: 1, 2, 3, 6, and 12.
1266
+ * Valid values: {1, 2, 3, 6, 12}.
1057
1267
  *
1058
1268
  * Default value: 1.
1059
1269
  *
@@ -1065,9 +1275,9 @@ export class CreateClusterRequest extends $dara.Model {
1065
1275
  masterAutoRenewPeriod?: number;
1066
1276
  /**
1067
1277
  * @remarks
1068
- * [**Deprecated**] When you configure the control plane, use the `size` parameter in the `control_plane_config` section instead.
1278
+ * **[Deprecated]** For control plane configuration, use the `size` parameter under `control_plane_config`.
1069
1279
  *
1070
- * The number of master nodes. Valid values: `3` and `5`.
1280
+ * Number of master nodes. Valid values: `3` or `5`.
1071
1281
  *
1072
1282
  * Default value: `3`.
1073
1283
  *
@@ -1079,12 +1289,13 @@ export class CreateClusterRequest extends $dara.Model {
1079
1289
  masterCount?: number;
1080
1290
  /**
1081
1291
  * @remarks
1082
- * [**Deprecated**] When you configure the control plane, use the `instance_charge_type` parameter in the `control_plane_config` section instead.
1292
+ * **[Deprecated]** For control plane configuration, use the `instance_charge_type` parameter under `control_plane_config`.
1293
+ *
1294
+ * Master node billing type. Valid values:
1083
1295
  *
1084
- * The billing method of master nodes. Valid values:
1296
+ * - `PrePaid`: Subscription.
1085
1297
  *
1086
- * * `PrePaid`: subscription.
1087
- * * `PostPaid`: pay-as-you-go.
1298
+ * - `PostPaid`: Pay-as-you-go.
1088
1299
  *
1089
1300
  * Default value: `PostPaid`.
1090
1301
  *
@@ -1096,20 +1307,20 @@ export class CreateClusterRequest extends $dara.Model {
1096
1307
  masterInstanceChargeType?: string;
1097
1308
  /**
1098
1309
  * @remarks
1099
- * [**Deprecated**] When you configure the control plane, use the `instance_types` parameter in the `control_plane_config` section instead.
1310
+ * **[Deprecated]** For control plane configuration, use the `instance_types` parameter under `control_plane_config`.
1100
1311
  *
1101
- * The instance types of master nodes. For more information, see [Overview of instance families](https://help.aliyun.com/document_detail/25378.html).
1312
+ * Master node instance types. For more information, see [Instance families](https://help.aliyun.com/document_detail/25378.html).
1102
1313
  *
1103
1314
  * @deprecated
1104
1315
  */
1105
1316
  masterInstanceTypes?: string[];
1106
1317
  /**
1107
1318
  * @remarks
1108
- * [**Deprecated**] When you configure the control plane, use the `unit` parameter in the `control_plane_config` section instead.
1319
+ * **[Deprecated]** For control plane configuration, use the `unit` parameter under `control_plane_config`.
1109
1320
  *
1110
- * The subscription duration of master nodes. This parameter takes effect and is required only when `master_instance_charge_type` is set to `PrePaid`.
1321
+ * Subscription duration for master nodes in months. Required and valid only when `master_instance_charge_type` is `PrePaid`.
1111
1322
  *
1112
- * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
1323
+ * Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.
1113
1324
  *
1114
1325
  * Default value: 1.
1115
1326
  *
@@ -1121,11 +1332,11 @@ export class CreateClusterRequest extends $dara.Model {
1121
1332
  masterPeriod?: number;
1122
1333
  /**
1123
1334
  * @remarks
1124
- * [**Deprecated**] When you configure the control plane, use the `period_unit` parameter in the `control_plane_config` section instead.
1335
+ * **[Deprecated]** For control plane configuration, use the `period_unit` parameter under `control_plane_config`.
1125
1336
  *
1126
- * The billing cycle of the master nodes in the cluster. This parameter is required if master_instance_charge_type is set to `PrePaid`.
1337
+ * Master node billing cycle. Required when master_instance_charge_type is `PrePaid`.
1127
1338
  *
1128
- * Valid value: `Month`, which indicates that master nodes are billed only on a monthly basis.
1339
+ * Valid value: `Month`. Only monthly billing is supported.
1129
1340
  *
1130
1341
  * @example
1131
1342
  * Month
@@ -1135,15 +1346,17 @@ export class CreateClusterRequest extends $dara.Model {
1135
1346
  masterPeriodUnit?: string;
1136
1347
  /**
1137
1348
  * @remarks
1138
- * [**Deprecated**] When you configure the control plane, use the `system_disk_category` parameter in the `control_plane_config` section instead.
1349
+ * **[Deprecated]** For control plane configuration, use the `system_disk_category` parameter under `control_plane_config`.
1350
+ *
1351
+ * Master node system disk type. Valid values:
1139
1352
  *
1140
- * The system disk category of master nodes. Valid values:
1353
+ * - `cloud_efficiency`: Ultra disk.
1141
1354
  *
1142
- * * `cloud_efficiency`: ultra disk.
1143
- * * `cloud_ssd`: standard SSD.
1144
- * * `cloud_essd`: Enterprise SSD (ESSD).
1355
+ * - `cloud_ssd`: Standard SSD.
1145
1356
  *
1146
- * Default value: `cloud_ssd`. The default value may vary in different zones.
1357
+ * - `cloud_essd`: ESSD.
1358
+ *
1359
+ * Default value: `cloud_ssd`. The default may vary by zone.
1147
1360
  *
1148
1361
  * @example
1149
1362
  * cloud_ssd
@@ -1153,9 +1366,9 @@ export class CreateClusterRequest extends $dara.Model {
1153
1366
  masterSystemDiskCategory?: string;
1154
1367
  /**
1155
1368
  * @remarks
1156
- * [**Deprecated**] When you configure the control plane, use the `system_disk_performance_level` parameter in the `control_plane_config` section instead.
1369
+ * **[Deprecated]** For control plane configuration, use the `system_disk_performance_level` parameter under `control_plane_config`.
1157
1370
  *
1158
- * The performance level (PL) of the system disk that you want to use for master nodes. This parameter takes effect only for ESSDs. For more information about the relationship between disk PLs and disk sizes, see [ESSDs](https://help.aliyun.com/document_detail/122389.html).
1371
+ * Performance level for master node system disks. Applies only to ESSD disks. Disk performance levels depend on disk size. For more information, see [ESSD](https://help.aliyun.com/document_detail/122389.html).
1159
1372
  *
1160
1373
  * @example
1161
1374
  * PL1
@@ -1165,9 +1378,9 @@ export class CreateClusterRequest extends $dara.Model {
1165
1378
  masterSystemDiskPerformanceLevel?: string;
1166
1379
  /**
1167
1380
  * @remarks
1168
- * [**Deprecated**] When you configure the control plane, use the `system_disk_disk` parameter in the `control_plane_config` section instead.
1381
+ * **[Deprecated]** For control plane configuration, use the `system_disk_size` parameter under `control_plane_config`.
1169
1382
  *
1170
- * The system disk size of master nodes. Valid values: 40 to 500. Unit: GiB.
1383
+ * Valid range: [40,500].
1171
1384
  *
1172
1385
  * Default value: `120`.
1173
1386
  *
@@ -1179,9 +1392,9 @@ export class CreateClusterRequest extends $dara.Model {
1179
1392
  masterSystemDiskSize?: number;
1180
1393
  /**
1181
1394
  * @remarks
1182
- * [**Deprecated**] When you configure the control plane, use the `system_disk_snapshot_policy_id` parameter in the `control_plane_config` section instead.
1395
+ * **[Deprecated]** For control plane configuration, use the `system_disk_snapshot_policy_id` parameter under `control_plane_config`.
1183
1396
  *
1184
- * The ID of the automatic snapshot policy that is used by the system disk specified for master nodes.
1397
+ * Automatic snapshot policy ID for master node system disks.
1185
1398
  *
1186
1399
  * @example
1187
1400
  * sp-2zej1nogjvovnz4z****
@@ -1191,20 +1404,18 @@ export class CreateClusterRequest extends $dara.Model {
1191
1404
  masterSystemDiskSnapshotPolicyId?: string;
1192
1405
  /**
1193
1406
  * @remarks
1194
- * [**Deprecated**] Use the `vswitch_ids` parameter instead.
1407
+ * **[Deprecated]** Use the `vswitch_ids` parameter instead.
1195
1408
  *
1196
- * The IDs of the vSwitches that are specified for master nodes. You can specify up to three vSwitches. We recommend that you specify three vSwitches in different zones to ensure high availability.
1409
+ * List of master node vSwitch IDs. The number of vSwitches must be in the range [1,3]. For high availability, we recommend selecting three vSwitches in different zones.
1197
1410
  *
1198
- * The number of vSwitches must be the same as the value of the `master_count` parameter and also the same as the number of vSwitches specified in the `master_vswitch_ids` parameter.
1411
+ * The number of specified instance types must match `master_count` and correspond one-to-one with elements in `master_vswitch_ids`.
1199
1412
  *
1200
1413
  * @deprecated
1201
1414
  */
1202
1415
  masterVswitchIds?: string[];
1203
1416
  /**
1204
1417
  * @remarks
1205
- * The cluster name.
1206
- *
1207
- * The name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). The name cannot start with a hyphen (-).
1418
+ * Custom cluster name. It can contain digits, letters, Chinese characters, or hyphens (-). The name must be 1 to 63 characters long and cannot start with a hyphen (-).
1208
1419
  *
1209
1420
  * This parameter is required.
1210
1421
  *
@@ -1214,7 +1425,7 @@ export class CreateClusterRequest extends $dara.Model {
1214
1425
  name?: string;
1215
1426
  /**
1216
1427
  * @remarks
1217
- * [Deprecated] Use the `snat_entry` parameter instead.
1428
+ * **[Deprecated]** Use the `snat_entry` parameter instead.
1218
1429
  *
1219
1430
  * @example
1220
1431
  * true
@@ -1224,7 +1435,7 @@ export class CreateClusterRequest extends $dara.Model {
1224
1435
  natGateway?: boolean;
1225
1436
  /**
1226
1437
  * @remarks
1227
- * The maximum number of IP addresses that can be assigned to each node. This number is determined by the subnet mask of the specified CIDR block. This parameter takes effect only if the cluster uses the Flannel plug-in.
1438
+ * Number of node IP addresses, determined by the specified CIDR mask. This applies only to Flannel network clusters.
1228
1439
  *
1229
1440
  * Default value: `26`.
1230
1441
  *
@@ -1234,26 +1445,17 @@ export class CreateClusterRequest extends $dara.Model {
1234
1445
  nodeCidrMask?: string;
1235
1446
  /**
1236
1447
  * @remarks
1237
- * [**Deprecated**] When you configure a node pool, use the `node_name_mode` parameter of the `kubernetes_config` field in the `nodepool` section instead.
1238
- *
1239
- * The custom node name.
1240
- *
1241
- * A custom node name consists of a prefix, a node IP address, and a suffix.
1242
- *
1243
- * * The prefix and suffix can contain multiple parts that are separated by periods (.). Each part can contain lowercase letters, digits, and hyphens (-), and must start and end with a lowercase letter or digit.
1244
- * * The IP substring length specifies the number of digits to be truncated from the end of the node IP address. The IP substring length ranges from 5 to 12.
1245
- *
1246
- * For example, if the node IP address is 192.168.0.55, the prefix is aliyun.com, the IP substring length is 5, and the suffix is test, the node name will aliyun.com00055test.
1448
+ * **[Deprecated]** Use the `node_name_mode` parameter under `kubernetes_config` in `nodepool` instead.
1247
1449
  *
1248
1450
  * @example
1249
- * aliyun.com00055test
1451
+ * null
1250
1452
  *
1251
1453
  * @deprecated
1252
1454
  */
1253
1455
  nodeNameMode?: string;
1254
1456
  /**
1255
1457
  * @remarks
1256
- * The node port range. Valid values: 30000 to 65535.
1458
+ * Node service port range: [30000,65535].
1257
1459
  *
1258
1460
  * Default value: `30000-32767`.
1259
1461
  *
@@ -1265,14 +1467,14 @@ export class CreateClusterRequest extends $dara.Model {
1265
1467
  nodePortRange?: string;
1266
1468
  /**
1267
1469
  * @remarks
1268
- * The list of node pools.
1470
+ * List of node pools.
1269
1471
  */
1270
1472
  nodepools?: Nodepool[];
1271
1473
  /**
1272
1474
  * @remarks
1273
- * [**Deprecated**] When you configure a node pool, use the `desired_size` parameter of the `scaling_group` field in the `nodepool` section instead.
1475
+ * **[Deprecated]** For node pool configuration, use the `desired_size` parameter under `scaling_group` in `nodepool`.
1274
1476
  *
1275
- * The number of worker nodes. Valid values: 0 to 100.
1477
+ * Number of worker nodes. Range: [0,100].
1276
1478
  *
1277
1479
  * @example
1278
1480
  * 3
@@ -1282,17 +1484,18 @@ export class CreateClusterRequest extends $dara.Model {
1282
1484
  numOfNodes?: number;
1283
1485
  /**
1284
1486
  * @remarks
1285
- * The automatic O\\&M policy of the cluster.
1487
+ * Cluster automated operations policy.
1286
1488
  */
1287
1489
  operationPolicy?: CreateClusterRequestOperationPolicy;
1288
1490
  /**
1289
1491
  * @remarks
1290
- * [**Deprecated**] When you configure the control plane, use the `image_type` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `image_type` parameter of the `scaling_group` field in the `nodepool` section instead.
1492
+ * **[Deprecated]** For control plane node configuration, use the `image_type` parameter under `control_plane_config`. For node pool configuration, use the `image_type` parameter under `scaling_group` in `nodepool`.
1291
1493
  *
1292
- * The type of OS. Valid values:
1494
+ * Operating system platform type. Valid values:
1293
1495
  *
1294
- * * Windows
1295
- * * Linux
1496
+ * - Windows
1497
+ *
1498
+ * - Linux
1296
1499
  *
1297
1500
  * Default value: `Linux`.
1298
1501
  *
@@ -1304,31 +1507,31 @@ export class CreateClusterRequest extends $dara.Model {
1304
1507
  osType?: string;
1305
1508
  /**
1306
1509
  * @remarks
1307
- * [**Deprecated**]
1510
+ * **[Deprecated]**
1308
1511
  *
1309
- * The subscription duration. This parameter takes effect and is required only when you set charge_type to PrePaid.
1512
+ * Subscription duration in months. Required and valid only when charge_type is PrePaid.
1310
1513
  *
1311
- * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
1514
+ * Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.
1312
1515
  *
1313
1516
  * Default value: 1.
1314
1517
  *
1315
- * This parameter was changed on October 15, 2024. For more information, see [Announcement on changes to the parameter behavior of the CreateCluster operation](https://help.aliyun.com/document_detail/2849194.html).
1518
+ * This parameter changed on October 15, 2024. For more information, see [Announcement on Changes to CreateCluster API Parameters](https://help.aliyun.com/document_detail/2849194.html).
1316
1519
  *
1317
1520
  * @example
1318
- * FY2023
1521
+ * 1
1319
1522
  *
1320
1523
  * @deprecated
1321
1524
  */
1322
1525
  period?: number;
1323
1526
  /**
1324
1527
  * @remarks
1325
- * [**Deprecated**]
1528
+ * **[Deprecated]**
1326
1529
  *
1327
- * The billing cycle. This parameter is required if charge_type is set to PrePaid.
1530
+ * Billing cycle. Required when the billing type is PrePaid.
1328
1531
  *
1329
- * Valid value: Month, which indicates that resources are billed only on a monthly basis.
1532
+ * Valid value: Month. Only monthly billing is supported.
1330
1533
  *
1331
- * This parameter was changed on October 15, 2024. For more information, see [Announcement on changes to the parameter behavior of the CreateCluster operation](https://help.aliyun.com/document_detail/2849194.html).
1534
+ * This parameter changed on October 15, 2024. For more information, see [Announcement on Changes to CreateCluster API Parameters](https://help.aliyun.com/document_detail/2849194.html).
1332
1535
  *
1333
1536
  * @example
1334
1537
  * Month
@@ -1338,16 +1541,21 @@ export class CreateClusterRequest extends $dara.Model {
1338
1541
  periodUnit?: string;
1339
1542
  /**
1340
1543
  * @remarks
1341
- * [**Deprecated**] When you configure a node pool, use the `platform` parameter of the `scaling_group` field in the `nodepool` section instead.
1544
+ * **[Deprecated]** For node pool configuration, use the `platform` parameter under `scaling_group` in `nodepool`.
1545
+ *
1546
+ * Operating system distribution. Valid values:
1342
1547
  *
1343
- * The OS distribution that is used. Valid values:
1548
+ * - CentOS
1344
1549
  *
1345
- * * CentOS
1346
- * * AliyunLinux
1347
- * * QbootAliyunLinux
1348
- * * Qboot
1349
- * * Windows
1350
- * * WindowsCore
1550
+ * - AliyunLinux
1551
+ *
1552
+ * - QbootAliyunLinux
1553
+ *
1554
+ * - Qboot
1555
+ *
1556
+ * - Windows
1557
+ *
1558
+ * - WindowsCore
1351
1559
  *
1352
1560
  * Default value: `CentOS`.
1353
1561
  *
@@ -1359,21 +1567,24 @@ export class CreateClusterRequest extends $dara.Model {
1359
1567
  platform?: string;
1360
1568
  /**
1361
1569
  * @remarks
1362
- * If you select Terway as the network plug-in, you must allocate vSwitches to pods. For each vSwitch that allocates IP addresses to worker nodes, you must select a vSwitch in the same zone to allocate IP addresses to pods.
1570
+ * **[Deprecated]** When using the Terway network plugin, specify virtual switches to assign IP addresses to pods. Each pod virtual switch corresponds to a worker node virtual switch, and both must be in the same zone.
1363
1571
  *
1364
- * > We recommend that you select pod vSwitches whose subnet masks do not exceed 19 bits in length. The maximum subnet mask length of a pod vSwitch is 25 bits. If you select a pod vSwitch whose subnet mask exceeds 25 bits in length, the IP addresses that can be allocated to pods may be insufficient.
1572
+ * > We recommend that the pod virtual switch CIDR mask not exceed /19 and must not exceed /25. Otherwise, the number of assignable pod IP addresses becomes very limited, affecting normal cluster operation.
1365
1573
  *
1366
1574
  * @deprecated
1367
1575
  */
1368
1576
  podVswitchIds?: string[];
1369
1577
  /**
1370
1578
  * @remarks
1371
- * If you set `cluster_type` to `ManagedKubernetes`, an ACK managed cluster is created. In this case, you can further specify the cluster edition. Valid values:
1579
+ * When you set `cluster_type` to `ManagedKubernetes` (ACK managed cluster), you can further specify the cluster subtype.
1580
+ *
1581
+ * - `Default`: ACK managed cluster, including ACK clusters (Pro Edition, Basic Edition).
1582
+ *
1583
+ * - `Edge`: ACK Edge cluster, including ACK Edge clusters (Pro Edition, Basic Edition).
1372
1584
  *
1373
- * * `Default`: ACK managed cluster. ACK managed clusters include ACK Basic clusters and ACK Pro clusters.
1374
- * * `Edge`: ACK Edge cluster. ACK Edge clusters include ACK Edge Basic clusters and ACK Edge Pro clusters.
1375
- * * `Serverless`: ACK Serverless cluster. ACK Serverless clusters include ACK Serverless Basic clusters and ACK Serverless Pro clusters.
1376
- * * `Lingjun`: ACK Lingjun Pro cluster.
1585
+ * - `Serverless`: ACK serverless cluster, including ACK serverless clusters (Pro Edition, Basic Edition).
1586
+ *
1587
+ * - `Lingjun`: ACK LINGJUN cluster, available only in Pro Edition.
1377
1588
  *
1378
1589
  * @example
1379
1590
  * Default
@@ -1381,10 +1592,14 @@ export class CreateClusterRequest extends $dara.Model {
1381
1592
  profile?: string;
1382
1593
  /**
1383
1594
  * @remarks
1384
- * The kube-proxy mode. Valid values:
1595
+ * kube-proxy proxy mode
1596
+ *
1597
+ * - `iptables`: A mature and stable kube-proxy mode. Kubernetes Service discovery and load balancing use iptables rules. Performance is moderate and scales poorly with large numbers of Services. Suitable for clusters with few Services.
1598
+ *
1599
+ * - `ipvs`: A high-performance kube-proxy mode. Kubernetes Service discovery and load balancing use the Linux IPVS module. Suitable for clusters with many Services requiring high-performance load balancing.
1385
1600
  *
1386
- * * `iptables`: a mature and stable mode that uses iptables rules to conduct service discovery and load balancing. The performance of this mode is limited by the size of the cluster. This mode is suitable for clusters that run a small number of Services.
1387
- * * `ipvs`: a mode that provides high performance and uses IP Virtual Server (IPVS) to conduct service discovery and load balancing. This mode is suitable for clusters that run a large number of Services. We recommend that you use this mode in scenarios that require high-performance load balancing.
1601
+ * - `nftables`: A next-generation kube-proxy mode based on Linux nftables for Service discovery and load balancing. It is the modern replacement for iptables. Compared to iptables, nftables offers better network performance, faster rule updates, and superior scalability for large numbers of Services.<br>
1602
+ * Supported only for clusters running Kubernetes version 1.35 or later. The Kubernetes community deprecated IPVS starting in version 1.35. We recommend using nftables for new clusters to ensure long-term community support.<br>
1388
1603
  *
1389
1604
  * Default value: `ipvs`.
1390
1605
  *
@@ -1394,16 +1609,16 @@ export class CreateClusterRequest extends $dara.Model {
1394
1609
  proxyMode?: string;
1395
1610
  /**
1396
1611
  * @remarks
1397
- * [**Deprecated**] When you configure a node pool, use the `rds_instances` parameter of the `scaling_group` field in the `nodepool` section instead.
1612
+ * **[Deprecated]** For node pool configuration, use the `rds_instances` parameter under `scaling_group` in `nodepool`.
1398
1613
  *
1399
- * The ApsaraDB RDS instances. The pod CIDR block and node CIDR block are added to the whitelists of the ApsaraDB RDS instances. We recommend that you add the pod CIDR block and node CIDR block to the whitelists of the ApsaraDB RDS instances in the ApsaraDB RDS console. If the RDS instances are not in the Running state, new nodes cannot be added to the cluster.
1614
+ * List of RDS instances to add to the whitelist. We recommend adding the pod and node CIDR blocks of your container cluster to the RDS whitelist. Setting RDS instances might fail if they are not in the Running state.
1400
1615
  *
1401
1616
  * @deprecated
1402
1617
  */
1403
1618
  rdsInstances?: string[];
1404
1619
  /**
1405
1620
  * @remarks
1406
- * The ID of the region in which the cluster is deployed. For more information about the regions supported by ACK, see [Regions supported by ACK](https://help.aliyun.com/document_detail/216938.html).
1621
+ * The region ID where the cluster is deployed. For more information, see [Regions supported by Container Service for Kubernetes](https://help.aliyun.com/document_detail/216938.html).
1407
1622
  *
1408
1623
  * This parameter is required.
1409
1624
  *
@@ -1413,25 +1628,31 @@ export class CreateClusterRequest extends $dara.Model {
1413
1628
  regionId?: string;
1414
1629
  /**
1415
1630
  * @remarks
1416
- * The ID of the resource group to which the cluster belongs. You can use resource groups to isolate clusters.
1631
+ * The resource group ID to which the cluster belongs, used to isolate different resources.
1417
1632
  *
1418
1633
  * @example
1419
1634
  * rg-acfm3mkrure****
1420
1635
  */
1421
1636
  resourceGroupId?: string;
1637
+ /**
1638
+ * @remarks
1639
+ * RRSA feature configuration.
1640
+ */
1422
1641
  rrsaConfig?: CreateClusterRequestRrsaConfig;
1423
1642
  /**
1424
1643
  * @remarks
1425
- * The container runtime. The default container runtime is Docker. containerd and Sandboxed-Container are also supported.
1644
+ * Container runtime for the cluster. Supports containerd, sandboxed containers, and Docker.
1426
1645
  *
1427
- * For more information about how to select a proper container runtime, see [Comparison among Docker, containerd, and Sandboxed-Container](https://help.aliyun.com/document_detail/160313.html).
1646
+ * > Kubernetes 1.24 no longer supports Docker as a built-in container runtime.
1647
+ *
1648
+ * For more information, see [Comparison of Docker, containerd, and sandboxed container runtimes](https://help.aliyun.com/document_detail/160313.html).
1428
1649
  *
1429
1650
  * @deprecated
1430
1651
  */
1431
1652
  runtime?: Runtime;
1432
1653
  /**
1433
1654
  * @remarks
1434
- * The ID of an existing security group. You must specify this parameter or `is_enterprise_security_group`. Cluster nodes are automatically added to the security group.
1655
+ * Specify an existing security group ID when creating a cluster. Choose either this parameter or `is_enterprise_security_group`. Cluster nodes are automatically added to this security group.
1435
1656
  *
1436
1657
  * @example
1437
1658
  * sg-bp1bdue0qc1g7k****
@@ -1439,12 +1660,13 @@ export class CreateClusterRequest extends $dara.Model {
1439
1660
  securityGroupId?: string;
1440
1661
  /**
1441
1662
  * @remarks
1442
- * [**Deprecated**] When you configure the control plane, use the `security_hardening_os` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `security_hardening_os` parameter of the `scaling_group` field in the `nodepool` section instead.
1663
+ * **[Deprecated]** For control plane configuration, use the `security_hardening_os` parameter under `control_plane_config`. For node pool configuration, use the `security_hardening_os` parameter under `scaling_group` in `nodepool`.
1664
+ *
1665
+ * Alibaba Cloud OS security hardening. Valid values:
1443
1666
  *
1444
- * Specifies whether to enable Alibaba Cloud Linux Security Hardening. Valid values:
1667
+ * - `true`: Enable Alibaba Cloud OS security hardening.
1445
1668
  *
1446
- * * `true`: enables Alibaba Cloud Linux Security Hardening.
1447
- * * `false`: disables Alibaba Cloud Linux Security Hardening.
1669
+ * - `false`: Disable Alibaba Cloud OS security hardening.
1448
1670
  *
1449
1671
  * Default value: `false`.
1450
1672
  *
@@ -1456,9 +1678,9 @@ export class CreateClusterRequest extends $dara.Model {
1456
1678
  securityHardeningOs?: boolean;
1457
1679
  /**
1458
1680
  * @remarks
1459
- * Service accounts provide identities for pods when pods communicate with the `API server` of the cluster. `service-account-issuer` specifies the issuer of the `serviceaccount token`, which is specified by using the `iss` field in the `token payload`.
1681
+ * ServiceAccount is the access credential used by pods to communicate with the cluster API Server. The `service-account-issuer` is the issuer identity in the `serviceaccount token`, represented by the `iss` field in the `token payload`.
1460
1682
  *
1461
- * For more information about `ServiceAccount`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
1683
+ * For more information about `ServiceAccount`, see [Deploy service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
1462
1684
  *
1463
1685
  * @example
1464
1686
  * kubernetes.default.svc
@@ -1466,9 +1688,10 @@ export class CreateClusterRequest extends $dara.Model {
1466
1688
  serviceAccountIssuer?: string;
1467
1689
  /**
1468
1690
  * @remarks
1469
- * The Service CIDR block. Valid values: 10.0.0.0/16-24, 172.16-31.0.0/16-24, and 192.168.0.0/16-24. The Service CIDR block cannot overlap with the VPC CIDR block (10.1.0.0/21) or the CIDR blocks of existing clusters in the VPC. You cannot modify the Service CIDR block after the cluster is created.
1691
+ * Service network CIDR block. Valid ranges: 10.0.0.0/16-24, 172.16.0.0/16-24 to 172.31.0.0/16-24, 192.168.0.0/16-24.
1692
+ * It cannot overlap with the VPC CIDR block 10.1.0.0/21 or existing Kubernetes cluster CIDR blocks in the VPC. This cannot be modified after cluster creation.
1470
1693
  *
1471
- * By default, the Service CIDR block is set to 172.19.0.0/20.
1694
+ * Default value: 172.19.0.0/20.
1472
1695
  *
1473
1696
  * @example
1474
1697
  * 172.21.0.0/20
@@ -1476,41 +1699,44 @@ export class CreateClusterRequest extends $dara.Model {
1476
1699
  serviceCidr?: string;
1477
1700
  /**
1478
1701
  * @remarks
1479
- * The methods for implementing service discovery in `ACK Serverless` clusters.
1702
+ * **[Deprecated]** Service discovery type for the cluster, used to specify the service discovery method in `ACK Serverless` clusters.
1703
+ *
1704
+ * - `CoreDNS`: Uses the standard Kubernetes service discovery component CoreDNS. Requires deploying a set of containers for DNS resolution. Defaults to two ECI instances with 0.25 vCPU and 512 MiB memory each.
1480
1705
  *
1481
- * * `CoreDNS`: a standard service discovery plug-in that is provided by open source Kubernetes. To use DNS resolution, you must provision pods. By default, two elastic container instances are used. The specification of each instance is 0.25 vCores and 512 MiB of memory.
1482
- * * `PrivateZone`: a DNS resolution service provided by Alibaba Cloud. You must activate Alibaba Cloud DNS PrivateZone before you can use it for service discovery.
1706
+ * - `PrivateZone`: Uses Alibaba Cloud PrivateZone for service discovery. Requires enabling the PrivateZone service.
1483
1707
  *
1484
- * By default, this parameter is not specified.
1708
+ * Default value: Disabled.
1485
1709
  *
1486
1710
  * @deprecated
1487
1711
  */
1488
1712
  serviceDiscoveryTypes?: string[];
1489
1713
  /**
1490
1714
  * @remarks
1491
- * Specifies whether to configure SNAT rules for the VPC in which your cluster is deployed. Valid values:
1715
+ * Configure SNAT for the VPC. Valid values:
1492
1716
  *
1493
- * * `true`: automatically creates a NAT gateway and configures SNAT rules. Set the value to `true` if nodes and applications in the cluster need to access the Internet.
1494
- * * `false`: does not create a NAT gateway or configure SNAT rules. In this case, nodes and applications in the cluster cannot access the Internet.
1717
+ * - `true`: Automatically create a NAT Gateway and configure SNAT rules. Set this to `true` if nodes or applications in the cluster need public network access.
1495
1718
  *
1496
- * > If this feature is disabled when you create the cluster, you can also manually enable this feature after you create the cluster. For more information, see [Enable an existing ACK cluster to access the Internet](https://help.aliyun.com/document_detail/178480.html).
1719
+ * - `false`: Do not create a NAT Gateway or SNAT rules. Nodes and applications in the cluster cannot access the public network.
1497
1720
  *
1498
- * Default value: `true`.
1721
+ * > If you do not enable this during cluster creation but later need public network access, you can [enable it manually](https://help.aliyun.com/document_detail/178480.html).
1722
+ *
1723
+ * Default value: `false`.
1499
1724
  *
1500
1725
  * @example
1501
- * true
1726
+ * false
1502
1727
  */
1503
1728
  snatEntry?: boolean;
1504
1729
  /**
1505
1730
  * @remarks
1506
- * [**Deprecated**] When you configure the control plane, use the `soc_enabled` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `soc_enabled` parameter of the `scaling_group` field in the `nodepool` section instead.
1731
+ * **[Deprecated]** For control plane node configuration, use the `soc_enabled` parameter under `control_plane_config`. For node pool configuration, use the `soc_enabled` parameter under `scaling_group` in `nodepool`.
1507
1732
  *
1508
- * Specifies whether to enable Multi-Level Protection Scheme (MLPS) security hardening. For more information, see [ACK security hardening based on MLPS](https://help.aliyun.com/document_detail/196148.html).
1733
+ * MLPS 2.0 security hardening. For more information, see [Using MLPS 2.0 security hardening in ACK](https://help.aliyun.com/document_detail/196148.html).
1509
1734
  *
1510
1735
  * Valid values:
1511
1736
  *
1512
- * * `true`: enables MLPS security hardening.
1513
- * * `false`: disables MLPS security hardening.
1737
+ * - `true`: Enable MLPS 2.0 security hardening.
1738
+ *
1739
+ * - `false`: Disable MLPS 2.0 security hardening.
1514
1740
  *
1515
1741
  * Default value: `false`.
1516
1742
  *
@@ -1522,10 +1748,11 @@ export class CreateClusterRequest extends $dara.Model {
1522
1748
  socEnabled?: boolean;
1523
1749
  /**
1524
1750
  * @remarks
1525
- * Specifies whether to enable SSH logon. If this parameter is set to true, you can log on to master nodes in an ACK dedicated cluster over the Internet. This parameter does not take effect for ACK managed clusters. Valid values:
1751
+ * Whether to enable public SSH logon. Used to log on to master nodes of ACK dedicated clusters. This parameter does not take effect for managed clusters.
1526
1752
  *
1527
- * * `true`: enables SSH logon.
1528
- * * `false`: disables SSH logon.
1753
+ * - `true`: Enable.
1754
+ *
1755
+ * - `false`: Disable.
1529
1756
  *
1530
1757
  * Default value: `false`.
1531
1758
  *
@@ -1535,26 +1762,27 @@ export class CreateClusterRequest extends $dara.Model {
1535
1762
  sshFlags?: boolean;
1536
1763
  /**
1537
1764
  * @remarks
1538
- * The labels that you want to add to nodes. You must add labels based on the following rules:
1765
+ * Node labels. Label rules:
1766
+ *
1767
+ * - Labels consist of case-sensitive key-value pairs. You can add up to 20 tags.
1539
1768
  *
1540
- * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
1541
- * * When you add a label, you must specify a unique key, but you can leave the value empty. A key cannot exceed 64 characters in length, and a value cannot exceed 128 characters in length. Keys and values cannot start with aliyun, acs:, https://, or http://. For more information, see [Labels and Selectors](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#syntax-and-character-set).
1769
+ * - Tag keys must be unique and up to 64 characters long. Tag values can be empty and up to 128 characters long. Neither tag keys nor tag values can start with "aliyun", "acs:", "https\\://", or "http\\://". For more information, see [Labels and Selectors](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#syntax-and-character-set).
1542
1770
  */
1543
1771
  tags?: Tag[];
1544
1772
  /**
1545
1773
  * @remarks
1546
- * [**Deprecated**] When you configure a node pool, use the `taints` parameter of the `kubernetes_config` field in the `nodepool` section instead.
1774
+ * **[Deprecated]** For node pool configuration, use the `taints` parameter under `kubernetes_config` in `nodepool`.
1547
1775
  *
1548
- * The taints that you want to add to nodes. Taints can be used together with tolerations to avoid scheduling pods to specific nodes. For more information, see [taint-and-toleration](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/).
1776
+ * Node taint information. Taints and tolerations work together to prevent pods from being scheduled onto unsuitable nodes. For more information, see [taint-and-toleration](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/).
1549
1777
  *
1550
1778
  * @deprecated
1551
1779
  */
1552
1780
  taints?: Taint[];
1553
1781
  /**
1554
1782
  * @remarks
1555
- * [**Deprecated**] By default, the system does not perform a rollback when the cluster fails to be created. You must manually delete the cluster that fails to be created.
1783
+ * **[Deprecated]** By default, clusters are not rolled back on creation failure. You must manually clean up failed clusters.
1556
1784
  *
1557
- * Specifies the timeout period of cluster creation. Unit: minutes.
1785
+ * Cluster creation timeout in minutes.
1558
1786
  *
1559
1787
  * Default value: `60`.
1560
1788
  *
@@ -1566,7 +1794,7 @@ export class CreateClusterRequest extends $dara.Model {
1566
1794
  timeoutMins?: number;
1567
1795
  /**
1568
1796
  * @remarks
1569
- * The time zone of the cluster.
1797
+ * Time zone used by the cluster. See [Supported time zones](https://help.aliyun.com/document_detail/354879.html).
1570
1798
  *
1571
1799
  * @example
1572
1800
  * Asia/Shanghai
@@ -1574,7 +1802,7 @@ export class CreateClusterRequest extends $dara.Model {
1574
1802
  timezone?: string;
1575
1803
  /**
1576
1804
  * @remarks
1577
- * The custom Certificate Authority (CA) certificate used by the cluster.
1805
+ * Custom cluster CA.
1578
1806
  *
1579
1807
  * @example
1580
1808
  * -----BEGIN CERTIFICATE-----****
@@ -1582,7 +1810,7 @@ export class CreateClusterRequest extends $dara.Model {
1582
1810
  userCa?: string;
1583
1811
  /**
1584
1812
  * @remarks
1585
- * The user data of nodes.
1813
+ * **[Deprecated]** Custom node data.
1586
1814
  *
1587
1815
  * @example
1588
1816
  * IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD****
@@ -1592,7 +1820,7 @@ export class CreateClusterRequest extends $dara.Model {
1592
1820
  userData?: string;
1593
1821
  /**
1594
1822
  * @remarks
1595
- * The virtual private cloud (VPC) in which you want to deploy the cluster. This parameter is required.
1823
+ * The VPC used by the cluster. You must provide this when creating a cluster.
1596
1824
  *
1597
1825
  * @example
1598
1826
  * vpc-2zeik9h3ahvv2zz95****
@@ -1600,17 +1828,18 @@ export class CreateClusterRequest extends $dara.Model {
1600
1828
  vpcid?: string;
1601
1829
  /**
1602
1830
  * @remarks
1603
- * The vSwitches for nodes in the cluster. This parameter is required if you create an ACK managed cluster that does not contain nodes.
1831
+ * Virtual switches for cluster nodes. This field is required when creating a zero-node managed cluster.
1604
1832
  */
1605
1833
  vswitchIds?: string[];
1606
1834
  /**
1607
1835
  * @remarks
1608
- * [**Deprecated**] When you configure a node pool, use the `auto_renew` parameter of the `scaling_group` field in the `nodepool` section instead.
1836
+ * **[Deprecated]** For node pool configuration, use the `auto_renew` parameter under `scaling_group` in `nodepool`.
1837
+ *
1838
+ * Whether to enable auto-renewal for worker nodes. Valid only when `worker_instance_charge_type` is `PrePaid`. Valid values:
1609
1839
  *
1610
- * Specifies whether to enable auto-renewal for worker nodes. This parameter takes effect and is required only when `worker_instance_charge_type` is set to `PrePaid`. Valid values:
1840
+ * - `true`: Enable auto-renewal.
1611
1841
  *
1612
- * * `true`: enables auto-renewal.
1613
- * * `false`: disables auto-renewal.
1842
+ * - `false`: Disable auto-renewal.
1614
1843
  *
1615
1844
  * Default value: `true`.
1616
1845
  *
@@ -1622,11 +1851,11 @@ export class CreateClusterRequest extends $dara.Model {
1622
1851
  workerAutoRenew?: boolean;
1623
1852
  /**
1624
1853
  * @remarks
1625
- * [**Deprecated**] When you configure a node pool, use the `auto_renew_period` parameter of the `scaling_group` field in the `nodepool` section instead.
1854
+ * **[Deprecated]** For node pool configuration, use the `auto_renew_period` parameter under `scaling_group` in `nodepool`.
1626
1855
  *
1627
- * The auto-renewal duration of worker nodes. This parameter takes effect and is required only if the subscription billing method is selected for worker nodes.
1856
+ * Auto-renewal period for worker nodes in months. Required and valid only when subscription billing is selected.
1628
1857
  *
1629
- * Valid values: 1, 2, 3, 6, and 12.
1858
+ * Valid values: {1, 2, 3, 6, 12}.
1630
1859
  *
1631
1860
  * @example
1632
1861
  * 1
@@ -1636,23 +1865,24 @@ export class CreateClusterRequest extends $dara.Model {
1636
1865
  workerAutoRenewPeriod?: number;
1637
1866
  /**
1638
1867
  * @remarks
1639
- * [**Deprecated**] When you configure a node pool, use the `data_disks` parameter of the `scaling_group` field in the `nodepool` section instead.
1868
+ * **[Deprecated]** For node pool configuration, use the `data_disks` parameter under `scaling_group` in `nodepool`.
1640
1869
  *
1641
- * The configurations of the data disks that you want to mount to worker nodes. The configurations include the disk category and disk size.
1870
+ * Configuration for worker node data disks, including type and size.
1642
1871
  *
1643
1872
  * @deprecated
1644
1873
  */
1645
1874
  workerDataDisks?: CreateClusterRequestWorkerDataDisks[];
1646
1875
  /**
1647
1876
  * @remarks
1648
- * [**Deprecated**] When you configure a node pool, use the `instance_charge_type` parameter of the `scaling_group` field in the `nodepool` section instead.
1877
+ * **[Deprecated]** For node pool configuration, use the `instance_charge_type` parameter under `scaling_group` in `nodepool`.
1649
1878
  *
1650
- * The billing method of worker nodes. Valid values:
1879
+ * Worker node billing type. Valid values:
1651
1880
  *
1652
- * * `PrePaid`: subscription.
1653
- * * `PostPaid`: pay-as-you-go.
1881
+ * - `PrePaid`: Subscription.
1654
1882
  *
1655
- * Default value: PostPaid.
1883
+ * - `PostPaid`: Pay-as-you-go.
1884
+ *
1885
+ * Default value: Pay-as-you-go.
1656
1886
  *
1657
1887
  * @example
1658
1888
  * PrePaid
@@ -1662,20 +1892,20 @@ export class CreateClusterRequest extends $dara.Model {
1662
1892
  workerInstanceChargeType?: string;
1663
1893
  /**
1664
1894
  * @remarks
1665
- * [**Deprecated**] When you configure a node pool, use the `instance_types` parameter of the `scaling_group` field in the `nodepool` section instead.
1895
+ * **[Deprecated]** For node pool configuration, use the `instance_types` parameter under `scaling_group` in `nodepool`.
1666
1896
  *
1667
- * The instance configurations of worker nodes.
1897
+ * Worker node instance configuration.
1668
1898
  *
1669
1899
  * @deprecated
1670
1900
  */
1671
1901
  workerInstanceTypes?: string[];
1672
1902
  /**
1673
1903
  * @remarks
1674
- * [**Deprecated**] When you configure a node pool, use the `period` parameter of the `scaling_group` field in the `nodepool` section instead.
1904
+ * **[Deprecated]** For node pool configuration, use the `period` parameter under `scaling_group` in `nodepool`.
1675
1905
  *
1676
- * The subscription duration of worker nodes. This parameter takes effect and is required only when `worker_instance_charge_type` is set to `PrePaid`.
1906
+ * Subscription duration for worker nodes in months. Required and valid only when `worker_instance_charge_type` is `PrePaid`.
1677
1907
  *
1678
- * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
1908
+ * Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.
1679
1909
  *
1680
1910
  * Default value: 1.
1681
1911
  *
@@ -1687,11 +1917,11 @@ export class CreateClusterRequest extends $dara.Model {
1687
1917
  workerPeriod?: number;
1688
1918
  /**
1689
1919
  * @remarks
1690
- * [**Deprecated**] When you configure a node pool, use the `period_unit` parameter of the `scaling_group` field in the `nodepool` section instead.
1920
+ * **[Deprecated]** For node pool configuration, use the `period_unit` parameter under `scaling_group` in `nodepool`.
1691
1921
  *
1692
- * The billing cycle of worker nodes. This parameter is required if worker_instance_charge_type is set to `PrePaid`.
1922
+ * Worker node billing cycle. Required when worker_instance_charge_type is `PrePaid`.
1693
1923
  *
1694
- * Valid value: `Month`, which indicates that worker nodes are billed only on a monthly basis.
1924
+ * Valid value: `Month`. Only monthly billing is supported.
1695
1925
  *
1696
1926
  * @example
1697
1927
  * Month
@@ -1701,14 +1931,15 @@ export class CreateClusterRequest extends $dara.Model {
1701
1931
  workerPeriodUnit?: string;
1702
1932
  /**
1703
1933
  * @remarks
1704
- * [**Deprecated**] When you configure a node pool, use the `system_disk_category` parameter of the `scaling_group` field in the `nodepool` section instead.
1934
+ * **[Deprecated]** For node pool configuration, use the `system_disk_category` parameter under `scaling_group` in `nodepool`.
1705
1935
  *
1706
- * The system disk category of worker nodes. For more information, see [Elastic Block Storage devices](https://help.aliyun.com/document_detail/63136.html).
1936
+ * Worker node system disk type. For more information, see [Overview of Elastic Block Storage](https://help.aliyun.com/document_detail/63136.html).
1707
1937
  *
1708
1938
  * Valid values:
1709
1939
  *
1710
- * * `cloud_efficiency`: ultra disk.
1711
- * * `cloud_ssd`: standard SSD.
1940
+ * - `cloud_efficiency`: Ultra disk.
1941
+ *
1942
+ * - `cloud_ssd`: Standard SSD.
1712
1943
  *
1713
1944
  * Default value: `cloud_ssd`.
1714
1945
  *
@@ -1720,16 +1951,19 @@ export class CreateClusterRequest extends $dara.Model {
1720
1951
  workerSystemDiskCategory?: string;
1721
1952
  /**
1722
1953
  * @remarks
1723
- * [**Deprecated**] When you configure a node pool, use the `system_disk_performance_level` parameter of the `scaling_group` field in the `nodepool` section instead.
1954
+ * **[Deprecated]** For node pool configuration, use the `system_disk_performance_level` parameter under `scaling_group` in `nodepool`.
1724
1955
  *
1725
- * If the system disk is an ESSD, you can specify the PL of the ESSD. For more information, see [Enterprise SSDs](https://help.aliyun.com/document_detail/122389.html).
1956
+ * When the system disk is an ESSD, you can set the performance level (PL). For more information, see [ESSD](https://help.aliyun.com/document_detail/122389.html).
1726
1957
  *
1727
1958
  * Valid values:
1728
1959
  *
1729
- * * PL0
1730
- * * PL1
1731
- * * PL2
1732
- * * PL3
1960
+ * - PL0
1961
+ *
1962
+ * - PL1
1963
+ *
1964
+ * - PL2
1965
+ *
1966
+ * - PL3
1733
1967
  *
1734
1968
  * @example
1735
1969
  * PL1
@@ -1739,13 +1973,13 @@ export class CreateClusterRequest extends $dara.Model {
1739
1973
  workerSystemDiskPerformanceLevel?: string;
1740
1974
  /**
1741
1975
  * @remarks
1742
- * [**Deprecated**] When you configure a node pool, use the `system_disk_size` parameter of the `scaling_group` field in the `nodepool` section instead.
1976
+ * **[Deprecated]** For node pool configuration, use the `system_disk_size` parameter under `scaling_group` in `nodepool`.
1743
1977
  *
1744
- * The system disk size of worker nodes. Unit: GiB.
1978
+ * Worker node system disk size in GiB.
1745
1979
  *
1746
- * Valid values: 40 to 500.
1980
+ * Valid range: [40,500].
1747
1981
  *
1748
- * The value of this parameter must be at least 40 and greater than or equal to the image size.
1982
+ * This value must be greater than or equal to max{40, ImageSize}.
1749
1983
  *
1750
1984
  * Default value: `120`.
1751
1985
  *
@@ -1757,9 +1991,9 @@ export class CreateClusterRequest extends $dara.Model {
1757
1991
  workerSystemDiskSize?: number;
1758
1992
  /**
1759
1993
  * @remarks
1760
- * [**Deprecated**] When you configure a node pool, use the `system_disk_snapshot_policy_id` parameter of the `scaling_group` field in the `nodepool` section instead.
1994
+ * **[Deprecated]** For node pool configuration, use the `system_disk_snapshot_policy_id` parameter under `scaling_group` in `nodepool`.
1761
1995
  *
1762
- * The ID of the automatic snapshot policy that is used by the system disk specified for worker nodes.
1996
+ * Automatic snapshot policy ID for worker node system disks.
1763
1997
  *
1764
1998
  * @example
1765
1999
  * sp-2zej1nogjvovnz4z****
@@ -1769,22 +2003,22 @@ export class CreateClusterRequest extends $dara.Model {
1769
2003
  workerSystemDiskSnapshotPolicyId?: string;
1770
2004
  /**
1771
2005
  * @remarks
1772
- * [**Deprecated**] When you configure a node pool, use the `vswitch_ids` parameter of the `scaling_group` field in the `nodepool` section instead.
2006
+ * **[Deprecated]** For node pool configuration, use the `vswitch_ids` parameter under `scaling_group` in `nodepool`.
1773
2007
  *
1774
- * The vSwitches for worker nodes. Each worker node is allocated a vSwitch.
2008
+ * List of vSwitches used by cluster nodes. One node corresponds to one value.
1775
2009
  *
1776
- * `worker_vswitch_ids` is optional, but `vswitch_ids` is required if you create an ACK managed cluster that does not contain nodes.
2010
+ * When creating a zero-node managed cluster, `worker_vswitch_ids` is optional, but you must provide `vswitch_ids`.
1777
2011
  *
1778
2012
  * @deprecated
1779
2013
  */
1780
2014
  workerVswitchIds?: string[];
1781
2015
  /**
1782
2016
  * @remarks
1783
- * [Deprecated] Use the `zone_ids` parameter instead.
2017
+ * **[Deprecated]** Use the `zone_ids` parameter instead.
1784
2018
  *
1785
- * The ID of the zone to which the cluster belongs. This parameter is specific to ACK Serverless clusters.
2019
+ * The zone ID in the cluster region. This parameter applies only to ACK managed clusters.
1786
2020
  *
1787
- * When you create an ACK managed cluster, you must set the `zone_id` parameter if `vpc_id` and `vswitch_ids` are not specified. This way, the system automatically creates a VPC in the specified zone. This parameter is invalid if you specify the `vpc_id` and `vswitch_ids` parameters.
2021
+ * When creating an ACK managed cluster, if you do not specify `vpc_id` and `vswitch_ids`, you must specify `zone_id` to automatically create VPC network resources in this zone. This parameter is ignored if you specify `vpc_id` and `vswitch_ids`.
1788
2022
  *
1789
2023
  * @example
1790
2024
  * cn-beiji****
@@ -1794,9 +2028,7 @@ export class CreateClusterRequest extends $dara.Model {
1794
2028
  zoneId?: string;
1795
2029
  /**
1796
2030
  * @remarks
1797
- * The IDs of the zone in which the cluster is deployed. This parameter is specific to ACK managed clusters.
1798
- *
1799
- * When you create an ACK managed cluster, you must set the `zone_id` parameter if `vpc_id` and `vswitch_ids` are not specified. This way, the system automatically creates a VPC in the specified zone. This parameter is invalid if you specify the `vpc_id` and `vswitch_ids` parameters.
2031
+ * A list of zone IDs in the cluster region. This parameter applies only to ACK managed clusters.
1800
2032
  */
1801
2033
  zoneIds?: string[];
1802
2034
  static names(): { [key: string]: string } {