@alicloud/cs20151215 4.8.11 → 4.8.12

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.
package/src/client.ts CHANGED
@@ -1061,7 +1061,7 @@ export class AttachInstancesResponseBodyList extends $dara.Model {
1061
1061
  export class CheckServiceRoleRequestRoles extends $dara.Model {
1062
1062
  /**
1063
1063
  * @remarks
1064
- * The service role name.
1064
+ * The name of the service role. For more information about ACK roles, see [ACK roles](https://help.aliyun.com/document_detail/86483.html).
1065
1065
  *
1066
1066
  * This parameter is required.
1067
1067
  *
@@ -1093,7 +1093,12 @@ export class CheckServiceRoleRequestRoles extends $dara.Model {
1093
1093
  export class CheckServiceRoleResponseBodyRoles extends $dara.Model {
1094
1094
  /**
1095
1095
  * @remarks
1096
- * Specifies whether the service role is granted required permissions.
1096
+ * Indicates whether the service role is assigned to ACK.
1097
+ *
1098
+ * Valid values:
1099
+ *
1100
+ * * true: The role is assigned to ACK.
1101
+ * * false: The role is not assigned to ACK.
1097
1102
  *
1098
1103
  * @example
1099
1104
  * true
@@ -1101,7 +1106,7 @@ export class CheckServiceRoleResponseBodyRoles extends $dara.Model {
1101
1106
  granted?: boolean;
1102
1107
  /**
1103
1108
  * @remarks
1104
- * The message returned if the service role is not granted required permissions.
1109
+ * The message that is displayed for a role that is not assigned to ACK.
1105
1110
  *
1106
1111
  * @example
1107
1112
  * The role does not exist: AliyunCSManagedAutoScalerRole
@@ -1109,7 +1114,7 @@ export class CheckServiceRoleResponseBodyRoles extends $dara.Model {
1109
1114
  message?: string;
1110
1115
  /**
1111
1116
  * @remarks
1112
- * The service role name.
1117
+ * The name of the service role.
1113
1118
  *
1114
1119
  * @example
1115
1120
  * AliyunCSManagedAutoScalerRole
@@ -1143,7 +1148,7 @@ export class CheckServiceRoleResponseBodyRoles extends $dara.Model {
1143
1148
  export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1144
1149
  /**
1145
1150
  * @remarks
1146
- * Indicates whether auto-renewal is enabled for the control plane node.
1151
+ * Specifies whether to enable auto-renewal for the node.
1147
1152
  *
1148
1153
  * @example
1149
1154
  * true
@@ -1151,7 +1156,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1151
1156
  autoRenew?: boolean;
1152
1157
  /**
1153
1158
  * @remarks
1154
- * The auto-renewal duration for the control plane node.
1159
+ * The auto-renewal duration for the node.
1155
1160
  *
1156
1161
  * @example
1157
1162
  * 1
@@ -1159,7 +1164,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1159
1164
  autoRenewPeriod?: number;
1160
1165
  /**
1161
1166
  * @remarks
1162
- * The billing method of the control plane node.
1167
+ * The billing method of the node.
1163
1168
  *
1164
1169
  * @example
1165
1170
  * PrePaid
@@ -1167,7 +1172,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1167
1172
  chargeType?: string;
1168
1173
  /**
1169
1174
  * @remarks
1170
- * Indicates whether to install CloudMonitor for the node.
1175
+ * Specifies whether to install CloudMonitor on the node.
1171
1176
  *
1172
1177
  * @example
1173
1178
  * true
@@ -1175,7 +1180,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1175
1180
  cloudMonitorFlags?: boolean;
1176
1181
  /**
1177
1182
  * @remarks
1178
- * The CPU management policy of nodes in the node pool.
1183
+ * The CPU management policy of the node.
1179
1184
  *
1180
1185
  * @example
1181
1186
  * none
@@ -1191,7 +1196,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1191
1196
  deploymentsetId?: string;
1192
1197
  /**
1193
1198
  * @remarks
1194
- * The ID of the image.
1199
+ * The image ID.
1195
1200
  *
1196
1201
  * @example
1197
1202
  * aliyun_3_x64_20G_alibase_20240819.vhd
@@ -1207,12 +1212,12 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1207
1212
  imageType?: string;
1208
1213
  /**
1209
1214
  * @remarks
1210
- * The instance type of the node.
1215
+ * The instance types of the nodes.
1211
1216
  */
1212
1217
  instanceTypes?: string[];
1213
1218
  /**
1214
1219
  * @remarks
1215
- * The name of the key pair. You must set key_pair or login_password.
1220
+ * The name of the key pair. You must set this parameter or login_password.
1216
1221
  *
1217
1222
  * @example
1218
1223
  * ack
@@ -1220,7 +1225,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1220
1225
  keyPair?: string;
1221
1226
  /**
1222
1227
  * @remarks
1223
- * The SSH logon password. The password must be 8 to 30 characters in length and contain a minimum of three of the following character types: uppercase letters, lowercase letters, digits, and special characters. You must set login_password or key_pair.
1228
+ * The SSH logon password. The password must be 8 to 30 characters in length and contain a minimum of three of the following character types: uppercase letters, lowercase letters, digits, and special characters. You must set this parameter or key_pair.
1224
1229
  *
1225
1230
  * @example
1226
1231
  * ack@Test
@@ -1236,7 +1241,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1236
1241
  nodePortRange?: string;
1237
1242
  /**
1238
1243
  * @remarks
1239
- * The subscription duration of the control plane node.
1244
+ * The subscription duration of the node.
1240
1245
  *
1241
1246
  * @example
1242
1247
  * 1
@@ -1244,7 +1249,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1244
1249
  period?: number;
1245
1250
  /**
1246
1251
  * @remarks
1247
- * The unit of the subscription duration of the control plane node.
1252
+ * The unit of the subscription duration of the node.
1248
1253
  *
1249
1254
  * @example
1250
1255
  * Month
@@ -1252,7 +1257,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1252
1257
  periodUnit?: string;
1253
1258
  /**
1254
1259
  * @remarks
1255
- * The runtime.
1260
+ * The container runtime.
1256
1261
  *
1257
1262
  * @example
1258
1263
  * containerd
@@ -1260,7 +1265,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1260
1265
  runtime?: string;
1261
1266
  /**
1262
1267
  * @remarks
1263
- * Indicates whether to enable Alibaba Cloud Linux Security Hardening.
1268
+ * Specifies whether to enable Alibaba Cloud Linux Security Hardening.
1264
1269
  *
1265
1270
  * @example
1266
1271
  * true
@@ -1276,7 +1281,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1276
1281
  size?: number;
1277
1282
  /**
1278
1283
  * @remarks
1279
- * Indicates whether to enable MLPS security hardening.
1284
+ * Specifies whether to enable MLPS security hardening.
1280
1285
  *
1281
1286
  * @example
1282
1287
  * true
@@ -1284,7 +1289,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1284
1289
  socEnabled?: boolean;
1285
1290
  /**
1286
1291
  * @remarks
1287
- * Indicates whether to enable the burst feature for the system disk.
1292
+ * Specifies whether to enable the burst feature for the system disk.
1288
1293
  *
1289
1294
  * @example
1290
1295
  * true
@@ -1292,7 +1297,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1292
1297
  systemDiskBurstingEnabled?: boolean;
1293
1298
  /**
1294
1299
  * @remarks
1295
- * The category of the system disk for nodes.
1300
+ * The system disk category for the node.
1296
1301
  *
1297
1302
  * @example
1298
1303
  * cloud_essd
@@ -1300,7 +1305,7 @@ export class CreateClusterRequestControlPlaneConfig extends $dara.Model {
1300
1305
  systemDiskCategory?: string;
1301
1306
  /**
1302
1307
  * @remarks
1303
- * The performance level (PL) of the system disk that you want to use for the node. This parameter takes effect only for ESSDs.
1308
+ * The PL of the system disk that you want to use for the node. This parameter takes effect only for ESSDs.
1304
1309
  *
1305
1310
  * @example
1306
1311
  * PL1
@@ -1447,7 +1452,7 @@ export class CreateClusterRequestOperationPolicyClusterAutoUpgrade extends $dara
1447
1452
  export class CreateClusterRequestOperationPolicy extends $dara.Model {
1448
1453
  /**
1449
1454
  * @remarks
1450
- * The configurations of auto cluster update.
1455
+ * The configurations of auto cluster upgrade.
1451
1456
  */
1452
1457
  clusterAutoUpgrade?: CreateClusterRequestOperationPolicyClusterAutoUpgrade;
1453
1458
  static names(): { [key: string]: string } {
@@ -1477,7 +1482,7 @@ export class CreateClusterRequestOperationPolicy extends $dara.Model {
1477
1482
  export class CreateClusterRequestWorkerDataDisks extends $dara.Model {
1478
1483
  /**
1479
1484
  * @remarks
1480
- * The data disk type.
1485
+ * The data disk category.
1481
1486
  *
1482
1487
  * This parameter is required.
1483
1488
  *
@@ -1487,12 +1492,12 @@ export class CreateClusterRequestWorkerDataDisks extends $dara.Model {
1487
1492
  category?: string;
1488
1493
  /**
1489
1494
  * @remarks
1490
- * Specifies whether to encrypt the data disks. Valid values:
1495
+ * Specifies whether to encrypt the data disk. Valid values:
1491
1496
  *
1492
1497
  * * `true`: encrypts the data disk.
1493
1498
  * * `false`: does not encrypt the data disk.
1494
1499
  *
1495
- * Default value: `false`
1500
+ * Default value: `false`.
1496
1501
  *
1497
1502
  * @example
1498
1503
  * true
@@ -1769,7 +1774,7 @@ export class CreateClusterNodePoolRequestKubernetesConfig extends $dara.Model {
1769
1774
  * * `true`: installs the CloudMonitor agent on ECS nodes.
1770
1775
  * * `false`: does not install the CloudMonitor agent on ECS nodes.
1771
1776
  *
1772
- * Default value: `false`
1777
+ * Default value: `false`.
1773
1778
  *
1774
1779
  * @example
1775
1780
  * true
@@ -1777,7 +1782,7 @@ export class CreateClusterNodePoolRequestKubernetesConfig extends $dara.Model {
1777
1782
  cmsEnabled?: boolean;
1778
1783
  /**
1779
1784
  * @remarks
1780
- * The CPU management policy of nodes. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
1785
+ * The CPU management policy of nodes in the node pool. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
1781
1786
  *
1782
1787
  * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
1783
1788
  * * `none`: specifies that the default CPU affinity is used.
@@ -1838,7 +1843,7 @@ export class CreateClusterNodePoolRequestKubernetesConfig extends $dara.Model {
1838
1843
  runtimeVersion?: string;
1839
1844
  /**
1840
1845
  * @remarks
1841
- * The configuration of the taint.
1846
+ * The configurations of the taints.
1842
1847
  */
1843
1848
  taints?: Taint[];
1844
1849
  /**
@@ -1940,10 +1945,10 @@ export class CreateClusterNodePoolRequestManagementAutoRepairPolicy extends $dar
1940
1945
  export class CreateClusterNodePoolRequestManagementAutoUpgradePolicy extends $dara.Model {
1941
1946
  /**
1942
1947
  * @remarks
1943
- * Specifies whether to allow auto update of the kubelet. This parameter takes effect only if `auto_upgrade` is set to true. Valid values:
1948
+ * Specifies whether to allow the auto upgrade of the kubelet. This parameter takes effect only if `auto_upgrade` is set to true. Valid values:
1944
1949
  *
1945
- * * `true`: allows auto update of the kubelet.
1946
- * * `false`: does not allow auto update of the kubelet.
1950
+ * * `true`: allows the auto upgrade of the kubelet.
1951
+ * * `false`: does not allow the auto upgrade of the kubelet.
1947
1952
  *
1948
1953
  * If `auto_upgrade` is set to true, the default value of this parameter is `true`. If `auto_upgrade` is set to false, the default value of this parameter is `false`.
1949
1954
  *
@@ -1953,20 +1958,20 @@ export class CreateClusterNodePoolRequestManagementAutoUpgradePolicy extends $da
1953
1958
  autoUpgradeKubelet?: boolean;
1954
1959
  /**
1955
1960
  * @remarks
1956
- * Specifies whether to allow auto update of the OS. This parameter takes effect only if `auto_upgrade` is set to true. Valid values:
1961
+ * Specifies whether to allow the auto upgrade of the OS. This parameter takes effect only if `auto_upgrade` is set to true. Valid values:
1957
1962
  *
1958
- * * `true`: allows auto update of the OS.
1959
- * * `false`: does not allow auto update of the OS.
1963
+ * * `true`: allows the auto upgrade of the OS.
1964
+ * * `false`: does not allow the auto upgrade of the OS.
1960
1965
  *
1961
1966
  * Default value: `false`.
1962
1967
  */
1963
1968
  autoUpgradeOs?: boolean;
1964
1969
  /**
1965
1970
  * @remarks
1966
- * Specifies whether to allow auto update of the runtime. This parameter takes effect only if `auto_upgrade` is set to true. Valid values:
1971
+ * Specifies whether to allow the auto upgrade of the runtime. This parameter takes effect only if `auto_upgrade` is set to true. Valid values:
1967
1972
  *
1968
- * * `true`: allows auto update of the runtime.
1969
- * * `false`: does not allow auto update of the runtime.
1973
+ * * `true`: allows the auto upgrade of the runtime.
1974
+ * * `false`: does not allow the auto upgrade of the runtime.
1970
1975
  *
1971
1976
  * Default value: `false`.
1972
1977
  */
@@ -2012,9 +2017,9 @@ export class CreateClusterNodePoolRequestManagementAutoVulFixPolicy extends $dar
2012
2017
  * @remarks
2013
2018
  * The severity levels of CVEs that can be automatically patched. Separate multiple levels with commas (,). Example: `asap,later`. Valid values:
2014
2019
  *
2015
- * * `asap`: high
2016
- * * `later`: medium
2017
- * * `nntf`: low
2020
+ * * `asap`: high.
2021
+ * * `later`: medium.
2022
+ * * `nntf`: low.
2018
2023
  *
2019
2024
  * If `auto_vul_fix` is set to true, the default value of this parameter is `asap`.
2020
2025
  *
@@ -2048,10 +2053,10 @@ export class CreateClusterNodePoolRequestManagementAutoVulFixPolicy extends $dar
2048
2053
  export class CreateClusterNodePoolRequestManagementUpgradeConfig extends $dara.Model {
2049
2054
  /**
2050
2055
  * @remarks
2051
- * Specifies whether to enable auto update. Valid values:
2056
+ * Specifies whether to enable auto upgrade. Valid values:
2052
2057
  *
2053
- * * `true`: enables auto update.
2054
- * * `false`: disables auto update.
2058
+ * * `true`: enables auto OS upgrade.
2059
+ * * `false`: disables auto OS upgrade.
2055
2060
  *
2056
2061
  * **
2057
2062
  *
@@ -2075,7 +2080,7 @@ export class CreateClusterNodePoolRequestManagementUpgradeConfig extends $dara.M
2075
2080
  maxUnavailable?: number;
2076
2081
  /**
2077
2082
  * @remarks
2078
- * The number of additional nodes.
2083
+ * The number of nodes that are temporarily added to the node pool during an auto upgrade.
2079
2084
  *
2080
2085
  * @example
2081
2086
  * 0
@@ -2137,10 +2142,10 @@ export class CreateClusterNodePoolRequestManagement extends $dara.Model {
2137
2142
  autoRepairPolicy?: CreateClusterNodePoolRequestManagementAutoRepairPolicy;
2138
2143
  /**
2139
2144
  * @remarks
2140
- * Specifies whether to enable auto node update. This parameter takes effect only if `enable` is set to true.
2145
+ * Specifies whether to enable auto node upgrade. This parameter takes effect only if `enable` is set to true.
2141
2146
  *
2142
- * * `true`: enables auto node update.
2143
- * * `false`: disables auto node update.
2147
+ * * `true`: enables auto node upgrade.
2148
+ * * `false`: disables auto node upgrade.
2144
2149
  *
2145
2150
  * If `enable` is set to true, the default value of this parameter is `true`. If `enable` is set to false, the default value of this parameter is `false`.
2146
2151
  *
@@ -2150,7 +2155,7 @@ export class CreateClusterNodePoolRequestManagement extends $dara.Model {
2150
2155
  autoUpgrade?: boolean;
2151
2156
  /**
2152
2157
  * @remarks
2153
- * The auto node update policy.
2158
+ * The auto node upgrade policy.
2154
2159
  */
2155
2160
  autoUpgradePolicy?: CreateClusterNodePoolRequestManagementAutoUpgradePolicy;
2156
2161
  /**
@@ -2178,7 +2183,7 @@ export class CreateClusterNodePoolRequestManagement extends $dara.Model {
2178
2183
  * * `true`: enables the managed node pool feature.
2179
2184
  * * `false`: disables the managed node pool feature. Other parameters in this section take effect only if enable is set to true.
2180
2185
  *
2181
- * Default value: false
2186
+ * Default value: false.
2182
2187
  *
2183
2188
  * @example
2184
2189
  * false
@@ -2186,7 +2191,7 @@ export class CreateClusterNodePoolRequestManagement extends $dara.Model {
2186
2191
  enable?: boolean;
2187
2192
  /**
2188
2193
  * @remarks
2189
- * The configurations of auto update. The configurations take effects only if `enable` is set to true.
2194
+ * The configurations of auto upgrade. The configurations take effects only if `enable` is set to true.
2190
2195
  *
2191
2196
  * @deprecated
2192
2197
  */
@@ -2456,7 +2461,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2456
2461
  * * `true`: enables auto-renewal.
2457
2462
  * * `false`: disables auto-renewal.
2458
2463
  *
2459
- * Default value: `false`
2464
+ * Default value: `false`.
2460
2465
  *
2461
2466
  * @example
2462
2467
  * true
@@ -2466,10 +2471,10 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2466
2471
  * @remarks
2467
2472
  * The auto-renewal period. Valid values:
2468
2473
  *
2469
- * * Valid values when PeriodUnit is set to Week: 1, 2, and 3
2470
- * * Valid values when PeriodUnit is set to Month: 1, 2, 3, 6, 12, 24, 36, 48, and 60
2474
+ * * Valid values when PeriodUnit is set to Week: 1, 2, and 3.
2475
+ * * Valid values when PeriodUnit is set to Month: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
2471
2476
  *
2472
- * Default value: 1
2477
+ * Default value: 1.
2473
2478
  *
2474
2479
  * @example
2475
2480
  * 1
@@ -2477,7 +2482,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2477
2482
  autoRenewPeriod?: number;
2478
2483
  /**
2479
2484
  * @remarks
2480
- * This parameter is deprecated. Use the security_hardening_os parameter instead.
2485
+ * This parameter is deprecated. Use security_hardening_os instead.
2481
2486
  *
2482
2487
  * @example
2483
2488
  * false
@@ -2531,13 +2536,14 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2531
2536
  *
2532
2537
  * * `AliyunLinux`: Alibaba Cloud Linux 2.
2533
2538
  * * `AliyunLinuxSecurity`: Alibaba Cloud Linux 2 (UEFI).
2534
- * * `AliyunLinux3`: Alibaba Cloud Linux 3.
2539
+ * * `AliyunLinux3`: Alibaba Cloud Linux 3
2535
2540
  * * `AliyunLinux3Arm64`: Alibaba Cloud Linux 3 (ARM).
2536
2541
  * * `AliyunLinux3Security`: Alibaba Cloud Linux 3 (UEFI).
2537
2542
  * * `CentOS`: CentOS.
2538
2543
  * * `Windows`: Windows.
2539
2544
  * * `WindowsCore`: Windows Core.
2540
2545
  * * `ContainerOS`: ContainerOS.
2546
+ * * `AliyunLinux3ContainerOptimized`: Alibaba Cloud Linux 3 Container-optimized.
2541
2547
  *
2542
2548
  * @example
2543
2549
  * AliyunLinux
@@ -2560,7 +2566,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2560
2566
  instanceChargeType?: string;
2561
2567
  /**
2562
2568
  * @remarks
2563
- * The instance properties.
2569
+ * The instance attributes.
2564
2570
  */
2565
2571
  instancePatterns?: InstancePatterns[];
2566
2572
  /**
@@ -2611,7 +2617,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2611
2617
  loginAsNonRoot?: boolean;
2612
2618
  /**
2613
2619
  * @remarks
2614
- * The password for SSH logon. You must specify this parameter or the `key_pair` parameter. 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.
2620
+ * The password for SSH logon. You must set this parameter or `key_pair`. The password must be 8 to 30 characters in length, and must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.
2615
2621
  *
2616
2622
  * @example
2617
2623
  * Hello1234
@@ -2679,7 +2685,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2679
2685
  periodUnit?: string;
2680
2686
  /**
2681
2687
  * @remarks
2682
- * The operating system distribution. Valid values:
2688
+ * The OS distribution that is used. Valid values:
2683
2689
  *
2684
2690
  * * `CentOS`
2685
2691
  * * `AliyunLinux`
@@ -2706,8 +2712,6 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2706
2712
  * * If you do not specify this parameter, the default worker RAM role created by the cluster is used.
2707
2713
  * * The specified RAM role must be a **regular service role** and the **Select Trusted Service** parameter must be set to **Elastic Compute Service**. For more information, see [Create a normal service role](https://help.aliyun.com/document_detail/116800.html). If the specified RAM role is not the default worker RAM role created by the cluster, the name of the RAM role cannot start with `KubernetesMasterRole-` or `KubernetesWorkerRole-`.
2708
2714
  *
2709
- * This parameter is available only to users in the whitelist. To use this parameter, submit a ticket.
2710
- *
2711
2715
  * > This parameter is available only for ACK managed clusters that run Kubernetes 1.22 or later.
2712
2716
  *
2713
2717
  * @example
@@ -2716,14 +2720,14 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2716
2720
  ramRoleName?: string;
2717
2721
  /**
2718
2722
  * @remarks
2719
- * A list of ApsaraDB RDS instances.
2723
+ * The IDs of ApsaraDB RDS instances.
2720
2724
  */
2721
2725
  rdsInstances?: string[];
2722
2726
  /**
2723
2727
  * @remarks
2724
2728
  * The scaling mode of the scaling group. Valid values:
2725
2729
  *
2726
- * * `release`: the standard mode. ECS instances are created and released based on the resource usage.
2730
+ * * `release`: the standard mode. ECS instances are created and released based on resource usage.
2727
2731
  * * `recycle`: the swift mode. ECS instances are created, stopped, or started during scaling events. This reduces the time required for the next scale-out event. When the instance is stopped, you are charged only for the storage service. This does not apply to ECS instances that are attached with local disks.
2728
2732
  *
2729
2733
  * Default value: `release`.
@@ -2775,7 +2779,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2775
2779
  spotInstancePools?: number;
2776
2780
  /**
2777
2781
  * @remarks
2778
- * Specifies whether to enable the supplementation of preemptible instances. If you set this parameter to true, when the scaling group receives a system message indicating that a preemptible instance is to be reclaimed, the scaling group attempts to create a new instance to replace this instance. Valid values:
2782
+ * Indicates whether preemptible instances can be supplemented. If you set this parameter to true, when the scaling group receives a system message indicating that a preemptible instance is to be reclaimed, the scaling group attempts to create a new instance to replace this instance. Valid values:
2779
2783
  *
2780
2784
  * * `true`: enables the supplementation of preemptible instances.
2781
2785
  * * `false`: disables the supplementation of preemptible instances.
@@ -2818,7 +2822,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2818
2822
  systemDiskBurstingEnabled?: boolean;
2819
2823
  /**
2820
2824
  * @remarks
2821
- * The categories of the system disk for nodes. The system attempts to create system disks of a disk category with a lower priority if the disk category with a higher priority is unavailable. Valid values: Valid values:
2825
+ * The categories of the system disk for nodes. The system attempts to create system disks of a disk category with a lower priority if the disk category with a higher priority is unavailable. Valid values:
2822
2826
  *
2823
2827
  * * `cloud`: basic disk.
2824
2828
  * * `cloud_efficiency`: ultra disk.
@@ -2830,12 +2834,12 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2830
2834
  systemDiskCategories?: string[];
2831
2835
  /**
2832
2836
  * @remarks
2833
- * The category of the system disk for nodes. Valid values:
2837
+ * The category of the system disk. Valid values:
2834
2838
  *
2835
2839
  * * `cloud`: basic disk.
2836
2840
  * * `cloud_efficiency`: ultra disk.
2837
2841
  * * `cloud_ssd`: standard SSD.
2838
- * * `cloud_essd`: ESSD.
2842
+ * * `cloud_essd`: Enterprise ESSD (ESSD).
2839
2843
  * * `cloud_auto`: ESSD AutoPL disk.
2840
2844
  * * `cloud_essd_entry`: ESSD Entry disk.
2841
2845
  *
@@ -2847,7 +2851,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2847
2851
  systemDiskCategory?: string;
2848
2852
  /**
2849
2853
  * @remarks
2850
- * The encryption algorithm that is used to encrypt the system disk. Set the value to aes-256.
2854
+ * The encryption algorithm that is used to encrypt the system disk. The value is aes-256.
2851
2855
  *
2852
2856
  * @example
2853
2857
  * aes-256
@@ -2855,7 +2859,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2855
2859
  systemDiskEncryptAlgorithm?: string;
2856
2860
  /**
2857
2861
  * @remarks
2858
- * Specifies whether to encrypt the system disk. Valid values: true: encrypts the system disk. false: does not encrypt the system disk.
2862
+ * Specifies whether to encrypt the system disk. true: encrypts the system disk. false: does not encrypt the system disk.
2859
2863
  *
2860
2864
  * @example
2861
2865
  * false
@@ -2886,7 +2890,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2886
2890
  systemDiskPerformanceLevel?: string;
2887
2891
  /**
2888
2892
  * @remarks
2889
- * The preset read/write IOPS of the system disk. Valid values: 0 to min{50,000, 1,000 × Capacity - Baseline IOPS} Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}.
2893
+ * The preset IOPS of the system disk. Valid values: 0 to min{50,000, 1,000 × Capacity - Baseline IOPS}. Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}.
2890
2894
  *
2891
2895
  * This parameter is supported only when `SystemDiskCategory` is set to `cloud_auto`. For more information, see [ESSD AutoPL disks](https://help.aliyun.com/document_detail/368372.html).
2892
2896
  *
@@ -2906,9 +2910,9 @@ export class CreateClusterNodePoolRequestScalingGroup extends $dara.Model {
2906
2910
  systemDiskSize?: number;
2907
2911
  /**
2908
2912
  * @remarks
2909
- * The labels that you want to add only to ECS instances.
2913
+ * The tags that you want to add only to ECS instances.
2910
2914
  *
2911
- * The label key must be unique and cannot exceed 128 characters in length. The label key and value cannot start with aliyun or acs: or contain https:// or http://.
2915
+ * The tag key must be unique and cannot exceed 128 characters in length. The tag key and value cannot start with aliyun or acs: or contain https:// or http://.
2912
2916
  */
2913
2917
  tags?: CreateClusterNodePoolRequestScalingGroupTags[];
2914
2918
  /**
@@ -3092,8 +3096,32 @@ export class CreateClusterNodePoolRequestTeeConfig extends $dara.Model {
3092
3096
  }
3093
3097
 
3094
3098
  export class DeleteAlertContactResponseBodyResult extends $dara.Model {
3099
+ /**
3100
+ * @remarks
3101
+ * The deletion status.
3102
+ *
3103
+ * * true: The alert contact was deleted.
3104
+ * * false: The alert contact failed to be deleted.
3105
+ *
3106
+ * @example
3107
+ * true
3108
+ */
3095
3109
  status?: boolean;
3110
+ /**
3111
+ * @remarks
3112
+ * The error message returned if the call fails.
3113
+ *
3114
+ * @example
3115
+ * Delete contact resource failed.
3116
+ */
3096
3117
  msg?: string;
3118
+ /**
3119
+ * @remarks
3120
+ * An alert contact ID.
3121
+ *
3122
+ * @example
3123
+ * 12345
3124
+ */
3097
3125
  contactId?: string;
3098
3126
  static names(): { [key: string]: string } {
3099
3127
  return {
@@ -3147,8 +3175,32 @@ export class DeleteAlertContactResponseBody extends $dara.Model {
3147
3175
  }
3148
3176
 
3149
3177
  export class DeleteAlertContactGroupResponseBody extends $dara.Model {
3178
+ /**
3179
+ * @remarks
3180
+ * The deletion status.
3181
+ *
3182
+ * * true: The alert contact group was deleted.
3183
+ * * false: The alert contact group failed to be deleted.
3184
+ *
3185
+ * @example
3186
+ * true
3187
+ */
3150
3188
  status?: boolean;
3189
+ /**
3190
+ * @remarks
3191
+ * The error message returned if the call fails.
3192
+ *
3193
+ * @example
3194
+ * Delete contact group resource failed.
3195
+ */
3151
3196
  msg?: string;
3197
+ /**
3198
+ * @remarks
3199
+ * The alert contact group ID.
3200
+ *
3201
+ * @example
3202
+ * 12345
3203
+ */
3152
3204
  contactGroupId?: string;
3153
3205
  static names(): { [key: string]: string } {
3154
3206
  return {
@@ -4176,7 +4228,7 @@ export class DescribeClusterNodePoolDetailResponseBodyKubernetesConfig extends $
4176
4228
  nodeNameMode?: string;
4177
4229
  /**
4178
4230
  * @remarks
4179
- * The custom script to be executed before nodes in the node pool are initialized. For more information, see [Generate user-defined data](https://help.aliyun.com/document_detail/49121.html).
4231
+ * The user-defined script that is executed before nodes are initialized. For more information, see [Generate user-defined data](https://help.aliyun.com/document_detail/49121.html).
4180
4232
  *
4181
4233
  * @example
4182
4234
  * dGhpcyBpcyBhIGV4YW1wbGU
@@ -5725,7 +5777,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsKubernetesConfig exten
5725
5777
  runtimeVersion?: string;
5726
5778
  /**
5727
5779
  * @remarks
5728
- * The taints of the nodes in the node pool. Taints can be used together with tolerations to prevent pods from being scheduled to specific nodes. For more information, see [taint-and-toleration](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/).
5780
+ * The taints of the nodes in the node pool. Taints can be used together with tolerations to avoid scheduling pods to specified nodes. For more information, see [taint-and-toleration](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/).
5729
5781
  */
5730
5782
  taints?: Taint[];
5731
5783
  /**
@@ -6065,7 +6117,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsManagement extends $da
6065
6117
  export class DescribeClusterNodePoolsResponseBodyNodepoolsNodeConfig extends $dara.Model {
6066
6118
  /**
6067
6119
  * @remarks
6068
- * The configurations of the kubelet.
6120
+ * The parameter settings of the kubelet.
6069
6121
  */
6070
6122
  kubeletConfiguration?: KubeletConfig;
6071
6123
  static names(): { [key: string]: string } {
@@ -6300,9 +6352,12 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup extends $
6300
6352
  autoRenew?: boolean;
6301
6353
  /**
6302
6354
  * @remarks
6303
- * The auto-renewal duration. This parameter takes effect and is required only if `instance_charge_type` is set to `PrePaid`.
6355
+ * The auto-renewal period. Valid values:
6356
+ *
6357
+ * * Valid values when PeriodUnit is set to Week: 1, 2, and 3
6358
+ * * Valid values when PeriodUnit is set to Month: 1, 2, 3, 6, 12, 24, 36, 48, and 60
6304
6359
  *
6305
- * If you set `period_unit` to Month, the valid values of this parameter are 1, 2, 3, 6, and 12.
6360
+ * Default value: 1.
6306
6361
  *
6307
6362
  * @example
6308
6363
  * 0
@@ -6331,7 +6386,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup extends $
6331
6386
  compensateWithOnDemand?: boolean;
6332
6387
  /**
6333
6388
  * @remarks
6334
- * The configurations of the data disks that are mounted to the nodes in the node pool. The configurations include the disk type and disk size.
6389
+ * The configurations of the data disks that are mounted to the nodes in the node pool. The configurations include the disk category and disk size.
6335
6390
  */
6336
6391
  dataDisks?: DataDisk[];
6337
6392
  /**
@@ -6625,7 +6680,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup extends $
6625
6680
  systemDiskBurstingEnabled?: boolean;
6626
6681
  /**
6627
6682
  * @remarks
6628
- * The types of system disks. The system attempts to create system disks of a disk type with a lower priority if the disk type with a higher priority is unavailable. Valid values: Valid values: cloud (basic disk), cloud_efficiency (ultra disk), cloud_ssd (standard SSD), cloud_essd (Enterprise SSD).
6683
+ * The categories of system disks. The system creates system disks of a disk category with a lower priority if the disk category with a higher priority is unavailable. Valid values: cloud (basic disk), cloud_efficiency (ultra disk). cloud_ssd (standard SSD), cloud_essd (Enterprise SSD).
6629
6684
  */
6630
6685
  systemDiskCategories?: string[];
6631
6686
  /**
@@ -6641,7 +6696,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup extends $
6641
6696
  systemDiskCategory?: string;
6642
6697
  /**
6643
6698
  * @remarks
6644
- * The encryption algorithm that is used to encrypt the system disk. The value is aes-256.
6699
+ * The encryption algorithm that is used to encrypt the system disk. Set the value to aes-256.
6645
6700
  *
6646
6701
  * @example
6647
6702
  * aes-256
@@ -6696,7 +6751,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup extends $
6696
6751
  * @remarks
6697
6752
  * The labels that you want to add only to Elastic Compute Service (ECS) instances.
6698
6753
  *
6699
- * The tag key must be unique and cannot exceed 128 characters in length. The tag key and value must not start with aliyun or acs: or contain https:// or http://.
6754
+ * The key must be unique and cannot exceed 128 characters in length. The key and value must not start with aliyun or acs: or contain https:// or http://.
6700
6755
  */
6701
6756
  tags?: Tag[];
6702
6757
  /**
@@ -7013,7 +7068,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepools extends $dara.Model {
7013
7068
  interconnectMode?: string;
7014
7069
  /**
7015
7070
  * @remarks
7016
- * The configurations of the cluster.
7071
+ * The configurations of the cluster in which the node pool is deployed.
7017
7072
  */
7018
7073
  kubernetesConfig?: DescribeClusterNodePoolsResponseBodyNodepoolsKubernetesConfig;
7019
7074
  /**
@@ -7417,8 +7472,29 @@ export class DescribeClusterNodesResponseBodyPage extends $dara.Model {
7417
7472
  }
7418
7473
 
7419
7474
  export class DescribeClusterResourcesResponseBodyDependencies extends $dara.Model {
7475
+ /**
7476
+ * @remarks
7477
+ * The ID of the cluster to which the dependent resource is related.
7478
+ *
7479
+ * @example
7480
+ * cc5ee03f63e43425cb6f71f1a1756****
7481
+ */
7420
7482
  clusterId?: string;
7483
+ /**
7484
+ * @remarks
7485
+ * The dependent resource type.
7486
+ *
7487
+ * @example
7488
+ * ALIYUN::VPC::NatGateway
7489
+ */
7421
7490
  resourceType?: string;
7491
+ /**
7492
+ * @remarks
7493
+ * The dependent resource ID.
7494
+ *
7495
+ * @example
7496
+ * ngw-wz9sphwk42sdtjixo****
7497
+ */
7422
7498
  instanceId?: string;
7423
7499
  static names(): { [key: string]: string } {
7424
7500
  return {
@@ -7621,7 +7697,7 @@ export class DescribeClusterResourcesResponseBody extends $dara.Model {
7621
7697
  deleteBehavior?: DescribeClusterResourcesResponseBodyDeleteBehavior;
7622
7698
  /**
7623
7699
  * @remarks
7624
- * The resource creator. Valid values:
7700
+ * The type of the resource creator. Valid values:
7625
7701
  *
7626
7702
  * * user: The resource is created by the user.
7627
7703
  * * system: The resource is created by the ACK management system.
@@ -8224,7 +8300,7 @@ export class DescribeClustersForRegionResponseBodyClusters extends $dara.Model {
8224
8300
  nextVersion?: string;
8225
8301
  /**
8226
8302
  * @remarks
8227
- * The subtype of the cluster. Valid values:
8303
+ * The subtype of the clusters. Valid values:
8228
8304
  *
8229
8305
  * * Default: ACK managed clusters. ACK managed clusters include ACK Basic clusters and ACK Pro clusters.
8230
8306
  * * Edge: ACK Edge clusters. ACK Edge clusters include ACK Edge Basic clusters and ACK Edge Pro clusters.
@@ -8313,7 +8389,7 @@ export class DescribeClustersForRegionResponseBodyClusters extends $dara.Model {
8313
8389
  state?: string;
8314
8390
  /**
8315
8391
  * @remarks
8316
- * The list of tags.
8392
+ * The list of cluster tags.
8317
8393
  */
8318
8394
  tags?: Tag[];
8319
8395
  /**
@@ -8342,7 +8418,7 @@ export class DescribeClustersForRegionResponseBodyClusters extends $dara.Model {
8342
8418
  vpcId?: string;
8343
8419
  /**
8344
8420
  * @remarks
8345
- * The vSwitches for the control plane of the cluster.
8421
+ * The list of vSwitches on the control plane of the cluster.
8346
8422
  */
8347
8423
  vswitchIds?: string[];
8348
8424
  static names(): { [key: string]: string } {
@@ -8799,12 +8875,14 @@ export class DescribeClustersV1ResponseBodyClusters extends $dara.Model {
8799
8875
  * * `initial`: The cluster is being created.
8800
8876
  * * `failed`: The cluster failed to be created.
8801
8877
  * * `running`: The cluster is running.
8802
- * * `updating`: The cluster is being updated.
8803
- * * `updating_failed`: The cluster failed to be updated.
8804
- * * `scaling`: The cluster is being scaled.
8805
- * * `stopped`: The cluster is stopped.
8878
+ * * `upgrading`: The cluster is undergoing an upgrade.
8879
+ * * `updating`: Cluster specification changes are being applied.
8880
+ * * `removing`: Nodes are being removed from the node pool.
8881
+ * * `draining`: Node draining is in progress.
8882
+ * * `scaling`: Auto-scaling operation is in progress for the cluster.
8883
+ * * `stopped`: The cluster has stopped running.
8806
8884
  * * `deleting`: The cluster is being deleted.
8807
- * * `deleted`: The cluster is deleted.
8885
+ * * `deleted`: The cluster has been deleted.
8808
8886
  * * `delete_failed`: The cluster failed to be deleted.
8809
8887
  *
8810
8888
  * @example
@@ -10583,7 +10661,7 @@ export class DescribePolicyInstancesResponseBody extends $dara.Model {
10583
10661
  policyName?: string;
10584
10662
  /**
10585
10663
  * @remarks
10586
- * The type of policy.
10664
+ * The type of the policy.
10587
10665
  *
10588
10666
  * @example
10589
10667
  * k8s-general
@@ -10638,7 +10716,7 @@ export class DescribePolicyInstancesResponseBody extends $dara.Model {
10638
10716
  policyAction?: string;
10639
10717
  /**
10640
10718
  * @remarks
10641
- * Creation time (deprecated, do not use).
10719
+ * The creation time of the instance. This parameter is deprecated.
10642
10720
  *
10643
10721
  * @example
10644
10722
  * 2024-10-29T18:09:12+08:00
@@ -10648,7 +10726,7 @@ export class DescribePolicyInstancesResponseBody extends $dara.Model {
10648
10726
  created?: string;
10649
10727
  /**
10650
10728
  * @remarks
10651
- * Update time (deprecated, do not use).
10729
+ * The update time of the instance. This parameter is deprecated.
10652
10730
  *
10653
10731
  * @example
10654
10732
  * 2024-10-29T18:09:12+08:00
@@ -10658,7 +10736,7 @@ export class DescribePolicyInstancesResponseBody extends $dara.Model {
10658
10736
  updated?: string;
10659
10737
  /**
10660
10738
  * @remarks
10661
- * Resource ID (deprecated, do not use).
10739
+ * The ID of the resource. This parameter is deprecated.
10662
10740
  *
10663
10741
  * @example
10664
10742
  * 123456***
@@ -10668,7 +10746,7 @@ export class DescribePolicyInstancesResponseBody extends $dara.Model {
10668
10746
  resourceId?: string;
10669
10747
  /**
10670
10748
  * @remarks
10671
- * Violation count processing in the cluster (deprecated, do not use).
10749
+ * The number of violations processed in the cluster. This parameter is deprecated.
10672
10750
  *
10673
10751
  * @example
10674
10752
  * 0
@@ -10678,7 +10756,7 @@ export class DescribePolicyInstancesResponseBody extends $dara.Model {
10678
10756
  totalViolations?: number;
10679
10757
  /**
10680
10758
  * @remarks
10681
- * Deletion status (deprecated, do not use).
10759
+ * The status of the deletion. This parameter is deprecated.
10682
10760
  *
10683
10761
  * @example
10684
10762
  * 0
@@ -12090,14 +12168,20 @@ export class GrantPermissionsRequestBody extends $dara.Model {
12090
12168
  namespace?: string;
12091
12169
  /**
12092
12170
  * @remarks
12093
- * The predefined role. Valid values:
12171
+ * The predefined role name. Valid values:
12094
12172
  *
12095
12173
  * * `admin`: administrator
12174
+ * * `admin-view`: read-only administrator
12096
12175
  * * `ops`: O\\&M engineer
12097
12176
  * * `dev`: developer
12098
12177
  * * `restricted`: restricted user
12099
12178
  * * Custom role
12100
12179
  *
12180
+ * Note:
12181
+ *
12182
+ * * You cannot grant namespace-level permissions to the `admin`, `admin-view`, and `ops` roles.
12183
+ * * You cannot grant all cluster-level permissions to the `admin-view` role.
12184
+ *
12101
12185
  * This parameter is required.
12102
12186
  *
12103
12187
  * @example
@@ -12109,7 +12193,7 @@ export class GrantPermissionsRequestBody extends $dara.Model {
12109
12193
  * The authorization type. Valid values:
12110
12194
  *
12111
12195
  * * `cluster`: authorizes the RAM user or RAM role to manage the specified clusters.
12112
- * * `namespace`: authorizes the RAM user or RAM role to manage the specified namepsaces.
12196
+ * * `namespace`: authorizes the RAM user or RAM role to manage the specified namespaces.
12113
12197
  * * `all-clusters`: authorizes the RAM user or RAM role to manage all clusters.
12114
12198
  *
12115
12199
  * This parameter is required.
@@ -13010,12 +13094,12 @@ export class ModifyClusterRequestApiServerCustomCertSans extends $dara.Model {
13010
13094
  export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
13011
13095
  /**
13012
13096
  * @remarks
13013
- * Specifies whether to enable auto-renewal for the instance. This parameter takes effect only when `charge_type` is set to `PrePaid`. Valid values:
13097
+ * Specifies whether to enable auto-renewal for control plane nodes. This parameter takes effect only when `charge_type` is set to `PrePaid`. Valid values:
13014
13098
  *
13015
13099
  * * `true`: enables auto-renewal.
13016
13100
  * * `false`: disables auto-renewal.
13017
13101
  *
13018
- * Default value: `false`.
13102
+ * Default value: `false`
13019
13103
  *
13020
13104
  * @example
13021
13105
  * true
@@ -13023,7 +13107,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
13023
13107
  autoRenew?: boolean;
13024
13108
  /**
13025
13109
  * @remarks
13026
- * The auto-renewal period of the instance. Valid values: 1, 2, 3, 6, and 12.
13110
+ * The auto-renewal period of control plane nodes. Valid values: 1, 2, 3, 6, and 12.
13027
13111
  *
13028
13112
  * Default value: 1.
13029
13113
  *
@@ -13033,7 +13117,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
13033
13117
  autoRenewPeriod?: number;
13034
13118
  /**
13035
13119
  * @remarks
13036
- * The billing method of the instance. Valid values:
13120
+ * The billing method of control plane nodes. Valid values:
13037
13121
  *
13038
13122
  * * `PrePaid`: subscription.
13039
13123
  * * `PostPaid`: pay-as-you-go.
@@ -13097,7 +13181,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
13097
13181
  imageType?: string;
13098
13182
  /**
13099
13183
  * @remarks
13100
- * The instance type. For more information, see [Overview of ECS instance families](https://help.aliyun.com/document_detail/25378.html).
13184
+ * The type of instance. For more information, see [Overview of ECS instance families](https://help.aliyun.com/document_detail/25378.html).
13101
13185
  */
13102
13186
  instanceTypes?: string[];
13103
13187
  /**
@@ -13136,9 +13220,9 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
13136
13220
  period?: number;
13137
13221
  /**
13138
13222
  * @remarks
13139
- * The billing cycle of the instance. This parameter takes effect only when `instance_charge_type` is set to `PrePaid`.
13223
+ * The billing cycle of control plane nodes. This parameter takes effect only when `instance_charge_type` is set to `PrePaid`.
13140
13224
  *
13141
- * Valid value: `Month`.
13225
+ * Set the value to `Month`.
13142
13226
  *
13143
13227
  * @example
13144
13228
  * Month
@@ -13163,7 +13247,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
13163
13247
  * * `true`: enables Alibaba Cloud Linux Security Hardening.
13164
13248
  * * `false`: disables Alibaba Cloud Linux Security Hardening.
13165
13249
  *
13166
- * Default value: `false`.
13250
+ * Default value: `false`
13167
13251
  *
13168
13252
  * @example
13169
13253
  * true
@@ -13207,12 +13291,12 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
13207
13291
  systemDiskBurstingEnabled?: boolean;
13208
13292
  /**
13209
13293
  * @remarks
13210
- * The type of the node system disk. Valid values:
13294
+ * The category of the system disk for nodes. Valid values:
13211
13295
  *
13212
13296
  * * `cloud`: basic disk.
13213
13297
  * * `cloud_efficiency`: ultra disk.
13214
13298
  * * `cloud_ssd`: standard SSD.
13215
- * * `cloud_essd`: enhanced SSD (ESSD).
13299
+ * * `cloud_essd`: Enterprise ESSD (ESSD).
13216
13300
  * * `cloud_auto`: ESSD AutoPL disk.
13217
13301
  * * `cloud_essd_entry`: ESSD Entry disk.
13218
13302
  *
@@ -13230,7 +13314,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
13230
13314
  systemDiskPerformanceLevel?: string;
13231
13315
  /**
13232
13316
  * @remarks
13233
- * The preset read/write input/output operations per second (IOPS) of the system disk. Valid values: 0 to min{50,000, 1,000 × Capacity - Baseline IOPS} Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}.
13317
+ * The preset read/write input/output operations per second (IOPS) of the system disk. Valid values: 0 to min{50,000, 1,000 × Capacity - Baseline IOPS}. Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}.
13234
13318
  *
13235
13319
  * This parameter is effective only when `system_disk_category` is set to `cloud_auto`. For more information, see [ESSD AutoPL disks](https://help.aliyun.com/document_detail/368372.html).
13236
13320
  *
@@ -13327,7 +13411,7 @@ export class ModifyClusterRequestControlPlaneConfig extends $dara.Model {
13327
13411
  export class ModifyClusterRequestOperationPolicyClusterAutoUpgrade extends $dara.Model {
13328
13412
  /**
13329
13413
  * @remarks
13330
- * The frequency of automatic cluster updates. For more information, see [Update frequency](https://help.aliyun.com/document_detail/2712866.html).
13414
+ * The frequency of auto cluster update. For more information, see [Update frequency](https://help.aliyun.com/document_detail/2712866.html).
13331
13415
  *
13332
13416
  * Valid values:
13333
13417
  *
@@ -13523,7 +13607,7 @@ export class ModifyClusterConfigurationRequestCustomizeConfig extends $dara.Mode
13523
13607
  export class ModifyClusterNodePoolRequestAutoScaling extends $dara.Model {
13524
13608
  /**
13525
13609
  * @remarks
13526
- * The maximum bandwidth of the elastic IP address (EIP).
13610
+ * The maximum bandwidth of the EIP.
13527
13611
  *
13528
13612
  * @example
13529
13613
  * 5
@@ -13535,7 +13619,7 @@ export class ModifyClusterNodePoolRequestAutoScaling extends $dara.Model {
13535
13619
  * @remarks
13536
13620
  * The billing method of the EIP. Valid values:
13537
13621
  *
13538
- * * `PayByBandwidth`: pay-by-bandwidth.
13622
+ * * `PayByBandwidth`: pay-by-bandwidth
13539
13623
  * * `PayByTraffic`: pay-by-data-transfer
13540
13624
  *
13541
13625
  * Default value: `PayByBandwidth`.
@@ -13553,7 +13637,7 @@ export class ModifyClusterNodePoolRequestAutoScaling extends $dara.Model {
13553
13637
  * * `true`: enables auto scaling for the node pool.
13554
13638
  * * `false`: disables auto scaling for the node pool. If you set this parameter to false, other parameters in `auto_scaling` do not take effect.
13555
13639
  *
13556
- * Default value: `false`.
13640
+ * Default value: `false`
13557
13641
  *
13558
13642
  * @example
13559
13643
  * true
@@ -13576,7 +13660,7 @@ export class ModifyClusterNodePoolRequestAutoScaling extends $dara.Model {
13576
13660
  isBondEip?: boolean;
13577
13661
  /**
13578
13662
  * @remarks
13579
- * The maximum number of Elastic Compute Service (ECS) instances that can be created in the node pool.
13663
+ * The maximum number of instances.
13580
13664
  *
13581
13665
  * @example
13582
13666
  * 10
@@ -13584,7 +13668,7 @@ export class ModifyClusterNodePoolRequestAutoScaling extends $dara.Model {
13584
13668
  maxInstances?: number;
13585
13669
  /**
13586
13670
  * @remarks
13587
- * The minimum number of ECS instances that must be kept in the node pool.
13671
+ * The minimum number of instances.
13588
13672
  *
13589
13673
  * @example
13590
13674
  * 2
@@ -13648,7 +13732,7 @@ export class ModifyClusterNodePoolRequestKubernetesConfig extends $dara.Model {
13648
13732
  * * `true`: installs the CloudMonitor agent on ECS nodes.
13649
13733
  * * `false`: does not install the CloudMonitor agent on ECS nodes.
13650
13734
  *
13651
- * Default value: `false`.
13735
+ * Default value: `false`
13652
13736
  *
13653
13737
  * @example
13654
13738
  * true
@@ -13656,10 +13740,10 @@ export class ModifyClusterNodePoolRequestKubernetesConfig extends $dara.Model {
13656
13740
  cmsEnabled?: boolean;
13657
13741
  /**
13658
13742
  * @remarks
13659
- * The CPU management policy of nodes. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
13743
+ * The CPU management policy of nodes in the node pool. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
13660
13744
  *
13661
- * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
13662
- * * `none`: specifies that the default CPU affinity is used.
13745
+ * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity
13746
+ * * `none`: specifies that the default CPU affinity is used
13663
13747
  *
13664
13748
  * Default value: `none`.
13665
13749
  *
@@ -13701,7 +13785,7 @@ export class ModifyClusterNodePoolRequestKubernetesConfig extends $dara.Model {
13701
13785
  runtimeVersion?: string;
13702
13786
  /**
13703
13787
  * @remarks
13704
- * The configuration of a node taint.
13788
+ * The configurations of node taints.
13705
13789
  */
13706
13790
  taints?: Taint[];
13707
13791
  /**
@@ -13812,8 +13896,8 @@ export class ModifyClusterNodePoolRequestManagementAutoUpgradePolicy extends $da
13812
13896
  * @remarks
13813
13897
  * Specifies whether ACK is allowed to automatically update the operating system. This parameter takes effect only when you specify `auto_upgrade=true`. Valid values:
13814
13898
  *
13815
- * * `true`: allows auto update of the OS.
13816
- * * `false`: does not allow auto update of the OS.
13899
+ * * `true`: yes.
13900
+ * * `false`: no.
13817
13901
  *
13818
13902
  * Default value: `false`.
13819
13903
  */
@@ -13822,8 +13906,8 @@ export class ModifyClusterNodePoolRequestManagementAutoUpgradePolicy extends $da
13822
13906
  * @remarks
13823
13907
  * Specifies whether ACK is allowed to automatically update the runtime. This parameter takes effect only when you specify `auto_upgrade=true`. Valid values:
13824
13908
  *
13825
- * * `true`: allows auto update of the runtime.
13826
- * * `false`: does not allow auto update of the runtime.
13909
+ * * `true`: yes.
13910
+ * * `false`: no.
13827
13911
  *
13828
13912
  * Default value: `false`.
13829
13913
  */
@@ -13977,7 +14061,7 @@ export class ModifyClusterNodePoolRequestManagement extends $dara.Model {
13977
14061
  * * `true`: enables auto repair.
13978
14062
  * * `false`: disables auto repair.
13979
14063
  *
13980
- * Default value: `true`
14064
+ * Default value: `true`.
13981
14065
  *
13982
14066
  * @example
13983
14067
  * true
@@ -13990,7 +14074,7 @@ export class ModifyClusterNodePoolRequestManagement extends $dara.Model {
13990
14074
  autoRepairPolicy?: ModifyClusterNodePoolRequestManagementAutoRepairPolicy;
13991
14075
  /**
13992
14076
  * @remarks
13993
- * Specifies whether to enable auto update. Valid values:
14077
+ * Indicates whether auto update is enabled. Valid values:
13994
14078
  *
13995
14079
  * * `true`: enables auto update.
13996
14080
  * * `false`: disables auto update.
@@ -14027,7 +14111,7 @@ export class ModifyClusterNodePoolRequestManagement extends $dara.Model {
14027
14111
  * * `true`: enables the managed node pool feature.
14028
14112
  * * `false`: disables the managed node pool feature. Other parameters in this section take effect only when `enable=true` is specified.
14029
14113
  *
14030
- * Default value: `false`.
14114
+ * Default value: `false`
14031
14115
  *
14032
14116
  * @example
14033
14117
  * true
@@ -14090,7 +14174,7 @@ export class ModifyClusterNodePoolRequestManagement extends $dara.Model {
14090
14174
  export class ModifyClusterNodePoolRequestNodepoolInfo extends $dara.Model {
14091
14175
  /**
14092
14176
  * @remarks
14093
- * The name of the node pool.
14177
+ * The name of a node pool.
14094
14178
  *
14095
14179
  * The name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). It cannot start with a hyphen (-).
14096
14180
  *
@@ -14100,7 +14184,7 @@ export class ModifyClusterNodePoolRequestNodepoolInfo extends $dara.Model {
14100
14184
  name?: string;
14101
14185
  /**
14102
14186
  * @remarks
14103
- * The resource group ID.
14187
+ * The resource group ID to which the instance belongs.
14104
14188
  *
14105
14189
  * @example
14106
14190
  * rg-acfmyvw3wjm****
@@ -14142,8 +14226,8 @@ export class ModifyClusterNodePoolRequestScalingGroupPrivatePoolOptions extends
14142
14226
  * @remarks
14143
14227
  * The type of private node pool. This parameter specifies the type of private node pool that you want to use to create instances. A private pool is generated when an elasticity assurance or a capacity reservation takes effect. The system selects a private pool to start instances. Valid values:
14144
14228
  *
14145
- * * `Open`: open private pool. The system selects an open private pool to start instances. If no matching open private pools are available, the resources in the public pool are used.
14146
- * * `Target`: private node pool. The system uses the resources of the specified private pool to start instances. If the specified private pool is unavailable, instances cannot be started.
14229
+ * * `Open`: uses an open private pool. The system selects an open private pool to start instances. If no matching open private pools are available, the resources in the public pool are used.
14230
+ * * `Target`: uses a specified private pool. The system uses the resources of the specified private pool to start instances. If the specified private pool is unavailable, instances cannot be started.
14147
14231
  * * `None`: does not use private pools. The resources of private node pools are not used to launch instances.
14148
14232
  *
14149
14233
  * @example
@@ -14220,10 +14304,10 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $dara.Model {
14220
14304
  * @remarks
14221
14305
  * Specifies whether to enable auto-renewal for the nodes in the node pool. This parameter takes effect only when you set `instance_charge_type` to `PrePaid`. Valid values:
14222
14306
  *
14223
- * * `true`: enables auto-renewal.
14307
+ * * `true`: enables auto-renewal
14224
14308
  * * `false`: disables auto-renewal.
14225
14309
  *
14226
- * Default value: `false`.
14310
+ * Default value: `false`
14227
14311
  *
14228
14312
  * @example
14229
14313
  * true
@@ -14247,7 +14331,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $dara.Model {
14247
14331
  * Specifies whether to automatically create pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created due to reasons such as the cost or insufficient inventory. This parameter takes effect only when you set `multi_az_policy` to `COST_OPTIMIZED`. Valid values:
14248
14332
  *
14249
14333
  * * `true`: automatically creates pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created
14250
- * * `false`: does not create pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created.
14334
+ * * `false`
14251
14335
  *
14252
14336
  * @example
14253
14337
  * true
@@ -14276,7 +14360,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $dara.Model {
14276
14360
  imageId?: string;
14277
14361
  /**
14278
14362
  * @remarks
14279
- * The type of OS distribution that you want to use. To specify the node OS, we recommend that you use this parameter. Valid values:
14363
+ * The type of operating system distribution that you want to use. We recommend that you use this parameter to specify the node operating system. Valid values:
14280
14364
  *
14281
14365
  * * `AliyunLinux`: Alibaba Cloud Linux 2.
14282
14366
  * * `AliyunLinuxSecurity`: Alibaba Cloud Linux 2 (UEFI).
@@ -14287,6 +14371,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $dara.Model {
14287
14371
  * * `Windows`: Windows.
14288
14372
  * * `WindowsCore`: Windows Core.
14289
14373
  * * `ContainerOS`: ContainerOS.
14374
+ * * `AliyunLinux3ContainerOptimized`: Alibaba Cloud Linux 3 Container-optimized image.
14290
14375
  *
14291
14376
  * @example
14292
14377
  * AliyunLinux
@@ -14296,10 +14381,10 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $dara.Model {
14296
14381
  * @remarks
14297
14382
  * The billing method of nodes in the node pool. Valid values:
14298
14383
  *
14299
- * * `PrePaid`: subscription.
14300
- * * `PostPaid`: pay-as-you-go.
14384
+ * * `PrePaid`: subscription
14385
+ * * `PostPaid`: pay-as-you-go
14301
14386
  *
14302
- * Default value: `PostPaid`.
14387
+ * Default value: `PostPaid`
14303
14388
  *
14304
14389
  * @example
14305
14390
  * PostPaid
@@ -14319,7 +14404,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $dara.Model {
14319
14404
  * @remarks
14320
14405
  * The billing method of the public IP address. Valid values:
14321
14406
  *
14322
- * * `PayByBandwidth`: pay-by-bandwidth.
14407
+ * * `PayByBandwidth`: pay-by-bandwidth
14323
14408
  * * `PayByTraffic`: pay-by-data-transfer
14324
14409
  *
14325
14410
  * @example
@@ -14390,7 +14475,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $dara.Model {
14390
14475
  * @remarks
14391
14476
  * The subscription duration of the nodes in the node pool. This parameter takes effect and is required only when you set `instance_charge_type` to `PrePaid`.
14392
14477
  *
14393
- * If `PeriodUnit=Month` is specified, the valid values are 1, 2, 3, 6, 12, 24, 36, 48, and 60.
14478
+ * Valid values if `period_unit` is set to Month: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
14394
14479
  *
14395
14480
  * @example
14396
14481
  * 1
@@ -14454,7 +14539,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $dara.Model {
14454
14539
  spotInstancePools?: number;
14455
14540
  /**
14456
14541
  * @remarks
14457
- * Specifies whether to supplement preemptible instances. If the supplementation of preemptible instances is enabled, when the scaling group receives a system message that a preemptible instance is to be reclaimed, the scaling group attempts to create a new instance to replace this instance. Valid values:
14542
+ * Indicates whether preemptible instances can be supplemented. If the supplementation of preemptible instances is enabled, when the scaling group receives a system message that a preemptible instance is to be reclaimed, the scaling group attempts to create a new instance to replace this instance. Valid values:
14458
14543
  *
14459
14544
  * * `true`: supplements preemptible instances.
14460
14545
  * * `false`: does not supplement preemptible instances.
@@ -14465,7 +14550,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $dara.Model {
14465
14550
  spotInstanceRemedy?: boolean;
14466
14551
  /**
14467
14552
  * @remarks
14468
- * The instance type of preemptible instance and the price cap for the instance type.
14553
+ * The bid configurations of preemptible instances.
14469
14554
  */
14470
14555
  spotPriceLimit?: ModifyClusterNodePoolRequestScalingGroupSpotPriceLimit[];
14471
14556
  /**
@@ -14492,17 +14577,17 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $dara.Model {
14492
14577
  systemDiskBurstingEnabled?: boolean;
14493
14578
  /**
14494
14579
  * @remarks
14495
- * The system disk types. The system attempts to create system disks of a disk type with a lower priority if the disk type with a higher priority is unavailable. Valid values: cloud: disk. cloud_efficiency (ultra disk). cloud_ssd: standard SSD. cloud_essd: Enterprise SSD (ESSD).
14580
+ * The system disk types. The system attempts to create system disks of a disk type with a lower priority if the disk type with a higher priority is unavailable. Valid values: cloud: disk. cloud_efficiency: Ultra disk. cloud_ssd: Standard SSD. cloud_essd: Enterprise SSD (ESSD).
14496
14581
  */
14497
14582
  systemDiskCategories?: string[];
14498
14583
  /**
14499
14584
  * @remarks
14500
14585
  * The type of system disk. Valid values:
14501
14586
  *
14502
- * * `cloud_efficiency`: ultra disk.
14503
- * * `cloud_ssd`: standard SSD.
14587
+ * * `cloud_efficiency`: ultra disk
14588
+ * * `cloud_ssd`: standard SSD
14504
14589
  *
14505
- * Default value: `cloud_ssd`.
14590
+ * Default value: `cloud_ssd`
14506
14591
  *
14507
14592
  * @example
14508
14593
  * cloud_efficiency
@@ -14518,7 +14603,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $dara.Model {
14518
14603
  systemDiskEncryptAlgorithm?: string;
14519
14604
  /**
14520
14605
  * @remarks
14521
- * Specifies whether to encrypt the system disk. Valid values: true: encrypts the system disk. false: does not encrypt the system disk.
14606
+ * Indicates whether the system disk is encrypted. Valid values: true false: does not encrypt the system disk.
14522
14607
  *
14523
14608
  * @example
14524
14609
  * false
@@ -14706,7 +14791,7 @@ export class ModifyClusterNodePoolRequestTeeConfig extends $dara.Model {
14706
14791
  * * `true`: enables confidential computing for the cluster.
14707
14792
  * * `false`: disables confidential computing for the cluster.
14708
14793
  *
14709
- * Default value: `false`.
14794
+ * Default value: `false`
14710
14795
  *
14711
14796
  * @example
14712
14797
  * false
@@ -14736,7 +14821,7 @@ export class ModifyClusterNodePoolRequestTeeConfig extends $dara.Model {
14736
14821
  export class ModifyNodePoolNodeConfigRequestOsConfig extends $dara.Model {
14737
14822
  /**
14738
14823
  * @remarks
14739
- * The sysctl configuration.
14824
+ * Configuration for sysctl kernel parameters.
14740
14825
  */
14741
14826
  sysctl?: { [key: string]: any };
14742
14827
  static names(): { [key: string]: string } {
@@ -14796,12 +14881,12 @@ export class ModifyNodePoolNodeConfigRequestRollingPolicy extends $dara.Model {
14796
14881
  export class RepairClusterNodePoolRequestOperations extends $dara.Model {
14797
14882
  /**
14798
14883
  * @remarks
14799
- * List of repair operation parameters.
14884
+ * The parameters of a repair operation.
14800
14885
  */
14801
14886
  args?: string[];
14802
14887
  /**
14803
14888
  * @remarks
14804
- * Repair operation ID.
14889
+ * The ID of a repair operation.
14805
14890
  *
14806
14891
  * @example
14807
14892
  * remove.containerdContainer
@@ -15061,14 +15146,20 @@ export class UpdateUserPermissionsRequestBody extends $dara.Model {
15061
15146
  namespace?: string;
15062
15147
  /**
15063
15148
  * @remarks
15064
- * The predefined role. Valid values:
15149
+ * The predefined role name. Valid values:
15065
15150
  *
15066
15151
  * * `admin`: administrator
15152
+ * * `admin-view`: read-only administrator
15067
15153
  * * `ops`: O\\&M engineer
15068
15154
  * * `dev`: developer
15069
15155
  * * `restricted`: restricted user
15070
15156
  * * Custom role
15071
15157
  *
15158
+ * Note:
15159
+ *
15160
+ * * You cannot grant **namespace-level** permissions to the `admin`, `admin-view`, and `ops` roles.
15161
+ * * You cannot grant **all cluster-level** permissions to the `admin-view` role.
15162
+ *
15072
15163
  * @example
15073
15164
  * ops
15074
15165
  */
@@ -15078,7 +15169,7 @@ export class UpdateUserPermissionsRequestBody extends $dara.Model {
15078
15169
  * The authorization type. Valid values:
15079
15170
  *
15080
15171
  * * `cluster`: authorizes the RAM user or RAM role to manage the specified clusters.
15081
- * * `namespace`: authorizes the RAM user or RAM role to manage the specified namepsaces.
15172
+ * * `namespace`: authorizes the RAM user or RAM role to manage the specified namespaces.
15082
15173
  * * `all-clusters`: authorizes the RAM user or RAM role to manage all clusters.
15083
15174
  *
15084
15175
  * @example
@@ -15119,7 +15210,7 @@ export class UpdateUserPermissionsRequestBody extends $dara.Model {
15119
15210
  export class UpgradeClusterRequestRollingPolicy extends $dara.Model {
15120
15211
  /**
15121
15212
  * @remarks
15122
- * The maximum size of each batch.
15213
+ * The maximum number of nodes concurrently upgraded per batch.
15123
15214
  *
15124
15215
  * @example
15125
15216
  * 3
@@ -17239,7 +17330,7 @@ export class CleanUserPermissionsResponse extends $dara.Model {
17239
17330
  export class CreateAutoscalingConfigRequest extends $dara.Model {
17240
17331
  /**
17241
17332
  * @remarks
17242
- * The waiting time before the auto scaling feature performs a scale-in activity. It is an interval between the time when the scale-in threshold is reached and the time when the scale-in activity (reduce the number of pods) starts. Unit: minutes. Default value: 10.
17333
+ * The waiting time before the auto scaling feature performs a scale-in activity. It is an interval between the time when the scale-in threshold is reached and the time when the scale-in activity (reducing the number of pods) starts. Unit: minutes. Default value: 10.
17243
17334
  *
17244
17335
  * @example
17245
17336
  * 10 m
@@ -17533,19 +17624,19 @@ export class CreateAutoscalingConfigResponse extends $dara.Model {
17533
17624
  export class CreateClusterRequest extends $dara.Model {
17534
17625
  /**
17535
17626
  * @remarks
17536
- * The ACL rule of the SLB instance associated with the API server if the cluster is a registered cluster.
17627
+ * The network access control list (ACL) rule of the SLB instance associated with the API server if the cluster is a registered cluster.
17537
17628
  */
17538
17629
  accessControlList?: string[];
17539
17630
  /**
17540
17631
  * @remarks
17541
- * The components that you want to install in the cluster. When you create a cluster, you can specify `addons` to install specific components.
17632
+ * The components that you want to install in the cluster. When you create a cluster, you can configure the `addons` parameter to specify the components that you want to install.
17542
17633
  *
17543
17634
  * **Network plug-in**: required. The Flannel and Terway plug-ins are supported. Select one of the plug-ins for the cluster.
17544
17635
  *
17545
- * * Specify the Flannel plug-in in the following format: [{"name":"flannel","config":""}].
17546
- * * If you want to use the Terway component, specify the value in the [{"Name": "terway-eniip","Config": ""}] format.
17636
+ * * If you want to use the Terway component, specify the network plug-in in the [{"name":"flannel","config":""}] format.
17637
+ * * If you want to use the Terway component, specify the value network plug-in in the [{"name": "terway-eniip","Config": ""}] format.
17547
17638
  *
17548
- * **Volume plug-in**: optional. Only the `CSI` plug-in is supported.
17639
+ * **Volume plug-in**: optional. Only the `Container Storage Interface (CSI)` plug-in is supported.
17549
17640
  *
17550
17641
  * Specify the `CSI` plug-in in the following format: [{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}].
17551
17642
  *
@@ -17554,23 +17645,23 @@ export class CreateClusterRequest extends $dara.Model {
17554
17645
  * * Specify an existing `Simple Log Service project` in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}].
17555
17646
  * * To create a `Simple Log Service project`, specify the component in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true"}"}].
17556
17647
  *
17557
- * **Ingress controller**`: optional. By default, the nginx-ingress-controller component is installed in ACK dedicated clusters.`
17648
+ * **Ingress controller**: optional. By default, the `nginx-ingress-controller` component is installed in ACK dedicated clusters.
17558
17649
  *
17559
17650
  * * To install nginx-ingress-controller and enable Internet access, specify the Ingress controller in the following format: [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}].
17560
- * * To disable the automatic installation of nginx-ingress-controller, specify the component in the following format: [{"name": "nginx-ingress-controller","config": "","disabled": true}].
17651
+ * * To disable the automatic installation of nginx-ingress-controller, specify the Ingress controller in the following format: [{"name": "nginx-ingress-controller","config": "","disabled": true}].
17561
17652
  *
17562
17653
  * **Event center**: optional. By default, the event center feature is enabled.
17563
17654
  *
17564
17655
  * You can use ACK event centers to store and query events and configure alerts. You can use the Logstores that are associated with ACK event centers free of charge within 90 days. For more information, see [Create and use an event center](https://help.aliyun.com/document_detail/150476.html).
17565
17656
  *
17566
- * Enable the ack-node-problem-detector component in the following format: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}].
17657
+ * To enable the event center feature, specify the event center component in the following format: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}].
17567
17658
  */
17568
17659
  addons?: Addon[];
17569
17660
  /**
17570
17661
  * @remarks
17571
- * Provides identities for pods when pods communicate with the `API server` of the cluster. `api-audiences` are used by the `API server` to check whether the `tokens` of requests are legitimate.`` Separate multiple values with commas (,).``
17662
+ * Service accounts provide identities for pods when pods communicate with the `API server` of the cluster. The `api-audiences` parameter validates `tokens` and is used by the `API server` to check whether the `tokens` of requests are valid. Separate multiple values with commas (,).``
17572
17663
  *
17573
- * For more information about `ServiceAccount`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
17664
+ * For more information about `service accounts`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
17574
17665
  *
17575
17666
  * @example
17576
17667
  * kubernetes.default.svc
@@ -17578,14 +17669,14 @@ export class CreateClusterRequest extends $dara.Model {
17578
17669
  apiAudiences?: string;
17579
17670
  /**
17580
17671
  * @remarks
17581
- * **This parameter is deprecated.**
17672
+ * [**Deprecated**]
17582
17673
  *
17583
17674
  * Specifies whether to enable auto-renewal. This parameter takes effect only when `charge_type` is set to `PrePaid`. Valid values:
17584
17675
  *
17585
17676
  * * `true`: enables auto-renewal.
17586
- * * `false`: disables auto-renewal
17677
+ * * `false`: disables auto-renewal.
17587
17678
  *
17588
- * Default value: `false`
17679
+ * Default value: `false`.
17589
17680
  *
17590
17681
  * This parameter was changed on October 15, 2024. For more information, see [Announcement on changes to the parameter behavior of the CreateCluster operation](https://help.aliyun.com/document_detail/2849194.html).
17591
17682
  *
@@ -17597,7 +17688,7 @@ export class CreateClusterRequest extends $dara.Model {
17597
17688
  autoRenew?: boolean;
17598
17689
  /**
17599
17690
  * @remarks
17600
- * **This parameter is deprecated.**
17691
+ * [**Deprecated**]
17601
17692
  *
17602
17693
  * The auto-renewal duration. This parameter takes effect only if charge_type is set to PrePaid and auto_renew is set to true. If you set `period_unit` to Month, the valid values of auto_renew_period are 1, 2, 3, 6, and 12.
17603
17694
  *
@@ -17613,16 +17704,18 @@ export class CreateClusterRequest extends $dara.Model {
17613
17704
  autoRenewPeriod?: number;
17614
17705
  /**
17615
17706
  * @remarks
17616
- * The billing method of the Classic Load Balancer (CLB) instance that is used by the API server. Default value: PostPaid. Valid values:
17707
+ * [**Deprecated**]
17708
+ *
17709
+ * The billing method of the CLB instance that is used by the API server. Default value: PostPaid. Valid values:
17617
17710
  *
17618
- * * PostPaid: pay-as-you-go
17619
- * * PrePaid: subscription. The newly created billing method for the CLB instance is not supported.
17711
+ * * PostPaid: pay-as-you-go.
17712
+ * * PrePaid: subscription. This billing method is not supported by newly created CLB instances. Existing CLB instances are not affected.
17620
17713
  *
17621
17714
  * >
17622
17715
  *
17623
17716
  * * This parameter was changed on October 15, 2024. For more information, see [Announcement on changes to the parameter behavior of the CreateCluster operation](https://help.aliyun.com/document_detail/2849194.html).
17624
17717
  *
17625
- * * Starting from December 1, 2024, new CLB instances no longer support the subscription billing method and will be charged for the instances.
17718
+ * * Starting from December 1, 2024, newly created CLB instances no longer support the subscription billing method, and an instance fee will be charged for newly created CLB instances
17626
17719
  *
17627
17720
  * For more information, see [CLB billing adjustments](https://help.aliyun.com/document_detail/2839797.html).
17628
17721
  *
@@ -17634,7 +17727,7 @@ export class CreateClusterRequest extends $dara.Model {
17634
17727
  chargeType?: string;
17635
17728
  /**
17636
17729
  * @remarks
17637
- * This parameter is deprecated. Use security_hardening_os instead.
17730
+ * [Deprecated] When you configure the control plane, use the `security_hardening_os` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `security_hardening_os` parameter of the `scaling_group` field in the `nodepool` section instead.
17638
17731
  *
17639
17732
  * @example
17640
17733
  * false
@@ -17644,12 +17737,14 @@ export class CreateClusterRequest extends $dara.Model {
17644
17737
  cisEnabled?: boolean;
17645
17738
  /**
17646
17739
  * @remarks
17740
+ * [**Deprecated**] When you configure the control plane, use the `cloud_monitor_flags` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `cms_enabled` parameter of the `kubernetes_config` field in the nodepool section instead.
17741
+ *
17647
17742
  * Specifies whether to install the CloudMonitor agent. Valid values:
17648
17743
  *
17649
17744
  * * `true`: installs the CloudMonitor agent.
17650
17745
  * * `false`: does not install the CloudMonitor agent.
17651
17746
  *
17652
- * Default value: `false`
17747
+ * Default value: `false`.
17653
17748
  *
17654
17749
  * @example
17655
17750
  * true
@@ -17671,8 +17766,8 @@ export class CreateClusterRequest extends $dara.Model {
17671
17766
  * @remarks
17672
17767
  * If you set `cluster_type` to `ManagedKubernetes` and specify `profile`, you can further specify the edition of the cluster. Valid values:
17673
17768
  *
17674
- * * `ack.pro.small`: creates an ACK Pro cluster.
17675
- * * `ack.standard`: creates an ACK Basic cluster. If you leave the parameter empty, an ACK Basic cluster is created.
17769
+ * * `ack.pro.small`: Pro Edition.
17770
+ * * `ack.standard`: Basic Edition. If you leave the parameter empty, an ACK Basic cluster is created.
17676
17771
  *
17677
17772
  * @example
17678
17773
  * ack.pro.small
@@ -17680,9 +17775,9 @@ export class CreateClusterRequest extends $dara.Model {
17680
17775
  clusterSpec?: string;
17681
17776
  /**
17682
17777
  * @remarks
17683
- * * `Kubernetes`: an ACK dedicated cluster.
17684
- * * `ManagedKubernetes`: ACK managed cluster. ACK managed clusters include ACK Basic clusters, ACK Pro clusters, ACK Serverless Basic clusters, ACK Serverless Pro clusters, ACK Edge Basic clusters, ACK Edge Pro clusters, and ACK Lingjun Pro clusters.
17685
- * * `ExternalKubernetes`: a registered cluster.
17778
+ * * `Kubernetes`: ACK dedicated cluster.
17779
+ * * `ManagedKubernetes`: ACK managed cluster. ACK managed clusters include ACK Basic clusters, ACK Pro clusters, ACK Serverless clusters (Basic Edition and Pro Edition), ACK Edge clusters (Basic Edition and Pro Edition), and ACK Lingjun clusters (Pro Edition).
17780
+ * * `ExternalKubernetes`: registered cluster.
17686
17781
  *
17687
17782
  * This parameter is required.
17688
17783
  *
@@ -17709,9 +17804,9 @@ export class CreateClusterRequest extends $dara.Model {
17709
17804
  controlPlaneConfig?: CreateClusterRequestControlPlaneConfig;
17710
17805
  /**
17711
17806
  * @remarks
17712
- * The control plane component for which you want to enable log collection.
17807
+ * The control plane components for which you want to enable log collection.
17713
17808
  *
17714
- * By default, the log of kube-apiserver, kube-controller-manager, and kube-scheduler is collected.
17809
+ * By default, the logs of kube-apiserver, kube-controller-manager, and kube-scheduler are collected.
17715
17810
  */
17716
17811
  controlplaneLogComponents?: string[];
17717
17812
  /**
@@ -17732,10 +17827,12 @@ export class CreateClusterRequest extends $dara.Model {
17732
17827
  controlplaneLogTtl?: string;
17733
17828
  /**
17734
17829
  * @remarks
17735
- * The CPU management policy of nodes in the node pool. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
17830
+ * [**Deprecated**] When you configure the control plane, use the `cpu_policy` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `cpu_policy` parameter of the `kubernetes_config` field in the `nodepool` section instead.
17736
17831
  *
17737
- * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity
17738
- * * `none`: specifies that the default CPU affinity is used
17832
+ * The CPU management policy of the node. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
17833
+ *
17834
+ * * `static`: allows pods with specific resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.
17835
+ * * `none`: specifies that the default CPU affinity is used.
17739
17836
  *
17740
17837
  * Default value: `none`.
17741
17838
  *
@@ -17747,7 +17844,7 @@ export class CreateClusterRequest extends $dara.Model {
17747
17844
  cpuPolicy?: string;
17748
17845
  /**
17749
17846
  * @remarks
17750
- * The custom subject alternative names (SANs) for the API server certificate to accept requests from specified IP addresses or domain names. Separate multiple IP addresses and domain names by commas (,).
17847
+ * The custom subject alternative names (SANs) for the API server certificate to accept requests from specified IP addresses or domain names. Separate multiple IP addresses and domain names with commas (,).
17751
17848
  *
17752
17849
  * @example
17753
17850
  * cs.aliyun.com
@@ -17755,12 +17852,12 @@ export class CreateClusterRequest extends $dara.Model {
17755
17852
  customSan?: string;
17756
17853
  /**
17757
17854
  * @remarks
17758
- * Specifies whether to enable cluster deletion protection. If this option is enabled, the cluster cannot be deleted in the console or by calling API operations. Valid values:
17855
+ * Specifies whether to enable cluster deletion protection. If you enable this option, the cluster cannot be deleted in the console or by calling API operations. Valid values:
17759
17856
  *
17760
- * * `true`: The cluster cannot be deleted in the Container Service console or by calling API operations.
17761
- * * `false`: The cluster can be deleted in the Container Service console or by calling API operations.
17857
+ * * `true`: enables cluster deletion protection.
17858
+ * * `false`: disables cluster deletion protection.
17762
17859
  *
17763
- * Default value: `false`
17860
+ * Default value: `false`.
17764
17861
  *
17765
17862
  * @example
17766
17863
  * true
@@ -17768,12 +17865,14 @@ export class CreateClusterRequest extends $dara.Model {
17768
17865
  deletionProtection?: boolean;
17769
17866
  /**
17770
17867
  * @remarks
17771
- * Specifies whether to perform a rollback if the cluster fails to be created. Valid values:
17868
+ * [**Deprecated**] By default, the system does not perform a rollback when the cluster fails to be created. You must manually delete the cluster that fails to be created.
17869
+ *
17870
+ * Specifies whether to perform a rollback when the cluster fails to be created. Valid values:
17772
17871
  *
17773
17872
  * * `true`: performs a rollback when the cluster fails to be created.
17774
17873
  * * `false`: does not perform a rollback when the cluster fails to be created.
17775
17874
  *
17776
- * Default value: `true`
17875
+ * Default value: `true`.
17777
17876
  *
17778
17877
  * @example
17779
17878
  * true
@@ -17783,7 +17882,7 @@ export class CreateClusterRequest extends $dara.Model {
17783
17882
  disableRollback?: boolean;
17784
17883
  /**
17785
17884
  * @remarks
17786
- * Specifies whether to enable the Resource Access Management (RAM) Roles for Service Accounts (RRSA) feature.
17885
+ * Specifies whether to enable the RAM Roles for Service Accounts (RRSA) feature.
17787
17886
  *
17788
17887
  * @example
17789
17888
  * true
@@ -17806,7 +17905,7 @@ export class CreateClusterRequest extends $dara.Model {
17806
17905
  * * `true`: enables Internet access for the cluster.
17807
17906
  * * `false`: disables Internet access for the cluster. If you set the value to false, the API server cannot be accessed over the Internet.
17808
17907
  *
17809
- * Default value: `false`
17908
+ * Default value: `false`.
17810
17909
  *
17811
17910
  * @example
17812
17911
  * true
@@ -17814,12 +17913,14 @@ export class CreateClusterRequest extends $dara.Model {
17814
17913
  endpointPublicAccess?: boolean;
17815
17914
  /**
17816
17915
  * @remarks
17916
+ * [**Deprecated**] When you configure a node pool, you cannot add existing nodes to the cluster. If you want to add existing nodes, you must first create a node pool and then call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) operation.
17917
+ *
17817
17918
  * Specifies whether to mount a data disk to a node that is created based on an existing ECS instance. Valid values:
17818
17919
  *
17819
17920
  * * `true`: stores the data of containers and images on a data disk. The existing data stored in the data disk is lost. Back up the existing data first.
17820
17921
  * * `false`: does not store the data of containers and images on a data disk.
17821
17922
  *
17822
- * Default value: `false`
17923
+ * Default value: `false`.
17823
17924
  *
17824
17925
  * How data disks are mounted:
17825
17926
  *
@@ -17834,7 +17935,9 @@ export class CreateClusterRequest extends $dara.Model {
17834
17935
  formatDisk?: boolean;
17835
17936
  /**
17836
17937
  * @remarks
17837
- * The custom image. By default, the image provided by ACK is used. You can select a custom image to replace the default image. For more information, see [Use a custom image to create an ACK cluster](https://help.aliyun.com/document_detail/146647.html).
17938
+ * [**Deprecated**] When you configure the control plane, use the `image_id` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `image_id` parameter of the `scaling_group` field in the `nodepool` section instead.
17939
+ *
17940
+ * The custom image for nodes. By default, the image provided by ACK is used. You can select a custom image to replace the default image. For more information, see [Use a custom image to create an ACK cluster](https://help.aliyun.com/document_detail/146647.html).
17838
17941
  *
17839
17942
  * @example
17840
17943
  * m-bp16z7xko3vvv8gt****
@@ -17844,6 +17947,8 @@ export class CreateClusterRequest extends $dara.Model {
17844
17947
  imageId?: string;
17845
17948
  /**
17846
17949
  * @remarks
17950
+ * [**Deprecated**] When you configure the control plane, use the `image_type` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `image_type` parameter of the `scaling_group` field in the `nodepool` section instead.
17951
+ *
17847
17952
  * The type of OS distribution that you want to use. To specify the node OS, we recommend that you use this parameter. Valid values:
17848
17953
  *
17849
17954
  * * CentOS
@@ -17866,7 +17971,9 @@ export class CreateClusterRequest extends $dara.Model {
17866
17971
  imageType?: string;
17867
17972
  /**
17868
17973
  * @remarks
17869
- * The existing Elastic Compute Service (ECS) instances that are specified as worker nodes for the cluster.
17974
+ * [**Deprecated**] When you configure a node pool, you cannot add existing nodes to the cluster. If you want to add existing nodes, you must first create a node pool and then call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) operation.
17975
+ *
17976
+ * The existing ECS instances that are specified as worker nodes for the cluster.
17870
17977
  *
17871
17978
  * > This parameter is required if you create worker nodes on existing ECS instances.
17872
17979
  *
@@ -17884,14 +17991,14 @@ export class CreateClusterRequest extends $dara.Model {
17884
17991
  ipStack?: string;
17885
17992
  /**
17886
17993
  * @remarks
17887
- * Specifies whether to create an advanced security group. This parameter takes effect only if `security_group_id` is not specified.
17994
+ * Specifies whether to create an advanced security group. This parameter takes effect only if `security_group_id` is left empty.
17888
17995
  *
17889
17996
  * > To use a basic security group, make sure that the sum of the number of nodes in the cluster and the number of pods that use Terway does not exceed 2,000. Therefore, we recommend that you specify an advanced security group for a cluster that uses Terway.
17890
17997
  *
17891
17998
  * * `true`: creates an advanced security group.
17892
17999
  * * `false`: does not create an advanced security group.
17893
18000
  *
17894
- * Default value: `true`
18001
+ * Default value: `true`.
17895
18002
  *
17896
18003
  * @example
17897
18004
  * true
@@ -17899,12 +18006,14 @@ export class CreateClusterRequest extends $dara.Model {
17899
18006
  isEnterpriseSecurityGroup?: boolean;
17900
18007
  /**
17901
18008
  * @remarks
18009
+ * [**Deprecated**] When you configure a node pool, you cannot add existing nodes to the cluster. If you want to add existing nodes, you must first create a node pool and then call the [AttachInstancesToNodePool](https://help.aliyun.com/document_detail/2667920.html) operation.
18010
+ *
17902
18011
  * Specifies whether to retain the names of existing ECS instances that are used in the cluster. Valid values:
17903
18012
  *
17904
18013
  * * `true`: retains the names.
17905
18014
  * * `false`: does not retain the names. The system assigns new names.
17906
18015
  *
17907
- * Default value: `true`
18016
+ * Default value: `true`.
17908
18017
  *
17909
18018
  * @example
17910
18019
  * true
@@ -17914,7 +18023,9 @@ export class CreateClusterRequest extends $dara.Model {
17914
18023
  keepInstanceName?: boolean;
17915
18024
  /**
17916
18025
  * @remarks
17917
- * The name of the key pair. You must configure this parameter or the `login_password` parameter.
18026
+ * [**Deprecated**] When you configure the control plane, use the `key_pair` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `key_pair` parameter of the `scaling_group` field in the `nodepool` section instead.
18027
+ *
18028
+ * The name of the key pair. You must configure this parameter or `login_password`.
17918
18029
  *
17919
18030
  * @example
17920
18031
  * secrity-key
@@ -17926,7 +18037,7 @@ export class CreateClusterRequest extends $dara.Model {
17926
18037
  * @remarks
17927
18038
  * The Kubernetes version of the cluster. The Kubernetes versions supported by ACK are the same as the Kubernetes versions supported by open source Kubernetes. We recommend that you specify the latest Kubernetes version. If you do not specify this parameter, the latest Kubernetes version is used.
17928
18039
  *
17929
- * You can create clusters of the latest two Kubernetes versions in the ACK console. If you want to create clusters that run earlier Kubernetes versions, use the ACK API. For more information about the Kubernetes versions supported by ACK, see [Support for Kubernetes versions](https://help.aliyun.com/document_detail/185269.html).
18040
+ * You can create ACK clusters of the latest three Kubernetes versions in the ACK console. If you want to create clusters that run earlier Kubernetes versions, use the ACK API. For more information about the Kubernetes versions supported by ACK, see [Support for Kubernetes versions](https://help.aliyun.com/document_detail/185269.html).
17930
18041
  *
17931
18042
  * @example
17932
18043
  * 1.16.9-aliyun.1
@@ -17936,12 +18047,16 @@ export class CreateClusterRequest extends $dara.Model {
17936
18047
  * @remarks
17937
18048
  * Specifies the ID of the CLB instance for accessing the API server. If this parameter is specified, the system does not automatically create a CLB instance for the API server.
17938
18049
  *
18050
+ * > Make sure that the CLB instance does not have other dependencies, such as listeners and backend servers. You cannot specify shared-resource or Internet-facing CLB instances.
18051
+ *
17939
18052
  * @example
17940
18053
  * lb-wz9t256gqa3vbouk****
17941
18054
  */
17942
18055
  loadBalancerId?: string;
17943
18056
  /**
17944
18057
  * @remarks
18058
+ * [**Deprecated**] The pay-as-you-go billing method is used by Classic Load Balancer (CLB) instances. This parameter does not take effect.
18059
+ *
17945
18060
  * The specification of the Server Load Balancer (SLB) instance. Valid values:
17946
18061
  *
17947
18062
  * * slb.s1.small
@@ -17961,7 +18076,7 @@ export class CreateClusterRequest extends $dara.Model {
17961
18076
  loadBalancerSpec?: string;
17962
18077
  /**
17963
18078
  * @remarks
17964
- * Enables Simple Log Service for the cluster. This parameter takes effect only for ACK Serverless clusters. Valid value: `SLS`.
18079
+ * Enables Simple Log Service for the cluster. This parameter takes effect only for ACK Serverless clusters. Set the value to `SLS`.
17965
18080
  *
17966
18081
  * @example
17967
18082
  * SLS
@@ -17969,6 +18084,8 @@ export class CreateClusterRequest extends $dara.Model {
17969
18084
  loggingType?: string;
17970
18085
  /**
17971
18086
  * @remarks
18087
+ * [**Deprecated**] When you configure the control plane, use the `login_password` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `login_password` parameter of the `scaling_group` field in the `nodepool` section instead.
18088
+ *
17972
18089
  * The password for SSH logon. You must set this parameter or `key_pair`. The password must be 8 to 30 characters in length, and must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.
17973
18090
  *
17974
18091
  * @example
@@ -17984,12 +18101,14 @@ export class CreateClusterRequest extends $dara.Model {
17984
18101
  maintenanceWindow?: MaintenanceWindow;
17985
18102
  /**
17986
18103
  * @remarks
18104
+ * [**Deprecated**] When you configure the control plane, use the `auto-renew` parameter in the `control_plane_config` section instead.
18105
+ *
17987
18106
  * Specifies whether to enable auto-renewal for master nodes. This parameter takes effect only when `master_instance_charge_type` is set to `PrePaid`. Valid values:
17988
18107
  *
17989
18108
  * * `true`: enables auto-renewal.
17990
- * * `false`: disables auto-renewal
18109
+ * * `false`: disables auto-renewal.
17991
18110
  *
17992
- * Default value: `true`
18111
+ * Default value: `true`.
17993
18112
  *
17994
18113
  * @example
17995
18114
  * true
@@ -17999,7 +18118,9 @@ export class CreateClusterRequest extends $dara.Model {
17999
18118
  masterAutoRenew?: boolean;
18000
18119
  /**
18001
18120
  * @remarks
18002
- * The cycle of auto-renewal. This parameter takes effect and is required only if the subscription billing method is selected for master nodes.
18121
+ * [**Deprecated**] When you configure the control plane, use the `auto-renew_period` parameter in the `control_plane_config` section instead.
18122
+ *
18123
+ * The auto-renewal duration. This parameter takes effect and is required only when the subscription billing method is selected for master nodes.
18003
18124
  *
18004
18125
  * Valid values: 1, 2, 3, 6, and 12.
18005
18126
  *
@@ -18013,6 +18134,8 @@ export class CreateClusterRequest extends $dara.Model {
18013
18134
  masterAutoRenewPeriod?: number;
18014
18135
  /**
18015
18136
  * @remarks
18137
+ * [**Deprecated**] When you configure the control plane, use the `size` parameter in the `control_plane_config` section instead.
18138
+ *
18016
18139
  * The number of master nodes. Valid values: `3` and `5`.
18017
18140
  *
18018
18141
  * Default value: `3`.
@@ -18025,12 +18148,14 @@ export class CreateClusterRequest extends $dara.Model {
18025
18148
  masterCount?: number;
18026
18149
  /**
18027
18150
  * @remarks
18151
+ * [**Deprecated**] When you configure the control plane, use the `instance_charge_type` parameter in the `control_plane_config` section instead.
18152
+ *
18028
18153
  * The billing method of master nodes. Valid values:
18029
18154
  *
18030
- * * `PrePaid`: subscription
18031
- * * `PostPaid`: the pay-as-you-go
18155
+ * * `PrePaid`: subscription.
18156
+ * * `PostPaid`: pay-as-you-go.
18032
18157
  *
18033
- * Default value: `PostPaid`
18158
+ * Default value: `PostPaid`.
18034
18159
  *
18035
18160
  * @example
18036
18161
  * PrePaid
@@ -18040,13 +18165,17 @@ export class CreateClusterRequest extends $dara.Model {
18040
18165
  masterInstanceChargeType?: string;
18041
18166
  /**
18042
18167
  * @remarks
18043
- * The instance types of master nodes. For more information, see [Overview of ECS instance families](https://help.aliyun.com/document_detail/25378.html).
18168
+ * [**Deprecated**] When you configure the control plane, use the `instance_types` parameter in the `control_plane_config` section instead.
18169
+ *
18170
+ * The instance types of master nodes. For more information, see [Overview of instance families](https://help.aliyun.com/document_detail/25378.html).
18044
18171
  *
18045
18172
  * @deprecated
18046
18173
  */
18047
18174
  masterInstanceTypes?: string[];
18048
18175
  /**
18049
18176
  * @remarks
18177
+ * [**Deprecated**] When you configure the control plane, use the `unit` parameter in the `control_plane_config` section instead.
18178
+ *
18050
18179
  * The subscription duration of master nodes. This parameter takes effect and is required only when `master_instance_charge_type` is set to `PrePaid`.
18051
18180
  *
18052
18181
  * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
@@ -18061,6 +18190,8 @@ export class CreateClusterRequest extends $dara.Model {
18061
18190
  masterPeriod?: number;
18062
18191
  /**
18063
18192
  * @remarks
18193
+ * [**Deprecated**] When you configure the control plane, use the `period_unit` parameter in the `control_plane_config` section instead.
18194
+ *
18064
18195
  * The billing cycle of the master nodes in the cluster. This parameter is required if master_instance_charge_type is set to `PrePaid`.
18065
18196
  *
18066
18197
  * Valid value: `Month`, which indicates that master nodes are billed only on a monthly basis.
@@ -18073,11 +18204,13 @@ export class CreateClusterRequest extends $dara.Model {
18073
18204
  masterPeriodUnit?: string;
18074
18205
  /**
18075
18206
  * @remarks
18076
- * The system disk type of master nodes. Valid values:
18207
+ * [**Deprecated**] When you configure the control plane, use the `system_disk_category` parameter in the `control_plane_config` section instead.
18077
18208
  *
18078
- * * `cloud_efficiency`: ultra disk
18079
- * * `cloud_ssd`: standard SSD
18080
- * * `cloud_essd`: Enterprise SSD (ESSD)
18209
+ * The system disk category of master nodes. Valid values:
18210
+ *
18211
+ * * `cloud_efficiency`: ultra disk.
18212
+ * * `cloud_ssd`: standard SSD.
18213
+ * * `cloud_essd`: Enterprise SSD (ESSD).
18081
18214
  *
18082
18215
  * Default value: `cloud_ssd`. The default value may vary in different zones.
18083
18216
  *
@@ -18089,6 +18222,8 @@ export class CreateClusterRequest extends $dara.Model {
18089
18222
  masterSystemDiskCategory?: string;
18090
18223
  /**
18091
18224
  * @remarks
18225
+ * [**Deprecated**] When you configure the control plane, use the `system_disk_performance_level` parameter in the `control_plane_config` section instead.
18226
+ *
18092
18227
  * The performance level (PL) of the system disk that you want to use for master nodes. This parameter takes effect only for ESSDs. For more information about the relationship between disk PLs and disk sizes, see [ESSDs](https://help.aliyun.com/document_detail/122389.html).
18093
18228
  *
18094
18229
  * @example
@@ -18099,6 +18234,8 @@ export class CreateClusterRequest extends $dara.Model {
18099
18234
  masterSystemDiskPerformanceLevel?: string;
18100
18235
  /**
18101
18236
  * @remarks
18237
+ * [**Deprecated**] When you configure the control plane, use the `system_disk_disk` parameter in the `control_plane_config` section instead.
18238
+ *
18102
18239
  * The system disk size of master nodes. Valid values: 40 to 500. Unit: GiB.
18103
18240
  *
18104
18241
  * Default value: `120`.
@@ -18111,6 +18248,8 @@ export class CreateClusterRequest extends $dara.Model {
18111
18248
  masterSystemDiskSize?: number;
18112
18249
  /**
18113
18250
  * @remarks
18251
+ * [**Deprecated**] When you configure the control plane, use the `system_disk_snapshot_policy_id` parameter in the `control_plane_config` section instead.
18252
+ *
18114
18253
  * The ID of the automatic snapshot policy that is used by the system disk specified for master nodes.
18115
18254
  *
18116
18255
  * @example
@@ -18121,9 +18260,11 @@ export class CreateClusterRequest extends $dara.Model {
18121
18260
  masterSystemDiskSnapshotPolicyId?: string;
18122
18261
  /**
18123
18262
  * @remarks
18263
+ * [**Deprecated**] Use the `vswitch_ids` parameter instead.
18264
+ *
18124
18265
  * The IDs of the vSwitches that are specified for master nodes. You can specify up to three vSwitches. We recommend that you specify three vSwitches in different zones to ensure high availability.
18125
18266
  *
18126
- * The number of vSwitches must be the same as that specified in `master_count` and the same as those specified in `master_vswitch_ids`.
18267
+ * The number of vSwitches must be the same as the value of the `master_count` parameter and also the same as the number of vSwitches specified in the `master_vswitch_ids` parameter.
18127
18268
  *
18128
18269
  * @deprecated
18129
18270
  */
@@ -18132,7 +18273,7 @@ export class CreateClusterRequest extends $dara.Model {
18132
18273
  * @remarks
18133
18274
  * The cluster name.
18134
18275
  *
18135
- * The cluster name must be 1 to 63 characters in length, and can contain digits, letters, and underscores (_). The cluster name cannot start with a hyphen (-).
18276
+ * The name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). The name cannot start with a hyphen (-).
18136
18277
  *
18137
18278
  * This parameter is required.
18138
18279
  *
@@ -18142,7 +18283,7 @@ export class CreateClusterRequest extends $dara.Model {
18142
18283
  name?: string;
18143
18284
  /**
18144
18285
  * @remarks
18145
- * This parameter is deprecated. Use `snat_entry` instead.
18286
+ * [Deprecated] Use the `snat_entry` parameter instead.
18146
18287
  *
18147
18288
  * @example
18148
18289
  * true
@@ -18150,7 +18291,7 @@ export class CreateClusterRequest extends $dara.Model {
18150
18291
  natGateway?: boolean;
18151
18292
  /**
18152
18293
  * @remarks
18153
- * The maximum number of IP addresses that can be assigned to nodes. This number is determined by the node CIDR block. This parameter takes effect only if the cluster uses Flannel network plug-in.
18294
+ * The maximum number of IP addresses that can be assigned to each node. This number is determined by the subnet mask of the specified CIDR block. This parameter takes effect only if the cluster uses the Flannel plug-in.
18154
18295
  *
18155
18296
  * Default value: `26`.
18156
18297
  *
@@ -18160,6 +18301,8 @@ export class CreateClusterRequest extends $dara.Model {
18160
18301
  nodeCidrMask?: string;
18161
18302
  /**
18162
18303
  * @remarks
18304
+ * [**Deprecated**] When you configure a node pool, use the `node_name_mode` parameter of the `kubernetes_config` field in the `nodepool` section instead.
18305
+ *
18163
18306
  * The custom node name.
18164
18307
  *
18165
18308
  * A custom node name consists of a prefix, a node IP address, and a suffix.
@@ -18167,7 +18310,7 @@ export class CreateClusterRequest extends $dara.Model {
18167
18310
  * * The prefix and suffix can contain multiple parts that are separated by periods (.). Each part can contain lowercase letters, digits, and hyphens (-), and must start and end with a lowercase letter or digit.
18168
18311
  * * The IP substring length specifies the number of digits to be truncated from the end of the node IP address. The IP substring length ranges from 5 to 12.
18169
18312
  *
18170
- * For example, if the node IP address is 192.168.0.55, the prefix is aliyun.com, the IP substring length is 5, and the suffix is test, the node name is aliyun.com00055test.
18313
+ * For example, if the node IP address is 192.168.0.55, the prefix is aliyun.com, the IP substring length is 5, and the suffix is test, the node name will aliyun.com00055test.
18171
18314
  *
18172
18315
  * @example
18173
18316
  * aliyun.com00055test
@@ -18192,6 +18335,8 @@ export class CreateClusterRequest extends $dara.Model {
18192
18335
  nodepools?: Nodepool[];
18193
18336
  /**
18194
18337
  * @remarks
18338
+ * [**Deprecated**] When you configure a node pool, use the `desired_size` parameter of the `scaling_group` field in the `nodepool` section instead.
18339
+ *
18195
18340
  * The number of worker nodes. Valid values: 0 to 100.
18196
18341
  *
18197
18342
  * @example
@@ -18207,6 +18352,8 @@ export class CreateClusterRequest extends $dara.Model {
18207
18352
  operationPolicy?: CreateClusterRequestOperationPolicy;
18208
18353
  /**
18209
18354
  * @remarks
18355
+ * [**Deprecated**] When you configure the control plane, use the `image_type` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `image_type` parameter of the `scaling_group` field in the `nodepool` section instead.
18356
+ *
18210
18357
  * The type of OS. Valid values:
18211
18358
  *
18212
18359
  * * Windows
@@ -18222,9 +18369,9 @@ export class CreateClusterRequest extends $dara.Model {
18222
18369
  osType?: string;
18223
18370
  /**
18224
18371
  * @remarks
18225
- * **This parameter is deprecated.**
18372
+ * [**Deprecated**]
18226
18373
  *
18227
- * The subscription duration of the instance. This parameter takes effect and is required only when you set charge_type to PrePaid.
18374
+ * The subscription duration. This parameter takes effect and is required only when you set charge_type to PrePaid.
18228
18375
  *
18229
18376
  * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
18230
18377
  *
@@ -18240,7 +18387,7 @@ export class CreateClusterRequest extends $dara.Model {
18240
18387
  period?: number;
18241
18388
  /**
18242
18389
  * @remarks
18243
- * **This parameter is deprecated.**
18390
+ * [**Deprecated**]
18244
18391
  *
18245
18392
  * The billing cycle. This parameter is required if charge_type is set to PrePaid.
18246
18393
  *
@@ -18256,6 +18403,8 @@ export class CreateClusterRequest extends $dara.Model {
18256
18403
  periodUnit?: string;
18257
18404
  /**
18258
18405
  * @remarks
18406
+ * [**Deprecated**] When you configure a node pool, use the `platform` parameter of the `scaling_group` field in the `nodepool` section instead.
18407
+ *
18259
18408
  * The OS distribution that is used. Valid values:
18260
18409
  *
18261
18410
  * * CentOS
@@ -18275,9 +18424,9 @@ export class CreateClusterRequest extends $dara.Model {
18275
18424
  platform?: string;
18276
18425
  /**
18277
18426
  * @remarks
18278
- * If you select Terway as the network plug-in, you must allocate vSwitches to pods. Each pod vSwitch must correspond to a worker node vSwitch. Pod vSwitches and worker node vSwitches must reside in the same zone.
18427
+ * If you select Terway as the network plug-in, you must allocate vSwitches to pods. For each vSwitch that allocates IP addresses to worker nodes, you must select a vSwitch in the same zone to allocate IP addresses to pods.
18279
18428
  *
18280
- * > We recommend that you select pod vSwitches whose subnet mask lengths are no longer than 19 bits. The maximum subnet mask length of a pod vSwitch is 25 bits. If you select a pod vSwitch whose subnet mask length is longer than 25 bits, the IP addresses that can be allocated to pods may be insufficient.
18429
+ * > We recommend that you select pod vSwitches whose subnet masks do not exceed 19 bits in length. The maximum subnet mask length of a pod vSwitch is 25 bits. If you select a pod vSwitch whose subnet mask exceeds 25 bits in length, the IP addresses that can be allocated to pods may be insufficient.
18281
18430
  */
18282
18431
  podVswitchIds?: string[];
18283
18432
  /**
@@ -18297,7 +18446,7 @@ export class CreateClusterRequest extends $dara.Model {
18297
18446
  * @remarks
18298
18447
  * The kube-proxy mode. Valid values:
18299
18448
  *
18300
- * * `iptables`: a mature and stable kube-proxy mode that uses iptables rules to conduct Service discovery and load balancing. The performance of this mode is limited by the size of the cluster. This mode is suitable for clusters that run a small number of Services.
18449
+ * * `iptables`: a mature and stable mode that uses iptables rules to conduct service discovery and load balancing. The performance of this mode is limited by the size of the cluster. This mode is suitable for clusters that run a small number of Services.
18301
18450
  * * `ipvs`: a mode that provides high performance and uses IP Virtual Server (IPVS) to conduct service discovery and load balancing. This mode is suitable for clusters that run a large number of Services. We recommend that you use this mode in scenarios that require high-performance load balancing.
18302
18451
  *
18303
18452
  * Default value: `ipvs`.
@@ -18308,14 +18457,16 @@ export class CreateClusterRequest extends $dara.Model {
18308
18457
  proxyMode?: string;
18309
18458
  /**
18310
18459
  * @remarks
18311
- * The ApsaraDB RDS instances. Select the ApsaraDB RDS instances that you want to add to the whitelist. We recommend that you add the pod CIDR block and node CIDR block to the ApsaraDB RDS instances in the ApsaraDB RDS console. When you configure the ApsaraDB RDS instances, you cannot scale out the number of nodes because the instances are not in the Running state.
18460
+ * [**Deprecated**] When you configure a node pool, use the `rds_instances` parameter of the `scaling_group` field in the `nodepool` section instead.
18461
+ *
18462
+ * The ApsaraDB RDS instances. The pod CIDR block and node CIDR block are added to the whitelists of the ApsaraDB RDS instances. We recommend that you add the pod CIDR block and node CIDR block to the whitelists of the ApsaraDB RDS instances in the ApsaraDB RDS console. If the RDS instances are not in the Running state, new nodes cannot be added to the cluster.
18312
18463
  *
18313
18464
  * @deprecated
18314
18465
  */
18315
18466
  rdsInstances?: string[];
18316
18467
  /**
18317
18468
  * @remarks
18318
- * The ID of the region in which the cluster is deployed.
18469
+ * The ID of the region in which the cluster is deployed. For more information about the regions supported by ACK, see [Regions supported by ACK](https://help.aliyun.com/document_detail/216938.html).
18319
18470
  *
18320
18471
  * This parameter is required.
18321
18472
  *
@@ -18348,12 +18499,14 @@ export class CreateClusterRequest extends $dara.Model {
18348
18499
  securityGroupId?: string;
18349
18500
  /**
18350
18501
  * @remarks
18502
+ * [**Deprecated**] When you configure the control plane, use the `security_hardening_os` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `security_hardening_os` parameter of the `scaling_group` field in the `nodepool` section instead.
18503
+ *
18351
18504
  * Specifies whether to enable Alibaba Cloud Linux Security Hardening. Valid values:
18352
18505
  *
18353
18506
  * * `true`: enables Alibaba Cloud Linux Security Hardening.
18354
18507
  * * `false`: disables Alibaba Cloud Linux Security Hardening.
18355
18508
  *
18356
- * Default value: `false`
18509
+ * Default value: `false`.
18357
18510
  *
18358
18511
  * @example
18359
18512
  * false
@@ -18363,7 +18516,7 @@ export class CreateClusterRequest extends $dara.Model {
18363
18516
  securityHardeningOs?: boolean;
18364
18517
  /**
18365
18518
  * @remarks
18366
- * Provides identities for pods when pods communicate with the `API server` of the cluster. `service-account-issuer` specifies the issuer of the `serviceaccount token`, which is specified by using the `iss` field in the `token payload`.
18519
+ * Service accounts provide identities for pods when pods communicate with the `API server` of the cluster. `service-account-issuer` specifies the issuer of the `serviceaccount token`, which is specified by using the `iss` field in the `token payload`.
18367
18520
  *
18368
18521
  * For more information about `ServiceAccount`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
18369
18522
  *
@@ -18373,7 +18526,7 @@ export class CreateClusterRequest extends $dara.Model {
18373
18526
  serviceAccountIssuer?: string;
18374
18527
  /**
18375
18528
  * @remarks
18376
- * The Service CIDR block. Valid values: 10.0.0.0/16-24, 172.16-31.0.0/16-24, and 192.168.0.0/16-24. The Service CIDR block cannot overlap with the CIDR block of the VPC (10.1.0.0/21) or the CIDR blocks of existing clusters in the VPC. You cannot modify the CIDR block of Services after the cluster is created.
18529
+ * The Service CIDR block. Valid values: 10.0.0.0/16-24, 172.16-31.0.0/16-24, and 192.168.0.0/16-24. The Service CIDR block cannot overlap with the VPC CIDR block (10.1.0.0/21) or the CIDR blocks of existing clusters in the VPC. You cannot modify the Service CIDR block after the cluster is created.
18377
18530
  *
18378
18531
  * By default, the Service CIDR block is set to 172.19.0.0/20.
18379
18532
  *
@@ -18387,7 +18540,7 @@ export class CreateClusterRequest extends $dara.Model {
18387
18540
  * @remarks
18388
18541
  * The methods for implementing service discovery in `ACK Serverless` clusters.
18389
18542
  *
18390
- * * `CoreDNS`: a standard service discovery plug-in that is provided by open source Kubernetes. To use DNS resolution, you must provision pods. By default, two elastic container instances are used. The specification of each instance is 0.25 vCPUs and 512 MiB of memory.
18543
+ * * `CoreDNS`: a standard service discovery plug-in that is provided by open source Kubernetes. To use DNS resolution, you must provision pods. By default, two elastic container instances are used. The specification of each instance is 0.25 vCores and 512 MiB of memory.
18391
18544
  * * `PrivateZone`: a DNS resolution service provided by Alibaba Cloud. You must activate Alibaba Cloud DNS PrivateZone before you can use it for service discovery.
18392
18545
  *
18393
18546
  * By default, this parameter is not specified.
@@ -18395,14 +18548,14 @@ export class CreateClusterRequest extends $dara.Model {
18395
18548
  serviceDiscoveryTypes?: string[];
18396
18549
  /**
18397
18550
  * @remarks
18398
- * Specifies whether to configure Source Network Address Translation (SNAT) rules for the VPC in which your cluster is deployed. Valid values:
18551
+ * Specifies whether to configure SNAT rules for the VPC in which your cluster is deployed. Valid values:
18399
18552
  *
18400
18553
  * * `true`: automatically creates a NAT gateway and configures SNAT rules. Set the value to `true` if nodes and applications in the cluster need to access the Internet.
18401
18554
  * * `false`: does not create a NAT gateway or configure SNAT rules. In this case, nodes and applications in the cluster cannot access the Internet.
18402
18555
  *
18403
18556
  * > If this feature is disabled when you create the cluster, you can also manually enable this feature after you create the cluster. For more information, see [Enable an existing ACK cluster to access the Internet](https://help.aliyun.com/document_detail/178480.html).
18404
18557
  *
18405
- * Default value: `true`
18558
+ * Default value: `true`.
18406
18559
  *
18407
18560
  * @example
18408
18561
  * true
@@ -18410,6 +18563,8 @@ export class CreateClusterRequest extends $dara.Model {
18410
18563
  snatEntry?: boolean;
18411
18564
  /**
18412
18565
  * @remarks
18566
+ * [**Deprecated**] When you configure the control plane, use the `soc_enabled` parameter in the `control_plane_config` section instead. When you configure a node pool, use the `soc_enabled` parameter of the `scaling_group` field in the `nodepool` section instead.
18567
+ *
18413
18568
  * Specifies whether to enable Multi-Level Protection Scheme (MLPS) security hardening. For more information, see [ACK security hardening based on MLPS](https://help.aliyun.com/document_detail/196148.html).
18414
18569
  *
18415
18570
  * Valid values:
@@ -18417,7 +18572,7 @@ export class CreateClusterRequest extends $dara.Model {
18417
18572
  * * `true`: enables MLPS security hardening.
18418
18573
  * * `false`: disables MLPS security hardening.
18419
18574
  *
18420
- * Default value: `false`
18575
+ * Default value: `false`.
18421
18576
  *
18422
18577
  * @example
18423
18578
  * false
@@ -18432,7 +18587,7 @@ export class CreateClusterRequest extends $dara.Model {
18432
18587
  * * `true`: enables SSH logon.
18433
18588
  * * `false`: disables SSH logon.
18434
18589
  *
18435
- * Default value: `false`
18590
+ * Default value: `false`.
18436
18591
  *
18437
18592
  * @example
18438
18593
  * true
@@ -18440,21 +18595,25 @@ export class CreateClusterRequest extends $dara.Model {
18440
18595
  sshFlags?: boolean;
18441
18596
  /**
18442
18597
  * @remarks
18443
- * The tags to be added to nodes. When you add tags to a node, the following rules apply:
18598
+ * The labels that you want to add to nodes. You must add labels based on the following rules:
18444
18599
  *
18445
- * * A tag is a case-sensitive key-value pair. You can add up to 20 tags.
18446
- * * When you add a tag, you must specify a unique key but you can leave the value empty. A key cannot exceed 64 characters in length and a value cannot exceed 128 characters in length. Keys and values cannot start with aliyun, acs:, https://, or http://. For more information, see [Labels and Selectors](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#syntax-and-character-set).
18600
+ * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
18601
+ * * When you add a label, you must specify a unique key, but you can leave the value empty. A key cannot exceed 64 characters in length, and a value cannot exceed 128 characters in length. Keys and values cannot start with aliyun, acs:, https://, or http://. For more information, see [Labels and Selectors](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#syntax-and-character-set).
18447
18602
  */
18448
18603
  tags?: Tag[];
18449
18604
  /**
18450
18605
  * @remarks
18451
- * The taint. Taints can be used together with tolerations to avoid scheduling pods to specified nodes. For more information, see [taint-and-toleration](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/).
18606
+ * [**Deprecated**] When you configure a node pool, use the `taints` parameter of the `kubernetes_config` field in the `nodepool` section instead.
18607
+ *
18608
+ * The taints that you want to add to nodes. Taints can be used together with tolerations to avoid scheduling pods to specific nodes. For more information, see [taint-and-toleration](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/).
18452
18609
  *
18453
18610
  * @deprecated
18454
18611
  */
18455
18612
  taints?: Taint[];
18456
18613
  /**
18457
18614
  * @remarks
18615
+ * [**Deprecated**] By default, the system does not perform a rollback when the cluster fails to be created. You must manually delete the cluster that fails to be created.
18616
+ *
18458
18617
  * Specifies the timeout period of cluster creation. Unit: minutes.
18459
18618
  *
18460
18619
  * Default value: `60`.
@@ -18499,17 +18658,19 @@ export class CreateClusterRequest extends $dara.Model {
18499
18658
  vpcid?: string;
18500
18659
  /**
18501
18660
  * @remarks
18502
- * The vSwitches that are specified for nodes in the cluster. This parameter is required if you create an ACK managed cluster that does not contain nodes.
18661
+ * The vSwitches for nodes in the cluster. This parameter is required if you create an ACK managed cluster that does not contain nodes.
18503
18662
  */
18504
18663
  vswitchIds?: string[];
18505
18664
  /**
18506
18665
  * @remarks
18507
- * Specifies whether to enable auto renewal for worker nodes. This parameter takes effect and is required only when `worker_instance_charge_type` is set to `PrePaid`. Valid values:
18666
+ * [**Deprecated**] When you configure a node pool, use the `auto_renew` parameter of the `scaling_group` field in the `nodepool` section instead.
18667
+ *
18668
+ * Specifies whether to enable auto-renewal for worker nodes. This parameter takes effect and is required only when `worker_instance_charge_type` is set to `PrePaid`. Valid values:
18508
18669
  *
18509
18670
  * * `true`: enables auto-renewal.
18510
- * * `false`: disables auto-renewal
18671
+ * * `false`: disables auto-renewal.
18511
18672
  *
18512
- * Default value: `true`
18673
+ * Default value: `true`.
18513
18674
  *
18514
18675
  * @example
18515
18676
  * true
@@ -18519,7 +18680,9 @@ export class CreateClusterRequest extends $dara.Model {
18519
18680
  workerAutoRenew?: boolean;
18520
18681
  /**
18521
18682
  * @remarks
18522
- * The cycle of auto-renewal. This parameter takes effect and is required only if the subscription billing method is selected for worker nodes.
18683
+ * [**Deprecated**] When you configure a node pool, use the `auto_renew_period` parameter of the `scaling_group` field in the `nodepool` section instead.
18684
+ *
18685
+ * The auto-renewal duration of worker nodes. This parameter takes effect and is required only if the subscription billing method is selected for worker nodes.
18523
18686
  *
18524
18687
  * Valid values: 1, 2, 3, 6, and 12.
18525
18688
  *
@@ -18531,17 +18694,21 @@ export class CreateClusterRequest extends $dara.Model {
18531
18694
  workerAutoRenewPeriod?: number;
18532
18695
  /**
18533
18696
  * @remarks
18534
- * The configurations of the data disks that you want to mount to worker nodes. The configurations include the disk type and disk size.
18697
+ * [**Deprecated**] When you configure a node pool, use the `data_disks` parameter of the `scaling_group` field in the `nodepool` section instead.
18698
+ *
18699
+ * The configurations of the data disks that you want to mount to worker nodes. The configurations include the disk category and disk size.
18535
18700
  *
18536
18701
  * @deprecated
18537
18702
  */
18538
18703
  workerDataDisks?: CreateClusterRequestWorkerDataDisks[];
18539
18704
  /**
18540
18705
  * @remarks
18706
+ * [**Deprecated**] When you configure a node pool, use the `instance_charge_type` parameter of the `scaling_group` field in the `nodepool` section instead.
18707
+ *
18541
18708
  * The billing method of worker nodes. Valid values:
18542
18709
  *
18543
- * * `PrePaid`: subscription
18544
- * * `PostPaid`: the pay-as-you-go
18710
+ * * `PrePaid`: subscription.
18711
+ * * `PostPaid`: pay-as-you-go.
18545
18712
  *
18546
18713
  * Default value: PostPaid.
18547
18714
  *
@@ -18553,6 +18720,8 @@ export class CreateClusterRequest extends $dara.Model {
18553
18720
  workerInstanceChargeType?: string;
18554
18721
  /**
18555
18722
  * @remarks
18723
+ * [**Deprecated**] When you configure a node pool, use the `instance_types` parameter of the `scaling_group` field in the `nodepool` section instead.
18724
+ *
18556
18725
  * The instance configurations of worker nodes.
18557
18726
  *
18558
18727
  * @deprecated
@@ -18560,6 +18729,8 @@ export class CreateClusterRequest extends $dara.Model {
18560
18729
  workerInstanceTypes?: string[];
18561
18730
  /**
18562
18731
  * @remarks
18732
+ * [**Deprecated**] When you configure a node pool, use the `period` parameter of the `scaling_group` field in the `nodepool` section instead.
18733
+ *
18563
18734
  * The subscription duration of worker nodes. This parameter takes effect and is required only when `worker_instance_charge_type` is set to `PrePaid`.
18564
18735
  *
18565
18736
  * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
@@ -18574,6 +18745,8 @@ export class CreateClusterRequest extends $dara.Model {
18574
18745
  workerPeriod?: number;
18575
18746
  /**
18576
18747
  * @remarks
18748
+ * [**Deprecated**] When you configure a node pool, use the `period_unit` parameter of the `scaling_group` field in the `nodepool` section instead.
18749
+ *
18577
18750
  * The billing cycle of worker nodes. This parameter is required if worker_instance_charge_type is set to `PrePaid`.
18578
18751
  *
18579
18752
  * Valid value: `Month`, which indicates that worker nodes are billed only on a monthly basis.
@@ -18586,14 +18759,16 @@ export class CreateClusterRequest extends $dara.Model {
18586
18759
  workerPeriodUnit?: string;
18587
18760
  /**
18588
18761
  * @remarks
18762
+ * [**Deprecated**] When you configure a node pool, use the `system_disk_category` parameter of the `scaling_group` field in the `nodepool` section instead.
18763
+ *
18589
18764
  * The system disk category of worker nodes. For more information, see [Elastic Block Storage devices](https://help.aliyun.com/document_detail/63136.html).
18590
18765
  *
18591
18766
  * Valid values:
18592
18767
  *
18593
- * * `cloud_efficiency`: ultra disk
18594
- * * `cloud_ssd`: standard SSD
18768
+ * * `cloud_efficiency`: ultra disk.
18769
+ * * `cloud_ssd`: standard SSD.
18595
18770
  *
18596
- * Default value: `cloud_ssd`
18771
+ * Default value: `cloud_ssd`.
18597
18772
  *
18598
18773
  * @example
18599
18774
  * cloud_efficiency
@@ -18603,6 +18778,8 @@ export class CreateClusterRequest extends $dara.Model {
18603
18778
  workerSystemDiskCategory?: string;
18604
18779
  /**
18605
18780
  * @remarks
18781
+ * [**Deprecated**] When you configure a node pool, use the `system_disk_performance_level` parameter of the `scaling_group` field in the `nodepool` section instead.
18782
+ *
18606
18783
  * If the system disk is an ESSD, you can specify the PL of the ESSD. For more information, see [Enterprise SSDs](https://help.aliyun.com/document_detail/122389.html).
18607
18784
  *
18608
18785
  * Valid values:
@@ -18620,6 +18797,8 @@ export class CreateClusterRequest extends $dara.Model {
18620
18797
  workerSystemDiskPerformanceLevel?: string;
18621
18798
  /**
18622
18799
  * @remarks
18800
+ * [**Deprecated**] When you configure a node pool, use the `system_disk_size` parameter of the `scaling_group` field in the `nodepool` section instead.
18801
+ *
18623
18802
  * The system disk size of worker nodes. Unit: GiB.
18624
18803
  *
18625
18804
  * Valid values: 40 to 500.
@@ -18636,6 +18815,8 @@ export class CreateClusterRequest extends $dara.Model {
18636
18815
  workerSystemDiskSize?: number;
18637
18816
  /**
18638
18817
  * @remarks
18818
+ * [**Deprecated**] When you configure a node pool, use the `system_disk_snapshot_policy_id` parameter of the `scaling_group` field in the `nodepool` section instead.
18819
+ *
18639
18820
  * The ID of the automatic snapshot policy that is used by the system disk specified for worker nodes.
18640
18821
  *
18641
18822
  * @example
@@ -18646,18 +18827,20 @@ export class CreateClusterRequest extends $dara.Model {
18646
18827
  workerSystemDiskSnapshotPolicyId?: string;
18647
18828
  /**
18648
18829
  * @remarks
18649
- * The vSwitches that are specified for worker nodes. Each worker node is allocated a vSwitch.
18830
+ * [**Deprecated**] When you configure a node pool, use the `vswitch_ids` parameter of the `scaling_group` field in the `nodepool` section instead.
18831
+ *
18832
+ * The vSwitches for worker nodes. Each worker node is allocated a vSwitch.
18650
18833
  *
18651
- * `worker_vswitch_ids` is optional but `vswitch_ids` is required if you create an ACK managed cluster that does not contain nodes.
18834
+ * `worker_vswitch_ids` is optional, but `vswitch_ids` is required if you create an ACK managed cluster that does not contain nodes.
18652
18835
  *
18653
18836
  * @deprecated
18654
18837
  */
18655
18838
  workerVswitchIds?: string[];
18656
18839
  /**
18657
18840
  * @remarks
18658
- * This parameter is deprecated. Use `zone_ids` instead.
18841
+ * [Deprecated] Use the `zone_ids` parameter instead.
18659
18842
  *
18660
- * The ID of the zone to which the cluster belongs. This parameter is specific to ACK managed clusters.
18843
+ * The ID of the zone to which the cluster belongs. This parameter is specific to ACK Serverless clusters.
18661
18844
  *
18662
18845
  * When you create an ACK managed cluster, you must set the `zone_id` parameter if `vpc_id` and `vswitch_ids` are not specified. This way, the system automatically creates a VPC in the specified zone. This parameter is invalid if you specify the `vpc_id` and `vswitch_ids` parameters.
18663
18846
  *
@@ -19219,7 +19402,7 @@ export class CreateClusterNodePoolRequest extends $dara.Model {
19219
19402
  count?: number;
19220
19403
  /**
19221
19404
  * @remarks
19222
- * Specifies whether set the network type of the pod to host network.
19405
+ * Specifies whether to set the network type of the pod to host network.
19223
19406
  *
19224
19407
  * * `true`: sets to host network.
19225
19408
  * * `false`: sets to container network.
@@ -20108,6 +20291,8 @@ export class CreateTriggerResponse extends $dara.Model {
20108
20291
  export class DeleteAlertContactRequest extends $dara.Model {
20109
20292
  /**
20110
20293
  * @remarks
20294
+ * The list of alert contact IDs.
20295
+ *
20111
20296
  * This parameter is required.
20112
20297
  */
20113
20298
  contactIds?: number[];
@@ -20138,6 +20323,8 @@ export class DeleteAlertContactRequest extends $dara.Model {
20138
20323
  export class DeleteAlertContactShrinkRequest extends $dara.Model {
20139
20324
  /**
20140
20325
  * @remarks
20326
+ * The list of alert contact IDs.
20327
+ *
20141
20328
  * This parameter is required.
20142
20329
  */
20143
20330
  contactIdsShrink?: string;
@@ -20200,6 +20387,8 @@ export class DeleteAlertContactResponse extends $dara.Model {
20200
20387
  export class DeleteAlertContactGroupRequest extends $dara.Model {
20201
20388
  /**
20202
20389
  * @remarks
20390
+ * The list of alert contact group IDs.
20391
+ *
20203
20392
  * This parameter is required.
20204
20393
  */
20205
20394
  contactGroupIds?: number[];
@@ -20230,6 +20419,8 @@ export class DeleteAlertContactGroupRequest extends $dara.Model {
20230
20419
  export class DeleteAlertContactGroupShrinkRequest extends $dara.Model {
20231
20420
  /**
20232
20421
  * @remarks
20422
+ * The list of alert contact group IDs.
20423
+ *
20233
20424
  * This parameter is required.
20234
20425
  */
20235
20426
  contactGroupIdsShrink?: string;
@@ -21554,12 +21745,12 @@ export class DescribeClusterAddonInstanceResponseBody extends $dara.Model {
21554
21745
  * The status of the component. Valid values:
21555
21746
  *
21556
21747
  * * initial: The component is being installed.
21557
- * * active: The component is installed.
21748
+ * * active: The component has been installed.
21558
21749
  * * unhealthy: The component is in an abnormal state.
21559
- * * upgrading: The component is being updated.
21560
- * * updating: The component is being modified.
21750
+ * * upgrading: The component is undergoing an upgrade.
21751
+ * * updating: Component configuration changes are being applied.
21561
21752
  * * deleting: The component is being uninstalled.
21562
- * * deleted: The component is deleted.
21753
+ * * deleted: The component has been deleted.
21563
21754
  *
21564
21755
  * @example
21565
21756
  * active
@@ -21915,17 +22106,25 @@ export class DescribeClusterAttachScriptsRequest extends $dara.Model {
21915
22106
  arch?: string;
21916
22107
  /**
21917
22108
  * @remarks
21918
- * Specifies whether to mount data disks to an existing instance when you add the instance to the cluster. You can add data disks to store container data and images. Valid values:
22109
+ * Describes the expiration time of the generated token, formatted as a Unix timestamp. For example, 1739980800 represents 2025-02-20 00:00:00.
22110
+ *
22111
+ * @example
22112
+ * 1740037333
22113
+ */
22114
+ expired?: number;
22115
+ /**
22116
+ * @remarks
22117
+ * Specifies whether to mount data disks to an existing instance when you manually add this instance to the cluster. You can add data disks to store container data and images. Valid values:
21919
22118
  *
21920
- * * `true`: mounts data disks to the existing instance that you want to add. After a data disk is mounted, the original data on the disk is erased. Back up data before you mount a data disk.
22119
+ * * `true`: mounts data disks to the existing instance. Back up the data first to prevent losses.
21921
22120
  * * `false`: does not mount data disks to the existing instance.
21922
22121
  *
21923
22122
  * Default value: `false`.
21924
22123
  *
21925
- * How a data disk is mounted:
22124
+ * Mounting rules:
21926
22125
  *
21927
- * * If the Elastic Compute Service (ECS) instances are already mounted with data disks and the file system of the last data disk is not initialized, the system automatically formats this data disk to ext4 and mounts it to /var/lib/docker and /var/lib/kubelet.
21928
- * * If no data disk is mounted to the ECS instance, the system does not purchase a new data disk.
22126
+ * * If the Elastic Compute Service (ECS) instances are already mounted with data disks and the file system of the last data disk is uninitialized, the system automatically formats this data disk to ext4 and mounts it to /var/lib/docker and /var/lib/kubelet.
22127
+ * * If no data disk is mounted to the ECS instance, no new disk will be mounted.
21929
22128
  *
21930
22129
  * @example
21931
22130
  * false
@@ -21933,10 +22132,10 @@ export class DescribeClusterAttachScriptsRequest extends $dara.Model {
21933
22132
  formatDisk?: boolean;
21934
22133
  /**
21935
22134
  * @remarks
21936
- * Specifies whether to retain the name of the existing instance when it is added to the cluster. If you do not retain the instance name, the instance is named in the `worker-k8s-for-cs-<clusterid>` format. Valid values:
22135
+ * Specifies whether to retain the name of the existing instance when it is added to the cluster. ``Valid values:
21937
22136
  *
21938
22137
  * * `true`: retains the instance name.
21939
- * * `false`: does not retain the instance name.
22138
+ * * `false`: renames the instance to worker-k8s-for-cs-\\<clusterid>.
21940
22139
  *
21941
22140
  * Default value: `true`.
21942
22141
  *
@@ -21948,7 +22147,7 @@ export class DescribeClusterAttachScriptsRequest extends $dara.Model {
21948
22147
  * @remarks
21949
22148
  * The ID of the node pool to which you want to add an existing node.
21950
22149
  *
21951
- * > If you do not specify a node pool ID, the node is added to a default node pool.
22150
+ * > If not specified, the node is added to the default node pool.
21952
22151
  *
21953
22152
  * @example
21954
22153
  * np1c9229d9be2d432c93f77a88fca0****
@@ -21966,12 +22165,13 @@ export class DescribeClusterAttachScriptsRequest extends $dara.Model {
21966
22165
  options?: string;
21967
22166
  /**
21968
22167
  * @remarks
21969
- * The ApsaraDB RDS instances. If you specify a list of ApsaraDB RDS instances, ECS instances in the cluster are automatically added to the whitelist of the ApsaraDB RDS instances.
22168
+ * If you specify a list of ApsaraDB RDS instances, ECS instances in the cluster will be automatically added to the whitelist of the ApsaraDB RDS instances.
21970
22169
  */
21971
22170
  rdsInstances?: string[];
21972
22171
  static names(): { [key: string]: string } {
21973
22172
  return {
21974
22173
  arch: 'arch',
22174
+ expired: 'expired',
21975
22175
  formatDisk: 'format_disk',
21976
22176
  keepInstanceName: 'keep_instance_name',
21977
22177
  nodepoolId: 'nodepool_id',
@@ -21983,6 +22183,7 @@ export class DescribeClusterAttachScriptsRequest extends $dara.Model {
21983
22183
  static types(): { [key: string]: any } {
21984
22184
  return {
21985
22185
  arch: 'string',
22186
+ expired: 'number',
21986
22187
  formatDisk: 'boolean',
21987
22188
  keepInstanceName: 'boolean',
21988
22189
  nodepoolId: 'string',
@@ -22713,6 +22914,10 @@ export class DescribeClusterNodePoolDetailResponseBody extends $dara.Model {
22713
22914
  * @remarks
22714
22915
  * Indicates whether the pods in the edge node pool can use the host network.
22715
22916
  *
22917
+ * `true`: sets to host network.
22918
+ *
22919
+ * `false`: sets to container network.
22920
+ *
22716
22921
  * @example
22717
22922
  * true
22718
22923
  */
@@ -22724,7 +22929,11 @@ export class DescribeClusterNodePoolDetailResponseBody extends $dara.Model {
22724
22929
  interconnectConfig?: DescribeClusterNodePoolDetailResponseBodyInterconnectConfig;
22725
22930
  /**
22726
22931
  * @remarks
22727
- * The network type of the edge node pool. Valid values: basic and enhanced. This parameter takes effect only for edge node pools.
22932
+ * The network type of the edge node pool. This parameter takes effect only if you set the type parameter of the node pool to edge. Valid values:
22933
+ *
22934
+ * `basic`: Internet.
22935
+ *
22936
+ * `private`: private network.
22728
22937
  *
22729
22938
  * @example
22730
22939
  * improved
@@ -22732,7 +22941,11 @@ export class DescribeClusterNodePoolDetailResponseBody extends $dara.Model {
22732
22941
  interconnectMode?: string;
22733
22942
  /**
22734
22943
  * @remarks
22735
- * Indicates whether all nodes in the edge node pool can communicate with each other at Layer 3.
22944
+ * Specifies whether all nodes in the edge node pool can communicate with each other at Layer 3.
22945
+ *
22946
+ * `true`: The nodes in the edge node pool can communicate with each other at Layer 3.
22947
+ *
22948
+ * `false`: The nodes in the edge node pool cannot communicate with each other at Layer 3.
22736
22949
  *
22737
22950
  * @example
22738
22951
  * true
@@ -22740,7 +22953,7 @@ export class DescribeClusterNodePoolDetailResponseBody extends $dara.Model {
22740
22953
  intranet?: boolean;
22741
22954
  /**
22742
22955
  * @remarks
22743
- * The configurations of the cluster.
22956
+ * The configurations of the cluster in which the node pool is deployed.
22744
22957
  */
22745
22958
  kubernetesConfig?: DescribeClusterNodePoolDetailResponseBodyKubernetesConfig;
22746
22959
  /**
@@ -22750,7 +22963,9 @@ export class DescribeClusterNodePoolDetailResponseBody extends $dara.Model {
22750
22963
  management?: DescribeClusterNodePoolDetailResponseBodyManagement;
22751
22964
  /**
22752
22965
  * @remarks
22753
- * The maximum number of nodes that are supported by the edge node pool. The value of this parameter must be equal to or greater than 0. A value of 0 indicates that the number of nodes in the node pool is limited only by the quota of nodes in the cluster. In most cases, this parameter is set to a value larger than 0 for edge node pools. This parameter is set to 0 for node pools whose types are ess or default edge node pools.
22966
+ * This parameter is deprecated.
22967
+ *
22968
+ * The maximum number of nodes allowed in an edge node pool.
22754
22969
  *
22755
22970
  * @example
22756
22971
  * 10
@@ -23144,6 +23359,9 @@ export class DescribeClusterResourcesRequest extends $dara.Model {
23144
23359
  /**
23145
23360
  * @remarks
23146
23361
  * Specifies whether to query the resources created by cluster components.
23362
+ *
23363
+ * @example
23364
+ * false
23147
23365
  */
23148
23366
  withAddonResources?: boolean;
23149
23367
  static names(): { [key: string]: string } {
@@ -23687,7 +23905,10 @@ export class DescribeClustersForRegionRequest extends $dara.Model {
23687
23905
  clusterId?: string;
23688
23906
  /**
23689
23907
  * @remarks
23690
- * The specification of the cluster.
23908
+ * The specification of the clusters to query. Valid values:
23909
+ *
23910
+ * * ack.pro.small: ACK Pro clusters.
23911
+ * * ack.standard: ACK Basic clusters.
23691
23912
  *
23692
23913
  * @example
23693
23914
  * ack.standard
@@ -23695,7 +23916,11 @@ export class DescribeClustersForRegionRequest extends $dara.Model {
23695
23916
  clusterSpec?: string;
23696
23917
  /**
23697
23918
  * @remarks
23698
- * The type of the cluster.
23919
+ * The type of the clusters to query. Valid values:
23920
+ *
23921
+ * * Kubernetes: ACK dedicated clusters.
23922
+ * * ManagedKubernetes: ACK managed clusters. ACK managed clusters include ACK Basic clusters, ACK Pro clusters, ACK Serverless Basic clusters, ACK Serverless Pro clusters, ACK Edge Basic clusters, ACK Edge Pro clusters, and ACK Lingjun Pro clusters.
23923
+ * * ExternalKubernetes: registered clusters.
23699
23924
  *
23700
23925
  * @example
23701
23926
  * Kubernetes
@@ -23727,7 +23952,12 @@ export class DescribeClustersForRegionRequest extends $dara.Model {
23727
23952
  pageSize?: number;
23728
23953
  /**
23729
23954
  * @remarks
23730
- * The identifier of the cluster.
23955
+ * The subtype of the clusters to query. Valid values:
23956
+ *
23957
+ * * Default: ACK managed clusters. ACK managed clusters include ACK Basic clusters and ACK Pro clusters.
23958
+ * * Edge: ACK Edge clusters. ACK Edge clusters include ACK Edge Basic clusters and ACK Edge Pro clusters.
23959
+ * * Serverless: ACK Serverless clusters. ACK Serverless clusters include ACK Serverless Basic clusters and ACK Serverless Pro clusters.
23960
+ * * Lingjun: ACK Lingjun Pro clusters.
23731
23961
  *
23732
23962
  * @example
23733
23963
  * Serverless
@@ -23769,7 +23999,7 @@ export class DescribeClustersForRegionRequest extends $dara.Model {
23769
23999
  export class DescribeClustersForRegionResponseBody extends $dara.Model {
23770
24000
  /**
23771
24001
  * @remarks
23772
- * The details of the clusters.
24002
+ * The information about the clusters returned.
23773
24003
  */
23774
24004
  clusters?: DescribeClustersForRegionResponseBodyClusters[];
23775
24005
  /**
@@ -23956,7 +24186,7 @@ export class DescribeClustersV1Request extends $dara.Model {
23956
24186
  export class DescribeClustersV1ResponseBody extends $dara.Model {
23957
24187
  /**
23958
24188
  * @remarks
23959
- * Details of the clusters.
24189
+ * The queried cluster(s) details.
23960
24190
  */
23961
24191
  clusters?: DescribeClustersV1ResponseBodyClusters[];
23962
24192
  /**
@@ -27576,7 +27806,7 @@ export class GetUpgradeStatusResponse extends $dara.Model {
27576
27806
  export class GrantPermissionsRequest extends $dara.Model {
27577
27807
  /**
27578
27808
  * @remarks
27579
- * The request parameters.
27809
+ * The request body.
27580
27810
  */
27581
27811
  body?: GrantPermissionsRequestBody[];
27582
27812
  static names(): { [key: string]: string } {
@@ -27668,7 +27898,7 @@ export class InstallClusterAddonsRequest extends $dara.Model {
27668
27898
  export class InstallClusterAddonsResponseBody extends $dara.Model {
27669
27899
  /**
27670
27900
  * @remarks
27671
- * The ID of the cluster.
27901
+ * The cluster ID.
27672
27902
  *
27673
27903
  * @example
27674
27904
  * c82e6987e2961451182edacd74faf****
@@ -27676,7 +27906,7 @@ export class InstallClusterAddonsResponseBody extends $dara.Model {
27676
27906
  clusterId?: string;
27677
27907
  /**
27678
27908
  * @remarks
27679
- * The ID of the request.
27909
+ * The request ID.
27680
27910
  *
27681
27911
  * @example
27682
27912
  * 48BD70F6-A7E6-543D-9F23-08DEB764C92E
@@ -27684,7 +27914,7 @@ export class InstallClusterAddonsResponseBody extends $dara.Model {
27684
27914
  requestId?: string;
27685
27915
  /**
27686
27916
  * @remarks
27687
- * The ID of the task.
27917
+ * The task ID.
27688
27918
  *
27689
27919
  * @example
27690
27920
  * T-5a54309c80282e39ea00002f
@@ -28332,7 +28562,7 @@ export class ListTagResourcesRequest extends $dara.Model {
28332
28562
  resourceType?: string;
28333
28563
  /**
28334
28564
  * @remarks
28335
- * The labels that you want to query. You can specify up to 20 labels.
28565
+ * The list of labels that you want to query. You can specify up to 20 labels.
28336
28566
  *
28337
28567
  * @example
28338
28568
  * [{\\"key\\":\\"env\\",\\"value\\",\\"dev\\"},{\\"key\\":\\"dev\\", \\"value\\":\\"IT\\"}]
@@ -28414,7 +28644,7 @@ export class ListTagResourcesShrinkRequest extends $dara.Model {
28414
28644
  resourceType?: string;
28415
28645
  /**
28416
28646
  * @remarks
28417
- * The labels that you want to query. You can specify up to 20 labels.
28647
+ * The list of labels that you want to query. You can specify up to 20 labels.
28418
28648
  *
28419
28649
  * @example
28420
28650
  * [{\\"key\\":\\"env\\",\\"value\\",\\"dev\\"},{\\"key\\":\\"dev\\", \\"value\\":\\"IT\\"}]
@@ -28812,7 +29042,7 @@ export class ModifyClusterRequest extends $dara.Model {
28812
29042
  apiServerEipId?: string;
28813
29043
  /**
28814
29044
  * @remarks
28815
- * The name of the cluster.
29045
+ * The cluster name.
28816
29046
  *
28817
29047
  * The cluster name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). The cluster name cannot start with a hyphen (-).
28818
29048
  *
@@ -28832,7 +29062,7 @@ export class ModifyClusterRequest extends $dara.Model {
28832
29062
  * * `true`: enables cluster deletion protection.
28833
29063
  * * `false`: disables cluster deletion protection.
28834
29064
  *
28835
- * Default value: `false`.
29065
+ * Default value: `false`
28836
29066
  *
28837
29067
  * @example
28838
29068
  * true
@@ -28856,7 +29086,7 @@ export class ModifyClusterRequest extends $dara.Model {
28856
29086
  * * `true`: remaps the test domain name of the cluster.
28857
29087
  * * `false`: does not remap the test domain name of the cluster.
28858
29088
  *
28859
- * Default value: `false`.
29089
+ * Default value: `false`
28860
29090
  *
28861
29091
  * @example
28862
29092
  * true
@@ -28877,7 +29107,7 @@ export class ModifyClusterRequest extends $dara.Model {
28877
29107
  * * `true`: enables instance deletion protection.
28878
29108
  * * `false`: disables instance deletion protection.
28879
29109
  *
28880
- * Default value: `false`.
29110
+ * Default value: `false`
28881
29111
  *
28882
29112
  * @example
28883
29113
  * true
@@ -28901,17 +29131,56 @@ export class ModifyClusterRequest extends $dara.Model {
28901
29131
  * rg-acfmyvw3wjm****
28902
29132
  */
28903
29133
  resourceGroupId?: string;
29134
+ /**
29135
+ * @remarks
29136
+ * The ID of the security group for the control plane.
29137
+ *
29138
+ * - If block rules are configured in the security group, ensure the security group rules allow traffic for protocols and ports required by the cluster. For recommended security group rules, see [Configure and manage security groups for an ACK cluster](https://www.alibabacloud.com/help/en/ack/ack-managed-and-ack-dedicated/user-guide/configure-security-group-rules-to-enforce-access-control-on-ack-clusters?spm=a2c63.p38356.help-menu-85222.d_2_0_4_3.43e35d09s8oSlR).
29139
+ *
29140
+ * - For non-ACK dedicated clusters:
29141
+ * - During security group updates, the cluster control plane and managed components (e.g., terway-controlplane) will restart briefly. Perform this operation during off-peak hours.
29142
+ * - After updating the control plane security group, the Elastic Network Interfaces (ENIs) used by the control plane and managed components will automatically join the new security group.
29143
+ *
29144
+ * - For ACK dedicated clusters:
29145
+ * - After updating the control plane security group, newly scaled-out master nodes will automatically apply the new security group. Existing control plane nodes remain unaffected.
29146
+ *
29147
+ * @example
29148
+ * sg-bp1h6rk3pgct2a08***
29149
+ */
29150
+ securityGroupId?: string;
28904
29151
  /**
28905
29152
  * @remarks
28906
29153
  * The storage configurations of system events.
28907
29154
  */
28908
29155
  systemEventsLogging?: ModifyClusterRequestSystemEventsLogging;
29156
+ /**
29157
+ * @remarks
29158
+ * The time zone configuration for the cluster.
29159
+ *
29160
+ * - After modifying the time zone, cluster inspection configurations will adopt the new time zone.
29161
+ *
29162
+ * - For ACK managed clusters:
29163
+ * - During time zone updates, the cluster control plane and managed components (e.g., terway-controlplane) will restart briefly. Perform this operation during off-peak hours.
29164
+ * - After updating the time zone:
29165
+ * - Newly scaled-out nodes will automatically apply the new time zone.
29166
+ * - Existing nodes remain unaffected. Reset the node to apply changes to existing nodes.
29167
+ *
29168
+ * - For ACK dedicated clusters:
29169
+ * - After updating the time zone:
29170
+ * - Newly scaled-out nodes (including control plane nodes) automatically apply the new time zone.
29171
+ * - Existing nodes (including control plane nodes) remain unaffected. Reset the node to apply changes to existing nodes.
29172
+ * - For control plane nodes, perform a scale-out followed by a scale-in to apply the new time zone to all control plane nodes.
29173
+ *
29174
+ * @example
29175
+ * Asia/Shanghai
29176
+ */
29177
+ timezone?: string;
28909
29178
  /**
28910
29179
  * @remarks
28911
29180
  * The vSwitches of the control plane. This parameter can be used to change the vSwitches of the control plane in an ACK managed cluster. Take note of the following items:
28912
29181
  *
28913
29182
  * * This parameter overwrites the existing configuration. You must specify all vSwitches of the control plane.
28914
- * * The control plane restarts during the change process. Exercise caution when you perform this operation.
29183
+ * * The control plane components restarts during the change process. Exercise caution when you perform this operation.
28915
29184
  * * Ensure that all security groups of the cluster, including the security groups of the control plane, all node pools, and container network, are allowed to access the CIDR blocks of the new vSwitches. This ensures that the nodes and containers can connect to the API server.
28916
29185
  * * If the new vSwitches of the control plane are configured with an ACL, ensure that the ACL allows communication between the new vSwitches and CIDR blocks such as those of the cluster nodes and the container network.
28917
29186
  */
@@ -28932,7 +29201,9 @@ export class ModifyClusterRequest extends $dara.Model {
28932
29201
  maintenanceWindow: 'maintenance_window',
28933
29202
  operationPolicy: 'operation_policy',
28934
29203
  resourceGroupId: 'resource_group_id',
29204
+ securityGroupId: 'security_group_id',
28935
29205
  systemEventsLogging: 'system_events_logging',
29206
+ timezone: 'timezone',
28936
29207
  vswitchIds: 'vswitch_ids',
28937
29208
  };
28938
29209
  }
@@ -28953,7 +29224,9 @@ export class ModifyClusterRequest extends $dara.Model {
28953
29224
  maintenanceWindow: MaintenanceWindow,
28954
29225
  operationPolicy: ModifyClusterRequestOperationPolicy,
28955
29226
  resourceGroupId: 'string',
29227
+ securityGroupId: 'string',
28956
29228
  systemEventsLogging: ModifyClusterRequestSystemEventsLogging,
29229
+ timezone: 'string',
28957
29230
  vswitchIds: { 'type': 'array', 'itemType': 'string' },
28958
29231
  };
28959
29232
  }
@@ -29217,7 +29490,7 @@ export class ModifyClusterNodePoolRequest extends $dara.Model {
29217
29490
  management?: ModifyClusterNodePoolRequestManagement;
29218
29491
  /**
29219
29492
  * @remarks
29220
- * The configurations of the node pool.
29493
+ * The configuration of the node pool.
29221
29494
  */
29222
29495
  nodepoolInfo?: ModifyClusterNodePoolRequestNodepoolInfo;
29223
29496
  /**
@@ -29439,7 +29712,7 @@ export class ModifyNodePoolNodeConfigRequest extends $dara.Model {
29439
29712
  containerdConfig?: ContainerdConfig;
29440
29713
  /**
29441
29714
  * @remarks
29442
- * The parameters of the kubelet.
29715
+ * The kubelet configuration.
29443
29716
  */
29444
29717
  kubeletConfig?: KubeletConfig;
29445
29718
  /**
@@ -29449,7 +29722,7 @@ export class ModifyNodePoolNodeConfigRequest extends $dara.Model {
29449
29722
  osConfig?: ModifyNodePoolNodeConfigRequestOsConfig;
29450
29723
  /**
29451
29724
  * @remarks
29452
- * The rolling policy configuration.
29725
+ * The rolling update configuration.
29453
29726
  */
29454
29727
  rollingPolicy?: ModifyNodePoolNodeConfigRequestRollingPolicy;
29455
29728
  static names(): { [key: string]: string } {
@@ -30213,7 +30486,11 @@ export class RemoveNodePoolNodesResponse extends $dara.Model {
30213
30486
  export class RepairClusterNodePoolRequest extends $dara.Model {
30214
30487
  /**
30215
30488
  * @remarks
30216
- * Specifies whether to restart the instance of the node.
30489
+ * Specifies whether to enable automatic instance restart.
30490
+ *
30491
+ * **
30492
+ *
30493
+ * **Warning** This parameter is deprecated. Any configured values will be ignored.
30217
30494
  *
30218
30495
  * @example
30219
30496
  * true
@@ -30223,12 +30500,12 @@ export class RepairClusterNodePoolRequest extends $dara.Model {
30223
30500
  autoRestart?: boolean;
30224
30501
  /**
30225
30502
  * @remarks
30226
- * The list of nodes. If you do not specify nodes, all nodes in the node pool are selected.
30503
+ * The list of nodes. If not specified, all nodes in the node pool are selected.
30227
30504
  */
30228
30505
  nodes?: string[];
30229
30506
  /**
30230
30507
  * @remarks
30231
- * The repair operation to be performed. If not specified, all repair operations will be executed by default. Generally, there is no need to specify this in most scenarios.
30508
+ * The list of repair operations to execute. If not specified, all repair operations are executed. Typically, you do not need to specify this parameter.
30232
30509
  */
30233
30510
  operations?: RepairClusterNodePoolRequestOperations[];
30234
30511
  static names(): { [key: string]: string } {
@@ -30883,7 +31160,7 @@ export class ScaleOutClusterRequest extends $dara.Model {
30883
31160
  count?: number;
30884
31161
  /**
30885
31162
  * @remarks
30886
- * The CPU management policy of nodes. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
31163
+ * The CPU management policy of nodes in the node pool. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
30887
31164
  *
30888
31165
  * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
30889
31166
  * * `none`: specifies that the default CPU affinity is used.
@@ -30934,15 +31211,15 @@ export class ScaleOutClusterRequest extends $dara.Model {
30934
31211
  runtime?: Runtime;
30935
31212
  /**
30936
31213
  * @remarks
30937
- * The tags that you want to add to nodes. When you add labels to a node, the following rules apply:
31214
+ * The labels that you want to add to the node. When you add labels to a node, the following rules apply:
30938
31215
  *
30939
31216
  * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
30940
- * * When you add a tag, you must specify a unique key but you can leave the value empty. A key cannot exceed 64 characters in length and a value cannot exceed 128 characters in length. Keys and values cannot start with aliyun, acs:, https://, or http://. For more information, see [Labels and Selectors](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#syntax-and-character-set).
31217
+ * * The key must be unique and cannot exceed 64 characters in length. The value can be empty and cannot exceed 128 characters in length. Keys and values cannot start with aliyun, acs:, https://, or http://. For more information, see [Labels and Selectors](https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#syntax-and-character-set).
30941
31218
  */
30942
31219
  tags?: Tag[];
30943
31220
  /**
30944
31221
  * @remarks
30945
- * The taints that you want to add to nodes. Taints can be used together with tolerations to prevent pods from being scheduled to specific nodes. For more information, see [taint-and-toleration](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/).
31222
+ * The taints that you want to add to nodes. Taints can be used together with tolerations to avoid scheduling pods to specified nodes. For more information, see [taint-and-toleration](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/).
30946
31223
  */
30947
31224
  taints?: Taint[];
30948
31225
  /**
@@ -30965,9 +31242,9 @@ export class ScaleOutClusterRequest extends $dara.Model {
30965
31242
  * Specifies whether to enable auto-renewal for worker nodes. This parameter takes effect and is required only if `worker_instance_charge_type` is set to `PrePaid`. Valid values:
30966
31243
  *
30967
31244
  * * `true`: enables auto-renewal.
30968
- * * `false`: disables auto-renewal.
31245
+ * * `false`: does not enable auto-renewal.
30969
31246
  *
30970
- * Default value: `true`.
31247
+ * Default value: `true`
30971
31248
  *
30972
31249
  * @example
30973
31250
  * true
@@ -30997,7 +31274,7 @@ export class ScaleOutClusterRequest extends $dara.Model {
30997
31274
  * * `PrePaid`: subscription.
30998
31275
  * * `PostPaid`: pay-as-you-go.
30999
31276
  *
31000
- * Default value: `PostPaid`
31277
+ * Default value: `PostPaid`.
31001
31278
  *
31002
31279
  * @example
31003
31280
  * PrePaid
@@ -31016,7 +31293,7 @@ export class ScaleOutClusterRequest extends $dara.Model {
31016
31293
  *
31017
31294
  * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
31018
31295
  *
31019
- * Default value: 1
31296
+ * Default value: 1.
31020
31297
  *
31021
31298
  * @example
31022
31299
  * 1
@@ -31026,7 +31303,7 @@ export class ScaleOutClusterRequest extends $dara.Model {
31026
31303
  * @remarks
31027
31304
  * The billing cycle of worker nodes. This parameter is required only if worker_instance_charge_type is set to `PrePaid`.
31028
31305
  *
31029
- * Set the value to `Month`. Worker nodes are billed only on a monthly basis.
31306
+ * Set the value to `Month`.
31030
31307
  *
31031
31308
  * @example
31032
31309
  * Month
@@ -31034,7 +31311,7 @@ export class ScaleOutClusterRequest extends $dara.Model {
31034
31311
  workerPeriodUnit?: string;
31035
31312
  /**
31036
31313
  * @remarks
31037
- * The system disk type of worker nodes. Valid values:
31314
+ * The system disk category of worker nodes. Valid values:
31038
31315
  *
31039
31316
  * * `cloud_efficiency`: ultra disk.
31040
31317
  * * `cloud_ssd`: standard SSD.
@@ -31307,7 +31584,7 @@ export class ScanClusterVulsResponse extends $dara.Model {
31307
31584
  export class StartAlertRequest extends $dara.Model {
31308
31585
  /**
31309
31586
  * @remarks
31310
- * The name of the alert rule set to be enabled.
31587
+ * The name of the alert rule group.
31311
31588
  *
31312
31589
  * @example
31313
31590
  * sample
@@ -31315,7 +31592,7 @@ export class StartAlertRequest extends $dara.Model {
31315
31592
  alertRuleGroupName?: string;
31316
31593
  /**
31317
31594
  * @remarks
31318
- * The name of the alert rule to be enabled. If you do not specify an alert rule name, the alert rule set is enabled.
31595
+ * The name of the alert rule.
31319
31596
  *
31320
31597
  * @example
31321
31598
  * sample
@@ -31422,7 +31699,7 @@ export class StartAlertResponse extends $dara.Model {
31422
31699
  export class StopAlertRequest extends $dara.Model {
31423
31700
  /**
31424
31701
  * @remarks
31425
- * The name of the alert rule set to be disabled.
31702
+ * The name of the alert rule group.
31426
31703
  *
31427
31704
  * @example
31428
31705
  * sample
@@ -31430,7 +31707,7 @@ export class StopAlertRequest extends $dara.Model {
31430
31707
  alertRuleGroupName?: string;
31431
31708
  /**
31432
31709
  * @remarks
31433
- * The name of the alert rule to be disabled. If you do not specify an alert rule name, the alert rule set is disabled.
31710
+ * The name of the alert rule.
31434
31711
  *
31435
31712
  * @example
31436
31713
  * sample
@@ -31622,7 +31899,7 @@ export class TagResourcesRequest extends $dara.Model {
31622
31899
  resourceIds?: string[];
31623
31900
  /**
31624
31901
  * @remarks
31625
- * The type of resources that you want to label. Valid value: `CLUSTER`.
31902
+ * The type of resources that you want to label. Set the value to `CLUSTER`.
31626
31903
  *
31627
31904
  * This parameter is required.
31628
31905
  *
@@ -31634,9 +31911,9 @@ export class TagResourcesRequest extends $dara.Model {
31634
31911
  * @remarks
31635
31912
  * The tags that you want to add to the resources in key-value pairs. You can add up to 20 key-value pairs. Note:
31636
31913
  *
31637
- * * The values must not be empty strings. A value must be 1 to 128 characters in length.
31638
- * * A key or value must not start with `aliyun` or `acs:`.
31639
- * * A key or value must not contain `http://` or `https://`.
31914
+ * * The values cannot be empty strings. A value must be 1 to 128 characters in length.
31915
+ * * A key or value cannot start with `aliyun` or `acs:`.
31916
+ * * A key or value cannot contain `http://` or `https://`.
31640
31917
  *
31641
31918
  * This parameter is required.
31642
31919
  */
@@ -32089,10 +32366,10 @@ export class UpdateClusterAuditLogConfigRequest extends $dara.Model {
32089
32366
  disable?: boolean;
32090
32367
  /**
32091
32368
  * @remarks
32092
- * The [Simple Log Service project](https://help.aliyun.com/document_detail/48873.html) to which the [Logstore](https://help.aliyun.com/document_detail/48873.html) that stores the cluster audit logs belongs.
32369
+ * The [Simple Log Service project](https://help.aliyun.com/document_detail/48873.html) to which the [Logstore](https://help.aliyun.com/document_detail/48873.html) storing the cluster audit logs belongs.
32093
32370
  *
32094
32371
  * * Default value: k8s-log-{clusterid}.
32095
- * * After the cluster audit log feature is enabled, a Logstore is created in the specified SLS project to store the cluster audit logs.
32372
+ * * After the cluster audit log feature is enabled, a Logstore is created in the specified Simple Log Service project to store cluster audit logs.
32096
32373
  * * If you want to change the project after audit logging is enabled for the cluster, you can use this parameter to specify another project. You can perform this operation only in ACK managed clusters.
32097
32374
  *
32098
32375
  * @example
@@ -32208,9 +32485,34 @@ export class UpdateClusterAuditLogConfigResponse extends $dara.Model {
32208
32485
  }
32209
32486
 
32210
32487
  export class UpdateContactGroupForAlertRequest extends $dara.Model {
32488
+ /**
32489
+ * @remarks
32490
+ * The name of the alert contact group.
32491
+ *
32492
+ * @example
32493
+ * sample
32494
+ */
32211
32495
  alertRuleGroupName?: string;
32496
+ /**
32497
+ * @remarks
32498
+ * The list of contact group IDs.
32499
+ */
32212
32500
  contactGroupIds?: number[];
32501
+ /**
32502
+ * @remarks
32503
+ * The name of the container registry instance.
32504
+ *
32505
+ * @example
32506
+ * sample
32507
+ */
32213
32508
  crName?: string;
32509
+ /**
32510
+ * @remarks
32511
+ * The namespace in which the resource resides.
32512
+ *
32513
+ * @example
32514
+ * default
32515
+ */
32214
32516
  namespace?: string;
32215
32517
  static names(): { [key: string]: string } {
32216
32518
  return {
@@ -32243,7 +32545,24 @@ export class UpdateContactGroupForAlertRequest extends $dara.Model {
32243
32545
  }
32244
32546
 
32245
32547
  export class UpdateContactGroupForAlertResponseBody extends $dara.Model {
32548
+ /**
32549
+ * @remarks
32550
+ * The error message returned if the call fails.
32551
+ *
32552
+ * @example
32553
+ * contact group illegal.
32554
+ */
32246
32555
  msg?: string;
32556
+ /**
32557
+ * @remarks
32558
+ * The update status.
32559
+ *
32560
+ * * true: The update is successful.
32561
+ * * false: The update failed.
32562
+ *
32563
+ * @example
32564
+ * true
32565
+ */
32247
32566
  status?: boolean;
32248
32567
  static names(): { [key: string]: string } {
32249
32568
  return {
@@ -32817,8 +33136,8 @@ export class UpdateUserPermissionsRequest extends $dara.Model {
32817
33136
  * The authorization method. Valid values:
32818
33137
  *
32819
33138
  * * `apply`: updates all permissions of the RAM user or RAM role. If you use this method, the existing permissions of the RAM user or RAM role on the cluster are overwritten. You must specify all the permissions that you want to grant to the RAM user or RAM role in the request parameters when you call the operation.
32820
- * * `delete`: revokes the specified permissions from the RAM user or RAM role. If you use this method, only the permissions that you specify are revoked, other permissions of the RAM user or RAM role on the cluster are not affected.
32821
- * * `patch`: grants the specified permissions to the RAM user or role. If you use this method, only the permissions that you specify are granted, other permissions of the RAM user or RAM role on the cluster are not affected.
33139
+ * * `delete`: revokes the specified permissions from the RAM user or RAM role. If you use this method, only the permissions that you specify are revoked, while other permissions of the RAM user or RAM role on the cluster are not affected.
33140
+ * * `patch`: grants the specified permissions to the RAM user or role. If you use this method, only the permissions that you specify are granted, while other permissions of the RAM user or RAM role on the cluster are not affected.
32822
33141
  *
32823
33142
  * Default value: `apply`.
32824
33143
  *
@@ -32884,7 +33203,7 @@ export class UpdateUserPermissionsResponse extends $dara.Model {
32884
33203
  export class UpgradeClusterRequest extends $dara.Model {
32885
33204
  /**
32886
33205
  * @remarks
32887
- * This parameter is deprecated.
33206
+ * This parameter is deprecated. No need to pass values.
32888
33207
  *
32889
33208
  * @example
32890
33209
  * k8s
@@ -32894,10 +33213,10 @@ export class UpgradeClusterRequest extends $dara.Model {
32894
33213
  componentName?: string;
32895
33214
  /**
32896
33215
  * @remarks
32897
- * Specifies whether to update only the master nodes. Valid values:
33216
+ * Specifies whether to upgrade only master nodes. Valid values:
32898
33217
  *
32899
- * * true: updates only the master nodes.
32900
- * * false: updates the master nodes and worker nodes.
33218
+ * * true: upgrades master nodes only.
33219
+ * * false: upgrades both master and worker nodes.
32901
33220
  *
32902
33221
  * @example
32903
33222
  * true
@@ -32905,7 +33224,7 @@ export class UpgradeClusterRequest extends $dara.Model {
32905
33224
  masterOnly?: boolean;
32906
33225
  /**
32907
33226
  * @remarks
32908
- * The Kubernetes version to which you want to update the cluster.
33227
+ * The target Kubernetes version for cluster upgrade.
32909
33228
  *
32910
33229
  * @example
32911
33230
  * 1.16.9-aliyun.1
@@ -32913,12 +33232,12 @@ export class UpgradeClusterRequest extends $dara.Model {
32913
33232
  nextVersion?: string;
32914
33233
  /**
32915
33234
  * @remarks
32916
- * The rotation configuration.
33235
+ * The rolling update configuration.
32917
33236
  */
32918
33237
  rollingPolicy?: UpgradeClusterRequestRollingPolicy;
32919
33238
  /**
32920
33239
  * @remarks
32921
- * This parameter is deprecated. Specify the Kubernetes version by using the next_version parameter.
33240
+ * This parameter is deprecated. Use next_version to specify the upgrade target Kubernetes version.
32922
33241
  *
32923
33242
  * @example
32924
33243
  * 1.14.8-aliyun.1
@@ -33757,7 +34076,7 @@ export default class Client extends OpenApi {
33757
34076
  }
33758
34077
 
33759
34078
  /**
33760
- * Checks whether the specified service role is granted required permissions within the current Alibaba Cloud account.
34079
+ * Checks whether the specified service roles are granted to Container Service for Kubernetes (ACK) within the current Alibaba Cloud account. ACK can access other cloud services, such as Elastic Compute Service (ECS), Object Storage Service (OSS), File Storage NAS (NAS), and Server Load Balancer (SLB), only after ACK is assigned the required service roles.
33761
34080
  *
33762
34081
  * @param request - CheckServiceRoleRequest
33763
34082
  * @param headers - map
@@ -33795,7 +34114,7 @@ export default class Client extends OpenApi {
33795
34114
  }
33796
34115
 
33797
34116
  /**
33798
- * Checks whether the specified service role is granted required permissions within the current Alibaba Cloud account.
34117
+ * Checks whether the specified service roles are granted to Container Service for Kubernetes (ACK) within the current Alibaba Cloud account. ACK can access other cloud services, such as Elastic Compute Service (ECS), Object Storage Service (OSS), File Storage NAS (NAS), and Server Load Balancer (SLB), only after ACK is assigned the required service roles.
33799
34118
  *
33800
34119
  * @param request - CheckServiceRoleRequest
33801
34120
  * @returns CheckServiceRoleResponse
@@ -34049,16 +34368,16 @@ export default class Client extends OpenApi {
34049
34368
  }
34050
34369
 
34051
34370
  /**
34052
- * You can call the CreateCluster operation to create a Container Service for Kubernetes (ACK) cluster. ACK clusters include ACK managed clusters, ACK dedicated clusters, ACK Serverless clusters, ACK Edge clusters, ACK clusters that support sandboxed containers, and registered clusters. For more information about how to create different types of ACK clusters, see the following usage notes.
34371
+ * Creates a Container Service for Kubernetes (ACK) cluster. For example, you can create an ACK managed cluster, ACK Serverless cluster, ACK Edge cluster, or registered cluster. When you create an ACK cluster, you need to configure the cluster information, components, and cloud resources used by ACK.
34053
34372
  *
34054
34373
  * @remarks
34055
- * This topic describes all request parameters for creating a Container Service for Kubernetes (ACK) cluster. For more information about how to call the API to create each type of ACK cluster, refer to the following topics:
34056
- * * [Call the API to create an ACK managed cluster](https://help.aliyun.com/document_detail/90776.html)
34057
- * * [Call the API to create an ACK dedicated cluster](https://help.aliyun.com/document_detail/197620.html)
34058
- * * [Call the API to create an ACK Serverless cluster](https://help.aliyun.com/document_detail/144246.html)
34059
- * * [Call the API to create an ACK Edge cluster](https://help.aliyun.com/document_detail/128204.html)
34060
- * * [Call the API to create an ACK Basic cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/196321.html)
34061
- * * [Call the API to create an ACK Pro cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/140623.html)
34374
+ * ### [](#-openapi-)Generate API request parameters in the ACK console
34375
+ * When you fail to create an ACK cluster by calling the CreateCluster operation due to invalid parameter settings, you can generate valid API request parameters in the ACK console. Procedure:
34376
+ * 1. Log on to the [ACK console](javascript:void\\(0\\)). In the left-side navigation pane, click **Clusters**.
34377
+ * 2. On the **Cluster** page, click **Cluster Templates**.
34378
+ * 3. In the Select Cluster Template dialog box, select the type of cluster that you want to create and click Create. Then, configure the cluster setting parameters.
34379
+ * 4. After you configure the cluster parameters, click **Generate API Request Parameters** in the **Confirm Order** step.
34380
+ * The API request parameters are displayed in the API Request Parameters dialog box.
34062
34381
  *
34063
34382
  * @param request - CreateClusterRequest
34064
34383
  * @param headers - map
@@ -34484,16 +34803,16 @@ export default class Client extends OpenApi {
34484
34803
  }
34485
34804
 
34486
34805
  /**
34487
- * You can call the CreateCluster operation to create a Container Service for Kubernetes (ACK) cluster. ACK clusters include ACK managed clusters, ACK dedicated clusters, ACK Serverless clusters, ACK Edge clusters, ACK clusters that support sandboxed containers, and registered clusters. For more information about how to create different types of ACK clusters, see the following usage notes.
34806
+ * Creates a Container Service for Kubernetes (ACK) cluster. For example, you can create an ACK managed cluster, ACK Serverless cluster, ACK Edge cluster, or registered cluster. When you create an ACK cluster, you need to configure the cluster information, components, and cloud resources used by ACK.
34488
34807
  *
34489
34808
  * @remarks
34490
- * This topic describes all request parameters for creating a Container Service for Kubernetes (ACK) cluster. For more information about how to call the API to create each type of ACK cluster, refer to the following topics:
34491
- * * [Call the API to create an ACK managed cluster](https://help.aliyun.com/document_detail/90776.html)
34492
- * * [Call the API to create an ACK dedicated cluster](https://help.aliyun.com/document_detail/197620.html)
34493
- * * [Call the API to create an ACK Serverless cluster](https://help.aliyun.com/document_detail/144246.html)
34494
- * * [Call the API to create an ACK Edge cluster](https://help.aliyun.com/document_detail/128204.html)
34495
- * * [Call the API to create an ACK Basic cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/196321.html)
34496
- * * [Call the API to create an ACK Pro cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/140623.html)
34809
+ * ### [](#-openapi-)Generate API request parameters in the ACK console
34810
+ * When you fail to create an ACK cluster by calling the CreateCluster operation due to invalid parameter settings, you can generate valid API request parameters in the ACK console. Procedure:
34811
+ * 1. Log on to the [ACK console](javascript:void\\(0\\)). In the left-side navigation pane, click **Clusters**.
34812
+ * 2. On the **Cluster** page, click **Cluster Templates**.
34813
+ * 3. In the Select Cluster Template dialog box, select the type of cluster that you want to create and click Create. Then, configure the cluster setting parameters.
34814
+ * 4. After you configure the cluster parameters, click **Generate API Request Parameters** in the **Confirm Order** step.
34815
+ * The API request parameters are displayed in the API Request Parameters dialog box.
34497
34816
  *
34498
34817
  * @param request - CreateClusterRequest
34499
34818
  * @returns CreateClusterResponse
@@ -35025,6 +35344,14 @@ export default class Client extends OpenApi {
35025
35344
  /**
35026
35345
  * You can call the DeleteCluster operation to delete a cluster and specify whether to delete or retain the relevant cluster resources. Before you delete a cluster, you must manually delete workloads in the cluster, such as Deployments, StatefulSets, Jobs, and CronJobs. Otherwise, you may fail to delete the cluster.
35027
35346
  *
35347
+ * @remarks
35348
+ * Warning:
35349
+ * * Subscription ECS instances and Lingjun nodes in a cluster cannot be automatically released. To avoid unnecessary costs, we recommend that you manually release the resources. For more information, see \\<a href="{0}" target="_blank">Rules for deleting clusters and releasing nodes\\</a>.
35350
+ * * If the SLB instance of the API server uses the subscription billing method, it cannot be automatically released. To avoid unnecessary costs, we recommend that you manually release it.
35351
+ * * By default, virtual private clouds (VPCs), vSwitches, security groups, and RAM roles are retained if they are used by other resources. To avoid unnecessary costs, we recommend that you manually release the resources.
35352
+ * * Elastic container instances created on virtual nodes are automatically released.
35353
+ * * Some resources created together with a cluster are not automatically released when the cluster is deleted. After the cluster is deleted, you are still charged for the resources. Release or retain the resources based on your actual needs. The resources include Simple Log Service projects automatically created by the cluster and dynamically provisioned disks.
35354
+ *
35028
35355
  * @param tmpReq - DeleteClusterRequest
35029
35356
  * @param headers - map
35030
35357
  * @param runtime - runtime options for this request RuntimeOptions
@@ -35085,6 +35412,14 @@ export default class Client extends OpenApi {
35085
35412
  /**
35086
35413
  * You can call the DeleteCluster operation to delete a cluster and specify whether to delete or retain the relevant cluster resources. Before you delete a cluster, you must manually delete workloads in the cluster, such as Deployments, StatefulSets, Jobs, and CronJobs. Otherwise, you may fail to delete the cluster.
35087
35414
  *
35415
+ * @remarks
35416
+ * Warning:
35417
+ * * Subscription ECS instances and Lingjun nodes in a cluster cannot be automatically released. To avoid unnecessary costs, we recommend that you manually release the resources. For more information, see \\<a href="{0}" target="_blank">Rules for deleting clusters and releasing nodes\\</a>.
35418
+ * * If the SLB instance of the API server uses the subscription billing method, it cannot be automatically released. To avoid unnecessary costs, we recommend that you manually release it.
35419
+ * * By default, virtual private clouds (VPCs), vSwitches, security groups, and RAM roles are retained if they are used by other resources. To avoid unnecessary costs, we recommend that you manually release the resources.
35420
+ * * Elastic container instances created on virtual nodes are automatically released.
35421
+ * * Some resources created together with a cluster are not automatically released when the cluster is deleted. After the cluster is deleted, you are still charged for the resources. Release or retain the resources based on your actual needs. The resources include Simple Log Service projects automatically created by the cluster and dynamically provisioned disks.
35422
+ *
35088
35423
  * @param request - DeleteClusterRequest
35089
35424
  * @returns DeleteClusterResponse
35090
35425
  */
@@ -35913,6 +36248,10 @@ export default class Client extends OpenApi {
35913
36248
  body["arch"] = request.arch;
35914
36249
  }
35915
36250
 
36251
+ if (!$dara.isNull(request.expired)) {
36252
+ body["expired"] = request.expired;
36253
+ }
36254
+
35916
36255
  if (!$dara.isNull(request.formatDisk)) {
35917
36256
  body["format_disk"] = request.formatDisk;
35918
36257
  }
@@ -37059,7 +37398,7 @@ export default class Client extends OpenApi {
37059
37398
  }
37060
37399
 
37061
37400
  /**
37062
- * Queries the proxy configurations of a registered cluster based on the cluster ID.
37401
+ * Queries the proxy configurations of a registered cluster by cluster ID.
37063
37402
  *
37064
37403
  * @remarks
37065
37404
  * For more information, see [Register an external Kubernetes cluster](https://help.aliyun.com/document_detail/121053.html).
@@ -37107,7 +37446,7 @@ export default class Client extends OpenApi {
37107
37446
  }
37108
37447
 
37109
37448
  /**
37110
- * Queries the proxy configurations of a registered cluster based on the cluster ID.
37449
+ * Queries the proxy configurations of a registered cluster by cluster ID.
37111
37450
  *
37112
37451
  * @remarks
37113
37452
  * For more information, see [Register an external Kubernetes cluster](https://help.aliyun.com/document_detail/121053.html).
@@ -38093,7 +38432,7 @@ export default class Client extends OpenApi {
38093
38432
  }
38094
38433
 
38095
38434
  /**
38096
- * You can call the GetClusterAuditProject operation to query the Simple Log Service (SLS) project that stores the audit logs of the API server of a cluster.
38435
+ * You can call the GetClusterAuditProject operation to check whether the cluster has API Server auditing enabled and the corresponding Simple Log Service project that stores API Server audit logs.
38097
38436
  *
38098
38437
  * @param headers - map
38099
38438
  * @param runtime - runtime options for this request RuntimeOptions
@@ -38123,7 +38462,7 @@ export default class Client extends OpenApi {
38123
38462
  }
38124
38463
 
38125
38464
  /**
38126
- * You can call the GetClusterAuditProject operation to query the Simple Log Service (SLS) project that stores the audit logs of the API server of a cluster.
38465
+ * You can call the GetClusterAuditProject operation to check whether the cluster has API Server auditing enabled and the corresponding Simple Log Service project that stores API Server audit logs.
38127
38466
  * @returns GetClusterAuditProjectResponse
38128
38467
  */
38129
38468
  async getClusterAuditProject(clusterid: string): Promise<GetClusterAuditProjectResponse> {
@@ -39023,10 +39362,18 @@ export default class Client extends OpenApi {
39023
39362
  body["resource_group_id"] = request.resourceGroupId;
39024
39363
  }
39025
39364
 
39365
+ if (!$dara.isNull(request.securityGroupId)) {
39366
+ body["security_group_id"] = request.securityGroupId;
39367
+ }
39368
+
39026
39369
  if (!$dara.isNull(request.systemEventsLogging)) {
39027
39370
  body["system_events_logging"] = request.systemEventsLogging;
39028
39371
  }
39029
39372
 
39373
+ if (!$dara.isNull(request.timezone)) {
39374
+ body["timezone"] = request.timezone;
39375
+ }
39376
+
39030
39377
  if (!$dara.isNull(request.vswitchIds)) {
39031
39378
  body["vswitch_ids"] = request.vswitchIds;
39032
39379
  }
@@ -40440,7 +40787,7 @@ export default class Client extends OpenApi {
40440
40787
  }
40441
40788
 
40442
40789
  /**
40443
- * 启用告警
40790
+ * Activates the specified alert rule(s).
40444
40791
  *
40445
40792
  * @param request - StartAlertRequest
40446
40793
  * @param headers - map
@@ -40482,7 +40829,7 @@ export default class Client extends OpenApi {
40482
40829
  }
40483
40830
 
40484
40831
  /**
40485
- * 启用告警
40832
+ * Activates the specified alert rule(s).
40486
40833
  *
40487
40834
  * @param request - StartAlertRequest
40488
40835
  * @returns StartAlertResponse
@@ -40774,7 +41121,7 @@ export default class Client extends OpenApi {
40774
41121
  * You can call the UpdateClusterAuditLogConfig operation to enable or disable the audit log feature in a Container Service for Kubernetes (ACK) cluster and update the audit log configuration. This operation also allows you to record requests to the Kubernetes API and the responses, which can be used to trace cluster operation history and troubleshoot cluster issues.
40775
41122
  *
40776
41123
  * @remarks
40777
- * Before you call this operation, ensure that you understand the billing methods and pricing of [Simple Log Service](https://www.alibabacloud.com/product/log-service/pricing) (SLS).
41124
+ * Before you call this operation, ensure that you understand the billing methods and pricing of [Simple Log Service](https://www.alibabacloud.com/product/log-service/pricing).
40778
41125
  *
40779
41126
  * @param request - UpdateClusterAuditLogConfigRequest
40780
41127
  * @param headers - map
@@ -40819,7 +41166,7 @@ export default class Client extends OpenApi {
40819
41166
  * You can call the UpdateClusterAuditLogConfig operation to enable or disable the audit log feature in a Container Service for Kubernetes (ACK) cluster and update the audit log configuration. This operation also allows you to record requests to the Kubernetes API and the responses, which can be used to trace cluster operation history and troubleshoot cluster issues.
40820
41167
  *
40821
41168
  * @remarks
40822
- * Before you call this operation, ensure that you understand the billing methods and pricing of [Simple Log Service](https://www.alibabacloud.com/product/log-service/pricing) (SLS).
41169
+ * Before you call this operation, ensure that you understand the billing methods and pricing of [Simple Log Service](https://www.alibabacloud.com/product/log-service/pricing).
40823
41170
  *
40824
41171
  * @param request - UpdateClusterAuditLogConfigRequest
40825
41172
  * @returns UpdateClusterAuditLogConfigResponse
@@ -41017,7 +41364,7 @@ export default class Client extends OpenApi {
41017
41364
  }
41018
41365
 
41019
41366
  /**
41020
- * Updates the deletion protection status of the specified resources. You can enable or disable deletion protection for namespaces and Services.
41367
+ * Updates the deletion protection status of the specified resources. You can enable or disable deletion protection for namespaces and Services. You can call this operation to enable deletion protection for namespaces or Services that involve businesses-critical and sensitive data to avoid incurring maintenance costs caused by accidental namespace or Service deletion.
41021
41368
  *
41022
41369
  * @param request - UpdateResourcesDeleteProtectionRequest
41023
41370
  * @param headers - map
@@ -41067,7 +41414,7 @@ export default class Client extends OpenApi {
41067
41414
  }
41068
41415
 
41069
41416
  /**
41070
- * Updates the deletion protection status of the specified resources. You can enable or disable deletion protection for namespaces and Services.
41417
+ * Updates the deletion protection status of the specified resources. You can enable or disable deletion protection for namespaces and Services. You can call this operation to enable deletion protection for namespaces or Services that involve businesses-critical and sensitive data to avoid incurring maintenance costs caused by accidental namespace or Service deletion.
41071
41418
  *
41072
41419
  * @param request - UpdateResourcesDeleteProtectionRequest
41073
41420
  * @returns UpdateResourcesDeleteProtectionResponse