@alicloud/cs20151215 4.7.10 → 4.8.0

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/dist/client.d.ts CHANGED
@@ -489,14 +489,14 @@ export declare class QuotasValue extends $tea.Model {
489
489
  export declare class AttachInstancesRequest extends $tea.Model {
490
490
  /**
491
491
  * @remarks
492
- * The CPU management policy. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later.
492
+ * 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:
493
493
  *
494
- * * `static`: This policy allows pods with specific resource characteristics on the node to be configured with enhanced CPU affinity and exclusivity.
495
- * * `none`: The default CPU affinity is used.
494
+ * * `static`: allows pods with specific resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.
495
+ * * `none`: specifies that the default CPU affinity is used.
496
496
  *
497
497
  * Default value: `none`.
498
498
  *
499
- * > This parameter is not supported if you specify the `nodepool_id` parameter.
499
+ * > This parameter is not supported if you specify `nodepool_id`.
500
500
  *
501
501
  * @example
502
502
  * none
@@ -511,12 +511,12 @@ export declare class AttachInstancesRequest extends $tea.Model {
511
511
  *
512
512
  * Default value: `false`.
513
513
  *
514
- * How a data disk is mounted:
514
+ * How data disks are attached:
515
515
  *
516
- * * If the 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.
517
- * * If no data disk is attached to the ECS instances, the system does not purchase a new data disk.
516
+ * * If the ECS instance is already attached with data disks and the file system of the last data disk is not initialized, the system automatically formats this data disk to ext4. Then, the system uses the disk to store the data in the /var/lib/docker and /var/lib/kubelet directories.
517
+ * * If no data disk is attached to the ECS instance, the system does not purchase a new data disk.
518
518
  *
519
- * > If you choose to store container data and images on data disks and a data disk is already mounted to the ECS instance, the original data on this data disk will be cleared. You can back up the disk to avoid data loss.
519
+ * > If you choose to store container data and images on data disks and a data disk is already attached to the ECS instance, the original data on this data disk is cleared. You can back up the disk to prevent data loss.
520
520
  *
521
521
  * @example
522
522
  * false
@@ -524,13 +524,13 @@ export declare class AttachInstancesRequest extends $tea.Model {
524
524
  formatDisk?: boolean;
525
525
  /**
526
526
  * @remarks
527
- * The ID of the custom image. If you do not set this parameter, the default system image is used.
527
+ * The custom image ID. If you do not specify this parameter, the default system image is used.
528
528
  *
529
529
  * >
530
530
  *
531
- * * If you specify a custom image, the custom image is used to deploy the operating systems on the system disks of the nodes.
531
+ * * If you specify a custom image, the custom image is used to deploy the operating system on the system disk of the node.
532
532
  *
533
- * * This parameter is not supported after you specify `nodepool_id`.
533
+ * * This parameter is not supported if you specify `nodepool_id`.
534
534
  *
535
535
  * @example
536
536
  * aliyun_2_1903_x64_20G_alibase_20200529.vhd
@@ -538,21 +538,21 @@ export declare class AttachInstancesRequest extends $tea.Model {
538
538
  imageId?: string;
539
539
  /**
540
540
  * @remarks
541
- * The ECS instances to be added.
541
+ * The ECS instances that you want to add.
542
542
  *
543
543
  * This parameter is required.
544
544
  */
545
545
  instances?: string[];
546
546
  /**
547
547
  * @remarks
548
- * Specifies whether the nodes that you want to add are Edge Node Service (ENS) nodes. Valid values:
548
+ * Specifies whether the node that you want to add is an Edge Node Service (ENS) node. Valid values:
549
549
  *
550
- * * `true`: The nodes that you want to add are ENS nodes.
551
- * * `false`: The nodes that you want to add are not ENS nodes.
550
+ * * `true`: the node that you want to add is an ENS node.
551
+ * * `false`: the node that you want to add is not an ENS node.
552
552
  *
553
553
  * Default value: `false`.
554
554
  *
555
- * > If the nodes that you want to add are ENS nodes, you must set this parameter to `true`. This allows you to identify these nodes.
555
+ * > If the node that you want to add is an ENS node, you must set the value to `true`. This allows you to identify the node.
556
556
  *
557
557
  * @example
558
558
  * false
@@ -565,7 +565,7 @@ export declare class AttachInstancesRequest extends $tea.Model {
565
565
  * * `true`: retains the instance name.
566
566
  * * `false`: does not retain the instance name.
567
567
  *
568
- * Default value: `true`
568
+ * Default value: `false`.
569
569
  *
570
570
  * @example
571
571
  * true
@@ -573,9 +573,9 @@ export declare class AttachInstancesRequest extends $tea.Model {
573
573
  keepInstanceName?: boolean;
574
574
  /**
575
575
  * @remarks
576
- * The name of the key pair that is used to log on to the ECS instances. You must set key_pair or `login_password`.
576
+ * The name of the key pair used to log on to the ECS instances. You must specify this parameter or `login_password`.
577
577
  *
578
- * > This parameter is not supported if you specify the `nodepool_id` parameter.
578
+ * > This parameter is not supported if you specify `nodepool_id`.
579
579
  *
580
580
  * @example
581
581
  * secrity-key
@@ -583,7 +583,7 @@ export declare class AttachInstancesRequest extends $tea.Model {
583
583
  keyPair?: string;
584
584
  /**
585
585
  * @remarks
586
- * The node pool ID. If you do not set this parameter, the nodes are added to the default node pool.
586
+ * The ID of the node pool to which the node is added. If you do not specify this parameter, the node is added to the default node pool.
587
587
  *
588
588
  * @example
589
589
  * np615c0e0966124216a0412e10afe0****
@@ -591,9 +591,9 @@ export declare class AttachInstancesRequest extends $tea.Model {
591
591
  nodepoolId?: string;
592
592
  /**
593
593
  * @remarks
594
- * The SSH logon password that is used to log on to the ECS instances. You must set login_password 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. It cannot contain backslashes (\\\\) or double quotation marks (").
594
+ * The SSH logon password used to log on to the ECS instances. You must specify 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. The password cannot contain backslashes (\\\\) or double quotation marks (").
595
595
  *
596
- * For security considerations, the password is encrypted during data transfer.
596
+ * The password is encrypted during data transfer to ensure security.
597
597
  *
598
598
  * @example
599
599
  * Hello1234
@@ -608,24 +608,24 @@ export declare class AttachInstancesRequest extends $tea.Model {
608
608
  * @remarks
609
609
  * The container runtime.
610
610
  *
611
- * > This parameter is not supported if you specify the `nodepool_id` parameter.
611
+ * > This parameter is not supported if you specify `nodepool_id`.
612
612
  */
613
613
  runtime?: Runtime;
614
614
  /**
615
615
  * @remarks
616
- * The labels that you want to add to nodes. You must add labels based on the following rules:
616
+ * The labels that you want to add to the node. When you add labels to a node, the following rules apply:
617
617
  *
618
- * * Each label is a case-sensitive key-value pair. You can add up to 20 labels.
619
- * * A key must be unique and cannot exceed 64 characters in length. A 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).
618
+ * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
619
+ * * 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).
620
620
  *
621
- * > This parameter is not supported if you specify the `nodepool_id` parameter.
621
+ * > This parameter is not supported if you specify `nodepool_id`.
622
622
  */
623
623
  tags?: Tag[];
624
624
  /**
625
625
  * @remarks
626
- * User-defined data. For more information, see [Generate user data](https://help.aliyun.com/document_detail/49121.html).
626
+ * The user-defined data on the node. For more information, see [Generate user-defined data](https://help.aliyun.com/document_detail/49121.html).
627
627
  *
628
- * > This parameter is not supported if you specify the `nodepool_id` parameter.
628
+ * > This parameter is not supported if you specify `nodepool_id`.
629
629
  *
630
630
  * @example
631
631
  * IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi
@@ -1013,17 +1013,15 @@ export declare class CleanClusterUserPermissionsResponse extends $tea.Model {
1013
1013
  export declare class CleanUserPermissionsRequest extends $tea.Model {
1014
1014
  /**
1015
1015
  * @remarks
1016
- * The cluster IDs.
1017
- *
1018
- * * If cluster IDs are specified, only the kubeconfig files of the specified clusters and the relevant RBAC permissions are deleted and revoked.
1016
+ * The cluster IDs. If you specify a list of cluster IDs, only the kubeconfig files and RBAC permissions of the clusters that belong to the current user in the list are revoked.
1019
1017
  */
1020
1018
  clusterIds?: string[];
1021
1019
  /**
1022
1020
  * @remarks
1023
1021
  * Specifies whether to forcefully delete the specified kubeconfig files. Valid values:
1024
1022
  *
1025
- * * **false** (default): checks the cluster access records within the previous seven days before deleting the kubeconfig files. The kubeconfig files are not deleted if cluster access records are found or fail to be retrieved.
1026
- * * **true**: forcefully deletes the kubeconfig files without checking cluster access records.
1023
+ * * false (default): checks the cluster access records within the previous seven days before deleting the kubeconfig files. The kubeconfig files are not deleted if cluster access records are found or fail to be retrieved.
1024
+ * * true: forcefully deletes the kubeconfig files without checking the cluster access records.
1027
1025
  *
1028
1026
  * @example
1029
1027
  * false
@@ -1042,17 +1040,15 @@ export declare class CleanUserPermissionsRequest extends $tea.Model {
1042
1040
  export declare class CleanUserPermissionsShrinkRequest extends $tea.Model {
1043
1041
  /**
1044
1042
  * @remarks
1045
- * The cluster IDs.
1046
- *
1047
- * * If cluster IDs are specified, only the kubeconfig files of the specified clusters and the relevant RBAC permissions are deleted and revoked.
1043
+ * The cluster IDs. If you specify a list of cluster IDs, only the kubeconfig files and RBAC permissions of the clusters that belong to the current user in the list are revoked.
1048
1044
  */
1049
1045
  clusterIdsShrink?: string;
1050
1046
  /**
1051
1047
  * @remarks
1052
1048
  * Specifies whether to forcefully delete the specified kubeconfig files. Valid values:
1053
1049
  *
1054
- * * **false** (default): checks the cluster access records within the previous seven days before deleting the kubeconfig files. The kubeconfig files are not deleted if cluster access records are found or fail to be retrieved.
1055
- * * **true**: forcefully deletes the kubeconfig files without checking cluster access records.
1050
+ * * false (default): checks the cluster access records within the previous seven days before deleting the kubeconfig files. The kubeconfig files are not deleted if cluster access records are found or fail to be retrieved.
1051
+ * * true: forcefully deletes the kubeconfig files without checking the cluster access records.
1056
1052
  *
1057
1053
  * @example
1058
1054
  * false
@@ -1071,7 +1067,7 @@ export declare class CleanUserPermissionsShrinkRequest extends $tea.Model {
1071
1067
  export declare class CleanUserPermissionsResponseBody extends $tea.Model {
1072
1068
  /**
1073
1069
  * @remarks
1074
- * 请求ID
1070
+ * The request ID.
1075
1071
  *
1076
1072
  * @example
1077
1073
  * 687C5BAA-D103-4993-884B-C35E4314****
@@ -1079,7 +1075,7 @@ export declare class CleanUserPermissionsResponseBody extends $tea.Model {
1079
1075
  requestId?: string;
1080
1076
  /**
1081
1077
  * @remarks
1082
- * 任务ID
1078
+ * The task ID.
1083
1079
  *
1084
1080
  * @example
1085
1081
  * clean-user-permissions-2085266204********-6694c16e6ae07***********
@@ -1278,19 +1274,19 @@ export declare class CreateAutoscalingConfigResponse extends $tea.Model {
1278
1274
  export declare class CreateClusterRequest extends $tea.Model {
1279
1275
  /**
1280
1276
  * @remarks
1281
- * The network access control list (ACL) of the SLB instance associated with the API server if the cluster is a registered cluster.
1277
+ * The ACL rule of the SLB instance associated with the API server if the cluster is a registered cluster.
1282
1278
  */
1283
1279
  accessControlList?: string[];
1284
1280
  /**
1285
1281
  * @remarks
1286
- * 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.
1282
+ * The components that you want to install in the cluster. When you create a cluster, you can specify `addons` to install specific components.
1287
1283
  *
1288
1284
  * **Network plug-in**: required. The Flannel and Terway plug-ins are supported. Select one of the plug-ins for the cluster.
1289
1285
  *
1290
- * * If you want to use the Terway component, specify the network plug-in in the [{"name":"flannel","config":""}] format.
1291
- * * If you want to use the Terway component, specify the value network plug-in in the [{"Name": "terway-eniip","Config": ""}] format.
1286
+ * * Specify the Flannel plug-in in the following format: [{"name":"flannel","config":""}].
1287
+ * * If you want to use the Terway component, specify the value in the [{"Name": "terway-eniip","Config": ""}] format.
1292
1288
  *
1293
- * **Volume plug-in**: optional. Only the `Container Storage Interface (CSI)` plug-in is supported.
1289
+ * **Volume plug-in**: optional. Only the `CSI` plug-in is supported.
1294
1290
  *
1295
1291
  * Specify the `CSI` plug-in in the following format: [{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}].
1296
1292
  *
@@ -1299,23 +1295,23 @@ export declare class CreateClusterRequest extends $tea.Model {
1299
1295
  * * Specify an existing `Simple Log Service project` in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}].
1300
1296
  * * To create a `Simple Log Service project`, specify the component in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true"}"}].
1301
1297
  *
1302
- * **Ingress controller**: optional. By default, the `nginx-ingress-controller` component is installed in ACK dedicated clusters.
1298
+ * **Ingress controller**`: optional. By default, the nginx-ingress-controller component is installed in ACK dedicated clusters.`
1303
1299
  *
1304
1300
  * * To install nginx-ingress-controller and enable Internet access, specify the Ingress controller in the following format: [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}].
1305
- * * To disable the automatic installation of nginx-ingress-controller, specify the Ingress controller in the following format: [{"name": "nginx-ingress-controller","config": "","disabled": true}].
1301
+ * * To disable the automatic installation of nginx-ingress-controller, specify the component in the following format: [{"name": "nginx-ingress-controller","config": "","disabled": true}].
1306
1302
  *
1307
1303
  * **Event center**: optional. By default, the event center feature is enabled.
1308
1304
  *
1309
1305
  * 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).
1310
1306
  *
1311
- * 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"}"}].
1307
+ * Enable the ack-node-problem-detector component in the following format: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}].
1312
1308
  */
1313
1309
  addons?: Addon[];
1314
1310
  /**
1315
1311
  * @remarks
1316
- * 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 (,).``
1312
+ * 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 (,).``
1317
1313
  *
1318
- * For more information about `service accounts`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
1314
+ * For more information about `ServiceAccount`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
1319
1315
  *
1320
1316
  * @example
1321
1317
  * kubernetes.default.svc
@@ -1323,13 +1319,14 @@ export declare class CreateClusterRequest extends $tea.Model {
1323
1319
  apiAudiences?: string;
1324
1320
  /**
1325
1321
  * @remarks
1326
- * Specifies whether to enable auto-renewal, which takes effect only when the `charge_type` value is set to `PrePaid`.
1322
+ * Specifies whether to enable auto-renewal. This parameter takes effect only when `charge_type` is set to `PrePaid`. Valid values:
1323
+ *
1324
+ * * `true`: enables auto-renewal.
1325
+ * * `false`: disables auto-renewal.
1327
1326
  *
1328
- * Possible values:
1329
- * - `true`: Enable auto-renewal.
1330
- * - `false`: Do not auto-renew.
1327
+ * Default value: `false`
1331
1328
  *
1332
- * Default value: `false`.
1329
+ * 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).
1333
1330
  *
1334
1331
  * @example
1335
1332
  * true
@@ -1337,29 +1334,32 @@ export declare class CreateClusterRequest extends $tea.Model {
1337
1334
  autoRenew?: boolean;
1338
1335
  /**
1339
1336
  * @remarks
1340
- * Renewal period, which takes effect only when Prepaid and Auto-Renewal are selected. When `PeriodUnit=Month`, the value range is {1, 2, 3, 6, 12}.
1337
+ * 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.
1338
+ *
1341
1339
  * Default value: 1.
1342
1340
  *
1341
+ * 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).
1342
+ *
1343
1343
  * @example
1344
1344
  * 1
1345
1345
  */
1346
1346
  autoRenewPeriod?: number;
1347
1347
  /**
1348
1348
  * @remarks
1349
- * The billing method of the cluster. The following resources are billed on a subscription basis:
1350
- *
1351
- * ECS instances in node pools.
1349
+ * The billing method of the resource. The following resources are billed on a subscription basis:
1352
1350
  *
1353
- * The internal-facing SLB instance associated with the API server.
1351
+ * The internal-facing SLB instance used by the API server.
1354
1352
  *
1355
1353
  * Valid values:
1356
1354
  *
1357
- * PrePaid: subscription.
1355
+ * PrePaid: subscription
1358
1356
  *
1359
- * PostPaid: pay-as-you-go.
1357
+ * PostPaid: pay-as-you-go
1360
1358
  *
1361
1359
  * Default value: PostPaid.
1362
1360
  *
1361
+ * 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).
1362
+ *
1363
1363
  * @example
1364
1364
  * 1
1365
1365
  */
@@ -1381,7 +1381,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1381
1381
  * * `true`: installs the CloudMonitor agent.
1382
1382
  * * `false`: does not install the CloudMonitor agent.
1383
1383
  *
1384
- * Default value: `false`.
1384
+ * Default value: `false`
1385
1385
  *
1386
1386
  * @example
1387
1387
  * true
@@ -1399,10 +1399,10 @@ export declare class CreateClusterRequest extends $tea.Model {
1399
1399
  clusterDomain?: string;
1400
1400
  /**
1401
1401
  * @remarks
1402
- * After you set `cluster_type` to `ManagedKubernetes` and configure the `profile` parameter, you can further specify the cluster edition. Valid values:
1402
+ * If you set `cluster_type` to `ManagedKubernetes` and specify `profile`, you can further specify the edition of the cluster. Valid values:
1403
1403
  *
1404
- * * `ack.pro.small`: Pro Edition.
1405
- * * `ack.standard`: Basic Edition. If you leave the parameter empty, an ACK Basic cluster is created.
1404
+ * * `ack.pro.small`: creates an ACK Pro cluster.
1405
+ * * `ack.standard`: creates an ACK Basic cluster. If you leave the parameter empty, an ACK Basic cluster is created.
1406
1406
  *
1407
1407
  * @example
1408
1408
  * ack.pro.small
@@ -1410,9 +1410,9 @@ export declare class CreateClusterRequest extends $tea.Model {
1410
1410
  clusterSpec?: string;
1411
1411
  /**
1412
1412
  * @remarks
1413
- * * `Kubernetes`: ACK dedicated cluster.
1414
- * * `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).
1415
- * * `ExternalKubernetes`: registered cluster.
1413
+ * * `Kubernetes`: an ACK dedicated cluster.
1414
+ * * `ManagedKubernetes`: an ACK managed cluster. ACK managed clusters include ACK Basic clusters, ACK Pro clusters, ACK Serverless clusters (Basic and Pro), ACK Edge clusters (Basic and Pro), and ACK Lingjun clusters (Pro).
1415
+ * * `ExternalKubernetes`: a registered cluster.
1416
1416
  *
1417
1417
  * This parameter is required.
1418
1418
  *
@@ -1434,9 +1434,9 @@ export declare class CreateClusterRequest extends $tea.Model {
1434
1434
  containerCidr?: string;
1435
1435
  /**
1436
1436
  * @remarks
1437
- * The list of control plane components for which you want to enable log collection.
1437
+ * The control plane component for which you want to enable log collection.
1438
1438
  *
1439
- * By default, the logs of kube-apiserver, kube-controller-manager, and kube-scheduler are collected.
1439
+ * By default, the log of kube-apiserver, kube-controller-manager, and kube-scheduler is collected.
1440
1440
  */
1441
1441
  controlplaneLogComponents?: string[];
1442
1442
  /**
@@ -1459,8 +1459,8 @@ export declare class CreateClusterRequest extends $tea.Model {
1459
1459
  * @remarks
1460
1460
  * 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:
1461
1461
  *
1462
- * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
1463
- * * `none`: specifies that the default CPU affinity is used.
1462
+ * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity
1463
+ * * `none`: specifies that the default CPU affinity is used
1464
1464
  *
1465
1465
  * Default value: `none`.
1466
1466
  *
@@ -1470,7 +1470,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1470
1470
  cpuPolicy?: string;
1471
1471
  /**
1472
1472
  * @remarks
1473
- * 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 (,).
1473
+ * 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 (,).
1474
1474
  *
1475
1475
  * @example
1476
1476
  * cs.aliyun.com
@@ -1478,12 +1478,12 @@ export declare class CreateClusterRequest extends $tea.Model {
1478
1478
  customSan?: string;
1479
1479
  /**
1480
1480
  * @remarks
1481
- * Specifies whether to enable cluster deletion protection. If this option is enabled, the cluster cannot be deleted in the ACK console or by calling API operations. Valid values:
1481
+ * 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:
1482
1482
  *
1483
- * * `true`: enables deletion protection for the cluster. This way, the cluster cannot be deleted in the ACK console or by calling API operations.
1484
- * * `false`: disables deletion protection for the cluster. This way, the cluster can be deleted in the ACK console or by calling API operations.
1483
+ * * `true`: The cluster cannot be deleted in the Container Service console or by calling API operations.
1484
+ * * `false`: The cluster can be deleted in the Container Service console or by calling API operations.
1485
1485
  *
1486
- * Default value: `false`.
1486
+ * Default value: `false`
1487
1487
  *
1488
1488
  * @example
1489
1489
  * true
@@ -1491,12 +1491,12 @@ export declare class CreateClusterRequest extends $tea.Model {
1491
1491
  deletionProtection?: boolean;
1492
1492
  /**
1493
1493
  * @remarks
1494
- * Specifies whether to perform a rollback when the cluster fails to be created. Valid values:
1494
+ * Specifies whether to perform a rollback if the cluster fails to be created. Valid values:
1495
1495
  *
1496
1496
  * * `true`: performs a rollback when the cluster fails to be created.
1497
1497
  * * `false`: does not perform a rollback when the cluster fails to be created.
1498
1498
  *
1499
- * Default value: `true`.
1499
+ * Default value: `true`
1500
1500
  *
1501
1501
  * @example
1502
1502
  * true
@@ -1506,7 +1506,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1506
1506
  disableRollback?: boolean;
1507
1507
  /**
1508
1508
  * @remarks
1509
- * Specifies whether to enable the RAM Roles for Service Accounts (RRSA) feature.
1509
+ * Specifies whether to enable the Resource Access Management (RAM) Roles for Service Accounts (RRSA) feature.
1510
1510
  *
1511
1511
  * @example
1512
1512
  * true
@@ -1529,7 +1529,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1529
1529
  * * `true`: enables Internet access for the cluster.
1530
1530
  * * `false`: disables Internet access for the cluster. If you set the value to false, the API server cannot be accessed over the Internet.
1531
1531
  *
1532
- * Default value: `false`.
1532
+ * Default value: `false`
1533
1533
  *
1534
1534
  * @example
1535
1535
  * true
@@ -1539,10 +1539,10 @@ export declare class CreateClusterRequest extends $tea.Model {
1539
1539
  * @remarks
1540
1540
  * Specifies whether to mount a data disk to a node that is created based on an existing ECS instance. Valid values:
1541
1541
  *
1542
- * * `true`: stores the data of containers and images on a data disk. The existing data stored on the data disk is lost. Back up the existing data first.
1542
+ * * `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.
1543
1543
  * * `false`: does not store the data of containers and images on a data disk.
1544
1544
  *
1545
- * Default value: `false`.
1545
+ * Default value: `false`
1546
1546
  *
1547
1547
  * How data disks are mounted:
1548
1548
  *
@@ -1583,7 +1583,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1583
1583
  imageType?: string;
1584
1584
  /**
1585
1585
  * @remarks
1586
- * The existing ECS instances that are specified as worker nodes for the cluster.
1586
+ * The existing Elastic Compute Service (ECS) instances that are specified as worker nodes for the cluster.
1587
1587
  *
1588
1588
  * > This parameter is required if you create worker nodes on existing ECS instances.
1589
1589
  */
@@ -1606,7 +1606,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1606
1606
  * * `true`: creates an advanced security group.
1607
1607
  * * `false`: does not create an advanced security group.
1608
1608
  *
1609
- * Default value: `true`.
1609
+ * Default value: `true`
1610
1610
  *
1611
1611
  * @example
1612
1612
  * true
@@ -1619,7 +1619,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1619
1619
  * * `true`: retains the names.
1620
1620
  * * `false`: does not retain the names. The system assigns new names.
1621
1621
  *
1622
- * Default value: `true`.
1622
+ * Default value: `true`
1623
1623
  *
1624
1624
  * @example
1625
1625
  * true
@@ -1627,7 +1627,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1627
1627
  keepInstanceName?: boolean;
1628
1628
  /**
1629
1629
  * @remarks
1630
- * The name of the key pair. You must specify this parameter or the `login_password` parameter.
1630
+ * The name of the key pair. You must configure this parameter or the `login_password` parameter.
1631
1631
  *
1632
1632
  * @example
1633
1633
  * secrity-key
@@ -1645,7 +1645,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1645
1645
  kubernetesVersion?: string;
1646
1646
  /**
1647
1647
  * @remarks
1648
- * Specifies the CLB instance ID for accessing the APIServer. When this parameter is set, an APIServer CLB will no longer be automatically created.
1648
+ * 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.
1649
1649
  *
1650
1650
  * @example
1651
1651
  * lb-wz9t256gqa3vbouk****
@@ -1678,12 +1678,16 @@ export declare class CreateClusterRequest extends $tea.Model {
1678
1678
  loggingType?: string;
1679
1679
  /**
1680
1680
  * @remarks
1681
- * The password for SSH logon. You must specify 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.
1681
+ * 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.
1682
1682
  *
1683
1683
  * @example
1684
1684
  * Hello@1234
1685
1685
  */
1686
1686
  loginPassword?: string;
1687
+ /**
1688
+ * @remarks
1689
+ * Cluster maintenance window.
1690
+ */
1687
1691
  maintenanceWindow?: MaintenanceWindow;
1688
1692
  /**
1689
1693
  * @remarks
@@ -1692,7 +1696,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1692
1696
  * * `true`: enables auto-renewal.
1693
1697
  * * `false`: disables auto-renewal.
1694
1698
  *
1695
- * Default value: `true`.
1699
+ * Default value: `true`
1696
1700
  *
1697
1701
  * @example
1698
1702
  * true
@@ -1700,7 +1704,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1700
1704
  masterAutoRenew?: boolean;
1701
1705
  /**
1702
1706
  * @remarks
1703
- * The auto-renewal duration. This parameter takes effect and is required only when the subscription billing method is selected for master nodes.
1707
+ * The cycle of auto-renewal. This parameter takes effect and is required only if the subscription billing method is selected for master nodes.
1704
1708
  *
1705
1709
  * Valid values: 1, 2, 3, 6, and 12.
1706
1710
  *
@@ -1725,9 +1729,9 @@ export declare class CreateClusterRequest extends $tea.Model {
1725
1729
  * The billing method of master nodes. Valid values:
1726
1730
  *
1727
1731
  * * `PrePaid`: subscription.
1728
- * * `PostPaid`: the pay-as-you-go.
1732
+ * * `PostPaid`: pay-as-you-go.
1729
1733
  *
1730
- * Default value: `PostPaid`.
1734
+ * Default value: `PostPaid`
1731
1735
  *
1732
1736
  * @example
1733
1737
  * PrePaid
@@ -1764,8 +1768,8 @@ export declare class CreateClusterRequest extends $tea.Model {
1764
1768
  * @remarks
1765
1769
  * The system disk type of master nodes. Valid values:
1766
1770
  *
1767
- * * `cloud_efficiency`: ultra disk.
1768
- * * `cloud_ssd`: standard SSD.
1771
+ * * `cloud_efficiency`: ultra disk
1772
+ * * `cloud_ssd`: standard SSD
1769
1773
  * * `cloud_essd`: Enterprise SSD (ESSD).
1770
1774
  *
1771
1775
  * Default value: `cloud_ssd`. The default value may vary in different zones.
@@ -1804,14 +1808,14 @@ export declare class CreateClusterRequest extends $tea.Model {
1804
1808
  * @remarks
1805
1809
  * 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.
1806
1810
  *
1807
- * 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.
1811
+ * The number of vSwitches must be the same as that specified in `master_count` and the same as those specified in `master_vswitch_ids`.
1808
1812
  */
1809
1813
  masterVswitchIds?: string[];
1810
1814
  /**
1811
1815
  * @remarks
1812
- * The cluster name.
1816
+ * The name of the cluster.
1813
1817
  *
1814
- * The name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). The name cannot start with a hyphen (-).
1818
+ * 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 (-).
1815
1819
  *
1816
1820
  * This parameter is required.
1817
1821
  *
@@ -1821,12 +1825,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1821
1825
  name?: string;
1822
1826
  /**
1823
1827
  * @remarks
1824
- * Specifies whether to create a NAT gateway and configure SNAT rules if you create an ACK Serverless cluster. Valid values:
1825
- *
1826
- * * `true`: automatically creates a NAT gateway and configures SNAT rules. This enables Internet access for the VPC in which the cluster is deployed.
1827
- * * `false`: does not create a NAT gateway or configure SNAT rules. If you specify this value, the cluster in the VPC cannot access the Internet.
1828
- *
1829
- * Default value: `false`.
1828
+ * This parameter is deprecated. Use `snat_entry` instead.
1830
1829
  *
1831
1830
  * @example
1832
1831
  * true
@@ -1834,7 +1833,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1834
1833
  natGateway?: boolean;
1835
1834
  /**
1836
1835
  * @remarks
1837
- * 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.
1836
+ * 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.
1838
1837
  *
1839
1838
  * Default value: `26`.
1840
1839
  *
@@ -1851,7 +1850,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1851
1850
  * * 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.
1852
1851
  * * 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.
1853
1852
  *
1854
- * 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.
1853
+ * 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.
1855
1854
  *
1856
1855
  * @example
1857
1856
  * aliyun.com00055test
@@ -1882,6 +1881,10 @@ export declare class CreateClusterRequest extends $tea.Model {
1882
1881
  * @deprecated
1883
1882
  */
1884
1883
  numOfNodes?: number;
1884
+ /**
1885
+ * @remarks
1886
+ * Cluster auto operation and maintenance policy.
1887
+ */
1885
1888
  operationPolicy?: CreateClusterRequestOperationPolicy;
1886
1889
  /**
1887
1890
  * @remarks
@@ -1904,6 +1907,8 @@ export declare class CreateClusterRequest extends $tea.Model {
1904
1907
  *
1905
1908
  * Default value: 1.
1906
1909
  *
1910
+ * 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).
1911
+ *
1907
1912
  * @example
1908
1913
  * FY2023
1909
1914
  */
@@ -1912,7 +1917,9 @@ export declare class CreateClusterRequest extends $tea.Model {
1912
1917
  * @remarks
1913
1918
  * The billing cycle. This parameter is required if charge_type is set to PrePaid.
1914
1919
  *
1915
- * Set the value to Month. Subscription clusters are billed only on a monthly basis.
1920
+ * Valid value: Month, which indicates that resources are billed only on a monthly basis.
1921
+ *
1922
+ * 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).
1916
1923
  *
1917
1924
  * @example
1918
1925
  * Month
@@ -1920,7 +1927,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1920
1927
  periodUnit?: string;
1921
1928
  /**
1922
1929
  * @remarks
1923
- * The OS distribution that is used. Valid values:
1930
+ * The operating system distribution. Valid values:
1924
1931
  *
1925
1932
  * * CentOS
1926
1933
  * * AliyunLinux
@@ -1937,19 +1944,19 @@ export declare class CreateClusterRequest extends $tea.Model {
1937
1944
  platform?: string;
1938
1945
  /**
1939
1946
  * @remarks
1940
- * 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.
1947
+ * 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.
1941
1948
  *
1942
- * > We recommend that you select pod vSwitches whose subnet masks that 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.
1949
+ * > 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.
1943
1950
  */
1944
1951
  podVswitchIds?: string[];
1945
1952
  /**
1946
1953
  * @remarks
1947
1954
  * If you set `cluster_type` to `ManagedKubernetes`, an ACK managed cluster is created. In this case, you can further specify the cluster edition. Valid values:
1948
1955
  *
1949
- * * `Default`: ACK managed cluster. ACK managed clusters include ACK Basic clusters and ACK Pro clusters.
1950
- * * `Edge`: ACK Edge cluster. ACK Edge clusters include ACK Edge Basic clusters and ACK Edge Pro clusters.
1951
- * * `Serverless`: ACK Serverless cluster. ACK Serverless clusters include ACK Serverless Basic clusters and ACK Serverless Pro clusters.
1952
- * * `Lingjun`: ACK Lingjun Pro cluster.
1956
+ * * `Default`. an ACK managed cluster. ACK managed clusters include ACK Basic clusters and ACK Pro clusters.
1957
+ * * `Edge`: an ACK Edge cluster. ACK Edge clusters include ACK Edge Basic clusters and ACK Edge Pro clusters.
1958
+ * * `Serverless`: an ACK Serverless cluster. ACK Serverless clusters include ACK Serverless Basic clusters and ACK Serverless Pro clusters.
1959
+ * * `Lingjun`: an ACK Lingjun Pro cluster.
1953
1960
  *
1954
1961
  * @example
1955
1962
  * Default
@@ -1959,8 +1966,8 @@ export declare class CreateClusterRequest extends $tea.Model {
1959
1966
  * @remarks
1960
1967
  * The kube-proxy mode. Valid values:
1961
1968
  *
1962
- * * `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.
1963
- * * `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.
1969
+ * * `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.
1970
+ * * `ipvs`: provides high performance and uses IP Virtual Server (IPVS). This allows you to configure service discovery and load balancing. This mode is suitable for clusters that are required to run a large number of services. We recommend that you use this mode in scenarios that require high load balancing performance.
1964
1971
  *
1965
1972
  * Default value: `ipvs`.
1966
1973
  *
@@ -1970,7 +1977,7 @@ export declare class CreateClusterRequest extends $tea.Model {
1970
1977
  proxyMode?: string;
1971
1978
  /**
1972
1979
  * @remarks
1973
- * 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.
1980
+ * 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.
1974
1981
  */
1975
1982
  rdsInstances?: string[];
1976
1983
  /**
@@ -2000,7 +2007,7 @@ export declare class CreateClusterRequest extends $tea.Model {
2000
2007
  runtime?: Runtime;
2001
2008
  /**
2002
2009
  * @remarks
2003
- * The ID of an existing security group. You must specify this parameter or the `is_enterprise_security_group` parameter. Cluster nodes are automatically added to the security group.
2010
+ * The ID of an existing security group. You must specify this parameter or `is_enterprise_security_group`. Cluster nodes are automatically added to the security group.
2004
2011
  *
2005
2012
  * @example
2006
2013
  * sg-bp1bdue0qc1g7k****
@@ -2013,7 +2020,7 @@ export declare class CreateClusterRequest extends $tea.Model {
2013
2020
  * * `true`: enables Alibaba Cloud Linux Security Hardening.
2014
2021
  * * `false`: disables Alibaba Cloud Linux Security Hardening.
2015
2022
  *
2016
- * Default value: `false`.
2023
+ * Default value: `false`
2017
2024
  *
2018
2025
  * @example
2019
2026
  * false
@@ -2021,9 +2028,9 @@ export declare class CreateClusterRequest extends $tea.Model {
2021
2028
  securityHardeningOs?: boolean;
2022
2029
  /**
2023
2030
  * @remarks
2024
- * Service accounts provide identities for pods when pods communicate with the `API server` of the cluster. The `service-account-issuer` parameter specifies the issuer of the `service account token`, which is specified by using the `iss` field in the `token payload`.
2031
+ * 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`.
2025
2032
  *
2026
- * For more information about `service accounts`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
2033
+ * For more information about `ServiceAccount`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
2027
2034
  *
2028
2035
  * @example
2029
2036
  * kubernetes.default.svc
@@ -2031,7 +2038,7 @@ export declare class CreateClusterRequest extends $tea.Model {
2031
2038
  serviceAccountIssuer?: string;
2032
2039
  /**
2033
2040
  * @remarks
2034
- * 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.
2041
+ * 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.
2035
2042
  *
2036
2043
  * By default, the Service CIDR block is set to 172.19.0.0/20.
2037
2044
  *
@@ -2043,24 +2050,24 @@ export declare class CreateClusterRequest extends $tea.Model {
2043
2050
  serviceCidr?: string;
2044
2051
  /**
2045
2052
  * @remarks
2046
- * The type of service discovery that is implemented in the `ACK Serverless` cluster.
2053
+ * The methods for implementing service discovery in `ACK Serverless` clusters.
2047
2054
  *
2048
- * * `CoreDNS`: a standard service discovery plug-in 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.
2049
- * * `PrivateZone`: a DNS resolution service provided by Alibaba Cloud. You must activate Alibaba Cloud DNS PrivateZone before you can use it to implement service discovery.
2055
+ * * `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.
2056
+ * * `PrivateZone`: a DNS resolution service provided by Alibaba Cloud. You must activate Alibaba Cloud DNS PrivateZone before you can use it for service discovery.
2050
2057
  *
2051
2058
  * By default, this parameter is not specified.
2052
2059
  */
2053
2060
  serviceDiscoveryTypes?: string[];
2054
2061
  /**
2055
2062
  * @remarks
2056
- * Specifies whether to configure SNAT rules for the VPC in which your cluster is deployed. Valid values:
2063
+ * Specifies whether to configure Source Network Address Translation (SNAT) rules for the VPC in which your cluster is deployed. Valid values:
2057
2064
  *
2058
2065
  * * `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.
2059
2066
  * * `false`: does not create a NAT gateway or configure SNAT rules. In this case, nodes and applications in the cluster cannot access the Internet.
2060
2067
  *
2061
2068
  * > 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).
2062
2069
  *
2063
- * Default value: `true`.
2070
+ * Default value: `true`
2064
2071
  *
2065
2072
  * @example
2066
2073
  * true
@@ -2075,7 +2082,7 @@ export declare class CreateClusterRequest extends $tea.Model {
2075
2082
  * * `true`: enables security hardening based on MLPS.
2076
2083
  * * `false`: disables security hardening based on MLPS.
2077
2084
  *
2078
- * Default value: `false`.
2085
+ * Default value: `false`
2079
2086
  *
2080
2087
  * @example
2081
2088
  * false
@@ -2088,7 +2095,7 @@ export declare class CreateClusterRequest extends $tea.Model {
2088
2095
  * * `true`: enables SSH logon.
2089
2096
  * * `false`: disables SSH logon.
2090
2097
  *
2091
- * Default value: `false`.
2098
+ * Default value: `false`
2092
2099
  *
2093
2100
  * @example
2094
2101
  * true
@@ -2096,15 +2103,15 @@ export declare class CreateClusterRequest extends $tea.Model {
2096
2103
  sshFlags?: boolean;
2097
2104
  /**
2098
2105
  * @remarks
2099
- * The labels that you want to add to nodes. You must add labels based on the following rules:
2106
+ * The tags to be added to nodes. You must add labels based on the following rules:
2100
2107
  *
2101
2108
  * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
2102
- * * 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).
2109
+ * * 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).
2103
2110
  */
2104
2111
  tags?: Tag[];
2105
2112
  /**
2106
2113
  * @remarks
2107
- * 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/).
2114
+ * 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/).
2108
2115
  */
2109
2116
  taints?: Taint[];
2110
2117
  /**
@@ -2151,15 +2158,15 @@ export declare class CreateClusterRequest extends $tea.Model {
2151
2158
  vpcid?: string;
2152
2159
  /**
2153
2160
  * @remarks
2154
- * The vSwitches for nodes in the cluster. This parameter is required if you create an ACK managed cluster that does not contain nodes.
2161
+ * 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.
2155
2162
  */
2156
2163
  vswitchIds?: string[];
2157
2164
  /**
2158
2165
  * @remarks
2159
- * 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:
2166
+ * 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:
2160
2167
  *
2161
2168
  * * `true`: enables auto-renewal.
2162
- * * `false`: disables auto-renewal.
2169
+ * * `false`: disables auto-renewal
2163
2170
  *
2164
2171
  * Default value: `true`
2165
2172
  *
@@ -2171,7 +2178,7 @@ export declare class CreateClusterRequest extends $tea.Model {
2171
2178
  workerAutoRenew?: boolean;
2172
2179
  /**
2173
2180
  * @remarks
2174
- * The auto-renewal duration. This parameter takes effect and is required only when the subscription billing method is selected for worker nodes.
2181
+ * The cycle of auto-renewal. This parameter takes effect and is required only if the subscription billing method is selected for worker nodes.
2175
2182
  *
2176
2183
  * Valid values: 1, 2, 3, 6, and 12.
2177
2184
  *
@@ -2228,7 +2235,7 @@ export declare class CreateClusterRequest extends $tea.Model {
2228
2235
  * @remarks
2229
2236
  * The billing cycle of worker nodes. This parameter is required if worker_instance_charge_type is set to `PrePaid`.
2230
2237
  *
2231
- * Set the value to `Month`. Subscription worker nodes are billed only on a monthly basis.
2238
+ * Valid value: `Month`, which indicates that worker nodes are billed only on a monthly basis.
2232
2239
  *
2233
2240
  * @example
2234
2241
  * Month
@@ -2238,7 +2245,7 @@ export declare class CreateClusterRequest extends $tea.Model {
2238
2245
  workerPeriodUnit?: string;
2239
2246
  /**
2240
2247
  * @remarks
2241
- * The system disk type of worker nodes. For more information, see [Overview of Block Storage](https://help.aliyun.com/document_detail/63136.html).
2248
+ * The system disk category of worker nodes. For more information, see [Elastic Block Storage devices](https://help.aliyun.com/document_detail/63136.html).
2242
2249
  *
2243
2250
  * Valid values:
2244
2251
  *
@@ -2298,7 +2305,7 @@ export declare class CreateClusterRequest extends $tea.Model {
2298
2305
  workerSystemDiskSnapshotPolicyId?: string;
2299
2306
  /**
2300
2307
  * @remarks
2301
- * The vSwitches for worker nodes. Each worker node is allocated a vSwitch.
2308
+ * The vSwitches that are specified for worker nodes. Each worker node is allocated a vSwitch.
2302
2309
  *
2303
2310
  * `worker_vswitch_ids` is optional but `vswitch_ids` is required if you create an ACK managed cluster that does not contain nodes.
2304
2311
  *
@@ -2307,9 +2314,11 @@ export declare class CreateClusterRequest extends $tea.Model {
2307
2314
  workerVswitchIds?: string[];
2308
2315
  /**
2309
2316
  * @remarks
2310
- * The ID of the zone to which the cluster belongs. This parameter takes effect only for ACK Serverless clusters.
2317
+ * This parameter is deprecated. Use `zone_ids` instead.
2311
2318
  *
2312
- * If you create an ACK Serverless cluster, you must specify `zone_id` if `vpc_id` and `vswitch_ids` are not specified. This way, the system automatically creates a VPC in the specified zone.
2319
+ * The ID of the zone to which the cluster belongs. This parameter is specific to ACK managed clusters.
2320
+ *
2321
+ * 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.
2313
2322
  *
2314
2323
  * @example
2315
2324
  * cn-beiji****
@@ -2319,8 +2328,9 @@ export declare class CreateClusterRequest extends $tea.Model {
2319
2328
  zoneId?: string;
2320
2329
  /**
2321
2330
  * @remarks
2322
- * List of availability zone IDs in the region where the cluster resides. This parameter is specific to ACK managed clusters.
2323
- * When creating an ACK managed cluster, if `vpc_id` and `vswitch_ids` are not specified, specifying `zone_ids` allows for automatic creation of VPC network resources across multiple availability zones. If `vpc_id` and `vswitch_ids` are specified, this parameter becomes ineffective.
2331
+ * The IDs of the zone in which the cluster is deployed. This parameter is specific to ACK managed clusters.
2332
+ *
2333
+ * 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.
2324
2334
  */
2325
2335
  zoneIds?: string[];
2326
2336
  static names(): {
@@ -2506,7 +2516,7 @@ export declare class CreateClusterNodePoolRequest extends $tea.Model {
2506
2516
  autoScaling?: CreateClusterNodePoolRequestAutoScaling;
2507
2517
  /**
2508
2518
  * @remarks
2509
- * This parameter is deprecated. Use desired_size instead.
2519
+ * This parameter is deprecated. Use the desired_size parameter instead.
2510
2520
  *
2511
2521
  * The number of nodes in the node pool.
2512
2522
  *
@@ -2516,6 +2526,7 @@ export declare class CreateClusterNodePoolRequest extends $tea.Model {
2516
2526
  * @deprecated
2517
2527
  */
2518
2528
  count?: number;
2529
+ hostNetwork?: boolean;
2519
2530
  /**
2520
2531
  * @remarks
2521
2532
  * This parameter is deprecated.
@@ -2527,15 +2538,16 @@ export declare class CreateClusterNodePoolRequest extends $tea.Model {
2527
2538
  interconnectConfig?: CreateClusterNodePoolRequestInterconnectConfig;
2528
2539
  /**
2529
2540
  * @remarks
2530
- * The network type of the edge node pool. This parameter takes effect only if you set the `type` of the node pool to `edge`. Valid values:
2541
+ * The network type of the edge node pool. This parameter takes effect only when the `type` of the node pool is set to `edge`. Valid values:
2531
2542
  *
2532
- * * `basic`: basic
2533
- * * `private`: dedicated Only Kubernetes 1.22 and later support this value.
2543
+ * * `basic`: basic.
2544
+ * * `private`: dedicated. Only clusters that run Kubernetes 1.22 and later support this value.
2534
2545
  *
2535
2546
  * @example
2536
2547
  * basic
2537
2548
  */
2538
2549
  interconnectMode?: string;
2550
+ intranet?: boolean;
2539
2551
  /**
2540
2552
  * @remarks
2541
2553
  * The configurations of the cluster.
@@ -3979,12 +3991,12 @@ export declare class DescribeClusterAddonInstanceResponseBody extends $tea.Model
3979
3991
  * @remarks
3980
3992
  * The status of the component. Valid values:
3981
3993
  *
3982
- * * initial: the component is being installed.
3983
- * * active: the component is installed.
3984
- * * unhealthy: the component abnormal.
3985
- * * upgrading: the component is being updated.
3986
- * * updating: the component is being modified.
3987
- * * deleting: the component is being uninstalled.
3994
+ * * initial: The component is being installed.
3995
+ * * active: The component is installed.
3996
+ * * unhealthy: The component is in an abnormal state.
3997
+ * * upgrading: The component is being updated.
3998
+ * * updating: The component is being modified.
3999
+ * * deleting: The component is being uninstalled.
3988
4000
  * * deleted: The component is deleted.
3989
4001
  *
3990
4002
  * @example
@@ -4275,6 +4287,9 @@ export declare class DescribeClusterAttachScriptsResponse extends $tea.Model {
4275
4287
  }
4276
4288
  export declare class DescribeClusterDetailResponseBody extends $tea.Model {
4277
4289
  /**
4290
+ * @remarks
4291
+ * The on-premises domain name of the cluster.
4292
+ *
4278
4293
  * @example
4279
4294
  * cluster.local
4280
4295
  */
@@ -4309,6 +4324,9 @@ export declare class DescribeClusterDetailResponseBody extends $tea.Model {
4309
4324
  */
4310
4325
  clusterType?: string;
4311
4326
  /**
4327
+ * @remarks
4328
+ * The CIDR block of the pod.
4329
+ *
4312
4330
  * @example
4313
4331
  * 172.20.0.0/16
4314
4332
  */
@@ -4349,6 +4367,9 @@ export declare class DescribeClusterDetailResponseBody extends $tea.Model {
4349
4367
  */
4350
4368
  dockerVersion?: string;
4351
4369
  /**
4370
+ * @remarks
4371
+ * The ID of the Server Load Balancer (SLB) instance that is created for the Ingress of the cluster.
4372
+ *
4352
4373
  * @example
4353
4374
  * lb-2zehc05z3b8dwiifh****
4354
4375
  */
@@ -4362,6 +4383,12 @@ export declare class DescribeClusterDetailResponseBody extends $tea.Model {
4362
4383
  */
4363
4384
  initVersion?: string;
4364
4385
  /**
4386
+ * @remarks
4387
+ * The IP protocol stack of the cluster. Valid values:
4388
+ *
4389
+ * * ipv4: creates a cluster that supports only the IPv4 protocol stack.
4390
+ * * dual: creates a cluster that supports IPv4/IPv6 dual-stack.
4391
+ *
4365
4392
  * @example
4366
4393
  * ipv4
4367
4394
  */
@@ -4398,29 +4425,50 @@ export declare class DescribeClusterDetailResponseBody extends $tea.Model {
4398
4425
  */
4399
4426
  name?: string;
4400
4427
  /**
4428
+ * @remarks
4429
+ * The network type of the cluster. Example: Virtual Private Cloud (VPC).
4430
+ *
4401
4431
  * @example
4402
4432
  * vpc
4403
4433
  */
4404
4434
  networkMode?: string;
4405
4435
  /**
4436
+ * @remarks
4437
+ * The Kubernetes version to which the cluster can be updated.
4438
+ *
4406
4439
  * @example
4407
4440
  * 1.18.8-aliyun.1
4408
4441
  */
4409
4442
  nextVersion?: string;
4410
4443
  /**
4444
+ * @remarks
4445
+ * The number of the IP addresses of the node.
4446
+ *
4411
4447
  * @example
4412
4448
  * 26
4413
4449
  */
4414
4450
  nodeCidrMask?: string;
4451
+ /**
4452
+ * @remarks
4453
+ * The automatic O\\&M policy of the cluster.
4454
+ */
4415
4455
  operationPolicy?: DescribeClusterDetailResponseBodyOperationPolicy;
4416
4456
  /**
4417
4457
  * @remarks
4418
- * The ROS parameters of the cluster.
4458
+ * The Resource Orchestration Service (ROS) parameters of the cluster.
4419
4459
  */
4420
4460
  parameters?: {
4421
4461
  [key: string]: string;
4422
4462
  };
4423
4463
  /**
4464
+ * @remarks
4465
+ * Indicates whether Alibaba Cloud DNS PrivateZone (PrivateZone) is enabled for the cluster. Valid values:
4466
+ *
4467
+ * * `true`: PrivateZone is enabled.
4468
+ * * `false`: PrivateZone is dislabled.
4469
+ *
4470
+ * Default value: false
4471
+ *
4424
4472
  * @example
4425
4473
  * false
4426
4474
  */
@@ -4439,6 +4487,9 @@ export declare class DescribeClusterDetailResponseBody extends $tea.Model {
4439
4487
  */
4440
4488
  profile?: string;
4441
4489
  /**
4490
+ * @remarks
4491
+ * The proxy mode. Valid values: ipvs and iptables.
4492
+ *
4442
4493
  * @example
4443
4494
  * ipvs
4444
4495
  */
@@ -4469,6 +4520,8 @@ export declare class DescribeClusterDetailResponseBody extends $tea.Model {
4469
4520
  securityGroupId?: string;
4470
4521
  /**
4471
4522
  * @remarks
4523
+ * The CIDR block of the Service.
4524
+ *
4472
4525
  * This parameter is required.
4473
4526
  *
4474
4527
  * @example
@@ -4512,9 +4565,9 @@ export declare class DescribeClusterDetailResponseBody extends $tea.Model {
4512
4565
  * * 172.16-31.0.0/12-16
4513
4566
  * * 192.168.0.0/16
4514
4567
  *
4515
- * The pod CIDR block cannot overlap with the CIDR block of the VPC or the CIDR blocks of the clusters in the VPC.
4568
+ * The pod CIDR block cannot overlap with the CIDR block of the VPC in which the cluster is deployed and the CIDR blocks of existing clusters in the VPC. You cannot modify the pod CIDR block after you create the cluster.
4516
4569
  *
4517
- * For more information, see [Plan CIDR blocks for an ACK cluster](https://help.aliyun.com/document_detail/186964.html).
4570
+ * For more information about the network planning of ACK clusters, see [Plan CIDR blocks for an ACK cluster](https://help.aliyun.com/document_detail/186964.html).
4518
4571
  *
4519
4572
  * @example
4520
4573
  * 172.20.0.0/16
@@ -4528,6 +4581,9 @@ export declare class DescribeClusterDetailResponseBody extends $tea.Model {
4528
4581
  */
4529
4582
  tags?: Tag[];
4530
4583
  /**
4584
+ * @remarks
4585
+ * The time zone.
4586
+ *
4531
4587
  * @example
4532
4588
  * Asia/Shanghai
4533
4589
  */
@@ -4550,7 +4606,7 @@ export declare class DescribeClusterDetailResponseBody extends $tea.Model {
4550
4606
  vpcId?: string;
4551
4607
  /**
4552
4608
  * @remarks
4553
- * The IDs of the vSwitches. You can select one to three vSwitches when you create a cluster. We recommend that you select vSwitches in different zones to ensure high availability.
4609
+ * The IDs of the vSwitches. You can select one to three vSwitches when you create a cluster. To ensure the high availability of the cluster, we recommend that you select vSwitches in different zones.
4554
4610
  *
4555
4611
  * @example
4556
4612
  * vsw-2zete8s4qocqg0mf6****,vsw-2zete8s4qocqg0mf6****
@@ -4558,6 +4614,10 @@ export declare class DescribeClusterDetailResponseBody extends $tea.Model {
4558
4614
  * @deprecated
4559
4615
  */
4560
4616
  vswitchId?: string;
4617
+ /**
4618
+ * @remarks
4619
+ * The vSwitch for the control plane of the cluster.
4620
+ */
4561
4621
  vswitchIds?: string[];
4562
4622
  /**
4563
4623
  * @remarks
@@ -4568,6 +4628,9 @@ export declare class DescribeClusterDetailResponseBody extends $tea.Model {
4568
4628
  */
4569
4629
  workerRamRoleName?: string;
4570
4630
  /**
4631
+ * @remarks
4632
+ * The ID of the zone within the region where the cluster is located.
4633
+ *
4571
4634
  * @example
4572
4635
  * cn-beijing-a
4573
4636
  */
@@ -4692,6 +4755,7 @@ export declare class DescribeClusterNodePoolDetailResponseBody extends $tea.Mode
4692
4755
  * The auto scaling configuration of the node pool.
4693
4756
  */
4694
4757
  autoScaling?: DescribeClusterNodePoolDetailResponseBodyAutoScaling;
4758
+ hostNetwork?: boolean;
4695
4759
  /**
4696
4760
  * @remarks
4697
4761
  * The network configuration of the edge node pool. This parameter takes effect only for edge node pools.
@@ -4705,9 +4769,10 @@ export declare class DescribeClusterNodePoolDetailResponseBody extends $tea.Mode
4705
4769
  * improved
4706
4770
  */
4707
4771
  interconnectMode?: string;
4772
+ intranet?: boolean;
4708
4773
  /**
4709
4774
  * @remarks
4710
- * The configuration of the cluster where the node pool is deployed.
4775
+ * The configurations of the cluster in which the node pool is deployed.
4711
4776
  */
4712
4777
  kubernetesConfig?: DescribeClusterNodePoolDetailResponseBodyKubernetesConfig;
4713
4778
  /**
@@ -5222,6 +5287,81 @@ export declare class DescribeClustersResponse extends $tea.Model {
5222
5287
  [key: string]: any;
5223
5288
  });
5224
5289
  }
5290
+ export declare class DescribeClustersForRegionRequest extends $tea.Model {
5291
+ /**
5292
+ * @example
5293
+ * c8155823d057948c69a****
5294
+ */
5295
+ clusterId?: string;
5296
+ /**
5297
+ * @example
5298
+ * ack.standard
5299
+ */
5300
+ clusterSpec?: string;
5301
+ /**
5302
+ * @example
5303
+ * Kubernetes
5304
+ */
5305
+ clusterType?: string;
5306
+ /**
5307
+ * @example
5308
+ * test-cluster
5309
+ */
5310
+ name?: string;
5311
+ /**
5312
+ * @example
5313
+ * 10
5314
+ */
5315
+ pageNumber?: number;
5316
+ /**
5317
+ * @example
5318
+ * 3
5319
+ */
5320
+ pageSize?: number;
5321
+ /**
5322
+ * @example
5323
+ * Serverless
5324
+ */
5325
+ profile?: string;
5326
+ static names(): {
5327
+ [key: string]: string;
5328
+ };
5329
+ static types(): {
5330
+ [key: string]: any;
5331
+ };
5332
+ constructor(map?: {
5333
+ [key: string]: any;
5334
+ });
5335
+ }
5336
+ export declare class DescribeClustersForRegionResponseBody extends $tea.Model {
5337
+ clusters?: DescribeClustersForRegionResponseBodyClusters[];
5338
+ pageInfo?: DescribeClustersForRegionResponseBodyPageInfo;
5339
+ static names(): {
5340
+ [key: string]: string;
5341
+ };
5342
+ static types(): {
5343
+ [key: string]: any;
5344
+ };
5345
+ constructor(map?: {
5346
+ [key: string]: any;
5347
+ });
5348
+ }
5349
+ export declare class DescribeClustersForRegionResponse extends $tea.Model {
5350
+ headers?: {
5351
+ [key: string]: string;
5352
+ };
5353
+ statusCode?: number;
5354
+ body?: DescribeClustersForRegionResponseBody;
5355
+ static names(): {
5356
+ [key: string]: string;
5357
+ };
5358
+ static types(): {
5359
+ [key: string]: any;
5360
+ };
5361
+ constructor(map?: {
5362
+ [key: string]: any;
5363
+ });
5364
+ }
5225
5365
  export declare class DescribeClustersV1Request extends $tea.Model {
5226
5366
  /**
5227
5367
  * @remarks
@@ -5690,7 +5830,7 @@ export declare class DescribeEventsRequest extends $tea.Model {
5690
5830
  export declare class DescribeEventsResponseBody extends $tea.Model {
5691
5831
  /**
5692
5832
  * @remarks
5693
- * The details of the event.
5833
+ * The details of the events.
5694
5834
  */
5695
5835
  events?: DescribeEventsResponseBodyEvents[];
5696
5836
  /**
@@ -5724,6 +5864,61 @@ export declare class DescribeEventsResponse extends $tea.Model {
5724
5864
  [key: string]: any;
5725
5865
  });
5726
5866
  }
5867
+ export declare class DescribeEventsForRegionRequest extends $tea.Model {
5868
+ /**
5869
+ * @example
5870
+ * cf62854ac2130470897be7a27ed1f****
5871
+ */
5872
+ clusterId?: string;
5873
+ /**
5874
+ * @example
5875
+ * 1
5876
+ */
5877
+ pageNumber?: number;
5878
+ /**
5879
+ * @example
5880
+ * 50
5881
+ */
5882
+ pageSize?: number;
5883
+ static names(): {
5884
+ [key: string]: string;
5885
+ };
5886
+ static types(): {
5887
+ [key: string]: any;
5888
+ };
5889
+ constructor(map?: {
5890
+ [key: string]: any;
5891
+ });
5892
+ }
5893
+ export declare class DescribeEventsForRegionResponseBody extends $tea.Model {
5894
+ events?: DescribeEventsForRegionResponseBodyEvents[];
5895
+ pageInfo?: DescribeEventsForRegionResponseBodyPageInfo;
5896
+ static names(): {
5897
+ [key: string]: string;
5898
+ };
5899
+ static types(): {
5900
+ [key: string]: any;
5901
+ };
5902
+ constructor(map?: {
5903
+ [key: string]: any;
5904
+ });
5905
+ }
5906
+ export declare class DescribeEventsForRegionResponse extends $tea.Model {
5907
+ headers?: {
5908
+ [key: string]: string;
5909
+ };
5910
+ statusCode?: number;
5911
+ body?: DescribeEventsForRegionResponseBody;
5912
+ static names(): {
5913
+ [key: string]: string;
5914
+ };
5915
+ static types(): {
5916
+ [key: string]: any;
5917
+ };
5918
+ constructor(map?: {
5919
+ [key: string]: any;
5920
+ });
5921
+ }
5727
5922
  export declare class DescribeExternalAgentRequest extends $tea.Model {
5728
5923
  /**
5729
5924
  * @remarks
@@ -5822,12 +6017,12 @@ export declare class DescribeKubernetesVersionMetadataRequest extends $tea.Model
5822
6017
  * @remarks
5823
6018
  * The query mode. Valid values:
5824
6019
  *
5825
- * * `supported`: queries all supported versions.
5826
- * * `creatable`: queries only versions that allow you to create clusters.
6020
+ * * `supported`: queries all supported Kubernetes versions.
6021
+ * * `creatable`: queries only Kubernetes versions of clusters that you can create.
5827
6022
  *
5828
6023
  * If you specify `KubernetesVersion`, this parameter does not take effect.
5829
6024
  *
5830
- * Default value: creatable.
6025
+ * If you do not specify a query mode, Kubernetes versions of clusters that you can create are returned.
5831
6026
  *
5832
6027
  * @example
5833
6028
  * supported
@@ -6997,7 +7192,10 @@ export declare class GetClusterAddonInstanceResponse extends $tea.Model {
6997
7192
  export declare class GetClusterAuditProjectResponseBody extends $tea.Model {
6998
7193
  /**
6999
7194
  * @remarks
7000
- * Indicates whether the cluster auditing feature is enabled for the cluster. `true`: The cluster auditing feature is enabled for the cluster. `false`: The cluster auditing feature is disabled for the cluster.
7195
+ * Indicates whether the cluster auditing feature is enabled for the cluster.
7196
+ *
7197
+ * * `true`: The cluster auditing feature is enabled for the cluster.
7198
+ * * `false`: The cluster auditing feature is disabled for the cluster.
7001
7199
  *
7002
7200
  * @example
7003
7201
  * true
@@ -7859,7 +8057,7 @@ export declare class ListTagResourcesRequest extends $tea.Model {
7859
8057
  resourceType?: string;
7860
8058
  /**
7861
8059
  * @remarks
7862
- * The list of labels that you want to query. You can specify at most 20 labels.
8060
+ * The labels that you want to query. You can specify up to 20 labels.
7863
8061
  *
7864
8062
  * @example
7865
8063
  * [{\\"key\\":\\"env\\",\\"value\\",\\"dev\\"},{\\"key\\":\\"dev\\", \\"value\\":\\"IT\\"}]
@@ -7916,7 +8114,7 @@ export declare class ListTagResourcesShrinkRequest extends $tea.Model {
7916
8114
  resourceType?: string;
7917
8115
  /**
7918
8116
  * @remarks
7919
- * The list of labels that you want to query. You can specify at most 20 labels.
8117
+ * The labels that you want to query. You can specify up to 20 labels.
7920
8118
  *
7921
8119
  * @example
7922
8120
  * [{\\"key\\":\\"env\\",\\"value\\",\\"dev\\"},{\\"key\\":\\"dev\\", \\"value\\":\\"IT\\"}]
@@ -8518,9 +8716,13 @@ export declare class ModifyClusterTagsResponse extends $tea.Model {
8518
8716
  export declare class ModifyNodePoolNodeConfigRequest extends $tea.Model {
8519
8717
  /**
8520
8718
  * @remarks
8521
- * The parameter settings of the kubelet.
8719
+ * The parameters of the kubelet.
8522
8720
  */
8523
8721
  kubeletConfig?: KubeletConfig;
8722
+ /**
8723
+ * @remarks
8724
+ * Operating system parameter configuration.
8725
+ */
8524
8726
  osConfig?: ModifyNodePoolNodeConfigRequestOsConfig;
8525
8727
  /**
8526
8728
  * @remarks
@@ -9377,15 +9579,15 @@ export declare class ScaleOutClusterRequest extends $tea.Model {
9377
9579
  runtime?: Runtime;
9378
9580
  /**
9379
9581
  * @remarks
9380
- * The labels that you want to add to nodes. You must add labels based on the following rules:
9582
+ * The tags that you want to add to nodes. When you add labels to a node, the following rules apply:
9381
9583
  *
9382
9584
  * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
9383
- * * 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).
9585
+ * * 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).
9384
9586
  */
9385
9587
  tags?: Tag[];
9386
9588
  /**
9387
9589
  * @remarks
9388
- * 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/).
9590
+ * 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/).
9389
9591
  */
9390
9592
  taints?: Taint[];
9391
9593
  /**
@@ -9408,7 +9610,7 @@ export declare class ScaleOutClusterRequest extends $tea.Model {
9408
9610
  * 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:
9409
9611
  *
9410
9612
  * * `true`: enables auto-renewal.
9411
- * * `false`: does not enable auto-renewal.
9613
+ * * `false`: disables auto-renewal.
9412
9614
  *
9413
9615
  * Default value: `true`.
9414
9616
  *
@@ -9440,7 +9642,7 @@ export declare class ScaleOutClusterRequest extends $tea.Model {
9440
9642
  * * `PrePaid`: subscription.
9441
9643
  * * `PostPaid`: pay-as-you-go.
9442
9644
  *
9443
- * Default value: `PostPaid`.
9645
+ * Default value: `PostPaid`
9444
9646
  *
9445
9647
  * @example
9446
9648
  * PrePaid
@@ -9459,7 +9661,7 @@ export declare class ScaleOutClusterRequest extends $tea.Model {
9459
9661
  *
9460
9662
  * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
9461
9663
  *
9462
- * Default value: 1.
9664
+ * Default value: 1
9463
9665
  *
9464
9666
  * @example
9465
9667
  * 1
@@ -9778,7 +9980,7 @@ export declare class SyncClusterNodePoolResponse extends $tea.Model {
9778
9980
  export declare class TagResourcesRequest extends $tea.Model {
9779
9981
  /**
9780
9982
  * @remarks
9781
- * The region ID of the resource.
9983
+ * The ID of the region in which the resource resides.
9782
9984
  *
9783
9985
  * This parameter is required.
9784
9986
  *
@@ -9795,7 +9997,7 @@ export declare class TagResourcesRequest extends $tea.Model {
9795
9997
  resourceIds?: string[];
9796
9998
  /**
9797
9999
  * @remarks
9798
- * The type of resource that you want to label. Set the value to `CLUSTER`.
10000
+ * The type of resources that you want to label. Valid value: `CLUSTER`.
9799
10001
  *
9800
10002
  * This parameter is required.
9801
10003
  *
@@ -9805,11 +10007,11 @@ export declare class TagResourcesRequest extends $tea.Model {
9805
10007
  resourceType?: string;
9806
10008
  /**
9807
10009
  * @remarks
9808
- * The labels that you want to add to the resources in key-value pairs. You can add up to 20 labels. Usage notes:
10010
+ * The tags that you want to add to the resources in key-value pairs. You can add up to 20 key-value pairs. Note:
9809
10011
  *
9810
- * * Label values must not be empty strings. A label value must be 1 to 128 characters in length.
9811
- * * The label value must not start with `aliyun` or `acs:`.
9812
- * * The label value must not contain `http://` or `https://`.
10012
+ * * The values must not be empty strings. A value must be 1 to 128 characters in length.
10013
+ * * A key or value must not start with `aliyun` or `acs:`.
10014
+ * * A key or value must not contain `http://` or `https://`.
9813
10015
  *
9814
10016
  * This parameter is required.
9815
10017
  */
@@ -10664,7 +10866,7 @@ export declare class UpgradeClusterAddonsRequest extends $tea.Model {
10664
10866
  export declare class UpgradeClusterAddonsResponseBody extends $tea.Model {
10665
10867
  /**
10666
10868
  * @remarks
10667
- * The ID of the cluster.
10869
+ * The cluster ID.
10668
10870
  *
10669
10871
  * @example
10670
10872
  * cf4299b79b3e34226abfdc80a4bda****
@@ -10672,7 +10874,7 @@ export declare class UpgradeClusterAddonsResponseBody extends $tea.Model {
10672
10874
  clusterId?: string;
10673
10875
  /**
10674
10876
  * @remarks
10675
- * The ID of the request.
10877
+ * The request ID.
10676
10878
  *
10677
10879
  * @example
10678
10880
  * bfd12953-31cb-42f1-8a36-7b80ec345094
@@ -10680,7 +10882,7 @@ export declare class UpgradeClusterAddonsResponseBody extends $tea.Model {
10680
10882
  requestId?: string;
10681
10883
  /**
10682
10884
  * @remarks
10683
- * The ID of the task.
10885
+ * The task ID.
10684
10886
  *
10685
10887
  * @example
10686
10888
  * T-62a944794ee141074400****
@@ -10749,7 +10951,7 @@ export declare class UpgradeClusterNodepoolRequest extends $tea.Model {
10749
10951
  runtimeType?: string;
10750
10952
  /**
10751
10953
  * @remarks
10752
- * The version of the container runtime that is used by the nodes. You can call the [DescribeKubernetesVersionMetadata](https://help.aliyun.com/document_detail/2667899.html) operation to query the runtime version information returned in the runtime parameter.
10954
+ * The version of the container runtime that is used by the nodes. You can call the [DescribeKubernetesVersionMetadata](https://help.aliyun.com/document_detail/2667899.html) operation to query the runtime version returned in the runtime parameter.
10753
10955
  *
10754
10956
  * @example
10755
10957
  * 1.5.10
@@ -11496,7 +11698,25 @@ export declare class CheckServiceRoleResponseBodyRoles extends $tea.Model {
11496
11698
  });
11497
11699
  }
11498
11700
  export declare class CreateClusterRequestOperationPolicyClusterAutoUpgrade extends $tea.Model {
11701
+ /**
11702
+ * @remarks
11703
+ * Cluster auto-upgrade frequency. Possible values:
11704
+ *
11705
+ * - patch
11706
+ * - stable
11707
+ * - rapid
11708
+ *
11709
+ * @example
11710
+ * patch
11711
+ */
11499
11712
  channel?: string;
11713
+ /**
11714
+ * @remarks
11715
+ * Whether to enable automatic cluster upgrades.
11716
+ *
11717
+ * @example
11718
+ * true
11719
+ */
11500
11720
  enabled?: boolean;
11501
11721
  static names(): {
11502
11722
  [key: string]: string;
@@ -11509,6 +11729,10 @@ export declare class CreateClusterRequestOperationPolicyClusterAutoUpgrade exten
11509
11729
  });
11510
11730
  }
11511
11731
  export declare class CreateClusterRequestOperationPolicy extends $tea.Model {
11732
+ /**
11733
+ * @remarks
11734
+ * Automatic cluster upgrade
11735
+ */
11512
11736
  clusterAutoUpgrade?: CreateClusterRequestOperationPolicyClusterAutoUpgrade;
11513
11737
  static names(): {
11514
11738
  [key: string]: string;
@@ -11533,12 +11757,12 @@ export declare class CreateClusterRequestWorkerDataDisks extends $tea.Model {
11533
11757
  category?: string;
11534
11758
  /**
11535
11759
  * @remarks
11536
- * Specifies whether to encrypt the data disk. Valid values:
11760
+ * Specifies whether to encrypt the data disks. Valid values:
11537
11761
  *
11538
11762
  * * `true`: encrypts the data disk.
11539
11763
  * * `false`: does not encrypt the data disk.
11540
11764
  *
11541
- * Default value: `false`.
11765
+ * Default value: `false`
11542
11766
  *
11543
11767
  * @example
11544
11768
  * true
@@ -11581,7 +11805,7 @@ export declare class CreateClusterNodePoolRequestAutoScaling extends $tea.Model
11581
11805
  *
11582
11806
  * **
11583
11807
  *
11584
- * **Important** This parameter is deprecated. Use internet_charge_type and internet_max_bandwidth_out.
11808
+ * **Important** This parameter is deprecated. Use the internet_charge_type and internet_max_bandwidth_out parameters instead.
11585
11809
  *
11586
11810
  * @example
11587
11811
  * 5
@@ -11602,7 +11826,7 @@ export declare class CreateClusterNodePoolRequestAutoScaling extends $tea.Model
11602
11826
  *
11603
11827
  * **
11604
11828
  *
11605
- * **Important** This parameter is deprecated. Use internet_charge_type and internet_max_bandwidth_out.
11829
+ * **Important** This parameter is deprecated. Use the internet_charge_type and internet_max_bandwidth_out parameters instead.
11606
11830
  *
11607
11831
  * @example
11608
11832
  * PayByBandwidth
@@ -11636,7 +11860,7 @@ export declare class CreateClusterNodePoolRequestAutoScaling extends $tea.Model
11636
11860
  *
11637
11861
  * **
11638
11862
  *
11639
- * **Important** This parameter is deprecated. Use internet_charge_type and internet_max_bandwidth_out.
11863
+ * **Important** This parameter is deprecated. Use the internet_charge_type and internet_max_bandwidth_out parameters instead.
11640
11864
  *
11641
11865
  * @example
11642
11866
  * true
@@ -11764,7 +11988,7 @@ export declare class CreateClusterNodePoolRequestKubernetesConfig extends $tea.M
11764
11988
  cmsEnabled?: boolean;
11765
11989
  /**
11766
11990
  * @remarks
11767
- * 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:
11991
+ * The CPU management policy of nodes. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
11768
11992
  *
11769
11993
  * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
11770
11994
  * * `none`: specifies that the default CPU affinity is used.
@@ -11777,12 +12001,12 @@ export declare class CreateClusterNodePoolRequestKubernetesConfig extends $tea.M
11777
12001
  cpuPolicy?: string;
11778
12002
  /**
11779
12003
  * @remarks
11780
- * The labels that you want to add to nodes in the cluster.
12004
+ * The labels that you want to add to the nodes in the cluster.
11781
12005
  */
11782
12006
  labels?: Tag[];
11783
12007
  /**
11784
12008
  * @remarks
11785
- * The custom node name. A custom node name consists of a prefix, a node IP address, and a suffix.
12009
+ * A custom node name consists of a prefix, a node IP address, and a suffix.
11786
12010
  *
11787
12011
  * * The prefix and the suffix can contain multiple parts that are separated by periods (.). Each part can contain lowercase letters, digits, and hyphens (-). A custom node name must start and end with a digit or lowercase letter.
11788
12012
  * * The node IP address in a custom node name is the private IP address of the node.
@@ -11793,10 +12017,17 @@ export declare class CreateClusterNodePoolRequestKubernetesConfig extends $tea.M
11793
12017
  * customized,aliyun,ip,com
11794
12018
  */
11795
12019
  nodeNameMode?: string;
12020
+ /**
12021
+ * @remarks
12022
+ * The user-defined data of nodes. You can specify custom scripts that are automatically executed before the nodes are initialized.
12023
+ *
12024
+ * @example
12025
+ * dGhpcyBpcyBhIGV4YW1wbGU
12026
+ */
11796
12027
  preUserData?: string;
11797
12028
  /**
11798
12029
  * @remarks
11799
- * The name of the container runtime. The following types of runtime are supported by Container Service for Kubernetes (ACK):
12030
+ * The name of the container runtime. The following types of runtime are supported by ACK:
11800
12031
  *
11801
12032
  * * containerd: containerd is the recommended runtime and supports all Kubernetes versions.
11802
12033
  * * Sandboxed-Container.runv: The Sandbox-Container runtime provides improved isolation and supports Kubernetes 1.24 and earlier.
@@ -11831,7 +12062,7 @@ export declare class CreateClusterNodePoolRequestKubernetesConfig extends $tea.M
11831
12062
  unschedulable?: boolean;
11832
12063
  /**
11833
12064
  * @remarks
11834
- * The user data on the node.
12065
+ * The user-defined data of nodes. You can specify custom scripts that are automatically executed after the nodes are initialized.
11835
12066
  *
11836
12067
  * @example
11837
12068
  * dGhpcyBpcyBhIGV4YW1wbGU=
@@ -11931,9 +12162,9 @@ export declare class CreateClusterNodePoolRequestManagementAutoVulFixPolicy exte
11931
12162
  * @remarks
11932
12163
  * The severity levels of CVEs that can be automatically patched. Separate multiple levels with commas (,). Example: `asap,later`. Valid values:
11933
12164
  *
11934
- * * `asap`: high.
11935
- * * `later`: medium.
11936
- * * `nntf`: low.
12165
+ * * `asap`: high severity.
12166
+ * * `later`: medium severity.
12167
+ * * `nntf`: low severity.
11937
12168
  *
11938
12169
  * If `auto_vul_fix` is set to true, the default value of this parameter is `asap`.
11939
12170
  *
@@ -11961,7 +12192,7 @@ export declare class CreateClusterNodePoolRequestManagementUpgradeConfig extends
11961
12192
  *
11962
12193
  * **
11963
12194
  *
11964
- * **Caution** This parameter is deprecated. Use the preceding auto_upgrade parameter.
12195
+ * **Caution** This parameter is deprecated. Use the preceding auto_upgrade parameter instead.
11965
12196
  *
11966
12197
  * @example
11967
12198
  * false
@@ -11971,9 +12202,9 @@ export declare class CreateClusterNodePoolRequestManagementUpgradeConfig extends
11971
12202
  autoUpgrade?: boolean;
11972
12203
  /**
11973
12204
  * @remarks
11974
- * The maximum number of unavailable nodes. Valid values: 1 to 1000.
12205
+ * The maximum number of nodes that can be in the Unavailable state. Valid values: 1 to 1000.
11975
12206
  *
11976
- * Default value: 1
12207
+ * Default value: 1.
11977
12208
  *
11978
12209
  * @example
11979
12210
  * 1
@@ -11981,7 +12212,7 @@ export declare class CreateClusterNodePoolRequestManagementUpgradeConfig extends
11981
12212
  maxUnavailable?: number;
11982
12213
  /**
11983
12214
  * @remarks
11984
- * The number of additional nodes that are temporarily added to the node pool during an auto update.
12215
+ * The number of additional nodes.
11985
12216
  *
11986
12217
  * @example
11987
12218
  * 0
@@ -12150,7 +12381,7 @@ export declare class CreateClusterNodePoolRequestNodepoolInfo extends $tea.Model
12150
12381
  export declare class CreateClusterNodePoolRequestScalingGroupPrivatePoolOptions extends $tea.Model {
12151
12382
  /**
12152
12383
  * @remarks
12153
- * The private node pool ID.
12384
+ * The ID of the private node pool.
12154
12385
  *
12155
12386
  * @example
12156
12387
  * eap-bp67acfmxazb4****
@@ -12160,9 +12391,9 @@ export declare class CreateClusterNodePoolRequestScalingGroupPrivatePoolOptions
12160
12391
  * @remarks
12161
12392
  * The type of private node pool. This parameter specifies the type of private 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:
12162
12393
  *
12163
- * * `Open`: open private node 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.
12164
- * * `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.
12165
- * * `None`: does not use private pools. The resources of private node pools are not used to launch instances.
12394
+ * * `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.
12395
+ * * `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.
12396
+ * * `None`: no private pool is used. The resources of private pools are not used to launch the instances.
12166
12397
  *
12167
12398
  * @example
12168
12399
  * Open
@@ -12189,7 +12420,7 @@ export declare class CreateClusterNodePoolRequestScalingGroupSpotPriceLimit exte
12189
12420
  instanceType?: string;
12190
12421
  /**
12191
12422
  * @remarks
12192
- * The price cap of a preemptible instance.
12423
+ * The price cap of a preemptible instance of the type.
12193
12424
  *
12194
12425
  * @example
12195
12426
  * 0.39
@@ -12258,7 +12489,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12258
12489
  autoRenewPeriod?: number;
12259
12490
  /**
12260
12491
  * @remarks
12261
- * This parameter is deprecated. Use security_hardening_os instead.
12492
+ * This parameter is deprecated. Use the security_hardening_os parameter instead.
12262
12493
  *
12263
12494
  * @example
12264
12495
  * false
@@ -12279,7 +12510,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12279
12510
  compensateWithOnDemand?: boolean;
12280
12511
  /**
12281
12512
  * @remarks
12282
- * The configurations of the data disks that are mounted to nodes in the node pool.
12513
+ * The configurations of the data disks that are attached to nodes in the node pool.
12283
12514
  */
12284
12515
  dataDisks?: DataDisk[];
12285
12516
  /**
@@ -12300,7 +12531,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12300
12531
  desiredSize?: number;
12301
12532
  /**
12302
12533
  * @remarks
12303
- * The custom image ID. By default, the image provided by ACK is used.
12534
+ * The custom image ID. By default, the image provided by Container Service for Kubernetes (ACK) is used.
12304
12535
  *
12305
12536
  * @example
12306
12537
  * aliyun_2_1903_x64_20G_alibase_20200529.vhd
@@ -12341,7 +12572,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12341
12572
  instanceChargeType?: string;
12342
12573
  /**
12343
12574
  * @remarks
12344
- * The instance attributes.
12575
+ * The instance properties.
12345
12576
  */
12346
12577
  instancePatterns?: InstancePatterns[];
12347
12578
  /**
@@ -12392,7 +12623,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12392
12623
  loginAsNonRoot?: boolean;
12393
12624
  /**
12394
12625
  * @remarks
12395
- * The password for SSH logon. You must specify 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.
12626
+ * 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.
12396
12627
  *
12397
12628
  * @example
12398
12629
  * Hello1234
@@ -12404,13 +12635,13 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12404
12635
  *
12405
12636
  * * `PRIORITY`: ECS instances are scaled based on the value of VSwitchIds.N. If an ECS instance cannot be created in the zone where the vSwitch that has the highest priority resides, the system creates the ECS instance in the zone where the vSwitch that has the next highest priority resides.
12406
12637
  *
12407
- * * `COST_OPTIMIZED`: ECS instances are created based on the vCPU unit price in ascending order. Preemptible instances are preferably created when preemptible instance types are specified in the scaling configurations. You can set `CompensateWithOnDemand` to specify whether to automatically create pay-as-you-go instances when preemptible instances cannot be created due to insufficient inventory.
12638
+ * * `COST_OPTIMIZED`: ECS instances are created based on the vCPU unit price in ascending order. Preemptible instances are preferably created if preemptible instance types are specified in the scaling configurations. You can set the `CompensateWithOnDemand` parameter to specify whether to automatically create pay-as-you-go instances when preemptible instances cannot be created due to insufficient inventory.
12408
12639
  *
12409
12640
  * **
12410
12641
  *
12411
- * **Note** `COST_OPTIMIZED` is valid only when multiple instance types are specified or at least one preemptible instance type is specified.
12642
+ * **Note** `COST_OPTIMIZED` takes effect only when multiple instance types are specified or at least one preemptible instance type is specified.
12412
12643
  *
12413
- * * `BALANCE`: ECS instances are evenly distributed across multiple zones specified by the scaling group. If ECS instances become imbalanced among multiple zones due to insufficient inventory, you can call the [RebalanceInstances](https://help.aliyun.com/document_detail/71516.html) operation of Auto Scaling to evenly distribute the ECS instances among zones.
12644
+ * * `BALANCE`: ECS instances are evenly distributed across multiple zones for the scaling group. If ECS instances become imbalanced among multiple zones due to insufficient inventory, you can call the [RebalanceInstances](https://help.aliyun.com/document_detail/71516.html) operation of Auto Scaling to evenly distribute the ECS instances among zones.
12414
12645
  *
12415
12646
  * Default value: `PRIORITY`.
12416
12647
  *
@@ -12420,7 +12651,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12420
12651
  multiAzPolicy?: string;
12421
12652
  /**
12422
12653
  * @remarks
12423
- * The minimum number of pay-as-you-go instances that must be kept in the scaling group. Valid values: 0 to 1000. If the number of pay-as-you-go instances is smaller than the value of this parameter, Auto Scaling preferably creates pay-as-you-go instances.
12654
+ * The minimum number of pay-as-you-go instances that must be kept in the scaling group. Valid values: 0 to 1000. If the number of pay-as-you-go instances is less than the value of this parameter, the system preferably creates pay-as-you-go instances.
12424
12655
  *
12425
12656
  * @example
12426
12657
  * 0
@@ -12460,7 +12691,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12460
12691
  periodUnit?: string;
12461
12692
  /**
12462
12693
  * @remarks
12463
- * The OS distribution that is used. Valid values:
12694
+ * The operating system distribution. Valid values:
12464
12695
  *
12465
12696
  * * `CentOS`
12466
12697
  * * `AliyunLinux`
@@ -12482,7 +12713,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12482
12713
  privatePoolOptions?: CreateClusterNodePoolRequestScalingGroupPrivatePoolOptions;
12483
12714
  /**
12484
12715
  * @remarks
12485
- * The name of the worker Resource Access Management (RAM) role.
12716
+ * The name of the worker RAM role.
12486
12717
  *
12487
12718
  * * If you do not specify this parameter, the default worker RAM role created by the cluster is used.
12488
12719
  * * 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-`.
@@ -12504,7 +12735,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12504
12735
  * @remarks
12505
12736
  * The scaling mode of the scaling group. Valid values:
12506
12737
  *
12507
- * * `release`: the standard mode. ECS instances are created and released based on resource usage.
12738
+ * * `release`: the standard mode. ECS instances are created and released based on the resource usage.
12508
12739
  * * `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.
12509
12740
  *
12510
12741
  * Default value: `release`.
@@ -12540,7 +12771,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12540
12771
  securityHardeningOs?: boolean;
12541
12772
  /**
12542
12773
  * @remarks
12543
- * Specifies whether to enable MLPS Security Hardening. You can enable MLPS Security Hardening only when Alibaba Cloud Linux 2 or Alibaba Cloud Linux 3 is installed on nodes. Alibaba Cloud provides standards for baseline checks and a scanner to ensure the compliance of Alibaba Cloud Linux 2 and Alibaba Cloud Linux 3 images with the level 3 standards of MLPS 2.0.
12774
+ * Specifies whether to enable MLPS Security Hardening. You can enable security hardening based on Multi-Level Protection Scheme (MLPS) only when Alibaba Cloud Linux 2 or Alibaba Cloud Linux 3 is installed on nodes. Alibaba Cloud provides standards for baseline checks and a scanner to ensure the compliance of Alibaba Cloud Linux 2 and Alibaba Cloud Linux 3 images with the level 3 standards of MLPS 2.0.
12544
12775
  *
12545
12776
  * @example
12546
12777
  * false
@@ -12556,10 +12787,10 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12556
12787
  spotInstancePools?: number;
12557
12788
  /**
12558
12789
  * @remarks
12559
- * Specifies whether to supplement 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 creates a new instance to replace this instance. Valid values:
12790
+ * 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:
12560
12791
  *
12561
- * * `true`: supplements preemptible instances.
12562
- * * `false`: does not supplement preemptible instances.
12792
+ * * `true`: enables the supplementation of preemptible instances.
12793
+ * * `false`: disables the supplementation of preemptible instances.
12563
12794
  *
12564
12795
  * @example
12565
12796
  * false
@@ -12575,10 +12806,10 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12575
12806
  * The bidding policy of preemptible instances. Valid values:
12576
12807
  *
12577
12808
  * * `NoSpot`: non-preemptible.
12578
- * * `SpotWithPriceLimit`: specifies the highest bid.
12809
+ * * `SpotWithPriceLimit`: specifies the highest bid for the preemptible instance.
12579
12810
  * * `SpotAsPriceGo`: automatically submits bids based on the up-to-date market price.
12580
12811
  *
12581
- * For more information, see [Preemptible instances](https://help.aliyun.com/document_detail/165053.html).
12812
+ * For more information, see [Use preemptible instances](https://help.aliyun.com/document_detail/165053.html).
12582
12813
  *
12583
12814
  * @example
12584
12815
  * NoSpot
@@ -12599,7 +12830,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12599
12830
  systemDiskBurstingEnabled?: boolean;
12600
12831
  /**
12601
12832
  * @remarks
12602
- * The system disk types. The system creates system disks of a disk type with a lower priority if the disk type with a higher priority is unavailable. Valid values:
12833
+ * 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:
12603
12834
  *
12604
12835
  * * `cloud`: basic disk.
12605
12836
  * * `cloud_efficiency`: ultra disk.
@@ -12611,7 +12842,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12611
12842
  systemDiskCategories?: string[];
12612
12843
  /**
12613
12844
  * @remarks
12614
- * The system disk type. Valid values:
12845
+ * The category of the system disk for nodes. Valid values:
12615
12846
  *
12616
12847
  * * `cloud`: basic disk.
12617
12848
  * * `cloud_efficiency`: ultra disk.
@@ -12669,7 +12900,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12669
12900
  * @remarks
12670
12901
  * 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}.
12671
12902
  *
12672
- * This parameter is available only when `SystemDiskCategory` is set to `cloud_auto`. For more information, see [ESSD AutoPL disks](https://help.aliyun.com/document_detail/368372.html).
12903
+ * 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).
12673
12904
  *
12674
12905
  * @example
12675
12906
  * 1000
@@ -12689,7 +12920,7 @@ export declare class CreateClusterNodePoolRequestScalingGroup extends $tea.Model
12689
12920
  * @remarks
12690
12921
  * The labels that you want to add only to ECS instances.
12691
12922
  *
12692
- * The label key must be unique and cannot exceed 128 characters in length. The label key and value cannot start with aliyun or acs: and cannot contain https:// or http://.
12923
+ * 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://.
12693
12924
  */
12694
12925
  tags?: CreateClusterNodePoolRequestScalingGroupTags[];
12695
12926
  /**
@@ -12885,7 +13116,27 @@ export declare class DescribeAddonsResponseBodyComponentGroups extends $tea.Mode
12885
13116
  });
12886
13117
  }
12887
13118
  export declare class DescribeClusterDetailResponseBodyOperationPolicyClusterAutoUpgrade extends $tea.Model {
13119
+ /**
13120
+ * @remarks
13121
+ * The frequency of auto cluster updates. For more information, see [Update frequency](https://help.aliyun.com/document_detail/2712866.html).
13122
+ *
13123
+ * Valid values:
13124
+ *
13125
+ * * patch: specifies the latest patch version.
13126
+ * * stable: specifies the second-latest minor version.
13127
+ * * rapid: specifies the latest minor version.
13128
+ *
13129
+ * @example
13130
+ * patch
13131
+ */
12888
13132
  channel?: string;
13133
+ /**
13134
+ * @remarks
13135
+ * Specifies whether to enable auto cluster update.
13136
+ *
13137
+ * @example
13138
+ * true
13139
+ */
12889
13140
  enabled?: boolean;
12890
13141
  static names(): {
12891
13142
  [key: string]: string;
@@ -12898,6 +13149,10 @@ export declare class DescribeClusterDetailResponseBodyOperationPolicyClusterAuto
12898
13149
  });
12899
13150
  }
12900
13151
  export declare class DescribeClusterDetailResponseBodyOperationPolicy extends $tea.Model {
13152
+ /**
13153
+ * @remarks
13154
+ * The configurations of auto cluster update.
13155
+ */
12901
13156
  clusterAutoUpgrade?: DescribeClusterDetailResponseBodyOperationPolicyClusterAutoUpgrade;
12902
13157
  static names(): {
12903
13158
  [key: string]: string;
@@ -13296,6 +13551,10 @@ export declare class DescribeClusterNodePoolDetailResponseBodyKubernetesConfig e
13296
13551
  * customized,test.,5,.com
13297
13552
  */
13298
13553
  nodeNameMode?: string;
13554
+ /**
13555
+ * @remarks
13556
+ * 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).
13557
+ */
13299
13558
  preUserData?: string;
13300
13559
  /**
13301
13560
  * @remarks
@@ -13328,7 +13587,7 @@ export declare class DescribeClusterNodePoolDetailResponseBodyKubernetesConfig e
13328
13587
  unschedulable?: boolean;
13329
13588
  /**
13330
13589
  * @remarks
13331
- * The user data of the node pool. For more information, see [Generate user data](https://help.aliyun.com/document_detail/49121.html).
13590
+ * The custom script to be executed after nodes in the node pool are initialized. For more information, see [Generate user-defined data](https://help.aliyun.com/document_detail/49121.html).
13332
13591
  *
13333
13592
  * @example
13334
13593
  * IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi
@@ -14393,7 +14652,7 @@ export declare class DescribeClusterNodePoolsResponseBodyNodepoolsKubernetesConf
14393
14652
  cpuPolicy?: string;
14394
14653
  /**
14395
14654
  * @remarks
14396
- * The labels that you want to add to the nodes in the cluster. You must add labels based on the following rules:
14655
+ * The labels that are added to the nodes in the cluster. You must add labels based on the following rules:
14397
14656
  *
14398
14657
  * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
14399
14658
  * * The key must be unique and can be up to 64 characters in length. The value can be empty and can be up to 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).
@@ -14412,6 +14671,13 @@ export declare class DescribeClusterNodePoolsResponseBodyNodepoolsKubernetesConf
14412
14671
  * customized,test.,5,.com
14413
14672
  */
14414
14673
  nodeNameMode?: string;
14674
+ /**
14675
+ * @remarks
14676
+ * 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).
14677
+ *
14678
+ * @example
14679
+ * IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD
14680
+ */
14415
14681
  preUserData?: string;
14416
14682
  /**
14417
14683
  * @remarks
@@ -14431,7 +14697,7 @@ export declare class DescribeClusterNodePoolsResponseBodyNodepoolsKubernetesConf
14431
14697
  runtimeVersion?: string;
14432
14698
  /**
14433
14699
  * @remarks
14434
- * The taints of the nodes in the node pool. Taints can be used together with tolerations to prevent pods from being scheduled to specified nodes. For more information, see [taint-and-toleration](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/).
14700
+ * 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/).
14435
14701
  */
14436
14702
  taints?: Taint[];
14437
14703
  /**
@@ -14444,7 +14710,7 @@ export declare class DescribeClusterNodePoolsResponseBodyNodepoolsKubernetesConf
14444
14710
  unschedulable?: boolean;
14445
14711
  /**
14446
14712
  * @remarks
14447
- * The user data of the node pool. For more information, see [Generate user-defined data](https://help.aliyun.com/document_detail/49121.html).
14713
+ * The user-defined script that is executed after nodes are initialized. For more information, see [Generate user-defined data](https://help.aliyun.com/document_detail/49121.html).
14448
14714
  *
14449
14715
  * @example
14450
14716
  * IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****
@@ -14647,7 +14913,7 @@ export declare class DescribeClusterNodePoolsResponseBodyNodepoolsManagement ext
14647
14913
  export declare class DescribeClusterNodePoolsResponseBodyNodepoolsNodeConfig extends $tea.Model {
14648
14914
  /**
14649
14915
  * @remarks
14650
- * The parameter settings of the kubelet.
14916
+ * The configurations of the kubelet.
14651
14917
  */
14652
14918
  kubeletConfiguration?: KubeletConfig;
14653
14919
  static names(): {
@@ -14896,7 +15162,7 @@ export declare class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup e
14896
15162
  instanceChargeType?: string;
14897
15163
  /**
14898
15164
  * @remarks
14899
- * Instance attributes
15165
+ * The attributes of an instance.
14900
15166
  */
14901
15167
  instancePatterns?: InstancePatterns[];
14902
15168
  /**
@@ -15142,7 +15408,7 @@ export declare class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup e
15142
15408
  systemDiskBurstingEnabled?: boolean;
15143
15409
  /**
15144
15410
  * @remarks
15145
- * The system disk types. The system attempts to create system disks from a disk type with a lower priority when the disk type with a higher priority is unavailable. Valid values: cloud: disk cloud_efficiency: utra disk cloud_ssd: standard SSD cloud_essd: Enterprise SSD (ESSD)
15411
+ * 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).
15146
15412
  */
15147
15413
  systemDiskCategories?: string[];
15148
15414
  /**
@@ -15158,7 +15424,7 @@ export declare class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup e
15158
15424
  systemDiskCategory?: string;
15159
15425
  /**
15160
15426
  * @remarks
15161
- * The algorithm that you want to use to encrypt the system disk. Set the value to aes-256.
15427
+ * The encryption algorithm that is used to encrypt the system disk. The value is aes-256.
15162
15428
  *
15163
15429
  * @example
15164
15430
  * aes-256
@@ -15211,7 +15477,7 @@ export declare class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup e
15211
15477
  systemDiskSize?: number;
15212
15478
  /**
15213
15479
  * @remarks
15214
- * The tag that you want to add only to ECS instances.
15480
+ * The labels that you want to add only to Elastic Compute Service (ECS) instances.
15215
15481
  *
15216
15482
  * 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://.
15217
15483
  */
@@ -15387,7 +15653,7 @@ export declare class DescribeClusterNodePoolsResponseBodyNodepools extends $tea.
15387
15653
  nodepoolInfo?: DescribeClusterNodePoolsResponseBodyNodepoolsNodepoolInfo;
15388
15654
  /**
15389
15655
  * @remarks
15390
- * The configuration of the scaling group.
15656
+ * The configurations of the scaling group.
15391
15657
  */
15392
15658
  scalingGroup?: DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup;
15393
15659
  /**
@@ -16087,8 +16353,185 @@ export declare class DescribeClustersResponseBody extends $tea.Model {
16087
16353
  [key: string]: any;
16088
16354
  });
16089
16355
  }
16356
+ export declare class DescribeClustersForRegionResponseBodyClusters extends $tea.Model {
16357
+ /**
16358
+ * @example
16359
+ * cluster.local
16360
+ */
16361
+ clusterDomain?: string;
16362
+ /**
16363
+ * @example
16364
+ * c905d1364c2dd4b6284a3f41790c4****
16365
+ */
16366
+ clusterId?: string;
16367
+ /**
16368
+ * @example
16369
+ * ack.standard
16370
+ */
16371
+ clusterSpec?: string;
16372
+ /**
16373
+ * @example
16374
+ * ManagedKubernetes
16375
+ */
16376
+ clusterType?: string;
16377
+ /**
16378
+ * @example
16379
+ * 172.20.0.0/16
16380
+ */
16381
+ containerCidr?: string;
16382
+ /**
16383
+ * @example
16384
+ * 2020-12-01T20:40:40+08:00
16385
+ */
16386
+ created?: string;
16387
+ /**
16388
+ * @example
16389
+ * 1.16.6-aliyun.1
16390
+ */
16391
+ currentVersion?: string;
16392
+ /**
16393
+ * @example
16394
+ * false
16395
+ */
16396
+ deletionProtection?: boolean;
16397
+ /**
16398
+ * @example
16399
+ * 1.16.6-aliyun.1
16400
+ */
16401
+ initVersion?: string;
16402
+ /**
16403
+ * @example
16404
+ * ipv4
16405
+ */
16406
+ ipStack?: string;
16407
+ /**
16408
+ * @example
16409
+ * test-cluster
16410
+ */
16411
+ name?: string;
16412
+ /**
16413
+ * @example
16414
+ * 1.18.8-aliyun.1
16415
+ */
16416
+ nextVersion?: string;
16417
+ /**
16418
+ * @example
16419
+ * Default
16420
+ */
16421
+ profile?: string;
16422
+ /**
16423
+ * @example
16424
+ * ipvs
16425
+ */
16426
+ proxyMode?: string;
16427
+ /**
16428
+ * @example
16429
+ * cn-beijing-a
16430
+ */
16431
+ regionId?: string;
16432
+ /**
16433
+ * @example
16434
+ * rg-acfmyvw3wjm****
16435
+ */
16436
+ resourceGroupId?: string;
16437
+ /**
16438
+ * @example
16439
+ * sg-2zeihch86ooz9io4****
16440
+ */
16441
+ securityGroupId?: string;
16442
+ /**
16443
+ * @remarks
16444
+ * This parameter is required.
16445
+ *
16446
+ * @example
16447
+ * 172.21.0.0/20
16448
+ */
16449
+ serviceCidr?: string;
16450
+ /**
16451
+ * @example
16452
+ * 2
16453
+ */
16454
+ size?: number;
16455
+ /**
16456
+ * @example
16457
+ * running
16458
+ */
16459
+ state?: string;
16460
+ tags?: Tag[];
16461
+ /**
16462
+ * @example
16463
+ * Asia/Shanghai
16464
+ */
16465
+ timezone?: string;
16466
+ /**
16467
+ * @example
16468
+ * 2020-12-08T15:37:00+08:00
16469
+ */
16470
+ updated?: string;
16471
+ /**
16472
+ * @example
16473
+ * vpc-2zeg8nf1ukc0fcmvq****
16474
+ */
16475
+ vpcId?: string;
16476
+ vswitchIds?: string[];
16477
+ static names(): {
16478
+ [key: string]: string;
16479
+ };
16480
+ static types(): {
16481
+ [key: string]: any;
16482
+ };
16483
+ constructor(map?: {
16484
+ [key: string]: any;
16485
+ });
16486
+ }
16487
+ export declare class DescribeClustersForRegionResponseBodyPageInfo extends $tea.Model {
16488
+ /**
16489
+ * @example
16490
+ * 1
16491
+ */
16492
+ pageNumber?: number;
16493
+ /**
16494
+ * @example
16495
+ * 10
16496
+ */
16497
+ pageSize?: number;
16498
+ /**
16499
+ * @example
16500
+ * 10
16501
+ */
16502
+ totalCount?: number;
16503
+ static names(): {
16504
+ [key: string]: string;
16505
+ };
16506
+ static types(): {
16507
+ [key: string]: any;
16508
+ };
16509
+ constructor(map?: {
16510
+ [key: string]: any;
16511
+ });
16512
+ }
16090
16513
  export declare class DescribeClustersV1ResponseBodyClustersOperationPolicyClusterAutoUpgrade extends $tea.Model {
16514
+ /**
16515
+ * @remarks
16516
+ * The frequency of auto cluster updates. For more information, see [Update frequency](https://help.aliyun.com/document_detail/2712866.html).
16517
+ *
16518
+ * Valid values:
16519
+ *
16520
+ * * patch: the latest patch version.
16521
+ * * stables: the second-latest minor version.
16522
+ * * rapid: the latest minor version.
16523
+ *
16524
+ * @example
16525
+ * patch
16526
+ */
16091
16527
  channel?: string;
16528
+ /**
16529
+ * @remarks
16530
+ * Specifies whether to enable auto cluster update.
16531
+ *
16532
+ * @example
16533
+ * true
16534
+ */
16092
16535
  enabled?: boolean;
16093
16536
  static names(): {
16094
16537
  [key: string]: string;
@@ -16101,6 +16544,10 @@ export declare class DescribeClustersV1ResponseBodyClustersOperationPolicyCluste
16101
16544
  });
16102
16545
  }
16103
16546
  export declare class DescribeClustersV1ResponseBodyClustersOperationPolicy extends $tea.Model {
16547
+ /**
16548
+ * @remarks
16549
+ * The configurations of auto cluster update.
16550
+ */
16104
16551
  clusterAutoUpgrade?: DescribeClustersV1ResponseBodyClustersOperationPolicyClusterAutoUpgrade;
16105
16552
  static names(): {
16106
16553
  [key: string]: string;
@@ -16114,6 +16561,9 @@ export declare class DescribeClustersV1ResponseBodyClustersOperationPolicy exten
16114
16561
  }
16115
16562
  export declare class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
16116
16563
  /**
16564
+ * @remarks
16565
+ * The domain name of the cluster.
16566
+ *
16117
16567
  * @example
16118
16568
  * cluster.local
16119
16569
  */
@@ -16148,6 +16598,9 @@ export declare class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
16148
16598
  */
16149
16599
  clusterType?: string;
16150
16600
  /**
16601
+ * @remarks
16602
+ * The pod CIDR block.
16603
+ *
16151
16604
  * @example
16152
16605
  * 172.20.0.0/16
16153
16606
  */
@@ -16208,6 +16661,12 @@ export declare class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
16208
16661
  */
16209
16662
  initVersion?: string;
16210
16663
  /**
16664
+ * @remarks
16665
+ * The IP stack of the cluster. Valid values:
16666
+ *
16667
+ * * ipv4: The cluster is an IPv4 cluster.
16668
+ * * dual: The cluster is a dual-stack cluster.
16669
+ *
16211
16670
  * @example
16212
16671
  * ipv4
16213
16672
  */
@@ -16264,6 +16723,10 @@ export declare class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
16264
16723
  * 1.18.8-aliyun.1
16265
16724
  */
16266
16725
  nextVersion?: string;
16726
+ /**
16727
+ * @remarks
16728
+ * The automatic O\\&M policy of the cluster.
16729
+ */
16267
16730
  operationPolicy?: DescribeClustersV1ResponseBodyClustersOperationPolicy;
16268
16731
  /**
16269
16732
  * @remarks
@@ -16290,6 +16753,9 @@ export declare class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
16290
16753
  */
16291
16754
  profile?: string;
16292
16755
  /**
16756
+ * @remarks
16757
+ * The kube-proxy mode. Valid values: ipvs and iptables.
16758
+ *
16293
16759
  * @example
16294
16760
  * ipvs
16295
16761
  */
@@ -16320,6 +16786,8 @@ export declare class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
16320
16786
  securityGroupId?: string;
16321
16787
  /**
16322
16788
  * @remarks
16789
+ * The Service CIDR block.
16790
+ *
16323
16791
  * This parameter is required.
16324
16792
  *
16325
16793
  * @example
@@ -16328,7 +16796,7 @@ export declare class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
16328
16796
  serviceCidr?: string;
16329
16797
  /**
16330
16798
  * @remarks
16331
- * The number of nodes in the cluster, including master nodes and worker nodes.
16799
+ * The number of nodes in the cluster, including control planes and worker nodes.
16332
16800
  *
16333
16801
  * @example
16334
16802
  * 5
@@ -16363,7 +16831,7 @@ export declare class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
16363
16831
  *
16364
16832
  * The pod CIDR block cannot overlap with the CIDR block of the VPC in which the cluster is deployed and the CIDR blocks of existing clusters in the VPC. You cannot modify the pod CIDR block after you create the cluster.
16365
16833
  *
16366
- * For more information about the network planning of ACK clusters, see [Plan CIDR blocks for an ACK cluster](https://help.aliyun.com/document_detail/86500.html).
16834
+ * For more information about the network planning of Container Service for Kubernetes (ACK) clusters, see [Plan CIDR blocks for an ACK cluster](https://help.aliyun.com/document_detail/86500.html).
16367
16835
  *
16368
16836
  * @example
16369
16837
  * 172.21.0.0/16
@@ -16377,6 +16845,9 @@ export declare class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
16377
16845
  */
16378
16846
  tags?: Tag[];
16379
16847
  /**
16848
+ * @remarks
16849
+ * The time zone.
16850
+ *
16380
16851
  * @example
16381
16852
  * Asia/Shanghai
16382
16853
  */
@@ -16399,7 +16870,7 @@ export declare class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
16399
16870
  vpcId?: string;
16400
16871
  /**
16401
16872
  * @remarks
16402
- * The IDs of the vSwitches. You can select one to three vSwitches when you create a cluster. We recommend that you select vSwitches in different zones to ensure high availability.
16873
+ * The IDs of the vSwitches. You can select one to three vSwitches when you create a cluster. To ensure the high availability of the cluster, we recommend that you select vSwitches in different zones.
16403
16874
  *
16404
16875
  * @example
16405
16876
  * vsw-2vc41xuumx5z2rdma****,vsw-2vc41xuumx5z2rdma****
@@ -16407,6 +16878,10 @@ export declare class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
16407
16878
  * @deprecated
16408
16879
  */
16409
16880
  vswitchId?: string;
16881
+ /**
16882
+ * @remarks
16883
+ * The vSwitches of the control planes.
16884
+ */
16410
16885
  vswitchIds?: string[];
16411
16886
  /**
16412
16887
  * @remarks
@@ -16677,7 +17152,11 @@ export declare class DescribeEdgeMachinesResponseBodyPageInfo extends $tea.Model
16677
17152
  export declare class DescribeEventsResponseBodyEventsData extends $tea.Model {
16678
17153
  /**
16679
17154
  * @remarks
16680
- * The severity level of the event.
17155
+ * The severity level of the event. Valid values:
17156
+ *
17157
+ * * info
17158
+ * * warning
17159
+ * * error
16681
17160
  *
16682
17161
  * @example
16683
17162
  * info
@@ -16822,6 +17301,96 @@ export declare class DescribeEventsResponseBodyPageInfo extends $tea.Model {
16822
17301
  [key: string]: any;
16823
17302
  });
16824
17303
  }
17304
+ export declare class DescribeEventsForRegionResponseBodyEventsData extends $tea.Model {
17305
+ /**
17306
+ * @example
17307
+ * info
17308
+ */
17309
+ level?: string;
17310
+ /**
17311
+ * @example
17312
+ * Start to upgrade NodePool nodePool/nodePool-A
17313
+ */
17314
+ message?: string;
17315
+ /**
17316
+ * @example
17317
+ * Started
17318
+ */
17319
+ reason?: string;
17320
+ static names(): {
17321
+ [key: string]: string;
17322
+ };
17323
+ static types(): {
17324
+ [key: string]: any;
17325
+ };
17326
+ constructor(map?: {
17327
+ [key: string]: any;
17328
+ });
17329
+ }
17330
+ export declare class DescribeEventsForRegionResponseBodyEvents extends $tea.Model {
17331
+ /**
17332
+ * @example
17333
+ * cluster-id
17334
+ */
17335
+ clusterId?: string;
17336
+ data?: DescribeEventsForRegionResponseBodyEventsData;
17337
+ /**
17338
+ * @example
17339
+ * A234-1234-1234
17340
+ */
17341
+ eventId?: string;
17342
+ source?: string;
17343
+ /**
17344
+ * @example
17345
+ * nodePool-id
17346
+ */
17347
+ subject?: string;
17348
+ /**
17349
+ * @example
17350
+ * 2020-12-01T17:31:00Z
17351
+ */
17352
+ time?: string;
17353
+ /**
17354
+ * @example
17355
+ * nodePool_upgrade
17356
+ */
17357
+ type?: string;
17358
+ static names(): {
17359
+ [key: string]: string;
17360
+ };
17361
+ static types(): {
17362
+ [key: string]: any;
17363
+ };
17364
+ constructor(map?: {
17365
+ [key: string]: any;
17366
+ });
17367
+ }
17368
+ export declare class DescribeEventsForRegionResponseBodyPageInfo extends $tea.Model {
17369
+ /**
17370
+ * @example
17371
+ * 1
17372
+ */
17373
+ pageNumber?: number;
17374
+ /**
17375
+ * @example
17376
+ * 50
17377
+ */
17378
+ pageSize?: number;
17379
+ /**
17380
+ * @example
17381
+ * 3
17382
+ */
17383
+ totalCount?: number;
17384
+ static names(): {
17385
+ [key: string]: string;
17386
+ };
17387
+ static types(): {
17388
+ [key: string]: any;
17389
+ };
17390
+ constructor(map?: {
17391
+ [key: string]: any;
17392
+ });
17393
+ }
16825
17394
  export declare class DescribeKubernetesVersionMetadataResponseBodyImages extends $tea.Model {
16826
17395
  /**
16827
17396
  * @remarks
@@ -17031,6 +17600,9 @@ export declare class DescribeNodePoolVulsResponseBodyVulRecordsVulList extends $
17031
17600
  /**
17032
17601
  * @remarks
17033
17602
  * Indicates whether a restart is required.
17603
+ *
17604
+ * @example
17605
+ * false
17034
17606
  */
17035
17607
  needReboot?: boolean;
17036
17608
  static names(): {
@@ -19114,9 +19686,9 @@ export declare class ListUserKubeConfigStatesResponseBodyStates extends $tea.Mod
19114
19686
  clusterId?: string;
19115
19687
  /**
19116
19688
  * @remarks
19117
- * The cluster name.
19689
+ * The name of the cluster.
19118
19690
  *
19119
- * The name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). The name cannot start with a hyphen (-).
19691
+ * The name must be 1 to 63 characters in length, and can contain digits, underscores (_), and hyphens (-). The name must start with a letter or number.
19120
19692
  *
19121
19693
  * @example
19122
19694
  * cluster-demo
@@ -19132,8 +19704,6 @@ export declare class ListUserKubeConfigStatesResponseBodyStates extends $tea.Mod
19132
19704
  * * `updating`: The cluster is being upgraded.
19133
19705
  * * `updating_failed`: The cluster failed to be updated.
19134
19706
  * * `scaling`: The cluster is being scaled.
19135
- * * `waiting`: The cluster is waiting for connection requests.
19136
- * * `disconnected`: The cluster is disconnected.
19137
19707
  * * `stopped`: The cluster is stopped.
19138
19708
  * * `deleting`: The cluster is being deleted.
19139
19709
  * * `deleted`: The cluster is deleted.
@@ -19336,7 +19906,7 @@ export declare class ModifyClusterNodePoolRequestAutoScaling extends $tea.Model
19336
19906
  * Specifies whether to enable auto scaling. Valid values:
19337
19907
  *
19338
19908
  * * `true`: enables auto scaling for the node pool.
19339
- * * `false`: disables auto scaling for the node pool. If you set this parameter to false, other parameters in the `auto_scaling` section do not take effect.
19909
+ * * `false`: disables auto scaling for the node pool. If you set this parameter to false, other parameters in `auto_scaling` do not take effect.
19340
19910
  *
19341
19911
  * Default value: `false`.
19342
19912
  *
@@ -19377,7 +19947,7 @@ export declare class ModifyClusterNodePoolRequestAutoScaling extends $tea.Model
19377
19947
  minInstances?: number;
19378
19948
  /**
19379
19949
  * @remarks
19380
- * The instance types that can be used for the auto scaling of the node pool. Valid values:
19950
+ * The instance type that is used for auto scaling. Valid values:
19381
19951
  *
19382
19952
  * * `cpu`: regular instance.
19383
19953
  * * `gpu`: GPU-accelerated instance.
@@ -19418,7 +19988,7 @@ export declare class ModifyClusterNodePoolRequestKubernetesConfig extends $tea.M
19418
19988
  cmsEnabled?: boolean;
19419
19989
  /**
19420
19990
  * @remarks
19421
- * 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:
19991
+ * The CPU management policy of nodes. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
19422
19992
  *
19423
19993
  * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
19424
19994
  * * `none`: specifies that the default CPU affinity is used.
@@ -19437,6 +20007,13 @@ export declare class ModifyClusterNodePoolRequestKubernetesConfig extends $tea.M
19437
20007
  * * 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).
19438
20008
  */
19439
20009
  labels?: Tag[];
20010
+ /**
20011
+ * @remarks
20012
+ * The user-defined script that is executed before nodes are initialized. For more information, see [Prepare user data](https://help.aliyun.com/document_detail/49121.html).
20013
+ *
20014
+ * @example
20015
+ * IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi
20016
+ */
19440
20017
  preUserData?: string;
19441
20018
  /**
19442
20019
  * @remarks
@@ -19469,7 +20046,7 @@ export declare class ModifyClusterNodePoolRequestKubernetesConfig extends $tea.M
19469
20046
  unschedulable?: boolean;
19470
20047
  /**
19471
20048
  * @remarks
19472
- * The user data of the node pool. For more information, see [Prepare user data](https://help.aliyun.com/document_detail/49121.html).
20049
+ * The user-defined script that is executed after nodes are initialized. For more information, see [Prepare user data](https://help.aliyun.com/document_detail/49121.html).
19473
20050
  *
19474
20051
  * @example
19475
20052
  * IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi
@@ -19601,7 +20178,7 @@ export declare class ModifyClusterNodePoolRequestManagementUpgradeConfig extends
19601
20178
  *
19602
20179
  * Valid values: 1 to 1000.
19603
20180
  *
19604
- * Default value: 1
20181
+ * Default value: 1.
19605
20182
  *
19606
20183
  * @example
19607
20184
  * 1
@@ -19656,7 +20233,7 @@ export declare class ModifyClusterNodePoolRequestManagement extends $tea.Model {
19656
20233
  autoRepairPolicy?: ModifyClusterNodePoolRequestManagementAutoRepairPolicy;
19657
20234
  /**
19658
20235
  * @remarks
19659
- * Specifies whether to enable auto update. Valid values:
20236
+ * Indicates whether auto update is enabled. Valid values:
19660
20237
  *
19661
20238
  * * `true`: enables auto update.
19662
20239
  * * `false`: disables auto update.
@@ -19779,7 +20356,7 @@ export declare class ModifyClusterNodePoolRequestScalingGroupPrivatePoolOptions
19779
20356
  export declare class ModifyClusterNodePoolRequestScalingGroupSpotPriceLimit extends $tea.Model {
19780
20357
  /**
19781
20358
  * @remarks
19782
- * The instance type of preemptible instances.
20359
+ * The price cap of a preemptible instance.
19783
20360
  *
19784
20361
  * @example
19785
20362
  * ecs.c6.large
@@ -19833,7 +20410,7 @@ export declare class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model
19833
20410
  * @remarks
19834
20411
  * 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:
19835
20412
  *
19836
- * * `true`: automatically creates pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created
20413
+ * * `true`: automatically creates pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created.
19837
20414
  * * `false`: does not create pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created.
19838
20415
  *
19839
20416
  * @example
@@ -19904,10 +20481,10 @@ export declare class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model
19904
20481
  instanceTypes?: string[];
19905
20482
  /**
19906
20483
  * @remarks
19907
- * The billing method of the public IP address. Valid values:
20484
+ * The metering method of the public IP address. Valid values:
19908
20485
  *
19909
20486
  * * `PayByBandwidth`: pay-by-bandwidth.
19910
- * * `PayByTraffic`: pay-by-data-transfer.
20487
+ * * `PayByTraffic`: pay-by-data-transfer
19911
20488
  *
19912
20489
  * @example
19913
20490
  * PayByBandwidth
@@ -19923,7 +20500,7 @@ export declare class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model
19923
20500
  internetMaxBandwidthOut?: number;
19924
20501
  /**
19925
20502
  * @remarks
19926
- * The name of the key pair. You must specify this parameter or the `login_password` parameter. You must specify the `key_pair` parameter if the node pool is a managed node pool.
20503
+ * The name of the key pair. You must specify this parameter or `login_password`. You must specify the `key_pair` parameter if the node pool is a managed node pool.
19927
20504
  *
19928
20505
  * @example
19929
20506
  * pro-nodepool
@@ -19931,7 +20508,7 @@ export declare class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model
19931
20508
  keyPair?: string;
19932
20509
  /**
19933
20510
  * @remarks
19934
- * 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.
20511
+ * The password for SSH logon. You must specify 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.
19935
20512
  *
19936
20513
  * @example
19937
20514
  * Hello1234
@@ -20012,12 +20589,12 @@ export declare class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model
20012
20589
  platform?: string;
20013
20590
  /**
20014
20591
  * @remarks
20015
- * The configurations of the private node pool.
20592
+ * The configuration of the private node pool.
20016
20593
  */
20017
20594
  privatePoolOptions?: ModifyClusterNodePoolRequestScalingGroupPrivatePoolOptions;
20018
20595
  /**
20019
20596
  * @remarks
20020
- * A list of ApsaraDB RDS instances.
20597
+ * The ApsaraDB RDS instances.
20021
20598
  */
20022
20599
  rdsInstances?: string[];
20023
20600
  /**
@@ -20084,10 +20661,10 @@ export declare class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model
20084
20661
  systemDiskCategories?: string[];
20085
20662
  /**
20086
20663
  * @remarks
20087
- * The type of the system disk. Valid values:
20664
+ * The type of system disk. Valid values:
20088
20665
  *
20089
20666
  * * `cloud_efficiency`: ultra disk.
20090
- * * `cloud_ssd`: standard SSD.
20667
+ * * `cloud_ssd`: standard SSD
20091
20668
  *
20092
20669
  * Default value: `cloud_ssd`.
20093
20670
  *
@@ -20097,7 +20674,7 @@ export declare class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model
20097
20674
  systemDiskCategory?: string;
20098
20675
  /**
20099
20676
  * @remarks
20100
- * The encryption algorithm that is used by the system disk. Set the value to aes-256.
20677
+ * The encryption algorithm that is used by the system disk. The value is aes-256.
20101
20678
  *
20102
20679
  * @example
20103
20680
  * aes-256
@@ -20105,7 +20682,7 @@ export declare class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model
20105
20682
  systemDiskEncryptAlgorithm?: string;
20106
20683
  /**
20107
20684
  * @remarks
20108
- * Specifies whether to encrypt the system disk. Valid values: true: encrypts the system disk. false: does not encrypt the system disk.
20685
+ * Indicates whether the system disk is encrypted. Valid values: true: encrypts the system disk. false: does not encrypt the system disk.
20109
20686
  *
20110
20687
  * @example
20111
20688
  * false
@@ -20151,7 +20728,7 @@ export declare class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model
20151
20728
  systemDiskSize?: number;
20152
20729
  /**
20153
20730
  * @remarks
20154
- * The labels that you want to add only to ECS instances.
20731
+ * The tags that you want to add only to ECS instances.
20155
20732
  *
20156
20733
  * 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://.
20157
20734
  */
@@ -20198,6 +20775,10 @@ export declare class ModifyClusterNodePoolRequestTeeConfig extends $tea.Model {
20198
20775
  });
20199
20776
  }
20200
20777
  export declare class ModifyNodePoolNodeConfigRequestOsConfig extends $tea.Model {
20778
+ /**
20779
+ * @remarks
20780
+ * sysctl parameter configuration
20781
+ */
20201
20782
  sysctl?: {
20202
20783
  [key: string]: any;
20203
20784
  };
@@ -20296,7 +20877,7 @@ export declare class ScaleOutClusterRequestWorkerDataDisks extends $tea.Model {
20296
20877
  autoSnapshotPolicyId?: string;
20297
20878
  /**
20298
20879
  * @remarks
20299
- * The data disk type.
20880
+ * The type of the data disk.
20300
20881
  *
20301
20882
  * @example
20302
20883
  * cloud_essd
@@ -20304,7 +20885,7 @@ export declare class ScaleOutClusterRequestWorkerDataDisks extends $tea.Model {
20304
20885
  category?: string;
20305
20886
  /**
20306
20887
  * @remarks
20307
- * Specifies whether to encrypt the data disk. Valid values:
20888
+ * Specifies whether to encrypt the data disks. Valid values:
20308
20889
  *
20309
20890
  * * `true`: encrypts the data disk.
20310
20891
  * * `false`: does not encrypt the data disk.
@@ -20317,7 +20898,7 @@ export declare class ScaleOutClusterRequestWorkerDataDisks extends $tea.Model {
20317
20898
  encrypted?: string;
20318
20899
  /**
20319
20900
  * @remarks
20320
- * The data disk size. Valid values: 40 to 32767.
20901
+ * The size of the data disk. Valid values: 40 to 32767.
20321
20902
  *
20322
20903
  * @example
20323
20904
  * 120
@@ -20519,7 +21100,7 @@ export declare class UpgradeClusterNodepoolRequestRollingPolicy extends $tea.Mod
20519
21100
  batchInterval?: number;
20520
21101
  /**
20521
21102
  * @remarks
20522
- * The maximum number of unavailable nodes.
21103
+ * The maximum number of nodes per batch.
20523
21104
  *
20524
21105
  * @example
20525
21106
  * 3
@@ -20723,9 +21304,9 @@ export default class Client extends OpenApi {
20723
21304
  * You can call the CleanUserPermissions operation to delete the kubeconfig files of the specified users and revoke the relevant Role-Based Access Control (RBAC) permissions. This API operation is suitable for scenarios where employees have resigned or the accounts of employees are locked.
20724
21305
  *
20725
21306
  * @remarks
20726
- * >- To call this operation, make sure that you have the AliyunCSFullAccess permissions.
20727
- * >- You cannot revoke the permissions of an Alibaba Cloud account.
20728
- * >- You cannot revoke the permissions of the account that you use to call this operation.
21307
+ * > - To call this operation, make sure that you have the AliyunCSFullAccess permission.
21308
+ * > - You cannot revoke the permissions of an Alibaba Cloud account.
21309
+ * > - You cannot revoke the permissions of the account that you use to call this operation.
20729
21310
  *
20730
21311
  * @param tmpReq - CleanUserPermissionsRequest
20731
21312
  * @param headers - map
@@ -20739,9 +21320,9 @@ export default class Client extends OpenApi {
20739
21320
  * You can call the CleanUserPermissions operation to delete the kubeconfig files of the specified users and revoke the relevant Role-Based Access Control (RBAC) permissions. This API operation is suitable for scenarios where employees have resigned or the accounts of employees are locked.
20740
21321
  *
20741
21322
  * @remarks
20742
- * >- To call this operation, make sure that you have the AliyunCSFullAccess permissions.
20743
- * >- You cannot revoke the permissions of an Alibaba Cloud account.
20744
- * >- You cannot revoke the permissions of the account that you use to call this operation.
21323
+ * > - To call this operation, make sure that you have the AliyunCSFullAccess permission.
21324
+ * > - You cannot revoke the permissions of an Alibaba Cloud account.
21325
+ * > - You cannot revoke the permissions of the account that you use to call this operation.
20745
21326
  *
20746
21327
  * @param request - CleanUserPermissionsRequest
20747
21328
  * @returns CleanUserPermissionsResponse
@@ -20820,7 +21401,7 @@ export default class Client extends OpenApi {
20820
21401
  */
20821
21402
  createClusterDiagnosis(clusterId: string, request: CreateClusterDiagnosisRequest): Promise<CreateClusterDiagnosisResponse>;
20822
21403
  /**
20823
- * Creates a node pool for a Container Service for Kubernetes (ACK) cluster. You can use node pools to facilitate node management. For example, you can schedule, configure, or maintain nodes by node pool, and enable auto scaling for a node pool. We recommend that you use a managed node pool, which can help automate specific O\\&M tasks for nodes, such as Common Vulnerabilities and Exposures (CVE) patching and node repair. This reduces your O\\&M workload.
21404
+ * Creates a node pool for a Container Service for Kubernetes (ACK) cluster. You can use node pools to facilitate node management. For example, you can schedule, configure, or maintain nodes by node pool, and enable auto scaling for a node pool. We recommend that you use a managed node pool, which can help automate specific O\\\\\\&M tasks for nodes, such as Common Vulnerabilities and Exposures (CVE) patching and node repair. This reduces your O\\\\\\&M workload.
20824
21405
  *
20825
21406
  * @param request - CreateClusterNodePoolRequest
20826
21407
  * @param headers - map
@@ -20831,7 +21412,7 @@ export default class Client extends OpenApi {
20831
21412
  [key: string]: string;
20832
21413
  }, runtime: $Util.RuntimeOptions): Promise<CreateClusterNodePoolResponse>;
20833
21414
  /**
20834
- * Creates a node pool for a Container Service for Kubernetes (ACK) cluster. You can use node pools to facilitate node management. For example, you can schedule, configure, or maintain nodes by node pool, and enable auto scaling for a node pool. We recommend that you use a managed node pool, which can help automate specific O\\&M tasks for nodes, such as Common Vulnerabilities and Exposures (CVE) patching and node repair. This reduces your O\\&M workload.
21415
+ * Creates a node pool for a Container Service for Kubernetes (ACK) cluster. You can use node pools to facilitate node management. For example, you can schedule, configure, or maintain nodes by node pool, and enable auto scaling for a node pool. We recommend that you use a managed node pool, which can help automate specific O\\\\\\&M tasks for nodes, such as Common Vulnerabilities and Exposures (CVE) patching and node repair. This reduces your O\\\\\\&M workload.
20835
21416
  *
20836
21417
  * @param request - CreateClusterNodePoolRequest
20837
21418
  * @returns CreateClusterNodePoolResponse
@@ -21333,7 +21914,7 @@ export default class Client extends OpenApi {
21333
21914
  */
21334
21915
  describeClusterNodePoolDetail(ClusterId: string, NodepoolId: string): Promise<DescribeClusterNodePoolDetailResponse>;
21335
21916
  /**
21336
- * Queries node pools in a Container Service for Kubernetes (ACK) cluster.
21917
+ * Queries the information about all node pools in a cluster.
21337
21918
  *
21338
21919
  * @param request - DescribeClusterNodePoolsRequest
21339
21920
  * @param headers - map
@@ -21344,14 +21925,14 @@ export default class Client extends OpenApi {
21344
21925
  [key: string]: string;
21345
21926
  }, runtime: $Util.RuntimeOptions): Promise<DescribeClusterNodePoolsResponse>;
21346
21927
  /**
21347
- * Queries node pools in a Container Service for Kubernetes (ACK) cluster.
21928
+ * Queries the information about all node pools in a cluster.
21348
21929
  *
21349
21930
  * @param request - DescribeClusterNodePoolsRequest
21350
21931
  * @returns DescribeClusterNodePoolsResponse
21351
21932
  */
21352
21933
  describeClusterNodePools(ClusterId: string, request: DescribeClusterNodePoolsRequest): Promise<DescribeClusterNodePoolsResponse>;
21353
21934
  /**
21354
- * You can call the DescribeClusterNodes operation to query the details about all nodes in a cluster by cluster ID.
21935
+ * null
21355
21936
  *
21356
21937
  * @param request - DescribeClusterNodesRequest
21357
21938
  * @param headers - map
@@ -21362,7 +21943,7 @@ export default class Client extends OpenApi {
21362
21943
  [key: string]: string;
21363
21944
  }, runtime: $Util.RuntimeOptions): Promise<DescribeClusterNodesResponse>;
21364
21945
  /**
21365
- * You can call the DescribeClusterNodes operation to query the details about all nodes in a cluster by cluster ID.
21946
+ * null
21366
21947
  *
21367
21948
  * @param request - DescribeClusterNodesRequest
21368
21949
  * @returns DescribeClusterNodesResponse
@@ -21487,6 +22068,24 @@ export default class Client extends OpenApi {
21487
22068
  * @returns DescribeClustersResponse
21488
22069
  */
21489
22070
  describeClusters(request: DescribeClustersRequest): Promise<DescribeClustersResponse>;
22071
+ /**
22072
+ * 查询指定地域内全部集群列表
22073
+ *
22074
+ * @param request - DescribeClustersForRegionRequest
22075
+ * @param headers - map
22076
+ * @param runtime - runtime options for this request RuntimeOptions
22077
+ * @returns DescribeClustersForRegionResponse
22078
+ */
22079
+ describeClustersForRegionWithOptions(regionId: string, request: DescribeClustersForRegionRequest, headers: {
22080
+ [key: string]: string;
22081
+ }, runtime: $Util.RuntimeOptions): Promise<DescribeClustersForRegionResponse>;
22082
+ /**
22083
+ * 查询指定地域内全部集群列表
22084
+ *
22085
+ * @param request - DescribeClustersForRegionRequest
22086
+ * @returns DescribeClustersForRegionResponse
22087
+ */
22088
+ describeClustersForRegion(regionId: string, request: DescribeClustersForRegionRequest): Promise<DescribeClustersForRegionResponse>;
21490
22089
  /**
21491
22090
  * Queries the details about Container Service for Kubernetes (ACK) clusters of specified types or specifications within an account.
21492
22091
  *
@@ -21569,7 +22168,7 @@ export default class Client extends OpenApi {
21569
22168
  */
21570
22169
  describeEdgeMachines(request: DescribeEdgeMachinesRequest): Promise<DescribeEdgeMachinesResponse>;
21571
22170
  /**
21572
- * Queries detailed information about a type of events, including the severity level, status, and start time of each event. Events are generated when clusters are created, modified, and updated, node pools are created and scaled out, and components are installed.
22171
+ * Queries the detailed information about a type of events, including the severity level, status, and time. Events are generated when clusters are created, modified, and updated, node pools are created and scaled out, and components are installed.
21573
22172
  *
21574
22173
  * @param request - DescribeEventsRequest
21575
22174
  * @param headers - map
@@ -21580,12 +22179,30 @@ export default class Client extends OpenApi {
21580
22179
  [key: string]: string;
21581
22180
  }, runtime: $Util.RuntimeOptions): Promise<DescribeEventsResponse>;
21582
22181
  /**
21583
- * Queries detailed information about a type of events, including the severity level, status, and start time of each event. Events are generated when clusters are created, modified, and updated, node pools are created and scaled out, and components are installed.
22182
+ * Queries the detailed information about a type of events, including the severity level, status, and time. Events are generated when clusters are created, modified, and updated, node pools are created and scaled out, and components are installed.
21584
22183
  *
21585
22184
  * @param request - DescribeEventsRequest
21586
22185
  * @returns DescribeEventsResponse
21587
22186
  */
21588
22187
  describeEvents(request: DescribeEventsRequest): Promise<DescribeEventsResponse>;
22188
+ /**
22189
+ * 查询指定地域内全部事件列表
22190
+ *
22191
+ * @param request - DescribeEventsForRegionRequest
22192
+ * @param headers - map
22193
+ * @param runtime - runtime options for this request RuntimeOptions
22194
+ * @returns DescribeEventsForRegionResponse
22195
+ */
22196
+ describeEventsForRegionWithOptions(regionId: string, request: DescribeEventsForRegionRequest, headers: {
22197
+ [key: string]: string;
22198
+ }, runtime: $Util.RuntimeOptions): Promise<DescribeEventsForRegionResponse>;
22199
+ /**
22200
+ * 查询指定地域内全部事件列表
22201
+ *
22202
+ * @param request - DescribeEventsForRegionRequest
22203
+ * @returns DescribeEventsForRegionResponse
22204
+ */
22205
+ describeEventsForRegion(regionId: string, request: DescribeEventsForRegionRequest): Promise<DescribeEventsForRegionResponse>;
21589
22206
  /**
21590
22207
  * Queries the proxy configurations of a registered cluster based on the cluster ID.
21591
22208
  *
@@ -21647,7 +22264,7 @@ export default class Client extends OpenApi {
21647
22264
  */
21648
22265
  describeNodePoolVuls(clusterId: string, nodepoolId: string, request: DescribeNodePoolVulsRequest): Promise<DescribeNodePoolVulsResponse>;
21649
22266
  /**
21650
- * Queries the policies for a Container Service for Kubernetes (ACK) cluster. Container security policies for ACK clusters offer a variety of built-in policies, including cis-k8s, infra, k8s-general, and PodSecurityPolicy. You can use these policies to ensure the security of containers running in a production environment.
22267
+ * Queries a list of security policies. Container Service for Kubernetes (ACK) clusters offer a variety of built-in container security policies, such as Compliance, Infra, K8s-general, and pod security policy (PSP). You can use these policies to ensure the security of containers running in a production environment.
21651
22268
  *
21652
22269
  * @param headers - map
21653
22270
  * @param runtime - runtime options for this request RuntimeOptions
@@ -21657,7 +22274,7 @@ export default class Client extends OpenApi {
21657
22274
  [key: string]: string;
21658
22275
  }, runtime: $Util.RuntimeOptions): Promise<DescribePoliciesResponse>;
21659
22276
  /**
21660
- * Queries the policies for a Container Service for Kubernetes (ACK) cluster. Container security policies for ACK clusters offer a variety of built-in policies, including cis-k8s, infra, k8s-general, and PodSecurityPolicy. You can use these policies to ensure the security of containers running in a production environment.
22277
+ * Queries a list of security policies. Container Service for Kubernetes (ACK) clusters offer a variety of built-in container security policies, such as Compliance, Infra, K8s-general, and pod security policy (PSP). You can use these policies to ensure the security of containers running in a production environment.
21661
22278
  * @returns DescribePoliciesResponse
21662
22279
  */
21663
22280
  describePolicies(): Promise<DescribePoliciesResponse>;
@@ -21954,6 +22571,8 @@ export default class Client extends OpenApi {
21954
22571
  */
21955
22572
  getClusterAddonInstance(clusterId: string, instanceName: string): Promise<GetClusterAddonInstanceResponse>;
21956
22573
  /**
22574
+ * 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.
22575
+ *
21957
22576
  * @param headers - map
21958
22577
  * @param runtime - runtime options for this request RuntimeOptions
21959
22578
  * @returns GetClusterAuditProjectResponse
@@ -21962,6 +22581,7 @@ export default class Client extends OpenApi {
21962
22581
  [key: string]: string;
21963
22582
  }, runtime: $Util.RuntimeOptions): Promise<GetClusterAuditProjectResponse>;
21964
22583
  /**
22584
+ * 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.
21965
22585
  * @returns GetClusterAuditProjectResponse
21966
22586
  */
21967
22587
  getClusterAuditProject(clusterid: string): Promise<GetClusterAuditProjectResponse>;
@@ -22052,8 +22672,7 @@ export default class Client extends OpenApi {
22052
22672
  *
22053
22673
  * @remarks
22054
22674
  * *Precautions**:
22055
- * * Make sure that you have attached a RAM policy that has at least the read-only permissions on the cluster to the RAM user or RAM role in the RAM console. Otherwise, the `ErrorRamPolicyConfig` error code is returned when you call the operation. For more information about how to authorize a RAM user by attaching RAM policies, see [Create a custom RAM policy](https://help.aliyun.com/document_detail/86485.html).
22056
- * * If you use a RAM user to call the operation, make sure that the RAM user has the permissions to modify the permissions of other RAM users or RAM roles. Otherwise, the `StatusForbidden` or `ForbiddenGrantPermissions` error code is returned when you call the operation. For more information, see [Use a RAM user to grant RBAC permissions to other RAM users](https://help.aliyun.com/document_detail/119035.html).
22675
+ * * If you use a Resource Access Management (RAM) user to call the operation, make sure that the RAM user has the permissions to modify the permissions of other RAM users or RAM roles. Otherwise, the `StatusForbidden` or `ForbiddenGrantPermissions` error code is returned after you call the operation. For more information, see [Use a RAM user to grant RBAC permissions to other RAM users](https://help.aliyun.com/document_detail/119035.html).
22057
22676
  * * If you update full permissions, 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.
22058
22677
  *
22059
22678
  * @param request - GrantPermissionsRequest
@@ -22069,8 +22688,7 @@ export default class Client extends OpenApi {
22069
22688
  *
22070
22689
  * @remarks
22071
22690
  * *Precautions**:
22072
- * * Make sure that you have attached a RAM policy that has at least the read-only permissions on the cluster to the RAM user or RAM role in the RAM console. Otherwise, the `ErrorRamPolicyConfig` error code is returned when you call the operation. For more information about how to authorize a RAM user by attaching RAM policies, see [Create a custom RAM policy](https://help.aliyun.com/document_detail/86485.html).
22073
- * * If you use a RAM user to call the operation, make sure that the RAM user has the permissions to modify the permissions of other RAM users or RAM roles. Otherwise, the `StatusForbidden` or `ForbiddenGrantPermissions` error code is returned when you call the operation. For more information, see [Use a RAM user to grant RBAC permissions to other RAM users](https://help.aliyun.com/document_detail/119035.html).
22691
+ * * If you use a Resource Access Management (RAM) user to call the operation, make sure that the RAM user has the permissions to modify the permissions of other RAM users or RAM roles. Otherwise, the `StatusForbidden` or `ForbiddenGrantPermissions` error code is returned after you call the operation. For more information, see [Use a RAM user to grant RBAC permissions to other RAM users](https://help.aliyun.com/document_detail/119035.html).
22074
22692
  * * If you update full permissions, 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.
22075
22693
  *
22076
22694
  * @param request - GrantPermissionsRequest
@@ -22538,7 +23156,7 @@ export default class Client extends OpenApi {
22538
23156
  */
22539
23157
  removeNodePoolNodes(ClusterId: string, NodepoolId: string, request: RemoveNodePoolNodesRequest): Promise<RemoveNodePoolNodesResponse>;
22540
23158
  /**
22541
- * Fixes issues on abnormal nodes in a node pool to ensure that the nodes can run as normal.
23159
+ * Repairs a node pool.
22542
23160
  *
22543
23161
  * @param request - RepairClusterNodePoolRequest
22544
23162
  * @param headers - map
@@ -22549,7 +23167,7 @@ export default class Client extends OpenApi {
22549
23167
  [key: string]: string;
22550
23168
  }, runtime: $Util.RuntimeOptions): Promise<RepairClusterNodePoolResponse>;
22551
23169
  /**
22552
- * Fixes issues on abnormal nodes in a node pool to ensure that the nodes can run as normal.
23170
+ * Repairs a node pool.
22553
23171
  *
22554
23172
  * @param request - RepairClusterNodePoolRequest
22555
23173
  * @returns RepairClusterNodePoolResponse
@@ -22575,7 +23193,7 @@ export default class Client extends OpenApi {
22575
23193
  */
22576
23194
  resumeComponentUpgrade(clusterid: string, componentid: string): Promise<ResumeComponentUpgradeResponse>;
22577
23195
  /**
22578
- * You can call the ResumeTask operation to resume a task.
23196
+ * Resumes a task.
22579
23197
  *
22580
23198
  * @param headers - map
22581
23199
  * @param runtime - runtime options for this request RuntimeOptions
@@ -22585,7 +23203,7 @@ export default class Client extends OpenApi {
22585
23203
  [key: string]: string;
22586
23204
  }, runtime: $Util.RuntimeOptions): Promise<ResumeTaskResponse>;
22587
23205
  /**
22588
- * You can call the ResumeTask operation to resume a task.
23206
+ * Resumes a task.
22589
23207
  * @returns ResumeTaskResponse
22590
23208
  */
22591
23209
  resumeTask(taskId: string): Promise<ResumeTaskResponse>;
@@ -22664,7 +23282,7 @@ export default class Client extends OpenApi {
22664
23282
  */
22665
23283
  scaleCluster(ClusterId: string, request: ScaleClusterRequest): Promise<ScaleClusterResponse>;
22666
23284
  /**
22667
- * You can call the ScaleClusterNodePool operation to scale out a node pool by node pool ID.
23285
+ * Scales out a node pool.
22668
23286
  *
22669
23287
  * @param request - ScaleClusterNodePoolRequest
22670
23288
  * @param headers - map
@@ -22675,7 +23293,7 @@ export default class Client extends OpenApi {
22675
23293
  [key: string]: string;
22676
23294
  }, runtime: $Util.RuntimeOptions): Promise<ScaleClusterNodePoolResponse>;
22677
23295
  /**
22678
- * You can call the ScaleClusterNodePool operation to scale out a node pool by node pool ID.
23296
+ * Scales out a node pool.
22679
23297
  *
22680
23298
  * @param request - ScaleClusterNodePoolRequest
22681
23299
  * @returns ScaleClusterNodePoolResponse