@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
@@ -7,7 +7,29 @@ import { Tag } from "./Tag";
7
7
  import { Taint } from "./Taint";
8
8
  import { InstanceMetadataOptions } from "./InstanceMetadataOptions";
9
9
  export declare class CreateClusterRequestAuditLogConfig extends $dara.Model {
10
+ /**
11
+ * @remarks
12
+ * Whether to enable cluster audit logging.
13
+ *
14
+ * - true: Enable.
15
+ *
16
+ * - false: Disable.
17
+ *
18
+ * @example
19
+ * true
20
+ */
10
21
  enabled?: boolean;
22
+ /**
23
+ * @remarks
24
+ * 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.
25
+ *
26
+ * - Default value: `k8s-log-{clusterid}`.
27
+ *
28
+ * - When audit logging is enabled, a Logstore for audit logs is created in the specified SLS Project.
29
+ *
30
+ * @example
31
+ * k8s-log-c2345xxxxxxxxxxxx
32
+ */
11
33
  slsProjectName?: string;
12
34
  static names(): {
13
35
  [key: string]: string;
@@ -21,6 +43,17 @@ export declare class CreateClusterRequestAuditLogConfig extends $dara.Model {
21
43
  });
22
44
  }
23
45
  export declare class CreateClusterRequestAutoMode extends $dara.Model {
46
+ /**
47
+ * @remarks
48
+ * Whether to enable Intelligent Managed Mode.
49
+ *
50
+ * - true: Enable.
51
+ *
52
+ * - false: Disable.
53
+ *
54
+ * @example
55
+ * true
56
+ */
24
57
  enable?: boolean;
25
58
  static names(): {
26
59
  [key: string]: string;
@@ -36,7 +69,13 @@ export declare class CreateClusterRequestAutoMode extends $dara.Model {
36
69
  export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model {
37
70
  /**
38
71
  * @remarks
39
- * Specifies whether to enable auto-renewal for the node.
72
+ * Whether to enable auto-renewal for control plane nodes. Valid only when charge_type is `PrePaid`.
73
+ *
74
+ * - true: Enable auto-renewal.
75
+ *
76
+ * - false: Disable auto-renewal.
77
+ *
78
+ * Default value: true.
40
79
  *
41
80
  * @example
42
81
  * true
@@ -44,7 +83,11 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
44
83
  autoRenew?: boolean;
45
84
  /**
46
85
  * @remarks
47
- * The auto-renewal duration for the node.
86
+ * Auto-renewal duration for control plane nodes in months.
87
+ *
88
+ * Valid values: {1, 2, 3, 6, 12}.
89
+ *
90
+ * Default value: 1.
48
91
  *
49
92
  * @example
50
93
  * 1
@@ -52,23 +95,41 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
52
95
  autoRenewPeriod?: number;
53
96
  /**
54
97
  * @remarks
55
- * The billing method of the node.
98
+ * Control plane node billing type.
99
+ *
100
+ * - `PrePaid`: Subscription.
101
+ *
102
+ * - `PostPaid`: Pay-as-you-go.
103
+ *
104
+ * Default value: `PostPaid`.
56
105
  *
57
106
  * @example
58
- * PrePaid
107
+ * PostPaid
59
108
  */
60
109
  chargeType?: string;
61
110
  /**
62
111
  * @remarks
63
- * Specifies whether to install CloudMonitor on the node.
112
+ * Whether to install Cloud Monitor on nodes.
113
+ *
114
+ * - true: Install the CloudMonitor agent.
115
+ *
116
+ * - false: Do not install the CloudMonitor agent.
117
+ *
118
+ * Default value: false.
64
119
  *
65
120
  * @example
66
- * true
121
+ * false
67
122
  */
68
123
  cloudMonitorFlags?: boolean;
69
124
  /**
70
125
  * @remarks
71
- * The CPU management policy of the node.
126
+ * Node CPU management policy.
127
+ *
128
+ * - static: Enhances CPU affinity and exclusivity for pods with specific resource characteristics on the node.
129
+ *
130
+ * - none: Uses the default CPU affinity scheme.
131
+ *
132
+ * Default value: none.
72
133
  *
73
134
  * @example
74
135
  * none
@@ -76,7 +137,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
76
137
  cpuPolicy?: string;
77
138
  /**
78
139
  * @remarks
79
- * The ID of the deployment set.
140
+ * Deployment set ID.
80
141
  *
81
142
  * @example
82
143
  * ds-bp10b35imuam5amw****
@@ -84,7 +145,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
84
145
  deploymentsetId?: string;
85
146
  /**
86
147
  * @remarks
87
- * The image ID.
148
+ * Image ID.
88
149
  *
89
150
  * @example
90
151
  * aliyun_3_x64_20G_alibase_20240819.vhd
@@ -92,21 +153,25 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
92
153
  imageId?: string;
93
154
  /**
94
155
  * @remarks
95
- * The type of the OS image.
156
+ * Operating system image type.
96
157
  *
97
158
  * @example
98
159
  * AliyunLinux3
99
160
  */
100
161
  imageType?: string;
162
+ /**
163
+ * @remarks
164
+ * ECS instance metadata access configuration.
165
+ */
101
166
  instanceMetadataOptions?: InstanceMetadataOptions;
102
167
  /**
103
168
  * @remarks
104
- * The instance types of the nodes.
169
+ * Node instance types.
105
170
  */
106
171
  instanceTypes?: string[];
107
172
  /**
108
173
  * @remarks
109
- * The name of the key pair. You must set this parameter or login_password.
174
+ * Key pair name. Choose either this parameter or login_password.
110
175
  *
111
176
  * @example
112
177
  * ack
@@ -114,15 +179,15 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
114
179
  keyPair?: string;
115
180
  /**
116
181
  * @remarks
117
- * 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.
182
+ * 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.
118
183
  *
119
184
  * @example
120
- * ack@Test
185
+ * ********
121
186
  */
122
187
  loginPassword?: string;
123
188
  /**
124
189
  * @remarks
125
- * The node port range.
190
+ * **[Deprecated]** Node service port range.
126
191
  *
127
192
  * @example
128
193
  * 30000-32767
@@ -130,7 +195,11 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
130
195
  nodePortRange?: string;
131
196
  /**
132
197
  * @remarks
133
- * The subscription duration of the node.
198
+ * Subscription duration for control plane nodes in months. Required and valid only when charge_type is `PrePaid`.
199
+ *
200
+ * Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.
201
+ *
202
+ * Default value: 1.
134
203
  *
135
204
  * @example
136
205
  * 1
@@ -138,7 +207,9 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
138
207
  period?: number;
139
208
  /**
140
209
  * @remarks
141
- * The unit of the subscription duration of the node.
210
+ * Billing cycle unit for control plane nodes. Required and valid only when charge_type is `PrePaid`.
211
+ *
212
+ * Valid value: `Month`. Only monthly billing is supported.
142
213
  *
143
214
  * @example
144
215
  * Month
@@ -146,7 +217,9 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
146
217
  periodUnit?: string;
147
218
  /**
148
219
  * @remarks
149
- * The container runtime.
220
+ * **[Deprecated]** Control plane node runtime name. Valid value:
221
+ *
222
+ * containerd: Containerd runtime, supported for all cluster versions.
150
223
  *
151
224
  * @example
152
225
  * containerd
@@ -154,15 +227,23 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
154
227
  runtime?: string;
155
228
  /**
156
229
  * @remarks
157
- * Specifies whether to enable Alibaba Cloud Linux Security Hardening.
230
+ * Whether to enable Alibaba Cloud OS security hardening.
231
+ *
232
+ * - true: Enable Alibaba Cloud OS security hardening.
233
+ *
234
+ * - false: Disable Alibaba Cloud OS security hardening.
235
+ *
236
+ * Default value: false.
158
237
  *
159
238
  * @example
160
- * true
239
+ * false
161
240
  */
162
241
  securityHardeningOs?: boolean;
163
242
  /**
164
243
  * @remarks
165
- * The number of control plane nodes.
244
+ * Number of control plane nodes.
245
+ *
246
+ * Valid values: `3` or `5`.
166
247
  *
167
248
  * @example
168
249
  * 3
@@ -170,15 +251,27 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
170
251
  size?: number;
171
252
  /**
172
253
  * @remarks
173
- * Specifies whether to enable MLPS security hardening.
254
+ * Whether to enable MLPS 2.0 security hardening.
255
+ *
256
+ * - true: Enable MLPS 2.0 security hardening.
257
+ *
258
+ * - false: Disable MLPS 2.0 security hardening.
259
+ *
260
+ * Default value: false.
174
261
  *
175
262
  * @example
176
- * true
263
+ * false
177
264
  */
178
265
  socEnabled?: boolean;
179
266
  /**
180
267
  * @remarks
181
- * Specifies whether to enable the burst feature for the system disk.
268
+ * Whether to enable performance burst for node system disks.
269
+ *
270
+ * - true: Enable.
271
+ *
272
+ * - false: Disable.
273
+ *
274
+ * This parameter is supported only when `system_disk_category` is `cloud_auto`.
182
275
  *
183
276
  * @example
184
277
  * true
@@ -186,15 +279,29 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
186
279
  systemDiskBurstingEnabled?: boolean;
187
280
  /**
188
281
  * @remarks
189
- * The system disk category for the node.
282
+ * Node system disk type.
283
+ *
284
+ * - `cloud_efficiency`: Ultra disk.
285
+ *
286
+ * - `cloud_ssd`: Standard SSD.
287
+ *
288
+ * - `cloud_essd`: ESSD.
289
+ *
290
+ * - `cloud_auto`: ESSD AutoPL.
291
+ *
292
+ * - `cloud_essd_entry`: ESSD Entry.
293
+ *
294
+ * Default value: `cloud_ssd`. The default may vary by zone.
190
295
  *
191
296
  * @example
192
- * cloud_essd
297
+ * cloud_ssd
193
298
  */
194
299
  systemDiskCategory?: string;
195
300
  /**
196
301
  * @remarks
197
- * The PL of the system disk that you want to use for the node. This parameter takes effect only for ESSDs.
302
+ * Node system disk performance level. Applies only to ESSD disks.
303
+ *
304
+ * Disk performance levels depend on disk size. For more information, see [ESSD](https://help.aliyun.com/document_detail/122389.html).
198
305
  *
199
306
  * @example
200
307
  * PL1
@@ -202,7 +309,11 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
202
309
  systemDiskPerformanceLevel?: string;
203
310
  /**
204
311
  * @remarks
205
- * The preset read/write IOPS of the system disk.
312
+ * Provisioned read/write IOPS for node system disks.
313
+ *
314
+ * Valid range: 0 to min{50,000, 1000 × capacity - baseline performance}. Baseline performance = min{1,800 + 50 × capacity, 50,000}.
315
+ *
316
+ * This parameter is supported only when `system_disk_category` is `cloud_auto`.
206
317
  *
207
318
  * @example
208
319
  * 1000
@@ -210,7 +321,11 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
210
321
  systemDiskProvisionedIops?: number;
211
322
  /**
212
323
  * @remarks
213
- * The system disk size of the node. The value must be at least 40 GB.
324
+ * Node system disk size in GiB.
325
+ *
326
+ * Valid range: [40,500].
327
+ *
328
+ * Default value: `120`.
214
329
  *
215
330
  * @example
216
331
  * 120
@@ -218,7 +333,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
218
333
  systemDiskSize?: number;
219
334
  /**
220
335
  * @remarks
221
- * The automatic snapshot policy of the node.
336
+ * Automatic snapshot backup policy for node system disks.
222
337
  *
223
338
  * @example
224
339
  * sp-2zej1nogjvovnz4z****
@@ -236,6 +351,10 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
236
351
  });
237
352
  }
238
353
  export declare class CreateClusterRequestControlPlaneEndpointsConfigInternalDnsConfig extends $dara.Model {
354
+ /**
355
+ * @remarks
356
+ * VPCs where the internal domain name resolution takes effect.
357
+ */
239
358
  bindVpcs?: string[];
240
359
  static names(): {
241
360
  [key: string]: string;
@@ -249,6 +368,10 @@ export declare class CreateClusterRequestControlPlaneEndpointsConfigInternalDnsC
249
368
  });
250
369
  }
251
370
  export declare class CreateClusterRequestControlPlaneEndpointsConfig extends $dara.Model {
371
+ /**
372
+ * @remarks
373
+ * 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.
374
+ */
252
375
  internalDnsConfig?: CreateClusterRequestControlPlaneEndpointsConfigInternalDnsConfig;
253
376
  static names(): {
254
377
  [key: string]: string;
@@ -264,19 +387,25 @@ export declare class CreateClusterRequestControlPlaneEndpointsConfig extends $da
264
387
  export declare class CreateClusterRequestOperationPolicyClusterAutoUpgrade extends $dara.Model {
265
388
  /**
266
389
  * @remarks
267
- * The automatic update frequency. Valid values:
390
+ * Cluster automatic upgrade frequency. Valid values:
391
+ *
392
+ * - patch: Automatically upgrade to the latest patch version within the current minor version. New Kubernetes versions do not include breaking changes.
393
+ *
394
+ * - 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.
268
395
  *
269
- * * patch
270
- * * stable
271
- * * rapid
396
+ * - rapid: Automatically upgrade to the latest patch version of the newest minor version to quickly access new Kubernetes community features.
272
397
  *
273
398
  * @example
274
- * patch
399
+ * stable
275
400
  */
276
401
  channel?: string;
277
402
  /**
278
403
  * @remarks
279
- * Specifies whether to enable auto cluster update.
404
+ * Whether to enable cluster automatic upgrade.
405
+ *
406
+ * - true: Enable.
407
+ *
408
+ * - false: Disable.
280
409
  *
281
410
  * @example
282
411
  * true
@@ -296,7 +425,7 @@ export declare class CreateClusterRequestOperationPolicyClusterAutoUpgrade exten
296
425
  export declare class CreateClusterRequestOperationPolicy extends $dara.Model {
297
426
  /**
298
427
  * @remarks
299
- * The configurations of auto cluster upgrade.
428
+ * Cluster automatic upgrade.
300
429
  */
301
430
  clusterAutoUpgrade?: CreateClusterRequestOperationPolicyClusterAutoUpgrade;
302
431
  static names(): {
@@ -311,6 +440,17 @@ export declare class CreateClusterRequestOperationPolicy extends $dara.Model {
311
440
  });
312
441
  }
313
442
  export declare class CreateClusterRequestRrsaConfig extends $dara.Model {
443
+ /**
444
+ * @remarks
445
+ * Whether to enable RRSA.
446
+ *
447
+ * - true: Enable.
448
+ *
449
+ * - false: Disable.
450
+ *
451
+ * @example
452
+ * true
453
+ */
314
454
  enabled?: boolean;
315
455
  static names(): {
316
456
  [key: string]: string;
@@ -326,7 +466,7 @@ export declare class CreateClusterRequestRrsaConfig extends $dara.Model {
326
466
  export declare class CreateClusterRequestWorkerDataDisks extends $dara.Model {
327
467
  /**
328
468
  * @remarks
329
- * The data disk category.
469
+ * Data disk type.
330
470
  *
331
471
  * This parameter is required.
332
472
  *
@@ -336,10 +476,11 @@ export declare class CreateClusterRequestWorkerDataDisks extends $dara.Model {
336
476
  category?: string;
337
477
  /**
338
478
  * @remarks
339
- * Specifies whether to encrypt the data disk. Valid values:
479
+ * Whether to encrypt the data disk. Valid values:
480
+ *
481
+ * - `true`: Encrypt the data disk.
340
482
  *
341
- * * `true`: encrypts the data disk.
342
- * * `false`: does not encrypt the data disk.
483
+ * - `false`: Do not encrypt the data disk.
343
484
  *
344
485
  * Default value: `false`.
345
486
  *
@@ -349,7 +490,7 @@ export declare class CreateClusterRequestWorkerDataDisks extends $dara.Model {
349
490
  encrypted?: string;
350
491
  /**
351
492
  * @remarks
352
- * 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).
493
+ * Data disk performance level. Applies only to [ESSD](https://help.aliyun.com/document_detail/122389.html).
353
494
  *
354
495
  * @example
355
496
  * PL1
@@ -357,7 +498,7 @@ export declare class CreateClusterRequestWorkerDataDisks extends $dara.Model {
357
498
  performanceLevel?: string;
358
499
  /**
359
500
  * @remarks
360
- * The data disk size. Valid values: 40 to 32767. Unit: GiB.
501
+ * Data disk size in GiB. Valid range: 4032767.
361
502
  *
362
503
  * This parameter is required.
363
504
  *
@@ -379,65 +520,77 @@ export declare class CreateClusterRequestWorkerDataDisks extends $dara.Model {
379
520
  export declare class CreateClusterRequest extends $dara.Model {
380
521
  /**
381
522
  * @remarks
382
- * The network access control list (ACL) rule of the SLB instance associated with the API server if the cluster is a registered cluster.
523
+ * **[Deprecated]** Access control list for the registered cluster API Server SLB.
383
524
  *
384
525
  * @deprecated
385
526
  */
386
527
  accessControlList?: string[];
387
528
  /**
388
529
  * @remarks
389
- * 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.
530
+ * List of cluster components. Specify components to install during cluster creation using the `addons` parameter.
531
+ *
532
+ * **Network components**: Required. Choose between Flannel and Terway:
390
533
  *
391
- * **Network plug-in**: required. The Flannel and Terway plug-ins are supported. Select one of the plug-ins for the cluster.
534
+ * - Flannel network: [{"name":"flannel","config":""}].
392
535
  *
393
- * * If you want to use the Terway component, specify the network plug-in in the [{"name":"flannel","config":""}] format.
394
- * * If you want to use the Terway component, specify the value network plug-in in the [{"name": "terway-eniip","Config": ""}] format.
536
+ * - Terway network: [{"name": "terway-eniip","config": ""}].
395
537
  *
396
- * **Volume plug-in**: optional. Only the `Container Storage Interface (CSI)` plug-in is supported.
538
+ * **Storage components**: Optional. Only `csi` is supported:
397
539
  *
398
- * Specify the `CSI` plug-in in the following format: [{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}].
540
+ * `csi`: [{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}].
399
541
  *
400
- * **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.
542
+ * **Logging components**: Optional. We recommend enabling this. Without SLS, you cannot use cluster audit features.
401
543
  *
402
- * * Specify an existing `Simple Log Service project` in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}].
403
- * * To create a `Simple Log Service project`, specify the component in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true"}"}].
544
+ * - Use an existing `SLS Project`: [{"name": "loongcollector","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}].
404
545
  *
405
- * **Ingress controller**: optional. By default, the `nginx-ingress-controller` component is installed in ACK dedicated clusters.
546
+ * - Create a new `SLS Project`: [{"name": "loongcollector","config": "{"IngressDashboardEnabled":"true"}"}].
406
547
  *
407
- * * To install nginx-ingress-controller and enable Internet access, specify the Ingress controller in the following format: [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}].
408
- * * To disable the automatic installation of nginx-ingress-controller, specify the Ingress controller in the following format: [{"name": "nginx-ingress-controller","config": "","disabled": true}].
548
+ * **Ingress components**: Optional. ACK dedicated clusters install the `nginx-ingress-controller` by default.
409
549
  *
410
- * **Event center**: optional. By default, the event center feature is enabled.
550
+ * - Install Ingress with public network access: [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}].
411
551
  *
412
- * 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).
552
+ * - Disable default Ingress installation: [{"name": "nginx-ingress-controller","config": "","disabled": true}].
413
553
  *
414
- * 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"}"}].
554
+ * **Event Hub**: Optional. Enabled by default.
555
+ *
556
+ * 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).
557
+ *
558
+ * Example to enable Event Hub: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}].
415
559
  */
416
560
  addons?: Addon[];
417
561
  /**
418
562
  * @remarks
419
- * 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 (,).``
563
+ * 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 (,).
420
564
  *
421
- * For more information about `service accounts`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
565
+ * For more information about `ServiceAccount`, see [Deploy service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
422
566
  *
423
567
  * @example
424
568
  * kubernetes.default.svc
425
569
  */
426
570
  apiAudiences?: string;
571
+ /**
572
+ * @remarks
573
+ * Cluster audit log configuration.
574
+ */
427
575
  auditLogConfig?: CreateClusterRequestAuditLogConfig;
576
+ /**
577
+ * @remarks
578
+ * [Intelligent Managed Mode](https://help.aliyun.com/document_detail/2938898.html) configuration.
579
+ */
428
580
  autoMode?: CreateClusterRequestAutoMode;
429
581
  /**
430
582
  * @remarks
431
- * [**Deprecated**]
583
+ * **[Deprecated]**
584
+ *
585
+ * Whether to enable auto-renewal. Valid only when `charge_type` is `PrePaid`. Valid values:
432
586
  *
433
- * Specifies whether to enable auto-renewal. This parameter takes effect only when `charge_type` is set to `PrePaid`. Valid values:
587
+ * - `true`: Enable auto-renewal.
434
588
  *
435
- * * `true`: enables auto-renewal.
436
- * * `false`: disables auto-renewal.
589
+ * - `false`: Disable auto-renewal.
437
590
  *
438
591
  * Default value: `false`.
439
592
  *
440
- * 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).
593
+ * 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).
441
594
  *
442
595
  * @example
443
596
  * true
@@ -447,13 +600,13 @@ export declare class CreateClusterRequest extends $dara.Model {
447
600
  autoRenew?: boolean;
448
601
  /**
449
602
  * @remarks
450
- * [**Deprecated**]
603
+ * **[Deprecated]**
451
604
  *
452
- * 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.
605
+ * 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}.
453
606
  *
454
607
  * Default value: 1.
455
608
  *
456
- * 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).
609
+ * 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).
457
610
  *
458
611
  * @example
459
612
  * 1
@@ -463,30 +616,32 @@ export declare class CreateClusterRequest extends $dara.Model {
463
616
  autoRenewPeriod?: number;
464
617
  /**
465
618
  * @remarks
466
- * [**Deprecated**]
619
+ * **[Deprecated]**
620
+ *
621
+ * Billing type for the CLB instance used by the API Server. Default value: PostPaid. Valid values:
467
622
  *
468
- * The billing method of the CLB instance that is used by the API server. Default value: PostPaid. Valid values:
623
+ * - PostPaid: Pay-as-you-go.
469
624
  *
470
- * * PostPaid: pay-as-you-go.
471
- * * PrePaid: subscription. This billing method is not supported by newly created CLB instances. Existing CLB instances are not affected.
625
+ * - PrePaid: Subscription. New CLB instances no longer support subscription billing, but existing instances are unaffected.
472
626
  *
473
- * >
627
+ * >Notice:
474
628
  *
475
- * * 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).
629
+ * - 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).
476
630
  *
477
- * * 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
631
+ * - Starting December 1, 2024, new CLB instances will no longer support subscription billing and will incur an instance fee.
478
632
  *
479
- * For more information, see [CLB billing adjustments](https://help.aliyun.com/document_detail/2839797.html).
633
+ * <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).
634
+ * <props="intl">For details, see [Adjustment of Classic Load Balancer Billing Items](https://help.aliyun.com/document_detail/2839797.html).
480
635
  *
481
636
  * @example
482
- * 1
637
+ * PostPaid
483
638
  *
484
639
  * @deprecated
485
640
  */
486
641
  chargeType?: string;
487
642
  /**
488
643
  * @remarks
489
- * [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.
644
+ * **[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`.
490
645
  *
491
646
  * @example
492
647
  * false
@@ -496,26 +651,27 @@ export declare class CreateClusterRequest extends $dara.Model {
496
651
  cisEnabled?: boolean;
497
652
  /**
498
653
  * @remarks
499
- * [**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.
654
+ * **[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`.
655
+ *
656
+ * Whether to install the CloudMonitor agent on the cluster. Valid values:
500
657
  *
501
- * Specifies whether to install the CloudMonitor agent. Valid values:
658
+ * - `true`: Install the CloudMonitor agent.
502
659
  *
503
- * * `true`: installs the CloudMonitor agent.
504
- * * `false`: does not install the CloudMonitor agent.
660
+ * - `false`: Do not install the CloudMonitor agent.
505
661
  *
506
662
  * Default value: `false`.
507
663
  *
508
664
  * @example
509
- * true
665
+ * false
510
666
  *
511
667
  * @deprecated
512
668
  */
513
669
  cloudMonitorFlags?: boolean;
514
670
  /**
515
671
  * @remarks
516
- * The domain name of the cluster.
672
+ * Cluster local domain name.
517
673
  *
518
- * 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.
674
+ * 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.
519
675
  *
520
676
  * @example
521
677
  * cluster.local
@@ -523,10 +679,21 @@ export declare class CreateClusterRequest extends $dara.Model {
523
679
  clusterDomain?: string;
524
680
  /**
525
681
  * @remarks
526
- * If you set `cluster_type` to `ManagedKubernetes` and specify `profile`, you can further specify the edition of the cluster. Valid values:
682
+ * When you set `cluster_type` to `ManagedKubernetes` and configure `profile`, you can further specify the cluster specification. Valid values:
683
+ *
684
+ * - `ack.standard`: Basic Edition (default when this parameter is empty)
685
+ *
686
+ * - `ack.pro.small`: Pro Edition
687
+ *
688
+ * - `ack.pro.xlarge`: Pro XL
689
+ *
690
+ * - `ack.pro.2xlarge`: Pro 2XL
691
+ *
692
+ * - `ack.pro.4xlarge`: Pro 4XL (requires whitelist approval from customer service)
527
693
  *
528
- * * `ack.pro.small`: Pro Edition.
529
- * * `ack.standard`: Basic Edition. If you leave the parameter empty, an ACK Basic cluster is created.
694
+ * 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.
695
+ *
696
+ * 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).
530
697
  *
531
698
  * @example
532
699
  * ack.pro.small
@@ -534,9 +701,11 @@ export declare class CreateClusterRequest extends $dara.Model {
534
701
  clusterSpec?: string;
535
702
  /**
536
703
  * @remarks
537
- * * `Kubernetes`: ACK dedicated cluster.
538
- * * `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).
539
- * * `ExternalKubernetes`: registered cluster.
704
+ * - `Kubernetes`: ACK dedicated cluster.
705
+ *
706
+ * - `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).
707
+ *
708
+ * - `ExternalKubernetes`: registered cluster.
540
709
  *
541
710
  * @example
542
711
  * Kubernetes
@@ -544,11 +713,11 @@ export declare class CreateClusterRequest extends $dara.Model {
544
713
  clusterType?: string;
545
714
  /**
546
715
  * @remarks
547
- * 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.
716
+ * 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.
548
717
  *
549
- * 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).
718
+ * For cluster network planning, see [Network planning for ACK managed clusters](https://help.aliyun.com/document_detail/86500.html).
550
719
  *
551
- * > This parameter is required if the cluster uses the Flannel plug-in.
720
+ * > This field is required for Flannel clusters.
552
721
  *
553
722
  * @example
554
723
  * 172.20.0.0/16
@@ -556,20 +725,24 @@ export declare class CreateClusterRequest extends $dara.Model {
556
725
  containerCidr?: string;
557
726
  /**
558
727
  * @remarks
559
- * The control plane configurations of an ACK dedicated cluster.
728
+ * Control plane configuration for ACK dedicated clusters.
560
729
  */
561
730
  controlPlaneConfig?: CreateClusterRequestControlPlaneConfig;
731
+ /**
732
+ * @remarks
733
+ * Cluster connection configuration.
734
+ */
562
735
  controlPlaneEndpointsConfig?: CreateClusterRequestControlPlaneEndpointsConfig;
563
736
  /**
564
737
  * @remarks
565
- * The control plane components for which you want to enable log collection.
738
+ * List of component names specifying which control plane component logs to collect.
566
739
  *
567
- * By default, the logs of kube-apiserver, kube-controller-manager, and kube-scheduler are collected.
740
+ * By default, logs are collected for kube-apiserver, kube-controller-manager, kube-scheduler, and cloud-controller-manager.
568
741
  */
569
742
  controlplaneLogComponents?: string[];
570
743
  /**
571
744
  * @remarks
572
- * 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.
745
+ * 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}`.
573
746
  *
574
747
  * @example
575
748
  * k8s-log-xxx
@@ -577,7 +750,7 @@ export declare class CreateClusterRequest extends $dara.Model {
577
750
  controlplaneLogProject?: string;
578
751
  /**
579
752
  * @remarks
580
- * The retention period of control plane logs in days.
753
+ * Number of days to retain control plane component logs.
581
754
  *
582
755
  * @example
583
756
  * 30
@@ -585,12 +758,13 @@ export declare class CreateClusterRequest extends $dara.Model {
585
758
  controlplaneLogTtl?: string;
586
759
  /**
587
760
  * @remarks
588
- * [**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.
761
+ * **[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`.
589
762
  *
590
- * 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:
763
+ * Node CPU management policy. Supported for cluster versions 1.12.6 and later:
591
764
  *
592
- * * `static`: allows pods with specific resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.
593
- * * `none`: specifies that the default CPU affinity is used.
765
+ * - `static`: Enhances CPU affinity and exclusivity for pods with specific resource characteristics on the node.
766
+ *
767
+ * - `none`: Uses the default CPU affinity scheme.
594
768
  *
595
769
  * Default value: `none`.
596
770
  *
@@ -602,7 +776,9 @@ export declare class CreateClusterRequest extends $dara.Model {
602
776
  cpuPolicy?: string;
603
777
  /**
604
778
  * @remarks
605
- * 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 (,).
779
+ * **[Deprecated]** Use the `extra_sans` parameter instead.
780
+ *
781
+ * Custom certificate SAN. Separate multiple IP addresses or domain names with commas (,).
606
782
  *
607
783
  * @example
608
784
  * cs.aliyun.com
@@ -612,10 +788,11 @@ export declare class CreateClusterRequest extends $dara.Model {
612
788
  customSan?: string;
613
789
  /**
614
790
  * @remarks
615
- * 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:
791
+ * Cluster deletion protection prevents accidental cluster deletion through the console or API. Valid values:
792
+ *
793
+ * - `true`: Enable deletion protection. You cannot delete the cluster through the console or API.
616
794
  *
617
- * * `true`: enables cluster deletion protection.
618
- * * `false`: disables cluster deletion protection.
795
+ * - `false`: Disable deletion protection. You can delete the cluster through the console or API.
619
796
  *
620
797
  * Default value: `false`.
621
798
  *
@@ -625,12 +802,13 @@ export declare class CreateClusterRequest extends $dara.Model {
625
802
  deletionProtection?: boolean;
626
803
  /**
627
804
  * @remarks
628
- * [**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.
805
+ * **[Deprecated]** By default, clusters are not rolled back on creation failure. You must manually clean up failed clusters.
629
806
  *
630
- * Specifies whether to perform a rollback when the cluster fails to be created. Valid values:
807
+ * Whether to roll back on cluster creation failure. Valid values:
631
808
  *
632
- * * `true`: performs a rollback when the cluster fails to be created.
633
- * * `false`: does not perform a rollback when the cluster fails to be created.
809
+ * - `true`: Roll back on failure.
810
+ *
811
+ * - `false`: Do not roll back on failure.
634
812
  *
635
813
  * Default value: `true`.
636
814
  *
@@ -642,19 +820,25 @@ export declare class CreateClusterRequest extends $dara.Model {
642
820
  disableRollback?: boolean;
643
821
  /**
644
822
  * @remarks
645
- * Specifies whether to enable the RAM Roles for Service Accounts (RRSA) feature.
823
+ * **[Deprecated]** Use the `rrsa_config` parameter instead.
824
+ *
825
+ * Whether to enable RRSA.
826
+ *
827
+ * - true: Enable.
828
+ *
829
+ * - false: Disable.
646
830
  *
647
831
  * @example
648
- * true
832
+ * false
649
833
  *
650
834
  * @deprecated
651
835
  */
652
836
  enableRrsa?: boolean;
653
837
  /**
654
838
  * @remarks
655
- * 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)
839
+ * KMS key ID used to encrypt data disks. For more information, see [Key Management Service](https://help.aliyun.com/document_detail/28935.html).
656
840
  *
657
- * > The key can be used only in ACK Pro clusters.
841
+ * > This feature is available only for professional managed clusters (ACK Pro clusters).
658
842
  *
659
843
  * @example
660
844
  * 0fe64791-55eb-4fc7-84c5-c6c7cdca****
@@ -662,10 +846,11 @@ export declare class CreateClusterRequest extends $dara.Model {
662
846
  encryptionProviderKey?: string;
663
847
  /**
664
848
  * @remarks
665
- * 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:
849
+ * Whether to enable public network access. Expose the API Server through an EIP to allow public network access to the cluster.
666
850
  *
667
- * * `true`: enables Internet access for the cluster.
668
- * * `false`: disables Internet access for the cluster. If you set the value to false, the API server cannot be accessed over the Internet.
851
+ * - `true`: Enable public network access.
852
+ *
853
+ * - `false`: Disable public network access. If disabled, you cannot access the cluster API Server from external networks.
669
854
  *
670
855
  * Default value: `false`.
671
856
  *
@@ -673,22 +858,28 @@ export declare class CreateClusterRequest extends $dara.Model {
673
858
  * true
674
859
  */
675
860
  endpointPublicAccess?: boolean;
861
+ /**
862
+ * @remarks
863
+ * Custom API Server certificate SAN (Subject Alternative Name).
864
+ */
676
865
  extraSans?: string[];
677
866
  /**
678
867
  * @remarks
679
- * [**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.
868
+ * **[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.
869
+ *
870
+ * When using existing instances to create a cluster, whether to mount data disks. Valid values:
680
871
  *
681
- * Specifies whether to mount a data disk to a node that is created based on an existing ECS instance. Valid values:
872
+ * - `true`: Store containers and images on the data disk. Existing data on the data disk will be lost. Back up your data.
682
873
  *
683
- * * `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.
684
- * * `false`: does not store the data of containers and images on a data disk.
874
+ * - `false`: Do not store containers and images on the data disk.
685
875
  *
686
876
  * Default value: `false`.
687
877
  *
688
- * How data disks are mounted:
878
+ * Data disk mounting rules:
879
+ *
880
+ * - 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.
689
881
  *
690
- * * 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.
691
- * * If no data disk is mounted to the ECS instance, the system does not purchase a new data disk.
882
+ * - If the ECS instance has no mounted data disks, no new data disks are mounted.
692
883
  *
693
884
  * @example
694
885
  * false
@@ -698,9 +889,9 @@ export declare class CreateClusterRequest extends $dara.Model {
698
889
  formatDisk?: boolean;
699
890
  /**
700
891
  * @remarks
701
- * [**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.
892
+ * **[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`.
702
893
  *
703
- * 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).
894
+ * 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).
704
895
  *
705
896
  * @example
706
897
  * m-bp16z7xko3vvv8gt****
@@ -710,19 +901,27 @@ export declare class CreateClusterRequest extends $dara.Model {
710
901
  imageId?: string;
711
902
  /**
712
903
  * @remarks
713
- * [**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.
904
+ * **[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`.
905
+ *
906
+ * Operating system distribution type. We recommend using this parameter to specify the node operating system. Valid values:
907
+ *
908
+ * - CentOS
909
+ *
910
+ * - AliyunLinux
714
911
  *
715
- * The type of OS distribution that you want to use. To specify the node OS, we recommend that you use this parameter. Valid values:
912
+ * - AliyunLinux Qboot
716
913
  *
717
- * * CentOS
718
- * * AliyunLinux
719
- * * AliyunLinux Qboot
720
- * * AliyunLinuxUEFI
721
- * * AliyunLinux3
722
- * * Windows
723
- * * WindowsCore
724
- * * AliyunLinux3Arm64
725
- * * ContainerOS
914
+ * - AliyunLinuxUEFI
915
+ *
916
+ * - AliyunLinux3
917
+ *
918
+ * - Windows
919
+ *
920
+ * - WindowsCore
921
+ *
922
+ * - AliyunLinux3Arm64
923
+ *
924
+ * - ContainerOS
726
925
  *
727
926
  * Default value: `CentOS`.
728
927
  *
@@ -734,32 +933,34 @@ export declare class CreateClusterRequest extends $dara.Model {
734
933
  imageType?: string;
735
934
  /**
736
935
  * @remarks
737
- * [**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.
936
+ * **[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.
738
937
  *
739
- * The existing ECS instances that are specified as worker nodes for the cluster.
938
+ * When using existing nodes to create a cluster, specify the ECS instance list. These instances are added as worker nodes to the cluster.
740
939
  *
741
- * > This parameter is required if you create worker nodes on existing ECS instances.
940
+ * > This field is required when using existing instances to create a cluster.
742
941
  *
743
942
  * @deprecated
744
943
  */
745
944
  instances?: string[];
746
945
  /**
747
946
  * @remarks
748
- * The IP stack of the cluster.
947
+ * Cluster IP stack.
749
948
  *
750
949
  * @example
751
- * Optional value: ipv4 (Single stack) or ipv6 (Dual Stack)
752
- * Default value: IPV4
950
+ * 可选值:
951
+ * ipv4(单栈)
952
+ * dual(双栈),默认值为ipv4。
753
953
  */
754
954
  ipStack?: string;
755
955
  /**
756
956
  * @remarks
757
- * Specifies whether to create an advanced security group. This parameter takes effect only if `security_group_id` is left empty.
957
+ * Automatically create an advanced security group. This takes effect when `security_group_id` is empty.
958
+ *
959
+ * > 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.
758
960
  *
759
- * > 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.
961
+ * - `true`: Create and use an advanced security group.
760
962
  *
761
- * * `true`: creates an advanced security group.
762
- * * `false`: does not create an advanced security group.
963
+ * - `false`: Use a basic security group.
763
964
  *
764
965
  * Default value: `true`.
765
966
  *
@@ -769,12 +970,13 @@ export declare class CreateClusterRequest extends $dara.Model {
769
970
  isEnterpriseSecurityGroup?: boolean;
770
971
  /**
771
972
  * @remarks
772
- * [**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.
973
+ * **[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.
773
974
  *
774
- * Specifies whether to retain the names of existing ECS instances that are used in the cluster. Valid values:
975
+ * When using existing instances to create a cluster, whether to keep the instance names.
775
976
  *
776
- * * `true`: retains the names.
777
- * * `false`: does not retain the names. The system assigns new names.
977
+ * - `true`: Keep.
978
+ *
979
+ * - `false`: Replace with system-generated names.
778
980
  *
779
981
  * Default value: `true`.
780
982
  *
@@ -786,31 +988,33 @@ export declare class CreateClusterRequest extends $dara.Model {
786
988
  keepInstanceName?: boolean;
787
989
  /**
788
990
  * @remarks
789
- * [**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.
991
+ * **[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`.
790
992
  *
791
- * The name of the key pair. You must configure this parameter or `login_password`.
993
+ * Key pair name. Choose either this parameter or `login_password`.
792
994
  *
793
995
  * @example
794
- * secrity-key
996
+ * security-key
795
997
  *
796
998
  * @deprecated
797
999
  */
798
1000
  keyPair?: string;
799
1001
  /**
800
1002
  * @remarks
801
- * 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.
1003
+ * 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.
1004
+ *
1005
+ * 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.
802
1006
  *
803
- * 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).
1007
+ * For more information about Kubernetes versions supported by ACK, see [Overview of Kubernetes version releases](https://help.aliyun.com/document_detail/185269.html).
804
1008
  *
805
1009
  * @example
806
- * 1.16.9-aliyun.1
1010
+ * 1.32.1-aliyun.1
807
1011
  */
808
1012
  kubernetesVersion?: string;
809
1013
  /**
810
1014
  * @remarks
811
- * 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.
1015
+ * Specify the CLB instance ID for API Server access. If specified, no new API Server CLB is automatically created.
812
1016
  *
813
- * > 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.
1017
+ * > Ensure the CLB instance has no dependencies (such as listeners or backend servers). Shared and public CLB instances are not supported.
814
1018
  *
815
1019
  * @example
816
1020
  * lb-wz9t256gqa3vbouk****
@@ -818,16 +1022,21 @@ export declare class CreateClusterRequest extends $dara.Model {
818
1022
  loadBalancerId?: string;
819
1023
  /**
820
1024
  * @remarks
821
- * [**Deprecated**] The pay-as-you-go billing method is used by Classic Load Balancer (CLB) instances. This parameter does not take effect.
1025
+ * **[Deprecated]** CLB is billed based on usage. This parameter has no effect.
1026
+ *
1027
+ * Load Balancer specification. Valid values:
1028
+ *
1029
+ * - slb.s1.small
1030
+ *
1031
+ * - slb.s2.small
1032
+ *
1033
+ * - slb.s2.medium
1034
+ *
1035
+ * - slb.s3.small
822
1036
  *
823
- * The specification of the Server Load Balancer (SLB) instance. Valid values:
1037
+ * - slb.s3.medium
824
1038
  *
825
- * * slb.s1.small
826
- * * slb.s2.small
827
- * * slb.s2.medium
828
- * * slb.s3.small
829
- * * slb.s3.medium
830
- * * slb.s3.large
1039
+ * - slb.s3.large
831
1040
  *
832
1041
  * Default value: `slb.s2.small`.
833
1042
  *
@@ -839,7 +1048,7 @@ export declare class CreateClusterRequest extends $dara.Model {
839
1048
  loadBalancerSpec?: string;
840
1049
  /**
841
1050
  * @remarks
842
- * Enables Simple Log Service for the cluster. This parameter takes effect only for ACK Serverless clusters. Set the value to `SLS`.
1051
+ * **[Deprecated]** Enables SLS for the cluster. Applies only to ACK Serverless clusters and must be set to `SLS`.
843
1052
  *
844
1053
  * @example
845
1054
  * SLS
@@ -849,29 +1058,30 @@ export declare class CreateClusterRequest extends $dara.Model {
849
1058
  loggingType?: string;
850
1059
  /**
851
1060
  * @remarks
852
- * [**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.
1061
+ * **[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`.
853
1062
  *
854
- * 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.
1063
+ * 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.
855
1064
  *
856
1065
  * @example
857
- * Hello@1234
1066
+ * null
858
1067
  *
859
1068
  * @deprecated
860
1069
  */
861
1070
  loginPassword?: string;
862
1071
  /**
863
1072
  * @remarks
864
- * The configurations of the cluster maintenance window.
1073
+ * Cluster maintenance window.
865
1074
  */
866
1075
  maintenanceWindow?: MaintenanceWindow;
867
1076
  /**
868
1077
  * @remarks
869
- * [**Deprecated**] When you configure the control plane, use the `auto-renew` parameter in the `control_plane_config` section instead.
1078
+ * **[Deprecated]** For control plane configuration, use the `auto_renew` parameter under `control_plane_config`.
870
1079
  *
871
- * 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:
1080
+ * Whether to enable auto-renewal for master nodes. Valid only when `master_instance_charge_type` is `PrePaid`. Valid values:
872
1081
  *
873
- * * `true`: enables auto-renewal.
874
- * * `false`: disables auto-renewal.
1082
+ * - `true`: Enable auto-renewal.
1083
+ *
1084
+ * - `false`: Disable auto-renewal.
875
1085
  *
876
1086
  * Default value: `true`.
877
1087
  *
@@ -883,11 +1093,11 @@ export declare class CreateClusterRequest extends $dara.Model {
883
1093
  masterAutoRenew?: boolean;
884
1094
  /**
885
1095
  * @remarks
886
- * [**Deprecated**] When you configure the control plane, use the `auto-renew_period` parameter in the `control_plane_config` section instead.
1096
+ * **[Deprecated]** For control plane configuration, use the `auto_renew_period` parameter under `control_plane_config`.
887
1097
  *
888
- * The auto-renewal duration. This parameter takes effect and is required only when the subscription billing method is selected for master nodes.
1098
+ * Auto-renewal period for master nodes in months. Required and valid only when subscription billing is selected.
889
1099
  *
890
- * Valid values: 1, 2, 3, 6, and 12.
1100
+ * Valid values: {1, 2, 3, 6, 12}.
891
1101
  *
892
1102
  * Default value: 1.
893
1103
  *
@@ -899,9 +1109,9 @@ export declare class CreateClusterRequest extends $dara.Model {
899
1109
  masterAutoRenewPeriod?: number;
900
1110
  /**
901
1111
  * @remarks
902
- * [**Deprecated**] When you configure the control plane, use the `size` parameter in the `control_plane_config` section instead.
1112
+ * **[Deprecated]** For control plane configuration, use the `size` parameter under `control_plane_config`.
903
1113
  *
904
- * The number of master nodes. Valid values: `3` and `5`.
1114
+ * Number of master nodes. Valid values: `3` or `5`.
905
1115
  *
906
1116
  * Default value: `3`.
907
1117
  *
@@ -913,12 +1123,13 @@ export declare class CreateClusterRequest extends $dara.Model {
913
1123
  masterCount?: number;
914
1124
  /**
915
1125
  * @remarks
916
- * [**Deprecated**] When you configure the control plane, use the `instance_charge_type` parameter in the `control_plane_config` section instead.
1126
+ * **[Deprecated]** For control plane configuration, use the `instance_charge_type` parameter under `control_plane_config`.
1127
+ *
1128
+ * Master node billing type. Valid values:
917
1129
  *
918
- * The billing method of master nodes. Valid values:
1130
+ * - `PrePaid`: Subscription.
919
1131
  *
920
- * * `PrePaid`: subscription.
921
- * * `PostPaid`: pay-as-you-go.
1132
+ * - `PostPaid`: Pay-as-you-go.
922
1133
  *
923
1134
  * Default value: `PostPaid`.
924
1135
  *
@@ -930,20 +1141,20 @@ export declare class CreateClusterRequest extends $dara.Model {
930
1141
  masterInstanceChargeType?: string;
931
1142
  /**
932
1143
  * @remarks
933
- * [**Deprecated**] When you configure the control plane, use the `instance_types` parameter in the `control_plane_config` section instead.
1144
+ * **[Deprecated]** For control plane configuration, use the `instance_types` parameter under `control_plane_config`.
934
1145
  *
935
- * The instance types of master nodes. For more information, see [Overview of instance families](https://help.aliyun.com/document_detail/25378.html).
1146
+ * Master node instance types. For more information, see [Instance families](https://help.aliyun.com/document_detail/25378.html).
936
1147
  *
937
1148
  * @deprecated
938
1149
  */
939
1150
  masterInstanceTypes?: string[];
940
1151
  /**
941
1152
  * @remarks
942
- * [**Deprecated**] When you configure the control plane, use the `unit` parameter in the `control_plane_config` section instead.
1153
+ * **[Deprecated]** For control plane configuration, use the `unit` parameter under `control_plane_config`.
943
1154
  *
944
- * The subscription duration of master nodes. This parameter takes effect and is required only when `master_instance_charge_type` is set to `PrePaid`.
1155
+ * Subscription duration for master nodes in months. Required and valid only when `master_instance_charge_type` is `PrePaid`.
945
1156
  *
946
- * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
1157
+ * Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.
947
1158
  *
948
1159
  * Default value: 1.
949
1160
  *
@@ -955,11 +1166,11 @@ export declare class CreateClusterRequest extends $dara.Model {
955
1166
  masterPeriod?: number;
956
1167
  /**
957
1168
  * @remarks
958
- * [**Deprecated**] When you configure the control plane, use the `period_unit` parameter in the `control_plane_config` section instead.
1169
+ * **[Deprecated]** For control plane configuration, use the `period_unit` parameter under `control_plane_config`.
959
1170
  *
960
- * The billing cycle of the master nodes in the cluster. This parameter is required if master_instance_charge_type is set to `PrePaid`.
1171
+ * Master node billing cycle. Required when master_instance_charge_type is `PrePaid`.
961
1172
  *
962
- * Valid value: `Month`, which indicates that master nodes are billed only on a monthly basis.
1173
+ * Valid value: `Month`. Only monthly billing is supported.
963
1174
  *
964
1175
  * @example
965
1176
  * Month
@@ -969,15 +1180,17 @@ export declare class CreateClusterRequest extends $dara.Model {
969
1180
  masterPeriodUnit?: string;
970
1181
  /**
971
1182
  * @remarks
972
- * [**Deprecated**] When you configure the control plane, use the `system_disk_category` parameter in the `control_plane_config` section instead.
1183
+ * **[Deprecated]** For control plane configuration, use the `system_disk_category` parameter under `control_plane_config`.
1184
+ *
1185
+ * Master node system disk type. Valid values:
973
1186
  *
974
- * The system disk category of master nodes. Valid values:
1187
+ * - `cloud_efficiency`: Ultra disk.
975
1188
  *
976
- * * `cloud_efficiency`: ultra disk.
977
- * * `cloud_ssd`: standard SSD.
978
- * * `cloud_essd`: Enterprise SSD (ESSD).
1189
+ * - `cloud_ssd`: Standard SSD.
979
1190
  *
980
- * Default value: `cloud_ssd`. The default value may vary in different zones.
1191
+ * - `cloud_essd`: ESSD.
1192
+ *
1193
+ * Default value: `cloud_ssd`. The default may vary by zone.
981
1194
  *
982
1195
  * @example
983
1196
  * cloud_ssd
@@ -987,9 +1200,9 @@ export declare class CreateClusterRequest extends $dara.Model {
987
1200
  masterSystemDiskCategory?: string;
988
1201
  /**
989
1202
  * @remarks
990
- * [**Deprecated**] When you configure the control plane, use the `system_disk_performance_level` parameter in the `control_plane_config` section instead.
1203
+ * **[Deprecated]** For control plane configuration, use the `system_disk_performance_level` parameter under `control_plane_config`.
991
1204
  *
992
- * 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).
1205
+ * 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).
993
1206
  *
994
1207
  * @example
995
1208
  * PL1
@@ -999,9 +1212,9 @@ export declare class CreateClusterRequest extends $dara.Model {
999
1212
  masterSystemDiskPerformanceLevel?: string;
1000
1213
  /**
1001
1214
  * @remarks
1002
- * [**Deprecated**] When you configure the control plane, use the `system_disk_disk` parameter in the `control_plane_config` section instead.
1215
+ * **[Deprecated]** For control plane configuration, use the `system_disk_size` parameter under `control_plane_config`.
1003
1216
  *
1004
- * The system disk size of master nodes. Valid values: 40 to 500. Unit: GiB.
1217
+ * Valid range: [40,500].
1005
1218
  *
1006
1219
  * Default value: `120`.
1007
1220
  *
@@ -1013,9 +1226,9 @@ export declare class CreateClusterRequest extends $dara.Model {
1013
1226
  masterSystemDiskSize?: number;
1014
1227
  /**
1015
1228
  * @remarks
1016
- * [**Deprecated**] When you configure the control plane, use the `system_disk_snapshot_policy_id` parameter in the `control_plane_config` section instead.
1229
+ * **[Deprecated]** For control plane configuration, use the `system_disk_snapshot_policy_id` parameter under `control_plane_config`.
1017
1230
  *
1018
- * The ID of the automatic snapshot policy that is used by the system disk specified for master nodes.
1231
+ * Automatic snapshot policy ID for master node system disks.
1019
1232
  *
1020
1233
  * @example
1021
1234
  * sp-2zej1nogjvovnz4z****
@@ -1025,20 +1238,18 @@ export declare class CreateClusterRequest extends $dara.Model {
1025
1238
  masterSystemDiskSnapshotPolicyId?: string;
1026
1239
  /**
1027
1240
  * @remarks
1028
- * [**Deprecated**] Use the `vswitch_ids` parameter instead.
1241
+ * **[Deprecated]** Use the `vswitch_ids` parameter instead.
1029
1242
  *
1030
- * 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.
1243
+ * 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.
1031
1244
  *
1032
- * 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.
1245
+ * The number of specified instance types must match `master_count` and correspond one-to-one with elements in `master_vswitch_ids`.
1033
1246
  *
1034
1247
  * @deprecated
1035
1248
  */
1036
1249
  masterVswitchIds?: string[];
1037
1250
  /**
1038
1251
  * @remarks
1039
- * The cluster name.
1040
- *
1041
- * The name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). The name cannot start with a hyphen (-).
1252
+ * 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 (-).
1042
1253
  *
1043
1254
  * This parameter is required.
1044
1255
  *
@@ -1048,7 +1259,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1048
1259
  name?: string;
1049
1260
  /**
1050
1261
  * @remarks
1051
- * [Deprecated] Use the `snat_entry` parameter instead.
1262
+ * **[Deprecated]** Use the `snat_entry` parameter instead.
1052
1263
  *
1053
1264
  * @example
1054
1265
  * true
@@ -1058,7 +1269,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1058
1269
  natGateway?: boolean;
1059
1270
  /**
1060
1271
  * @remarks
1061
- * 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.
1272
+ * Number of node IP addresses, determined by the specified CIDR mask. This applies only to Flannel network clusters.
1062
1273
  *
1063
1274
  * Default value: `26`.
1064
1275
  *
@@ -1068,26 +1279,17 @@ export declare class CreateClusterRequest extends $dara.Model {
1068
1279
  nodeCidrMask?: string;
1069
1280
  /**
1070
1281
  * @remarks
1071
- * [**Deprecated**] When you configure a node pool, use the `node_name_mode` parameter of the `kubernetes_config` field in the `nodepool` section instead.
1072
- *
1073
- * The custom node name.
1074
- *
1075
- * A custom node name consists of a prefix, a node IP address, and a suffix.
1076
- *
1077
- * * 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.
1078
- * * 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.
1079
- *
1080
- * 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.
1282
+ * **[Deprecated]** Use the `node_name_mode` parameter under `kubernetes_config` in `nodepool` instead.
1081
1283
  *
1082
1284
  * @example
1083
- * aliyun.com00055test
1285
+ * null
1084
1286
  *
1085
1287
  * @deprecated
1086
1288
  */
1087
1289
  nodeNameMode?: string;
1088
1290
  /**
1089
1291
  * @remarks
1090
- * The node port range. Valid values: 30000 to 65535.
1292
+ * Node service port range: [30000,65535].
1091
1293
  *
1092
1294
  * Default value: `30000-32767`.
1093
1295
  *
@@ -1099,14 +1301,14 @@ export declare class CreateClusterRequest extends $dara.Model {
1099
1301
  nodePortRange?: string;
1100
1302
  /**
1101
1303
  * @remarks
1102
- * The list of node pools.
1304
+ * List of node pools.
1103
1305
  */
1104
1306
  nodepools?: Nodepool[];
1105
1307
  /**
1106
1308
  * @remarks
1107
- * [**Deprecated**] When you configure a node pool, use the `desired_size` parameter of the `scaling_group` field in the `nodepool` section instead.
1309
+ * **[Deprecated]** For node pool configuration, use the `desired_size` parameter under `scaling_group` in `nodepool`.
1108
1310
  *
1109
- * The number of worker nodes. Valid values: 0 to 100.
1311
+ * Number of worker nodes. Range: [0,100].
1110
1312
  *
1111
1313
  * @example
1112
1314
  * 3
@@ -1116,17 +1318,18 @@ export declare class CreateClusterRequest extends $dara.Model {
1116
1318
  numOfNodes?: number;
1117
1319
  /**
1118
1320
  * @remarks
1119
- * The automatic O\\&M policy of the cluster.
1321
+ * Cluster automated operations policy.
1120
1322
  */
1121
1323
  operationPolicy?: CreateClusterRequestOperationPolicy;
1122
1324
  /**
1123
1325
  * @remarks
1124
- * [**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.
1326
+ * **[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`.
1125
1327
  *
1126
- * The type of OS. Valid values:
1328
+ * Operating system platform type. Valid values:
1127
1329
  *
1128
- * * Windows
1129
- * * Linux
1330
+ * - Windows
1331
+ *
1332
+ * - Linux
1130
1333
  *
1131
1334
  * Default value: `Linux`.
1132
1335
  *
@@ -1138,31 +1341,31 @@ export declare class CreateClusterRequest extends $dara.Model {
1138
1341
  osType?: string;
1139
1342
  /**
1140
1343
  * @remarks
1141
- * [**Deprecated**]
1344
+ * **[Deprecated]**
1142
1345
  *
1143
- * The subscription duration. This parameter takes effect and is required only when you set charge_type to PrePaid.
1346
+ * Subscription duration in months. Required and valid only when charge_type is PrePaid.
1144
1347
  *
1145
- * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
1348
+ * Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.
1146
1349
  *
1147
1350
  * Default value: 1.
1148
1351
  *
1149
- * 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).
1352
+ * 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).
1150
1353
  *
1151
1354
  * @example
1152
- * FY2023
1355
+ * 1
1153
1356
  *
1154
1357
  * @deprecated
1155
1358
  */
1156
1359
  period?: number;
1157
1360
  /**
1158
1361
  * @remarks
1159
- * [**Deprecated**]
1362
+ * **[Deprecated]**
1160
1363
  *
1161
- * The billing cycle. This parameter is required if charge_type is set to PrePaid.
1364
+ * Billing cycle. Required when the billing type is PrePaid.
1162
1365
  *
1163
- * Valid value: Month, which indicates that resources are billed only on a monthly basis.
1366
+ * Valid value: Month. Only monthly billing is supported.
1164
1367
  *
1165
- * 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).
1368
+ * 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).
1166
1369
  *
1167
1370
  * @example
1168
1371
  * Month
@@ -1172,16 +1375,21 @@ export declare class CreateClusterRequest extends $dara.Model {
1172
1375
  periodUnit?: string;
1173
1376
  /**
1174
1377
  * @remarks
1175
- * [**Deprecated**] When you configure a node pool, use the `platform` parameter of the `scaling_group` field in the `nodepool` section instead.
1378
+ * **[Deprecated]** For node pool configuration, use the `platform` parameter under `scaling_group` in `nodepool`.
1379
+ *
1380
+ * Operating system distribution. Valid values:
1176
1381
  *
1177
- * The OS distribution that is used. Valid values:
1382
+ * - CentOS
1178
1383
  *
1179
- * * CentOS
1180
- * * AliyunLinux
1181
- * * QbootAliyunLinux
1182
- * * Qboot
1183
- * * Windows
1184
- * * WindowsCore
1384
+ * - AliyunLinux
1385
+ *
1386
+ * - QbootAliyunLinux
1387
+ *
1388
+ * - Qboot
1389
+ *
1390
+ * - Windows
1391
+ *
1392
+ * - WindowsCore
1185
1393
  *
1186
1394
  * Default value: `CentOS`.
1187
1395
  *
@@ -1193,21 +1401,24 @@ export declare class CreateClusterRequest extends $dara.Model {
1193
1401
  platform?: string;
1194
1402
  /**
1195
1403
  * @remarks
1196
- * 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.
1404
+ * **[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.
1197
1405
  *
1198
- * > 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.
1406
+ * > 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.
1199
1407
  *
1200
1408
  * @deprecated
1201
1409
  */
1202
1410
  podVswitchIds?: string[];
1203
1411
  /**
1204
1412
  * @remarks
1205
- * 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:
1413
+ * When you set `cluster_type` to `ManagedKubernetes` (ACK managed cluster), you can further specify the cluster subtype.
1414
+ *
1415
+ * - `Default`: ACK managed cluster, including ACK clusters (Pro Edition, Basic Edition).
1416
+ *
1417
+ * - `Edge`: ACK Edge cluster, including ACK Edge clusters (Pro Edition, Basic Edition).
1206
1418
  *
1207
- * * `Default`: ACK managed cluster. ACK managed clusters include ACK Basic clusters and ACK Pro clusters.
1208
- * * `Edge`: ACK Edge cluster. ACK Edge clusters include ACK Edge Basic clusters and ACK Edge Pro clusters.
1209
- * * `Serverless`: ACK Serverless cluster. ACK Serverless clusters include ACK Serverless Basic clusters and ACK Serverless Pro clusters.
1210
- * * `Lingjun`: ACK Lingjun Pro cluster.
1419
+ * - `Serverless`: ACK serverless cluster, including ACK serverless clusters (Pro Edition, Basic Edition).
1420
+ *
1421
+ * - `Lingjun`: ACK LINGJUN cluster, available only in Pro Edition.
1211
1422
  *
1212
1423
  * @example
1213
1424
  * Default
@@ -1215,10 +1426,14 @@ export declare class CreateClusterRequest extends $dara.Model {
1215
1426
  profile?: string;
1216
1427
  /**
1217
1428
  * @remarks
1218
- * The kube-proxy mode. Valid values:
1429
+ * kube-proxy proxy mode
1430
+ *
1431
+ * - `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.
1432
+ *
1433
+ * - `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.
1219
1434
  *
1220
- * * `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.
1221
- * * `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.
1435
+ * - `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>
1436
+ * 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>
1222
1437
  *
1223
1438
  * Default value: `ipvs`.
1224
1439
  *
@@ -1228,16 +1443,16 @@ export declare class CreateClusterRequest extends $dara.Model {
1228
1443
  proxyMode?: string;
1229
1444
  /**
1230
1445
  * @remarks
1231
- * [**Deprecated**] When you configure a node pool, use the `rds_instances` parameter of the `scaling_group` field in the `nodepool` section instead.
1446
+ * **[Deprecated]** For node pool configuration, use the `rds_instances` parameter under `scaling_group` in `nodepool`.
1232
1447
  *
1233
- * 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.
1448
+ * 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.
1234
1449
  *
1235
1450
  * @deprecated
1236
1451
  */
1237
1452
  rdsInstances?: string[];
1238
1453
  /**
1239
1454
  * @remarks
1240
- * 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).
1455
+ * 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).
1241
1456
  *
1242
1457
  * This parameter is required.
1243
1458
  *
@@ -1247,25 +1462,31 @@ export declare class CreateClusterRequest extends $dara.Model {
1247
1462
  regionId?: string;
1248
1463
  /**
1249
1464
  * @remarks
1250
- * The ID of the resource group to which the cluster belongs. You can use resource groups to isolate clusters.
1465
+ * The resource group ID to which the cluster belongs, used to isolate different resources.
1251
1466
  *
1252
1467
  * @example
1253
1468
  * rg-acfm3mkrure****
1254
1469
  */
1255
1470
  resourceGroupId?: string;
1471
+ /**
1472
+ * @remarks
1473
+ * RRSA feature configuration.
1474
+ */
1256
1475
  rrsaConfig?: CreateClusterRequestRrsaConfig;
1257
1476
  /**
1258
1477
  * @remarks
1259
- * The container runtime. The default container runtime is Docker. containerd and Sandboxed-Container are also supported.
1478
+ * Container runtime for the cluster. Supports containerd, sandboxed containers, and Docker.
1260
1479
  *
1261
- * 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).
1480
+ * > Kubernetes 1.24 no longer supports Docker as a built-in container runtime.
1481
+ *
1482
+ * For more information, see [Comparison of Docker, containerd, and sandboxed container runtimes](https://help.aliyun.com/document_detail/160313.html).
1262
1483
  *
1263
1484
  * @deprecated
1264
1485
  */
1265
1486
  runtime?: Runtime;
1266
1487
  /**
1267
1488
  * @remarks
1268
- * 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.
1489
+ * 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.
1269
1490
  *
1270
1491
  * @example
1271
1492
  * sg-bp1bdue0qc1g7k****
@@ -1273,12 +1494,13 @@ export declare class CreateClusterRequest extends $dara.Model {
1273
1494
  securityGroupId?: string;
1274
1495
  /**
1275
1496
  * @remarks
1276
- * [**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.
1497
+ * **[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`.
1498
+ *
1499
+ * Alibaba Cloud OS security hardening. Valid values:
1277
1500
  *
1278
- * Specifies whether to enable Alibaba Cloud Linux Security Hardening. Valid values:
1501
+ * - `true`: Enable Alibaba Cloud OS security hardening.
1279
1502
  *
1280
- * * `true`: enables Alibaba Cloud Linux Security Hardening.
1281
- * * `false`: disables Alibaba Cloud Linux Security Hardening.
1503
+ * - `false`: Disable Alibaba Cloud OS security hardening.
1282
1504
  *
1283
1505
  * Default value: `false`.
1284
1506
  *
@@ -1290,9 +1512,9 @@ export declare class CreateClusterRequest extends $dara.Model {
1290
1512
  securityHardeningOs?: boolean;
1291
1513
  /**
1292
1514
  * @remarks
1293
- * 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`.
1515
+ * 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`.
1294
1516
  *
1295
- * For more information about `ServiceAccount`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
1517
+ * For more information about `ServiceAccount`, see [Deploy service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
1296
1518
  *
1297
1519
  * @example
1298
1520
  * kubernetes.default.svc
@@ -1300,9 +1522,10 @@ export declare class CreateClusterRequest extends $dara.Model {
1300
1522
  serviceAccountIssuer?: string;
1301
1523
  /**
1302
1524
  * @remarks
1303
- * 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.
1525
+ * 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.
1526
+ * 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.
1304
1527
  *
1305
- * By default, the Service CIDR block is set to 172.19.0.0/20.
1528
+ * Default value: 172.19.0.0/20.
1306
1529
  *
1307
1530
  * @example
1308
1531
  * 172.21.0.0/20
@@ -1310,41 +1533,44 @@ export declare class CreateClusterRequest extends $dara.Model {
1310
1533
  serviceCidr?: string;
1311
1534
  /**
1312
1535
  * @remarks
1313
- * The methods for implementing service discovery in `ACK Serverless` clusters.
1536
+ * **[Deprecated]** Service discovery type for the cluster, used to specify the service discovery method in `ACK Serverless` clusters.
1537
+ *
1538
+ * - `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.
1314
1539
  *
1315
- * * `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.
1316
- * * `PrivateZone`: a DNS resolution service provided by Alibaba Cloud. You must activate Alibaba Cloud DNS PrivateZone before you can use it for service discovery.
1540
+ * - `PrivateZone`: Uses Alibaba Cloud PrivateZone for service discovery. Requires enabling the PrivateZone service.
1317
1541
  *
1318
- * By default, this parameter is not specified.
1542
+ * Default value: Disabled.
1319
1543
  *
1320
1544
  * @deprecated
1321
1545
  */
1322
1546
  serviceDiscoveryTypes?: string[];
1323
1547
  /**
1324
1548
  * @remarks
1325
- * Specifies whether to configure SNAT rules for the VPC in which your cluster is deployed. Valid values:
1549
+ * Configure SNAT for the VPC. Valid values:
1326
1550
  *
1327
- * * `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.
1328
- * * `false`: does not create a NAT gateway or configure SNAT rules. In this case, nodes and applications in the cluster cannot access the Internet.
1551
+ * - `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.
1329
1552
  *
1330
- * > 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).
1553
+ * - `false`: Do not create a NAT Gateway or SNAT rules. Nodes and applications in the cluster cannot access the public network.
1331
1554
  *
1332
- * Default value: `true`.
1555
+ * > 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).
1556
+ *
1557
+ * Default value: `false`.
1333
1558
  *
1334
1559
  * @example
1335
- * true
1560
+ * false
1336
1561
  */
1337
1562
  snatEntry?: boolean;
1338
1563
  /**
1339
1564
  * @remarks
1340
- * [**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.
1565
+ * **[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`.
1341
1566
  *
1342
- * 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).
1567
+ * 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).
1343
1568
  *
1344
1569
  * Valid values:
1345
1570
  *
1346
- * * `true`: enables MLPS security hardening.
1347
- * * `false`: disables MLPS security hardening.
1571
+ * - `true`: Enable MLPS 2.0 security hardening.
1572
+ *
1573
+ * - `false`: Disable MLPS 2.0 security hardening.
1348
1574
  *
1349
1575
  * Default value: `false`.
1350
1576
  *
@@ -1356,10 +1582,11 @@ export declare class CreateClusterRequest extends $dara.Model {
1356
1582
  socEnabled?: boolean;
1357
1583
  /**
1358
1584
  * @remarks
1359
- * 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:
1585
+ * 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.
1360
1586
  *
1361
- * * `true`: enables SSH logon.
1362
- * * `false`: disables SSH logon.
1587
+ * - `true`: Enable.
1588
+ *
1589
+ * - `false`: Disable.
1363
1590
  *
1364
1591
  * Default value: `false`.
1365
1592
  *
@@ -1369,26 +1596,27 @@ export declare class CreateClusterRequest extends $dara.Model {
1369
1596
  sshFlags?: boolean;
1370
1597
  /**
1371
1598
  * @remarks
1372
- * The labels that you want to add to nodes. You must add labels based on the following rules:
1599
+ * Node labels. Label rules:
1600
+ *
1601
+ * - Labels consist of case-sensitive key-value pairs. You can add up to 20 tags.
1373
1602
  *
1374
- * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
1375
- * * 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).
1603
+ * - 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).
1376
1604
  */
1377
1605
  tags?: Tag[];
1378
1606
  /**
1379
1607
  * @remarks
1380
- * [**Deprecated**] When you configure a node pool, use the `taints` parameter of the `kubernetes_config` field in the `nodepool` section instead.
1608
+ * **[Deprecated]** For node pool configuration, use the `taints` parameter under `kubernetes_config` in `nodepool`.
1381
1609
  *
1382
- * 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/).
1610
+ * 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/).
1383
1611
  *
1384
1612
  * @deprecated
1385
1613
  */
1386
1614
  taints?: Taint[];
1387
1615
  /**
1388
1616
  * @remarks
1389
- * [**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.
1617
+ * **[Deprecated]** By default, clusters are not rolled back on creation failure. You must manually clean up failed clusters.
1390
1618
  *
1391
- * Specifies the timeout period of cluster creation. Unit: minutes.
1619
+ * Cluster creation timeout in minutes.
1392
1620
  *
1393
1621
  * Default value: `60`.
1394
1622
  *
@@ -1400,7 +1628,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1400
1628
  timeoutMins?: number;
1401
1629
  /**
1402
1630
  * @remarks
1403
- * The time zone of the cluster.
1631
+ * Time zone used by the cluster. See [Supported time zones](https://help.aliyun.com/document_detail/354879.html).
1404
1632
  *
1405
1633
  * @example
1406
1634
  * Asia/Shanghai
@@ -1408,7 +1636,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1408
1636
  timezone?: string;
1409
1637
  /**
1410
1638
  * @remarks
1411
- * The custom Certificate Authority (CA) certificate used by the cluster.
1639
+ * Custom cluster CA.
1412
1640
  *
1413
1641
  * @example
1414
1642
  * -----BEGIN CERTIFICATE-----****
@@ -1416,7 +1644,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1416
1644
  userCa?: string;
1417
1645
  /**
1418
1646
  * @remarks
1419
- * The user data of nodes.
1647
+ * **[Deprecated]** Custom node data.
1420
1648
  *
1421
1649
  * @example
1422
1650
  * IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD****
@@ -1426,7 +1654,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1426
1654
  userData?: string;
1427
1655
  /**
1428
1656
  * @remarks
1429
- * The virtual private cloud (VPC) in which you want to deploy the cluster. This parameter is required.
1657
+ * The VPC used by the cluster. You must provide this when creating a cluster.
1430
1658
  *
1431
1659
  * @example
1432
1660
  * vpc-2zeik9h3ahvv2zz95****
@@ -1434,17 +1662,18 @@ export declare class CreateClusterRequest extends $dara.Model {
1434
1662
  vpcid?: string;
1435
1663
  /**
1436
1664
  * @remarks
1437
- * The vSwitches for nodes in the cluster. This parameter is required if you create an ACK managed cluster that does not contain nodes.
1665
+ * Virtual switches for cluster nodes. This field is required when creating a zero-node managed cluster.
1438
1666
  */
1439
1667
  vswitchIds?: string[];
1440
1668
  /**
1441
1669
  * @remarks
1442
- * [**Deprecated**] When you configure a node pool, use the `auto_renew` parameter of the `scaling_group` field in the `nodepool` section instead.
1670
+ * **[Deprecated]** For node pool configuration, use the `auto_renew` parameter under `scaling_group` in `nodepool`.
1671
+ *
1672
+ * Whether to enable auto-renewal for worker nodes. Valid only when `worker_instance_charge_type` is `PrePaid`. Valid values:
1443
1673
  *
1444
- * 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:
1674
+ * - `true`: Enable auto-renewal.
1445
1675
  *
1446
- * * `true`: enables auto-renewal.
1447
- * * `false`: disables auto-renewal.
1676
+ * - `false`: Disable auto-renewal.
1448
1677
  *
1449
1678
  * Default value: `true`.
1450
1679
  *
@@ -1456,11 +1685,11 @@ export declare class CreateClusterRequest extends $dara.Model {
1456
1685
  workerAutoRenew?: boolean;
1457
1686
  /**
1458
1687
  * @remarks
1459
- * [**Deprecated**] When you configure a node pool, use the `auto_renew_period` parameter of the `scaling_group` field in the `nodepool` section instead.
1688
+ * **[Deprecated]** For node pool configuration, use the `auto_renew_period` parameter under `scaling_group` in `nodepool`.
1460
1689
  *
1461
- * 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.
1690
+ * Auto-renewal period for worker nodes in months. Required and valid only when subscription billing is selected.
1462
1691
  *
1463
- * Valid values: 1, 2, 3, 6, and 12.
1692
+ * Valid values: {1, 2, 3, 6, 12}.
1464
1693
  *
1465
1694
  * @example
1466
1695
  * 1
@@ -1470,23 +1699,24 @@ export declare class CreateClusterRequest extends $dara.Model {
1470
1699
  workerAutoRenewPeriod?: number;
1471
1700
  /**
1472
1701
  * @remarks
1473
- * [**Deprecated**] When you configure a node pool, use the `data_disks` parameter of the `scaling_group` field in the `nodepool` section instead.
1702
+ * **[Deprecated]** For node pool configuration, use the `data_disks` parameter under `scaling_group` in `nodepool`.
1474
1703
  *
1475
- * The configurations of the data disks that you want to mount to worker nodes. The configurations include the disk category and disk size.
1704
+ * Configuration for worker node data disks, including type and size.
1476
1705
  *
1477
1706
  * @deprecated
1478
1707
  */
1479
1708
  workerDataDisks?: CreateClusterRequestWorkerDataDisks[];
1480
1709
  /**
1481
1710
  * @remarks
1482
- * [**Deprecated**] When you configure a node pool, use the `instance_charge_type` parameter of the `scaling_group` field in the `nodepool` section instead.
1711
+ * **[Deprecated]** For node pool configuration, use the `instance_charge_type` parameter under `scaling_group` in `nodepool`.
1483
1712
  *
1484
- * The billing method of worker nodes. Valid values:
1713
+ * Worker node billing type. Valid values:
1485
1714
  *
1486
- * * `PrePaid`: subscription.
1487
- * * `PostPaid`: pay-as-you-go.
1715
+ * - `PrePaid`: Subscription.
1488
1716
  *
1489
- * Default value: PostPaid.
1717
+ * - `PostPaid`: Pay-as-you-go.
1718
+ *
1719
+ * Default value: Pay-as-you-go.
1490
1720
  *
1491
1721
  * @example
1492
1722
  * PrePaid
@@ -1496,20 +1726,20 @@ export declare class CreateClusterRequest extends $dara.Model {
1496
1726
  workerInstanceChargeType?: string;
1497
1727
  /**
1498
1728
  * @remarks
1499
- * [**Deprecated**] When you configure a node pool, use the `instance_types` parameter of the `scaling_group` field in the `nodepool` section instead.
1729
+ * **[Deprecated]** For node pool configuration, use the `instance_types` parameter under `scaling_group` in `nodepool`.
1500
1730
  *
1501
- * The instance configurations of worker nodes.
1731
+ * Worker node instance configuration.
1502
1732
  *
1503
1733
  * @deprecated
1504
1734
  */
1505
1735
  workerInstanceTypes?: string[];
1506
1736
  /**
1507
1737
  * @remarks
1508
- * [**Deprecated**] When you configure a node pool, use the `period` parameter of the `scaling_group` field in the `nodepool` section instead.
1738
+ * **[Deprecated]** For node pool configuration, use the `period` parameter under `scaling_group` in `nodepool`.
1509
1739
  *
1510
- * The subscription duration of worker nodes. This parameter takes effect and is required only when `worker_instance_charge_type` is set to `PrePaid`.
1740
+ * Subscription duration for worker nodes in months. Required and valid only when `worker_instance_charge_type` is `PrePaid`.
1511
1741
  *
1512
- * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
1742
+ * Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.
1513
1743
  *
1514
1744
  * Default value: 1.
1515
1745
  *
@@ -1521,11 +1751,11 @@ export declare class CreateClusterRequest extends $dara.Model {
1521
1751
  workerPeriod?: number;
1522
1752
  /**
1523
1753
  * @remarks
1524
- * [**Deprecated**] When you configure a node pool, use the `period_unit` parameter of the `scaling_group` field in the `nodepool` section instead.
1754
+ * **[Deprecated]** For node pool configuration, use the `period_unit` parameter under `scaling_group` in `nodepool`.
1525
1755
  *
1526
- * The billing cycle of worker nodes. This parameter is required if worker_instance_charge_type is set to `PrePaid`.
1756
+ * Worker node billing cycle. Required when worker_instance_charge_type is `PrePaid`.
1527
1757
  *
1528
- * Valid value: `Month`, which indicates that worker nodes are billed only on a monthly basis.
1758
+ * Valid value: `Month`. Only monthly billing is supported.
1529
1759
  *
1530
1760
  * @example
1531
1761
  * Month
@@ -1535,14 +1765,15 @@ export declare class CreateClusterRequest extends $dara.Model {
1535
1765
  workerPeriodUnit?: string;
1536
1766
  /**
1537
1767
  * @remarks
1538
- * [**Deprecated**] When you configure a node pool, use the `system_disk_category` parameter of the `scaling_group` field in the `nodepool` section instead.
1768
+ * **[Deprecated]** For node pool configuration, use the `system_disk_category` parameter under `scaling_group` in `nodepool`.
1539
1769
  *
1540
- * The system disk category of worker nodes. For more information, see [Elastic Block Storage devices](https://help.aliyun.com/document_detail/63136.html).
1770
+ * Worker node system disk type. For more information, see [Overview of Elastic Block Storage](https://help.aliyun.com/document_detail/63136.html).
1541
1771
  *
1542
1772
  * Valid values:
1543
1773
  *
1544
- * * `cloud_efficiency`: ultra disk.
1545
- * * `cloud_ssd`: standard SSD.
1774
+ * - `cloud_efficiency`: Ultra disk.
1775
+ *
1776
+ * - `cloud_ssd`: Standard SSD.
1546
1777
  *
1547
1778
  * Default value: `cloud_ssd`.
1548
1779
  *
@@ -1554,16 +1785,19 @@ export declare class CreateClusterRequest extends $dara.Model {
1554
1785
  workerSystemDiskCategory?: string;
1555
1786
  /**
1556
1787
  * @remarks
1557
- * [**Deprecated**] When you configure a node pool, use the `system_disk_performance_level` parameter of the `scaling_group` field in the `nodepool` section instead.
1788
+ * **[Deprecated]** For node pool configuration, use the `system_disk_performance_level` parameter under `scaling_group` in `nodepool`.
1558
1789
  *
1559
- * 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).
1790
+ * 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).
1560
1791
  *
1561
1792
  * Valid values:
1562
1793
  *
1563
- * * PL0
1564
- * * PL1
1565
- * * PL2
1566
- * * PL3
1794
+ * - PL0
1795
+ *
1796
+ * - PL1
1797
+ *
1798
+ * - PL2
1799
+ *
1800
+ * - PL3
1567
1801
  *
1568
1802
  * @example
1569
1803
  * PL1
@@ -1573,13 +1807,13 @@ export declare class CreateClusterRequest extends $dara.Model {
1573
1807
  workerSystemDiskPerformanceLevel?: string;
1574
1808
  /**
1575
1809
  * @remarks
1576
- * [**Deprecated**] When you configure a node pool, use the `system_disk_size` parameter of the `scaling_group` field in the `nodepool` section instead.
1810
+ * **[Deprecated]** For node pool configuration, use the `system_disk_size` parameter under `scaling_group` in `nodepool`.
1577
1811
  *
1578
- * The system disk size of worker nodes. Unit: GiB.
1812
+ * Worker node system disk size in GiB.
1579
1813
  *
1580
- * Valid values: 40 to 500.
1814
+ * Valid range: [40,500].
1581
1815
  *
1582
- * The value of this parameter must be at least 40 and greater than or equal to the image size.
1816
+ * This value must be greater than or equal to max{40, ImageSize}.
1583
1817
  *
1584
1818
  * Default value: `120`.
1585
1819
  *
@@ -1591,9 +1825,9 @@ export declare class CreateClusterRequest extends $dara.Model {
1591
1825
  workerSystemDiskSize?: number;
1592
1826
  /**
1593
1827
  * @remarks
1594
- * [**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.
1828
+ * **[Deprecated]** For node pool configuration, use the `system_disk_snapshot_policy_id` parameter under `scaling_group` in `nodepool`.
1595
1829
  *
1596
- * The ID of the automatic snapshot policy that is used by the system disk specified for worker nodes.
1830
+ * Automatic snapshot policy ID for worker node system disks.
1597
1831
  *
1598
1832
  * @example
1599
1833
  * sp-2zej1nogjvovnz4z****
@@ -1603,22 +1837,22 @@ export declare class CreateClusterRequest extends $dara.Model {
1603
1837
  workerSystemDiskSnapshotPolicyId?: string;
1604
1838
  /**
1605
1839
  * @remarks
1606
- * [**Deprecated**] When you configure a node pool, use the `vswitch_ids` parameter of the `scaling_group` field in the `nodepool` section instead.
1840
+ * **[Deprecated]** For node pool configuration, use the `vswitch_ids` parameter under `scaling_group` in `nodepool`.
1607
1841
  *
1608
- * The vSwitches for worker nodes. Each worker node is allocated a vSwitch.
1842
+ * List of vSwitches used by cluster nodes. One node corresponds to one value.
1609
1843
  *
1610
- * `worker_vswitch_ids` is optional, but `vswitch_ids` is required if you create an ACK managed cluster that does not contain nodes.
1844
+ * When creating a zero-node managed cluster, `worker_vswitch_ids` is optional, but you must provide `vswitch_ids`.
1611
1845
  *
1612
1846
  * @deprecated
1613
1847
  */
1614
1848
  workerVswitchIds?: string[];
1615
1849
  /**
1616
1850
  * @remarks
1617
- * [Deprecated] Use the `zone_ids` parameter instead.
1851
+ * **[Deprecated]** Use the `zone_ids` parameter instead.
1618
1852
  *
1619
- * The ID of the zone to which the cluster belongs. This parameter is specific to ACK Serverless clusters.
1853
+ * The zone ID in the cluster region. This parameter applies only to ACK managed clusters.
1620
1854
  *
1621
- * 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.
1855
+ * 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`.
1622
1856
  *
1623
1857
  * @example
1624
1858
  * cn-beiji****
@@ -1628,9 +1862,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1628
1862
  zoneId?: string;
1629
1863
  /**
1630
1864
  * @remarks
1631
- * The IDs of the zone in which the cluster is deployed. This parameter is specific to ACK managed clusters.
1632
- *
1633
- * 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.
1865
+ * A list of zone IDs in the cluster region. This parameter applies only to ACK managed clusters.
1634
1866
  */
1635
1867
  zoneIds?: string[];
1636
1868
  static names(): {