@alicloud/cs20151215 7.0.3 → 7.0.4

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 (45) hide show
  1. package/dist/client.d.ts +30 -30
  2. package/dist/client.js +33 -30
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/CreateClusterNodePoolRequest.d.ts +139 -83
  5. package/dist/models/CreateClusterNodePoolRequest.js +29 -1
  6. package/dist/models/CreateClusterNodePoolRequest.js.map +1 -1
  7. package/dist/models/CreateClusterRequest.d.ts +372 -345
  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/DescribeClusterDetailResponseBody.d.ts +147 -106
  12. package/dist/models/DescribeClusterDetailResponseBody.js +29 -1
  13. package/dist/models/DescribeClusterDetailResponseBody.js.map +1 -1
  14. package/dist/models/DescribeClusterNodePoolDetailResponseBody.d.ts +163 -131
  15. package/dist/models/DescribeClusterNodePoolDetailResponseBody.js +29 -1
  16. package/dist/models/DescribeClusterNodePoolDetailResponseBody.js.map +1 -1
  17. package/dist/models/DescribeClusterNodePoolsResponseBody.d.ts +120 -92
  18. package/dist/models/DescribeClusterNodePoolsResponseBody.js +29 -1
  19. package/dist/models/DescribeClusterNodePoolsResponseBody.js.map +1 -1
  20. package/dist/models/ModifyClusterNodePoolRequest.d.ts +64 -49
  21. package/dist/models/ModifyClusterNodePoolRequest.js +4 -0
  22. package/dist/models/ModifyClusterNodePoolRequest.js.map +1 -1
  23. package/dist/models/ModifyClusterRequest.d.ts +151 -112
  24. package/dist/models/ModifyClusterRequest.js +29 -1
  25. package/dist/models/ModifyClusterRequest.js.map +1 -1
  26. package/dist/models/ModifyClusterResponseBody.d.ts +3 -3
  27. package/dist/models/Nodepool.d.ts +132 -88
  28. package/dist/models/Nodepool.js +29 -1
  29. package/dist/models/Nodepool.js.map +1 -1
  30. package/dist/models/model.d.ts +7 -0
  31. package/dist/models/model.js +80 -66
  32. package/dist/models/model.js.map +1 -1
  33. package/package.json +2 -2
  34. package/src/client.ts +34 -30
  35. package/src/models/CreateClusterNodePoolRequest.ts +158 -83
  36. package/src/models/CreateClusterRequest.ts +389 -345
  37. package/src/models/CreateClusterResponseBody.ts +3 -3
  38. package/src/models/DescribeClusterDetailResponseBody.ts +166 -106
  39. package/src/models/DescribeClusterNodePoolDetailResponseBody.ts +182 -131
  40. package/src/models/DescribeClusterNodePoolsResponseBody.ts +139 -92
  41. package/src/models/ModifyClusterNodePoolRequest.ts +68 -49
  42. package/src/models/ModifyClusterRequest.ts +170 -112
  43. package/src/models/ModifyClusterResponseBody.ts +3 -3
  44. package/src/models/Nodepool.ts +151 -88
  45. package/src/models/model.ts +7 -0
@@ -6,9 +6,9 @@ import { MaintenanceWindow } from "./MaintenanceWindow";
6
6
  export class ModifyClusterRequestApiServerCustomCertSans extends $dara.Model {
7
7
  /**
8
8
  * @remarks
9
- * Overwrite or append SAN configuration. Valid values:
10
- * - overwrite: Overwrite.
11
- * - append: Append.
9
+ * Specifies whether to overwrite or append the SAN configuration. Valid values:
10
+ * - overwrite: overwrites the existing configuration.
11
+ * - append: appends to the existing configuration.
12
12
  *
13
13
  * @example
14
14
  * append
@@ -16,7 +16,7 @@ export class ModifyClusterRequestApiServerCustomCertSans extends $dara.Model {
16
16
  action?: string;
17
17
  /**
18
18
  * @remarks
19
- * SAN list.
19
+ * The SAN list.
20
20
  */
21
21
  subjectAlternativeNames?: string[];
22
22
  static names(): { [key: string]: string } {
@@ -48,10 +48,10 @@ export class ModifyClusterRequestApiServerCustomCertSans extends $dara.Model {
48
48
  export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
49
49
  /**
50
50
  * @remarks
51
- * Whether to enable automatic renewal for control plane node instances. This parameter takes effect only when `charge_type` is set to `PrePaid`. Valid values:
51
+ * Specifies whether to enable auto-renewal for control plane node instances. This parameter takes effect only when `charge_type` is set to `PrePaid`. Valid values:
52
52
  *
53
- * - `true`: Enable automatic renewal.
54
- * - `false`: Disable automatic renewal.
53
+ * - `true`: Enables auto-renewal.
54
+ * - `false`: Disables auto-renewal.
55
55
  *
56
56
  * Default value: `false`.
57
57
  *
@@ -61,7 +61,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
61
61
  autoRenew?: boolean;
62
62
  /**
63
63
  * @remarks
64
- * Duration for each automatic renewal of control plane node instances.
64
+ * The auto-renewal duration for each renewal cycle of control plane node instances.
65
65
  *
66
66
  * Valid values: {1, 2, 3, 6, 12}. Unit: months.
67
67
  *
@@ -73,10 +73,10 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
73
73
  autoRenewPeriod?: number;
74
74
  /**
75
75
  * @remarks
76
- * Control plane node instance billing method. Valid values:
76
+ * The billing method for control plane node instances. Valid values:
77
77
  *
78
- * - `PrePaid`: Subscription.
79
- * - `PostPaid`: Pay-as-you-go.
78
+ * - `PrePaid`: subscription.
79
+ * - `PostPaid`: pay-as-you-go.
80
80
  *
81
81
  * Default value: `PostPaid`.
82
82
  *
@@ -86,10 +86,10 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
86
86
  chargeType?: string;
87
87
  /**
88
88
  * @remarks
89
- * Whether to install the Cloud Monitor agent on control plane nodes. Valid values:
89
+ * Specifies whether to install the CloudMonitor agent on control plane nodes. Valid values:
90
90
  *
91
- * - `true`: Install the Cloud Monitor agent.
92
- * - `false`: Do not install the Cloud Monitor agent.
91
+ * - `true`: Installs the CloudMonitor agent.
92
+ * - `false`: Does not install the CloudMonitor agent.
93
93
  *
94
94
  * @example
95
95
  * true
@@ -97,9 +97,9 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
97
97
  cloudMonitorFlags?: boolean;
98
98
  /**
99
99
  * @remarks
100
- * Node CPU management policy. When the cluster version is 1.12.6 or later, the following two policies are supported:
100
+ * The node CPU management policy. The following policies are supported for clusters running version 1.12.6 or later:
101
101
  *
102
- * - `static`: Allows enhanced CPU affinity and exclusivity for Pods with certain resource characteristics on the node.
102
+ * - `static`: Allows pods with certain resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.
103
103
  * - `none`: Uses the existing default CPU affinity scheme.
104
104
  *
105
105
  * Default value: `none`.
@@ -110,7 +110,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
110
110
  cpuPolicy?: string;
111
111
  /**
112
112
  * @remarks
113
- * Deployment set ID.
113
+ * The deployment set ID.
114
114
  *
115
115
  * @example
116
116
  * ds-bp10b35imuam5amw****
@@ -118,7 +118,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
118
118
  deploymentsetId?: string;
119
119
  /**
120
120
  * @remarks
121
- * Custom image ID. Specified when using a custom image.
121
+ * The custom image ID. Specify this parameter when using a custom image.
122
122
  *
123
123
  * @example
124
124
  * aliyun_3_x64_20G_alibase_20240819.vhd
@@ -126,10 +126,10 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
126
126
  imageId?: string;
127
127
  /**
128
128
  * @remarks
129
- * Operating system image type. Valid values:
129
+ * The operating system image type. Valid values:
130
130
  *
131
131
  * - `AliyunLinux3`: Alinux3 image.
132
- * - `Custom`: Custom image.
132
+ * - `Custom`: custom image.
133
133
  *
134
134
  * @example
135
135
  * AliyunLinux3
@@ -137,12 +137,12 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
137
137
  imageType?: string;
138
138
  /**
139
139
  * @remarks
140
- * Instance types. For more information, see [Instance Family](https://help.aliyun.com/document_detail/25378.html).
140
+ * The instance types. For more information, see [Instance families](https://help.aliyun.com/document_detail/25378.html).
141
141
  */
142
142
  instanceTypes?: string[];
143
143
  /**
144
144
  * @remarks
145
- * Key pair name. Mutually exclusive with `login_password`.
145
+ * The key pair name. Mutually exclusive with `login_password`.
146
146
  *
147
147
  * @example
148
148
  * ack
@@ -150,7 +150,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
150
150
  keyPair?: string;
151
151
  /**
152
152
  * @remarks
153
- * SSH login password. Mutually exclusive with `key_pair`. The password must be 8 to 30 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. If you want to use password login, specify this parameter during scale-out.
153
+ * The SSH logon password. Mutually exclusive with `key_pair`. 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. To use password-based logon, specify this parameter during scale-out.
154
154
  *
155
155
  * @example
156
156
  * Ack@2000.
@@ -158,8 +158,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
158
158
  loginPassword?: string;
159
159
  /**
160
160
  * @remarks
161
- * Node service port range.
162
- * Available port range: [30000, 65535].
161
+ * The node service port range. Available port range: [30000, 65535].
163
162
  *
164
163
  * Default value: 30000-32767.
165
164
  *
@@ -169,9 +168,9 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
169
168
  nodePortRange?: string;
170
169
  /**
171
170
  * @remarks
172
- * Control plane node instance subscription duration. This parameter takes effect and is required only when `charge_type` is set to `PrePaid`.
171
+ * The subscription duration for control plane node instances. This parameter takes effect and is required only when `charge_type` is set to `PrePaid`.
173
172
  *
174
- * When `period_unit=Month`, valid values: {1, 2, 3, 6, 12, 24, 36, 48, 60}.
173
+ * When `period_unit=Month`, valid values are {1, 2, 3, 6, 12, 24, 36, 48, 60}.
175
174
  *
176
175
  * @example
177
176
  * 1
@@ -179,9 +178,9 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
179
178
  period?: number;
180
179
  /**
181
180
  * @remarks
182
- * Control plane node instance billing period. This parameter takes effect only when `charge_type` is set to `PrePaid`.
181
+ * The billing cycle unit for control plane node instances. This parameter takes effect only when `charge_type` is set to `PrePaid`.
183
182
  *
184
- * `Month`: Billed on a monthly basis. Currently, only monthly billing is supported.
183
+ * `Month`: The billing cycle is measured in months. Currently, only months are supported.
185
184
  *
186
185
  * @example
187
186
  * Month
@@ -189,7 +188,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
189
188
  periodUnit?: string;
190
189
  /**
191
190
  * @remarks
192
- * Container runtime name. Valid values:
191
+ * The container runtime name. Valid values:
193
192
  *
194
193
  * - `containerd`: Recommended. Supported by all cluster versions.
195
194
  *
@@ -201,10 +200,10 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
201
200
  runtime?: string;
202
201
  /**
203
202
  * @remarks
204
- * Alibaba Cloud OS security hardening. Valid values:
203
+ * Specifies whether to enable Alibaba Cloud OS security hardening. Valid values:
205
204
  *
206
- * - `true`: Enable Alibaba Cloud OS security hardening.
207
- * - `false`: Disable Alibaba Cloud OS security hardening.
205
+ * - `true`: Enables Alibaba Cloud OS security hardening.
206
+ * - `false`: Disables Alibaba Cloud OS security hardening.
208
207
  *
209
208
  * Default value: `false`.
210
209
  *
@@ -214,7 +213,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
214
213
  securityHardeningOs?: boolean;
215
214
  /**
216
215
  * @remarks
217
- * Number of control plane nodes. To scale out the dedicated cluster control plane, this parameter specifies the target number of control plane nodes and must be greater than the current number of control plane nodes.
216
+ * The number of control plane nodes. To scale out the control plane of a dedicated cluster, set this parameter to the target number of control plane nodes, which must be greater than the current number.
218
217
  *
219
218
  * @example
220
219
  * 5
@@ -222,11 +221,11 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
222
221
  size?: number;
223
222
  /**
224
223
  * @remarks
225
- * Security hardening for compliance. For more information, see [ACK Security Hardening for Compliance](https://help.aliyun.com/document_detail/196148.html).
224
+ * Specifies whether to enable MLPS 2.0 security hardening. For more information, see [ACK MLPS 2.0 security hardening](https://help.aliyun.com/document_detail/196148.html).
226
225
  *
227
226
  * Valid values:
228
- * - `true`: Enable security hardening for compliance.
229
- * - `false`: Disable security hardening for compliance.
227
+ * - `true`: Enables MLPS 2.0 security hardening.
228
+ * - `false`: Disables MLPS 2.0 security hardening.
230
229
  *
231
230
  * Default value: `false`.
232
231
  *
@@ -236,11 +235,11 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
236
235
  socEnabled?: boolean;
237
236
  /**
238
237
  * @remarks
239
- * Whether to enable burst (performance bursting) for the node system disk. Valid values:
240
- * - `true`: Enable.
241
- * - `false`: Disable.
238
+ * Specifies whether to enable burst (performance burst) for the node system cloud disk. Valid values:
239
+ * - `true`: Enabled.
240
+ * - `false`: Disabled.
242
241
  *
243
- * This parameter is supported only when `system_disk_category` is set to `cloud_auto`. For more information, see [ESSD AutoPL](https://help.aliyun.com/document_detail/368372.html).
242
+ * This parameter is supported only when `system_disk_category` is set to `cloud_auto`. For more information, see [ESSD AutoPL cloud disks](https://help.aliyun.com/document_detail/368372.html).
244
243
  *
245
244
  * @example
246
245
  * true
@@ -248,12 +247,12 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
248
247
  systemDiskBurstingEnabled?: boolean;
249
248
  /**
250
249
  * @remarks
251
- * Node system disk type. Valid values:
252
- * - `cloud_efficiency`: Ultra disk.
253
- * - `cloud_ssd`: SSD disk.
254
- * - `cloud_essd`: ESSD disk.
255
- * - `cloud_auto`: ESSD AutoPL disk.
256
- * - `cloud_essd_entry`: ESSD Entry disk.
250
+ * The node system cloud disk type. Valid values:
251
+ * - `cloud_efficiency`: ultra cloud disk.
252
+ * - `cloud_ssd`: standard SSD.
253
+ * - `cloud_essd`: Enterprise SSD (ESSD).
254
+ * - `cloud_auto`: ESSD AutoPL cloud disk.
255
+ * - `cloud_essd_entry`: ESSD Entry cloud disk.
257
256
  *
258
257
  * @example
259
258
  * cloud_essd
@@ -261,7 +260,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
261
260
  systemDiskCategory?: string;
262
261
  /**
263
262
  * @remarks
264
- * Node system disk performance level. Only applicable to ESSD disks. The performance level is related to the disk size. For more information, see [ESSD](https://help.aliyun.com/document_detail/122389.html).
263
+ * The performance level of the node system cloud disk. This parameter takes effect only for ESSD cloud disks. The performance level varies based on the cloud disk size. For more information, see [standard SSDs](https://help.aliyun.com/document_detail/122389.html).
265
264
  *
266
265
  * @example
267
266
  * PL1
@@ -269,9 +268,9 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
269
268
  systemDiskPerformanceLevel?: string;
270
269
  /**
271
270
  * @remarks
272
- * Provisioned read/write IOPS for the node system disk. Valid values: 0 to min{50,000, 1000*capacity - baseline performance}. Baseline performance = min{1,800 + 50*capacity, 50,000}.
271
+ * The provisioned read/write IOPS for the node system cloud disk. Valid values: 0 to min{50,000, 1000 × capacity - baseline performance}. Baseline performance = min{1,800 + 50 × capacity, 50000}.
273
272
  *
274
- * This parameter is supported only when `system_disk_category` is set to `cloud_auto`. For more information, see [ESSD AutoPL](https://help.aliyun.com/document_detail/368372.html).
273
+ * This parameter is supported only when `system_disk_category` is set to `cloud_auto`. For more information, see [ESSD AutoPL cloud disks](https://help.aliyun.com/document_detail/368372.html).
275
274
  *
276
275
  * @example
277
276
  * 1000
@@ -279,7 +278,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
279
278
  systemDiskProvisionedIops?: number;
280
279
  /**
281
280
  * @remarks
282
- * Node system disk size. Valid values: [40, 500]. Unit: GiB.
281
+ * The node system cloud disk size. Valid values: [40, 500]. Unit: GiB.
283
282
  *
284
283
  * @example
285
284
  * 120
@@ -287,7 +286,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
287
286
  systemDiskSize?: number;
288
287
  /**
289
288
  * @remarks
290
- * Automatic snapshot policy ID for the node system disk.
289
+ * The ID of the automatic snapshot policy applied to the node system cloud disk.
291
290
  *
292
291
  * @example
293
292
  * sp-2zej1nogjvovnz4z****
@@ -366,13 +365,13 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
366
365
  export class ModifyClusterRequestControlPlaneEndpointsConfigInternalDnsConfig extends $dara.Model {
367
366
  /**
368
367
  * @remarks
369
- * VPCs where the cluster internal domain name record resolution takes effect.
368
+ * The VPCs where the internal domain name resolution takes effect.
370
369
  */
371
370
  bindVpcs?: string[];
372
371
  /**
373
372
  * @remarks
374
- * Whether to enable cluster internal domain name access. Valid values:
375
- * - true: Enable cluster internal domain name access. Node-side components (kubelet, kube-proxy) will access the API Server through the cluster internal domain name.
373
+ * Specifies whether to enable internal domain name access for the cluster. Valid values:
374
+ * - true: Enables internal domain name access. Node-side components (kubelet, kube-proxy) access the API Server through the internal domain name.
376
375
  *
377
376
  * @example
378
377
  * true
@@ -404,21 +403,68 @@ export class ModifyClusterRequestControlPlaneEndpointsConfigInternalDnsConfig ex
404
403
  }
405
404
  }
406
405
 
406
+ export class ModifyClusterRequestControlPlaneEndpointsConfigLoadBalancersConfig extends $dara.Model {
407
+ /**
408
+ * @remarks
409
+ * The endpoint type.
410
+ *
411
+ * @example
412
+ * public
413
+ */
414
+ endpointType?: string;
415
+ /**
416
+ * @remarks
417
+ * The SLB instance associated with the endpoint.
418
+ *
419
+ * @example
420
+ * nlb-xxxx
421
+ */
422
+ loadBalancerId?: string;
423
+ static names(): { [key: string]: string } {
424
+ return {
425
+ endpointType: 'endpoint_type',
426
+ loadBalancerId: 'load_balancer_id',
427
+ };
428
+ }
429
+
430
+ static types(): { [key: string]: any } {
431
+ return {
432
+ endpointType: 'string',
433
+ loadBalancerId: 'string',
434
+ };
435
+ }
436
+
437
+ validate() {
438
+ super.validate();
439
+ }
440
+
441
+ constructor(map?: { [key: string]: any }) {
442
+ super(map);
443
+ }
444
+ }
445
+
407
446
  export class ModifyClusterRequestControlPlaneEndpointsConfig extends $dara.Model {
408
447
  /**
409
448
  * @remarks
410
- * Cluster internal domain name configuration. Applicable to ACK managed clusters. The cluster internal domain name is used by node-side system components such as kubelet and kube-proxy to access the API Server. When the cluster internal domain name access is not enabled, node-side system components access via the CLB IP.
449
+ * The internal DNS configuration for the cluster. Applicable 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. When internal domain name access is not enabled, node-side system components access the API Server through the CLB IP address.
411
450
  */
412
451
  internalDnsConfig?: ModifyClusterRequestControlPlaneEndpointsConfigInternalDnsConfig;
452
+ /**
453
+ * @remarks
454
+ * The cluster access load balancing configuration.
455
+ */
456
+ loadBalancersConfig?: ModifyClusterRequestControlPlaneEndpointsConfigLoadBalancersConfig[];
413
457
  static names(): { [key: string]: string } {
414
458
  return {
415
459
  internalDnsConfig: 'internal_dns_config',
460
+ loadBalancersConfig: 'load_balancers_config',
416
461
  };
417
462
  }
418
463
 
419
464
  static types(): { [key: string]: any } {
420
465
  return {
421
466
  internalDnsConfig: ModifyClusterRequestControlPlaneEndpointsConfigInternalDnsConfig,
467
+ loadBalancersConfig: { 'type': 'array', 'itemType': ModifyClusterRequestControlPlaneEndpointsConfigLoadBalancersConfig },
422
468
  };
423
469
  }
424
470
 
@@ -426,6 +472,9 @@ export class ModifyClusterRequestControlPlaneEndpointsConfig extends $dara.Model
426
472
  if(this.internalDnsConfig && typeof (this.internalDnsConfig as any).validate === 'function') {
427
473
  (this.internalDnsConfig as any).validate();
428
474
  }
475
+ if(Array.isArray(this.loadBalancersConfig)) {
476
+ $dara.Model.validateArray(this.loadBalancersConfig);
477
+ }
429
478
  super.validate();
430
479
  }
431
480
 
@@ -437,12 +486,12 @@ export class ModifyClusterRequestControlPlaneEndpointsConfig extends $dara.Model
437
486
  export class ModifyClusterRequestOperationPolicyClusterAutoUpgrade extends $dara.Model {
438
487
  /**
439
488
  * @remarks
440
- * Cluster automatic upgrade frequency. For more information, see [Upgrade Frequency](https://help.aliyun.com/document_detail/2712866.html).
489
+ * The cluster auto upgrade frequency. For more information, see [Upgrade frequency](https://help.aliyun.com/document_detail/2712866.html).
441
490
  *
442
491
  * Valid values:
443
- * - patch: Latest patch version.
444
- * - stable: Second latest minor version.
445
- * - rapid: Latest minor version.
492
+ * - patch: latest patch version.
493
+ * - stable: second-latest minor version.
494
+ * - rapid: latest minor version.
446
495
  *
447
496
  * @example
448
497
  * patch
@@ -450,11 +499,11 @@ export class ModifyClusterRequestOperationPolicyClusterAutoUpgrade extends $dara
450
499
  channel?: string;
451
500
  /**
452
501
  * @remarks
453
- * Whether to enable cluster automatic upgrade.
502
+ * Specifies whether to enable cluster auto upgrade.
454
503
  *
455
- * - true: Enable automatic upgrade.
504
+ * - true: Enables auto upgrade.
456
505
  *
457
- * - false: Disable automatic upgrade.
506
+ * - false: Disables auto upgrade.
458
507
  *
459
508
  * @example
460
509
  * true
@@ -486,7 +535,7 @@ export class ModifyClusterRequestOperationPolicyClusterAutoUpgrade extends $dara
486
535
  export class ModifyClusterRequestOperationPolicy extends $dara.Model {
487
536
  /**
488
537
  * @remarks
489
- * Cluster automatic upgrade.
538
+ * The cluster auto upgrade configuration.
490
539
  */
491
540
  clusterAutoUpgrade?: ModifyClusterRequestOperationPolicyClusterAutoUpgrade;
492
541
  static names(): { [key: string]: string } {
@@ -516,12 +565,12 @@ export class ModifyClusterRequestOperationPolicy extends $dara.Model {
516
565
  export class ModifyClusterRequestSystemEventsLogging extends $dara.Model {
517
566
  /**
518
567
  * @remarks
519
- * Whether to enable system event storage.
568
+ * Specifies whether to enable system event storage.
520
569
  *
521
570
  *
522
- * - true: Enable system event storage.
571
+ * - true: Enables system event storage.
523
572
  *
524
- * - false: Disable system event storage.
573
+ * - false: Disables system event storage.
525
574
  *
526
575
  * @example
527
576
  * true
@@ -529,7 +578,7 @@ export class ModifyClusterRequestSystemEventsLogging extends $dara.Model {
529
578
  enabled?: boolean;
530
579
  /**
531
580
  * @remarks
532
- * LogProject name for system event storage.
581
+ * The name of the LogProject used for system event storage.
533
582
  *
534
583
  * @example
535
584
  * k8s-log-cb95aa626a47740afbf6aa099b65****
@@ -561,25 +610,24 @@ export class ModifyClusterRequestSystemEventsLogging extends $dara.Model {
561
610
  export class ModifyClusterRequest extends $dara.Model {
562
611
  /**
563
612
  * @remarks
564
- * Access control list for the registered cluster API Server SLB.
613
+ * The access control list for the registered cluster API Server SLB.
565
614
  *
566
615
  * @deprecated
567
616
  */
568
617
  accessControlList?: string[];
569
618
  /**
570
619
  * @remarks
571
- * Custom API Server certificate SAN (Subject Alternative Name).
572
- * Used to add custom IPs or domain names to the SAN field of the cluster API Server server certificate for client access control.
620
+ * The custom API Server certificate Subject Alternative Name (SAN). This parameter adds custom IP addresses or domain names to the SAN field of the cluster API Server certificate for client access control.
573
621
  *
574
622
  * Only managed clusters support this parameter.
575
623
  */
576
624
  apiServerCustomCertSans?: ModifyClusterRequestApiServerCustomCertSans;
577
625
  /**
578
626
  * @remarks
579
- * Whether to associate an EIP with the cluster for public access to API Server. Valid values:
627
+ * Indicates whether an Elastic IP Address (EIP) is attached to the cluster for public network access to the API server. Valid values:
580
628
  *
581
- * - `true`: Associate an EIP with the cluster.
582
- * - `false`: Do not associate an EIP with the cluster.
629
+ * - `true`: An EIP is attached to the cluster.
630
+ * - `false`: No EIP is attached to the cluster.
583
631
  *
584
632
  * @example
585
633
  * true
@@ -587,7 +635,7 @@ export class ModifyClusterRequest extends $dara.Model {
587
635
  apiServerEip?: boolean;
588
636
  /**
589
637
  * @remarks
590
- * The ID of the EIP instance associated with the cluster API Server. This parameter takes effect only when `api_server_eip` is set to `true`.
638
+ * The instance ID of the EIP attached to the cluster API Server. This parameter takes effect only when `api_server_eip` is set to `true`.
591
639
  *
592
640
  * @example
593
641
  * eip-wz9fnasl6dsfhmvci****
@@ -595,7 +643,15 @@ export class ModifyClusterRequest extends $dara.Model {
595
643
  apiServerEipId?: string;
596
644
  /**
597
645
  * @remarks
598
- * Custom cluster name. The name can contain digits, Chinese characters, English characters, or hyphens (-), must be 1 to 63 characters in length, and cannot start with a hyphen (-).
646
+ * The client token.
647
+ *
648
+ * @example
649
+ * af31042c-6355-495b-b6e3-exxb9669
650
+ */
651
+ clientToken?: string;
652
+ /**
653
+ * @remarks
654
+ * The custom cluster name. The name can contain digits, Chinese characters, letters, and hyphens (-). It must be 1 to 63 characters in length and cannot start with a hyphen (-).
599
655
  *
600
656
  * @example
601
657
  * cluster-new-name
@@ -603,16 +659,16 @@ export class ModifyClusterRequest extends $dara.Model {
603
659
  clusterName?: string;
604
660
  /**
605
661
  * @remarks
606
- * When `cluster_type` is set to `ManagedKubernetes` and `profile` is configured, specifies the cluster specification. Valid values:
662
+ * The cluster specification when `cluster_type` is set to `ManagedKubernetes` and `profile` is configured. Valid values:
607
663
  *
608
- * - `ack.pro.small`: Pro Edition
664
+ * - `ack.pro.small`: Pro
609
665
  * - `ack.pro.xlarge`: Pro XL
610
666
  * - `ack.pro.2xlarge`: Pro 2XL
611
- * - `ack.pro.4xlarge`: Pro 4XL (requires contacting customer service to enable allowlisting)
667
+ * - `ack.pro.4xlarge`: Pro 4XL (contact customer service to be added to the whitelist)
612
668
  *
613
- * 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). By pre-allocating and fixing control plane resources, it ensures that API concurrency and Pod scheduling capabilities are always at a determined high level, suitable for AI training and inference, ultra-large-scale clusters, and mission-critical workloads.
669
+ * 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). By pre-allocating and dedicating control plane resources, these tiers ensure that API concurrency and pod scheduling capabilities remain at a consistently high level. They are suitable for AI training and inference, ultra-large-scale clusters, and mission-critical workloads.
614
670
  *
615
- * For cluster management fees for 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).
671
+ * For information about the cluster management fees for Pro 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).
616
672
  *
617
673
  * @example
618
674
  * ack.pro.small
@@ -620,20 +676,20 @@ export class ModifyClusterRequest extends $dara.Model {
620
676
  clusterSpec?: string;
621
677
  /**
622
678
  * @remarks
623
- * Dedicated cluster control plane configuration.
679
+ * The dedicated cluster control plane configuration.
624
680
  */
625
681
  controlPlaneConfig?: ModifyClusterRequestControlPlaneConfig;
626
682
  /**
627
683
  * @remarks
628
- * Cluster connection configuration.
684
+ * The cluster connection configuration.
629
685
  */
630
686
  controlPlaneEndpointsConfig?: ModifyClusterRequestControlPlaneEndpointsConfig;
631
687
  /**
632
688
  * @remarks
633
- * Cluster deletion protection, which prevents accidental deletion of the cluster through the console or API. Valid values:
689
+ * Specifies whether to enable deletion protection for the cluster to prevent accidental deletion through the console or API. Valid values:
634
690
  *
635
- * - `true`: Enable cluster deletion protection. The cluster cannot be deleted through the console or API.
636
- * - `false`: Disable cluster deletion protection. The cluster can be deleted through the console or API.
691
+ * - `true`: Enables cluster deletion protection. The cluster cannot be deleted through the console or API.
692
+ * - `false`: Disables cluster deletion protection. The cluster can be deleted through the console or API.
637
693
  *
638
694
  * Default value: `false`.
639
695
  *
@@ -643,10 +699,10 @@ export class ModifyClusterRequest extends $dara.Model {
643
699
  deletionProtection?: boolean;
644
700
  /**
645
701
  * @remarks
646
- * Enable or disable the RRSA feature (only managed clusters support this parameter). Valid values:
702
+ * Specifies whether to enable or disable the RAM Roles for Service Accounts (RRSA) feature. Only managed clusters support this parameter. Valid values:
647
703
  *
648
- * - `true`: Enable.
649
- * - `false`: Disable.
704
+ * - `true`: Enabled.
705
+ * - `false`: Disabled.
650
706
  *
651
707
  * @example
652
708
  * true
@@ -654,10 +710,10 @@ export class ModifyClusterRequest extends $dara.Model {
654
710
  enableRrsa?: boolean;
655
711
  /**
656
712
  * @remarks
657
- * Rebind the cluster test domain. Valid values:
713
+ * Specifies whether to rebind the cluster test domain name. Valid values:
658
714
  *
659
- * - `true`: Rebind the cluster test domain.
660
- * - `false`: Do not rebind the cluster test domain.
715
+ * - `true`: Rebinds the cluster test domain name.
716
+ * - `false`: Does not rebind the cluster test domain name.
661
717
  *
662
718
  * Default value: `false`.
663
719
  *
@@ -669,7 +725,7 @@ export class ModifyClusterRequest extends $dara.Model {
669
725
  ingressDomainRebinding?: boolean;
670
726
  /**
671
727
  * @remarks
672
- * SLB instance ID of the cluster to be modified.
728
+ * The SLB instance ID of the cluster to be modified.
673
729
  *
674
730
  * @example
675
731
  * lb-wz97kes8tnndkpodw****
@@ -679,10 +735,10 @@ export class ModifyClusterRequest extends $dara.Model {
679
735
  ingressLoadbalancerId?: string;
680
736
  /**
681
737
  * @remarks
682
- * Instance deletion protection to prevent accidental deletion and release of nodes through the console or API. Valid values:
738
+ * Specifies whether to enable instance deletion protection to prevent accidental deletion of nodes through the console or API. Valid values:
683
739
  *
684
740
  * - `true`: Nodes cannot be accidentally deleted through the console or API.
685
- * - `false`: Nodes can be deleted through the console or API.
741
+ * - `false`: Nodes can be accidentally deleted through the console or API.
686
742
  *
687
743
  * Default value: `false`.
688
744
  *
@@ -694,17 +750,17 @@ export class ModifyClusterRequest extends $dara.Model {
694
750
  instanceDeletionProtection?: boolean;
695
751
  /**
696
752
  * @remarks
697
- * Cluster maintenance window. This feature only takes effect for ACK Pro managed clusters.
753
+ * The maintenance window configuration for the cluster. This feature takes effect only for ACK Pro clusters.
698
754
  */
699
755
  maintenanceWindow?: MaintenanceWindow;
700
756
  /**
701
757
  * @remarks
702
- * Cluster automatic O&M policy.
758
+ * The cluster automatic O&M policy.
703
759
  */
704
760
  operationPolicy?: ModifyClusterRequestOperationPolicy;
705
761
  /**
706
762
  * @remarks
707
- * Cluster resource group ID.
763
+ * The resource group ID of the cluster.
708
764
  *
709
765
  * @example
710
766
  * rg-acfmyvw3wjm****
@@ -712,11 +768,11 @@ export class ModifyClusterRequest extends $dara.Model {
712
768
  resourceGroupId?: string;
713
769
  /**
714
770
  * @remarks
715
- * Control plane security group ID.
771
+ * The control plane security group ID.
716
772
  *
717
- * - If you have configured blocking rules in the security group, ensure that the security group rules allow the protocols and ports required by the cluster. For recommended security group rules, see [Configure and Manage Cluster Security Groups](https://help.aliyun.com/document_detail/353191.html).
718
- * - For non-ACK dedicated clusters, during the change process, the cluster control plane and installed managed components (such as terway-controlplane) will briefly restart. We recommend performing this operation during off-peak hours. After the control plane security group is changed, the ENIs used by the cluster control plane and installed managed components will be automatically added to the new security group.
719
- * - For ACK dedicated clusters, after the control plane security group is changed, newly scaled-out Master nodes will automatically use the new control plane security group. Existing control plane nodes are not affected.
773
+ * - If you have configured blocking rules in the security group, ensure that the security group rules allow the protocols and ports required by the cluster. For information about recommended security group rules, see [Configure and manage cluster security groups](https://help.aliyun.com/document_detail/353191.html).
774
+ * - For non-ACK dedicated clusters, the cluster control plane and installed managed components (such as terway-controlplane) briefly restart during the procedure. Perform this operation during off-peak hours. After the control plane security group is changed, the network interface controllers (NICs) used by the cluster control plane and installed managed components are automatically added to the new security group.
775
+ * - For ACK dedicated clusters, after the control plane security group is changed, newly scaled-out master nodes automatically use the new control plane security group. Existing control plane nodes are not affected.
720
776
  *
721
777
  * @example
722
778
  * sg-bp1h6rk3pgct2a08***
@@ -724,17 +780,17 @@ export class ModifyClusterRequest extends $dara.Model {
724
780
  securityGroupId?: string;
725
781
  /**
726
782
  * @remarks
727
- * System event storage configuration.
783
+ * The system event storage configuration.
728
784
  */
729
785
  systemEventsLogging?: ModifyClusterRequestSystemEventsLogging;
730
786
  /**
731
787
  * @remarks
732
- * Cluster timezone. See [Supported Timezones](https://help.aliyun.com/document_detail/354879.html).
733
- * - After changing the timezone, cluster inspection configurations will use the new timezone settings.
788
+ * The cluster time zone. See [Supported time zones](https://help.aliyun.com/document_detail/354879.html).
789
+ * - After the time zone is changed, the cluster inspection configuration uses the new time zone settings.
734
790
  *
735
- * - For managed clusters, during the change process, the cluster control plane and installed managed components (such as terway-controlplane) will briefly restart. We recommend performing this operation during off-peak hours. After changing the timezone, newly scaled-out nodes will automatically use the new timezone settings. Existing nodes are not affected. You can use the node pool node reset feature to apply the new settings to existing nodes.
791
+ * - For managed clusters, the cluster control plane and installed managed components (such as terway-controlplane) briefly restart during the change. Perform this operation during off-peak hours. After the time zone is changed, newly scaled-out nodes automatically use the new time zone settings. Existing nodes are not affected. You can use the node pool node reset feature to apply the new settings to existing nodes.
736
792
  *
737
- * - For dedicated clusters, after changing the timezone, newly scaled-out nodes (including control plane nodes) will automatically use the new timezone settings. Existing nodes (including control plane nodes) are not affected. You can use the node pool node reset feature to apply the new settings to existing nodes. For control plane nodes, you need to scale out first and then scale in to apply the settings to all control plane nodes.
793
+ * - For dedicated clusters, after the time zone is changed, newly scaled-out nodes (including control plane nodes) automatically use the new time zone settings. Existing nodes (including control plane nodes) are not affected. You can use the node pool node reset feature to apply the new settings to existing nodes. For control plane nodes, scale out and then scale in to apply the new settings to all control plane nodes.
738
794
  *
739
795
  * @example
740
796
  * Asia/Shanghai
@@ -742,11 +798,11 @@ export class ModifyClusterRequest extends $dara.Model {
742
798
  timezone?: string;
743
799
  /**
744
800
  * @remarks
745
- * Cluster control plane vSwitches. For dedicated clusters, this takes effect on newly scaled-out control plane nodes. When modifying control plane vSwitches for managed clusters, note the following:
746
- * - This parameter performs a full overwrite update. You must specify the complete list of target vSwitches.
747
- * - During the change, control plane components will briefly restart. Proceed with caution.
748
- * - Ensure that all security groups of the cluster (including the control plane security group, all node pool security groups, and container network security groups) allow inbound and outbound traffic for the IP ranges of the new vSwitches to prevent nodes and containers from being unable to connect to the API Server.
749
- * - If the new control plane vSwitches have ACL rules configured, ensure that the ACL rules allow communication with the cluster nodes, container network, and other IP ranges.
801
+ * The vSwitches for the cluster control plane. For dedicated clusters, the change applies to newly scaled-out control plane nodes. When changing control plane vSwitches for managed clusters, note the following:
802
+ * - This parameter performs a full overwrite. Specify the complete list of target vSwitches.
803
+ * - Control plane components briefly restart during the change. Proceed with caution.
804
+ * - Ensure that all security groups of the cluster (including the control plane security group, security groups of all node pools, and security groups used by the container network) allow inbound and outbound traffic for the IP CIDR blocks of the new vSwitches to prevent nodes and containers from losing connectivity to the API server.
805
+ * - If the new control plane vSwitches have ACL rules configured, ensure that the ACL rules allow communication with the CIDR blocks of cluster nodes and the container network.
750
806
  */
751
807
  vswitchIds?: string[];
752
808
  static names(): { [key: string]: string } {
@@ -755,6 +811,7 @@ export class ModifyClusterRequest extends $dara.Model {
755
811
  apiServerCustomCertSans: 'api_server_custom_cert_sans',
756
812
  apiServerEip: 'api_server_eip',
757
813
  apiServerEipId: 'api_server_eip_id',
814
+ clientToken: 'client_token',
758
815
  clusterName: 'cluster_name',
759
816
  clusterSpec: 'cluster_spec',
760
817
  controlPlaneConfig: 'control_plane_config',
@@ -780,6 +837,7 @@ export class ModifyClusterRequest extends $dara.Model {
780
837
  apiServerCustomCertSans: ModifyClusterRequestApiServerCustomCertSans,
781
838
  apiServerEip: 'boolean',
782
839
  apiServerEipId: 'string',
840
+ clientToken: 'string',
783
841
  clusterName: 'string',
784
842
  clusterSpec: 'string',
785
843
  controlPlaneConfig: ModifyClusterRequestControlPlaneConfig,