@alicloud/cs20151215 7.0.3 → 7.0.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 (70) hide show
  1. package/dist/client.d.ts +38 -50
  2. package/dist/client.js +72 -79
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/CreateClusterNodePoolRequest.d.ts +182 -369
  5. package/dist/models/CreateClusterNodePoolRequest.js +31 -1
  6. package/dist/models/CreateClusterNodePoolRequest.js.map +1 -1
  7. package/dist/models/CreateClusterRequest.d.ts +174 -649
  8. package/dist/models/CreateClusterRequest.js +27 -1
  9. package/dist/models/CreateClusterRequest.js.map +1 -1
  10. package/dist/models/CreateClusterResponseBody.d.ts +3 -3
  11. package/dist/models/DescribeAddonRequest.d.ts +7 -18
  12. package/dist/models/DescribeAddonRequest.js.map +1 -1
  13. package/dist/models/DescribeAddonResponseBody.d.ts +12 -12
  14. package/dist/models/DescribeClusterDetailResponseBody.d.ts +147 -106
  15. package/dist/models/DescribeClusterDetailResponseBody.js +29 -1
  16. package/dist/models/DescribeClusterDetailResponseBody.js.map +1 -1
  17. package/dist/models/DescribeClusterNodePoolDetailResponseBody.d.ts +195 -232
  18. package/dist/models/DescribeClusterNodePoolDetailResponseBody.js +31 -1
  19. package/dist/models/DescribeClusterNodePoolDetailResponseBody.js.map +1 -1
  20. package/dist/models/DescribeClusterNodePoolsResponseBody.d.ts +153 -244
  21. package/dist/models/DescribeClusterNodePoolsResponseBody.js +31 -1
  22. package/dist/models/DescribeClusterNodePoolsResponseBody.js.map +1 -1
  23. package/dist/models/InstallNodePoolComponentsRequest.d.ts +12 -4
  24. package/dist/models/InstallNodePoolComponentsRequest.js +2 -0
  25. package/dist/models/InstallNodePoolComponentsRequest.js.map +1 -1
  26. package/dist/models/MaintenanceWindow.d.ts +1 -1
  27. package/dist/models/ModifyClusterNodePoolRequest.d.ts +107 -250
  28. package/dist/models/ModifyClusterNodePoolRequest.js +6 -0
  29. package/dist/models/ModifyClusterNodePoolRequest.js.map +1 -1
  30. package/dist/models/ModifyClusterRequest.d.ts +151 -112
  31. package/dist/models/ModifyClusterRequest.js +29 -1
  32. package/dist/models/ModifyClusterRequest.js.map +1 -1
  33. package/dist/models/ModifyClusterResponseBody.d.ts +3 -3
  34. package/dist/models/ModifyNodePoolNodeConfigRequest.d.ts +9 -1
  35. package/dist/models/ModifyNodePoolNodeConfigRequest.js +2 -0
  36. package/dist/models/ModifyNodePoolNodeConfigRequest.js.map +1 -1
  37. package/dist/models/Nodepool.d.ts +128 -209
  38. package/dist/models/Nodepool.js +29 -1
  39. package/dist/models/Nodepool.js.map +1 -1
  40. package/dist/models/Runtime.d.ts +2 -2
  41. package/dist/models/UpdateNodePoolComponentRequest.d.ts +12 -4
  42. package/dist/models/UpdateNodePoolComponentRequest.js +2 -0
  43. package/dist/models/UpdateNodePoolComponentRequest.js.map +1 -1
  44. package/dist/models/UpgradeClusterNodepoolRequest.d.ts +23 -11
  45. package/dist/models/UpgradeClusterNodepoolRequest.js +2 -0
  46. package/dist/models/UpgradeClusterNodepoolRequest.js.map +1 -1
  47. package/dist/models/model.d.ts +7 -0
  48. package/dist/models/model.js +80 -66
  49. package/dist/models/model.js.map +1 -1
  50. package/package.json +2 -2
  51. package/src/client.ts +73 -79
  52. package/src/models/CreateClusterNodePoolRequest.ts +204 -370
  53. package/src/models/CreateClusterRequest.ts +191 -649
  54. package/src/models/CreateClusterResponseBody.ts +3 -3
  55. package/src/models/DescribeAddonRequest.ts +7 -18
  56. package/src/models/DescribeAddonResponseBody.ts +12 -12
  57. package/src/models/DescribeClusterDetailResponseBody.ts +166 -106
  58. package/src/models/DescribeClusterNodePoolDetailResponseBody.ts +216 -232
  59. package/src/models/DescribeClusterNodePoolsResponseBody.ts +174 -244
  60. package/src/models/InstallNodePoolComponentsRequest.ts +14 -4
  61. package/src/models/MaintenanceWindow.ts +1 -1
  62. package/src/models/ModifyClusterNodePoolRequest.ts +113 -250
  63. package/src/models/ModifyClusterRequest.ts +170 -112
  64. package/src/models/ModifyClusterResponseBody.ts +3 -3
  65. package/src/models/ModifyNodePoolNodeConfigRequest.ts +11 -1
  66. package/src/models/Nodepool.ts +147 -209
  67. package/src/models/Runtime.ts +2 -2
  68. package/src/models/UpdateNodePoolComponentRequest.ts +14 -4
  69. package/src/models/UpgradeClusterNodepoolRequest.ts +25 -11
  70. package/src/models/model.ts +7 -0
@@ -9,11 +9,7 @@ import { InstanceMetadataOptions } from "./InstanceMetadataOptions";
9
9
  export declare class CreateClusterRequestAuditLogConfig extends $dara.Model {
10
10
  /**
11
11
  * @remarks
12
- * Whether to enable the cluster audit log feature.
13
- *
14
- * - true: Enable.
15
- *
16
- * - false: Disable.
12
+ * Specifies whether to enable the cluster audit log feature.
17
13
  *
18
14
  * @example
19
15
  * true
@@ -21,11 +17,7 @@ export declare class CreateClusterRequestAuditLogConfig extends $dara.Model {
21
17
  enabled?: boolean;
22
18
  /**
23
19
  * @remarks
24
- * The [SLS Project](https://help.aliyun.com/document_detail/48873.html) where the cluster audit log [Logstore](https://help.aliyun.com/document_detail/48873.html) is located.
25
- *
26
- * - Default value: `k8s-log-{clusterid}`.
27
- *
28
- * - After enabling the cluster audit log feature, a corresponding Logstore will be created under the specified SLS Project.
20
+ * The [Simple Log Service project](https://help.aliyun.com/document_detail/48873.html) that contains the [Logstore](https://help.aliyun.com/document_detail/48873.html) for cluster audit logs.
29
21
  *
30
22
  * @example
31
23
  * k8s-log-c2345xxxxxxxxxxxx
@@ -45,11 +37,7 @@ export declare class CreateClusterRequestAuditLogConfig extends $dara.Model {
45
37
  export declare class CreateClusterRequestAutoMode extends $dara.Model {
46
38
  /**
47
39
  * @remarks
48
- * Whether to enable intelligent managed mode.
49
- *
50
- * - true: Enable.
51
- *
52
- * - false: Disable.
40
+ * Specifies whether to enable intelligent managed mode.
53
41
  *
54
42
  * @example
55
43
  * true
@@ -69,11 +57,7 @@ export declare class CreateClusterRequestAutoMode extends $dara.Model {
69
57
  export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model {
70
58
  /**
71
59
  * @remarks
72
- * Whether to enable auto-renewal for control plane nodes. Valid when the billing type is `PrePaid`.
73
- * - true: Enable auto-renewal.
74
- * - false: Disable auto-renewal.
75
- *
76
- * Default value: true.
60
+ * Specifies whether to enable auto-renewal for control plane nodes. This parameter is valid only when charge_type is set to `PrePaid`.
77
61
  *
78
62
  * @example
79
63
  * true
@@ -81,11 +65,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
81
65
  autoRenew?: boolean;
82
66
  /**
83
67
  * @remarks
84
- * Auto-renewal duration for control plane nodes.
85
- *
86
- * Valid values: {1, 2, 3, 6, 12}. Unit: months.
87
- *
88
- * Default value: 1.
68
+ * The auto-renewal duration of control plane nodes.
89
69
  *
90
70
  * @example
91
71
  * 1
@@ -93,12 +73,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
93
73
  autoRenewPeriod?: number;
94
74
  /**
95
75
  * @remarks
96
- * Control plane node billing type.
97
- *
98
- * - `PrePaid`: Subscription.
99
- * - `PostPaid`: Pay-as-you-go.
100
- *
101
- * Default value: `PostPaid`.
76
+ * The billing method of control plane nodes.
102
77
  *
103
78
  * @example
104
79
  * PostPaid
@@ -106,13 +81,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
106
81
  chargeType?: string;
107
82
  /**
108
83
  * @remarks
109
- * Whether to install CloudMonitor on nodes.
110
- *
111
- * - true: Install the CloudMonitor agent.
112
- *
113
- * - false: Do not install the CloudMonitor agent.
114
- *
115
- * Default value: false.
84
+ * Specifies whether to install CloudMonitor on nodes.
116
85
  *
117
86
  * @example
118
87
  * false
@@ -120,13 +89,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
120
89
  cloudMonitorFlags?: boolean;
121
90
  /**
122
91
  * @remarks
123
- * Node CPU management policy.
124
- *
125
- * - static: Allows enhancing CPU affinity and exclusivity for Pods with certain resource characteristics on the node.
126
- *
127
- * - none: Enables the existing default CPU affinity scheme.
128
- *
129
- * Default value: none.
92
+ * The CPU management policy for nodes.
130
93
  *
131
94
  * @example
132
95
  * none
@@ -134,7 +97,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
134
97
  cpuPolicy?: string;
135
98
  /**
136
99
  * @remarks
137
- * Deployment set ID.
100
+ * The deployment set ID.
138
101
  *
139
102
  * @example
140
103
  * ds-bp10b35imuam5amw****
@@ -142,7 +105,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
142
105
  deploymentsetId?: string;
143
106
  /**
144
107
  * @remarks
145
- * Image ID.
108
+ * The image ID.
146
109
  *
147
110
  * @example
148
111
  * aliyun_3_x64_20G_alibase_20240819.vhd
@@ -150,7 +113,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
150
113
  imageId?: string;
151
114
  /**
152
115
  * @remarks
153
- * OS image type.
116
+ * The operating system image type.
154
117
  *
155
118
  * @example
156
119
  * AliyunLinux3
@@ -158,17 +121,17 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
158
121
  imageType?: string;
159
122
  /**
160
123
  * @remarks
161
- * ECS instance metadata access configuration.
124
+ * The instance metadata access configuration for ECS instances.
162
125
  */
163
126
  instanceMetadataOptions?: InstanceMetadataOptions;
164
127
  /**
165
128
  * @remarks
166
- * Node instance types.
129
+ * The instance types of nodes.
167
130
  */
168
131
  instanceTypes?: string[];
169
132
  /**
170
133
  * @remarks
171
- * Key pair name. Mutually exclusive with login_password.
134
+ * The name of the key pair. Specify either this parameter or login_password.
172
135
  *
173
136
  * @example
174
137
  * ack
@@ -176,7 +139,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
176
139
  keyPair?: string;
177
140
  /**
178
141
  * @remarks
179
- * SSH login password. The password must be 8 to 30 characters in length and contain at least three of the following: uppercase letters, lowercase letters, digits, and special characters. Mutually exclusive with key_pair.
142
+ * The SSH logon password. The password must be 8 to 30 characters in length and contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. Specify either this parameter or key_pair.
180
143
  *
181
144
  * @example
182
145
  * ********
@@ -184,7 +147,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
184
147
  loginPassword?: string;
185
148
  /**
186
149
  * @remarks
187
- * [**This field is deprecated**] Node service port range.
150
+ * **[Deprecated]** The node service port range.
188
151
  *
189
152
  * @example
190
153
  * 30000-32767
@@ -192,11 +155,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
192
155
  nodePortRange?: string;
193
156
  /**
194
157
  * @remarks
195
- * Subscription duration for control plane nodes. Valid and required when the billing type is `PrePaid`.
196
- *
197
- * Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}. Unit: months.
198
- *
199
- * Default value: 1.
158
+ * The subscription duration of control plane nodes. This parameter is valid and required only when charge_type is set to `PrePaid`.
200
159
  *
201
160
  * @example
202
161
  * 1
@@ -204,9 +163,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
204
163
  period?: number;
205
164
  /**
206
165
  * @remarks
207
- * Subscription period unit for control plane nodes. Valid and required when the billing type is `PrePaid`.
208
- *
209
- * Valid value: `Month`. Currently, only month-based periods are supported.
166
+ * The unit of the subscription duration of control plane nodes. This parameter is valid and required only when charge_type is set to `PrePaid`.
210
167
  *
211
168
  * @example
212
169
  * Month
@@ -214,9 +171,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
214
171
  periodUnit?: string;
215
172
  /**
216
173
  * @remarks
217
- * [**This field is deprecated**] Control plane node runtime name. Valid value:
218
- *
219
- * containerd: Containerd runtime, supported by all cluster versions.
174
+ * **[Deprecated]** The runtime name of control plane nodes. Valid values:
220
175
  *
221
176
  * @example
222
177
  * containerd
@@ -224,13 +179,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
224
179
  runtime?: string;
225
180
  /**
226
181
  * @remarks
227
- * Whether to enable Alibaba Cloud OS security hardening.
228
- *
229
- * - true: Enable Alibaba Cloud OS security hardening.
230
- *
231
- * - false: Disable Alibaba Cloud OS security hardening.
232
- *
233
- * Default value: false.
182
+ * Specifies whether to enable Alibaba Cloud OS security hardening.
234
183
  *
235
184
  * @example
236
185
  * false
@@ -238,9 +187,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
238
187
  securityHardeningOs?: boolean;
239
188
  /**
240
189
  * @remarks
241
- * Number of control plane nodes.
242
- *
243
- * Valid values: `3` or `5`.
190
+ * The number of control plane nodes.
244
191
  *
245
192
  * @example
246
193
  * 3
@@ -248,13 +195,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
248
195
  size?: number;
249
196
  /**
250
197
  * @remarks
251
- * Whether to enable classified protection security hardening.
252
- *
253
- * - true: Enable classified protection hardening.
254
- *
255
- * - false: Disable classified protection hardening.
256
- *
257
- * Default value: false.
198
+ * Specifies whether to enable MLPS security hardening.
258
199
  *
259
200
  * @example
260
201
  * false
@@ -262,13 +203,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
262
203
  socEnabled?: boolean;
263
204
  /**
264
205
  * @remarks
265
- * Whether to enable burst (performance burst) for the node system disk.
266
- *
267
- * - true: Enable.
268
- *
269
- * - false: Disable.
270
- *
271
- * This parameter is only supported when `system_disk_category` is set to `cloud_auto`.
206
+ * Specifies whether to enable burst (performance burst) for the system cloud disk of nodes.
272
207
  *
273
208
  * @example
274
209
  * true
@@ -276,15 +211,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
276
211
  systemDiskBurstingEnabled?: boolean;
277
212
  /**
278
213
  * @remarks
279
- * Node system disk type.
280
- *
281
- * - `cloud_efficiency`: Ultra disk.
282
- * - `cloud_ssd`: SSD disk.
283
- * - `cloud_essd`: ESSD disk.
284
- * - `cloud_auto`: ESSD AutoPL disk.
285
- * - `cloud_essd_entry`: ESSD Entry disk.
286
- *
287
- * Default value: `cloud_ssd`. The default value may vary across availability zones.
214
+ * The type of the system cloud disk for nodes.
288
215
  *
289
216
  * @example
290
217
  * cloud_ssd
@@ -292,9 +219,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
292
219
  systemDiskCategory?: string;
293
220
  /**
294
221
  * @remarks
295
- * Node system disk performance level. Only takes effect for ESSD disks.
296
- *
297
- * The performance level is related to the disk size. For more information, see [ESSD disk](https://help.aliyun.com/document_detail/122389.html).
222
+ * The performance level of the system cloud disk. This parameter takes effect only for ESSD disks.
298
223
  *
299
224
  * @example
300
225
  * PL1
@@ -302,11 +227,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
302
227
  systemDiskPerformanceLevel?: string;
303
228
  /**
304
229
  * @remarks
305
- * Pre-provisioned read/write IOPS for the node system disk.
306
- *
307
- * Valid values: 0 to min{50,000, 1000*capacity - baseline performance}. Baseline performance = min{1,800 + 50*capacity, 50000}.
308
- *
309
- * This parameter is only supported when `system_disk_category` is set to `cloud_auto`.
230
+ * The provisioned read/write IOPS of the system cloud disk for nodes.
310
231
  *
311
232
  * @example
312
233
  * 1000
@@ -314,11 +235,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
314
235
  systemDiskProvisionedIops?: number;
315
236
  /**
316
237
  * @remarks
317
- * Node system disk size.
318
- *
319
- * Valid values: [40, 500\\]. Unit: GiB.
320
- *
321
- * Default value: `120`.
238
+ * The size of the system cloud disk for nodes.
322
239
  *
323
240
  * @example
324
241
  * 120
@@ -326,7 +243,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
326
243
  systemDiskSize?: number;
327
244
  /**
328
245
  * @remarks
329
- * Node automatic snapshot backup policy.
246
+ * The automatic snapshot policy for nodes.
330
247
  *
331
248
  * @example
332
249
  * sp-2zej1nogjvovnz4z****
@@ -346,7 +263,7 @@ export declare class CreateClusterRequestControlPlaneConfig extends $dara.Model
346
263
  export declare class CreateClusterRequestControlPlaneEndpointsConfigInternalDnsConfig extends $dara.Model {
347
264
  /**
348
265
  * @remarks
349
- * VPCs where the internal DNS record resolution takes effect.
266
+ * The VPCs in which the internal domain name DNS resolution takes effect.
350
267
  */
351
268
  bindVpcs?: string[];
352
269
  static names(): {
@@ -360,12 +277,45 @@ export declare class CreateClusterRequestControlPlaneEndpointsConfigInternalDnsC
360
277
  [key: string]: any;
361
278
  });
362
279
  }
280
+ export declare class CreateClusterRequestControlPlaneEndpointsConfigLoadBalancersConfig extends $dara.Model {
281
+ /**
282
+ * @remarks
283
+ * The endpoint type.
284
+ *
285
+ * @example
286
+ * private
287
+ */
288
+ endpointType?: string;
289
+ /**
290
+ * @remarks
291
+ * The NLB instance ID.
292
+ *
293
+ * @example
294
+ * nlb-0ogk9aaxxxxxxx
295
+ */
296
+ loadBalancerId?: string;
297
+ static names(): {
298
+ [key: string]: string;
299
+ };
300
+ static types(): {
301
+ [key: string]: any;
302
+ };
303
+ validate(): void;
304
+ constructor(map?: {
305
+ [key: string]: any;
306
+ });
307
+ }
363
308
  export declare class CreateClusterRequestControlPlaneEndpointsConfig extends $dara.Model {
364
309
  /**
365
310
  * @remarks
366
- * Internal DNS configuration for the cluster, applicable to ACK managed clusters. The internal DNS is used by node-side system components such as kubelet and kube-proxy to access the API Server. When internal DNS access is not enabled, node-side system components will access via CLB IP.
311
+ * The internal DNS configuration of the cluster. This applies to ACK managed clusters. The internal domain name is used by node-side system components such as kubelet and kube-proxy to access the API Server. If the internal domain name access is not enabled, node-side system components access the API Server through the CLB IP address.
367
312
  */
368
313
  internalDnsConfig?: CreateClusterRequestControlPlaneEndpointsConfigInternalDnsConfig;
314
+ /**
315
+ * @remarks
316
+ * The cluster connection configuration. When this field is specified, the endpoint_public_access and load_balancer_id parameters do not take effect.
317
+ */
318
+ loadBalancersConfig?: CreateClusterRequestControlPlaneEndpointsConfigLoadBalancersConfig[];
369
319
  static names(): {
370
320
  [key: string]: string;
371
321
  };
@@ -380,10 +330,7 @@ export declare class CreateClusterRequestControlPlaneEndpointsConfig extends $da
380
330
  export declare class CreateClusterRequestOperationPolicyClusterAutoUpgrade extends $dara.Model {
381
331
  /**
382
332
  * @remarks
383
- * Cluster automatic upgrade frequency. Valid values:
384
- * - patch: Automatically upgrade to an available patch version of the current minor version. The new Kubernetes version will not contain breaking changes.
385
- * - stable: Automatically upgrade to the latest patch version of the second-newest minor version. The new Kubernetes version may involve API and feature changes, but its stability has been widely verified.
386
- * - rapid: Automatically upgrade to the latest patch version of the latest minor version to get new features from the Kubernetes community faster.
333
+ * The cluster auto-upgrade frequency. Valid values:
387
334
  *
388
335
  * @example
389
336
  * stable
@@ -391,11 +338,7 @@ export declare class CreateClusterRequestOperationPolicyClusterAutoUpgrade exten
391
338
  channel?: string;
392
339
  /**
393
340
  * @remarks
394
- * Whether to enable cluster automatic upgrade.
395
- *
396
- * - true: Enable.
397
- *
398
- * - false: Disable.
341
+ * Specifies whether to enable cluster auto-upgrade.
399
342
  *
400
343
  * @example
401
344
  * true
@@ -415,7 +358,7 @@ export declare class CreateClusterRequestOperationPolicyClusterAutoUpgrade exten
415
358
  export declare class CreateClusterRequestOperationPolicy extends $dara.Model {
416
359
  /**
417
360
  * @remarks
418
- * Cluster automatic upgrade.
361
+ * The cluster auto-upgrade configuration.
419
362
  */
420
363
  clusterAutoUpgrade?: CreateClusterRequestOperationPolicyClusterAutoUpgrade;
421
364
  static names(): {
@@ -432,11 +375,7 @@ export declare class CreateClusterRequestOperationPolicy extends $dara.Model {
432
375
  export declare class CreateClusterRequestRrsaConfig extends $dara.Model {
433
376
  /**
434
377
  * @remarks
435
- * Whether to enable the RRSA feature.
436
- *
437
- * - true: Enable.
438
- *
439
- * - false: Disable.
378
+ * Specifies whether to enable the RRSA feature.
440
379
  *
441
380
  * @example
442
381
  * true
@@ -456,7 +395,7 @@ export declare class CreateClusterRequestRrsaConfig extends $dara.Model {
456
395
  export declare class CreateClusterRequestWorkerDataDisks extends $dara.Model {
457
396
  /**
458
397
  * @remarks
459
- * Data disk type.
398
+ * The type of the data disk.
460
399
  *
461
400
  * This parameter is required.
462
401
  *
@@ -466,12 +405,7 @@ export declare class CreateClusterRequestWorkerDataDisks extends $dara.Model {
466
405
  category?: string;
467
406
  /**
468
407
  * @remarks
469
- * Whether to encrypt the data disk. Valid values:
470
- *
471
- * - `true`: Encrypt the data disk.
472
- * - `false`: Do not encrypt the data disk.
473
- *
474
- * Default value: `false`.
408
+ * Specifies whether to encrypt the data disk. Valid values:
475
409
  *
476
410
  * @example
477
411
  * true
@@ -479,7 +413,7 @@ export declare class CreateClusterRequestWorkerDataDisks extends $dara.Model {
479
413
  encrypted?: string;
480
414
  /**
481
415
  * @remarks
482
- * Node data disk performance level. Only takes effect for [ESSD disks](https://help.aliyun.com/document_detail/122389.html).
416
+ * The performance level of the data cloud disk for nodes. This parameter takes effect only for [standard SSDs](https://help.aliyun.com/document_detail/122389.html).
483
417
  *
484
418
  * @example
485
419
  * PL1
@@ -487,7 +421,7 @@ export declare class CreateClusterRequestWorkerDataDisks extends $dara.Model {
487
421
  performanceLevel?: string;
488
422
  /**
489
423
  * @remarks
490
- * Data disk size. Valid values: 40 to 32767. Unit: GiB.
424
+ * The size of the data disk. Valid values: 40 to 32767. Unit: GiB.
491
425
  *
492
426
  * This parameter is required.
493
427
  *
@@ -509,46 +443,19 @@ export declare class CreateClusterRequestWorkerDataDisks extends $dara.Model {
509
443
  export declare class CreateClusterRequest extends $dara.Model {
510
444
  /**
511
445
  * @remarks
512
- * [**This field is deprecated**] Registered cluster API Server SLB access control list.
446
+ * **[Deprecated]** The access control list for the API Server SLB of the registered cluster.
513
447
  *
514
448
  * @deprecated
515
449
  */
516
450
  accessControlList?: string[];
517
451
  /**
518
452
  * @remarks
519
- * List of cluster components. Specify the components to install when creating a cluster through `addons`.
520
- *
521
- * **Network component**: Required. Choose between Flannel and Terway network types when creating a cluster:
522
- *
523
- * - Flannel network: [{"name":"flannel","config":""}].
524
- * - Terway network: [{"name": "terway-eniip","config": ""}] .
525
- *
526
- * **Storage component**: Optional. Only the `csi` type is supported:
527
- *
528
- * `csi`: [{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}].
529
- *
530
- * **Log component**: Optional. Recommended to enable. If Log Service is not enabled, the cluster audit feature will be unavailable.
531
- *
532
- * - Use an existing `SLS Project`: [{"name": "loongcollector","config": "{\\"IngressDashboardEnabled\\":\\"true\\",\\"sls_project_name\\":\\"your_sls_project_name\\"}"}] .
533
- * - Create a new `SLS Project`: [{"name": "loongcollector","config": "{\\"IngressDashboardEnabled\\":\\"true\\"}"}] .
534
- *
535
- * **Ingress component**: Optional. ACK dedicated clusters install the Ingress component `nginx-ingress-controller` by default.
536
- *
537
- * - Install Ingress with public network access: [{"name":"nginx-ingress-controller","config":"{\\"IngressSlbNetworkType\\":\\"internet\\"}"}] .
538
- * - Disable default Ingress installation: [{"name": "nginx-ingress-controller","config": "","disabled": true}] .
539
- *
540
- * **Event center**: Optional. Enabled by default.
541
- *
542
- * The event center provides capabilities for storing, querying, and alerting on Kubernetes events. The Logstore associated with the Kubernetes event center is free for 90 days. For more information about the free policy, see [Create and use the Kubernetes event center](https://help.aliyun.com/document_detail/150476.html).
543
- *
544
- * Example of enabling the event center: [{"name":"ack-node-problem-detector","config":"{\\"sls_project_name\\":\\"your_sls_project_name\\"}"}].
453
+ * The list of cluster components. Use `addons` to specify the components to install when creating a cluster.
545
454
  */
546
455
  addons?: Addon[];
547
456
  /**
548
457
  * @remarks
549
- * ServiceAccount is the access credential for communication between Pods and the cluster API Server. `api-audiences` defines the valid request `token` identities used by the `apiserver` to verify whether the request `token` is legitimate. Multiple `audience` values can be configured, separated by commas (,).
550
- *
551
- * For more details about `ServiceAccount`, see [Deploy service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
458
+ * A ServiceAccount is the access credential for communication between a pod and the cluster API server. The `api-audiences` parameter specifies the valid request `token` identities used by the `apiserver` to authenticate whether a request `token` is valid. You can specify multiple `audience` values separated by commas (,).
552
459
  *
553
460
  * @example
554
461
  * kubernetes.default.svc
@@ -556,26 +463,17 @@ export declare class CreateClusterRequest extends $dara.Model {
556
463
  apiAudiences?: string;
557
464
  /**
558
465
  * @remarks
559
- * Cluster audit log configuration.
466
+ * The cluster audit log configuration.
560
467
  */
561
468
  auditLogConfig?: CreateClusterRequestAuditLogConfig;
562
469
  /**
563
470
  * @remarks
564
- * [Intelligent managed mode](https://help.aliyun.com/document_detail/2938898.html) configuration.
471
+ * The [intelligent managed mode](https://help.aliyun.com/document_detail/2938898.html) configuration.
565
472
  */
566
473
  autoMode?: CreateClusterRequestAutoMode;
567
474
  /**
568
475
  * @remarks
569
- * [**This field is deprecated**]
570
- *
571
- * Whether to enable auto-renewal. Only takes effect when `charge_type` is set to `PrePaid`. Valid values:
572
- *
573
- * - `true`: Enable auto-renewal.
574
- * - `false`: Disable auto-renewal.
575
- *
576
- * Default value: `false`.
577
- *
578
- * This field was changed on October 15, 2024. For more information, see [Announcement on CreateCluster API parameter behavior changes](https://help.aliyun.com/document_detail/2849194.html).
476
+ * **[Deprecated]**
579
477
  *
580
478
  * @example
581
479
  * true
@@ -585,13 +483,7 @@ export declare class CreateClusterRequest extends $dara.Model {
585
483
  autoRenew?: boolean;
586
484
  /**
587
485
  * @remarks
588
- * [**This field is deprecated**]
589
- *
590
- * Auto-renewal period. Only takes effect when subscription and auto-renewal are selected. When `PeriodUnit=Month`, valid values: {1, 2, 3, 6, 12}.
591
- *
592
- * Default value: 1.
593
- *
594
- * This field was changed on October 15, 2024. For more information, see [Announcement on CreateCluster API parameter behavior changes](https://help.aliyun.com/document_detail/2849194.html).
486
+ * **[Deprecated]**
595
487
  *
596
488
  * @example
597
489
  * 1
@@ -601,19 +493,7 @@ export declare class CreateClusterRequest extends $dara.Model {
601
493
  autoRenewPeriod?: number;
602
494
  /**
603
495
  * @remarks
604
- * [**This field is deprecated**]
605
- *
606
- * Billing type of the CLB instance used by the API Server. Default value: PostPaid. Valid values:
607
- * - PostPaid: Pay-as-you-go.
608
- * - PrePaid: Subscription. This billing type is no longer supported for newly created CLB instances. Existing instances are not affected.
609
- *
610
- * >Notice:
611
- *
612
- * - This field was changed on October 15, 2024. For more information, see [Announcement on CreateCluster API parameter behavior changes](https://help.aliyun.com/document_detail/2849194.html).
613
- * - Starting from December 1, 2024, newly created CLB instances no longer support the subscription billing type, and instance fees will be charged.
614
- * </notice>
615
- * <props="china">For details, see [Product announcement on canceling subscription billing for cluster API Server CLB](https://help.aliyun.com/document_detail/2851191.html) and [CLB billing adjustment announcement](https://help.aliyun.com/document_detail/2839797.html).
616
- * <props="intl">For details, see [CLB billing adjustment announcement](https://help.aliyun.com/document_detail/2839797.html).
496
+ * **[Deprecated]**
617
497
  *
618
498
  * @example
619
499
  * PostPaid
@@ -623,7 +503,7 @@ export declare class CreateClusterRequest extends $dara.Model {
623
503
  chargeType?: string;
624
504
  /**
625
505
  * @remarks
626
- * [**This field is deprecated**] For cluster control plane configuration, use the `security_hardening_os` parameter under `control_plane_config` instead. For node pool configuration, use the `security_hardening_os` parameter under `scaling_group` in `nodepool` instead.
506
+ * **[Deprecated]** For cluster control plane configuration, use the `security_hardening_os` parameter under `control_plane_config` instead. For node pool configuration, use the `security_hardening_os` parameter under `scaling_group` in `nodepool` instead.
627
507
  *
628
508
  * @example
629
509
  * false
@@ -633,14 +513,7 @@ export declare class CreateClusterRequest extends $dara.Model {
633
513
  cisEnabled?: boolean;
634
514
  /**
635
515
  * @remarks
636
- * [**This field is deprecated**] For cluster control plane node configuration, use the `cloud_monitor_flags` parameter under `control_plane_config` instead. For node pool configuration, use the `cms_enabled` parameter under `kubernetes_config` in `nodepool` instead.
637
- *
638
- * Whether to install the CloudMonitor agent in the cluster. Valid values:
639
- *
640
- * - `true`: Install the CloudMonitor agent.
641
- * - `false`: Do not install the CloudMonitor agent.
642
- *
643
- * Default value: `false`.
516
+ * **[Deprecated]** For cluster control plane node configuration, use the `cloud_monitor_flags` parameter under `control_plane_config` instead. For node pool configuration, use the `cms_enabled` parameter under `kubernetes_config` in `nodepool` instead.
644
517
  *
645
518
  * @example
646
519
  * false
@@ -650,9 +523,7 @@ export declare class CreateClusterRequest extends $dara.Model {
650
523
  cloudMonitorFlags?: boolean;
651
524
  /**
652
525
  * @remarks
653
- * Cluster local domain name.
654
- *
655
- * Naming rules: The domain name consists of one or more parts separated by periods (.). 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.
526
+ * The cluster local domain name.
656
527
  *
657
528
  * @example
658
529
  * cluster.local
@@ -660,17 +531,7 @@ export declare class CreateClusterRequest extends $dara.Model {
660
531
  clusterDomain?: string;
661
532
  /**
662
533
  * @remarks
663
- * After selecting `cluster_type` as `ManagedKubernetes` and configuring `profile`, you can further specify the cluster specification. Valid values:
664
- *
665
- * - `ack.standard`: Basic edition (selected by default when the value is empty)
666
- * - `ack.pro.small`: Pro edition
667
- * - `ack.pro.xlarge`: Pro XL
668
- * - `ack.pro.2xlarge`: Pro 2XL
669
- * - `ack.pro.4xlarge`: Pro 4XL (requires contacting customer service to enable allowlisting)
670
- *
671
- * 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). They pre-allocate and fix control plane resources to ensure that API concurrency and Pod scheduling capabilities always remain at a determined high level, suitable for AI training and inference, ultra-large-scale clusters, and mission-critical workloads.
672
- *
673
- * For the cluster management fees of Pro edition and provisioned control plane editions, 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).
534
+ * If you set `cluster_type` to `ManagedKubernetes` and configure `profile`, you can further specify the cluster specifications. Valid values:
674
535
  *
675
536
  * @example
676
537
  * ack.pro.small
@@ -679,8 +540,6 @@ export declare class CreateClusterRequest extends $dara.Model {
679
540
  /**
680
541
  * @remarks
681
542
  * - `Kubernetes`: ACK dedicated cluster.
682
- * - `ManagedKubernetes`: ACK managed cluster types, including ACK managed cluster (Pro and Basic editions), ACK Serverless cluster (Pro and Basic editions), ACK Edge cluster (Pro and Basic editions), and ACK Lingjun cluster (Pro edition).
683
- * - `ExternalKubernetes`: Registered cluster.
684
543
  *
685
544
  * @example
686
545
  * Kubernetes
@@ -688,11 +547,7 @@ export declare class CreateClusterRequest extends $dara.Model {
688
547
  clusterType?: string;
689
548
  /**
690
549
  * @remarks
691
- * Pod network CIDR block. Must be a valid private CIDR block, specifically the following CIDR blocks and their subnets: 10.0.0.0/8, 172.16-31.0.0/12-16, 192.168.0.0/16. Cannot overlap with the VPC or CIDR blocks used by existing Kubernetes clusters in the VPC. Cannot be modified after creation.
692
- *
693
- * For cluster network planning, see [ACK managed cluster network planning](https://help.aliyun.com/document_detail/86500.html).
694
- *
695
- * > This field is required for Flannel clusters.
550
+ * The pod network CIDR block. It must be a valid private CIDR block, which includes the following CIDR blocks and their subnets: 10.0.0.0/8, 172.16-31.0.0/12-16, and 192.168.0.0/16. It cannot overlap with the CIDR blocks used by the VPC or existing Kubernetes clusters in the VPC. It cannot be modified after the cluster is created.
696
551
  *
697
552
  * @example
698
553
  * 172.20.0.0/16
@@ -700,24 +555,22 @@ export declare class CreateClusterRequest extends $dara.Model {
700
555
  containerCidr?: string;
701
556
  /**
702
557
  * @remarks
703
- * ACK dedicated cluster control plane configuration.
558
+ * The control plane configuration for ACK dedicated clusters.
704
559
  */
705
560
  controlPlaneConfig?: CreateClusterRequestControlPlaneConfig;
706
561
  /**
707
562
  * @remarks
708
- * Cluster connection configuration.
563
+ * The cluster connection configuration.
709
564
  */
710
565
  controlPlaneEndpointsConfig?: CreateClusterRequestControlPlaneEndpointsConfig;
711
566
  /**
712
567
  * @remarks
713
- * List of component names, specifying which control plane components\\" logs to collect.
714
- *
715
- * By default, logs are collected from kube-apiserver, kube-controller-manager, kube-scheduler, and cloud-controller-manager.
568
+ * The list of component names that specifies which control plane components to collect logs from.
716
569
  */
717
570
  controlplaneLogComponents?: string[];
718
571
  /**
719
572
  * @remarks
720
- * Log Service project for control plane component logs. You can use an existing project for log storage or let the system automatically create a project. If you choose to auto-create a Log Service project, a project named `k8s-log-{ClusterID}` will be automatically created.
573
+ * The Simple Log Service project for control plane component logs. You can use an existing project for log storage or allow the system to automatically create a project. If you choose automatic creation, a Simple Log Service project named `k8s-log-{ClusterID}` is automatically created.
721
574
  *
722
575
  * @example
723
576
  * k8s-log-xxx
@@ -725,7 +578,7 @@ export declare class CreateClusterRequest extends $dara.Model {
725
578
  controlplaneLogProject?: string;
726
579
  /**
727
580
  * @remarks
728
- * Number of days to retain control plane component logs.
581
+ * The number of days for control plane component log retention.
729
582
  *
730
583
  * @example
731
584
  * 30
@@ -733,14 +586,7 @@ export declare class CreateClusterRequest extends $dara.Model {
733
586
  controlplaneLogTtl?: string;
734
587
  /**
735
588
  * @remarks
736
- * [**This field is deprecated**] For cluster control plane configuration, use the `cpu_policy` parameter under `control_plane_config` instead. For node pool configuration, use the `cpu_policy` parameter under `kubernetes_config` in `nodepool` instead.
737
- *
738
- * Node CPU management policy. The following two policies are supported when the cluster version is 1.12.6 or later:
739
- *
740
- * - `static`: Allows enhancing CPU affinity and exclusivity for Pods with certain resource characteristics on the node.
741
- * - `none`: Enables the existing default CPU affinity scheme.
742
- *
743
- * Default value: `none`.
589
+ * **[Deprecated]** For cluster control plane configuration, use the cpu_policy parameter under `control_plane_config` instead. For node pool configuration, use the cpu_policy parameter under `kubernetes_config` in `nodepool` instead.
744
590
  *
745
591
  * @example
746
592
  * none
@@ -750,9 +596,7 @@ export declare class CreateClusterRequest extends $dara.Model {
750
596
  cpuPolicy?: string;
751
597
  /**
752
598
  * @remarks
753
- * [**This field is deprecated**] Use the `extra_sans` parameter instead.
754
- *
755
- * Custom certificate SAN. Multiple IPs or domain names are separated by commas (,).
599
+ * **[Deprecated]** Use the `extra_sans` parameter instead.
756
600
  *
757
601
  * @example
758
602
  * cs.aliyun.com
@@ -762,12 +606,7 @@ export declare class CreateClusterRequest extends $dara.Model {
762
606
  customSan?: string;
763
607
  /**
764
608
  * @remarks
765
- * Cluster deletion protection, which prevents accidental cluster deletion through the console or API. Valid values:
766
- *
767
- * - `true`: Enable cluster deletion protection. The cluster cannot be deleted through the console or API.
768
- * - `false`: Disable cluster deletion protection. The cluster can be deleted through the console or API.
769
- *
770
- * Default value: `false`.
609
+ * Specifies whether to enable deletion protection for the cluster to prevent accidental deletion through the console or API. Valid values:
771
610
  *
772
611
  * @example
773
612
  * true
@@ -775,15 +614,7 @@ export declare class CreateClusterRequest extends $dara.Model {
775
614
  deletionProtection?: boolean;
776
615
  /**
777
616
  * @remarks
778
- * [**This field is deprecated**] By default, no rollback is performed when cluster creation fails. You need to clean up the failed cluster yourself.
779
- *
780
- * Whether to roll back when cluster creation fails. Valid values:
781
- *
782
- * - `true`: Roll back when cluster creation fails.
783
- * - `false`: Do not roll back when cluster creation fails.
784
- *
785
- *
786
- * Default value: `true`.
617
+ * **[Deprecated]** When cluster creation fails, rollback is not performed by default. You must manually clean up the failed cluster.
787
618
  *
788
619
  * @example
789
620
  * true
@@ -793,13 +624,7 @@ export declare class CreateClusterRequest extends $dara.Model {
793
624
  disableRollback?: boolean;
794
625
  /**
795
626
  * @remarks
796
- * [**This field is deprecated**] Use the `rrsa_config` parameter instead.
797
- *
798
- * Whether to enable the RRSA feature.
799
- *
800
- * - true: Enable.
801
- *
802
- * - false: Disable.
627
+ * **[Deprecated]** Use the `rrsa_config` parameter instead.
803
628
  *
804
629
  * @example
805
630
  * false
@@ -809,9 +634,7 @@ export declare class CreateClusterRequest extends $dara.Model {
809
634
  enableRrsa?: boolean;
810
635
  /**
811
636
  * @remarks
812
- * KMS key ID. This key is used to encrypt data disks. For more details, see [Key Management Service](https://help.aliyun.com/document_detail/28935.html).
813
- *
814
- * > This feature only takes effect in professional managed clusters (ACK Pro clusters).
637
+ * The KMS key ID used to encrypt data cloud disks. For more information, see [Key Management Service](https://help.aliyun.com/document_detail/28935.html).
815
638
  *
816
639
  * @example
817
640
  * 0fe64791-55eb-4fc7-84c5-c6c7cdca****
@@ -819,12 +642,7 @@ export declare class CreateClusterRequest extends $dara.Model {
819
642
  encryptionProviderKey?: string;
820
643
  /**
821
644
  * @remarks
822
- * Whether to enable public access. Expose the API Server through an EIP to enable public access to the cluster.
823
- *
824
- * - `true`: Enable public access.
825
- * - `false`: Disable public access. When disabled, the cluster API Server cannot be accessed from the Internet.
826
- *
827
- * Default value: `false`.
645
+ * Specifies whether to public network access. The API Server is exposed through an EIP to public network access to the cluster.
828
646
  *
829
647
  * @example
830
648
  * true
@@ -832,25 +650,12 @@ export declare class CreateClusterRequest extends $dara.Model {
832
650
  endpointPublicAccess?: boolean;
833
651
  /**
834
652
  * @remarks
835
- * Custom API Server certificate SAN (Subject Alternative Name).
653
+ * The custom API Server certificate SAN (Subject Alternative Name).
836
654
  */
837
655
  extraSans?: string[];
838
656
  /**
839
657
  * @remarks
840
- * [**This field is deprecated**] Selecting existing nodes when creating a cluster is no longer supported. To add existing nodes to a cluster, create a node pool first and call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) API.
841
- *
842
- * Whether to mount data disks on instances when creating a cluster with existing instances. Valid values:
843
- *
844
- * - `true`: Store containers and images on the data disk. Existing data on the data disk will be lost. Please back up your data.
845
- *
846
- * - `false`: Do not store containers and images on the data disk.
847
- *
848
- * Default value: `false`.
849
- *
850
- * Data disk mounting rules:
851
- *
852
- * - If the ECS instance already has data disks mounted and the file system of the last data disk is not initialized, the system will automatically format the data disk as ext4 to store /var/lib/docker and /var/lib/kubelet.
853
- * - If the ECS instance has no data disks mounted, no new data disk will be mounted.
658
+ * **[Deprecated]** Selecting existing nodes during cluster creation is not supported. To add existing nodes to a cluster, create a node pool first and call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) operation.
854
659
  *
855
660
  * @example
856
661
  * false
@@ -860,9 +665,7 @@ export declare class CreateClusterRequest extends $dara.Model {
860
665
  formatDisk?: boolean;
861
666
  /**
862
667
  * @remarks
863
- * [**This field is deprecated**] For cluster control plane configuration, use the `image_id` parameter under `control_plane_config` instead. For node pool configuration, use the `image_id` parameter under `scaling_group` in `nodepool` instead.
864
- *
865
- * Custom node image. The system image is used by default. When a custom image is selected, it replaces the default system image. See [Custom images](https://help.aliyun.com/document_detail/146647.html).
668
+ * **[Deprecated]** For cluster control plane configuration, use the `image_id` parameter under `control_plane_config` instead. For node pool configuration, use the `image_id` parameter under `scaling_group` in `nodepool` instead.
866
669
  *
867
670
  * @example
868
671
  * m-bp16z7xko3vvv8gt****
@@ -872,21 +675,7 @@ export declare class CreateClusterRequest extends $dara.Model {
872
675
  imageId?: string;
873
676
  /**
874
677
  * @remarks
875
- * [**This field is deprecated**] For cluster control plane configuration, use the `image_type` parameter under `control_plane_config` instead. For node pool configuration, use the `image_type` parameter under `scaling_group` in `nodepool` instead.
876
- *
877
- * OS distribution type. It is recommended to use this field to specify the node OS. Valid values:
878
- *
879
- * - CentOS
880
- * - AliyunLinux
881
- * - AliyunLinux Qboot
882
- * - AliyunLinuxUEFI
883
- * - AliyunLinux3
884
- * - Windows
885
- * - WindowsCore
886
- * - AliyunLinux3Arm64
887
- * - ContainerOS
888
- *
889
- * Default value: `CentOS`.
678
+ * **[Deprecated]** For cluster control plane configuration, use the `image_type` parameter under `control_plane_config` instead. For node pool configuration, use the `image_type` parameter under `scaling_group` in `nodepool` instead.
890
679
  *
891
680
  * @example
892
681
  * AliyunLinux
@@ -896,36 +685,22 @@ export declare class CreateClusterRequest extends $dara.Model {
896
685
  imageType?: string;
897
686
  /**
898
687
  * @remarks
899
- * [**This field is deprecated**] Selecting existing nodes when creating a cluster is no longer supported. To add existing nodes to a cluster, create a node pool first and call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) API.
900
- *
901
- *
902
- * When creating a cluster with existing nodes, you need to specify a list of ECS instances. These instances will join the cluster as Worker nodes.
903
- *
904
- * > This field is required when creating a cluster with existing instances.
688
+ * **[Deprecated]** Selecting existing nodes during cluster creation is not supported. To add existing nodes to a cluster, create a node pool first and call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) operation.
905
689
  *
906
690
  * @deprecated
907
691
  */
908
692
  instances?: string[];
909
693
  /**
910
694
  * @remarks
911
- * Cluster IP stack.
695
+ * The IP stack of the cluster.
912
696
  *
913
697
  * @example
914
- * 可选值:
915
- * ipv4(单栈)
916
- * dual(双栈),默认值为ipv4。
698
+ * Valid values:
917
699
  */
918
700
  ipStack?: string;
919
701
  /**
920
702
  * @remarks
921
- * Automatically create an enterprise security group. Takes effect when `security_group_id` is empty.
922
- *
923
- * > When using a basic security group, the total number of nodes and Terway Pods in the cluster cannot exceed 2000. Therefore, when creating a Terway network type cluster, it is recommended to use an enterprise security group.
924
- *
925
- * - `true`: Create and use an enterprise security group.
926
- * - `false`: Use a basic security group.
927
- *
928
- * Default value: `true`.
703
+ * Specifies whether to enable automatic creation of an advanced security group. This parameter takes effect only when `security_group_id` is empty.
929
704
  *
930
705
  * @example
931
706
  * true
@@ -933,14 +708,7 @@ export declare class CreateClusterRequest extends $dara.Model {
933
708
  isEnterpriseSecurityGroup?: boolean;
934
709
  /**
935
710
  * @remarks
936
- * [**This field is deprecated**] Selecting existing nodes when creating a cluster is no longer supported. To add existing nodes to a cluster, create a node pool first and call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) API.
937
- *
938
- * Whether to retain instance names when creating a cluster with existing instances.
939
- *
940
- * - `true`: Retain.
941
- * - `false`: Do not retain. Names will be replaced using system rules.
942
- *
943
- * Default value: `true`.
711
+ * **[Deprecated]** Selecting existing nodes during cluster creation is not supported. To add existing nodes to a cluster, create a node pool first and call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) operation.
944
712
  *
945
713
  * @example
946
714
  * true
@@ -950,9 +718,7 @@ export declare class CreateClusterRequest extends $dara.Model {
950
718
  keepInstanceName?: boolean;
951
719
  /**
952
720
  * @remarks
953
- * [**This field is deprecated**] For cluster control plane configuration, use the `key_pair` parameter under `control_plane_config` instead. For node pool configuration, use the `key_pair` parameter under `scaling_group` in `nodepool` instead.
954
- *
955
- * Key pair name. Mutually exclusive with `login_password`.
721
+ * **[Deprecated]** For cluster control plane configuration, use the key_pair parameter under `control_plane_config` instead. For node pool configuration, use the key_pair parameter under `scaling_group` in `nodepool` instead.
956
722
  *
957
723
  * @example
958
724
  * security-key
@@ -962,11 +728,7 @@ export declare class CreateClusterRequest extends $dara.Model {
962
728
  keyPair?: string;
963
729
  /**
964
730
  * @remarks
965
- * Cluster version, consistent with the Kubernetes community baseline version. We recommend selecting the latest version. If not specified, the latest version is used by default.
966
- *
967
- * You can create clusters of the three most recent versions. You can query supported cluster versions through the [DescribeKubernetesVersionMetadata](https://help.aliyun.com/document_detail/2667899.html) API.
968
- *
969
- * For Kubernetes versions supported by ACK, see [Kubernetes version release overview](https://help.aliyun.com/document_detail/185269.html).
731
+ * The cluster version, which is consistent with the Kubernetes community baseline version. Use the latest version. If you do not specify this parameter, the latest version is used by default.
970
732
  *
971
733
  * @example
972
734
  * 1.32.1-aliyun.1
@@ -974,8 +736,7 @@ export declare class CreateClusterRequest extends $dara.Model {
974
736
  kubernetesVersion?: string;
975
737
  /**
976
738
  * @remarks
977
- * Specify the CLB instance ID for API Server access. When this parameter is specified, an API Server CLB will not be automatically created.
978
- * > Ensure that the CLB instance has no other dependencies (such as listeners or backend servers). Shared and public-network CLB instances are not supported.
739
+ * The CLB instance ID used for API Server access. When this parameter is specified, automatic creation of the API Server CLB is skipped.
979
740
  *
980
741
  * @example
981
742
  * lb-wz9t256gqa3vbouk****
@@ -983,17 +744,7 @@ export declare class CreateClusterRequest extends $dara.Model {
983
744
  loadBalancerId?: string;
984
745
  /**
985
746
  * @remarks
986
- * [**This parameter is deprecated**] CLB is billed by usage. This parameter does not take effect.
987
- *
988
- * Load balancer specification. Valid values:
989
- * - slb.s1.small
990
- * - slb.s2.small
991
- * - slb.s2.medium
992
- * - slb.s3.small
993
- * - slb.s3.medium
994
- * - slb.s3.large
995
- *
996
- * Default value: `slb.s2.small`.
747
+ * **[Deprecated]** CLB is billed on a pay-by-usage basis. This parameter does not take effect.
997
748
  *
998
749
  * @example
999
750
  * slb.s2.small
@@ -1003,7 +754,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1003
754
  loadBalancerSpec?: string;
1004
755
  /**
1005
756
  * @remarks
1006
- * [**This field is deprecated**] Enable Log Service for the cluster. Only takes effect for ACK Serverless clusters, and the value must be `SLS`.
757
+ * **[Deprecated]** Enables the log service for the cluster. This parameter takes effect only for ACK Serverless clusters, and the value must be `SLS`.
1007
758
  *
1008
759
  * @example
1009
760
  * SLS
@@ -1013,9 +764,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1013
764
  loggingType?: string;
1014
765
  /**
1015
766
  * @remarks
1016
- * [**This field is deprecated**] For cluster control plane configuration, use the `login_password` parameter under `control_plane_config` instead. For node pool configuration, use the `login_password` parameter under `scaling_group` in `nodepool` instead.
1017
- *
1018
- * SSH login password. Mutually exclusive with `key_pair`. The password must be 8 to 30 characters in length and contain at least three of the following: uppercase letters, lowercase letters, digits, and special characters.
767
+ * **[Deprecated]** For cluster control plane configuration, use the login_password parameter under `control_plane_config` instead. For node pool configuration, use the login_password parameter under `scaling_group` in `nodepool` instead.
1019
768
  *
1020
769
  * @example
1021
770
  * null
@@ -1025,19 +774,12 @@ export declare class CreateClusterRequest extends $dara.Model {
1025
774
  loginPassword?: string;
1026
775
  /**
1027
776
  * @remarks
1028
- * Cluster maintenance window.
777
+ * The cluster maintenance window.
1029
778
  */
1030
779
  maintenanceWindow?: MaintenanceWindow;
1031
780
  /**
1032
781
  * @remarks
1033
- * [**This field is deprecated**] For cluster control plane configuration, use the `auto_renew` parameter under `control_plane_config` instead.
1034
- *
1035
- * Whether to enable auto-renewal for Master nodes. Only takes effect when `master_instance_charge_type` is set to `PrePaid`. Valid values:
1036
- *
1037
- * - `true`: Enable auto-renewal.
1038
- * - `false`: Disable auto-renewal.
1039
- *
1040
- * Default value: `true`.
782
+ * **[Deprecated]** For cluster control plane configuration, use the auto_renew parameter under `control_plane_config` instead.
1041
783
  *
1042
784
  * @example
1043
785
  * true
@@ -1047,13 +789,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1047
789
  masterAutoRenew?: boolean;
1048
790
  /**
1049
791
  * @remarks
1050
- * [**This field is deprecated**] For cluster control plane configuration, use the `auto_renew_period` parameter under `control_plane_config` instead.
1051
- *
1052
- * Master node auto-renewal period. Only takes effect when subscription billing type is selected, and is a required value.
1053
- *
1054
- * Valid values: {1, 2, 3, 6, 12}.
1055
- *
1056
- * Default value: 1.
792
+ * **[Deprecated]** For cluster control plane configuration, use the auto_renew_period parameter under `control_plane_config` instead.
1057
793
  *
1058
794
  * @example
1059
795
  * 1
@@ -1063,11 +799,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1063
799
  masterAutoRenewPeriod?: number;
1064
800
  /**
1065
801
  * @remarks
1066
- * [**This field is deprecated**] For cluster control plane configuration, use the `size` parameter under `control_plane_config` instead.
1067
- *
1068
- * Number of Master nodes. Valid values: `3` or `5`.
1069
- *
1070
- * Default value: `3`.
802
+ * **[Deprecated]** For cluster control plane configuration, use the size parameter under `control_plane_config` instead.
1071
803
  *
1072
804
  * @example
1073
805
  * 3
@@ -1077,14 +809,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1077
809
  masterCount?: number;
1078
810
  /**
1079
811
  * @remarks
1080
- * [**This field is deprecated**] For cluster control plane configuration, use the `instance_charge_type` parameter under `control_plane_config` instead.
1081
- *
1082
- * Master node billing type. Valid values:
1083
- *
1084
- * - `PrePaid`: Subscription.
1085
- * - `PostPaid`: Pay-as-you-go.
1086
- *
1087
- * Default value: `PostPaid`.
812
+ * **[Deprecated]** For cluster control plane configuration, use the instance_charge_type parameter under `control_plane_config` instead.
1088
813
  *
1089
814
  * @example
1090
815
  * PrePaid
@@ -1094,22 +819,14 @@ export declare class CreateClusterRequest extends $dara.Model {
1094
819
  masterInstanceChargeType?: string;
1095
820
  /**
1096
821
  * @remarks
1097
- * [**This field is deprecated**] For cluster control plane configuration, use the `instance_types` parameter under `control_plane_config` instead.
1098
- *
1099
- * Master node instance types. For more information, see [Instance family](https://help.aliyun.com/document_detail/25378.html).
822
+ * **[Deprecated]** For cluster control plane configuration, use the instance_types parameter under `control_plane_config` instead.
1100
823
  *
1101
824
  * @deprecated
1102
825
  */
1103
826
  masterInstanceTypes?: string[];
1104
827
  /**
1105
828
  * @remarks
1106
- * [**This field is deprecated**] For cluster control plane configuration, use the `unit` parameter under `control_plane_config` instead.
1107
- *
1108
- * Master node subscription duration. Valid and required when `master_instance_charge_type` is set to `PrePaid`.
1109
- *
1110
- * Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.
1111
- *
1112
- * Default value: 1.
829
+ * **[Deprecated]** For cluster control plane configuration, use the `unit` parameter under `control_plane_config` instead.
1113
830
  *
1114
831
  * @example
1115
832
  * 1
@@ -1119,11 +836,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1119
836
  masterPeriod?: number;
1120
837
  /**
1121
838
  * @remarks
1122
- * [**This field is deprecated**] For cluster control plane configuration, use the `period_unit` parameter under `control_plane_config` instead.
1123
- *
1124
- * Master node billing period. Must be specified when the billing type is `PrePaid`.
1125
- *
1126
- * Valid value: `Month`. Currently, only month-based periods are supported.
839
+ * **[Deprecated]** For cluster control plane configuration, use the period_unit parameter under `control_plane_config` instead.
1127
840
  *
1128
841
  * @example
1129
842
  * Month
@@ -1133,15 +846,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1133
846
  masterPeriodUnit?: string;
1134
847
  /**
1135
848
  * @remarks
1136
- * [**This field is deprecated**] For cluster control plane configuration, use the `system_disk_category` parameter under `control_plane_config` instead.
1137
- *
1138
- * Master node system disk type. Valid values:
1139
- *
1140
- * - `cloud_efficiency`: Ultra disk.
1141
- * - `cloud_ssd`: SSD disk.
1142
- * - `cloud_essd`: ESSD disk.
1143
- *
1144
- * Default value: `cloud_ssd`. The default value may vary across availability zones.
849
+ * **[Deprecated]** For cluster control plane configuration, use the system_disk_category parameter under `control_plane_config` instead.
1145
850
  *
1146
851
  * @example
1147
852
  * cloud_ssd
@@ -1151,9 +856,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1151
856
  masterSystemDiskCategory?: string;
1152
857
  /**
1153
858
  * @remarks
1154
- * [**This field is deprecated**] For cluster control plane configuration, use the `system_disk_performance_level` parameter under `control_plane_config` instead.
1155
- *
1156
- * Cluster Master node system disk performance level. Only takes effect for ESSD disks. The performance level is related to the disk size. For more information, see [ESSD disk](https://help.aliyun.com/document_detail/122389.html).
859
+ * **[Deprecated]** For cluster control plane configuration, use the system_disk_performance_level parameter under `control_plane_config` instead.
1157
860
  *
1158
861
  * @example
1159
862
  * PL1
@@ -1163,11 +866,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1163
866
  masterSystemDiskPerformanceLevel?: string;
1164
867
  /**
1165
868
  * @remarks
1166
- * [**This field is deprecated**] For cluster control plane configuration, use the `system_disk_size` parameter under `control_plane_config` instead.
1167
- *
1168
- * Master node system disk size. Valid values: [40, 500\\]. Unit: GiB.
1169
- *
1170
- * Default value: `120`.
869
+ * **[Deprecated]** For cluster control plane configuration, use the system_disk_size parameter under `control_plane_config` instead.
1171
870
  *
1172
871
  * @example
1173
872
  * 120
@@ -1177,9 +876,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1177
876
  masterSystemDiskSize?: number;
1178
877
  /**
1179
878
  * @remarks
1180
- * [**This field is deprecated**] For cluster control plane configuration, use the `system_disk_snapshot_policy_id` parameter under `control_plane_config` instead.
1181
- *
1182
- * Automatic snapshot policy ID for the Master node system disk.
879
+ * **[Deprecated]** For cluster control plane configuration, use the system_disk_snapshot_policy_id parameter under `control_plane_config` instead.
1183
880
  *
1184
881
  * @example
1185
882
  * sp-2zej1nogjvovnz4z****
@@ -1189,18 +886,14 @@ export declare class CreateClusterRequest extends $dara.Model {
1189
886
  masterSystemDiskSnapshotPolicyId?: string;
1190
887
  /**
1191
888
  * @remarks
1192
- * [**This field is deprecated**] Use the `vswitch_ids` parameter instead.
1193
- *
1194
- * List of Master node vSwitch IDs. The number of vSwitches ranges from [1, 3\\]. To ensure high availability of the cluster, it is recommended to select 3 vSwitches distributed in different availability zones.
1195
- *
1196
- * The number of specified instance types must be consistent with `master_count` and correspond one-to-one with the elements in `master_vswitch_ids`.
889
+ * **[Deprecated]** Use the `vswitch_ids` parameter instead.
1197
890
  *
1198
891
  * @deprecated
1199
892
  */
1200
893
  masterVswitchIds?: string[];
1201
894
  /**
1202
895
  * @remarks
1203
- * Custom cluster name. Consists of digits, Chinese characters, English characters, or hyphens (-), with a length of 1 to 63 characters, and cannot start with a hyphen (-).
896
+ * The custom cluster name. The name must be 1 to 63 characters in length and can contain digits, Chinese characters, letters, and hyphens (-). It cannot start with a hyphen (-).
1204
897
  *
1205
898
  * This parameter is required.
1206
899
  *
@@ -1210,7 +903,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1210
903
  name?: string;
1211
904
  /**
1212
905
  * @remarks
1213
- * [**This field is deprecated**] Use the `snat_entry` parameter instead.
906
+ * **[Deprecated]** Use the `snat_entry` parameter instead.
1214
907
  *
1215
908
  * @example
1216
909
  * true
@@ -1220,9 +913,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1220
913
  natGateway?: boolean;
1221
914
  /**
1222
915
  * @remarks
1223
- * Number of node IPs, determined by specifying the network CIDR. Only takes effect for Flannel network type clusters.
1224
- *
1225
- * Default value: `26`.
916
+ * The number of node IP addresses, determined by specifying the network CIDR block. This parameter takes effect only for Flannel network type clusters.
1226
917
  *
1227
918
  * @example
1228
919
  * 25
@@ -1230,7 +921,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1230
921
  nodeCidrMask?: string;
1231
922
  /**
1232
923
  * @remarks
1233
- * [**This field is deprecated**] For node pool configuration, use the `node_name_mode` parameter under `kubernetes_config` in `nodepool` instead.
924
+ * **[Deprecated]** For node pool configuration, use the `node_name_mode` parameter under `kubernetes_config` in `nodepool` instead.
1234
925
  *
1235
926
  * @example
1236
927
  * null
@@ -1240,9 +931,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1240
931
  nodeNameMode?: string;
1241
932
  /**
1242
933
  * @remarks
1243
- * Node service ports. Valid port range: [30000, 65535\\].
1244
- *
1245
- * Default value: `30000-32767`.
934
+ * The node service port. Valid port range: [30000,65535\\].
1246
935
  *
1247
936
  * @example
1248
937
  * 30000~32767
@@ -1252,14 +941,12 @@ export declare class CreateClusterRequest extends $dara.Model {
1252
941
  nodePortRange?: string;
1253
942
  /**
1254
943
  * @remarks
1255
- * Node pool list.
944
+ * The list of node pools.
1256
945
  */
1257
946
  nodepools?: Nodepool[];
1258
947
  /**
1259
948
  * @remarks
1260
- * [**This field is deprecated**] For node pool configuration, use the `desired_size` parameter under `scaling_group` in `nodepool` instead.
1261
- *
1262
- * Number of Worker nodes. Range: [0, 100\\].
949
+ * **[Deprecated]** For node pool configuration, use the desired_size parameter under `scaling_group` in `nodepool` instead.
1263
950
  *
1264
951
  * @example
1265
952
  * 3
@@ -1269,18 +956,12 @@ export declare class CreateClusterRequest extends $dara.Model {
1269
956
  numOfNodes?: number;
1270
957
  /**
1271
958
  * @remarks
1272
- * Cluster automatic O&M policy.
959
+ * The cluster automatic O&M policy.
1273
960
  */
1274
961
  operationPolicy?: CreateClusterRequestOperationPolicy;
1275
962
  /**
1276
963
  * @remarks
1277
- * [**This field is deprecated**] For cluster control plane node configuration, use the `image_type` parameter under `control_plane_config` instead. For node pool configuration, use the `image_type` parameter under `scaling_group` in `nodepool` instead.
1278
- *
1279
- * OS platform type. Valid values:
1280
- * - Windows
1281
- * - Linux
1282
- *
1283
- * Default value: `Linux`.
964
+ * **[Deprecated]** For cluster control plane node configuration, use the `image_type` parameter under `control_plane_config` instead. For node pool configuration, use the `image_type` parameter under `scaling_group` in `nodepool` instead.
1284
965
  *
1285
966
  * @example
1286
967
  * Linux
@@ -1290,15 +971,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1290
971
  osType?: string;
1291
972
  /**
1292
973
  * @remarks
1293
- * [**This field is deprecated**]
1294
- *
1295
- * Purchase duration. Subscription duration. Valid and required when charge_type is set to PrePaid.
1296
- *
1297
- * Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.
1298
- *
1299
- * Default value: 1.
1300
- *
1301
- * This field was changed on October 15, 2024. For more information, see [Announcement on CreateCluster API parameter behavior changes](https://help.aliyun.com/document_detail/2849194.html).
974
+ * **[Deprecated]**
1302
975
  *
1303
976
  * @example
1304
977
  * 1
@@ -1308,13 +981,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1308
981
  period?: number;
1309
982
  /**
1310
983
  * @remarks
1311
- * [**This field is deprecated**]
1312
- *
1313
- * Billing period. Must be specified when the billing type is PrePaid.
1314
- *
1315
- * Valid value: Month. Currently, only month-based periods are supported.
1316
- *
1317
- * This field was changed on October 15, 2024. For more information, see [Announcement on CreateCluster API parameter behavior changes](https://help.aliyun.com/document_detail/2849194.html).
984
+ * **[Deprecated]**
1318
985
  *
1319
986
  * @example
1320
987
  * Month
@@ -1324,18 +991,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1324
991
  periodUnit?: string;
1325
992
  /**
1326
993
  * @remarks
1327
- * [**This field is deprecated**] For node pool configuration, use the `platform` parameter under `scaling_group` in `nodepool` instead.
1328
- *
1329
- * OS distribution. Valid values:
1330
- *
1331
- * - CentOS
1332
- * - AliyunLinux
1333
- * - QbootAliyunLinux
1334
- * - Qboot
1335
- * - Windows
1336
- * - WindowsCore
1337
- *
1338
- * Default value: `CentOS`.
994
+ * **[Deprecated]** For node pool configuration, use the `platform` parameter under `scaling_group` in `nodepool` instead.
1339
995
  *
1340
996
  * @example
1341
997
  * CentOS
@@ -1345,19 +1001,14 @@ export declare class CreateClusterRequest extends $dara.Model {
1345
1001
  platform?: string;
1346
1002
  /**
1347
1003
  * @remarks
1348
- * [**This field is deprecated**] When using the Terway network plugin, you need to specify vSwitches for Pod IP allocation. Each Pod vSwitch corresponds to a Worker node vSwitch, and the availability zones of Pod vSwitches and Worker node vSwitches must be consistent.
1349
- * > The CIDR mask of Pod vSwitches should not exceed 19 and must not exceed 25; otherwise, the available Pod IP addresses in the cluster network will be very limited, affecting normal cluster usage.
1004
+ * **[Deprecated]** When you select Terway as the network plugin, you must specify vSwitches for pod IP address allocation. Each pod vSwitch corresponds to a worker node vSwitch, and the pod vSwitch and the worker node vSwitch must be in the same zone.
1350
1005
  *
1351
1006
  * @deprecated
1352
1007
  */
1353
1008
  podVswitchIds?: string[];
1354
1009
  /**
1355
1010
  * @remarks
1356
- * When `cluster_type` is set to `ManagedKubernetes`, you can further specify the cluster subtype.
1357
- * - `Default`: ACK managed cluster, including ACK cluster (Pro and Basic editions).
1358
- * - `Edge`: ACK Edge cluster, including ACK Edge cluster (Pro and Basic editions).
1359
- * - `Serverless`: ACK Serverless cluster, including ACK Serverless cluster (Pro and Basic editions).
1360
- * - `Lingjun`: ACK Lingjun cluster, available in Pro edition.
1011
+ * If you set `cluster_type` to `ManagedKubernetes`, which indicates an ACK managed cluster, you can further specify the cluster subtype.
1361
1012
  *
1362
1013
  * @example
1363
1014
  * Default
@@ -1365,14 +1016,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1365
1016
  profile?: string;
1366
1017
  /**
1367
1018
  * @remarks
1368
- * kube-proxy mode
1369
- *
1370
- * - `iptables`: A mature and stable kube-proxy mode. Kubernetes Service discovery and load balancing are configured using iptables rules. Performance is average and significantly affected by scale, suitable for clusters with a small number of Services.
1371
- * - `ipvs`: A high-performance kube-proxy mode. Kubernetes Service discovery and load balancing are configured using the Linux IPVS module, suitable for clusters with a large number of Services that require high-performance load balancing.
1372
- * - `nftables`: Next-generation kube-proxy mode based on Linux nftables for Service discovery and load balancing. It is a modern replacement for iptables. Compared to iptables, nftables performs better in network performance, rule update efficiency, and large-scale Service scenarios.
1373
- * Only supported for clusters of version 1.35 and above. The Kubernetes community deprecated IPVS starting from version 1.35. It is recommended to use nftables for new clusters for longer-term community support.
1374
- *
1375
- * Default value: `ipvs`.
1019
+ * The kube-proxy proxy mode.
1376
1020
  *
1377
1021
  * @example
1378
1022
  * ipvs
@@ -1380,16 +1024,14 @@ export declare class CreateClusterRequest extends $dara.Model {
1380
1024
  proxyMode?: string;
1381
1025
  /**
1382
1026
  * @remarks
1383
- * [**This field is deprecated**] For node pool configuration, use the `rds_instances` parameter under `scaling_group` in `nodepool` instead.
1384
- *
1385
- * List of RDS instances. Select the RDS instances you want to add to the whitelist. It is recommended to add the container Pod CIDR block and Node CIDR block in RDS. Setting RDS instances may fail to pop up due to non-running instance status.
1027
+ * **[Deprecated]** For node pool configuration, use the `rds_instances` parameter under `scaling_group` in `nodepool` instead.
1386
1028
  *
1387
1029
  * @deprecated
1388
1030
  */
1389
1031
  rdsInstances?: string[];
1390
1032
  /**
1391
1033
  * @remarks
1392
- * The region ID where the cluster is located. For details, see [Regions supported by Container Service](https://help.aliyun.com/document_detail/216938.html).
1034
+ * The region ID of the cluster. For details, see [Regions supported by container service](https://help.aliyun.com/document_detail/216938.html).
1393
1035
  *
1394
1036
  * This parameter is required.
1395
1037
  *
@@ -1399,7 +1041,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1399
1041
  regionId?: string;
1400
1042
  /**
1401
1043
  * @remarks
1402
- * The resource group ID to which the cluster belongs, used for isolating different resources.
1044
+ * The resource group ID of the cluster, which is used to isolate different resources.
1403
1045
  *
1404
1046
  * @example
1405
1047
  * rg-acfm3mkrure****
@@ -1407,22 +1049,19 @@ export declare class CreateClusterRequest extends $dara.Model {
1407
1049
  resourceGroupId?: string;
1408
1050
  /**
1409
1051
  * @remarks
1410
- * RRSA feature configuration.
1052
+ * The RRSA feature configuration.
1411
1053
  */
1412
1054
  rrsaConfig?: CreateClusterRequestRrsaConfig;
1413
1055
  /**
1414
1056
  * @remarks
1415
- * Container runtime in the cluster. Supports containerd, sandboxed containers, and Docker.
1416
- * > Kubernetes 1.24 no longer supports Docker as a built-in container runtime.
1417
- *
1418
- * For more information, see [Comparison of Docker, containerd, and sandboxed container runtimes](https://help.aliyun.com/document_detail/160313.html).
1057
+ * The container runtime in the cluster. Supported runtimes include containerd, sandboxed containers, and Docker.
1419
1058
  *
1420
1059
  * @deprecated
1421
1060
  */
1422
1061
  runtime?: Runtime;
1423
1062
  /**
1424
1063
  * @remarks
1425
- * Specify the security group ID when creating a cluster with an existing security group. Mutually exclusive with `is_enterprise_security_group`. Cluster nodes are automatically added to this security group.
1064
+ * The security group ID. Specify this parameter when you use an existing security group to create a cluster. This parameter and `is_enterprise_security_group` are mutually exclusive. Cluster nodes are automatically added to this security group.
1426
1065
  *
1427
1066
  * @example
1428
1067
  * sg-bp1bdue0qc1g7k****
@@ -1430,14 +1069,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1430
1069
  securityGroupId?: string;
1431
1070
  /**
1432
1071
  * @remarks
1433
- * [**This field is deprecated**] For cluster control plane configuration, use the `security_hardening_os` parameter under `control_plane_config` instead. For node pool configuration, use the `security_hardening_os` parameter under `scaling_group` in `nodepool` instead.
1434
- *
1435
- * Alibaba Cloud OS security hardening. Valid values:
1436
- *
1437
- * - `true`: Enable Alibaba Cloud OS security hardening.
1438
- * - `false`: Disable Alibaba Cloud OS security hardening.
1439
- *
1440
- * Default value: `false`.
1072
+ * **[Deprecated]** For cluster control plane configuration, use the `security_hardening_os` parameter under `control_plane_config` instead. For node pool configuration, use the `security_hardening_os` parameter under `scaling_group` in `nodepool` instead.
1441
1073
  *
1442
1074
  * @example
1443
1075
  * false
@@ -1447,9 +1079,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1447
1079
  securityHardeningOs?: boolean;
1448
1080
  /**
1449
1081
  * @remarks
1450
- * ServiceAccount is the access credential for communication between Pods and the cluster API Server. `service-account-issuer` is the issuer identity in the `serviceaccount token`, i.e., the `iss` field in the `token payload`.
1451
- *
1452
- * For more details about `ServiceAccount`, see [Deploy service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
1082
+ * A ServiceAccount is the access credential for communication between a pod and the cluster API server. The `service-account-issuer` is the issuer identity in the `serviceaccount token`, which is the `iss` field in the `token payload`.
1453
1083
  *
1454
1084
  * @example
1455
1085
  * kubernetes.default.svc
@@ -1457,9 +1087,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1457
1087
  serviceAccountIssuer?: string;
1458
1088
  /**
1459
1089
  * @remarks
1460
- * Service network CIDR block. Valid ranges: 10.0.0.0/16-24, 172.16-31.0.0/16-24, 192.168.0.0/16-24. Cannot overlap with VPC CIDR block 10.1.0.0/21 or CIDR blocks used by existing Kubernetes clusters in the VPC. Cannot be modified after creation.
1461
- *
1462
- * Default value: 172.19.0.0/20.
1090
+ * The Service network CIDR block. Valid ranges: 10.0.0.0/16-24, 172.16-31.0.0/16-24, and 192.168.0.0/16-24.
1463
1091
  *
1464
1092
  * @example
1465
1093
  * 172.21.0.0/20
@@ -1467,26 +1095,14 @@ export declare class CreateClusterRequest extends $dara.Model {
1467
1095
  serviceCidr?: string;
1468
1096
  /**
1469
1097
  * @remarks
1470
- * [**This field is deprecated**] Service discovery type within the cluster, used to specify the service discovery method in `ACK Serverless` clusters.
1471
- *
1472
- * - `CoreDNS`: Uses the Kubernetes native standard service discovery component CoreDNS. A set of containers needs to be deployed in the cluster for DNS resolution. By default, two ECI instances with 0.25 Core 512 MiB specifications are used.
1473
- * - `PrivateZone`: Uses the Alibaba Cloud PrivateZone product for service discovery capabilities. The PrivateZone service needs to be enabled.
1474
- *
1475
- * Default value: Not enabled.
1098
+ * **[Deprecated]** The service discovery types within the cluster, used to specify the service discovery method in `ACK Serverless` clusters.
1476
1099
  *
1477
1100
  * @deprecated
1478
1101
  */
1479
1102
  serviceDiscoveryTypes?: string[];
1480
1103
  /**
1481
1104
  * @remarks
1482
- * Configure SNAT for the VPC. Valid values:
1483
- *
1484
- * - `true`: Automatically create a NAT gateway and configure SNAT rules. Set to `true` if nodes and applications in the cluster need to access the Internet.
1485
- * - `false`: Do not create a NAT gateway or SNAT rules. Nodes and applications in the cluster will not be able to access the Internet.
1486
- *
1487
- * > If not enabled during cluster creation and the business later requires Internet access, you can [manually enable it](https://help.aliyun.com/document_detail/178480.html).
1488
- *
1489
- * Default value: `false`.
1105
+ * Specifies whether to configure SNAT for the VPC. Valid values:
1490
1106
  *
1491
1107
  * @example
1492
1108
  * false
@@ -1494,15 +1110,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1494
1110
  snatEntry?: boolean;
1495
1111
  /**
1496
1112
  * @remarks
1497
- * [**This field is deprecated**] For cluster control plane node configuration, use the `soc_enabled` parameter under `control_plane_config` instead. For node pool configuration, use the `soc_enabled` parameter under `scaling_group` in `nodepool` instead.
1498
- *
1499
- * Classified protection hardening. For more information, see [ACK classified protection hardening user guide](https://help.aliyun.com/document_detail/196148.html).
1500
- *
1501
- * Valid values:
1502
- * - `true`: Enable classified protection hardening.
1503
- * - `false`: Disable classified protection hardening.
1504
- *
1505
- * Default value: `false`.
1113
+ * **[Deprecated]** For cluster control plane node configuration, use the `soc_enabled` parameter under `control_plane_config` instead. For node pool configuration, use the `soc_enabled` parameter under `scaling_group` in `nodepool` instead.
1506
1114
  *
1507
1115
  * @example
1508
1116
  * false
@@ -1512,11 +1120,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1512
1120
  socEnabled?: boolean;
1513
1121
  /**
1514
1122
  * @remarks
1515
- * Whether to enable public SSH login. Used for logging in to Master nodes of ACK dedicated clusters. This parameter does not take effect in managed clusters.
1516
- * - `true`: Enable.
1517
- * - `false`: Disable.
1518
- *
1519
- * Default value: `false`.
1123
+ * Specifies whether to enable public SSH logon. This is used to log on to the master nodes of ACK dedicated clusters. This parameter does not take effect for managed clusters.
1520
1124
  *
1521
1125
  * @example
1522
1126
  * true
@@ -1524,28 +1128,19 @@ export declare class CreateClusterRequest extends $dara.Model {
1524
1128
  sshFlags?: boolean;
1525
1129
  /**
1526
1130
  * @remarks
1527
- * Node tags. Tag definition rules:
1528
- *
1529
- * - Tags consist of case-sensitive key-value pairs. You can set up to 20 tags.
1530
- * - Tag keys cannot be duplicated, with a maximum length of 64 characters; tag values can be empty, with a maximum length of 128 characters. Neither tag keys nor tag values can start with “aliyun”, “acs:”, “https://”, or “http://”. For details, see [Labels and Selectors](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#syntax-and-character-set).
1131
+ * The node tags. Tag definition rules:
1531
1132
  */
1532
1133
  tags?: Tag[];
1533
1134
  /**
1534
1135
  * @remarks
1535
- * [**This field is deprecated**] For node pool configuration, use the `taints` parameter under `kubernetes_config` in `nodepool` instead.
1536
- *
1537
- * Node taint information. Taints and tolerations work together to prevent Pods from being scheduled on inappropriate nodes. For more information, see [taint-and-toleration](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/).
1136
+ * **[Deprecated]** For node pool configuration, use the `taints` parameter under `kubernetes_config` in `nodepool` instead.
1538
1137
  *
1539
1138
  * @deprecated
1540
1139
  */
1541
1140
  taints?: Taint[];
1542
1141
  /**
1543
1142
  * @remarks
1544
- * [**This field is deprecated**] By default, no rollback is performed when cluster creation fails. You need to clean up the failed cluster yourself.
1545
- *
1546
- * Cluster creation timeout. Unit: minutes.
1547
- *
1548
- * Default value: `60`.
1143
+ * **[Deprecated]** When cluster creation fails, rollback is not performed by default. You must manually clean up the failed cluster.
1549
1144
  *
1550
1145
  * @example
1551
1146
  * 60
@@ -1555,7 +1150,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1555
1150
  timeoutMins?: number;
1556
1151
  /**
1557
1152
  * @remarks
1558
- * The timezone used by the cluster. See [Supported timezones](https://help.aliyun.com/document_detail/354879.html).
1153
+ * The time zone used by the cluster. For more information, see [Supported time zones](https://help.aliyun.com/document_detail/354879.html).
1559
1154
  *
1560
1155
  * @example
1561
1156
  * Asia/Shanghai
@@ -1563,7 +1158,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1563
1158
  timezone?: string;
1564
1159
  /**
1565
1160
  * @remarks
1566
- * Custom cluster CA.
1161
+ * The custom cluster CA.
1567
1162
  *
1568
1163
  * @example
1569
1164
  * -----BEGIN CERTIFICATE-----****
@@ -1571,7 +1166,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1571
1166
  userCa?: string;
1572
1167
  /**
1573
1168
  * @remarks
1574
- * [**This field is deprecated**] Custom node data.
1169
+ * **[Deprecated]** The custom node data.
1575
1170
  *
1576
1171
  * @example
1577
1172
  * IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD****
@@ -1581,7 +1176,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1581
1176
  userData?: string;
1582
1177
  /**
1583
1178
  * @remarks
1584
- * The VPC used by the cluster. Must be provided when creating a cluster.
1179
+ * The VPC used by the cluster. You must provide a VPC when you create a cluster.
1585
1180
  *
1586
1181
  * @example
1587
1182
  * vpc-2zeik9h3ahvv2zz95****
@@ -1589,19 +1184,12 @@ export declare class CreateClusterRequest extends $dara.Model {
1589
1184
  vpcid?: string;
1590
1185
  /**
1591
1186
  * @remarks
1592
- * vSwitches for cluster nodes. This field is required when creating a zero-node managed cluster.
1187
+ * The vSwitches for cluster nodes. This field is required when you create a zero-node managed cluster.
1593
1188
  */
1594
1189
  vswitchIds?: string[];
1595
1190
  /**
1596
1191
  * @remarks
1597
- * [**This field is deprecated**] For node pool configuration, use the `auto_renew` parameter under `scaling_group` in `nodepool` instead.
1598
- *
1599
- * Whether to enable auto-renewal for Worker nodes. Only takes effect when `worker_instance_charge_type` is set to `PrePaid`. Valid values:
1600
- *
1601
- * - `true`: Enable auto-renewal.
1602
- * - `false`: Disable auto-renewal.
1603
- *
1604
- * Default value: `true`.
1192
+ * **[Deprecated]** For node pool configuration, use the auto_renew parameter under `scaling_group` in `nodepool` instead.
1605
1193
  *
1606
1194
  * @example
1607
1195
  * true
@@ -1611,12 +1199,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1611
1199
  workerAutoRenew?: boolean;
1612
1200
  /**
1613
1201
  * @remarks
1614
- * [**This field is deprecated**] For node pool configuration, use the `auto_renew_period` parameter under `scaling_group` in `nodepool` instead.
1615
- *
1616
- *
1617
- * Worker node auto-renewal period. Only takes effect when subscription billing type is selected, and is a required value.
1618
- *
1619
- * Valid values: {1, 2, 3, 6, 12}.
1202
+ * **[Deprecated]** For node pool configuration, use the auto_renew_period parameter under `scaling_group` in `nodepool` instead.
1620
1203
  *
1621
1204
  * @example
1622
1205
  * 1
@@ -1626,23 +1209,14 @@ export declare class CreateClusterRequest extends $dara.Model {
1626
1209
  workerAutoRenewPeriod?: number;
1627
1210
  /**
1628
1211
  * @remarks
1629
- * [**This field is deprecated**] For node pool configuration, use the `data_disks` parameter under `scaling_group` in `nodepool` instead.
1630
- *
1631
- * Combination of Worker node data disk type, size, and other configurations.
1212
+ * **[Deprecated]** For node pool configuration, use the data_disks parameter under `scaling_group` in `nodepool` instead.
1632
1213
  *
1633
1214
  * @deprecated
1634
1215
  */
1635
1216
  workerDataDisks?: CreateClusterRequestWorkerDataDisks[];
1636
1217
  /**
1637
1218
  * @remarks
1638
- * [**This field is deprecated**] For node pool configuration, use the `instance_charge_type` parameter under `scaling_group` in `nodepool` instead.
1639
- *
1640
- * Worker node billing type. Valid values:
1641
- *
1642
- * - `PrePaid`: Subscription.
1643
- * - `PostPaid`: Pay-as-you-go.
1644
- *
1645
- * Default value: Pay-as-you-go.
1219
+ * **[Deprecated]** For node pool configuration, use the instance_charge_type parameter under `scaling_group` in `nodepool` instead.
1646
1220
  *
1647
1221
  * @example
1648
1222
  * PrePaid
@@ -1652,22 +1226,14 @@ export declare class CreateClusterRequest extends $dara.Model {
1652
1226
  workerInstanceChargeType?: string;
1653
1227
  /**
1654
1228
  * @remarks
1655
- * [**This field is deprecated**] For node pool configuration, use the `instance_types` parameter under `scaling_group` in `nodepool` instead.
1656
- *
1657
- * Worker node instance configuration.
1229
+ * **[Deprecated]** For node pool configuration, use the instance_types parameter under `scaling_group` in `nodepool` instead.
1658
1230
  *
1659
1231
  * @deprecated
1660
1232
  */
1661
1233
  workerInstanceTypes?: string[];
1662
1234
  /**
1663
1235
  * @remarks
1664
- * [**This field is deprecated**] For node pool configuration, use the `period` parameter under `scaling_group` in `nodepool` instead.
1665
- *
1666
- * Worker node subscription duration. Valid and required when `worker_instance_charge_type` is set to `PrePaid`.
1667
- *
1668
- * Valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.
1669
- *
1670
- * Default value: 1.
1236
+ * **[Deprecated]** For node pool configuration, use the period parameter under `scaling_group` in `nodepool` instead.
1671
1237
  *
1672
1238
  * @example
1673
1239
  * 1
@@ -1677,11 +1243,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1677
1243
  workerPeriod?: number;
1678
1244
  /**
1679
1245
  * @remarks
1680
- * [**This field is deprecated**] For node pool configuration, use the `period_unit` parameter under `scaling_group` in `nodepool` instead.
1681
- *
1682
- * Worker node billing period. Must be specified when the billing type is `PrePaid`.
1683
- *
1684
- * Valid value: `Month`. Currently, only month-based periods are supported.
1246
+ * **[Deprecated]** For node pool configuration, use the period_unit parameter under `scaling_group` in `nodepool` instead.
1685
1247
  *
1686
1248
  * @example
1687
1249
  * Month
@@ -1691,17 +1253,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1691
1253
  workerPeriodUnit?: string;
1692
1254
  /**
1693
1255
  * @remarks
1694
- * [**This field is deprecated**] For node pool configuration, use the `system_disk_category` parameter under `scaling_group` in `nodepool` instead.
1695
- *
1696
- * Worker node system disk type. For more information, see [Block storage overview](https://help.aliyun.com/document_detail/63136.html).
1697
- *
1698
- * Valid values:
1699
- *
1700
- * - `cloud_efficiency`: Ultra disk.
1701
- * - `cloud_ssd`: SSD disk.
1702
- *
1703
- *
1704
- * Default value: `cloud_ssd`.
1256
+ * **[Deprecated]** For node pool configuration, use the system_disk_category parameter under `scaling_group` in `nodepool` instead.
1705
1257
  *
1706
1258
  * @example
1707
1259
  * cloud_efficiency
@@ -1711,16 +1263,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1711
1263
  workerSystemDiskCategory?: string;
1712
1264
  /**
1713
1265
  * @remarks
1714
- * [**This field is deprecated**] For node pool configuration, use the `system_disk_performance_level` parameter under `scaling_group` in `nodepool` instead.
1715
- *
1716
- * When the system disk is an ESSD disk, you can set the Performance Level (PL) of the ESSD disk. For more information, see [ESSD disk](https://help.aliyun.com/document_detail/122389.html).
1717
- *
1718
- * Valid values:
1719
- *
1720
- * - PL0
1721
- * - PL1
1722
- * - PL2
1723
- * - PL3
1266
+ * **[Deprecated]** For node pool configuration, use the system_disk_performance_level parameter under `scaling_group` in `nodepool` instead.
1724
1267
  *
1725
1268
  * @example
1726
1269
  * PL1
@@ -1730,15 +1273,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1730
1273
  workerSystemDiskPerformanceLevel?: string;
1731
1274
  /**
1732
1275
  * @remarks
1733
- * [**This field is deprecated**] For node pool configuration, use the `system_disk_size` parameter under `scaling_group` in `nodepool` instead.
1734
- *
1735
- * Worker node system disk size. Unit: GiB.
1736
- *
1737
- * Valid values: [40, 500\\].
1738
- *
1739
- * The value must be greater than or equal to max{40, ImageSize}.
1740
- *
1741
- * Default value: `120`.
1276
+ * **[Deprecated]** For node pool configuration, use the system_disk_size parameter under `scaling_group` in `nodepool` instead.
1742
1277
  *
1743
1278
  * @example
1744
1279
  * 120
@@ -1748,9 +1283,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1748
1283
  workerSystemDiskSize?: number;
1749
1284
  /**
1750
1285
  * @remarks
1751
- * [**This field is deprecated**] For node pool configuration, use the `system_disk_snapshot_policy_id` parameter under `scaling_group` in `nodepool` instead.
1752
- *
1753
- * Automatic snapshot policy ID for the Worker node system disk.
1286
+ * **[Deprecated]** For node pool configuration, use the system_disk_snapshot_policy_id parameter under `scaling_group` in `nodepool` instead.
1754
1287
  *
1755
1288
  * @example
1756
1289
  * sp-2zej1nogjvovnz4z****
@@ -1760,22 +1293,14 @@ export declare class CreateClusterRequest extends $dara.Model {
1760
1293
  workerSystemDiskSnapshotPolicyId?: string;
1761
1294
  /**
1762
1295
  * @remarks
1763
- * [**This field is deprecated**] For node pool configuration, use the `vswitch_ids` parameter under `scaling_group` in `nodepool` instead.
1764
- *
1765
- * List of vSwitches used by cluster nodes. One node corresponds to one value.
1766
- *
1767
- * When creating a zero-node managed cluster, the `worker_vswitch_ids` field is not required, but `vswitch_ids` must be provided.
1296
+ * **[Deprecated]** For node pool configuration, use the vswitch_ids parameter under `scaling_group` in `nodepool` instead.
1768
1297
  *
1769
1298
  * @deprecated
1770
1299
  */
1771
1300
  workerVswitchIds?: string[];
1772
1301
  /**
1773
1302
  * @remarks
1774
- * [**This field is deprecated**] Use the `zone_ids` parameter instead.
1775
- *
1776
- * Availability zone ID of the region where the cluster is located. This parameter is specific to ACK managed cluster types.
1777
- *
1778
- * When creating an ACK managed cluster, if `vpc_id` and `vswitch_ids` are not specified, `zone_id` must be specified for the cluster to automatically create VPC network resources in this availability zone. This parameter is ignored when `vpc_id` and `vswitch_ids` are specified.
1303
+ * **[Deprecated]** Use the `zone_ids` parameter instead.
1779
1304
  *
1780
1305
  * @example
1781
1306
  * cn-beiji****
@@ -1785,7 +1310,7 @@ export declare class CreateClusterRequest extends $dara.Model {
1785
1310
  zoneId?: string;
1786
1311
  /**
1787
1312
  * @remarks
1788
- * Multiple availability zone IDs of the region where the cluster is located. This parameter is specific to ACK managed cluster types.
1313
+ * The zone IDs of the cluster region. This parameter is specific to ACK managed clusters.
1789
1314
  */
1790
1315
  zoneIds?: string[];
1791
1316
  static names(): {