@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/src/client.ts CHANGED
@@ -688,14 +688,14 @@ export class QuotasValue extends $tea.Model {
688
688
  export class AttachInstancesRequest extends $tea.Model {
689
689
  /**
690
690
  * @remarks
691
- * The CPU management policy. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later.
691
+ * 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:
692
692
  *
693
- * * `static`: This policy allows pods with specific resource characteristics on the node to be configured with enhanced CPU affinity and exclusivity.
694
- * * `none`: The default CPU affinity is used.
693
+ * * `static`: allows pods with specific resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.
694
+ * * `none`: specifies that the default CPU affinity is used.
695
695
  *
696
696
  * Default value: `none`.
697
697
  *
698
- * > This parameter is not supported if you specify the `nodepool_id` parameter.
698
+ * > This parameter is not supported if you specify `nodepool_id`.
699
699
  *
700
700
  * @example
701
701
  * none
@@ -710,12 +710,12 @@ export class AttachInstancesRequest extends $tea.Model {
710
710
  *
711
711
  * Default value: `false`.
712
712
  *
713
- * How a data disk is mounted:
713
+ * How data disks are attached:
714
714
  *
715
- * * 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.
716
- * * If no data disk is attached to the ECS instances, the system does not purchase a new data disk.
715
+ * * 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.
716
+ * * If no data disk is attached to the ECS instance, the system does not purchase a new data disk.
717
717
  *
718
- * > 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.
718
+ * > 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.
719
719
  *
720
720
  * @example
721
721
  * false
@@ -723,13 +723,13 @@ export class AttachInstancesRequest extends $tea.Model {
723
723
  formatDisk?: boolean;
724
724
  /**
725
725
  * @remarks
726
- * The ID of the custom image. If you do not set this parameter, the default system image is used.
726
+ * The custom image ID. If you do not specify this parameter, the default system image is used.
727
727
  *
728
728
  * >
729
729
  *
730
- * * If you specify a custom image, the custom image is used to deploy the operating systems on the system disks of the nodes.
730
+ * * If you specify a custom image, the custom image is used to deploy the operating system on the system disk of the node.
731
731
  *
732
- * * This parameter is not supported after you specify `nodepool_id`.
732
+ * * This parameter is not supported if you specify `nodepool_id`.
733
733
  *
734
734
  * @example
735
735
  * aliyun_2_1903_x64_20G_alibase_20200529.vhd
@@ -737,21 +737,21 @@ export class AttachInstancesRequest extends $tea.Model {
737
737
  imageId?: string;
738
738
  /**
739
739
  * @remarks
740
- * The ECS instances to be added.
740
+ * The ECS instances that you want to add.
741
741
  *
742
742
  * This parameter is required.
743
743
  */
744
744
  instances?: string[];
745
745
  /**
746
746
  * @remarks
747
- * Specifies whether the nodes that you want to add are Edge Node Service (ENS) nodes. Valid values:
747
+ * Specifies whether the node that you want to add is an Edge Node Service (ENS) node. Valid values:
748
748
  *
749
- * * `true`: The nodes that you want to add are ENS nodes.
750
- * * `false`: The nodes that you want to add are not ENS nodes.
749
+ * * `true`: the node that you want to add is an ENS node.
750
+ * * `false`: the node that you want to add is not an ENS node.
751
751
  *
752
752
  * Default value: `false`.
753
753
  *
754
- * > 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.
754
+ * > 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.
755
755
  *
756
756
  * @example
757
757
  * false
@@ -764,7 +764,7 @@ export class AttachInstancesRequest extends $tea.Model {
764
764
  * * `true`: retains the instance name.
765
765
  * * `false`: does not retain the instance name.
766
766
  *
767
- * Default value: `true`
767
+ * Default value: `false`.
768
768
  *
769
769
  * @example
770
770
  * true
@@ -772,9 +772,9 @@ export class AttachInstancesRequest extends $tea.Model {
772
772
  keepInstanceName?: boolean;
773
773
  /**
774
774
  * @remarks
775
- * The name of the key pair that is used to log on to the ECS instances. You must set key_pair or `login_password`.
775
+ * The name of the key pair used to log on to the ECS instances. You must specify this parameter or `login_password`.
776
776
  *
777
- * > This parameter is not supported if you specify the `nodepool_id` parameter.
777
+ * > This parameter is not supported if you specify `nodepool_id`.
778
778
  *
779
779
  * @example
780
780
  * secrity-key
@@ -782,7 +782,7 @@ export class AttachInstancesRequest extends $tea.Model {
782
782
  keyPair?: string;
783
783
  /**
784
784
  * @remarks
785
- * The node pool ID. If you do not set this parameter, the nodes are added to the default node pool.
785
+ * 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.
786
786
  *
787
787
  * @example
788
788
  * np615c0e0966124216a0412e10afe0****
@@ -790,9 +790,9 @@ export class AttachInstancesRequest extends $tea.Model {
790
790
  nodepoolId?: string;
791
791
  /**
792
792
  * @remarks
793
- * 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 (").
793
+ * 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 (").
794
794
  *
795
- * For security considerations, the password is encrypted during data transfer.
795
+ * The password is encrypted during data transfer to ensure security.
796
796
  *
797
797
  * @example
798
798
  * Hello1234
@@ -807,24 +807,24 @@ export class AttachInstancesRequest extends $tea.Model {
807
807
  * @remarks
808
808
  * The container runtime.
809
809
  *
810
- * > This parameter is not supported if you specify the `nodepool_id` parameter.
810
+ * > This parameter is not supported if you specify `nodepool_id`.
811
811
  */
812
812
  runtime?: Runtime;
813
813
  /**
814
814
  * @remarks
815
- * The labels that you want to add to nodes. You must add labels based on the following rules:
815
+ * The labels that you want to add to the node. When you add labels to a node, the following rules apply:
816
816
  *
817
- * * Each label is a case-sensitive key-value pair. You can add up to 20 labels.
818
- * * 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).
817
+ * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
818
+ * * 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).
819
819
  *
820
- * > This parameter is not supported if you specify the `nodepool_id` parameter.
820
+ * > This parameter is not supported if you specify `nodepool_id`.
821
821
  */
822
822
  tags?: Tag[];
823
823
  /**
824
824
  * @remarks
825
- * User-defined data. For more information, see [Generate user data](https://help.aliyun.com/document_detail/49121.html).
825
+ * The user-defined data on the node. For more information, see [Generate user-defined data](https://help.aliyun.com/document_detail/49121.html).
826
826
  *
827
- * > This parameter is not supported if you specify the `nodepool_id` parameter.
827
+ * > This parameter is not supported if you specify `nodepool_id`.
828
828
  *
829
829
  * @example
830
830
  * IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi
@@ -1388,17 +1388,15 @@ export class CleanClusterUserPermissionsResponse extends $tea.Model {
1388
1388
  export class CleanUserPermissionsRequest extends $tea.Model {
1389
1389
  /**
1390
1390
  * @remarks
1391
- * The cluster IDs.
1392
- *
1393
- * * If cluster IDs are specified, only the kubeconfig files of the specified clusters and the relevant RBAC permissions are deleted and revoked.
1391
+ * 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.
1394
1392
  */
1395
1393
  clusterIds?: string[];
1396
1394
  /**
1397
1395
  * @remarks
1398
1396
  * Specifies whether to forcefully delete the specified kubeconfig files. Valid values:
1399
1397
  *
1400
- * * **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.
1401
- * * **true**: forcefully deletes the kubeconfig files without checking cluster access records.
1398
+ * * 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.
1399
+ * * true: forcefully deletes the kubeconfig files without checking the cluster access records.
1402
1400
  *
1403
1401
  * @example
1404
1402
  * false
@@ -1426,17 +1424,15 @@ export class CleanUserPermissionsRequest extends $tea.Model {
1426
1424
  export class CleanUserPermissionsShrinkRequest extends $tea.Model {
1427
1425
  /**
1428
1426
  * @remarks
1429
- * The cluster IDs.
1430
- *
1431
- * * If cluster IDs are specified, only the kubeconfig files of the specified clusters and the relevant RBAC permissions are deleted and revoked.
1427
+ * 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.
1432
1428
  */
1433
1429
  clusterIdsShrink?: string;
1434
1430
  /**
1435
1431
  * @remarks
1436
1432
  * Specifies whether to forcefully delete the specified kubeconfig files. Valid values:
1437
1433
  *
1438
- * * **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.
1439
- * * **true**: forcefully deletes the kubeconfig files without checking cluster access records.
1434
+ * * 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.
1435
+ * * true: forcefully deletes the kubeconfig files without checking the cluster access records.
1440
1436
  *
1441
1437
  * @example
1442
1438
  * false
@@ -1464,7 +1460,7 @@ export class CleanUserPermissionsShrinkRequest extends $tea.Model {
1464
1460
  export class CleanUserPermissionsResponseBody extends $tea.Model {
1465
1461
  /**
1466
1462
  * @remarks
1467
- * 请求ID
1463
+ * The request ID.
1468
1464
  *
1469
1465
  * @example
1470
1466
  * 687C5BAA-D103-4993-884B-C35E4314****
@@ -1472,7 +1468,7 @@ export class CleanUserPermissionsResponseBody extends $tea.Model {
1472
1468
  requestId?: string;
1473
1469
  /**
1474
1470
  * @remarks
1475
- * 任务ID
1471
+ * The task ID.
1476
1472
  *
1477
1473
  * @example
1478
1474
  * clean-user-permissions-2085266204********-6694c16e6ae07***********
@@ -1729,19 +1725,19 @@ export class CreateAutoscalingConfigResponse extends $tea.Model {
1729
1725
  export class CreateClusterRequest extends $tea.Model {
1730
1726
  /**
1731
1727
  * @remarks
1732
- * The network access control list (ACL) of the SLB instance associated with the API server if the cluster is a registered cluster.
1728
+ * The ACL rule of the SLB instance associated with the API server if the cluster is a registered cluster.
1733
1729
  */
1734
1730
  accessControlList?: string[];
1735
1731
  /**
1736
1732
  * @remarks
1737
- * 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.
1733
+ * The components that you want to install in the cluster. When you create a cluster, you can specify `addons` to install specific components.
1738
1734
  *
1739
1735
  * **Network plug-in**: required. The Flannel and Terway plug-ins are supported. Select one of the plug-ins for the cluster.
1740
1736
  *
1741
- * * If you want to use the Terway component, specify the network plug-in in the [{"name":"flannel","config":""}] format.
1742
- * * If you want to use the Terway component, specify the value network plug-in in the [{"Name": "terway-eniip","Config": ""}] format.
1737
+ * * Specify the Flannel plug-in in the following format: [{"name":"flannel","config":""}].
1738
+ * * If you want to use the Terway component, specify the value in the [{"Name": "terway-eniip","Config": ""}] format.
1743
1739
  *
1744
- * **Volume plug-in**: optional. Only the `Container Storage Interface (CSI)` plug-in is supported.
1740
+ * **Volume plug-in**: optional. Only the `CSI` plug-in is supported.
1745
1741
  *
1746
1742
  * Specify the `CSI` plug-in in the following format: [{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}].
1747
1743
  *
@@ -1750,23 +1746,23 @@ export class CreateClusterRequest extends $tea.Model {
1750
1746
  * * Specify an existing `Simple Log Service project` in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}].
1751
1747
  * * To create a `Simple Log Service project`, specify the component in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true"}"}].
1752
1748
  *
1753
- * **Ingress controller**: optional. By default, the `nginx-ingress-controller` component is installed in ACK dedicated clusters.
1749
+ * **Ingress controller**`: optional. By default, the nginx-ingress-controller component is installed in ACK dedicated clusters.`
1754
1750
  *
1755
1751
  * * To install nginx-ingress-controller and enable Internet access, specify the Ingress controller in the following format: [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}].
1756
- * * To disable the automatic installation of nginx-ingress-controller, specify the Ingress controller in the following format: [{"name": "nginx-ingress-controller","config": "","disabled": true}].
1752
+ * * To disable the automatic installation of nginx-ingress-controller, specify the component in the following format: [{"name": "nginx-ingress-controller","config": "","disabled": true}].
1757
1753
  *
1758
1754
  * **Event center**: optional. By default, the event center feature is enabled.
1759
1755
  *
1760
1756
  * 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).
1761
1757
  *
1762
- * 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"}"}].
1758
+ * Enable the ack-node-problem-detector component in the following format: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}].
1763
1759
  */
1764
1760
  addons?: Addon[];
1765
1761
  /**
1766
1762
  * @remarks
1767
- * 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 (,).``
1763
+ * 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 (,).``
1768
1764
  *
1769
- * For more information about `service accounts`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
1765
+ * For more information about `ServiceAccount`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
1770
1766
  *
1771
1767
  * @example
1772
1768
  * kubernetes.default.svc
@@ -1774,13 +1770,14 @@ export class CreateClusterRequest extends $tea.Model {
1774
1770
  apiAudiences?: string;
1775
1771
  /**
1776
1772
  * @remarks
1777
- * Specifies whether to enable auto-renewal, which takes effect only when the `charge_type` value is set to `PrePaid`.
1773
+ * Specifies whether to enable auto-renewal. This parameter takes effect only when `charge_type` is set to `PrePaid`. Valid values:
1774
+ *
1775
+ * * `true`: enables auto-renewal.
1776
+ * * `false`: disables auto-renewal.
1778
1777
  *
1779
- * Possible values:
1780
- * - `true`: Enable auto-renewal.
1781
- * - `false`: Do not auto-renew.
1778
+ * Default value: `false`
1782
1779
  *
1783
- * Default value: `false`.
1780
+ * 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).
1784
1781
  *
1785
1782
  * @example
1786
1783
  * true
@@ -1788,29 +1785,32 @@ export class CreateClusterRequest extends $tea.Model {
1788
1785
  autoRenew?: boolean;
1789
1786
  /**
1790
1787
  * @remarks
1791
- * 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}.
1788
+ * 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.
1789
+ *
1792
1790
  * Default value: 1.
1793
1791
  *
1792
+ * 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).
1793
+ *
1794
1794
  * @example
1795
1795
  * 1
1796
1796
  */
1797
1797
  autoRenewPeriod?: number;
1798
1798
  /**
1799
1799
  * @remarks
1800
- * The billing method of the cluster. The following resources are billed on a subscription basis:
1801
- *
1802
- * ECS instances in node pools.
1800
+ * The billing method of the resource. The following resources are billed on a subscription basis:
1803
1801
  *
1804
- * The internal-facing SLB instance associated with the API server.
1802
+ * The internal-facing SLB instance used by the API server.
1805
1803
  *
1806
1804
  * Valid values:
1807
1805
  *
1808
- * PrePaid: subscription.
1806
+ * PrePaid: subscription
1809
1807
  *
1810
- * PostPaid: pay-as-you-go.
1808
+ * PostPaid: pay-as-you-go
1811
1809
  *
1812
1810
  * Default value: PostPaid.
1813
1811
  *
1812
+ * 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).
1813
+ *
1814
1814
  * @example
1815
1815
  * 1
1816
1816
  */
@@ -1832,7 +1832,7 @@ export class CreateClusterRequest extends $tea.Model {
1832
1832
  * * `true`: installs the CloudMonitor agent.
1833
1833
  * * `false`: does not install the CloudMonitor agent.
1834
1834
  *
1835
- * Default value: `false`.
1835
+ * Default value: `false`
1836
1836
  *
1837
1837
  * @example
1838
1838
  * true
@@ -1850,10 +1850,10 @@ export class CreateClusterRequest extends $tea.Model {
1850
1850
  clusterDomain?: string;
1851
1851
  /**
1852
1852
  * @remarks
1853
- * After you set `cluster_type` to `ManagedKubernetes` and configure the `profile` parameter, you can further specify the cluster edition. Valid values:
1853
+ * If you set `cluster_type` to `ManagedKubernetes` and specify `profile`, you can further specify the edition of the cluster. Valid values:
1854
1854
  *
1855
- * * `ack.pro.small`: Pro Edition.
1856
- * * `ack.standard`: Basic Edition. If you leave the parameter empty, an ACK Basic cluster is created.
1855
+ * * `ack.pro.small`: creates an ACK Pro cluster.
1856
+ * * `ack.standard`: creates an ACK Basic cluster. If you leave the parameter empty, an ACK Basic cluster is created.
1857
1857
  *
1858
1858
  * @example
1859
1859
  * ack.pro.small
@@ -1861,9 +1861,9 @@ export class CreateClusterRequest extends $tea.Model {
1861
1861
  clusterSpec?: string;
1862
1862
  /**
1863
1863
  * @remarks
1864
- * * `Kubernetes`: ACK dedicated cluster.
1865
- * * `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).
1866
- * * `ExternalKubernetes`: registered cluster.
1864
+ * * `Kubernetes`: an ACK dedicated cluster.
1865
+ * * `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).
1866
+ * * `ExternalKubernetes`: a registered cluster.
1867
1867
  *
1868
1868
  * This parameter is required.
1869
1869
  *
@@ -1885,9 +1885,9 @@ export class CreateClusterRequest extends $tea.Model {
1885
1885
  containerCidr?: string;
1886
1886
  /**
1887
1887
  * @remarks
1888
- * The list of control plane components for which you want to enable log collection.
1888
+ * The control plane component for which you want to enable log collection.
1889
1889
  *
1890
- * By default, the logs of kube-apiserver, kube-controller-manager, and kube-scheduler are collected.
1890
+ * By default, the log of kube-apiserver, kube-controller-manager, and kube-scheduler is collected.
1891
1891
  */
1892
1892
  controlplaneLogComponents?: string[];
1893
1893
  /**
@@ -1910,8 +1910,8 @@ export class CreateClusterRequest extends $tea.Model {
1910
1910
  * @remarks
1911
1911
  * 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:
1912
1912
  *
1913
- * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
1914
- * * `none`: specifies that the default CPU affinity is used.
1913
+ * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity
1914
+ * * `none`: specifies that the default CPU affinity is used
1915
1915
  *
1916
1916
  * Default value: `none`.
1917
1917
  *
@@ -1921,7 +1921,7 @@ export class CreateClusterRequest extends $tea.Model {
1921
1921
  cpuPolicy?: string;
1922
1922
  /**
1923
1923
  * @remarks
1924
- * 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 (,).
1924
+ * 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 (,).
1925
1925
  *
1926
1926
  * @example
1927
1927
  * cs.aliyun.com
@@ -1929,12 +1929,12 @@ export class CreateClusterRequest extends $tea.Model {
1929
1929
  customSan?: string;
1930
1930
  /**
1931
1931
  * @remarks
1932
- * 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:
1932
+ * 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:
1933
1933
  *
1934
- * * `true`: enables deletion protection for the cluster. This way, the cluster cannot be deleted in the ACK console or by calling API operations.
1935
- * * `false`: disables deletion protection for the cluster. This way, the cluster can be deleted in the ACK console or by calling API operations.
1934
+ * * `true`: The cluster cannot be deleted in the Container Service console or by calling API operations.
1935
+ * * `false`: The cluster can be deleted in the Container Service console or by calling API operations.
1936
1936
  *
1937
- * Default value: `false`.
1937
+ * Default value: `false`
1938
1938
  *
1939
1939
  * @example
1940
1940
  * true
@@ -1942,12 +1942,12 @@ export class CreateClusterRequest extends $tea.Model {
1942
1942
  deletionProtection?: boolean;
1943
1943
  /**
1944
1944
  * @remarks
1945
- * Specifies whether to perform a rollback when the cluster fails to be created. Valid values:
1945
+ * Specifies whether to perform a rollback if the cluster fails to be created. Valid values:
1946
1946
  *
1947
1947
  * * `true`: performs a rollback when the cluster fails to be created.
1948
1948
  * * `false`: does not perform a rollback when the cluster fails to be created.
1949
1949
  *
1950
- * Default value: `true`.
1950
+ * Default value: `true`
1951
1951
  *
1952
1952
  * @example
1953
1953
  * true
@@ -1957,7 +1957,7 @@ export class CreateClusterRequest extends $tea.Model {
1957
1957
  disableRollback?: boolean;
1958
1958
  /**
1959
1959
  * @remarks
1960
- * Specifies whether to enable the RAM Roles for Service Accounts (RRSA) feature.
1960
+ * Specifies whether to enable the Resource Access Management (RAM) Roles for Service Accounts (RRSA) feature.
1961
1961
  *
1962
1962
  * @example
1963
1963
  * true
@@ -1980,7 +1980,7 @@ export class CreateClusterRequest extends $tea.Model {
1980
1980
  * * `true`: enables Internet access for the cluster.
1981
1981
  * * `false`: disables Internet access for the cluster. If you set the value to false, the API server cannot be accessed over the Internet.
1982
1982
  *
1983
- * Default value: `false`.
1983
+ * Default value: `false`
1984
1984
  *
1985
1985
  * @example
1986
1986
  * true
@@ -1990,10 +1990,10 @@ export class CreateClusterRequest extends $tea.Model {
1990
1990
  * @remarks
1991
1991
  * Specifies whether to mount a data disk to a node that is created based on an existing ECS instance. Valid values:
1992
1992
  *
1993
- * * `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.
1993
+ * * `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.
1994
1994
  * * `false`: does not store the data of containers and images on a data disk.
1995
1995
  *
1996
- * Default value: `false`.
1996
+ * Default value: `false`
1997
1997
  *
1998
1998
  * How data disks are mounted:
1999
1999
  *
@@ -2034,7 +2034,7 @@ export class CreateClusterRequest extends $tea.Model {
2034
2034
  imageType?: string;
2035
2035
  /**
2036
2036
  * @remarks
2037
- * The existing ECS instances that are specified as worker nodes for the cluster.
2037
+ * The existing Elastic Compute Service (ECS) instances that are specified as worker nodes for the cluster.
2038
2038
  *
2039
2039
  * > This parameter is required if you create worker nodes on existing ECS instances.
2040
2040
  */
@@ -2057,7 +2057,7 @@ export class CreateClusterRequest extends $tea.Model {
2057
2057
  * * `true`: creates an advanced security group.
2058
2058
  * * `false`: does not create an advanced security group.
2059
2059
  *
2060
- * Default value: `true`.
2060
+ * Default value: `true`
2061
2061
  *
2062
2062
  * @example
2063
2063
  * true
@@ -2070,7 +2070,7 @@ export class CreateClusterRequest extends $tea.Model {
2070
2070
  * * `true`: retains the names.
2071
2071
  * * `false`: does not retain the names. The system assigns new names.
2072
2072
  *
2073
- * Default value: `true`.
2073
+ * Default value: `true`
2074
2074
  *
2075
2075
  * @example
2076
2076
  * true
@@ -2078,7 +2078,7 @@ export class CreateClusterRequest extends $tea.Model {
2078
2078
  keepInstanceName?: boolean;
2079
2079
  /**
2080
2080
  * @remarks
2081
- * The name of the key pair. You must specify this parameter or the `login_password` parameter.
2081
+ * The name of the key pair. You must configure this parameter or the `login_password` parameter.
2082
2082
  *
2083
2083
  * @example
2084
2084
  * secrity-key
@@ -2096,7 +2096,7 @@ export class CreateClusterRequest extends $tea.Model {
2096
2096
  kubernetesVersion?: string;
2097
2097
  /**
2098
2098
  * @remarks
2099
- * Specifies the CLB instance ID for accessing the APIServer. When this parameter is set, an APIServer CLB will no longer be automatically created.
2099
+ * 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.
2100
2100
  *
2101
2101
  * @example
2102
2102
  * lb-wz9t256gqa3vbouk****
@@ -2129,12 +2129,16 @@ export class CreateClusterRequest extends $tea.Model {
2129
2129
  loggingType?: string;
2130
2130
  /**
2131
2131
  * @remarks
2132
- * 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.
2132
+ * 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.
2133
2133
  *
2134
2134
  * @example
2135
2135
  * Hello@1234
2136
2136
  */
2137
2137
  loginPassword?: string;
2138
+ /**
2139
+ * @remarks
2140
+ * Cluster maintenance window.
2141
+ */
2138
2142
  maintenanceWindow?: MaintenanceWindow;
2139
2143
  /**
2140
2144
  * @remarks
@@ -2143,7 +2147,7 @@ export class CreateClusterRequest extends $tea.Model {
2143
2147
  * * `true`: enables auto-renewal.
2144
2148
  * * `false`: disables auto-renewal.
2145
2149
  *
2146
- * Default value: `true`.
2150
+ * Default value: `true`
2147
2151
  *
2148
2152
  * @example
2149
2153
  * true
@@ -2151,7 +2155,7 @@ export class CreateClusterRequest extends $tea.Model {
2151
2155
  masterAutoRenew?: boolean;
2152
2156
  /**
2153
2157
  * @remarks
2154
- * The auto-renewal duration. This parameter takes effect and is required only when the subscription billing method is selected for master nodes.
2158
+ * The cycle of auto-renewal. This parameter takes effect and is required only if the subscription billing method is selected for master nodes.
2155
2159
  *
2156
2160
  * Valid values: 1, 2, 3, 6, and 12.
2157
2161
  *
@@ -2176,9 +2180,9 @@ export class CreateClusterRequest extends $tea.Model {
2176
2180
  * The billing method of master nodes. Valid values:
2177
2181
  *
2178
2182
  * * `PrePaid`: subscription.
2179
- * * `PostPaid`: the pay-as-you-go.
2183
+ * * `PostPaid`: pay-as-you-go.
2180
2184
  *
2181
- * Default value: `PostPaid`.
2185
+ * Default value: `PostPaid`
2182
2186
  *
2183
2187
  * @example
2184
2188
  * PrePaid
@@ -2215,8 +2219,8 @@ export class CreateClusterRequest extends $tea.Model {
2215
2219
  * @remarks
2216
2220
  * The system disk type of master nodes. Valid values:
2217
2221
  *
2218
- * * `cloud_efficiency`: ultra disk.
2219
- * * `cloud_ssd`: standard SSD.
2222
+ * * `cloud_efficiency`: ultra disk
2223
+ * * `cloud_ssd`: standard SSD
2220
2224
  * * `cloud_essd`: Enterprise SSD (ESSD).
2221
2225
  *
2222
2226
  * Default value: `cloud_ssd`. The default value may vary in different zones.
@@ -2255,14 +2259,14 @@ export class CreateClusterRequest extends $tea.Model {
2255
2259
  * @remarks
2256
2260
  * 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.
2257
2261
  *
2258
- * 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.
2262
+ * The number of vSwitches must be the same as that specified in `master_count` and the same as those specified in `master_vswitch_ids`.
2259
2263
  */
2260
2264
  masterVswitchIds?: string[];
2261
2265
  /**
2262
2266
  * @remarks
2263
- * The cluster name.
2267
+ * The name of the cluster.
2264
2268
  *
2265
- * The name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). The name cannot start with a hyphen (-).
2269
+ * 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 (-).
2266
2270
  *
2267
2271
  * This parameter is required.
2268
2272
  *
@@ -2272,12 +2276,7 @@ export class CreateClusterRequest extends $tea.Model {
2272
2276
  name?: string;
2273
2277
  /**
2274
2278
  * @remarks
2275
- * Specifies whether to create a NAT gateway and configure SNAT rules if you create an ACK Serverless cluster. Valid values:
2276
- *
2277
- * * `true`: automatically creates a NAT gateway and configures SNAT rules. This enables Internet access for the VPC in which the cluster is deployed.
2278
- * * `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.
2279
- *
2280
- * Default value: `false`.
2279
+ * This parameter is deprecated. Use `snat_entry` instead.
2281
2280
  *
2282
2281
  * @example
2283
2282
  * true
@@ -2285,7 +2284,7 @@ export class CreateClusterRequest extends $tea.Model {
2285
2284
  natGateway?: boolean;
2286
2285
  /**
2287
2286
  * @remarks
2288
- * 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.
2287
+ * 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.
2289
2288
  *
2290
2289
  * Default value: `26`.
2291
2290
  *
@@ -2302,7 +2301,7 @@ export class CreateClusterRequest extends $tea.Model {
2302
2301
  * * 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.
2303
2302
  * * 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.
2304
2303
  *
2305
- * 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.
2304
+ * 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.
2306
2305
  *
2307
2306
  * @example
2308
2307
  * aliyun.com00055test
@@ -2333,6 +2332,10 @@ export class CreateClusterRequest extends $tea.Model {
2333
2332
  * @deprecated
2334
2333
  */
2335
2334
  numOfNodes?: number;
2335
+ /**
2336
+ * @remarks
2337
+ * Cluster auto operation and maintenance policy.
2338
+ */
2336
2339
  operationPolicy?: CreateClusterRequestOperationPolicy;
2337
2340
  /**
2338
2341
  * @remarks
@@ -2355,6 +2358,8 @@ export class CreateClusterRequest extends $tea.Model {
2355
2358
  *
2356
2359
  * Default value: 1.
2357
2360
  *
2361
+ * 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).
2362
+ *
2358
2363
  * @example
2359
2364
  * FY2023
2360
2365
  */
@@ -2363,7 +2368,9 @@ export class CreateClusterRequest extends $tea.Model {
2363
2368
  * @remarks
2364
2369
  * The billing cycle. This parameter is required if charge_type is set to PrePaid.
2365
2370
  *
2366
- * Set the value to Month. Subscription clusters are billed only on a monthly basis.
2371
+ * Valid value: Month, which indicates that resources are billed only on a monthly basis.
2372
+ *
2373
+ * 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).
2367
2374
  *
2368
2375
  * @example
2369
2376
  * Month
@@ -2371,7 +2378,7 @@ export class CreateClusterRequest extends $tea.Model {
2371
2378
  periodUnit?: string;
2372
2379
  /**
2373
2380
  * @remarks
2374
- * The OS distribution that is used. Valid values:
2381
+ * The operating system distribution. Valid values:
2375
2382
  *
2376
2383
  * * CentOS
2377
2384
  * * AliyunLinux
@@ -2388,19 +2395,19 @@ export class CreateClusterRequest extends $tea.Model {
2388
2395
  platform?: string;
2389
2396
  /**
2390
2397
  * @remarks
2391
- * 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.
2398
+ * 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.
2392
2399
  *
2393
- * > 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.
2400
+ * > 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.
2394
2401
  */
2395
2402
  podVswitchIds?: string[];
2396
2403
  /**
2397
2404
  * @remarks
2398
2405
  * 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:
2399
2406
  *
2400
- * * `Default`: ACK managed cluster. ACK managed clusters include ACK Basic clusters and ACK Pro clusters.
2401
- * * `Edge`: ACK Edge cluster. ACK Edge clusters include ACK Edge Basic clusters and ACK Edge Pro clusters.
2402
- * * `Serverless`: ACK Serverless cluster. ACK Serverless clusters include ACK Serverless Basic clusters and ACK Serverless Pro clusters.
2403
- * * `Lingjun`: ACK Lingjun Pro cluster.
2407
+ * * `Default`. an ACK managed cluster. ACK managed clusters include ACK Basic clusters and ACK Pro clusters.
2408
+ * * `Edge`: an ACK Edge cluster. ACK Edge clusters include ACK Edge Basic clusters and ACK Edge Pro clusters.
2409
+ * * `Serverless`: an ACK Serverless cluster. ACK Serverless clusters include ACK Serverless Basic clusters and ACK Serverless Pro clusters.
2410
+ * * `Lingjun`: an ACK Lingjun Pro cluster.
2404
2411
  *
2405
2412
  * @example
2406
2413
  * Default
@@ -2410,8 +2417,8 @@ export class CreateClusterRequest extends $tea.Model {
2410
2417
  * @remarks
2411
2418
  * The kube-proxy mode. Valid values:
2412
2419
  *
2413
- * * `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.
2414
- * * `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.
2420
+ * * `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.
2421
+ * * `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.
2415
2422
  *
2416
2423
  * Default value: `ipvs`.
2417
2424
  *
@@ -2421,7 +2428,7 @@ export class CreateClusterRequest extends $tea.Model {
2421
2428
  proxyMode?: string;
2422
2429
  /**
2423
2430
  * @remarks
2424
- * 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.
2431
+ * 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.
2425
2432
  */
2426
2433
  rdsInstances?: string[];
2427
2434
  /**
@@ -2451,7 +2458,7 @@ export class CreateClusterRequest extends $tea.Model {
2451
2458
  runtime?: Runtime;
2452
2459
  /**
2453
2460
  * @remarks
2454
- * 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.
2461
+ * 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.
2455
2462
  *
2456
2463
  * @example
2457
2464
  * sg-bp1bdue0qc1g7k****
@@ -2464,7 +2471,7 @@ export class CreateClusterRequest extends $tea.Model {
2464
2471
  * * `true`: enables Alibaba Cloud Linux Security Hardening.
2465
2472
  * * `false`: disables Alibaba Cloud Linux Security Hardening.
2466
2473
  *
2467
- * Default value: `false`.
2474
+ * Default value: `false`
2468
2475
  *
2469
2476
  * @example
2470
2477
  * false
@@ -2472,9 +2479,9 @@ export class CreateClusterRequest extends $tea.Model {
2472
2479
  securityHardeningOs?: boolean;
2473
2480
  /**
2474
2481
  * @remarks
2475
- * 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`.
2482
+ * 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`.
2476
2483
  *
2477
- * For more information about `service accounts`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
2484
+ * For more information about `ServiceAccount`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
2478
2485
  *
2479
2486
  * @example
2480
2487
  * kubernetes.default.svc
@@ -2482,7 +2489,7 @@ export class CreateClusterRequest extends $tea.Model {
2482
2489
  serviceAccountIssuer?: string;
2483
2490
  /**
2484
2491
  * @remarks
2485
- * 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.
2492
+ * 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.
2486
2493
  *
2487
2494
  * By default, the Service CIDR block is set to 172.19.0.0/20.
2488
2495
  *
@@ -2494,24 +2501,24 @@ export class CreateClusterRequest extends $tea.Model {
2494
2501
  serviceCidr?: string;
2495
2502
  /**
2496
2503
  * @remarks
2497
- * The type of service discovery that is implemented in the `ACK Serverless` cluster.
2504
+ * The methods for implementing service discovery in `ACK Serverless` clusters.
2498
2505
  *
2499
- * * `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.
2500
- * * `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.
2506
+ * * `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.
2507
+ * * `PrivateZone`: a DNS resolution service provided by Alibaba Cloud. You must activate Alibaba Cloud DNS PrivateZone before you can use it for service discovery.
2501
2508
  *
2502
2509
  * By default, this parameter is not specified.
2503
2510
  */
2504
2511
  serviceDiscoveryTypes?: string[];
2505
2512
  /**
2506
2513
  * @remarks
2507
- * Specifies whether to configure SNAT rules for the VPC in which your cluster is deployed. Valid values:
2514
+ * Specifies whether to configure Source Network Address Translation (SNAT) rules for the VPC in which your cluster is deployed. Valid values:
2508
2515
  *
2509
2516
  * * `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.
2510
2517
  * * `false`: does not create a NAT gateway or configure SNAT rules. In this case, nodes and applications in the cluster cannot access the Internet.
2511
2518
  *
2512
2519
  * > 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).
2513
2520
  *
2514
- * Default value: `true`.
2521
+ * Default value: `true`
2515
2522
  *
2516
2523
  * @example
2517
2524
  * true
@@ -2526,7 +2533,7 @@ export class CreateClusterRequest extends $tea.Model {
2526
2533
  * * `true`: enables security hardening based on MLPS.
2527
2534
  * * `false`: disables security hardening based on MLPS.
2528
2535
  *
2529
- * Default value: `false`.
2536
+ * Default value: `false`
2530
2537
  *
2531
2538
  * @example
2532
2539
  * false
@@ -2539,7 +2546,7 @@ export class CreateClusterRequest extends $tea.Model {
2539
2546
  * * `true`: enables SSH logon.
2540
2547
  * * `false`: disables SSH logon.
2541
2548
  *
2542
- * Default value: `false`.
2549
+ * Default value: `false`
2543
2550
  *
2544
2551
  * @example
2545
2552
  * true
@@ -2547,15 +2554,15 @@ export class CreateClusterRequest extends $tea.Model {
2547
2554
  sshFlags?: boolean;
2548
2555
  /**
2549
2556
  * @remarks
2550
- * The labels that you want to add to nodes. You must add labels based on the following rules:
2557
+ * The tags to be added to nodes. You must add labels based on the following rules:
2551
2558
  *
2552
2559
  * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
2553
- * * 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).
2560
+ * * 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).
2554
2561
  */
2555
2562
  tags?: Tag[];
2556
2563
  /**
2557
2564
  * @remarks
2558
- * 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/).
2565
+ * 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/).
2559
2566
  */
2560
2567
  taints?: Taint[];
2561
2568
  /**
@@ -2602,15 +2609,15 @@ export class CreateClusterRequest extends $tea.Model {
2602
2609
  vpcid?: string;
2603
2610
  /**
2604
2611
  * @remarks
2605
- * The vSwitches for nodes in the cluster. This parameter is required if you create an ACK managed cluster that does not contain nodes.
2612
+ * 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.
2606
2613
  */
2607
2614
  vswitchIds?: string[];
2608
2615
  /**
2609
2616
  * @remarks
2610
- * 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:
2617
+ * 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:
2611
2618
  *
2612
2619
  * * `true`: enables auto-renewal.
2613
- * * `false`: disables auto-renewal.
2620
+ * * `false`: disables auto-renewal
2614
2621
  *
2615
2622
  * Default value: `true`
2616
2623
  *
@@ -2622,7 +2629,7 @@ export class CreateClusterRequest extends $tea.Model {
2622
2629
  workerAutoRenew?: boolean;
2623
2630
  /**
2624
2631
  * @remarks
2625
- * The auto-renewal duration. This parameter takes effect and is required only when the subscription billing method is selected for worker nodes.
2632
+ * The cycle of auto-renewal. This parameter takes effect and is required only if the subscription billing method is selected for worker nodes.
2626
2633
  *
2627
2634
  * Valid values: 1, 2, 3, 6, and 12.
2628
2635
  *
@@ -2679,7 +2686,7 @@ export class CreateClusterRequest extends $tea.Model {
2679
2686
  * @remarks
2680
2687
  * The billing cycle of worker nodes. This parameter is required if worker_instance_charge_type is set to `PrePaid`.
2681
2688
  *
2682
- * Set the value to `Month`. Subscription worker nodes are billed only on a monthly basis.
2689
+ * Valid value: `Month`, which indicates that worker nodes are billed only on a monthly basis.
2683
2690
  *
2684
2691
  * @example
2685
2692
  * Month
@@ -2689,7 +2696,7 @@ export class CreateClusterRequest extends $tea.Model {
2689
2696
  workerPeriodUnit?: string;
2690
2697
  /**
2691
2698
  * @remarks
2692
- * The system disk type of worker nodes. For more information, see [Overview of Block Storage](https://help.aliyun.com/document_detail/63136.html).
2699
+ * The system disk category of worker nodes. For more information, see [Elastic Block Storage devices](https://help.aliyun.com/document_detail/63136.html).
2693
2700
  *
2694
2701
  * Valid values:
2695
2702
  *
@@ -2749,7 +2756,7 @@ export class CreateClusterRequest extends $tea.Model {
2749
2756
  workerSystemDiskSnapshotPolicyId?: string;
2750
2757
  /**
2751
2758
  * @remarks
2752
- * The vSwitches for worker nodes. Each worker node is allocated a vSwitch.
2759
+ * The vSwitches that are specified for worker nodes. Each worker node is allocated a vSwitch.
2753
2760
  *
2754
2761
  * `worker_vswitch_ids` is optional but `vswitch_ids` is required if you create an ACK managed cluster that does not contain nodes.
2755
2762
  *
@@ -2758,9 +2765,11 @@ export class CreateClusterRequest extends $tea.Model {
2758
2765
  workerVswitchIds?: string[];
2759
2766
  /**
2760
2767
  * @remarks
2761
- * The ID of the zone to which the cluster belongs. This parameter takes effect only for ACK Serverless clusters.
2768
+ * This parameter is deprecated. Use `zone_ids` instead.
2762
2769
  *
2763
- * 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.
2770
+ * The ID of the zone to which the cluster belongs. This parameter is specific to ACK managed clusters.
2771
+ *
2772
+ * 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.
2764
2773
  *
2765
2774
  * @example
2766
2775
  * cn-beiji****
@@ -2770,8 +2779,9 @@ export class CreateClusterRequest extends $tea.Model {
2770
2779
  zoneId?: string;
2771
2780
  /**
2772
2781
  * @remarks
2773
- * List of availability zone IDs in the region where the cluster resides. This parameter is specific to ACK managed clusters.
2774
- * 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.
2782
+ * The IDs of the zone in which the cluster is deployed. This parameter is specific to ACK managed clusters.
2783
+ *
2784
+ * 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.
2775
2785
  */
2776
2786
  zoneIds?: string[];
2777
2787
  static names(): { [key: string]: string } {
@@ -3203,7 +3213,7 @@ export class CreateClusterNodePoolRequest extends $tea.Model {
3203
3213
  autoScaling?: CreateClusterNodePoolRequestAutoScaling;
3204
3214
  /**
3205
3215
  * @remarks
3206
- * This parameter is deprecated. Use desired_size instead.
3216
+ * This parameter is deprecated. Use the desired_size parameter instead.
3207
3217
  *
3208
3218
  * The number of nodes in the node pool.
3209
3219
  *
@@ -3213,6 +3223,7 @@ export class CreateClusterNodePoolRequest extends $tea.Model {
3213
3223
  * @deprecated
3214
3224
  */
3215
3225
  count?: number;
3226
+ hostNetwork?: boolean;
3216
3227
  /**
3217
3228
  * @remarks
3218
3229
  * This parameter is deprecated.
@@ -3224,15 +3235,16 @@ export class CreateClusterNodePoolRequest extends $tea.Model {
3224
3235
  interconnectConfig?: CreateClusterNodePoolRequestInterconnectConfig;
3225
3236
  /**
3226
3237
  * @remarks
3227
- * 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:
3238
+ * 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:
3228
3239
  *
3229
- * * `basic`: basic
3230
- * * `private`: dedicated Only Kubernetes 1.22 and later support this value.
3240
+ * * `basic`: basic.
3241
+ * * `private`: dedicated. Only clusters that run Kubernetes 1.22 and later support this value.
3231
3242
  *
3232
3243
  * @example
3233
3244
  * basic
3234
3245
  */
3235
3246
  interconnectMode?: string;
3247
+ intranet?: boolean;
3236
3248
  /**
3237
3249
  * @remarks
3238
3250
  * The configurations of the cluster.
@@ -3280,8 +3292,10 @@ export class CreateClusterNodePoolRequest extends $tea.Model {
3280
3292
  return {
3281
3293
  autoScaling: 'auto_scaling',
3282
3294
  count: 'count',
3295
+ hostNetwork: 'host_network',
3283
3296
  interconnectConfig: 'interconnect_config',
3284
3297
  interconnectMode: 'interconnect_mode',
3298
+ intranet: 'intranet',
3285
3299
  kubernetesConfig: 'kubernetes_config',
3286
3300
  management: 'management',
3287
3301
  maxNodes: 'max_nodes',
@@ -3296,8 +3310,10 @@ export class CreateClusterNodePoolRequest extends $tea.Model {
3296
3310
  return {
3297
3311
  autoScaling: CreateClusterNodePoolRequestAutoScaling,
3298
3312
  count: 'number',
3313
+ hostNetwork: 'boolean',
3299
3314
  interconnectConfig: CreateClusterNodePoolRequestInterconnectConfig,
3300
3315
  interconnectMode: 'string',
3316
+ intranet: 'boolean',
3301
3317
  kubernetesConfig: CreateClusterNodePoolRequestKubernetesConfig,
3302
3318
  management: CreateClusterNodePoolRequestManagement,
3303
3319
  maxNodes: 'number',
@@ -5170,12 +5186,12 @@ export class DescribeClusterAddonInstanceResponseBody extends $tea.Model {
5170
5186
  * @remarks
5171
5187
  * The status of the component. Valid values:
5172
5188
  *
5173
- * * initial: the component is being installed.
5174
- * * active: the component is installed.
5175
- * * unhealthy: the component abnormal.
5176
- * * upgrading: the component is being updated.
5177
- * * updating: the component is being modified.
5178
- * * deleting: the component is being uninstalled.
5189
+ * * initial: The component is being installed.
5190
+ * * active: The component is installed.
5191
+ * * unhealthy: The component is in an abnormal state.
5192
+ * * upgrading: The component is being updated.
5193
+ * * updating: The component is being modified.
5194
+ * * deleting: The component is being uninstalled.
5179
5195
  * * deleted: The component is deleted.
5180
5196
  *
5181
5197
  * @example
@@ -5576,6 +5592,9 @@ export class DescribeClusterAttachScriptsResponse extends $tea.Model {
5576
5592
 
5577
5593
  export class DescribeClusterDetailResponseBody extends $tea.Model {
5578
5594
  /**
5595
+ * @remarks
5596
+ * The on-premises domain name of the cluster.
5597
+ *
5579
5598
  * @example
5580
5599
  * cluster.local
5581
5600
  */
@@ -5610,6 +5629,9 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5610
5629
  */
5611
5630
  clusterType?: string;
5612
5631
  /**
5632
+ * @remarks
5633
+ * The CIDR block of the pod.
5634
+ *
5613
5635
  * @example
5614
5636
  * 172.20.0.0/16
5615
5637
  */
@@ -5650,6 +5672,9 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5650
5672
  */
5651
5673
  dockerVersion?: string;
5652
5674
  /**
5675
+ * @remarks
5676
+ * The ID of the Server Load Balancer (SLB) instance that is created for the Ingress of the cluster.
5677
+ *
5653
5678
  * @example
5654
5679
  * lb-2zehc05z3b8dwiifh****
5655
5680
  */
@@ -5663,6 +5688,12 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5663
5688
  */
5664
5689
  initVersion?: string;
5665
5690
  /**
5691
+ * @remarks
5692
+ * The IP protocol stack of the cluster. Valid values:
5693
+ *
5694
+ * * ipv4: creates a cluster that supports only the IPv4 protocol stack.
5695
+ * * dual: creates a cluster that supports IPv4/IPv6 dual-stack.
5696
+ *
5666
5697
  * @example
5667
5698
  * ipv4
5668
5699
  */
@@ -5699,27 +5730,48 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5699
5730
  */
5700
5731
  name?: string;
5701
5732
  /**
5733
+ * @remarks
5734
+ * The network type of the cluster. Example: Virtual Private Cloud (VPC).
5735
+ *
5702
5736
  * @example
5703
5737
  * vpc
5704
5738
  */
5705
5739
  networkMode?: string;
5706
5740
  /**
5741
+ * @remarks
5742
+ * The Kubernetes version to which the cluster can be updated.
5743
+ *
5707
5744
  * @example
5708
5745
  * 1.18.8-aliyun.1
5709
5746
  */
5710
5747
  nextVersion?: string;
5711
5748
  /**
5749
+ * @remarks
5750
+ * The number of the IP addresses of the node.
5751
+ *
5712
5752
  * @example
5713
5753
  * 26
5714
5754
  */
5715
5755
  nodeCidrMask?: string;
5756
+ /**
5757
+ * @remarks
5758
+ * The automatic O\\&M policy of the cluster.
5759
+ */
5716
5760
  operationPolicy?: DescribeClusterDetailResponseBodyOperationPolicy;
5717
5761
  /**
5718
5762
  * @remarks
5719
- * The ROS parameters of the cluster.
5763
+ * The Resource Orchestration Service (ROS) parameters of the cluster.
5720
5764
  */
5721
5765
  parameters?: { [key: string]: string };
5722
5766
  /**
5767
+ * @remarks
5768
+ * Indicates whether Alibaba Cloud DNS PrivateZone (PrivateZone) is enabled for the cluster. Valid values:
5769
+ *
5770
+ * * `true`: PrivateZone is enabled.
5771
+ * * `false`: PrivateZone is dislabled.
5772
+ *
5773
+ * Default value: false
5774
+ *
5723
5775
  * @example
5724
5776
  * false
5725
5777
  */
@@ -5738,6 +5790,9 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5738
5790
  */
5739
5791
  profile?: string;
5740
5792
  /**
5793
+ * @remarks
5794
+ * The proxy mode. Valid values: ipvs and iptables.
5795
+ *
5741
5796
  * @example
5742
5797
  * ipvs
5743
5798
  */
@@ -5768,6 +5823,8 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5768
5823
  securityGroupId?: string;
5769
5824
  /**
5770
5825
  * @remarks
5826
+ * The CIDR block of the Service.
5827
+ *
5771
5828
  * This parameter is required.
5772
5829
  *
5773
5830
  * @example
@@ -5811,9 +5868,9 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5811
5868
  * * 172.16-31.0.0/12-16
5812
5869
  * * 192.168.0.0/16
5813
5870
  *
5814
- * The pod CIDR block cannot overlap with the CIDR block of the VPC or the CIDR blocks of the clusters in the VPC.
5871
+ * 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.
5815
5872
  *
5816
- * For more information, see [Plan CIDR blocks for an ACK cluster](https://help.aliyun.com/document_detail/186964.html).
5873
+ * 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).
5817
5874
  *
5818
5875
  * @example
5819
5876
  * 172.20.0.0/16
@@ -5827,6 +5884,9 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5827
5884
  */
5828
5885
  tags?: Tag[];
5829
5886
  /**
5887
+ * @remarks
5888
+ * The time zone.
5889
+ *
5830
5890
  * @example
5831
5891
  * Asia/Shanghai
5832
5892
  */
@@ -5849,7 +5909,7 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5849
5909
  vpcId?: string;
5850
5910
  /**
5851
5911
  * @remarks
5852
- * 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.
5912
+ * 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.
5853
5913
  *
5854
5914
  * @example
5855
5915
  * vsw-2zete8s4qocqg0mf6****,vsw-2zete8s4qocqg0mf6****
@@ -5857,6 +5917,10 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5857
5917
  * @deprecated
5858
5918
  */
5859
5919
  vswitchId?: string;
5920
+ /**
5921
+ * @remarks
5922
+ * The vSwitch for the control plane of the cluster.
5923
+ */
5860
5924
  vswitchIds?: string[];
5861
5925
  /**
5862
5926
  * @remarks
@@ -5867,6 +5931,9 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5867
5931
  */
5868
5932
  workerRamRoleName?: string;
5869
5933
  /**
5934
+ * @remarks
5935
+ * The ID of the zone within the region where the cluster is located.
5936
+ *
5870
5937
  * @example
5871
5938
  * cn-beijing-a
5872
5939
  */
@@ -6121,6 +6188,7 @@ export class DescribeClusterNodePoolDetailResponseBody extends $tea.Model {
6121
6188
  * The auto scaling configuration of the node pool.
6122
6189
  */
6123
6190
  autoScaling?: DescribeClusterNodePoolDetailResponseBodyAutoScaling;
6191
+ hostNetwork?: boolean;
6124
6192
  /**
6125
6193
  * @remarks
6126
6194
  * The network configuration of the edge node pool. This parameter takes effect only for edge node pools.
@@ -6134,9 +6202,10 @@ export class DescribeClusterNodePoolDetailResponseBody extends $tea.Model {
6134
6202
  * improved
6135
6203
  */
6136
6204
  interconnectMode?: string;
6205
+ intranet?: boolean;
6137
6206
  /**
6138
6207
  * @remarks
6139
- * The configuration of the cluster where the node pool is deployed.
6208
+ * The configurations of the cluster in which the node pool is deployed.
6140
6209
  */
6141
6210
  kubernetesConfig?: DescribeClusterNodePoolDetailResponseBodyKubernetesConfig;
6142
6211
  /**
@@ -6180,8 +6249,10 @@ export class DescribeClusterNodePoolDetailResponseBody extends $tea.Model {
6180
6249
  static names(): { [key: string]: string } {
6181
6250
  return {
6182
6251
  autoScaling: 'auto_scaling',
6252
+ hostNetwork: 'host_network',
6183
6253
  interconnectConfig: 'interconnect_config',
6184
6254
  interconnectMode: 'interconnect_mode',
6255
+ intranet: 'intranet',
6185
6256
  kubernetesConfig: 'kubernetes_config',
6186
6257
  management: 'management',
6187
6258
  maxNodes: 'max_nodes',
@@ -6196,8 +6267,10 @@ export class DescribeClusterNodePoolDetailResponseBody extends $tea.Model {
6196
6267
  static types(): { [key: string]: any } {
6197
6268
  return {
6198
6269
  autoScaling: DescribeClusterNodePoolDetailResponseBodyAutoScaling,
6270
+ hostNetwork: 'boolean',
6199
6271
  interconnectConfig: DescribeClusterNodePoolDetailResponseBodyInterconnectConfig,
6200
6272
  interconnectMode: 'string',
6273
+ intranet: 'boolean',
6201
6274
  kubernetesConfig: DescribeClusterNodePoolDetailResponseBodyKubernetesConfig,
6202
6275
  management: DescribeClusterNodePoolDetailResponseBodyManagement,
6203
6276
  maxNodes: 'number',
@@ -6874,6 +6947,118 @@ export class DescribeClustersResponse extends $tea.Model {
6874
6947
  }
6875
6948
  }
6876
6949
 
6950
+ export class DescribeClustersForRegionRequest extends $tea.Model {
6951
+ /**
6952
+ * @example
6953
+ * c8155823d057948c69a****
6954
+ */
6955
+ clusterId?: string;
6956
+ /**
6957
+ * @example
6958
+ * ack.standard
6959
+ */
6960
+ clusterSpec?: string;
6961
+ /**
6962
+ * @example
6963
+ * Kubernetes
6964
+ */
6965
+ clusterType?: string;
6966
+ /**
6967
+ * @example
6968
+ * test-cluster
6969
+ */
6970
+ name?: string;
6971
+ /**
6972
+ * @example
6973
+ * 10
6974
+ */
6975
+ pageNumber?: number;
6976
+ /**
6977
+ * @example
6978
+ * 3
6979
+ */
6980
+ pageSize?: number;
6981
+ /**
6982
+ * @example
6983
+ * Serverless
6984
+ */
6985
+ profile?: string;
6986
+ static names(): { [key: string]: string } {
6987
+ return {
6988
+ clusterId: 'cluster_id',
6989
+ clusterSpec: 'cluster_spec',
6990
+ clusterType: 'cluster_type',
6991
+ name: 'name',
6992
+ pageNumber: 'page_number',
6993
+ pageSize: 'page_size',
6994
+ profile: 'profile',
6995
+ };
6996
+ }
6997
+
6998
+ static types(): { [key: string]: any } {
6999
+ return {
7000
+ clusterId: 'string',
7001
+ clusterSpec: 'string',
7002
+ clusterType: 'string',
7003
+ name: 'string',
7004
+ pageNumber: 'number',
7005
+ pageSize: 'number',
7006
+ profile: 'string',
7007
+ };
7008
+ }
7009
+
7010
+ constructor(map?: { [key: string]: any }) {
7011
+ super(map);
7012
+ }
7013
+ }
7014
+
7015
+ export class DescribeClustersForRegionResponseBody extends $tea.Model {
7016
+ clusters?: DescribeClustersForRegionResponseBodyClusters[];
7017
+ pageInfo?: DescribeClustersForRegionResponseBodyPageInfo;
7018
+ static names(): { [key: string]: string } {
7019
+ return {
7020
+ clusters: 'clusters',
7021
+ pageInfo: 'page_info',
7022
+ };
7023
+ }
7024
+
7025
+ static types(): { [key: string]: any } {
7026
+ return {
7027
+ clusters: { 'type': 'array', 'itemType': DescribeClustersForRegionResponseBodyClusters },
7028
+ pageInfo: DescribeClustersForRegionResponseBodyPageInfo,
7029
+ };
7030
+ }
7031
+
7032
+ constructor(map?: { [key: string]: any }) {
7033
+ super(map);
7034
+ }
7035
+ }
7036
+
7037
+ export class DescribeClustersForRegionResponse extends $tea.Model {
7038
+ headers?: { [key: string]: string };
7039
+ statusCode?: number;
7040
+ body?: DescribeClustersForRegionResponseBody;
7041
+ static names(): { [key: string]: string } {
7042
+ return {
7043
+ headers: 'headers',
7044
+ statusCode: 'statusCode',
7045
+ body: 'body',
7046
+ };
7047
+ }
7048
+
7049
+ static types(): { [key: string]: any } {
7050
+ return {
7051
+ headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
7052
+ statusCode: 'number',
7053
+ body: DescribeClustersForRegionResponseBody,
7054
+ };
7055
+ }
7056
+
7057
+ constructor(map?: { [key: string]: any }) {
7058
+ super(map);
7059
+ }
7060
+ }
7061
+
6877
7062
  export class DescribeClustersV1Request extends $tea.Model {
6878
7063
  /**
6879
7064
  * @remarks
@@ -7497,7 +7682,7 @@ export class DescribeEventsRequest extends $tea.Model {
7497
7682
  export class DescribeEventsResponseBody extends $tea.Model {
7498
7683
  /**
7499
7684
  * @remarks
7500
- * The details of the event.
7685
+ * The details of the events.
7501
7686
  */
7502
7687
  events?: DescribeEventsResponseBodyEvents[];
7503
7688
  /**
@@ -7549,30 +7734,114 @@ export class DescribeEventsResponse extends $tea.Model {
7549
7734
  }
7550
7735
  }
7551
7736
 
7552
- export class DescribeExternalAgentRequest extends $tea.Model {
7737
+ export class DescribeEventsForRegionRequest extends $tea.Model {
7553
7738
  /**
7554
- * @remarks
7555
- * The permission mode of the agent. Valid values:
7556
- *
7557
- * admin: the admin mode, which provides full permissions. restricted: the restricted mode, which provides partial permissions. Default value: admin.
7558
- *
7559
7739
  * @example
7560
- * admin
7740
+ * cf62854ac2130470897be7a27ed1f****
7561
7741
  */
7562
- agentMode?: string;
7742
+ clusterId?: string;
7563
7743
  /**
7564
- * @remarks
7565
- * Specifies whether to obtain the credentials that are used to access the cluster over the internal network.
7566
- *
7567
- * * `true`: obtains the credentials that are used to access the cluster over the internal network.
7568
- * * `false`: obtains the credentials that are used to access the cluster over the Internet.
7569
- *
7570
- * Default value: `false`.
7571
- *
7572
7744
  * @example
7573
- * true
7745
+ * 1
7574
7746
  */
7575
- privateIpAddress?: string;
7747
+ pageNumber?: number;
7748
+ /**
7749
+ * @example
7750
+ * 50
7751
+ */
7752
+ pageSize?: number;
7753
+ static names(): { [key: string]: string } {
7754
+ return {
7755
+ clusterId: 'cluster_id',
7756
+ pageNumber: 'page_number',
7757
+ pageSize: 'page_size',
7758
+ };
7759
+ }
7760
+
7761
+ static types(): { [key: string]: any } {
7762
+ return {
7763
+ clusterId: 'string',
7764
+ pageNumber: 'number',
7765
+ pageSize: 'number',
7766
+ };
7767
+ }
7768
+
7769
+ constructor(map?: { [key: string]: any }) {
7770
+ super(map);
7771
+ }
7772
+ }
7773
+
7774
+ export class DescribeEventsForRegionResponseBody extends $tea.Model {
7775
+ events?: DescribeEventsForRegionResponseBodyEvents[];
7776
+ pageInfo?: DescribeEventsForRegionResponseBodyPageInfo;
7777
+ static names(): { [key: string]: string } {
7778
+ return {
7779
+ events: 'events',
7780
+ pageInfo: 'page_info',
7781
+ };
7782
+ }
7783
+
7784
+ static types(): { [key: string]: any } {
7785
+ return {
7786
+ events: { 'type': 'array', 'itemType': DescribeEventsForRegionResponseBodyEvents },
7787
+ pageInfo: DescribeEventsForRegionResponseBodyPageInfo,
7788
+ };
7789
+ }
7790
+
7791
+ constructor(map?: { [key: string]: any }) {
7792
+ super(map);
7793
+ }
7794
+ }
7795
+
7796
+ export class DescribeEventsForRegionResponse extends $tea.Model {
7797
+ headers?: { [key: string]: string };
7798
+ statusCode?: number;
7799
+ body?: DescribeEventsForRegionResponseBody;
7800
+ static names(): { [key: string]: string } {
7801
+ return {
7802
+ headers: 'headers',
7803
+ statusCode: 'statusCode',
7804
+ body: 'body',
7805
+ };
7806
+ }
7807
+
7808
+ static types(): { [key: string]: any } {
7809
+ return {
7810
+ headers: { 'type': 'map', 'keyType': 'string', 'valueType': 'string' },
7811
+ statusCode: 'number',
7812
+ body: DescribeEventsForRegionResponseBody,
7813
+ };
7814
+ }
7815
+
7816
+ constructor(map?: { [key: string]: any }) {
7817
+ super(map);
7818
+ }
7819
+ }
7820
+
7821
+ export class DescribeExternalAgentRequest extends $tea.Model {
7822
+ /**
7823
+ * @remarks
7824
+ * The permission mode of the agent. Valid values:
7825
+ *
7826
+ * admin: the admin mode, which provides full permissions. restricted: the restricted mode, which provides partial permissions. Default value: admin.
7827
+ *
7828
+ * @example
7829
+ * admin
7830
+ */
7831
+ agentMode?: string;
7832
+ /**
7833
+ * @remarks
7834
+ * Specifies whether to obtain the credentials that are used to access the cluster over the internal network.
7835
+ *
7836
+ * * `true`: obtains the credentials that are used to access the cluster over the internal network.
7837
+ * * `false`: obtains the credentials that are used to access the cluster over the Internet.
7838
+ *
7839
+ * Default value: `false`.
7840
+ *
7841
+ * @example
7842
+ * true
7843
+ */
7844
+ privateIpAddress?: string;
7576
7845
  static names(): { [key: string]: string } {
7577
7846
  return {
7578
7847
  agentMode: 'AgentMode',
@@ -7672,12 +7941,12 @@ export class DescribeKubernetesVersionMetadataRequest extends $tea.Model {
7672
7941
  * @remarks
7673
7942
  * The query mode. Valid values:
7674
7943
  *
7675
- * * `supported`: queries all supported versions.
7676
- * * `creatable`: queries only versions that allow you to create clusters.
7944
+ * * `supported`: queries all supported Kubernetes versions.
7945
+ * * `creatable`: queries only Kubernetes versions of clusters that you can create.
7677
7946
  *
7678
7947
  * If you specify `KubernetesVersion`, this parameter does not take effect.
7679
7948
  *
7680
- * Default value: creatable.
7949
+ * If you do not specify a query mode, Kubernetes versions of clusters that you can create are returned.
7681
7950
  *
7682
7951
  * @example
7683
7952
  * supported
@@ -9269,7 +9538,10 @@ export class GetClusterAddonInstanceResponse extends $tea.Model {
9269
9538
  export class GetClusterAuditProjectResponseBody extends $tea.Model {
9270
9539
  /**
9271
9540
  * @remarks
9272
- * 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.
9541
+ * Indicates whether the cluster auditing feature is enabled for the cluster.
9542
+ *
9543
+ * * `true`: The cluster auditing feature is enabled for the cluster.
9544
+ * * `false`: The cluster auditing feature is disabled for the cluster.
9273
9545
  *
9274
9546
  * @example
9275
9547
  * true
@@ -10427,7 +10699,7 @@ export class ListTagResourcesRequest extends $tea.Model {
10427
10699
  resourceType?: string;
10428
10700
  /**
10429
10701
  * @remarks
10430
- * The list of labels that you want to query. You can specify at most 20 labels.
10702
+ * The labels that you want to query. You can specify up to 20 labels.
10431
10703
  *
10432
10704
  * @example
10433
10705
  * [{\\"key\\":\\"env\\",\\"value\\",\\"dev\\"},{\\"key\\":\\"dev\\", \\"value\\":\\"IT\\"}]
@@ -10499,7 +10771,7 @@ export class ListTagResourcesShrinkRequest extends $tea.Model {
10499
10771
  resourceType?: string;
10500
10772
  /**
10501
10773
  * @remarks
10502
- * The list of labels that you want to query. You can specify at most 20 labels.
10774
+ * The labels that you want to query. You can specify up to 20 labels.
10503
10775
  *
10504
10776
  * @example
10505
10777
  * [{\\"key\\":\\"env\\",\\"value\\",\\"dev\\"},{\\"key\\":\\"dev\\", \\"value\\":\\"IT\\"}]
@@ -11330,9 +11602,13 @@ export class ModifyClusterTagsResponse extends $tea.Model {
11330
11602
  export class ModifyNodePoolNodeConfigRequest extends $tea.Model {
11331
11603
  /**
11332
11604
  * @remarks
11333
- * The parameter settings of the kubelet.
11605
+ * The parameters of the kubelet.
11334
11606
  */
11335
11607
  kubeletConfig?: KubeletConfig;
11608
+ /**
11609
+ * @remarks
11610
+ * Operating system parameter configuration.
11611
+ */
11336
11612
  osConfig?: ModifyNodePoolNodeConfigRequestOsConfig;
11337
11613
  /**
11338
11614
  * @remarks
@@ -12536,15 +12812,15 @@ export class ScaleOutClusterRequest extends $tea.Model {
12536
12812
  runtime?: Runtime;
12537
12813
  /**
12538
12814
  * @remarks
12539
- * The labels that you want to add to nodes. You must add labels based on the following rules:
12815
+ * The tags that you want to add to nodes. When you add labels to a node, the following rules apply:
12540
12816
  *
12541
12817
  * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
12542
- * * 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).
12818
+ * * 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).
12543
12819
  */
12544
12820
  tags?: Tag[];
12545
12821
  /**
12546
12822
  * @remarks
12547
- * 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/).
12823
+ * 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/).
12548
12824
  */
12549
12825
  taints?: Taint[];
12550
12826
  /**
@@ -12567,7 +12843,7 @@ export class ScaleOutClusterRequest extends $tea.Model {
12567
12843
  * 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:
12568
12844
  *
12569
12845
  * * `true`: enables auto-renewal.
12570
- * * `false`: does not enable auto-renewal.
12846
+ * * `false`: disables auto-renewal.
12571
12847
  *
12572
12848
  * Default value: `true`.
12573
12849
  *
@@ -12599,7 +12875,7 @@ export class ScaleOutClusterRequest extends $tea.Model {
12599
12875
  * * `PrePaid`: subscription.
12600
12876
  * * `PostPaid`: pay-as-you-go.
12601
12877
  *
12602
- * Default value: `PostPaid`.
12878
+ * Default value: `PostPaid`
12603
12879
  *
12604
12880
  * @example
12605
12881
  * PrePaid
@@ -12618,7 +12894,7 @@ export class ScaleOutClusterRequest extends $tea.Model {
12618
12894
  *
12619
12895
  * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
12620
12896
  *
12621
- * Default value: 1.
12897
+ * Default value: 1
12622
12898
  *
12623
12899
  * @example
12624
12900
  * 1
@@ -13092,7 +13368,7 @@ export class SyncClusterNodePoolResponse extends $tea.Model {
13092
13368
  export class TagResourcesRequest extends $tea.Model {
13093
13369
  /**
13094
13370
  * @remarks
13095
- * The region ID of the resource.
13371
+ * The ID of the region in which the resource resides.
13096
13372
  *
13097
13373
  * This parameter is required.
13098
13374
  *
@@ -13109,7 +13385,7 @@ export class TagResourcesRequest extends $tea.Model {
13109
13385
  resourceIds?: string[];
13110
13386
  /**
13111
13387
  * @remarks
13112
- * The type of resource that you want to label. Set the value to `CLUSTER`.
13388
+ * The type of resources that you want to label. Valid value: `CLUSTER`.
13113
13389
  *
13114
13390
  * This parameter is required.
13115
13391
  *
@@ -13119,11 +13395,11 @@ export class TagResourcesRequest extends $tea.Model {
13119
13395
  resourceType?: string;
13120
13396
  /**
13121
13397
  * @remarks
13122
- * The labels that you want to add to the resources in key-value pairs. You can add up to 20 labels. Usage notes:
13398
+ * The tags that you want to add to the resources in key-value pairs. You can add up to 20 key-value pairs. Note:
13123
13399
  *
13124
- * * Label values must not be empty strings. A label value must be 1 to 128 characters in length.
13125
- * * The label value must not start with `aliyun` or `acs:`.
13126
- * * The label value must not contain `http://` or `https://`.
13400
+ * * The values must not be empty strings. A value must be 1 to 128 characters in length.
13401
+ * * A key or value must not start with `aliyun` or `acs:`.
13402
+ * * A key or value must not contain `http://` or `https://`.
13127
13403
  *
13128
13404
  * This parameter is required.
13129
13405
  */
@@ -14293,7 +14569,7 @@ export class UpgradeClusterAddonsRequest extends $tea.Model {
14293
14569
  export class UpgradeClusterAddonsResponseBody extends $tea.Model {
14294
14570
  /**
14295
14571
  * @remarks
14296
- * The ID of the cluster.
14572
+ * The cluster ID.
14297
14573
  *
14298
14574
  * @example
14299
14575
  * cf4299b79b3e34226abfdc80a4bda****
@@ -14301,7 +14577,7 @@ export class UpgradeClusterAddonsResponseBody extends $tea.Model {
14301
14577
  clusterId?: string;
14302
14578
  /**
14303
14579
  * @remarks
14304
- * The ID of the request.
14580
+ * The request ID.
14305
14581
  *
14306
14582
  * @example
14307
14583
  * bfd12953-31cb-42f1-8a36-7b80ec345094
@@ -14309,7 +14585,7 @@ export class UpgradeClusterAddonsResponseBody extends $tea.Model {
14309
14585
  requestId?: string;
14310
14586
  /**
14311
14587
  * @remarks
14312
- * The ID of the task.
14588
+ * The task ID.
14313
14589
  *
14314
14590
  * @example
14315
14591
  * T-62a944794ee141074400****
@@ -14398,7 +14674,7 @@ export class UpgradeClusterNodepoolRequest extends $tea.Model {
14398
14674
  runtimeType?: string;
14399
14675
  /**
14400
14676
  * @remarks
14401
- * 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.
14677
+ * 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.
14402
14678
  *
14403
14679
  * @example
14404
14680
  * 1.5.10
@@ -15464,7 +15740,25 @@ export class CheckServiceRoleResponseBodyRoles extends $tea.Model {
15464
15740
  }
15465
15741
 
15466
15742
  export class CreateClusterRequestOperationPolicyClusterAutoUpgrade extends $tea.Model {
15743
+ /**
15744
+ * @remarks
15745
+ * Cluster auto-upgrade frequency. Possible values:
15746
+ *
15747
+ * - patch
15748
+ * - stable
15749
+ * - rapid
15750
+ *
15751
+ * @example
15752
+ * patch
15753
+ */
15467
15754
  channel?: string;
15755
+ /**
15756
+ * @remarks
15757
+ * Whether to enable automatic cluster upgrades.
15758
+ *
15759
+ * @example
15760
+ * true
15761
+ */
15468
15762
  enabled?: boolean;
15469
15763
  static names(): { [key: string]: string } {
15470
15764
  return {
@@ -15486,6 +15780,10 @@ export class CreateClusterRequestOperationPolicyClusterAutoUpgrade extends $tea.
15486
15780
  }
15487
15781
 
15488
15782
  export class CreateClusterRequestOperationPolicy extends $tea.Model {
15783
+ /**
15784
+ * @remarks
15785
+ * Automatic cluster upgrade
15786
+ */
15489
15787
  clusterAutoUpgrade?: CreateClusterRequestOperationPolicyClusterAutoUpgrade;
15490
15788
  static names(): { [key: string]: string } {
15491
15789
  return {
@@ -15517,12 +15815,12 @@ export class CreateClusterRequestWorkerDataDisks extends $tea.Model {
15517
15815
  category?: string;
15518
15816
  /**
15519
15817
  * @remarks
15520
- * Specifies whether to encrypt the data disk. Valid values:
15818
+ * Specifies whether to encrypt the data disks. Valid values:
15521
15819
  *
15522
15820
  * * `true`: encrypts the data disk.
15523
15821
  * * `false`: does not encrypt the data disk.
15524
15822
  *
15525
- * Default value: `false`.
15823
+ * Default value: `false`
15526
15824
  *
15527
15825
  * @example
15528
15826
  * true
@@ -15578,7 +15876,7 @@ export class CreateClusterNodePoolRequestAutoScaling extends $tea.Model {
15578
15876
  *
15579
15877
  * **
15580
15878
  *
15581
- * **Important** This parameter is deprecated. Use internet_charge_type and internet_max_bandwidth_out.
15879
+ * **Important** This parameter is deprecated. Use the internet_charge_type and internet_max_bandwidth_out parameters instead.
15582
15880
  *
15583
15881
  * @example
15584
15882
  * 5
@@ -15599,7 +15897,7 @@ export class CreateClusterNodePoolRequestAutoScaling extends $tea.Model {
15599
15897
  *
15600
15898
  * **
15601
15899
  *
15602
- * **Important** This parameter is deprecated. Use internet_charge_type and internet_max_bandwidth_out.
15900
+ * **Important** This parameter is deprecated. Use the internet_charge_type and internet_max_bandwidth_out parameters instead.
15603
15901
  *
15604
15902
  * @example
15605
15903
  * PayByBandwidth
@@ -15633,7 +15931,7 @@ export class CreateClusterNodePoolRequestAutoScaling extends $tea.Model {
15633
15931
  *
15634
15932
  * **
15635
15933
  *
15636
- * **Important** This parameter is deprecated. Use internet_charge_type and internet_max_bandwidth_out.
15934
+ * **Important** This parameter is deprecated. Use the internet_charge_type and internet_max_bandwidth_out parameters instead.
15637
15935
  *
15638
15936
  * @example
15639
15937
  * true
@@ -15795,7 +16093,7 @@ export class CreateClusterNodePoolRequestKubernetesConfig extends $tea.Model {
15795
16093
  cmsEnabled?: boolean;
15796
16094
  /**
15797
16095
  * @remarks
15798
- * 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:
16096
+ * The CPU management policy of nodes. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
15799
16097
  *
15800
16098
  * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
15801
16099
  * * `none`: specifies that the default CPU affinity is used.
@@ -15808,12 +16106,12 @@ export class CreateClusterNodePoolRequestKubernetesConfig extends $tea.Model {
15808
16106
  cpuPolicy?: string;
15809
16107
  /**
15810
16108
  * @remarks
15811
- * The labels that you want to add to nodes in the cluster.
16109
+ * The labels that you want to add to the nodes in the cluster.
15812
16110
  */
15813
16111
  labels?: Tag[];
15814
16112
  /**
15815
16113
  * @remarks
15816
- * The custom node name. A custom node name consists of a prefix, a node IP address, and a suffix.
16114
+ * A custom node name consists of a prefix, a node IP address, and a suffix.
15817
16115
  *
15818
16116
  * * 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.
15819
16117
  * * The node IP address in a custom node name is the private IP address of the node.
@@ -15824,10 +16122,17 @@ export class CreateClusterNodePoolRequestKubernetesConfig extends $tea.Model {
15824
16122
  * customized,aliyun,ip,com
15825
16123
  */
15826
16124
  nodeNameMode?: string;
16125
+ /**
16126
+ * @remarks
16127
+ * The user-defined data of nodes. You can specify custom scripts that are automatically executed before the nodes are initialized.
16128
+ *
16129
+ * @example
16130
+ * dGhpcyBpcyBhIGV4YW1wbGU
16131
+ */
15827
16132
  preUserData?: string;
15828
16133
  /**
15829
16134
  * @remarks
15830
- * The name of the container runtime. The following types of runtime are supported by Container Service for Kubernetes (ACK):
16135
+ * The name of the container runtime. The following types of runtime are supported by ACK:
15831
16136
  *
15832
16137
  * * containerd: containerd is the recommended runtime and supports all Kubernetes versions.
15833
16138
  * * Sandboxed-Container.runv: The Sandbox-Container runtime provides improved isolation and supports Kubernetes 1.24 and earlier.
@@ -15862,7 +16167,7 @@ export class CreateClusterNodePoolRequestKubernetesConfig extends $tea.Model {
15862
16167
  unschedulable?: boolean;
15863
16168
  /**
15864
16169
  * @remarks
15865
- * The user data on the node.
16170
+ * The user-defined data of nodes. You can specify custom scripts that are automatically executed after the nodes are initialized.
15866
16171
  *
15867
16172
  * @example
15868
16173
  * dGhpcyBpcyBhIGV4YW1wbGU=
@@ -16005,9 +16310,9 @@ export class CreateClusterNodePoolRequestManagementAutoVulFixPolicy extends $tea
16005
16310
  * @remarks
16006
16311
  * The severity levels of CVEs that can be automatically patched. Separate multiple levels with commas (,). Example: `asap,later`. Valid values:
16007
16312
  *
16008
- * * `asap`: high.
16009
- * * `later`: medium.
16010
- * * `nntf`: low.
16313
+ * * `asap`: high severity.
16314
+ * * `later`: medium severity.
16315
+ * * `nntf`: low severity.
16011
16316
  *
16012
16317
  * If `auto_vul_fix` is set to true, the default value of this parameter is `asap`.
16013
16318
  *
@@ -16044,7 +16349,7 @@ export class CreateClusterNodePoolRequestManagementUpgradeConfig extends $tea.Mo
16044
16349
  *
16045
16350
  * **
16046
16351
  *
16047
- * **Caution** This parameter is deprecated. Use the preceding auto_upgrade parameter.
16352
+ * **Caution** This parameter is deprecated. Use the preceding auto_upgrade parameter instead.
16048
16353
  *
16049
16354
  * @example
16050
16355
  * false
@@ -16054,9 +16359,9 @@ export class CreateClusterNodePoolRequestManagementUpgradeConfig extends $tea.Mo
16054
16359
  autoUpgrade?: boolean;
16055
16360
  /**
16056
16361
  * @remarks
16057
- * The maximum number of unavailable nodes. Valid values: 1 to 1000.
16362
+ * The maximum number of nodes that can be in the Unavailable state. Valid values: 1 to 1000.
16058
16363
  *
16059
- * Default value: 1
16364
+ * Default value: 1.
16060
16365
  *
16061
16366
  * @example
16062
16367
  * 1
@@ -16064,7 +16369,7 @@ export class CreateClusterNodePoolRequestManagementUpgradeConfig extends $tea.Mo
16064
16369
  maxUnavailable?: number;
16065
16370
  /**
16066
16371
  * @remarks
16067
- * The number of additional nodes that are temporarily added to the node pool during an auto update.
16372
+ * The number of additional nodes.
16068
16373
  *
16069
16374
  * @example
16070
16375
  * 0
@@ -16285,7 +16590,7 @@ export class CreateClusterNodePoolRequestNodepoolInfo extends $tea.Model {
16285
16590
  export class CreateClusterNodePoolRequestScalingGroupPrivatePoolOptions extends $tea.Model {
16286
16591
  /**
16287
16592
  * @remarks
16288
- * The private node pool ID.
16593
+ * The ID of the private node pool.
16289
16594
  *
16290
16595
  * @example
16291
16596
  * eap-bp67acfmxazb4****
@@ -16295,9 +16600,9 @@ export class CreateClusterNodePoolRequestScalingGroupPrivatePoolOptions extends
16295
16600
  * @remarks
16296
16601
  * 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:
16297
16602
  *
16298
- * * `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.
16299
- * * `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.
16300
- * * `None`: does not use private pools. The resources of private node pools are not used to launch instances.
16603
+ * * `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.
16604
+ * * `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.
16605
+ * * `None`: no private pool is used. The resources of private pools are not used to launch the instances.
16301
16606
  *
16302
16607
  * @example
16303
16608
  * Open
@@ -16333,7 +16638,7 @@ export class CreateClusterNodePoolRequestScalingGroupSpotPriceLimit extends $tea
16333
16638
  instanceType?: string;
16334
16639
  /**
16335
16640
  * @remarks
16336
- * The price cap of a preemptible instance.
16641
+ * The price cap of a preemptible instance of the type.
16337
16642
  *
16338
16643
  * @example
16339
16644
  * 0.39
@@ -16420,7 +16725,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16420
16725
  autoRenewPeriod?: number;
16421
16726
  /**
16422
16727
  * @remarks
16423
- * This parameter is deprecated. Use security_hardening_os instead.
16728
+ * This parameter is deprecated. Use the security_hardening_os parameter instead.
16424
16729
  *
16425
16730
  * @example
16426
16731
  * false
@@ -16441,7 +16746,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16441
16746
  compensateWithOnDemand?: boolean;
16442
16747
  /**
16443
16748
  * @remarks
16444
- * The configurations of the data disks that are mounted to nodes in the node pool.
16749
+ * The configurations of the data disks that are attached to nodes in the node pool.
16445
16750
  */
16446
16751
  dataDisks?: DataDisk[];
16447
16752
  /**
@@ -16462,7 +16767,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16462
16767
  desiredSize?: number;
16463
16768
  /**
16464
16769
  * @remarks
16465
- * The custom image ID. By default, the image provided by ACK is used.
16770
+ * The custom image ID. By default, the image provided by Container Service for Kubernetes (ACK) is used.
16466
16771
  *
16467
16772
  * @example
16468
16773
  * aliyun_2_1903_x64_20G_alibase_20200529.vhd
@@ -16503,7 +16808,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16503
16808
  instanceChargeType?: string;
16504
16809
  /**
16505
16810
  * @remarks
16506
- * The instance attributes.
16811
+ * The instance properties.
16507
16812
  */
16508
16813
  instancePatterns?: InstancePatterns[];
16509
16814
  /**
@@ -16554,7 +16859,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16554
16859
  loginAsNonRoot?: boolean;
16555
16860
  /**
16556
16861
  * @remarks
16557
- * 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.
16862
+ * 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.
16558
16863
  *
16559
16864
  * @example
16560
16865
  * Hello1234
@@ -16566,13 +16871,13 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16566
16871
  *
16567
16872
  * * `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.
16568
16873
  *
16569
- * * `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.
16874
+ * * `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.
16570
16875
  *
16571
16876
  * **
16572
16877
  *
16573
- * **Note** `COST_OPTIMIZED` is valid only when multiple instance types are specified or at least one preemptible instance type is specified.
16878
+ * **Note** `COST_OPTIMIZED` takes effect only when multiple instance types are specified or at least one preemptible instance type is specified.
16574
16879
  *
16575
- * * `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.
16880
+ * * `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.
16576
16881
  *
16577
16882
  * Default value: `PRIORITY`.
16578
16883
  *
@@ -16582,7 +16887,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16582
16887
  multiAzPolicy?: string;
16583
16888
  /**
16584
16889
  * @remarks
16585
- * 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.
16890
+ * 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.
16586
16891
  *
16587
16892
  * @example
16588
16893
  * 0
@@ -16622,7 +16927,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16622
16927
  periodUnit?: string;
16623
16928
  /**
16624
16929
  * @remarks
16625
- * The OS distribution that is used. Valid values:
16930
+ * The operating system distribution. Valid values:
16626
16931
  *
16627
16932
  * * `CentOS`
16628
16933
  * * `AliyunLinux`
@@ -16644,7 +16949,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16644
16949
  privatePoolOptions?: CreateClusterNodePoolRequestScalingGroupPrivatePoolOptions;
16645
16950
  /**
16646
16951
  * @remarks
16647
- * The name of the worker Resource Access Management (RAM) role.
16952
+ * The name of the worker RAM role.
16648
16953
  *
16649
16954
  * * If you do not specify this parameter, the default worker RAM role created by the cluster is used.
16650
16955
  * * 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-`.
@@ -16666,7 +16971,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16666
16971
  * @remarks
16667
16972
  * The scaling mode of the scaling group. Valid values:
16668
16973
  *
16669
- * * `release`: the standard mode. ECS instances are created and released based on resource usage.
16974
+ * * `release`: the standard mode. ECS instances are created and released based on the resource usage.
16670
16975
  * * `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.
16671
16976
  *
16672
16977
  * Default value: `release`.
@@ -16702,7 +17007,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16702
17007
  securityHardeningOs?: boolean;
16703
17008
  /**
16704
17009
  * @remarks
16705
- * 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.
17010
+ * 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.
16706
17011
  *
16707
17012
  * @example
16708
17013
  * false
@@ -16718,10 +17023,10 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16718
17023
  spotInstancePools?: number;
16719
17024
  /**
16720
17025
  * @remarks
16721
- * 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:
17026
+ * 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:
16722
17027
  *
16723
- * * `true`: supplements preemptible instances.
16724
- * * `false`: does not supplement preemptible instances.
17028
+ * * `true`: enables the supplementation of preemptible instances.
17029
+ * * `false`: disables the supplementation of preemptible instances.
16725
17030
  *
16726
17031
  * @example
16727
17032
  * false
@@ -16737,10 +17042,10 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16737
17042
  * The bidding policy of preemptible instances. Valid values:
16738
17043
  *
16739
17044
  * * `NoSpot`: non-preemptible.
16740
- * * `SpotWithPriceLimit`: specifies the highest bid.
17045
+ * * `SpotWithPriceLimit`: specifies the highest bid for the preemptible instance.
16741
17046
  * * `SpotAsPriceGo`: automatically submits bids based on the up-to-date market price.
16742
17047
  *
16743
- * For more information, see [Preemptible instances](https://help.aliyun.com/document_detail/165053.html).
17048
+ * For more information, see [Use preemptible instances](https://help.aliyun.com/document_detail/165053.html).
16744
17049
  *
16745
17050
  * @example
16746
17051
  * NoSpot
@@ -16761,7 +17066,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16761
17066
  systemDiskBurstingEnabled?: boolean;
16762
17067
  /**
16763
17068
  * @remarks
16764
- * 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:
17069
+ * 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:
16765
17070
  *
16766
17071
  * * `cloud`: basic disk.
16767
17072
  * * `cloud_efficiency`: ultra disk.
@@ -16773,7 +17078,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16773
17078
  systemDiskCategories?: string[];
16774
17079
  /**
16775
17080
  * @remarks
16776
- * The system disk type. Valid values:
17081
+ * The category of the system disk for nodes. Valid values:
16777
17082
  *
16778
17083
  * * `cloud`: basic disk.
16779
17084
  * * `cloud_efficiency`: ultra disk.
@@ -16831,7 +17136,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16831
17136
  * @remarks
16832
17137
  * 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}.
16833
17138
  *
16834
- * 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).
17139
+ * 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).
16835
17140
  *
16836
17141
  * @example
16837
17142
  * 1000
@@ -16851,7 +17156,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16851
17156
  * @remarks
16852
17157
  * The labels that you want to add only to ECS instances.
16853
17158
  *
16854
- * 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://.
17159
+ * 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://.
16855
17160
  */
16856
17161
  tags?: CreateClusterNodePoolRequestScalingGroupTags[];
16857
17162
  /**
@@ -17216,7 +17521,27 @@ export class DescribeAddonsResponseBodyComponentGroups extends $tea.Model {
17216
17521
  }
17217
17522
 
17218
17523
  export class DescribeClusterDetailResponseBodyOperationPolicyClusterAutoUpgrade extends $tea.Model {
17524
+ /**
17525
+ * @remarks
17526
+ * The frequency of auto cluster updates. For more information, see [Update frequency](https://help.aliyun.com/document_detail/2712866.html).
17527
+ *
17528
+ * Valid values:
17529
+ *
17530
+ * * patch: specifies the latest patch version.
17531
+ * * stable: specifies the second-latest minor version.
17532
+ * * rapid: specifies the latest minor version.
17533
+ *
17534
+ * @example
17535
+ * patch
17536
+ */
17219
17537
  channel?: string;
17538
+ /**
17539
+ * @remarks
17540
+ * Specifies whether to enable auto cluster update.
17541
+ *
17542
+ * @example
17543
+ * true
17544
+ */
17220
17545
  enabled?: boolean;
17221
17546
  static names(): { [key: string]: string } {
17222
17547
  return {
@@ -17238,6 +17563,10 @@ export class DescribeClusterDetailResponseBodyOperationPolicyClusterAutoUpgrade
17238
17563
  }
17239
17564
 
17240
17565
  export class DescribeClusterDetailResponseBodyOperationPolicy extends $tea.Model {
17566
+ /**
17567
+ * @remarks
17568
+ * The configurations of auto cluster update.
17569
+ */
17241
17570
  clusterAutoUpgrade?: DescribeClusterDetailResponseBodyOperationPolicyClusterAutoUpgrade;
17242
17571
  static names(): { [key: string]: string } {
17243
17572
  return {
@@ -17733,6 +18062,10 @@ export class DescribeClusterNodePoolDetailResponseBodyKubernetesConfig extends $
17733
18062
  * customized,test.,5,.com
17734
18063
  */
17735
18064
  nodeNameMode?: string;
18065
+ /**
18066
+ * @remarks
18067
+ * 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).
18068
+ */
17736
18069
  preUserData?: string;
17737
18070
  /**
17738
18071
  * @remarks
@@ -17765,7 +18098,7 @@ export class DescribeClusterNodePoolDetailResponseBodyKubernetesConfig extends $
17765
18098
  unschedulable?: boolean;
17766
18099
  /**
17767
18100
  * @remarks
17768
- * The user data of the node pool. For more information, see [Generate user data](https://help.aliyun.com/document_detail/49121.html).
18101
+ * 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).
17769
18102
  *
17770
18103
  * @example
17771
18104
  * IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFDSyEi
@@ -19121,7 +19454,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsKubernetesConfig exten
19121
19454
  cpuPolicy?: string;
19122
19455
  /**
19123
19456
  * @remarks
19124
- * The labels that you want to add to the nodes in the cluster. You must add labels based on the following rules:
19457
+ * The labels that are added to the nodes in the cluster. You must add labels based on the following rules:
19125
19458
  *
19126
19459
  * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
19127
19460
  * * 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).
@@ -19140,6 +19473,13 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsKubernetesConfig exten
19140
19473
  * customized,test.,5,.com
19141
19474
  */
19142
19475
  nodeNameMode?: string;
19476
+ /**
19477
+ * @remarks
19478
+ * 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).
19479
+ *
19480
+ * @example
19481
+ * IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD
19482
+ */
19143
19483
  preUserData?: string;
19144
19484
  /**
19145
19485
  * @remarks
@@ -19159,7 +19499,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsKubernetesConfig exten
19159
19499
  runtimeVersion?: string;
19160
19500
  /**
19161
19501
  * @remarks
19162
- * 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/).
19502
+ * 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/).
19163
19503
  */
19164
19504
  taints?: Taint[];
19165
19505
  /**
@@ -19172,7 +19512,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsKubernetesConfig exten
19172
19512
  unschedulable?: boolean;
19173
19513
  /**
19174
19514
  * @remarks
19175
- * The user data of the node pool. For more information, see [Generate user-defined data](https://help.aliyun.com/document_detail/49121.html).
19515
+ * 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).
19176
19516
  *
19177
19517
  * @example
19178
19518
  * IyEvYmluL3NoCmVjaG8gIkhlbGxvIEFD****
@@ -19457,7 +19797,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsManagement extends $te
19457
19797
  export class DescribeClusterNodePoolsResponseBodyNodepoolsNodeConfig extends $tea.Model {
19458
19798
  /**
19459
19799
  * @remarks
19460
- * The parameter settings of the kubelet.
19800
+ * The configurations of the kubelet.
19461
19801
  */
19462
19802
  kubeletConfiguration?: KubeletConfig;
19463
19803
  static names(): { [key: string]: string } {
@@ -19752,7 +20092,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup extends $
19752
20092
  instanceChargeType?: string;
19753
20093
  /**
19754
20094
  * @remarks
19755
- * Instance attributes
20095
+ * The attributes of an instance.
19756
20096
  */
19757
20097
  instancePatterns?: InstancePatterns[];
19758
20098
  /**
@@ -19998,7 +20338,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup extends $
19998
20338
  systemDiskBurstingEnabled?: boolean;
19999
20339
  /**
20000
20340
  * @remarks
20001
- * 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)
20341
+ * 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).
20002
20342
  */
20003
20343
  systemDiskCategories?: string[];
20004
20344
  /**
@@ -20014,7 +20354,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup extends $
20014
20354
  systemDiskCategory?: string;
20015
20355
  /**
20016
20356
  * @remarks
20017
- * The algorithm that you want to use to encrypt the system disk. Set the value to aes-256.
20357
+ * The encryption algorithm that is used to encrypt the system disk. The value is aes-256.
20018
20358
  *
20019
20359
  * @example
20020
20360
  * aes-256
@@ -20067,7 +20407,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup extends $
20067
20407
  systemDiskSize?: number;
20068
20408
  /**
20069
20409
  * @remarks
20070
- * The tag that you want to add only to ECS instances.
20410
+ * The labels that you want to add only to Elastic Compute Service (ECS) instances.
20071
20411
  *
20072
20412
  * 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://.
20073
20413
  */
@@ -20372,7 +20712,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepools extends $tea.Model {
20372
20712
  nodepoolInfo?: DescribeClusterNodePoolsResponseBodyNodepoolsNodepoolInfo;
20373
20713
  /**
20374
20714
  * @remarks
20375
- * The configuration of the scaling group.
20715
+ * The configurations of the scaling group.
20376
20716
  */
20377
20717
  scalingGroup?: DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup;
20378
20718
  /**
@@ -21343,80 +21683,25 @@ export class DescribeClustersResponseBody extends $tea.Model {
21343
21683
  }
21344
21684
  }
21345
21685
 
21346
- export class DescribeClustersV1ResponseBodyClustersOperationPolicyClusterAutoUpgrade extends $tea.Model {
21347
- channel?: string;
21348
- enabled?: boolean;
21349
- static names(): { [key: string]: string } {
21350
- return {
21351
- channel: 'channel',
21352
- enabled: 'enabled',
21353
- };
21354
- }
21355
-
21356
- static types(): { [key: string]: any } {
21357
- return {
21358
- channel: 'string',
21359
- enabled: 'boolean',
21360
- };
21361
- }
21362
-
21363
- constructor(map?: { [key: string]: any }) {
21364
- super(map);
21365
- }
21366
- }
21367
-
21368
- export class DescribeClustersV1ResponseBodyClustersOperationPolicy extends $tea.Model {
21369
- clusterAutoUpgrade?: DescribeClustersV1ResponseBodyClustersOperationPolicyClusterAutoUpgrade;
21370
- static names(): { [key: string]: string } {
21371
- return {
21372
- clusterAutoUpgrade: 'cluster_auto_upgrade',
21373
- };
21374
- }
21375
-
21376
- static types(): { [key: string]: any } {
21377
- return {
21378
- clusterAutoUpgrade: DescribeClustersV1ResponseBodyClustersOperationPolicyClusterAutoUpgrade,
21379
- };
21380
- }
21381
-
21382
- constructor(map?: { [key: string]: any }) {
21383
- super(map);
21384
- }
21385
- }
21386
-
21387
- export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21686
+ export class DescribeClustersForRegionResponseBodyClusters extends $tea.Model {
21388
21687
  /**
21389
21688
  * @example
21390
21689
  * cluster.local
21391
21690
  */
21392
21691
  clusterDomain?: string;
21393
21692
  /**
21394
- * @remarks
21395
- * The cluster ID.
21396
- *
21397
21693
  * @example
21398
- * c3fb96524f9274b4495df0f12a6b5****
21694
+ * c905d1364c2dd4b6284a3f41790c4****
21399
21695
  */
21400
21696
  clusterId?: string;
21401
21697
  /**
21402
- * @remarks
21403
- * After you set `cluster_type` to `ManagedKubernetes` and configure the `profile` parameter, you can further specify the edition of the cluster. Valid values:
21404
- *
21405
- * * `ack.pro.small`: ACK Pro cluster.
21406
- * * `ack.standard`: ACK Basic cluster. If you leave the parameter empty, ACK Basic cluster is selected.
21407
- *
21408
21698
  * @example
21409
21699
  * ack.standard
21410
21700
  */
21411
21701
  clusterSpec?: string;
21412
21702
  /**
21413
- * @remarks
21414
- * * `Kubernetes`: ACK dedicated cluster.
21415
- * * `ManagedKubernetes`: ACK managed cluster. ACK managed clusters include ACK Basic clusters, ACK Pro clusters, ACK Serverless Basic clusters, ACK Serverless Pro clusters, ACK Edge Basic clusters, ACK Edge Pro clusters, and ACK Lingjun Pro clusters.
21416
- * * `ExternalKubernetes`: registered cluster.
21417
- *
21418
21703
  * @example
21419
- * Kubernetes
21704
+ * ManagedKubernetes
21420
21705
  */
21421
21706
  clusterType?: string;
21422
21707
  /**
@@ -21425,28 +21710,336 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21425
21710
  */
21426
21711
  containerCidr?: string;
21427
21712
  /**
21428
- * @remarks
21429
- * The time when the cluster was created.
21430
- *
21431
21713
  * @example
21432
- * 2020-08-20T10:51:29+08:00
21714
+ * 2020-12-01T20:40:40+08:00
21433
21715
  */
21434
21716
  created?: string;
21435
21717
  /**
21436
- * @remarks
21437
- * The Kubernetes version of the cluster.
21438
- *
21439
21718
  * @example
21440
- * 1.16.9-aliyun.1
21719
+ * 1.16.6-aliyun.1
21441
21720
  */
21442
21721
  currentVersion?: string;
21443
21722
  /**
21444
- * @remarks
21445
- * 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:
21446
- *
21447
- * * `true`: enables deletion protection for the cluster. This way, the cluster cannot be deleted in the ACK console or by calling API operations.
21448
- * * `false`: disables deletion protection for the cluster. This way, the cluster can be deleted in the ACK console or by calling API operations.
21449
- *
21723
+ * @example
21724
+ * false
21725
+ */
21726
+ deletionProtection?: boolean;
21727
+ /**
21728
+ * @example
21729
+ * 1.16.6-aliyun.1
21730
+ */
21731
+ initVersion?: string;
21732
+ /**
21733
+ * @example
21734
+ * ipv4
21735
+ */
21736
+ ipStack?: string;
21737
+ /**
21738
+ * @example
21739
+ * test-cluster
21740
+ */
21741
+ name?: string;
21742
+ /**
21743
+ * @example
21744
+ * 1.18.8-aliyun.1
21745
+ */
21746
+ nextVersion?: string;
21747
+ /**
21748
+ * @example
21749
+ * Default
21750
+ */
21751
+ profile?: string;
21752
+ /**
21753
+ * @example
21754
+ * ipvs
21755
+ */
21756
+ proxyMode?: string;
21757
+ /**
21758
+ * @example
21759
+ * cn-beijing-a
21760
+ */
21761
+ regionId?: string;
21762
+ /**
21763
+ * @example
21764
+ * rg-acfmyvw3wjm****
21765
+ */
21766
+ resourceGroupId?: string;
21767
+ /**
21768
+ * @example
21769
+ * sg-2zeihch86ooz9io4****
21770
+ */
21771
+ securityGroupId?: string;
21772
+ /**
21773
+ * @remarks
21774
+ * This parameter is required.
21775
+ *
21776
+ * @example
21777
+ * 172.21.0.0/20
21778
+ */
21779
+ serviceCidr?: string;
21780
+ /**
21781
+ * @example
21782
+ * 2
21783
+ */
21784
+ size?: number;
21785
+ /**
21786
+ * @example
21787
+ * running
21788
+ */
21789
+ state?: string;
21790
+ tags?: Tag[];
21791
+ /**
21792
+ * @example
21793
+ * Asia/Shanghai
21794
+ */
21795
+ timezone?: string;
21796
+ /**
21797
+ * @example
21798
+ * 2020-12-08T15:37:00+08:00
21799
+ */
21800
+ updated?: string;
21801
+ /**
21802
+ * @example
21803
+ * vpc-2zeg8nf1ukc0fcmvq****
21804
+ */
21805
+ vpcId?: string;
21806
+ vswitchIds?: string[];
21807
+ static names(): { [key: string]: string } {
21808
+ return {
21809
+ clusterDomain: 'cluster_domain',
21810
+ clusterId: 'cluster_id',
21811
+ clusterSpec: 'cluster_spec',
21812
+ clusterType: 'cluster_type',
21813
+ containerCidr: 'container_cidr',
21814
+ created: 'created',
21815
+ currentVersion: 'current_version',
21816
+ deletionProtection: 'deletion_protection',
21817
+ initVersion: 'init_version',
21818
+ ipStack: 'ip_stack',
21819
+ name: 'name',
21820
+ nextVersion: 'next_version',
21821
+ profile: 'profile',
21822
+ proxyMode: 'proxy_mode',
21823
+ regionId: 'region_id',
21824
+ resourceGroupId: 'resource_group_id',
21825
+ securityGroupId: 'security_group_id',
21826
+ serviceCidr: 'service_cidr',
21827
+ size: 'size',
21828
+ state: 'state',
21829
+ tags: 'tags',
21830
+ timezone: 'timezone',
21831
+ updated: 'updated',
21832
+ vpcId: 'vpc_id',
21833
+ vswitchIds: 'vswitch_ids',
21834
+ };
21835
+ }
21836
+
21837
+ static types(): { [key: string]: any } {
21838
+ return {
21839
+ clusterDomain: 'string',
21840
+ clusterId: 'string',
21841
+ clusterSpec: 'string',
21842
+ clusterType: 'string',
21843
+ containerCidr: 'string',
21844
+ created: 'string',
21845
+ currentVersion: 'string',
21846
+ deletionProtection: 'boolean',
21847
+ initVersion: 'string',
21848
+ ipStack: 'string',
21849
+ name: 'string',
21850
+ nextVersion: 'string',
21851
+ profile: 'string',
21852
+ proxyMode: 'string',
21853
+ regionId: 'string',
21854
+ resourceGroupId: 'string',
21855
+ securityGroupId: 'string',
21856
+ serviceCidr: 'string',
21857
+ size: 'number',
21858
+ state: 'string',
21859
+ tags: { 'type': 'array', 'itemType': Tag },
21860
+ timezone: 'string',
21861
+ updated: 'string',
21862
+ vpcId: 'string',
21863
+ vswitchIds: { 'type': 'array', 'itemType': 'string' },
21864
+ };
21865
+ }
21866
+
21867
+ constructor(map?: { [key: string]: any }) {
21868
+ super(map);
21869
+ }
21870
+ }
21871
+
21872
+ export class DescribeClustersForRegionResponseBodyPageInfo extends $tea.Model {
21873
+ /**
21874
+ * @example
21875
+ * 1
21876
+ */
21877
+ pageNumber?: number;
21878
+ /**
21879
+ * @example
21880
+ * 10
21881
+ */
21882
+ pageSize?: number;
21883
+ /**
21884
+ * @example
21885
+ * 10
21886
+ */
21887
+ totalCount?: number;
21888
+ static names(): { [key: string]: string } {
21889
+ return {
21890
+ pageNumber: 'page_number',
21891
+ pageSize: 'page_size',
21892
+ totalCount: 'total_count',
21893
+ };
21894
+ }
21895
+
21896
+ static types(): { [key: string]: any } {
21897
+ return {
21898
+ pageNumber: 'number',
21899
+ pageSize: 'number',
21900
+ totalCount: 'number',
21901
+ };
21902
+ }
21903
+
21904
+ constructor(map?: { [key: string]: any }) {
21905
+ super(map);
21906
+ }
21907
+ }
21908
+
21909
+ export class DescribeClustersV1ResponseBodyClustersOperationPolicyClusterAutoUpgrade extends $tea.Model {
21910
+ /**
21911
+ * @remarks
21912
+ * The frequency of auto cluster updates. For more information, see [Update frequency](https://help.aliyun.com/document_detail/2712866.html).
21913
+ *
21914
+ * Valid values:
21915
+ *
21916
+ * * patch: the latest patch version.
21917
+ * * stables: the second-latest minor version.
21918
+ * * rapid: the latest minor version.
21919
+ *
21920
+ * @example
21921
+ * patch
21922
+ */
21923
+ channel?: string;
21924
+ /**
21925
+ * @remarks
21926
+ * Specifies whether to enable auto cluster update.
21927
+ *
21928
+ * @example
21929
+ * true
21930
+ */
21931
+ enabled?: boolean;
21932
+ static names(): { [key: string]: string } {
21933
+ return {
21934
+ channel: 'channel',
21935
+ enabled: 'enabled',
21936
+ };
21937
+ }
21938
+
21939
+ static types(): { [key: string]: any } {
21940
+ return {
21941
+ channel: 'string',
21942
+ enabled: 'boolean',
21943
+ };
21944
+ }
21945
+
21946
+ constructor(map?: { [key: string]: any }) {
21947
+ super(map);
21948
+ }
21949
+ }
21950
+
21951
+ export class DescribeClustersV1ResponseBodyClustersOperationPolicy extends $tea.Model {
21952
+ /**
21953
+ * @remarks
21954
+ * The configurations of auto cluster update.
21955
+ */
21956
+ clusterAutoUpgrade?: DescribeClustersV1ResponseBodyClustersOperationPolicyClusterAutoUpgrade;
21957
+ static names(): { [key: string]: string } {
21958
+ return {
21959
+ clusterAutoUpgrade: 'cluster_auto_upgrade',
21960
+ };
21961
+ }
21962
+
21963
+ static types(): { [key: string]: any } {
21964
+ return {
21965
+ clusterAutoUpgrade: DescribeClustersV1ResponseBodyClustersOperationPolicyClusterAutoUpgrade,
21966
+ };
21967
+ }
21968
+
21969
+ constructor(map?: { [key: string]: any }) {
21970
+ super(map);
21971
+ }
21972
+ }
21973
+
21974
+ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21975
+ /**
21976
+ * @remarks
21977
+ * The domain name of the cluster.
21978
+ *
21979
+ * @example
21980
+ * cluster.local
21981
+ */
21982
+ clusterDomain?: string;
21983
+ /**
21984
+ * @remarks
21985
+ * The cluster ID.
21986
+ *
21987
+ * @example
21988
+ * c3fb96524f9274b4495df0f12a6b5****
21989
+ */
21990
+ clusterId?: string;
21991
+ /**
21992
+ * @remarks
21993
+ * After you set `cluster_type` to `ManagedKubernetes` and configure the `profile` parameter, you can further specify the edition of the cluster. Valid values:
21994
+ *
21995
+ * * `ack.pro.small`: ACK Pro cluster.
21996
+ * * `ack.standard`: ACK Basic cluster. If you leave the parameter empty, ACK Basic cluster is selected.
21997
+ *
21998
+ * @example
21999
+ * ack.standard
22000
+ */
22001
+ clusterSpec?: string;
22002
+ /**
22003
+ * @remarks
22004
+ * * `Kubernetes`: ACK dedicated cluster.
22005
+ * * `ManagedKubernetes`: ACK managed cluster. ACK managed clusters include ACK Basic clusters, ACK Pro clusters, ACK Serverless Basic clusters, ACK Serverless Pro clusters, ACK Edge Basic clusters, ACK Edge Pro clusters, and ACK Lingjun Pro clusters.
22006
+ * * `ExternalKubernetes`: registered cluster.
22007
+ *
22008
+ * @example
22009
+ * Kubernetes
22010
+ */
22011
+ clusterType?: string;
22012
+ /**
22013
+ * @remarks
22014
+ * The pod CIDR block.
22015
+ *
22016
+ * @example
22017
+ * 172.20.0.0/16
22018
+ */
22019
+ containerCidr?: string;
22020
+ /**
22021
+ * @remarks
22022
+ * The time when the cluster was created.
22023
+ *
22024
+ * @example
22025
+ * 2020-08-20T10:51:29+08:00
22026
+ */
22027
+ created?: string;
22028
+ /**
22029
+ * @remarks
22030
+ * The Kubernetes version of the cluster.
22031
+ *
22032
+ * @example
22033
+ * 1.16.9-aliyun.1
22034
+ */
22035
+ currentVersion?: string;
22036
+ /**
22037
+ * @remarks
22038
+ * 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:
22039
+ *
22040
+ * * `true`: enables deletion protection for the cluster. This way, the cluster cannot be deleted in the ACK console or by calling API operations.
22041
+ * * `false`: disables deletion protection for the cluster. This way, the cluster can be deleted in the ACK console or by calling API operations.
22042
+ *
21450
22043
  * @example
21451
22044
  * true
21452
22045
  */
@@ -21480,6 +22073,12 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21480
22073
  */
21481
22074
  initVersion?: string;
21482
22075
  /**
22076
+ * @remarks
22077
+ * The IP stack of the cluster. Valid values:
22078
+ *
22079
+ * * ipv4: The cluster is an IPv4 cluster.
22080
+ * * dual: The cluster is a dual-stack cluster.
22081
+ *
21483
22082
  * @example
21484
22083
  * ipv4
21485
22084
  */
@@ -21536,6 +22135,10 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21536
22135
  * 1.18.8-aliyun.1
21537
22136
  */
21538
22137
  nextVersion?: string;
22138
+ /**
22139
+ * @remarks
22140
+ * The automatic O\\&M policy of the cluster.
22141
+ */
21539
22142
  operationPolicy?: DescribeClustersV1ResponseBodyClustersOperationPolicy;
21540
22143
  /**
21541
22144
  * @remarks
@@ -21562,6 +22165,9 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21562
22165
  */
21563
22166
  profile?: string;
21564
22167
  /**
22168
+ * @remarks
22169
+ * The kube-proxy mode. Valid values: ipvs and iptables.
22170
+ *
21565
22171
  * @example
21566
22172
  * ipvs
21567
22173
  */
@@ -21592,6 +22198,8 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21592
22198
  securityGroupId?: string;
21593
22199
  /**
21594
22200
  * @remarks
22201
+ * The Service CIDR block.
22202
+ *
21595
22203
  * This parameter is required.
21596
22204
  *
21597
22205
  * @example
@@ -21600,7 +22208,7 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21600
22208
  serviceCidr?: string;
21601
22209
  /**
21602
22210
  * @remarks
21603
- * The number of nodes in the cluster, including master nodes and worker nodes.
22211
+ * The number of nodes in the cluster, including control planes and worker nodes.
21604
22212
  *
21605
22213
  * @example
21606
22214
  * 5
@@ -21635,7 +22243,7 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21635
22243
  *
21636
22244
  * 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.
21637
22245
  *
21638
- * 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).
22246
+ * 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).
21639
22247
  *
21640
22248
  * @example
21641
22249
  * 172.21.0.0/16
@@ -21649,6 +22257,9 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21649
22257
  */
21650
22258
  tags?: Tag[];
21651
22259
  /**
22260
+ * @remarks
22261
+ * The time zone.
22262
+ *
21652
22263
  * @example
21653
22264
  * Asia/Shanghai
21654
22265
  */
@@ -21671,7 +22282,7 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21671
22282
  vpcId?: string;
21672
22283
  /**
21673
22284
  * @remarks
21674
- * 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.
22285
+ * 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.
21675
22286
  *
21676
22287
  * @example
21677
22288
  * vsw-2vc41xuumx5z2rdma****,vsw-2vc41xuumx5z2rdma****
@@ -21679,6 +22290,10 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21679
22290
  * @deprecated
21680
22291
  */
21681
22292
  vswitchId?: string;
22293
+ /**
22294
+ * @remarks
22295
+ * The vSwitches of the control planes.
22296
+ */
21682
22297
  vswitchIds?: string[];
21683
22298
  /**
21684
22299
  * @remarks
@@ -22025,16 +22640,213 @@ export class DescribeEdgeMachinesResponseBodyEdgeMachines extends $tea.Model {
22025
22640
 
22026
22641
  static types(): { [key: string]: any } {
22027
22642
  return {
22028
- activeTime: 'string',
22029
- created: 'string',
22030
- edgeMachineId: 'string',
22031
- hostname: 'string',
22032
- lifeState: 'string',
22033
- model: 'string',
22034
- name: 'string',
22035
- onlineState: 'string',
22036
- sn: 'string',
22037
- updated: 'string',
22643
+ activeTime: 'string',
22644
+ created: 'string',
22645
+ edgeMachineId: 'string',
22646
+ hostname: 'string',
22647
+ lifeState: 'string',
22648
+ model: 'string',
22649
+ name: 'string',
22650
+ onlineState: 'string',
22651
+ sn: 'string',
22652
+ updated: 'string',
22653
+ };
22654
+ }
22655
+
22656
+ constructor(map?: { [key: string]: any }) {
22657
+ super(map);
22658
+ }
22659
+ }
22660
+
22661
+ export class DescribeEdgeMachinesResponseBodyPageInfo extends $tea.Model {
22662
+ /**
22663
+ * @remarks
22664
+ * The page number.
22665
+ *
22666
+ * Default value: 1.
22667
+ *
22668
+ * @example
22669
+ * 1
22670
+ */
22671
+ pageNumber?: number;
22672
+ /**
22673
+ * @remarks
22674
+ * The number of entries per page.
22675
+ *
22676
+ * Default value: 10.
22677
+ *
22678
+ * @example
22679
+ * 10
22680
+ */
22681
+ pageSize?: number;
22682
+ /**
22683
+ * @remarks
22684
+ * The total number of pages returned.
22685
+ *
22686
+ * @example
22687
+ * 1
22688
+ */
22689
+ totalCount?: number;
22690
+ static names(): { [key: string]: string } {
22691
+ return {
22692
+ pageNumber: 'page_number',
22693
+ pageSize: 'page_size',
22694
+ totalCount: 'total_count',
22695
+ };
22696
+ }
22697
+
22698
+ static types(): { [key: string]: any } {
22699
+ return {
22700
+ pageNumber: 'number',
22701
+ pageSize: 'number',
22702
+ totalCount: 'number',
22703
+ };
22704
+ }
22705
+
22706
+ constructor(map?: { [key: string]: any }) {
22707
+ super(map);
22708
+ }
22709
+ }
22710
+
22711
+ export class DescribeEventsResponseBodyEventsData extends $tea.Model {
22712
+ /**
22713
+ * @remarks
22714
+ * The severity level of the event. Valid values:
22715
+ *
22716
+ * * info
22717
+ * * warning
22718
+ * * error
22719
+ *
22720
+ * @example
22721
+ * info
22722
+ */
22723
+ level?: string;
22724
+ /**
22725
+ * @remarks
22726
+ * The details of the event.
22727
+ *
22728
+ * @example
22729
+ * Start to upgrade NodePool nodePool/nodePool-A
22730
+ */
22731
+ message?: string;
22732
+ /**
22733
+ * @remarks
22734
+ * The status of the event.
22735
+ *
22736
+ * @example
22737
+ * Started
22738
+ */
22739
+ reason?: string;
22740
+ static names(): { [key: string]: string } {
22741
+ return {
22742
+ level: 'level',
22743
+ message: 'message',
22744
+ reason: 'reason',
22745
+ };
22746
+ }
22747
+
22748
+ static types(): { [key: string]: any } {
22749
+ return {
22750
+ level: 'string',
22751
+ message: 'string',
22752
+ reason: 'string',
22753
+ };
22754
+ }
22755
+
22756
+ constructor(map?: { [key: string]: any }) {
22757
+ super(map);
22758
+ }
22759
+ }
22760
+
22761
+ export class DescribeEventsResponseBodyEvents extends $tea.Model {
22762
+ /**
22763
+ * @remarks
22764
+ * The ID of the cluster.
22765
+ *
22766
+ * @example
22767
+ * cluster-id
22768
+ */
22769
+ clusterId?: string;
22770
+ /**
22771
+ * @remarks
22772
+ * The description of the event.
22773
+ */
22774
+ data?: DescribeEventsResponseBodyEventsData;
22775
+ /**
22776
+ * @remarks
22777
+ * The event ID.
22778
+ *
22779
+ * @example
22780
+ * A234-1234-1234
22781
+ */
22782
+ eventId?: string;
22783
+ /**
22784
+ * @remarks
22785
+ * The source of the event.
22786
+ */
22787
+ source?: string;
22788
+ /**
22789
+ * @remarks
22790
+ * The subject of the event.
22791
+ *
22792
+ * @example
22793
+ * nodePool-id
22794
+ */
22795
+ subject?: string;
22796
+ /**
22797
+ * @remarks
22798
+ * The time when the event started.
22799
+ *
22800
+ * @example
22801
+ * 2022-11-23T20:48:01+08:00
22802
+ */
22803
+ time?: string;
22804
+ /**
22805
+ * @remarks
22806
+ * The event type. Valid values:
22807
+ *
22808
+ * * `cluster_create`: cluster creation.
22809
+ * * `cluster_scaleout`: cluster scale-out.
22810
+ * * `cluster_attach`: node addition.
22811
+ * * `cluster_delete`: cluster deletion.
22812
+ * * `cluster_upgrade`: cluster upgrades.
22813
+ * * `cluster_migrate`: cluster migration.
22814
+ * * `cluster_node_delete`: node removal.
22815
+ * * `cluster_node_drain`: node draining.
22816
+ * * `cluster_modify`: cluster modifications.
22817
+ * * `cluster_configuration_modify`: modifications of control plane configurations.
22818
+ * * `cluster_addon_install`: component installation.
22819
+ * * `cluster_addon_upgrade`: component updates.
22820
+ * * `cluster_addon_uninstall`: component uninstallation.
22821
+ * * `runtime_upgrade`: runtime updates.
22822
+ * * `nodepool_upgrade`: node pool upgrades.
22823
+ * * `nodepool_update`: node pool updates.
22824
+ *
22825
+ * @example
22826
+ * nodepool_upgrade
22827
+ */
22828
+ type?: string;
22829
+ static names(): { [key: string]: string } {
22830
+ return {
22831
+ clusterId: 'cluster_id',
22832
+ data: 'data',
22833
+ eventId: 'event_id',
22834
+ source: 'source',
22835
+ subject: 'subject',
22836
+ time: 'time',
22837
+ type: 'type',
22838
+ };
22839
+ }
22840
+
22841
+ static types(): { [key: string]: any } {
22842
+ return {
22843
+ clusterId: 'string',
22844
+ data: DescribeEventsResponseBodyEventsData,
22845
+ eventId: 'string',
22846
+ source: 'string',
22847
+ subject: 'string',
22848
+ time: 'string',
22849
+ type: 'string',
22038
22850
  };
22039
22851
  }
22040
22852
 
@@ -22043,13 +22855,11 @@ export class DescribeEdgeMachinesResponseBodyEdgeMachines extends $tea.Model {
22043
22855
  }
22044
22856
  }
22045
22857
 
22046
- export class DescribeEdgeMachinesResponseBodyPageInfo extends $tea.Model {
22858
+ export class DescribeEventsResponseBodyPageInfo extends $tea.Model {
22047
22859
  /**
22048
22860
  * @remarks
22049
22861
  * The page number.
22050
22862
  *
22051
- * Default value: 1.
22052
- *
22053
22863
  * @example
22054
22864
  * 1
22055
22865
  */
@@ -22058,18 +22868,16 @@ export class DescribeEdgeMachinesResponseBodyPageInfo extends $tea.Model {
22058
22868
  * @remarks
22059
22869
  * The number of entries per page.
22060
22870
  *
22061
- * Default value: 10.
22062
- *
22063
22871
  * @example
22064
- * 10
22872
+ * 50
22065
22873
  */
22066
22874
  pageSize?: number;
22067
22875
  /**
22068
22876
  * @remarks
22069
- * The total number of pages returned.
22877
+ * The total number of entries returned.
22070
22878
  *
22071
22879
  * @example
22072
- * 1
22880
+ * 3
22073
22881
  */
22074
22882
  totalCount?: number;
22075
22883
  static names(): { [key: string]: string } {
@@ -22093,27 +22901,18 @@ export class DescribeEdgeMachinesResponseBodyPageInfo extends $tea.Model {
22093
22901
  }
22094
22902
  }
22095
22903
 
22096
- export class DescribeEventsResponseBodyEventsData extends $tea.Model {
22904
+ export class DescribeEventsForRegionResponseBodyEventsData extends $tea.Model {
22097
22905
  /**
22098
- * @remarks
22099
- * The severity level of the event.
22100
- *
22101
22906
  * @example
22102
22907
  * info
22103
22908
  */
22104
22909
  level?: string;
22105
22910
  /**
22106
- * @remarks
22107
- * The details of the event.
22108
- *
22109
22911
  * @example
22110
22912
  * Start to upgrade NodePool nodePool/nodePool-A
22111
22913
  */
22112
22914
  message?: string;
22113
22915
  /**
22114
- * @remarks
22115
- * The status of the event.
22116
- *
22117
22916
  * @example
22118
22917
  * Started
22119
22918
  */
@@ -22139,72 +22938,32 @@ export class DescribeEventsResponseBodyEventsData extends $tea.Model {
22139
22938
  }
22140
22939
  }
22141
22940
 
22142
- export class DescribeEventsResponseBodyEvents extends $tea.Model {
22941
+ export class DescribeEventsForRegionResponseBodyEvents extends $tea.Model {
22143
22942
  /**
22144
- * @remarks
22145
- * The ID of the cluster.
22146
- *
22147
22943
  * @example
22148
22944
  * cluster-id
22149
22945
  */
22150
22946
  clusterId?: string;
22947
+ data?: DescribeEventsForRegionResponseBodyEventsData;
22151
22948
  /**
22152
- * @remarks
22153
- * The description of the event.
22154
- */
22155
- data?: DescribeEventsResponseBodyEventsData;
22156
- /**
22157
- * @remarks
22158
- * The event ID.
22159
- *
22160
22949
  * @example
22161
22950
  * A234-1234-1234
22162
22951
  */
22163
22952
  eventId?: string;
22164
- /**
22165
- * @remarks
22166
- * The source of the event.
22167
- */
22168
22953
  source?: string;
22169
22954
  /**
22170
- * @remarks
22171
- * The subject of the event.
22172
- *
22173
22955
  * @example
22174
22956
  * nodePool-id
22175
22957
  */
22176
22958
  subject?: string;
22177
22959
  /**
22178
- * @remarks
22179
- * The time when the event started.
22180
- *
22181
22960
  * @example
22182
- * 2022-11-23T20:48:01+08:00
22961
+ * 2020-12-01T17:31:00Z
22183
22962
  */
22184
22963
  time?: string;
22185
22964
  /**
22186
- * @remarks
22187
- * The event type. Valid values:
22188
- *
22189
- * * `cluster_create`: cluster creation.
22190
- * * `cluster_scaleout`: cluster scale-out.
22191
- * * `cluster_attach`: node addition.
22192
- * * `cluster_delete`: cluster deletion.
22193
- * * `cluster_upgrade`: cluster upgrades.
22194
- * * `cluster_migrate`: cluster migration.
22195
- * * `cluster_node_delete`: node removal.
22196
- * * `cluster_node_drain`: node draining.
22197
- * * `cluster_modify`: cluster modifications.
22198
- * * `cluster_configuration_modify`: modifications of control plane configurations.
22199
- * * `cluster_addon_install`: component installation.
22200
- * * `cluster_addon_upgrade`: component updates.
22201
- * * `cluster_addon_uninstall`: component uninstallation.
22202
- * * `runtime_upgrade`: runtime updates.
22203
- * * `nodepool_upgrade`: node pool upgrades.
22204
- * * `nodepool_update`: node pool updates.
22205
- *
22206
22965
  * @example
22207
- * nodepool_upgrade
22966
+ * nodePool_upgrade
22208
22967
  */
22209
22968
  type?: string;
22210
22969
  static names(): { [key: string]: string } {
@@ -22222,7 +22981,7 @@ export class DescribeEventsResponseBodyEvents extends $tea.Model {
22222
22981
  static types(): { [key: string]: any } {
22223
22982
  return {
22224
22983
  clusterId: 'string',
22225
- data: DescribeEventsResponseBodyEventsData,
22984
+ data: DescribeEventsForRegionResponseBodyEventsData,
22226
22985
  eventId: 'string',
22227
22986
  source: 'string',
22228
22987
  subject: 'string',
@@ -22236,27 +22995,18 @@ export class DescribeEventsResponseBodyEvents extends $tea.Model {
22236
22995
  }
22237
22996
  }
22238
22997
 
22239
- export class DescribeEventsResponseBodyPageInfo extends $tea.Model {
22998
+ export class DescribeEventsForRegionResponseBodyPageInfo extends $tea.Model {
22240
22999
  /**
22241
- * @remarks
22242
- * The page number.
22243
- *
22244
23000
  * @example
22245
23001
  * 1
22246
23002
  */
22247
23003
  pageNumber?: number;
22248
23004
  /**
22249
- * @remarks
22250
- * The number of entries per page.
22251
- *
22252
23005
  * @example
22253
23006
  * 50
22254
23007
  */
22255
23008
  pageSize?: number;
22256
23009
  /**
22257
- * @remarks
22258
- * The total number of entries returned.
22259
- *
22260
23010
  * @example
22261
23011
  * 3
22262
23012
  */
@@ -22531,6 +23281,9 @@ export class DescribeNodePoolVulsResponseBodyVulRecordsVulList extends $tea.Mode
22531
23281
  /**
22532
23282
  * @remarks
22533
23283
  * Indicates whether a restart is required.
23284
+ *
23285
+ * @example
23286
+ * false
22534
23287
  */
22535
23288
  needReboot?: boolean;
22536
23289
  static names(): { [key: string]: string } {
@@ -25201,9 +25954,9 @@ export class ListUserKubeConfigStatesResponseBodyStates extends $tea.Model {
25201
25954
  clusterId?: string;
25202
25955
  /**
25203
25956
  * @remarks
25204
- * The cluster name.
25957
+ * The name of the cluster.
25205
25958
  *
25206
- * The name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). The name cannot start with a hyphen (-).
25959
+ * 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.
25207
25960
  *
25208
25961
  * @example
25209
25962
  * cluster-demo
@@ -25219,8 +25972,6 @@ export class ListUserKubeConfigStatesResponseBodyStates extends $tea.Model {
25219
25972
  * * `updating`: The cluster is being upgraded.
25220
25973
  * * `updating_failed`: The cluster failed to be updated.
25221
25974
  * * `scaling`: The cluster is being scaled.
25222
- * * `waiting`: The cluster is waiting for connection requests.
25223
- * * `disconnected`: The cluster is disconnected.
25224
25975
  * * `stopped`: The cluster is stopped.
25225
25976
  * * `deleting`: The cluster is being deleted.
25226
25977
  * * `deleted`: The cluster is deleted.
@@ -25490,7 +26241,7 @@ export class ModifyClusterNodePoolRequestAutoScaling extends $tea.Model {
25490
26241
  * Specifies whether to enable auto scaling. Valid values:
25491
26242
  *
25492
26243
  * * `true`: enables auto scaling for the node pool.
25493
- * * `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.
26244
+ * * `false`: disables auto scaling for the node pool. If you set this parameter to false, other parameters in `auto_scaling` do not take effect.
25494
26245
  *
25495
26246
  * Default value: `false`.
25496
26247
  *
@@ -25531,7 +26282,7 @@ export class ModifyClusterNodePoolRequestAutoScaling extends $tea.Model {
25531
26282
  minInstances?: number;
25532
26283
  /**
25533
26284
  * @remarks
25534
- * The instance types that can be used for the auto scaling of the node pool. Valid values:
26285
+ * The instance type that is used for auto scaling. Valid values:
25535
26286
  *
25536
26287
  * * `cpu`: regular instance.
25537
26288
  * * `gpu`: GPU-accelerated instance.
@@ -25591,7 +26342,7 @@ export class ModifyClusterNodePoolRequestKubernetesConfig extends $tea.Model {
25591
26342
  cmsEnabled?: boolean;
25592
26343
  /**
25593
26344
  * @remarks
25594
- * 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:
26345
+ * The CPU management policy of nodes. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
25595
26346
  *
25596
26347
  * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
25597
26348
  * * `none`: specifies that the default CPU affinity is used.
@@ -25610,6 +26361,13 @@ export class ModifyClusterNodePoolRequestKubernetesConfig extends $tea.Model {
25610
26361
  * * 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).
25611
26362
  */
25612
26363
  labels?: Tag[];
26364
+ /**
26365
+ * @remarks
26366
+ * 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).
26367
+ *
26368
+ * @example
26369
+ * IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi
26370
+ */
25613
26371
  preUserData?: string;
25614
26372
  /**
25615
26373
  * @remarks
@@ -25642,7 +26400,7 @@ export class ModifyClusterNodePoolRequestKubernetesConfig extends $tea.Model {
25642
26400
  unschedulable?: boolean;
25643
26401
  /**
25644
26402
  * @remarks
25645
- * The user data of the node pool. For more information, see [Prepare user data](https://help.aliyun.com/document_detail/49121.html).
26403
+ * 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).
25646
26404
  *
25647
26405
  * @example
25648
26406
  * IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi
@@ -25824,7 +26582,7 @@ export class ModifyClusterNodePoolRequestManagementUpgradeConfig extends $tea.Mo
25824
26582
  *
25825
26583
  * Valid values: 1 to 1000.
25826
26584
  *
25827
- * Default value: 1
26585
+ * Default value: 1.
25828
26586
  *
25829
26587
  * @example
25830
26588
  * 1
@@ -25892,7 +26650,7 @@ export class ModifyClusterNodePoolRequestManagement extends $tea.Model {
25892
26650
  autoRepairPolicy?: ModifyClusterNodePoolRequestManagementAutoRepairPolicy;
25893
26651
  /**
25894
26652
  * @remarks
25895
- * Specifies whether to enable auto update. Valid values:
26653
+ * Indicates whether auto update is enabled. Valid values:
25896
26654
  *
25897
26655
  * * `true`: enables auto update.
25898
26656
  * * `false`: disables auto update.
@@ -26054,7 +26812,7 @@ export class ModifyClusterNodePoolRequestScalingGroupPrivatePoolOptions extends
26054
26812
  export class ModifyClusterNodePoolRequestScalingGroupSpotPriceLimit extends $tea.Model {
26055
26813
  /**
26056
26814
  * @remarks
26057
- * The instance type of preemptible instances.
26815
+ * The price cap of a preemptible instance.
26058
26816
  *
26059
26817
  * @example
26060
26818
  * ecs.c6.large
@@ -26117,7 +26875,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26117
26875
  * @remarks
26118
26876
  * 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:
26119
26877
  *
26120
- * * `true`: automatically creates pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created
26878
+ * * `true`: automatically creates pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created.
26121
26879
  * * `false`: does not create pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created.
26122
26880
  *
26123
26881
  * @example
@@ -26188,10 +26946,10 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26188
26946
  instanceTypes?: string[];
26189
26947
  /**
26190
26948
  * @remarks
26191
- * The billing method of the public IP address. Valid values:
26949
+ * The metering method of the public IP address. Valid values:
26192
26950
  *
26193
26951
  * * `PayByBandwidth`: pay-by-bandwidth.
26194
- * * `PayByTraffic`: pay-by-data-transfer.
26952
+ * * `PayByTraffic`: pay-by-data-transfer
26195
26953
  *
26196
26954
  * @example
26197
26955
  * PayByBandwidth
@@ -26207,7 +26965,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26207
26965
  internetMaxBandwidthOut?: number;
26208
26966
  /**
26209
26967
  * @remarks
26210
- * 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.
26968
+ * 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.
26211
26969
  *
26212
26970
  * @example
26213
26971
  * pro-nodepool
@@ -26215,7 +26973,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26215
26973
  keyPair?: string;
26216
26974
  /**
26217
26975
  * @remarks
26218
- * 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.
26976
+ * 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.
26219
26977
  *
26220
26978
  * @example
26221
26979
  * Hello1234
@@ -26296,12 +27054,12 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26296
27054
  platform?: string;
26297
27055
  /**
26298
27056
  * @remarks
26299
- * The configurations of the private node pool.
27057
+ * The configuration of the private node pool.
26300
27058
  */
26301
27059
  privatePoolOptions?: ModifyClusterNodePoolRequestScalingGroupPrivatePoolOptions;
26302
27060
  /**
26303
27061
  * @remarks
26304
- * A list of ApsaraDB RDS instances.
27062
+ * The ApsaraDB RDS instances.
26305
27063
  */
26306
27064
  rdsInstances?: string[];
26307
27065
  /**
@@ -26368,10 +27126,10 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26368
27126
  systemDiskCategories?: string[];
26369
27127
  /**
26370
27128
  * @remarks
26371
- * The type of the system disk. Valid values:
27129
+ * The type of system disk. Valid values:
26372
27130
  *
26373
27131
  * * `cloud_efficiency`: ultra disk.
26374
- * * `cloud_ssd`: standard SSD.
27132
+ * * `cloud_ssd`: standard SSD
26375
27133
  *
26376
27134
  * Default value: `cloud_ssd`.
26377
27135
  *
@@ -26381,7 +27139,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26381
27139
  systemDiskCategory?: string;
26382
27140
  /**
26383
27141
  * @remarks
26384
- * The encryption algorithm that is used by the system disk. Set the value to aes-256.
27142
+ * The encryption algorithm that is used by the system disk. The value is aes-256.
26385
27143
  *
26386
27144
  * @example
26387
27145
  * aes-256
@@ -26389,7 +27147,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26389
27147
  systemDiskEncryptAlgorithm?: string;
26390
27148
  /**
26391
27149
  * @remarks
26392
- * Specifies whether to encrypt the system disk. Valid values: true: encrypts the system disk. false: does not encrypt the system disk.
27150
+ * Indicates whether the system disk is encrypted. Valid values: true: encrypts the system disk. false: does not encrypt the system disk.
26393
27151
  *
26394
27152
  * @example
26395
27153
  * false
@@ -26435,7 +27193,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26435
27193
  systemDiskSize?: number;
26436
27194
  /**
26437
27195
  * @remarks
26438
- * The labels that you want to add only to ECS instances.
27196
+ * The tags that you want to add only to ECS instances.
26439
27197
  *
26440
27198
  * 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://.
26441
27199
  */
@@ -26570,6 +27328,10 @@ export class ModifyClusterNodePoolRequestTeeConfig extends $tea.Model {
26570
27328
  }
26571
27329
 
26572
27330
  export class ModifyNodePoolNodeConfigRequestOsConfig extends $tea.Model {
27331
+ /**
27332
+ * @remarks
27333
+ * sysctl parameter configuration
27334
+ */
26573
27335
  sysctl?: { [key: string]: any };
26574
27336
  static names(): { [key: string]: string } {
26575
27337
  return {
@@ -26718,7 +27480,7 @@ export class ScaleOutClusterRequestWorkerDataDisks extends $tea.Model {
26718
27480
  autoSnapshotPolicyId?: string;
26719
27481
  /**
26720
27482
  * @remarks
26721
- * The data disk type.
27483
+ * The type of the data disk.
26722
27484
  *
26723
27485
  * @example
26724
27486
  * cloud_essd
@@ -26726,7 +27488,7 @@ export class ScaleOutClusterRequestWorkerDataDisks extends $tea.Model {
26726
27488
  category?: string;
26727
27489
  /**
26728
27490
  * @remarks
26729
- * Specifies whether to encrypt the data disk. Valid values:
27491
+ * Specifies whether to encrypt the data disks. Valid values:
26730
27492
  *
26731
27493
  * * `true`: encrypts the data disk.
26732
27494
  * * `false`: does not encrypt the data disk.
@@ -26739,7 +27501,7 @@ export class ScaleOutClusterRequestWorkerDataDisks extends $tea.Model {
26739
27501
  encrypted?: string;
26740
27502
  /**
26741
27503
  * @remarks
26742
- * The data disk size. Valid values: 40 to 32767.
27504
+ * The size of the data disk. Valid values: 40 to 32767.
26743
27505
  *
26744
27506
  * @example
26745
27507
  * 120
@@ -27002,7 +27764,7 @@ export class UpgradeClusterNodepoolRequestRollingPolicy extends $tea.Model {
27002
27764
  batchInterval?: number;
27003
27765
  /**
27004
27766
  * @remarks
27005
- * The maximum number of unavailable nodes.
27767
+ * The maximum number of nodes per batch.
27006
27768
  *
27007
27769
  * @example
27008
27770
  * 3
@@ -27540,9 +28302,9 @@ export default class Client extends OpenApi {
27540
28302
  * 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.
27541
28303
  *
27542
28304
  * @remarks
27543
- * >- To call this operation, make sure that you have the AliyunCSFullAccess permissions.
27544
- * >- You cannot revoke the permissions of an Alibaba Cloud account.
27545
- * >- You cannot revoke the permissions of the account that you use to call this operation.
28305
+ * > - To call this operation, make sure that you have the AliyunCSFullAccess permission.
28306
+ * > - You cannot revoke the permissions of an Alibaba Cloud account.
28307
+ * > - You cannot revoke the permissions of the account that you use to call this operation.
27546
28308
  *
27547
28309
  * @param tmpReq - CleanUserPermissionsRequest
27548
28310
  * @param headers - map
@@ -27588,9 +28350,9 @@ export default class Client extends OpenApi {
27588
28350
  * 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.
27589
28351
  *
27590
28352
  * @remarks
27591
- * >- To call this operation, make sure that you have the AliyunCSFullAccess permissions.
27592
- * >- You cannot revoke the permissions of an Alibaba Cloud account.
27593
- * >- You cannot revoke the permissions of the account that you use to call this operation.
28353
+ * > - To call this operation, make sure that you have the AliyunCSFullAccess permission.
28354
+ * > - You cannot revoke the permissions of an Alibaba Cloud account.
28355
+ * > - You cannot revoke the permissions of the account that you use to call this operation.
27594
28356
  *
27595
28357
  * @param request - CleanUserPermissionsRequest
27596
28358
  * @returns CleanUserPermissionsResponse
@@ -28195,7 +28957,7 @@ export default class Client extends OpenApi {
28195
28957
  }
28196
28958
 
28197
28959
  /**
28198
- * 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.
28960
+ * 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.
28199
28961
  *
28200
28962
  * @param request - CreateClusterNodePoolRequest
28201
28963
  * @param headers - map
@@ -28213,6 +28975,10 @@ export default class Client extends OpenApi {
28213
28975
  body["count"] = request.count;
28214
28976
  }
28215
28977
 
28978
+ if (!Util.isUnset(request.hostNetwork)) {
28979
+ body["host_network"] = request.hostNetwork;
28980
+ }
28981
+
28216
28982
  if (!Util.isUnset(request.interconnectConfig)) {
28217
28983
  body["interconnect_config"] = request.interconnectConfig;
28218
28984
  }
@@ -28221,6 +28987,10 @@ export default class Client extends OpenApi {
28221
28987
  body["interconnect_mode"] = request.interconnectMode;
28222
28988
  }
28223
28989
 
28990
+ if (!Util.isUnset(request.intranet)) {
28991
+ body["intranet"] = request.intranet;
28992
+ }
28993
+
28224
28994
  if (!Util.isUnset(request.kubernetesConfig)) {
28225
28995
  body["kubernetes_config"] = request.kubernetesConfig;
28226
28996
  }
@@ -28268,7 +29038,7 @@ export default class Client extends OpenApi {
28268
29038
  }
28269
29039
 
28270
29040
  /**
28271
- * 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.
29041
+ * 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.
28272
29042
  *
28273
29043
  * @param request - CreateClusterNodePoolRequest
28274
29044
  * @returns CreateClusterNodePoolResponse
@@ -29625,7 +30395,7 @@ export default class Client extends OpenApi {
29625
30395
  }
29626
30396
 
29627
30397
  /**
29628
- * Queries node pools in a Container Service for Kubernetes (ACK) cluster.
30398
+ * Queries the information about all node pools in a cluster.
29629
30399
  *
29630
30400
  * @param request - DescribeClusterNodePoolsRequest
29631
30401
  * @param headers - map
@@ -29658,7 +30428,7 @@ export default class Client extends OpenApi {
29658
30428
  }
29659
30429
 
29660
30430
  /**
29661
- * Queries node pools in a Container Service for Kubernetes (ACK) cluster.
30431
+ * Queries the information about all node pools in a cluster.
29662
30432
  *
29663
30433
  * @param request - DescribeClusterNodePoolsRequest
29664
30434
  * @returns DescribeClusterNodePoolsResponse
@@ -29670,7 +30440,7 @@ export default class Client extends OpenApi {
29670
30440
  }
29671
30441
 
29672
30442
  /**
29673
- * You can call the DescribeClusterNodes operation to query the details about all nodes in a cluster by cluster ID.
30443
+ * null
29674
30444
  *
29675
30445
  * @param request - DescribeClusterNodesRequest
29676
30446
  * @param headers - map
@@ -29719,7 +30489,7 @@ export default class Client extends OpenApi {
29719
30489
  }
29720
30490
 
29721
30491
  /**
29722
- * You can call the DescribeClusterNodes operation to query the details about all nodes in a cluster by cluster ID.
30492
+ * null
29723
30493
  *
29724
30494
  * @param request - DescribeClusterNodesRequest
29725
30495
  * @returns DescribeClusterNodesResponse
@@ -30024,6 +30794,75 @@ export default class Client extends OpenApi {
30024
30794
  return await this.describeClustersWithOptions(request, headers, runtime);
30025
30795
  }
30026
30796
 
30797
+ /**
30798
+ * 查询指定地域内全部集群列表
30799
+ *
30800
+ * @param request - DescribeClustersForRegionRequest
30801
+ * @param headers - map
30802
+ * @param runtime - runtime options for this request RuntimeOptions
30803
+ * @returns DescribeClustersForRegionResponse
30804
+ */
30805
+ async describeClustersForRegionWithOptions(regionId: string, request: DescribeClustersForRegionRequest, headers: {[key: string ]: string}, runtime: $Util.RuntimeOptions): Promise<DescribeClustersForRegionResponse> {
30806
+ Util.validateModel(request);
30807
+ let query : {[key: string ]: any} = { };
30808
+ if (!Util.isUnset(request.clusterId)) {
30809
+ query["cluster_id"] = request.clusterId;
30810
+ }
30811
+
30812
+ if (!Util.isUnset(request.clusterSpec)) {
30813
+ query["cluster_spec"] = request.clusterSpec;
30814
+ }
30815
+
30816
+ if (!Util.isUnset(request.clusterType)) {
30817
+ query["cluster_type"] = request.clusterType;
30818
+ }
30819
+
30820
+ if (!Util.isUnset(request.name)) {
30821
+ query["name"] = request.name;
30822
+ }
30823
+
30824
+ if (!Util.isUnset(request.pageNumber)) {
30825
+ query["page_number"] = request.pageNumber;
30826
+ }
30827
+
30828
+ if (!Util.isUnset(request.pageSize)) {
30829
+ query["page_size"] = request.pageSize;
30830
+ }
30831
+
30832
+ if (!Util.isUnset(request.profile)) {
30833
+ query["profile"] = request.profile;
30834
+ }
30835
+
30836
+ let req = new $OpenApi.OpenApiRequest({
30837
+ headers: headers,
30838
+ query: OpenApiUtil.query(query),
30839
+ });
30840
+ let params = new $OpenApi.Params({
30841
+ action: "DescribeClustersForRegion",
30842
+ version: "2015-12-15",
30843
+ protocol: "HTTPS",
30844
+ pathname: `/regions/${OpenApiUtil.getEncodeParam(regionId)}/clusters`,
30845
+ method: "GET",
30846
+ authType: "AK",
30847
+ style: "ROA",
30848
+ reqBodyType: "json",
30849
+ bodyType: "json",
30850
+ });
30851
+ return $tea.cast<DescribeClustersForRegionResponse>(await this.callApi(params, req, runtime), new DescribeClustersForRegionResponse({}));
30852
+ }
30853
+
30854
+ /**
30855
+ * 查询指定地域内全部集群列表
30856
+ *
30857
+ * @param request - DescribeClustersForRegionRequest
30858
+ * @returns DescribeClustersForRegionResponse
30859
+ */
30860
+ async describeClustersForRegion(regionId: string, request: DescribeClustersForRegionRequest): Promise<DescribeClustersForRegionResponse> {
30861
+ let runtime = new $Util.RuntimeOptions({ });
30862
+ let headers : {[key: string ]: string} = { };
30863
+ return await this.describeClustersForRegionWithOptions(regionId, request, headers, runtime);
30864
+ }
30865
+
30027
30866
  /**
30028
30867
  * Queries the details about Container Service for Kubernetes (ACK) clusters of specified types or specifications within an account.
30029
30868
  *
@@ -30268,7 +31107,7 @@ export default class Client extends OpenApi {
30268
31107
  }
30269
31108
 
30270
31109
  /**
30271
- * 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.
31110
+ * 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.
30272
31111
  *
30273
31112
  * @param request - DescribeEventsRequest
30274
31113
  * @param headers - map
@@ -30313,7 +31152,7 @@ export default class Client extends OpenApi {
30313
31152
  }
30314
31153
 
30315
31154
  /**
30316
- * 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.
31155
+ * 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.
30317
31156
  *
30318
31157
  * @param request - DescribeEventsRequest
30319
31158
  * @returns DescribeEventsResponse
@@ -30324,6 +31163,59 @@ export default class Client extends OpenApi {
30324
31163
  return await this.describeEventsWithOptions(request, headers, runtime);
30325
31164
  }
30326
31165
 
31166
+ /**
31167
+ * 查询指定地域内全部事件列表
31168
+ *
31169
+ * @param request - DescribeEventsForRegionRequest
31170
+ * @param headers - map
31171
+ * @param runtime - runtime options for this request RuntimeOptions
31172
+ * @returns DescribeEventsForRegionResponse
31173
+ */
31174
+ async describeEventsForRegionWithOptions(regionId: string, request: DescribeEventsForRegionRequest, headers: {[key: string ]: string}, runtime: $Util.RuntimeOptions): Promise<DescribeEventsForRegionResponse> {
31175
+ Util.validateModel(request);
31176
+ let query : {[key: string ]: any} = { };
31177
+ if (!Util.isUnset(request.clusterId)) {
31178
+ query["cluster_id"] = request.clusterId;
31179
+ }
31180
+
31181
+ if (!Util.isUnset(request.pageNumber)) {
31182
+ query["page_number"] = request.pageNumber;
31183
+ }
31184
+
31185
+ if (!Util.isUnset(request.pageSize)) {
31186
+ query["page_size"] = request.pageSize;
31187
+ }
31188
+
31189
+ let req = new $OpenApi.OpenApiRequest({
31190
+ headers: headers,
31191
+ query: OpenApiUtil.query(query),
31192
+ });
31193
+ let params = new $OpenApi.Params({
31194
+ action: "DescribeEventsForRegion",
31195
+ version: "2015-12-15",
31196
+ protocol: "HTTPS",
31197
+ pathname: `/regions/${OpenApiUtil.getEncodeParam(regionId)}/events`,
31198
+ method: "GET",
31199
+ authType: "AK",
31200
+ style: "ROA",
31201
+ reqBodyType: "json",
31202
+ bodyType: "json",
31203
+ });
31204
+ return $tea.cast<DescribeEventsForRegionResponse>(await this.callApi(params, req, runtime), new DescribeEventsForRegionResponse({}));
31205
+ }
31206
+
31207
+ /**
31208
+ * 查询指定地域内全部事件列表
31209
+ *
31210
+ * @param request - DescribeEventsForRegionRequest
31211
+ * @returns DescribeEventsForRegionResponse
31212
+ */
31213
+ async describeEventsForRegion(regionId: string, request: DescribeEventsForRegionRequest): Promise<DescribeEventsForRegionResponse> {
31214
+ let runtime = new $Util.RuntimeOptions({ });
31215
+ let headers : {[key: string ]: string} = { };
31216
+ return await this.describeEventsForRegionWithOptions(regionId, request, headers, runtime);
31217
+ }
31218
+
30327
31219
  /**
30328
31220
  * Queries the proxy configurations of a registered cluster based on the cluster ID.
30329
31221
  *
@@ -30494,7 +31386,7 @@ export default class Client extends OpenApi {
30494
31386
  }
30495
31387
 
30496
31388
  /**
30497
- * 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.
31389
+ * 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.
30498
31390
  *
30499
31391
  * @param headers - map
30500
31392
  * @param runtime - runtime options for this request RuntimeOptions
@@ -30519,7 +31411,7 @@ export default class Client extends OpenApi {
30519
31411
  }
30520
31412
 
30521
31413
  /**
30522
- * 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.
31414
+ * 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.
30523
31415
  * @returns DescribePoliciesResponse
30524
31416
  */
30525
31417
  async describePolicies(): Promise<DescribePoliciesResponse> {
@@ -31249,6 +32141,8 @@ export default class Client extends OpenApi {
31249
32141
  }
31250
32142
 
31251
32143
  /**
32144
+ * 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.
32145
+ *
31252
32146
  * @param headers - map
31253
32147
  * @param runtime - runtime options for this request RuntimeOptions
31254
32148
  * @returns GetClusterAuditProjectResponse
@@ -31272,6 +32166,7 @@ export default class Client extends OpenApi {
31272
32166
  }
31273
32167
 
31274
32168
  /**
32169
+ * 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.
31275
32170
  * @returns GetClusterAuditProjectResponse
31276
32171
  */
31277
32172
  async getClusterAuditProject(clusterid: string): Promise<GetClusterAuditProjectResponse> {
@@ -31488,8 +32383,7 @@ export default class Client extends OpenApi {
31488
32383
  *
31489
32384
  * @remarks
31490
32385
  * *Precautions**:
31491
- * * 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).
31492
- * * 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).
32386
+ * * 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).
31493
32387
  * * 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.
31494
32388
  *
31495
32389
  * @param request - GrantPermissionsRequest
@@ -31522,8 +32416,7 @@ export default class Client extends OpenApi {
31522
32416
  *
31523
32417
  * @remarks
31524
32418
  * *Precautions**:
31525
- * * 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).
31526
- * * 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).
32419
+ * * 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).
31527
32420
  * * 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.
31528
32421
  *
31529
32422
  * @param request - GrantPermissionsRequest
@@ -32762,7 +33655,7 @@ export default class Client extends OpenApi {
32762
33655
  }
32763
33656
 
32764
33657
  /**
32765
- * Fixes issues on abnormal nodes in a node pool to ensure that the nodes can run as normal.
33658
+ * Repairs a node pool.
32766
33659
  *
32767
33660
  * @param request - RepairClusterNodePoolRequest
32768
33661
  * @param headers - map
@@ -32803,7 +33696,7 @@ export default class Client extends OpenApi {
32803
33696
  }
32804
33697
 
32805
33698
  /**
32806
- * Fixes issues on abnormal nodes in a node pool to ensure that the nodes can run as normal.
33699
+ * Repairs a node pool.
32807
33700
  *
32808
33701
  * @param request - RepairClusterNodePoolRequest
32809
33702
  * @returns RepairClusterNodePoolResponse
@@ -32856,7 +33749,7 @@ export default class Client extends OpenApi {
32856
33749
  }
32857
33750
 
32858
33751
  /**
32859
- * You can call the ResumeTask operation to resume a task.
33752
+ * Resumes a task.
32860
33753
  *
32861
33754
  * @param headers - map
32862
33755
  * @param runtime - runtime options for this request RuntimeOptions
@@ -32881,7 +33774,7 @@ export default class Client extends OpenApi {
32881
33774
  }
32882
33775
 
32883
33776
  /**
32884
- * You can call the ResumeTask operation to resume a task.
33777
+ * Resumes a task.
32885
33778
  * @returns ResumeTaskResponse
32886
33779
  */
32887
33780
  async resumeTask(taskId: string): Promise<ResumeTaskResponse> {
@@ -33143,7 +34036,7 @@ export default class Client extends OpenApi {
33143
34036
  }
33144
34037
 
33145
34038
  /**
33146
- * You can call the ScaleClusterNodePool operation to scale out a node pool by node pool ID.
34039
+ * Scales out a node pool.
33147
34040
  *
33148
34041
  * @param request - ScaleClusterNodePoolRequest
33149
34042
  * @param headers - map
@@ -33176,7 +34069,7 @@ export default class Client extends OpenApi {
33176
34069
  }
33177
34070
 
33178
34071
  /**
33179
- * You can call the ScaleClusterNodePool operation to scale out a node pool by node pool ID.
34072
+ * Scales out a node pool.
33180
34073
  *
33181
34074
  * @param request - ScaleClusterNodePoolRequest
33182
34075
  * @returns ScaleClusterNodePoolResponse