@alicloud/cs20151215 4.7.4 → 4.7.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/src/client.ts CHANGED
@@ -1105,17 +1105,10 @@ export class CancelComponentUpgradeResponse extends $tea.Model {
1105
1105
  }
1106
1106
 
1107
1107
  export class CancelOperationPlanResponseBody extends $tea.Model {
1108
- /**
1109
- * @remarks
1110
- * The request ID.
1111
- *
1112
- * @example
1113
- * 873DC52C-28AA-5A5C-938C-684D3D4B****
1114
- */
1115
1108
  requestId?: string;
1116
1109
  static names(): { [key: string]: string } {
1117
1110
  return {
1118
- requestId: 'requestId',
1111
+ requestId: 'request_id',
1119
1112
  };
1120
1113
  }
1121
1114
 
@@ -1314,6 +1307,8 @@ export class CheckControlPlaneLogEnableResponse extends $tea.Model {
1314
1307
  export class CheckServiceRoleRequest extends $tea.Model {
1315
1308
  /**
1316
1309
  * @remarks
1310
+ * The service roles that you want to check.
1311
+ *
1317
1312
  * This parameter is required.
1318
1313
  */
1319
1314
  roles?: CheckServiceRoleRequestRoles[];
@@ -1335,6 +1330,10 @@ export class CheckServiceRoleRequest extends $tea.Model {
1335
1330
  }
1336
1331
 
1337
1332
  export class CheckServiceRoleResponseBody extends $tea.Model {
1333
+ /**
1334
+ * @remarks
1335
+ * The check results.
1336
+ */
1338
1337
  roles?: CheckServiceRoleResponseBodyRoles[];
1339
1338
  static names(): { [key: string]: string } {
1340
1339
  return {
@@ -1383,8 +1382,8 @@ export class CleanClusterUserPermissionsRequest extends $tea.Model {
1383
1382
  * @remarks
1384
1383
  * Specifies whether to forcefully delete the specified kubeconfig files. Valid values:
1385
1384
  *
1386
- * * **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.
1387
- * * **true**: forcefully deletes the kubeconfig files without checking cluster access records.
1385
+ * * 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.
1386
+ * * true: forcefully deletes the kubeconfig files without checking the cluster access records.
1388
1387
  *
1389
1388
  * @example
1390
1389
  * false
@@ -1569,7 +1568,7 @@ export class CleanUserPermissionsResponse extends $tea.Model {
1569
1568
  export class CreateAutoscalingConfigRequest extends $tea.Model {
1570
1569
  /**
1571
1570
  * @remarks
1572
- * The waiting time before the auto scaling feature performs a scale-in activity. Only if the resource usage on a node remains below the scale-in threshold within the waiting time, the node is removed after the waiting time ends. Unit: minutes.
1571
+ * The waiting time before the auto scaling feature performs a scale-in activity. It is an interval between the time when the scale-in threshold is reached and the time when the scale-in activity (reduce the number of pods) starts. Unit: minutes. Default value: 10.
1573
1572
  *
1574
1573
  * @example
1575
1574
  * 10 m
@@ -1577,7 +1576,7 @@ export class CreateAutoscalingConfigRequest extends $tea.Model {
1577
1576
  coolDownDuration?: string;
1578
1577
  /**
1579
1578
  * @remarks
1580
- * Specifies whether to evict DaemonSet pods during scale-in activities. Valid values:
1579
+ * Specifies whether to evict pods created by DaemonSets when the cluster autoscaler performs a scale-in activity. Valid values:
1581
1580
  *
1582
1581
  * * `true`: evicts DaemonSet pods.
1583
1582
  * * `false`: does not evict DaemonSet pods.
@@ -1602,13 +1601,15 @@ export class CreateAutoscalingConfigRequest extends $tea.Model {
1602
1601
  * @remarks
1603
1602
  * The scale-in threshold of GPU utilization. This threshold specifies the ratio of the GPU resources that are requested by pods to the total GPU resources on the node.
1604
1603
  *
1604
+ * A scale-in activity is performed only when the CPU utilization, memory utilization, and GPU utilization of a GPU-accelerated node are lower than the scale-in threshold of GPU utilization.
1605
+ *
1605
1606
  * @example
1606
1607
  * 0.5
1607
1608
  */
1608
1609
  gpuUtilizationThreshold?: string;
1609
1610
  /**
1610
1611
  * @remarks
1611
- * The maximum amount of time that the cluster autoscaler waits for pods on the nodes to terminate during scale-in activities. Unit: seconds.
1612
+ * The maximum amount of time to wait for pods on a node to terminate during a scale-in activity. Unit: seconds.
1612
1613
  *
1613
1614
  * @example
1614
1615
  * 14400s
@@ -1616,7 +1617,7 @@ export class CreateAutoscalingConfigRequest extends $tea.Model {
1616
1617
  maxGracefulTerminationSec?: number;
1617
1618
  /**
1618
1619
  * @remarks
1619
- * The minimum number of pods that must be guaranteed during scale-in activities.
1620
+ * The minimum number of pods allowed in each ReplicaSet before a scale-in activity is performed.
1620
1621
  *
1621
1622
  * @example
1622
1623
  * 0
@@ -1624,7 +1625,10 @@ export class CreateAutoscalingConfigRequest extends $tea.Model {
1624
1625
  minReplicaCount?: number;
1625
1626
  /**
1626
1627
  * @remarks
1627
- * Specifies whether to delete the corresponding Kubernetes node objects after nodes are removed in swift mode.
1628
+ * Specifies whether to delete the corresponding Kubernetes node objects after nodes are removed in swift mode. For more information about the swift mode, see [Scaling mode](https://help.aliyun.com/document_detail/119099.html). Default value: false. Valid values:
1629
+ *
1630
+ * * `true`: deletes the corresponding Kubernetes node objects after nodes are removed in swift mode. We recommend that you do not set the value to true because data inconsistency may occur in Kubernetes objects.
1631
+ * * `false`: retains the corresponding Kubernetes node objects after nodes are removed in swift mode.
1628
1632
  *
1629
1633
  * @example
1630
1634
  * false
@@ -1643,7 +1647,10 @@ export class CreateAutoscalingConfigRequest extends $tea.Model {
1643
1647
  scaleDownEnabled?: boolean;
1644
1648
  /**
1645
1649
  * @remarks
1646
- * Specifies whether the cluster autoscaler performs scale-out activities when the number of ready nodes in the cluster is zero.
1650
+ * Specifies whether the cluster autoscaler performs a scale-out activity when the number of ready nodes in the cluster is 0. Default value: true. Valid values:
1651
+ *
1652
+ * * `true`: performs a scale-out activity.
1653
+ * * `false`: does not perform a scale-out activity.
1647
1654
  *
1648
1655
  * @example
1649
1656
  * true
@@ -1651,7 +1658,7 @@ export class CreateAutoscalingConfigRequest extends $tea.Model {
1651
1658
  scaleUpFromZero?: boolean;
1652
1659
  /**
1653
1660
  * @remarks
1654
- * The interval at which the cluster is scanned and evaluated for scaling. Unit: seconds.
1661
+ * The interval at which the system scans for events that trigger scaling activities. Unit: seconds. Default value: 60.
1655
1662
  *
1656
1663
  * @example
1657
1664
  * 30s
@@ -1659,7 +1666,7 @@ export class CreateAutoscalingConfigRequest extends $tea.Model {
1659
1666
  scanInterval?: string;
1660
1667
  /**
1661
1668
  * @remarks
1662
- * Specifies whether to allow the cluster autoscaler to scale in nodes that host pods mounted with local storage, such as EmptyDir volumes or HostPath volumes. Valid values:
1669
+ * Specifies whether the cluster autoscaler scales in nodes that host pods mounted with local volumes, such as EmptyDir or HostPath volumes. Valid values:
1663
1670
  *
1664
1671
  * * `true`: does not allow the cluster autoscaler to scale in these nodes.
1665
1672
  * * `false`: allows the cluster autoscaler to scale in these nodes.
@@ -1670,7 +1677,7 @@ export class CreateAutoscalingConfigRequest extends $tea.Model {
1670
1677
  skipNodesWithLocalStorage?: boolean;
1671
1678
  /**
1672
1679
  * @remarks
1673
- * Specifies whether to allow the cluster autoscaler to scale in nodes that host pods in the kube-system namespace, excluding DaemonSet pods and mirror pods. Valid values:
1680
+ * Specifies whether the cluster autoscaler scales in nodes that host pods in the kube-system namespace. This parameter does not take effect on pods created by DaemonSets and mirror pods. Valid values:
1674
1681
  *
1675
1682
  * * `true`: does not allow the cluster autoscaler to scale in these nodes.
1676
1683
  * * `false`: allows the cluster autoscaler to scale in these nodes.
@@ -1681,7 +1688,7 @@ export class CreateAutoscalingConfigRequest extends $tea.Model {
1681
1688
  skipNodesWithSystemPods?: boolean;
1682
1689
  /**
1683
1690
  * @remarks
1684
- * The cooldown period. Newly added nodes can be removed in scale-in activities only after the cooldown period ends. Unit: minutes.
1691
+ * The cooldown period. After the autoscaler performs a scale-out activity, the autoscaler waits a cooldown period before it can perform a scale-in activity. Newly added nodes can be removed in scale-in activities only after the cooldown period ends. Unit: minutes.
1685
1692
  *
1686
1693
  * @example
1687
1694
  * 10 m
@@ -1691,6 +1698,8 @@ export class CreateAutoscalingConfigRequest extends $tea.Model {
1691
1698
  * @remarks
1692
1699
  * The scale-in threshold. This threshold specifies the ratio of the resources that are requested by pods to the total resources on the node.
1693
1700
  *
1701
+ * A scale-in activity is performed only when the CPU utilization and memory utilization of a node are lower than the scale-in threshold.
1702
+ *
1694
1703
  * @example
1695
1704
  * 0.5
1696
1705
  */
@@ -1763,56 +1772,66 @@ export class CreateAutoscalingConfigResponse extends $tea.Model {
1763
1772
  export class CreateClusterRequest extends $tea.Model {
1764
1773
  /**
1765
1774
  * @remarks
1766
- * The access control list (ACL) rule of the SLB instance associated with the API server if the cluster is a registered cluster.
1775
+ * The network access control list (ACL) of the SLB instance associated with the API server if the cluster is a registered cluster.
1767
1776
  */
1768
1777
  accessControlList?: string[];
1769
1778
  /**
1770
1779
  * @remarks
1771
- * The components that you want to install in the cluster. When you create a cluster, you can configure the `addons` parameter to install specific components.
1780
+ * 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.
1772
1781
  *
1773
1782
  * **Network plug-in**: required. The Flannel and Terway plug-ins are supported. Select one of the plug-ins for the cluster.
1774
1783
  *
1775
- * * Specify the Flannel plug-in in the following format: [{"name":"flannel","config":""}].
1776
- * * Specify the Flannel plug-in in the following format: [{"name": "terway-eniip","config": ""}].
1784
+ * * If you want to use the Terway component, specify the network plug-in in the [{"name":"flannel","config":""}] format.
1785
+ * * If you want to use the Terway component, specify the value network plug-in in the [{"Name": "terway-eniip","Config": ""}] format.
1777
1786
  *
1778
- * **Volume plug-in**: optional. Only the `CSI` plug-in is supported.
1787
+ * **Volume plug-in**: optional. Only the `Container Storage Interface (CSI)` plug-in is supported.
1779
1788
  *
1780
1789
  * Specify the `CSI` plug-in in the following format: [{"name":"csi-plugin","config": ""},{"name": "csi-provisioner","config": ""}].
1781
1790
  *
1782
1791
  * **Simple Log Service component**: optional. We recommend that you enable Simple Log Service. If Simple Log Service is disabled, you cannot use the cluster auditing feature.
1783
1792
  *
1784
- * * To use an existing `Simple Log Service project`, specify the value in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}].
1785
- * * To create a `Simple Log Service project`, specify the value in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true"}"}].
1793
+ * * Specify an existing `Simple Log Service project` in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true","sls_project_name":"your_sls_project_name"}"}].
1794
+ * * To create a `Simple Log Service project`, specify the component in the following format: [{"name": "logtail-ds","config": "{"IngressDashboardEnabled":"true"}"}].
1786
1795
  *
1787
1796
  * **Ingress controller**: optional. By default, the `nginx-ingress-controller` component is installed in ACK dedicated clusters.
1788
1797
  *
1789
- * * To install nginx-ingress-controller and enable Internet access, specify the value in the following format: [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}].
1790
- * * To disable the system to automatically install nginx-ingress-controller, specify the value in the following format: [{"name": "nginx-ingress-controller","config": "","disabled": true}].
1798
+ * * To install nginx-ingress-controller and enable Internet access, specify the Ingress controller in the following format: [{"name":"nginx-ingress-controller","config":"{"IngressSlbNetworkType":"internet"}"}].
1799
+ * * To disable the automatic installation of nginx-ingress-controller, specify the Ingress controller in the following format: [{"name": "nginx-ingress-controller","config": "","disabled": true}].
1791
1800
  *
1792
1801
  * **Event center**: optional. By default, the event center feature is enabled.
1793
1802
  *
1794
- * You can use Kubernetes event centers to store and query events and configure alerts. You can use the Logstores that are associated with Kubernetes event centers free of charge within 90 days. For more information, see [Create and use a Kubernetes event center](https://help.aliyun.com/document_detail/150476.html).
1803
+ * 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).
1795
1804
  *
1796
- * To enable the ack-node-problem-detector component, specify the value in the following format: [{"name":"ack-node-problem-detector","config":"{"sls_project_name":"your_sls_project_name"}"}].
1805
+ * 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"}"}].
1797
1806
  */
1798
1807
  addons?: Addon[];
1799
1808
  /**
1800
1809
  * @remarks
1801
- * Service accounts provide 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 `audiences` with commas (,).
1810
+ * 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 (,).``
1802
1811
  *
1803
- * For more information about `ServiceAccount`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
1812
+ * For more information about `service accounts`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
1804
1813
  *
1805
1814
  * @example
1806
1815
  * kubernetes.default.svc
1807
1816
  */
1808
1817
  apiAudiences?: string;
1818
+ /**
1819
+ * @example
1820
+ * true
1821
+ */
1822
+ autoRenew?: boolean;
1823
+ /**
1824
+ * @example
1825
+ * 1
1826
+ */
1827
+ autoRenewPeriod?: number;
1809
1828
  /**
1810
1829
  * @remarks
1811
1830
  * The billing method of the cluster. The following resources are billed on a subscription basis:
1812
1831
  *
1813
1832
  * ECS instances in node pools.
1814
1833
  *
1815
- * The internal-facing SLB instance used by the API server.
1834
+ * The internal-facing SLB instance associated with the API server.
1816
1835
  *
1817
1836
  * Valid values:
1818
1837
  *
@@ -1828,9 +1847,7 @@ export class CreateClusterRequest extends $tea.Model {
1828
1847
  chargeType?: string;
1829
1848
  /**
1830
1849
  * @remarks
1831
- * [This parameter is deprecated]
1832
- *
1833
- * Please replace this parameter with security_hardening_os.
1850
+ * This parameter is deprecated. Use security_hardening_os instead.
1834
1851
  *
1835
1852
  * @example
1836
1853
  * false
@@ -1863,10 +1880,10 @@ export class CreateClusterRequest extends $tea.Model {
1863
1880
  clusterDomain?: string;
1864
1881
  /**
1865
1882
  * @remarks
1866
- * After you set `cluster_type` to `ManagedKubernetes` and configure the `profile` parameter, you can further specify the edition of the cluster. Valid values:
1883
+ * After you set `cluster_type` to `ManagedKubernetes` and configure the `profile` parameter, you can further specify the cluster edition. Valid values:
1867
1884
  *
1868
- * * `ack.pro.small`: Pro.
1869
- * * `ack.standard`: Basic. If you leave the parameter empty, the Basic edition is selected.
1885
+ * * `ack.pro.small`: Pro Edition.
1886
+ * * `ack.standard`: Basic Edition. If you leave the parameter empty, an ACK Basic cluster is created.
1870
1887
  *
1871
1888
  * @example
1872
1889
  * ack.pro.small
@@ -1875,7 +1892,7 @@ export class CreateClusterRequest extends $tea.Model {
1875
1892
  /**
1876
1893
  * @remarks
1877
1894
  * * `Kubernetes`: ACK dedicated cluster.
1878
- * * `ManagedKubernetes`: 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).
1895
+ * * `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).
1879
1896
  * * `ExternalKubernetes`: registered cluster.
1880
1897
  *
1881
1898
  * This parameter is required.
@@ -1886,11 +1903,11 @@ export class CreateClusterRequest extends $tea.Model {
1886
1903
  clusterType?: string;
1887
1904
  /**
1888
1905
  * @remarks
1889
- * The CIDR block of pods. You can specify 10.0.0.0/8, 172.16-31.0.0/12-16, 192.168.0.0/16, or their subnets as the CIDR block of pods. 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.
1906
+ * The pod CIDR block. You can specify 10.0.0.0/8, 172.16-31.0.0/12-16, 192.168.0.0/16, or their subnets as the pod CIDR block. 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.
1890
1907
  *
1891
- * For more information about subnetting for ACK clusters, see [Plan CIDR blocks for an ACK cluster that is deployed in a VPC](https://help.aliyun.com/document_detail/86500.html).
1908
+ * For more information about how to plan the network of an ACK cluster, see [Plan the network of an ACK cluster](https://help.aliyun.com/document_detail/86500.html).
1892
1909
  *
1893
- * > This parameter is required if the cluster uses Flannel as the network plug-in.
1910
+ * > This parameter is required if the cluster uses the Flannel plug-in.
1894
1911
  *
1895
1912
  * @example
1896
1913
  * 172.20.0.0/16
@@ -1900,7 +1917,7 @@ export class CreateClusterRequest extends $tea.Model {
1900
1917
  * @remarks
1901
1918
  * The list of control plane components for which you want to enable log collection.
1902
1919
  *
1903
- * By default, the log of kube-apiserver, kube-controller-manager, and kube-scheduler is collected.
1920
+ * By default, the logs of kube-apiserver, kube-controller-manager, and kube-scheduler are collected.
1904
1921
  */
1905
1922
  controlplaneLogComponents?: string[];
1906
1923
  /**
@@ -1921,7 +1938,7 @@ export class CreateClusterRequest extends $tea.Model {
1921
1938
  controlplaneLogTtl?: string;
1922
1939
  /**
1923
1940
  * @remarks
1924
- * The CPU management policy of the nodes in the node pool. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
1941
+ * 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:
1925
1942
  *
1926
1943
  * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
1927
1944
  * * `none`: specifies that the default CPU affinity is used.
@@ -1934,7 +1951,7 @@ export class CreateClusterRequest extends $tea.Model {
1934
1951
  cpuPolicy?: string;
1935
1952
  /**
1936
1953
  * @remarks
1937
- * Specifies custom subject alternative names (SANs) for the API server certificate to accept requests from specified IP addresses or domain names. Separate multiple IP addresses or domain names with commas (,).
1954
+ * 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 (,).
1938
1955
  *
1939
1956
  * @example
1940
1957
  * cs.aliyun.com
@@ -1942,10 +1959,10 @@ export class CreateClusterRequest extends $tea.Model {
1942
1959
  customSan?: string;
1943
1960
  /**
1944
1961
  * @remarks
1945
- * 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:
1962
+ * 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:
1946
1963
  *
1947
- * * `true`: enables deletion protection for the cluster. This way, the cluster cannot be deleted in the Container Service console or by calling API operations.
1948
- * * `false`: disables deletion protection for the cluster. This way, the cluster can be deleted in the Container Service console or by calling API operations.
1964
+ * * `true`: enables deletion protection for the cluster. This way, the cluster cannot be deleted in the ACK console or by calling API operations.
1965
+ * * `false`: disables deletion protection for the cluster. This way, the cluster can be deleted in the ACK console or by calling API operations.
1949
1966
  *
1950
1967
  * Default value: `false`.
1951
1968
  *
@@ -1955,10 +1972,10 @@ export class CreateClusterRequest extends $tea.Model {
1955
1972
  deletionProtection?: boolean;
1956
1973
  /**
1957
1974
  * @remarks
1958
- * Specifies whether to perform a rollback if the cluster fails to be created. Valid values:
1975
+ * Specifies whether to perform a rollback when the cluster fails to be created. Valid values:
1959
1976
  *
1960
- * * `true`: performs a rollback if the system fails to create the cluster.
1961
- * * `false`: does not perform a rollback if the system fails to create the cluster.
1977
+ * * `true`: performs a rollback when the cluster fails to be created.
1978
+ * * `false`: does not perform a rollback when the cluster fails to be created.
1962
1979
  *
1963
1980
  * Default value: `true`.
1964
1981
  *
@@ -1978,7 +1995,7 @@ export class CreateClusterRequest extends $tea.Model {
1978
1995
  enableRrsa?: boolean;
1979
1996
  /**
1980
1997
  * @remarks
1981
- * The ID of a key that is managed by Key Management Service (KMS). The key is used to encrypt data disks. For more information, see [KMS](https://help.aliyun.com/document_detail/28935.html).
1998
+ * The ID of the Key Management Service (KMS) key that is used to encrypt the system disk. For more information, see [What is KMS?](https://help.aliyun.com/document_detail/28935.html)
1982
1999
  *
1983
2000
  * > The key can be used only in ACK Pro clusters.
1984
2001
  *
@@ -1990,8 +2007,8 @@ export class CreateClusterRequest extends $tea.Model {
1990
2007
  * @remarks
1991
2008
  * Specifies whether to enable Internet access for the cluster. You can use an elastic IP address (EIP) to expose the API server. This way, you can access the cluster over the Internet. Valid values:
1992
2009
  *
1993
- * * `true`: enables Internet access.
1994
- * * `false`: disables Internet access. If you set this parameter to false, the API server cannot be accessed over the Internet.
2010
+ * * `true`: enables Internet access for the cluster.
2011
+ * * `false`: disables Internet access for the cluster. If you set the value to false, the API server cannot be accessed over the Internet.
1995
2012
  *
1996
2013
  * Default value: `false`.
1997
2014
  *
@@ -2003,7 +2020,7 @@ export class CreateClusterRequest extends $tea.Model {
2003
2020
  * @remarks
2004
2021
  * Specifies whether to mount a data disk to a node that is created based on an existing ECS instance. Valid values:
2005
2022
  *
2006
- * * `true`: stores the data of containers and images on a data disk. Back up the existing data on the data disk first.
2023
+ * * `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.
2007
2024
  * * `false`: does not store the data of containers and images on a data disk.
2008
2025
  *
2009
2026
  * Default value: `false`.
@@ -2019,7 +2036,7 @@ export class CreateClusterRequest extends $tea.Model {
2019
2036
  formatDisk?: boolean;
2020
2037
  /**
2021
2038
  * @remarks
2022
- * Specifies a custom image for nodes. By default, the image provided by ACK is used. You can select a custom image to replace the default image. For more information, see [Custom images](https://help.aliyun.com/document_detail/146647.html).
2039
+ * The custom image. By default, the image provided by ACK is used. You can select a custom image to replace the default image. For more information, see [Use a custom image to create an ACK cluster](https://help.aliyun.com/document_detail/146647.html).
2023
2040
  *
2024
2041
  * @example
2025
2042
  * m-bp16z7xko3vvv8gt****
@@ -2047,9 +2064,9 @@ export class CreateClusterRequest extends $tea.Model {
2047
2064
  imageType?: string;
2048
2065
  /**
2049
2066
  * @remarks
2050
- * The list of existing Elastic Compute Service (ECS) instances that are specified as worker nodes for the cluster.
2067
+ * The existing ECS instances that are specified as worker nodes for the cluster.
2051
2068
  *
2052
- * > This parameter is required when you create worker nodes based on existing ECS instances.
2069
+ * > This parameter is required if you create worker nodes on existing ECS instances.
2053
2070
  */
2054
2071
  instances?: string[];
2055
2072
  /**
@@ -2063,9 +2080,9 @@ export class CreateClusterRequest extends $tea.Model {
2063
2080
  ipStack?: string;
2064
2081
  /**
2065
2082
  * @remarks
2066
- * Specifies whether to create an advanced security group. This parameter takes effect only if `security_group_id` is left empty.
2083
+ * Specifies whether to create an advanced security group. This parameter takes effect only if `security_group_id` is not specified.
2067
2084
  *
2068
- * > To use a basic security group, make sure that the sum of the number of nodes in the cluster and the number of pods that use Terway does not exceed 2,000. Therefore, we recommend that you specify an advanced security group for a cluster that has Terway installed.
2085
+ * > To use a basic security group, make sure that the sum of the number of nodes in the cluster and the number of pods that use Terway does not exceed 2,000. Therefore, we recommend that you specify an advanced security group for a cluster that uses Terway.
2069
2086
  *
2070
2087
  * * `true`: creates an advanced security group.
2071
2088
  * * `false`: does not create an advanced security group.
@@ -2091,7 +2108,7 @@ export class CreateClusterRequest extends $tea.Model {
2091
2108
  keepInstanceName?: boolean;
2092
2109
  /**
2093
2110
  * @remarks
2094
- * The name of the key pair. You must configure this parameter or the `login_password` parameter.
2111
+ * The name of the key pair. You must specify this parameter or the `login_password` parameter.
2095
2112
  *
2096
2113
  * @example
2097
2114
  * secrity-key
@@ -2099,14 +2116,18 @@ export class CreateClusterRequest extends $tea.Model {
2099
2116
  keyPair?: string;
2100
2117
  /**
2101
2118
  * @remarks
2102
- * The Kubernetes version of the cluster. The Kubernetes versions supported by ACK are the same as the Kubernetes versions supported by open source Kubernetes. We recommend that you specify the latest Kubernetes version. If you do not configure this parameter, the latest Kubernetes version is used.
2119
+ * The Kubernetes version of the cluster. The Kubernetes versions supported by ACK are the same as the Kubernetes versions supported by open source Kubernetes. We recommend that you specify the latest Kubernetes version. If you do not specify this parameter, the latest Kubernetes version is used.
2103
2120
  *
2104
- * You can create clusters of the latest two Kubernetes versions in the ACK console. If you want to create clusters that run earlier Kubernetes versions, use the API. For more information about the Kubernetes versions supported by ACK, see [Release notes on Kubernetes versions](https://help.aliyun.com/document_detail/185269.html).
2121
+ * You can create clusters of the latest two Kubernetes versions in the ACK console. If you want to create clusters that run earlier Kubernetes versions, use the ACK API. For more information about the Kubernetes versions supported by ACK, see [Support for Kubernetes versions](https://help.aliyun.com/document_detail/185269.html).
2105
2122
  *
2106
2123
  * @example
2107
2124
  * 1.16.9-aliyun.1
2108
2125
  */
2109
2126
  kubernetesVersion?: string;
2127
+ /**
2128
+ * @example
2129
+ * lb-wz9t256gqa3vbouk****
2130
+ */
2110
2131
  loadBalancerId?: string;
2111
2132
  /**
2112
2133
  * @remarks
@@ -2127,7 +2148,7 @@ export class CreateClusterRequest extends $tea.Model {
2127
2148
  loadBalancerSpec?: string;
2128
2149
  /**
2129
2150
  * @remarks
2130
- * Enables Simple Log Service for the cluster. This parameter takes effect only on ACK Serverless clusters. Set the value to `SLS`.
2151
+ * Enables Simple Log Service for the cluster. This parameter takes effect only for ACK Serverless clusters. Valid value: `SLS`.
2131
2152
  *
2132
2153
  * @example
2133
2154
  * SLS
@@ -2135,7 +2156,7 @@ export class CreateClusterRequest extends $tea.Model {
2135
2156
  loggingType?: string;
2136
2157
  /**
2137
2158
  * @remarks
2138
- * The password for SSH logon. You must configure 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.
2159
+ * 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.
2139
2160
  *
2140
2161
  * @example
2141
2162
  * Hello@1234
@@ -2143,7 +2164,7 @@ export class CreateClusterRequest extends $tea.Model {
2143
2164
  loginPassword?: string;
2144
2165
  /**
2145
2166
  * @remarks
2146
- * Specifies whether to enable auto-renewal for master nodes. This parameter takes effect only if `master_instance_charge_type` is set to `PrePaid`. Valid values:
2167
+ * Specifies whether to enable auto-renewal for master nodes. This parameter takes effect only when `master_instance_charge_type` is set to `PrePaid`. Valid values:
2147
2168
  *
2148
2169
  * * `true`: enables auto-renewal.
2149
2170
  * * `false`: disables auto-renewal.
@@ -2156,7 +2177,7 @@ export class CreateClusterRequest extends $tea.Model {
2156
2177
  masterAutoRenew?: boolean;
2157
2178
  /**
2158
2179
  * @remarks
2159
- * The cycle of auto-renewal. This parameter takes effect and is required only if the subscription billing method is selected for master nodes.
2180
+ * The auto-renewal duration. This parameter takes effect and is required only when the subscription billing method is selected for master nodes.
2160
2181
  *
2161
2182
  * Valid values: 1, 2, 3, 6, and 12.
2162
2183
  *
@@ -2181,7 +2202,7 @@ export class CreateClusterRequest extends $tea.Model {
2181
2202
  * The billing method of master nodes. Valid values:
2182
2203
  *
2183
2204
  * * `PrePaid`: subscription.
2184
- * * `PostPaid`: pay-as-you-go.
2205
+ * * `PostPaid`: the pay-as-you-go.
2185
2206
  *
2186
2207
  * Default value: `PostPaid`.
2187
2208
  *
@@ -2196,7 +2217,7 @@ export class CreateClusterRequest extends $tea.Model {
2196
2217
  masterInstanceTypes?: string[];
2197
2218
  /**
2198
2219
  * @remarks
2199
- * The subscription duration of master nodes. This parameter takes effect and is required only if `master_instance_charge_type` is set to `PrePaid`.
2220
+ * The subscription duration of master nodes. This parameter takes effect and is required only when `master_instance_charge_type` is set to `PrePaid`.
2200
2221
  *
2201
2222
  * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
2202
2223
  *
@@ -2208,9 +2229,9 @@ export class CreateClusterRequest extends $tea.Model {
2208
2229
  masterPeriod?: number;
2209
2230
  /**
2210
2231
  * @remarks
2211
- * The billing cycle of master nodes. This parameter is required if master_instance_charge_type is set to `PrePaid`.
2232
+ * The billing cycle of the master nodes in the cluster. This parameter is required if master_instance_charge_type is set to `PrePaid`.
2212
2233
  *
2213
- * Set the value to `Month`. Master nodes are billed only on a monthly basis.
2234
+ * Valid value: `Month`, which indicates that master nodes are billed only on a monthly basis.
2214
2235
  *
2215
2236
  * @example
2216
2237
  * Month
@@ -2218,11 +2239,11 @@ export class CreateClusterRequest extends $tea.Model {
2218
2239
  masterPeriodUnit?: string;
2219
2240
  /**
2220
2241
  * @remarks
2221
- * The type of system disk that you want to use for the master nodes. Valid values:
2242
+ * The system disk type of master nodes. Valid values:
2222
2243
  *
2223
2244
  * * `cloud_efficiency`: ultra disk.
2224
2245
  * * `cloud_ssd`: standard SSD.
2225
- * * `cloud_essd`: enhanced SSD (ESSD).
2246
+ * * `cloud_essd`: Enterprise SSD (ESSD).
2226
2247
  *
2227
2248
  * Default value: `cloud_ssd`. The default value may vary in different zones.
2228
2249
  *
@@ -2240,7 +2261,7 @@ export class CreateClusterRequest extends $tea.Model {
2240
2261
  masterSystemDiskPerformanceLevel?: string;
2241
2262
  /**
2242
2263
  * @remarks
2243
- * The size of the system disk that is specified for master nodes. Valid values: 40 to 500. Unit: GiB.
2264
+ * The system disk size of master nodes. Valid values: 40 to 500. Unit: GiB.
2244
2265
  *
2245
2266
  * Default value: `120`.
2246
2267
  *
@@ -2260,12 +2281,12 @@ export class CreateClusterRequest extends $tea.Model {
2260
2281
  * @remarks
2261
2282
  * 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.
2262
2283
  *
2263
- * The number of vSwitches must be the same as that specified in `master_count` and the same as those specified in `master_vswitch_ids`.
2284
+ * 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.
2264
2285
  */
2265
2286
  masterVswitchIds?: string[];
2266
2287
  /**
2267
2288
  * @remarks
2268
- * The name of the cluster.
2289
+ * The cluster name.
2269
2290
  *
2270
2291
  * The name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). The name cannot start with a hyphen (-).
2271
2292
  *
@@ -2277,10 +2298,10 @@ export class CreateClusterRequest extends $tea.Model {
2277
2298
  name?: string;
2278
2299
  /**
2279
2300
  * @remarks
2280
- * Specifies whether to create a NAT gateway and configure SNAT rules when the system creates the ACK Serverless cluster. Valid values:
2301
+ * Specifies whether to create a NAT gateway and configure SNAT rules if you create an ACK Serverless cluster. Valid values:
2281
2302
  *
2282
2303
  * * `true`: automatically creates a NAT gateway and configures SNAT rules. This enables Internet access for the VPC in which the cluster is deployed.
2283
- * * `false`: does not create a NAT gateway or configure SNAT rules. In this case, the cluster in the VPC cannot access the Internet.
2304
+ * * `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.
2284
2305
  *
2285
2306
  * Default value: `false`.
2286
2307
  *
@@ -2290,7 +2311,7 @@ export class CreateClusterRequest extends $tea.Model {
2290
2311
  natGateway?: boolean;
2291
2312
  /**
2292
2313
  * @remarks
2293
- * 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 as the network plug-in.
2314
+ * 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.
2294
2315
  *
2295
2316
  * Default value: `26`.
2296
2317
  *
@@ -2300,14 +2321,14 @@ export class CreateClusterRequest extends $tea.Model {
2300
2321
  nodeCidrMask?: string;
2301
2322
  /**
2302
2323
  * @remarks
2303
- * The name of the custom node.
2324
+ * The custom node name.
2304
2325
  *
2305
- * A node name consists of a prefix, an IP substring, and a suffix.
2326
+ * A custom node name consists of a prefix, a node IP address, and a suffix.
2306
2327
  *
2307
2328
  * * 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.
2308
2329
  * * 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.
2309
2330
  *
2310
- * 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 be aliyun.com00055test.
2331
+ * 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.
2311
2332
  *
2312
2333
  * @example
2313
2334
  * aliyun.com00055test
@@ -2353,7 +2374,7 @@ export class CreateClusterRequest extends $tea.Model {
2353
2374
  osType?: string;
2354
2375
  /**
2355
2376
  * @remarks
2356
- * The subscription duration. This parameter takes effect and is required only if you set charge_type to PrePaid.
2377
+ * The subscription duration of the instance. This parameter takes effect and is required only when you set charge_type to PrePaid.
2357
2378
  *
2358
2379
  * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
2359
2380
  *
@@ -2367,7 +2388,7 @@ export class CreateClusterRequest extends $tea.Model {
2367
2388
  * @remarks
2368
2389
  * The billing cycle. This parameter is required if charge_type is set to PrePaid.
2369
2390
  *
2370
- * Set the value to Month. Master nodes are billed only on a monthly basis.
2391
+ * Set the value to Month. Subscription clusters are billed only on a monthly basis.
2371
2392
  *
2372
2393
  * @example
2373
2394
  * Month
@@ -2375,7 +2396,7 @@ export class CreateClusterRequest extends $tea.Model {
2375
2396
  periodUnit?: string;
2376
2397
  /**
2377
2398
  * @remarks
2378
- * The OS distribution. Valid values:
2399
+ * The OS distribution that is used. Valid values:
2379
2400
  *
2380
2401
  * * CentOS
2381
2402
  * * AliyunLinux
@@ -2392,9 +2413,9 @@ export class CreateClusterRequest extends $tea.Model {
2392
2413
  platform?: string;
2393
2414
  /**
2394
2415
  * @remarks
2395
- * The list of pod vSwitches. You need to specify at least one pod vSwitch for each node vSwitch, and the pod vSwitches must be different from the node vSwitches (`vswitch`). We recommend that you specify pod vSwitches whose mask lengths are no longer than 19.
2416
+ * 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.
2396
2417
  *
2397
- * > The `pod_vswitch_ids` parameter is required if the cluster uses Terway as the network plug-in.
2418
+ * > 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.
2398
2419
  */
2399
2420
  podVswitchIds?: string[];
2400
2421
  /**
@@ -2414,8 +2435,8 @@ export class CreateClusterRequest extends $tea.Model {
2414
2435
  * @remarks
2415
2436
  * The kube-proxy mode. Valid values:
2416
2437
  *
2417
- * * `iptables`: iptables is a kube-proxy mode. It 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.
2418
- * * `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 when high load balancing performance is required.
2438
+ * * `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.
2439
+ * * `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.
2419
2440
  *
2420
2441
  * Default value: `ipvs`.
2421
2442
  *
@@ -2425,12 +2446,12 @@ export class CreateClusterRequest extends $tea.Model {
2425
2446
  proxyMode?: string;
2426
2447
  /**
2427
2448
  * @remarks
2428
- * The list of ApsaraDB RDS instances. Select the ApsaraDB RDS instances that you want to add to the whitelist. We recommend that you add the CIDR block of pods and CIDR block of nodes to the ApsaraDB RDS instances in the ApsaraDB RDS console. When you set the ApsaraDB RDS instances, you cannot scale out the number of nodes because the instances are not in the Running state.
2449
+ * 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.
2429
2450
  */
2430
2451
  rdsInstances?: string[];
2431
2452
  /**
2432
2453
  * @remarks
2433
- * The ID of the region in which you want to deploy the cluster.
2454
+ * The ID of the region in which the cluster is deployed.
2434
2455
  *
2435
2456
  * This parameter is required.
2436
2457
  *
@@ -2450,12 +2471,12 @@ export class CreateClusterRequest extends $tea.Model {
2450
2471
  * @remarks
2451
2472
  * The container runtime. The default container runtime is Docker. containerd and Sandboxed-Container are also supported.
2452
2473
  *
2453
- * For more information about how to select a proper container runtime, see [How to select between Docker and Sandboxed-Container](https://help.aliyun.com/document_detail/160313.html).
2474
+ * For more information about how to select a proper container runtime, see [Comparison among Docker, containerd, and Sandboxed-Container](https://help.aliyun.com/document_detail/160313.html).
2454
2475
  */
2455
2476
  runtime?: Runtime;
2456
2477
  /**
2457
2478
  * @remarks
2458
- * The ID of an existing security group. You need to choose between this parameter and the `is_enterprise_security_group` parameter. Cluster nodes are automatically added to the security group.
2479
+ * 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.
2459
2480
  *
2460
2481
  * @example
2461
2482
  * sg-bp1bdue0qc1g7k****
@@ -2463,14 +2484,12 @@ export class CreateClusterRequest extends $tea.Model {
2463
2484
  securityGroupId?: string;
2464
2485
  /**
2465
2486
  * @remarks
2466
- * Specifies whether to enable Alibaba Cloud Linux Security Hardening.
2467
- *
2468
- * Valid values:
2487
+ * Specifies whether to enable Alibaba Cloud Linux Security Hardening. Valid values:
2469
2488
  *
2470
- * - true: enables Alibaba Cloud Linux Security Hardening.
2471
- * - false: disables Alibaba Cloud Linux Security Hardening.
2489
+ * * `true`: enables Alibaba Cloud Linux Security Hardening.
2490
+ * * `false`: disables Alibaba Cloud Linux Security Hardening.
2472
2491
  *
2473
- * Default value: false
2492
+ * Default value: `false`.
2474
2493
  *
2475
2494
  * @example
2476
2495
  * false
@@ -2478,9 +2497,9 @@ export class CreateClusterRequest extends $tea.Model {
2478
2497
  securityHardeningOs?: boolean;
2479
2498
  /**
2480
2499
  * @remarks
2481
- * Service accounts provide identities for pods when pods communicate with the `API server` of the cluster. `service-account-issuer` is the issuer of the `serviceaccount token`, which corresponds to the `iss` field in the `token payload`.
2500
+ * 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
2501
  *
2483
- * For more information about `ServiceAccount`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
2502
+ * For more information about `service accounts`, see [Enable service account token volume projection](https://help.aliyun.com/document_detail/160384.html).
2484
2503
  *
2485
2504
  * @example
2486
2505
  * kubernetes.default.svc
@@ -2488,9 +2507,9 @@ export class CreateClusterRequest extends $tea.Model {
2488
2507
  serviceAccountIssuer?: string;
2489
2508
  /**
2490
2509
  * @remarks
2491
- * The CIDR block of Services. Valid values: 10.0.0.0/16-24, 172.16-31.0.0/16-24, and 192.168.0.0/16-24. The CIDR block of Services 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.
2510
+ * 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
2511
  *
2493
- * By default, the CIDR block of Services is set to 172.19.0.0/20.
2512
+ * By default, the Service CIDR block is set to 172.19.0.0/20.
2494
2513
  *
2495
2514
  * This parameter is required.
2496
2515
  *
@@ -2502,20 +2521,20 @@ export class CreateClusterRequest extends $tea.Model {
2502
2521
  * @remarks
2503
2522
  * The type of service discovery that is implemented in the `ACK Serverless` cluster.
2504
2523
  *
2505
- * * `CoreDNS`: CoreDNS is a standard service discovery plug-in that is provided by open source Kubernetes. To use DNS resolution, you must provision pods. By default, two elastic container instances are used. The specification of each instance is 0.25 vCores and 512 MiB of memory.
2506
- * * `PrivateZone`: a DNS resolution service provided by Alibaba Cloud. You must activate Alibaba Cloud DNS PrivateZone before you can use it for service discovery.
2524
+ * * `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.
2525
+ * * `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.
2507
2526
  *
2508
2527
  * By default, this parameter is not specified.
2509
2528
  */
2510
2529
  serviceDiscoveryTypes?: string[];
2511
2530
  /**
2512
2531
  * @remarks
2513
- * Specifies whether to configure Source Network Address Translation (SNAT) rules for the VPC in which the cluster is deployed. Valid values:
2532
+ * Specifies whether to configure SNAT rules for the VPC in which your cluster is deployed. Valid values:
2514
2533
  *
2515
- * * `true`: automatically creates a NAT gateway and configures SNAT rules. Set this parameter to `true` if nodes and applications in the cluster need to access the Internet.
2534
+ * * `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.
2516
2535
  * * `false`: does not create a NAT gateway or configure SNAT rules. In this case, nodes and applications in the cluster cannot access the Internet.
2517
2536
  *
2518
- * > If this feature is disabled when you create the cluster, you can manually enable this feature after you create the cluster. For more information, see [Manually create a NAT gateway and configure SNAT rules](https://help.aliyun.com/document_detail/178480.html).
2537
+ * > 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).
2519
2538
  *
2520
2539
  * Default value: `true`.
2521
2540
  *
@@ -2525,12 +2544,12 @@ export class CreateClusterRequest extends $tea.Model {
2525
2544
  snatEntry?: boolean;
2526
2545
  /**
2527
2546
  * @remarks
2528
- * Specifies whether to enable reinforcement based on Multi-Level Protection Scheme (MLPS). For more information, see [ACK reinforcement based on classified protection](https://help.aliyun.com/document_detail/196148.html).
2547
+ * Specifies whether to enable security hardening based on Multi-Level Protection Scheme (MLPS). For more information, see [ACK security hardening based on MLPS](https://help.aliyun.com/document_detail/196148.html).
2529
2548
  *
2530
2549
  * Valid values:
2531
2550
  *
2532
- * * `true`: enables reinforcement based on MLPS.
2533
- * * `false`: disables reinforcement based on MLPS.
2551
+ * * `true`: enables security hardening based on MLPS.
2552
+ * * `false`: disables security hardening based on MLPS.
2534
2553
  *
2535
2554
  * Default value: `false`.
2536
2555
  *
@@ -2561,7 +2580,7 @@ export class CreateClusterRequest extends $tea.Model {
2561
2580
  tags?: Tag[];
2562
2581
  /**
2563
2582
  * @remarks
2564
- * The taints of the nodes in the node pool. Taints can be used together with tolerations to avoid scheduling pods to specified nodes. For more information, see [taint-and-toleration](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/).
2583
+ * 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
2584
  */
2566
2585
  taints?: Taint[];
2567
2586
  /**
@@ -2600,9 +2619,7 @@ export class CreateClusterRequest extends $tea.Model {
2600
2619
  userData?: string;
2601
2620
  /**
2602
2621
  * @remarks
2603
- * The ID of the virtual private cloud (VPC) in which you want to deploy the cluster. This parameter is required.
2604
- *
2605
- * This parameter is required.
2622
+ * The virtual private cloud (VPC) in which you want to deploy the cluster. This parameter is required.
2606
2623
  *
2607
2624
  * @example
2608
2625
  * vpc-2zeik9h3ahvv2zz95****
@@ -2610,19 +2627,17 @@ export class CreateClusterRequest extends $tea.Model {
2610
2627
  vpcid?: string;
2611
2628
  /**
2612
2629
  * @remarks
2613
- * The vSwitches that are specified for nodes in the cluster. This parameter is required when you create an ACK managed cluster that does not contain nodes.
2614
- *
2615
- * This parameter is required.
2630
+ * The vSwitches for nodes in the cluster. This parameter is required if you create an ACK managed cluster that does not contain nodes.
2616
2631
  */
2617
2632
  vswitchIds?: string[];
2618
2633
  /**
2619
2634
  * @remarks
2620
- * 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:
2635
+ * 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:
2621
2636
  *
2622
2637
  * * `true`: enables auto-renewal.
2623
2638
  * * `false`: disables auto-renewal.
2624
2639
  *
2625
- * Default value: `true`.
2640
+ * Default value: `true`
2626
2641
  *
2627
2642
  * @example
2628
2643
  * true
@@ -2632,7 +2647,7 @@ export class CreateClusterRequest extends $tea.Model {
2632
2647
  workerAutoRenew?: boolean;
2633
2648
  /**
2634
2649
  * @remarks
2635
- * The cycle of auto-renewal. This parameter takes effect and is required only if the subscription billing method is selected for worker nodes.
2650
+ * The auto-renewal duration. This parameter takes effect and is required only when the subscription billing method is selected for worker nodes.
2636
2651
  *
2637
2652
  * Valid values: 1, 2, 3, 6, and 12.
2638
2653
  *
@@ -2673,7 +2688,7 @@ export class CreateClusterRequest extends $tea.Model {
2673
2688
  workerInstanceTypes?: string[];
2674
2689
  /**
2675
2690
  * @remarks
2676
- * The subscription duration of worker nodes. This parameter takes effect and is required only if `worker_instance_charge_type` is set to `PrePaid`.
2691
+ * The subscription duration of worker nodes. This parameter takes effect and is required only when `worker_instance_charge_type` is set to `PrePaid`.
2677
2692
  *
2678
2693
  * Valid values: 1, 2, 3, 6, 12, 24, 36, 48, and 60.
2679
2694
  *
@@ -2689,7 +2704,7 @@ export class CreateClusterRequest extends $tea.Model {
2689
2704
  * @remarks
2690
2705
  * The billing cycle of worker nodes. This parameter is required if worker_instance_charge_type is set to `PrePaid`.
2691
2706
  *
2692
- * Set the value to `Month`. Worker nodes are billed only on a monthly basis.
2707
+ * Set the value to `Month`. Subscription worker nodes are billed only on a monthly basis.
2693
2708
  *
2694
2709
  * @example
2695
2710
  * Month
@@ -2699,7 +2714,7 @@ export class CreateClusterRequest extends $tea.Model {
2699
2714
  workerPeriodUnit?: string;
2700
2715
  /**
2701
2716
  * @remarks
2702
- * The category of the system disks for worker nodes. For more information, see [Elastic Block Storage devices](https://help.aliyun.com/document_detail/63136.html).
2717
+ * The system disk type of worker nodes. For more information, see [Overview of Block Storage](https://help.aliyun.com/document_detail/63136.html).
2703
2718
  *
2704
2719
  * Valid values:
2705
2720
  *
@@ -2716,7 +2731,7 @@ export class CreateClusterRequest extends $tea.Model {
2716
2731
  workerSystemDiskCategory?: string;
2717
2732
  /**
2718
2733
  * @remarks
2719
- * If the system disk is an ESSD, you can set the PL of the ESSD. For more information, see [ESSDs](https://help.aliyun.com/document_detail/122389.html).
2734
+ * If the system disk is an ESSD, you can specify the PL of the ESSD. For more information, see [Enterprise SSDs](https://help.aliyun.com/document_detail/122389.html).
2720
2735
  *
2721
2736
  * Valid values:
2722
2737
  *
@@ -2737,7 +2752,7 @@ export class CreateClusterRequest extends $tea.Model {
2737
2752
  *
2738
2753
  * Valid values: 40 to 500.
2739
2754
  *
2740
- * The value of this parameter must be at least 40 and no less than the image size.
2755
+ * The value of this parameter must be at least 40 and greater than or equal to the image size.
2741
2756
  *
2742
2757
  * Default value: `120`.
2743
2758
  *
@@ -2759,28 +2774,33 @@ export class CreateClusterRequest extends $tea.Model {
2759
2774
  workerSystemDiskSnapshotPolicyId?: string;
2760
2775
  /**
2761
2776
  * @remarks
2762
- * The list of vSwitches that are specified for nodes. Each node is allocated a vSwitch.
2777
+ * The vSwitches for worker nodes. Each worker node is allocated a vSwitch.
2763
2778
  *
2764
- * The `worker_vswitch_ids` parameter is optional but the `vswitch_ids` parameter is required when you create an ACK managed cluster that does not contain nodes.
2779
+ * `worker_vswitch_ids` is optional but `vswitch_ids` is required if you create an ACK managed cluster that does not contain nodes.
2765
2780
  *
2766
2781
  * @deprecated
2767
2782
  */
2768
2783
  workerVswitchIds?: string[];
2769
2784
  /**
2770
2785
  * @remarks
2771
- * The ID of the zone to which the cluster belongs. This parameter takes effect for only ACK Serverless clusters.
2786
+ * The ID of the zone to which the cluster belongs. This parameter takes effect only for ACK Serverless clusters.
2772
2787
  *
2773
- * When you create an ACK Serverless cluster, you must configure `zone_id` if `vpc_id` and `vswitch_ids` are not configured. This way, the system automatically creates a VPC in the specified zone.
2788
+ * 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.
2774
2789
  *
2775
2790
  * @example
2776
2791
  * cn-beiji****
2792
+ *
2793
+ * @deprecated
2777
2794
  */
2778
2795
  zoneId?: string;
2796
+ zoneIds?: string[];
2779
2797
  static names(): { [key: string]: string } {
2780
2798
  return {
2781
2799
  accessControlList: 'access_control_list',
2782
2800
  addons: 'addons',
2783
2801
  apiAudiences: 'api_audiences',
2802
+ autoRenew: 'auto_renew',
2803
+ autoRenewPeriod: 'auto_renew_period',
2784
2804
  chargeType: 'charge_type',
2785
2805
  cisEnabled: 'cis_enabled',
2786
2806
  cloudMonitorFlags: 'cloud_monitor_flags',
@@ -2870,6 +2890,7 @@ export class CreateClusterRequest extends $tea.Model {
2870
2890
  workerSystemDiskSnapshotPolicyId: 'worker_system_disk_snapshot_policy_id',
2871
2891
  workerVswitchIds: 'worker_vswitch_ids',
2872
2892
  zoneId: 'zone_id',
2893
+ zoneIds: 'zone_ids',
2873
2894
  };
2874
2895
  }
2875
2896
 
@@ -2878,6 +2899,8 @@ export class CreateClusterRequest extends $tea.Model {
2878
2899
  accessControlList: { 'type': 'array', 'itemType': 'string' },
2879
2900
  addons: { 'type': 'array', 'itemType': Addon },
2880
2901
  apiAudiences: 'string',
2902
+ autoRenew: 'boolean',
2903
+ autoRenewPeriod: 'number',
2881
2904
  chargeType: 'string',
2882
2905
  cisEnabled: 'boolean',
2883
2906
  cloudMonitorFlags: 'boolean',
@@ -2967,6 +2990,7 @@ export class CreateClusterRequest extends $tea.Model {
2967
2990
  workerSystemDiskSnapshotPolicyId: 'string',
2968
2991
  workerVswitchIds: { 'type': 'array', 'itemType': 'string' },
2969
2992
  zoneId: 'string',
2993
+ zoneIds: { 'type': 'array', 'itemType': 'string' },
2970
2994
  };
2971
2995
  }
2972
2996
 
@@ -3048,11 +3072,51 @@ export class CreateClusterResponse extends $tea.Model {
3048
3072
 
3049
3073
  export class CreateClusterDiagnosisRequest extends $tea.Model {
3050
3074
  /**
3075
+ * @remarks
3076
+ * The parameter used to specify the diagnostic object. Examples of parameters for different types of diagnostic objects:
3077
+ *
3078
+ * node:
3079
+ *
3080
+ * {"name": "cn-shanghai.10.10.10.107"}
3081
+ *
3082
+ * pod
3083
+ *
3084
+ * {"namespace": "kube-system", "name": "csi-plugin-2cg9f"}
3085
+ *
3086
+ * network
3087
+ *
3088
+ * {"src": "10.10.10.108", "dst": "10.11.247.16", "dport": "80"}
3089
+ *
3090
+ * ingress
3091
+ *
3092
+ * {"url": "https://example.com"}
3093
+ *
3094
+ * memory
3095
+ *
3096
+ * {"node":"cn-hangzhou.172.16.9.240"}
3097
+ *
3098
+ * service
3099
+ *
3100
+ * {"namespace": "kube-system", "name": "nginx-ingress-lb"}
3101
+ *
3051
3102
  * @example
3052
3103
  * {"namespace": "kube-system", "name": "csi-plugin-2cg9f"}
3053
3104
  */
3054
3105
  target?: { [key: string]: any };
3055
3106
  /**
3107
+ * @remarks
3108
+ * The type of the diagnostic.
3109
+ *
3110
+ * Valid values:
3111
+ *
3112
+ * * node
3113
+ * * ingress
3114
+ * * cluster
3115
+ * * memory
3116
+ * * pod
3117
+ * * service
3118
+ * * network
3119
+ *
3056
3120
  * @example
3057
3121
  * node
3058
3122
  */
@@ -3078,16 +3142,25 @@ export class CreateClusterDiagnosisRequest extends $tea.Model {
3078
3142
 
3079
3143
  export class CreateClusterDiagnosisResponseBody extends $tea.Model {
3080
3144
  /**
3145
+ * @remarks
3146
+ * The cluster ID.
3147
+ *
3081
3148
  * @example
3082
3149
  * c5cdf7e3938bc4f8eb0e44b21a80f****
3083
3150
  */
3084
3151
  clusterId?: string;
3085
3152
  /**
3153
+ * @remarks
3154
+ * The diagnostic ID.
3155
+ *
3086
3156
  * @example
3087
3157
  * 6f719f23098240818eb26fe3a37d****
3088
3158
  */
3089
3159
  diagnosisId?: string;
3090
3160
  /**
3161
+ * @remarks
3162
+ * The request ID.
3163
+ *
3091
3164
  * @example
3092
3165
  * 687C5BAA-D103-4993-884B-C35E4314****
3093
3166
  */
@@ -3146,7 +3219,7 @@ export class CreateClusterNodePoolRequest extends $tea.Model {
3146
3219
  autoScaling?: CreateClusterNodePoolRequestAutoScaling;
3147
3220
  /**
3148
3221
  * @remarks
3149
- * This parameter is discontinued. Use desired_size.
3222
+ * This parameter is deprecated. Use desired_size instead.
3150
3223
  *
3151
3224
  * The number of nodes in the node pool.
3152
3225
  *
@@ -3158,7 +3231,7 @@ export class CreateClusterNodePoolRequest extends $tea.Model {
3158
3231
  count?: number;
3159
3232
  /**
3160
3233
  * @remarks
3161
- * This parameter is discontinued.
3234
+ * This parameter is deprecated.
3162
3235
  *
3163
3236
  * The configurations of the edge node pool.
3164
3237
  *
@@ -3167,10 +3240,10 @@ export class CreateClusterNodePoolRequest extends $tea.Model {
3167
3240
  interconnectConfig?: CreateClusterNodePoolRequestInterconnectConfig;
3168
3241
  /**
3169
3242
  * @remarks
3170
- * The network type of the edge node pool. This parameter takes effect only if you set the `type` parameter of the node pool to `edge`. Valid values:
3243
+ * 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:
3171
3244
  *
3172
- * * `basic`: basic.
3173
- * * `private`: dedicated. Only Kubernetes 1.22 and later support this value.
3245
+ * * `basic`: basic
3246
+ * * `private`: dedicated Only Kubernetes 1.22 and later support this value.
3174
3247
  *
3175
3248
  * @example
3176
3249
  * basic
@@ -3178,7 +3251,7 @@ export class CreateClusterNodePoolRequest extends $tea.Model {
3178
3251
  interconnectMode?: string;
3179
3252
  /**
3180
3253
  * @remarks
3181
- * The cluster configurations.
3254
+ * The configurations of the cluster.
3182
3255
  */
3183
3256
  kubernetesConfig?: CreateClusterNodePoolRequestKubernetesConfig;
3184
3257
  /**
@@ -3188,7 +3261,10 @@ export class CreateClusterNodePoolRequest extends $tea.Model {
3188
3261
  management?: CreateClusterNodePoolRequestManagement;
3189
3262
  /**
3190
3263
  * @remarks
3191
- * The maximum number of nodes that can be created in the edge node pool. The value of this parameter must be greater than or equal to 0. A value of 0 indicates that the number of nodes in the node pool is limited only by the quota of nodes in the cluster. In most cases, this parameter is set to a value greater than 0 for edge node pools. This parameter is set to 0 for node pools whose types are ess or default edge node pools.
3264
+ * The maximum number of nodes that can be contained in the edge node pool. The value of this parameter must be greater than or equal to 0. A value of 0 indicates that the number of nodes in the node pool is limited only by the quota of nodes in the cluster.
3265
+ *
3266
+ * * In most cases, this parameter is set to a value greater than 0 for edge node pools.
3267
+ * * This parameter is set to 0 for node pools whose types are ess or default edge node pools.
3192
3268
  *
3193
3269
  * @example
3194
3270
  * 10
@@ -4052,12 +4128,12 @@ export class DeleteClusterRequest extends $tea.Model {
4052
4128
  deleteOptions?: DeleteClusterRequestDeleteOptions[];
4053
4129
  /**
4054
4130
  * @remarks
4055
- * Specifies whether to retain the Server Load Balancer (SLB) instances that are created by the cluster.
4131
+ * Specifies whether to retain the Server Load Balancer (SLB) resources that are created by the cluster.
4056
4132
  *
4057
4133
  * * `true`: retains the SLB instances that are created by the cluster.
4058
4134
  * * `false`: does not retain the SLB instances that are created by the cluster.
4059
4135
  *
4060
- * Default value: `false`.
4136
+ * Default value: `false`. Set resource_type to `SLB` in the `delete_options` parameter to manage SLB instances.
4061
4137
  *
4062
4138
  * @example
4063
4139
  * false
@@ -4067,10 +4143,10 @@ export class DeleteClusterRequest extends $tea.Model {
4067
4143
  keepSlb?: boolean;
4068
4144
  /**
4069
4145
  * @remarks
4070
- * Specifies whether to retain all resources. If you set the parameter to `true`, the `retain_resources` parameter is ignored.
4146
+ * Specifies whether to retain all resources. If you set the parameter to `true`, the `retain_resources` parameter is ignored. The cloud resources that are created by the cluster are retained. You can call the `DescribeClusterResources` operation to query cloud resources created by the cluster. If you set the parameter to `false`, resources to be retained by default in the `delete_options` parameter are still retained. To delete these resources, set `delete_mode` to `delete` in `delete_options`.
4071
4147
  *
4072
- * * `true`: retains all resources.
4073
- * * `false`: does not retain all resources.
4148
+ * * `true`: retains all resources, including cloud resources created by the cluster.
4149
+ * * `false`: does not retain all resources. Resources to be retained by default in the `delete_options` parameter are retained. For example, `ALB` instances are retained when this parameter is set to `false`.
4074
4150
  *
4075
4151
  * Default value: `false`.
4076
4152
  *
@@ -4114,12 +4190,12 @@ export class DeleteClusterShrinkRequest extends $tea.Model {
4114
4190
  deleteOptionsShrink?: string;
4115
4191
  /**
4116
4192
  * @remarks
4117
- * Specifies whether to retain the Server Load Balancer (SLB) instances that are created by the cluster.
4193
+ * Specifies whether to retain the Server Load Balancer (SLB) resources that are created by the cluster.
4118
4194
  *
4119
4195
  * * `true`: retains the SLB instances that are created by the cluster.
4120
4196
  * * `false`: does not retain the SLB instances that are created by the cluster.
4121
4197
  *
4122
- * Default value: `false`.
4198
+ * Default value: `false`. Set resource_type to `SLB` in the `delete_options` parameter to manage SLB instances.
4123
4199
  *
4124
4200
  * @example
4125
4201
  * false
@@ -4129,10 +4205,10 @@ export class DeleteClusterShrinkRequest extends $tea.Model {
4129
4205
  keepSlb?: boolean;
4130
4206
  /**
4131
4207
  * @remarks
4132
- * Specifies whether to retain all resources. If you set the parameter to `true`, the `retain_resources` parameter is ignored.
4208
+ * Specifies whether to retain all resources. If you set the parameter to `true`, the `retain_resources` parameter is ignored. The cloud resources that are created by the cluster are retained. You can call the `DescribeClusterResources` operation to query cloud resources created by the cluster. If you set the parameter to `false`, resources to be retained by default in the `delete_options` parameter are still retained. To delete these resources, set `delete_mode` to `delete` in `delete_options`.
4133
4209
  *
4134
- * * `true`: retains all resources.
4135
- * * `false`: does not retain all resources.
4210
+ * * `true`: retains all resources, including cloud resources created by the cluster.
4211
+ * * `false`: does not retain all resources. Resources to be retained by default in the `delete_options` parameter are retained. For example, `ALB` instances are retained when this parameter is set to `false`.
4136
4212
  *
4137
4213
  * Default value: `false`.
4138
4214
  *
@@ -5120,12 +5196,10 @@ export class DescribeAddonsRequest extends $tea.Model {
5120
5196
  clusterProfile?: string;
5121
5197
  /**
5122
5198
  * @remarks
5123
- * The edition of the cluster. If you set the cluster type to `ManagedKubernetes`, the following editions are supported:
5199
+ * If you set `cluster_type` to `ManagedKubernetes` and specify `profile`, you can further specify the edition of the cluster. Valid values:
5124
5200
  *
5125
- * * `ack.pro.small`: ACK Pro cluster
5126
- * * `ack.standard`: ACK Basic cluster
5127
- *
5128
- * By default, this parameter is left empty. If you leave this parameter empty, clusters are not filtered by edition.
5201
+ * * `ack.pro.small`: creates an ACK Pro cluster.
5202
+ * * `ack.standard`: creates an ACK Basic cluster. If you leave the parameter empty, an ACK Basic cluster is created.
5129
5203
  *
5130
5204
  * @example
5131
5205
  * ack.pro.small
@@ -5133,10 +5207,8 @@ export class DescribeAddonsRequest extends $tea.Model {
5133
5207
  clusterSpec?: string;
5134
5208
  /**
5135
5209
  * @remarks
5136
- * The type of cluster. Valid values:
5137
- *
5138
5210
  * * `Kubernetes`: ACK dedicated cluster.
5139
- * * `ManagedKubernetes`: ACK managed cluster. ACK managed clusters include ACK Pro clusters, ACK Basic clusters, ACK Serverless Pro clusters, ACK Serverless Basic clusters, ACK Edge Pro clusters, and ACK Edge Basic clusters.
5211
+ * * `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.
5140
5212
  * * `ExternalKubernetes`: registered cluster.
5141
5213
  *
5142
5214
  * @example
@@ -5262,12 +5334,12 @@ export class DescribeClusterAddonInstanceResponseBody extends $tea.Model {
5262
5334
  * @remarks
5263
5335
  * The status of the component. Valid values:
5264
5336
  *
5265
- * * initial: The component is being installed.
5266
- * * active: The component is installed.
5267
- * * unhealthy: The component is in an abnormal state.
5268
- * * upgrading: The component is being updated.
5269
- * * updating: The component is being modified.
5270
- * * deleting: The component is being uninstalled.
5337
+ * * initial: the component is being installed.
5338
+ * * active: the component is installed.
5339
+ * * unhealthy: the component abnormal.
5340
+ * * upgrading: the component is being updated.
5341
+ * * updating: the component is being modified.
5342
+ * * deleting: the component is being uninstalled.
5271
5343
  * * deleted: The component is deleted.
5272
5344
  *
5273
5345
  * @example
@@ -5677,10 +5749,10 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5677
5749
  clusterId?: string;
5678
5750
  /**
5679
5751
  * @remarks
5680
- * The edition of the cluster if the cluster is an ACK managed cluster. Valid values:
5752
+ * After you set `cluster_type` to `ManagedKubernetes` and configure the `profile` parameter, you can further specify the edition of the cluster.
5681
5753
  *
5682
- * * `ack.pro.small`: ACK Pro
5683
- * * `ack.standard`: ACK Basic
5754
+ * * `ack.pro.small`: Pro.
5755
+ * * `ack.standard`: Basic. If you leave the parameter empty, the Basic edition is selected.
5684
5756
  *
5685
5757
  * @example
5686
5758
  * ack.pro.small
@@ -5688,10 +5760,8 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5688
5760
  clusterSpec?: string;
5689
5761
  /**
5690
5762
  * @remarks
5691
- * The type of cluster. Valid values:
5692
- *
5693
5763
  * * `Kubernetes`: ACK dedicated cluster.
5694
- * * `ManagedKubernetes`: ACK managed cluster. ACK managed clusters include ACK Pro clusters, ACK Basic clusters, ACK Serverless Pro clusters, ACK Serverless Basic clusters, ACK Edge Pro clusters, and ACK Edge Basic clusters.
5764
+ * * `ManagedKubernetes`: 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).
5695
5765
  * * `ExternalKubernetes`: registered cluster.
5696
5766
  *
5697
5767
  * @example
@@ -5799,10 +5869,12 @@ export class DescribeClusterDetailResponseBody extends $tea.Model {
5799
5869
  privateZone?: boolean;
5800
5870
  /**
5801
5871
  * @remarks
5802
- * Indicates the scenario in which the cluster is used. Valid values:
5872
+ * If you set `cluster_type` to `ManagedKubernetes`, an ACK managed cluster is created. In this case, you can further specify the cluster edition.
5803
5873
  *
5804
- * * `Default`: non-edge computing scenarios
5805
- * * `Edge`: edge computing scenarios
5874
+ * * `Default`. ACK managed cluster. ACK managed clusters include ACK Basic clusters and ACK Pro clusters.
5875
+ * * `Edge`: ACK Edge cluster. ACK Edge clusters include ACK Edge Basic clusters and ACK Edge Pro clusters.
5876
+ * * `Serverless`: ACK Serverless cluster. ACK Serverless clusters include ACK Serverless Basic clusters and ACK Serverless Pro clusters.
5877
+ * * `Lingjun`: ACK Lingjun Pro cluster.
5806
5878
  *
5807
5879
  * @example
5808
5880
  * Default
@@ -6267,9 +6339,6 @@ export class DescribeClusterNodePoolDetailResponse extends $tea.Model {
6267
6339
 
6268
6340
  export class DescribeClusterNodePoolsRequest extends $tea.Model {
6269
6341
  /**
6270
- * @remarks
6271
- * 节点池名称。
6272
- *
6273
6342
  * @example
6274
6343
  * nodepool-test
6275
6344
  */
@@ -6475,7 +6544,7 @@ export class DescribeClusterNodesResponse extends $tea.Model {
6475
6544
  export class DescribeClusterResourcesRequest extends $tea.Model {
6476
6545
  /**
6477
6546
  * @remarks
6478
- * Specifies whether to query the resources created by cluster components at the same time.
6547
+ * Specifies whether to query the resources created by cluster components.
6479
6548
  */
6480
6549
  withAddonResources?: boolean;
6481
6550
  static names(): { [key: string]: string } {
@@ -6911,12 +6980,10 @@ export class DescribeClustersV1Request extends $tea.Model {
6911
6980
  clusterId?: string;
6912
6981
  /**
6913
6982
  * @remarks
6914
- * The cluster type, which is available only when the cluster type is set to `ManagedKubernetes`. Valid values:
6915
- *
6916
- * * `ack.pro.small`: ACK Pro cluster
6917
- * * `ack.standard`: ACK Basic cluster
6983
+ * After you set `cluster_type` to `ManagedKubernetes` and configure the `profile` parameter, you can further specify the edition of the cluster. Valid values:
6918
6984
  *
6919
- * By default, this parameter is left empty, which means that ACK clusters are not filtered by this parameter.
6985
+ * * `ack.pro.small`: ACK Pro cluster.
6986
+ * * `ack.standard`: ACK Basic cluster. If you leave the parameter empty, ACK Basic cluster is selected.
6920
6987
  *
6921
6988
  * @example
6922
6989
  * ack.pro.small
@@ -6924,10 +6991,8 @@ export class DescribeClustersV1Request extends $tea.Model {
6924
6991
  clusterSpec?: string;
6925
6992
  /**
6926
6993
  * @remarks
6927
- * The cluster type. Valid values:
6928
- *
6929
6994
  * * `Kubernetes`: ACK dedicated cluster.
6930
- * * `ManagedKubernetes`: ACK managed cluster. ACK managed clusters include ACK Pro clusters, ACK Basic clusters, ACK Serverless Pro clusters, ACK Serverless Basic clusters, ACK Edge Pro clusters, and ACK Edge Basic clusters.
6995
+ * * `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.
6931
6996
  * * `ExternalKubernetes`: registered cluster.
6932
6997
  *
6933
6998
  * @example
@@ -6962,17 +7027,12 @@ export class DescribeClustersV1Request extends $tea.Model {
6962
7027
  pageSize?: number;
6963
7028
  /**
6964
7029
  * @remarks
6965
- * The identifier of the cluster. Valid values when the cluster_type parameter is set to `ManagedKubernetes`:
6966
- *
6967
- * * `Default`: ACK managed cluster
6968
- * * `Serverless`: ACK Serverless cluster
6969
- * * `Edge`: ACK Edge cluster
6970
- *
6971
- * Valid values when the cluster_type parameter is set to `Ask`:
6972
- *
6973
- * `ask.v2`: ACK Serverless cluster
7030
+ * 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:
6974
7031
  *
6975
- * By default, this parameter is left empty. If you leave this parameter empty, ACK clusters are not filtered by identifier.
7032
+ * * `Default`: ACK managed cluster. ACK managed clusters include ACK Basic clusters and ACK Pro clusters.
7033
+ * * `Edge`: ACK Edge cluster. ACK Edge clusters include ACK Edge Basic clusters and ACK Edge Pro clusters.
7034
+ * * `Serverless`: ACK Serverless cluster. ACK Serverless clusters include ACK Serverless Basic clusters and ACK Serverless Pro clusters.
7035
+ * * `Lingjun`: ACK Lingjun Pro cluster.
6976
7036
  *
6977
7037
  * @example
6978
7038
  * Default
@@ -7732,6 +7792,13 @@ export class DescribeKubernetesVersionMetadataRequest extends $tea.Model {
7732
7792
  * Default
7733
7793
  */
7734
7794
  profile?: string;
7795
+ /**
7796
+ * @remarks
7797
+ * Specify whether to query the Kubernetes versions available for updates. This parameter takes effect only when the KubernetesVersion parameter is specified.
7798
+ *
7799
+ * @example
7800
+ * 1.30.1-aliyun.1
7801
+ */
7735
7802
  queryUpgradableVersion?: boolean;
7736
7803
  /**
7737
7804
  * @remarks
@@ -8190,7 +8257,7 @@ export class DescribePolicyInstancesResponse extends $tea.Model {
8190
8257
  export class DescribePolicyInstancesStatusResponseBody extends $tea.Model {
8191
8258
  /**
8192
8259
  * @remarks
8193
- * Information about the number of policy instances of each severity level.
8260
+ * The number of policy instances that are deployed in the cluster at different severity levels.
8194
8261
  *
8195
8262
  * @example
8196
8263
  * { "high": 11, "medium": 1 }
@@ -8198,7 +8265,7 @@ export class DescribePolicyInstancesStatusResponseBody extends $tea.Model {
8198
8265
  instancesSeverityCount?: { [key: string]: any };
8199
8266
  /**
8200
8267
  * @remarks
8201
- * Details about policy instances of different types.
8268
+ * The number of policy instances of each policy type.
8202
8269
  */
8203
8270
  policyInstances?: DescribePolicyInstancesStatusResponseBodyPolicyInstances[];
8204
8271
  static names(): { [key: string]: string } {
@@ -8919,9 +8986,9 @@ export class DescribeUserQuotaResponseBody extends $tea.Model {
8919
8986
  clusterQuota?: number;
8920
8987
  /**
8921
8988
  * @remarks
8922
- * This parameter is deprecated.
8989
+ * This parameter is discontinued.
8923
8990
  *
8924
- * The quota of enhanced edge node pools.
8991
+ * The quotas of enhanced edge node pools.
8925
8992
  */
8926
8993
  edgeImprovedNodepoolQuota?: DescribeUserQuotaResponseBodyEdgeImprovedNodepoolQuota;
8927
8994
  /**
@@ -9340,8 +9407,18 @@ export class GetClusterAddonInstanceResponse extends $tea.Model {
9340
9407
  }
9341
9408
 
9342
9409
  export class GetClusterAuditProjectResponseBody extends $tea.Model {
9410
+ /**
9411
+ * @remarks
9412
+ * 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.
9413
+ *
9414
+ * @example
9415
+ * true
9416
+ */
9343
9417
  auditEnabled?: boolean;
9344
9418
  /**
9419
+ * @remarks
9420
+ * The SLS project in which the audit logs of the API server are stored.
9421
+ *
9345
9422
  * @example
9346
9423
  * k8s-log-cad1230511cbb4db4a488e58518******
9347
9424
  */
@@ -9499,18 +9576,31 @@ export class GetClusterCheckResponse extends $tea.Model {
9499
9576
  }
9500
9577
 
9501
9578
  export class GetClusterDiagnosisCheckItemsResponseBody extends $tea.Model {
9579
+ /**
9580
+ * @remarks
9581
+ * The check item.
9582
+ */
9502
9583
  checkItems?: GetClusterDiagnosisCheckItemsResponseBodyCheckItems[];
9503
9584
  /**
9585
+ * @remarks
9586
+ * The status code.
9587
+ *
9504
9588
  * @example
9505
9589
  * success
9506
9590
  */
9507
9591
  code?: string;
9508
9592
  /**
9593
+ * @remarks
9594
+ * Indicates whether the check is successful.
9595
+ *
9509
9596
  * @example
9510
9597
  * true
9511
9598
  */
9512
9599
  isSuccess?: boolean;
9513
9600
  /**
9601
+ * @remarks
9602
+ * The request ID.
9603
+ *
9514
9604
  * @example
9515
9605
  * 1DFFD8C6-259E-582B-8B40-002C17DC****
9516
9606
  */
@@ -9565,46 +9655,90 @@ export class GetClusterDiagnosisCheckItemsResponse extends $tea.Model {
9565
9655
 
9566
9656
  export class GetClusterDiagnosisResultResponseBody extends $tea.Model {
9567
9657
  /**
9658
+ * @remarks
9659
+ * The code that indicates the diagnostic result. Valid values:
9660
+ *
9661
+ * * 0: the diagnostic is completed.
9662
+ * * 1: the diagnostic failed.
9663
+ *
9568
9664
  * @example
9569
9665
  * 0
9570
9666
  */
9571
9667
  code?: number;
9572
9668
  /**
9669
+ * @remarks
9670
+ * The time when the diagnostic is initiated.
9671
+ *
9573
9672
  * @example
9574
9673
  * 2024-05-28T11:29Z
9575
9674
  */
9576
9675
  created?: string;
9577
9676
  /**
9677
+ * @remarks
9678
+ * The diagnostic ID.
9679
+ *
9578
9680
  * @example
9579
9681
  * 6cf6b62e334e4583bdfd26707516****
9580
9682
  */
9581
9683
  diagnosisId?: string;
9582
9684
  /**
9685
+ * @remarks
9686
+ * The time when the diagnostic is completed.
9687
+ *
9583
9688
  * @example
9584
9689
  * 2024-05-28T11:29Z
9585
9690
  */
9586
9691
  finished?: string;
9587
9692
  /**
9693
+ * @remarks
9694
+ * The diagnostic status information.
9695
+ *
9588
9696
  * @example
9589
9697
  * success
9590
9698
  */
9591
9699
  message?: string;
9592
9700
  /**
9701
+ * @remarks
9702
+ * The diagnostic result.
9703
+ *
9593
9704
  * @example
9594
9705
  * {"phase":5,"version":"20240101"}
9595
9706
  */
9596
9707
  result?: string;
9597
9708
  /**
9709
+ * @remarks
9710
+ * The status of the diagnostic. Valid values:
9711
+ *
9712
+ * * 0: The diagnostic is created.
9713
+ * * 1: The diagnostic is running.
9714
+ * * 2: The diagnostic is completed.
9715
+ *
9598
9716
  * @example
9599
9717
  * 2
9600
9718
  */
9601
9719
  status?: number;
9602
9720
  /**
9721
+ * @remarks
9722
+ * The diagnostic object.
9723
+ *
9603
9724
  * @example
9604
9725
  * {"name":"cn-hongkong.10.0.0.246"}
9605
9726
  */
9606
9727
  target?: string;
9607
9728
  /**
9729
+ * @remarks
9730
+ * The type of the diagnostic.
9731
+ *
9732
+ * Valid values:
9733
+ *
9734
+ * * node
9735
+ * * ingress
9736
+ * * cluster
9737
+ * * memory
9738
+ * * pod
9739
+ * * service
9740
+ * * network
9741
+ *
9608
9742
  * @example
9609
9743
  * Node
9610
9744
  */
@@ -10225,7 +10359,7 @@ export class ListClusterKubeconfigStatesRequest extends $tea.Model {
10225
10359
  * The number of entries per page.
10226
10360
  *
10227
10361
  * * Valid values: 10 to 50.
10228
- * * Default value: 10.
10362
+ * * Default value: 10
10229
10363
  *
10230
10364
  * @example
10231
10365
  * 10
@@ -10258,7 +10392,7 @@ export class ListClusterKubeconfigStatesResponseBody extends $tea.Model {
10258
10392
  page?: ListClusterKubeconfigStatesResponseBodyPage;
10259
10393
  /**
10260
10394
  * @remarks
10261
- * The status of the kubeconfig files associated with the cluster.
10395
+ * The status list of the kubeconfig files associated with the cluster.
10262
10396
  */
10263
10397
  states?: ListClusterKubeconfigStatesResponseBodyStates[];
10264
10398
  static names(): { [key: string]: string } {
@@ -10808,13 +10942,17 @@ export class MigrateClusterResponse extends $tea.Model {
10808
10942
  export class ModifyClusterRequest extends $tea.Model {
10809
10943
  /**
10810
10944
  * @remarks
10811
- * The network access control list (ACL) of the SLB instance associated with the API server if the cluster is a registered cluster.
10945
+ * The network access control lists (ACLs) of the SLB instance associated with the API server if the cluster is a registered cluster.
10812
10946
  */
10813
10947
  accessControlList?: string[];
10948
+ /**
10949
+ * @remarks
10950
+ * The custom subject alternative names (SANs) for the API server certificate to accept requests from specified IP addresses or domain names. This parameter is available only for ACK managed clusters.
10951
+ */
10814
10952
  apiServerCustomCertSans?: ModifyClusterRequestApiServerCustomCertSans;
10815
10953
  /**
10816
10954
  * @remarks
10817
- * Specifies whether to associate an elastic IP address (EIP) with the cluster. This EIP is used for accessing the API server over the Internet. Valid values:
10955
+ * Specifies whether to associate an elastic IP address (EIP) with the cluster. This EIP is used to enable access to the API server over the Internet. Valid values:
10818
10956
  *
10819
10957
  * * `true`: associates an EIP with the cluster.
10820
10958
  * * `false`: does not associate an EIP with the cluster.
@@ -10833,9 +10971,9 @@ export class ModifyClusterRequest extends $tea.Model {
10833
10971
  apiServerEipId?: string;
10834
10972
  /**
10835
10973
  * @remarks
10836
- * The cluster name.
10974
+ * The name of the cluster.
10837
10975
  *
10838
- * The cluster name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (_). The cluster name cannot start with a hyphen (-).
10976
+ * The cluster name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). The cluster name cannot start with a hyphen (-).
10839
10977
  *
10840
10978
  * @example
10841
10979
  * cluster-new-name
@@ -10843,12 +10981,12 @@ export class ModifyClusterRequest extends $tea.Model {
10843
10981
  clusterName?: string;
10844
10982
  /**
10845
10983
  * @remarks
10846
- * 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:
10984
+ * Specifies whether to enable cluster deletion protection. If you enable this option, the cluster cannot be deleted in the console or by calling API operations. Valid values:
10847
10985
  *
10848
- * * `true`
10849
- * * `false`
10986
+ * * `true`: enables cluster deletion protection.
10987
+ * * `false`: disables cluster deletion protection.
10850
10988
  *
10851
- * Default value: `false`
10989
+ * Default value: `false`.
10852
10990
  *
10853
10991
  * @example
10854
10992
  * true
@@ -10856,10 +10994,10 @@ export class ModifyClusterRequest extends $tea.Model {
10856
10994
  deletionProtection?: boolean;
10857
10995
  /**
10858
10996
  * @remarks
10859
- * Specifies whether to enable the RRSA feature. Valid values:
10997
+ * Specifies whether to enable the RAM Roles for Service Accounts (RRSA) feature. This parameter is available only for ACK managed clusters. Valid values:
10860
10998
  *
10861
- * * `true`
10862
- * * `false`
10999
+ * * `true`: enables the RRSA feature.
11000
+ * * `false`: disables the RRSA feature.
10863
11001
  *
10864
11002
  * @example
10865
11003
  * true
@@ -10869,10 +11007,10 @@ export class ModifyClusterRequest extends $tea.Model {
10869
11007
  * @remarks
10870
11008
  * Specifies whether to remap the test domain name of the cluster. Valid values:
10871
11009
  *
10872
- * * `true`
10873
- * * `false`
11010
+ * * `true`: remaps the test domain name of the cluster.
11011
+ * * `false`: does not remap the test domain name of the cluster.
10874
11012
  *
10875
- * Default value: `false`
11013
+ * Default value: `false`.
10876
11014
  *
10877
11015
  * @example
10878
11016
  * true
@@ -10888,12 +11026,12 @@ export class ModifyClusterRequest extends $tea.Model {
10888
11026
  ingressLoadbalancerId?: string;
10889
11027
  /**
10890
11028
  * @remarks
10891
- * Specifies whether to enable instance deletion protection. If this option is enabled, the instance cannot be deleted in the console or by calling API operations. Valid values:
11029
+ * Specifies whether to enable instance deletion protection. If you enable this option, the instance cannot be deleted in the console or by calling API operations. Valid values:
10892
11030
  *
10893
- * * `true`
10894
- * * `false`
11031
+ * * `true`: enables instance deletion protection.
11032
+ * * `false`: disables instance deletion protection.
10895
11033
  *
10896
- * Default value: `false`
11034
+ * Default value: `false`.
10897
11035
  *
10898
11036
  * @example
10899
11037
  * true
@@ -10901,13 +11039,17 @@ export class ModifyClusterRequest extends $tea.Model {
10901
11039
  instanceDeletionProtection?: boolean;
10902
11040
  /**
10903
11041
  * @remarks
10904
- * The cluster maintenance window. This feature takes effect only for managed Pro clusters.
11042
+ * The cluster maintenance window. This feature takes effect only for ACK Pro clusters.
10905
11043
  */
10906
11044
  maintenanceWindow?: MaintenanceWindow;
11045
+ /**
11046
+ * @remarks
11047
+ * The automatic O\\&M policy of the cluster.
11048
+ */
10907
11049
  operationPolicy?: ModifyClusterRequestOperationPolicy;
10908
11050
  /**
10909
11051
  * @remarks
10910
- * The ID of the cluster resource group.
11052
+ * The cluster resource group ID.
10911
11053
  *
10912
11054
  * @example
10913
11055
  * rg-acfmyvw3wjm****
@@ -11141,12 +11283,12 @@ export class ModifyClusterNodePoolRequest extends $tea.Model {
11141
11283
  concurrency?: boolean;
11142
11284
  /**
11143
11285
  * @remarks
11144
- * The configuration of the cluster where the node pool is deployed.
11286
+ * The configurations of the cluster in which the node pool is deployed.
11145
11287
  */
11146
11288
  kubernetesConfig?: ModifyClusterNodePoolRequestKubernetesConfig;
11147
11289
  /**
11148
11290
  * @remarks
11149
- * The configuration of the managed node pool feature.
11291
+ * The configurations of the managed node pool feature.
11150
11292
  */
11151
11293
  management?: ModifyClusterNodePoolRequestManagement;
11152
11294
  /**
@@ -11156,7 +11298,7 @@ export class ModifyClusterNodePoolRequest extends $tea.Model {
11156
11298
  nodepoolInfo?: ModifyClusterNodePoolRequestNodepoolInfo;
11157
11299
  /**
11158
11300
  * @remarks
11159
- * The configurations of the scaling group.
11301
+ * The configurations of the scaling group that is used by the node pool.
11160
11302
  */
11161
11303
  scalingGroup?: ModifyClusterNodePoolRequestScalingGroup;
11162
11304
  /**
@@ -11532,8 +11674,8 @@ export class OpenAckServiceRequest extends $tea.Model {
11532
11674
  * @remarks
11533
11675
  * The type of service that you want to activate. Valid values:
11534
11676
  *
11535
- * * `propayasgo`: professional managed Kubernetes service.
11536
- * * `edgepayasgo`: ACK Edge.
11677
+ * * `propayasgo`: ACK clusters (including ACK managed clusters and ACK dedicated clusters), ACK Serverless clusters, and registered clusters.
11678
+ * * `edgepayasgo`: ACK Edge clusters.
11537
11679
  *
11538
11680
  * @example
11539
11681
  * propayasgo
@@ -11746,9 +11888,6 @@ export class RemoveClusterNodesResponse extends $tea.Model {
11746
11888
 
11747
11889
  export class RemoveNodePoolNodesRequest extends $tea.Model {
11748
11890
  /**
11749
- * @remarks
11750
- * 是否并发移除。
11751
- *
11752
11891
  * @example
11753
11892
  * false
11754
11893
  */
@@ -11814,9 +11953,6 @@ export class RemoveNodePoolNodesRequest extends $tea.Model {
11814
11953
 
11815
11954
  export class RemoveNodePoolNodesShrinkRequest extends $tea.Model {
11816
11955
  /**
11817
- * @remarks
11818
- * 是否并发移除。
11819
- *
11820
11956
  * @example
11821
11957
  * false
11822
11958
  */
@@ -11966,7 +12102,7 @@ export class RemoveWorkflowResponse extends $tea.Model {
11966
12102
  export class RepairClusterNodePoolRequest extends $tea.Model {
11967
12103
  /**
11968
12104
  * @remarks
11969
- * Specifies whether to allow node restart.
12105
+ * Specifies whether to restart the instance of the node.
11970
12106
  *
11971
12107
  * @example
11972
12108
  * true
@@ -11974,7 +12110,7 @@ export class RepairClusterNodePoolRequest extends $tea.Model {
11974
12110
  autoRestart?: boolean;
11975
12111
  /**
11976
12112
  * @remarks
11977
- * The nodes that you want to repair. If you do not specify nodes, all nodes in the node pool are repaired.
12113
+ * The list of nodes. If you do not specify nodes, all nodes in the node pool are selected.
11978
12114
  */
11979
12115
  nodes?: string[];
11980
12116
  operations?: RepairClusterNodePoolRequestOperations[];
@@ -12175,7 +12311,7 @@ export class RunClusterCheckRequest extends $tea.Model {
12175
12311
  options?: { [key: string]: string };
12176
12312
  /**
12177
12313
  * @remarks
12178
- * 检查目标。
12314
+ * The target to be checked.
12179
12315
  *
12180
12316
  * @example
12181
12317
  * np1f6779297c4444a3a1cdd29be8e5****
@@ -12399,7 +12535,7 @@ export class ScaleClusterResponse extends $tea.Model {
12399
12535
  export class ScaleClusterNodePoolRequest extends $tea.Model {
12400
12536
  /**
12401
12537
  * @remarks
12402
- * The number of worker nodes that you want to add. You can add at most 500 nodes in one API call. The maximum number of nodes that can be added is limited by the quota of nodes in the cluster.
12538
+ * The number of worker nodes that you want to add. For example, the current node pool contains two nodes. After the node pool is scaled out, the node pool contains four nodes. Due to the limit of the node quota, you can add at most 500 nodes in each request.
12403
12539
  *
12404
12540
  * @example
12405
12541
  * 1
@@ -12499,10 +12635,10 @@ export class ScaleOutClusterRequest extends $tea.Model {
12499
12635
  count?: number;
12500
12636
  /**
12501
12637
  * @remarks
12502
- * The CPU management policy of the nodes in a node pool. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later.
12638
+ * The CPU management policy of nodes. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
12503
12639
  *
12504
- * * `static`: This policy allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
12505
- * * `none`: The default CPU affinity is used.
12640
+ * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
12641
+ * * `none`: specifies that the default CPU affinity is used.
12506
12642
  *
12507
12643
  * Default value: `none`.
12508
12644
  *
@@ -12512,7 +12648,7 @@ export class ScaleOutClusterRequest extends $tea.Model {
12512
12648
  cpuPolicy?: string;
12513
12649
  /**
12514
12650
  * @remarks
12515
- * Specifies a custom image for nodes. By default, the image provided by Container Service for Kubernetes (ACK) is used. You can select a custom image to replace the default image. For more information, see [Custom images](https://help.aliyun.com/document_detail/146647.html).
12651
+ * Specifies a custom image for nodes. By default, the image provided by ACK is used. You can select a custom image to replace the default image. For more information, see [Custom images](https://help.aliyun.com/document_detail/146647.html).
12516
12652
  *
12517
12653
  * @example
12518
12654
  * m-bp16z7xko3vvv8gt****
@@ -12520,7 +12656,7 @@ export class ScaleOutClusterRequest extends $tea.Model {
12520
12656
  imageId?: string;
12521
12657
  /**
12522
12658
  * @remarks
12523
- * The name of the key pair. You must set this parameter or the `login_password` parameter.
12659
+ * The name of the key pair. You must configure this parameter or the `login_password` parameter.
12524
12660
  *
12525
12661
  * This parameter is required.
12526
12662
  *
@@ -12530,7 +12666,7 @@ export class ScaleOutClusterRequest extends $tea.Model {
12530
12666
  keyPair?: string;
12531
12667
  /**
12532
12668
  * @remarks
12533
- * The password for SSH logon. You must set 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.
12669
+ * The password for SSH logon. You must configure 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.
12534
12670
  *
12535
12671
  * This parameter is required.
12536
12672
  *
@@ -12540,7 +12676,7 @@ export class ScaleOutClusterRequest extends $tea.Model {
12540
12676
  loginPassword?: string;
12541
12677
  /**
12542
12678
  * @remarks
12543
- * After you specify the list of ApsaraDB RDS instances, the ECS instances in the cluster are automatically added to the whitelist of the ApsaraDB RDS instances.
12679
+ * The ApsaraDB RDS instances. If you specify a list of ApsaraDB RDS instances, ECS instances in the cluster are automatically added to the whitelist of the ApsaraDB RDS instances.
12544
12680
  */
12545
12681
  rdsInstances?: string[];
12546
12682
  /**
@@ -12552,18 +12688,18 @@ export class ScaleOutClusterRequest extends $tea.Model {
12552
12688
  * @remarks
12553
12689
  * The labels that you want to add to nodes. You must add labels based on the following rules:
12554
12690
  *
12555
- * * Each label is a case-sensitive key-value pair. You can add up to 20 labels.
12556
- * * 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).
12691
+ * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
12692
+ * * 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).
12557
12693
  */
12558
12694
  tags?: Tag[];
12559
12695
  /**
12560
12696
  * @remarks
12561
- * The taints that you want to add to nodes. Taints are added to nodes to prevent pods from being scheduled to inappropriate nodes. However, tolerations allow pods to be scheduled to nodes with matching taints. For more information, see [Taints and Tolerations](https://kubernetes.io/zh/docs/concepts/scheduling-eviction/taint-and-toleration/).
12697
+ * 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/).
12562
12698
  */
12563
12699
  taints?: Taint[];
12564
12700
  /**
12565
12701
  * @remarks
12566
- * The user data of the node pool. For more information, see [Generate user-defined data](https://help.aliyun.com/document_detail/49121.html).
12702
+ * The user-defined data of the node pool. For more information, see [Generate user-defined data](https://help.aliyun.com/document_detail/49121.html).
12567
12703
  *
12568
12704
  * @example
12569
12705
  * IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFD****
@@ -12571,17 +12707,17 @@ export class ScaleOutClusterRequest extends $tea.Model {
12571
12707
  userData?: string;
12572
12708
  /**
12573
12709
  * @remarks
12574
- * 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.
12710
+ * The vSwitch IDs. 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.
12575
12711
  *
12576
12712
  * This parameter is required.
12577
12713
  */
12578
12714
  vswitchIds?: string[];
12579
12715
  /**
12580
12716
  * @remarks
12581
- * Specifies whether to enable auto-renewal for worker nodes. This parameter takes effect only if `worker_instance_charge_type` is set to `PrePaid`. Valid values:
12717
+ * 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:
12582
12718
  *
12583
12719
  * * `true`: enables auto-renewal.
12584
- * * `false`: disables auto-renewal.
12720
+ * * `false`: does not enable auto-renewal.
12585
12721
  *
12586
12722
  * Default value: `true`.
12587
12723
  *
@@ -12591,7 +12727,7 @@ export class ScaleOutClusterRequest extends $tea.Model {
12591
12727
  workerAutoRenew?: boolean;
12592
12728
  /**
12593
12729
  * @remarks
12594
- * The auto-renewal period for worker nodes after the subscriptions of worker nodes expire. This parameter takes effect and is required only if the subscription billing method is selected for worker nodes.
12730
+ * The auto-renewal duration of worker nodes. This parameter takes effect and is required only if the subscription billing method is selected for worker nodes.
12595
12731
  *
12596
12732
  * Valid values: 1, 2, 3, 6, and 12.
12597
12733
  *
@@ -12603,7 +12739,7 @@ export class ScaleOutClusterRequest extends $tea.Model {
12603
12739
  workerAutoRenewPeriod?: number;
12604
12740
  /**
12605
12741
  * @remarks
12606
- * The configuration of the data disk that is mounted to worker nodes. The configuration includes the disk type and disk size.
12742
+ * The configurations of the data disks that you want to mount to worker nodes. The configurations include the disk type and disk size.
12607
12743
  */
12608
12744
  workerDataDisks?: ScaleOutClusterRequestWorkerDataDisks[];
12609
12745
  /**
@@ -12640,7 +12776,7 @@ export class ScaleOutClusterRequest extends $tea.Model {
12640
12776
  workerPeriod?: number;
12641
12777
  /**
12642
12778
  * @remarks
12643
- * The billing cycle of worker nodes. This parameter is required if worker_instance_charge_type is set to `PrePaid`.
12779
+ * The billing cycle of worker nodes. This parameter is required only if worker_instance_charge_type is set to `PrePaid`.
12644
12780
  *
12645
12781
  * Set the value to `Month`. Worker nodes are billed only on a monthly basis.
12646
12782
  *
@@ -12650,11 +12786,11 @@ export class ScaleOutClusterRequest extends $tea.Model {
12650
12786
  workerPeriodUnit?: string;
12651
12787
  /**
12652
12788
  * @remarks
12653
- * The type of system disk that you want to use for worker nodes. Valid values:
12789
+ * The system disk type of worker nodes. Valid values:
12654
12790
  *
12655
12791
  * * `cloud_efficiency`: ultra disk.
12656
12792
  * * `cloud_ssd`: standard SSD.
12657
- * * `cloud_essd`: enhanced SSD (ESSD).
12793
+ * * `cloud_essd`: Enterprise SSD (ESSD).
12658
12794
  *
12659
12795
  * Default value: `cloud_ssd`.
12660
12796
  *
@@ -12666,7 +12802,7 @@ export class ScaleOutClusterRequest extends $tea.Model {
12666
12802
  workerSystemDiskCategory?: string;
12667
12803
  /**
12668
12804
  * @remarks
12669
- * The size of the system disk that you want to use for worker nodes. Unit: GiB.
12805
+ * The system disk size of worker nodes. Unit: GiB.
12670
12806
  *
12671
12807
  * Valid values: 40 to 500.
12672
12808
  *
@@ -13919,7 +14055,7 @@ export class UpdateControlPlaneLogRequest extends $tea.Model {
13919
14055
  components?: string[];
13920
14056
  /**
13921
14057
  * @remarks
13922
- * The name of the Simple Log Service project that you want to use to store the logs of control plane components.
14058
+ * The name of the Simple Log Service Project that you want to use to store the logs of control plane components.
13923
14059
  *
13924
14060
  * Default value: k8s-log-$Cluster ID.
13925
14061
  *
@@ -14394,7 +14530,7 @@ export class UpdateUserPermissionsResponse extends $tea.Model {
14394
14530
  export class UpgradeClusterRequest extends $tea.Model {
14395
14531
  /**
14396
14532
  * @remarks
14397
- * This parameter is discontinued.
14533
+ * This parameter is deprecated.
14398
14534
  *
14399
14535
  * @example
14400
14536
  * k8s
@@ -14406,8 +14542,8 @@ export class UpgradeClusterRequest extends $tea.Model {
14406
14542
  * @remarks
14407
14543
  * Specifies whether to update only the master nodes. Valid values:
14408
14544
  *
14409
- * * true: Updates only the master nodes.
14410
- * * false: Updates the master nodes and worker nodes.
14545
+ * * true: updates only the master nodes.
14546
+ * * false: updates the master nodes and worker nodes.
14411
14547
  *
14412
14548
  * @example
14413
14549
  * true
@@ -14424,7 +14560,7 @@ export class UpgradeClusterRequest extends $tea.Model {
14424
14560
  rollingPolicy?: UpgradeClusterRequestRollingPolicy;
14425
14561
  /**
14426
14562
  * @remarks
14427
- * This parameter is discontinued. Specify the Kubernetes version by using the next_version parameter.
14563
+ * This parameter is deprecated. Specify the Kubernetes version by using the next_version parameter.
14428
14564
  *
14429
14565
  * @example
14430
14566
  * 1.14.8-aliyun.1
@@ -14459,25 +14595,16 @@ export class UpgradeClusterRequest extends $tea.Model {
14459
14595
 
14460
14596
  export class UpgradeClusterResponseBody extends $tea.Model {
14461
14597
  /**
14462
- * @remarks
14463
- * 集群ID。
14464
- *
14465
14598
  * @example
14466
14599
  * c82e6987e2961451182edacd74faf****
14467
14600
  */
14468
14601
  clusterId?: string;
14469
14602
  /**
14470
- * @remarks
14471
- * 请求ID。
14472
- *
14473
14603
  * @example
14474
14604
  * 0527ac9a-c899-4341-a21a-****
14475
14605
  */
14476
14606
  requestId?: string;
14477
14607
  /**
14478
- * @remarks
14479
- * 任务ID。
14480
- *
14481
14608
  * @example
14482
14609
  * T-5faa48fb31b6b8078d00****
14483
14610
  */
@@ -14552,8 +14679,29 @@ export class UpgradeClusterAddonsRequest extends $tea.Model {
14552
14679
  }
14553
14680
 
14554
14681
  export class UpgradeClusterAddonsResponseBody extends $tea.Model {
14682
+ /**
14683
+ * @remarks
14684
+ * The ID of the cluster.
14685
+ *
14686
+ * @example
14687
+ * cf4299b79b3e34226abfdc80a4bda****
14688
+ */
14555
14689
  clusterId?: string;
14690
+ /**
14691
+ * @remarks
14692
+ * The ID of the request.
14693
+ *
14694
+ * @example
14695
+ * bfd12953-31cb-42f1-8a36-7b80ec345094
14696
+ */
14556
14697
  requestId?: string;
14698
+ /**
14699
+ * @remarks
14700
+ * The ID of the task.
14701
+ *
14702
+ * @example
14703
+ * T-62a944794ee141074400****
14704
+ */
14557
14705
  taskId?: string;
14558
14706
  static names(): { [key: string]: string } {
14559
14707
  return {
@@ -14612,17 +14760,25 @@ export class UpgradeClusterNodepoolRequest extends $tea.Model {
14612
14760
  imageId?: string;
14613
14761
  /**
14614
14762
  * @remarks
14615
- * The Kubernetes version that is used by the nodes.
14763
+ * The Kubernetes version that is used by the nodes. You can call the [DescribeKubernetesVersionMetadata](https://help.aliyun.com/document_detail/2667899.html) operation to query the Kubernetes version of the cluster returned in the current_version parameter.
14616
14764
  *
14617
14765
  * @example
14618
14766
  * 1.22.15-aliyun.1
14619
14767
  */
14620
14768
  kubernetesVersion?: string;
14769
+ /**
14770
+ * @remarks
14771
+ * The nodes that you want to update. If you do not specify this parameter, all nodes in the node pool are updated by default.
14772
+ */
14621
14773
  nodeNames?: string[];
14774
+ /**
14775
+ * @remarks
14776
+ * The rotation configuration.
14777
+ */
14622
14778
  rollingPolicy?: UpgradeClusterNodepoolRequestRollingPolicy;
14623
14779
  /**
14624
14780
  * @remarks
14625
- * The runtime type. Valid values: containerd and docker.
14781
+ * The runtime type. You can call the [DescribeKubernetesVersionMetadata](https://help.aliyun.com/document_detail/2667899.html) operation to query the runtime information returned in the runtime parameter.
14626
14782
  *
14627
14783
  * @example
14628
14784
  * containerd
@@ -14630,12 +14786,24 @@ export class UpgradeClusterNodepoolRequest extends $tea.Model {
14630
14786
  runtimeType?: string;
14631
14787
  /**
14632
14788
  * @remarks
14633
- * The version of the container runtime that is used by the nodes.
14789
+ * 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.
14634
14790
  *
14635
14791
  * @example
14636
14792
  * 1.5.10
14637
14793
  */
14638
14794
  runtimeVersion?: string;
14795
+ /**
14796
+ * @remarks
14797
+ * Specifies whether to perform the update by replacing the system disk. Valid values:
14798
+ *
14799
+ * * true: updates by replacing the system disk.
14800
+ * * false: does not update by replacing the system disk.
14801
+ *
14802
+ * Default value: false.
14803
+ *
14804
+ * @example
14805
+ * false
14806
+ */
14639
14807
  useReplace?: boolean;
14640
14808
  static names(): { [key: string]: string } {
14641
14809
  return {
@@ -15612,6 +15780,8 @@ export class AttachInstancesResponseBodyList extends $tea.Model {
15612
15780
  export class CheckServiceRoleRequestRoles extends $tea.Model {
15613
15781
  /**
15614
15782
  * @remarks
15783
+ * The service role name.
15784
+ *
15615
15785
  * This parameter is required.
15616
15786
  *
15617
15787
  * @example
@@ -15637,16 +15807,25 @@ export class CheckServiceRoleRequestRoles extends $tea.Model {
15637
15807
 
15638
15808
  export class CheckServiceRoleResponseBodyRoles extends $tea.Model {
15639
15809
  /**
15810
+ * @remarks
15811
+ * Specifies whether the service role is granted required permissions.
15812
+ *
15640
15813
  * @example
15641
15814
  * true
15642
15815
  */
15643
15816
  granted?: boolean;
15644
15817
  /**
15818
+ * @remarks
15819
+ * The message returned if the service role is not granted required permissions.
15820
+ *
15645
15821
  * @example
15646
15822
  * The role does not exist: AliyunCSManagedAutoScalerRole
15647
15823
  */
15648
15824
  message?: string;
15649
15825
  /**
15826
+ * @remarks
15827
+ * The service role name.
15828
+ *
15650
15829
  * @example
15651
15830
  * AliyunCSManagedAutoScalerRole
15652
15831
  */
@@ -15675,7 +15854,7 @@ export class CheckServiceRoleResponseBodyRoles extends $tea.Model {
15675
15854
  export class CreateClusterRequestWorkerDataDisks extends $tea.Model {
15676
15855
  /**
15677
15856
  * @remarks
15678
- * The type of a data disk.
15857
+ * The data disk type.
15679
15858
  *
15680
15859
  * This parameter is required.
15681
15860
  *
@@ -15698,7 +15877,7 @@ export class CreateClusterRequestWorkerDataDisks extends $tea.Model {
15698
15877
  encrypted?: string;
15699
15878
  /**
15700
15879
  * @remarks
15701
- * The PL of the data disk. This parameter takes effect only for ESSDs. You can specify a higher PL if you increase the size of a data disk. For more information, see [ESSDs](https://help.aliyun.com/document_detail/122389.html).
15880
+ * The PL of the data disk. This parameter takes effect only for ESSDs. You can specify a higher PL if you increase the size of a data disk. For more information, see [Enterprise SSDs](https://help.aliyun.com/document_detail/122389.html).
15702
15881
  *
15703
15882
  * @example
15704
15883
  * PL1
@@ -15706,7 +15885,7 @@ export class CreateClusterRequestWorkerDataDisks extends $tea.Model {
15706
15885
  performanceLevel?: string;
15707
15886
  /**
15708
15887
  * @remarks
15709
- * The size of the data disk. Valid values: 40 to 32767. Unit: GiB.
15888
+ * The data disk size. Valid values: 40 to 32767. Unit: GiB.
15710
15889
  *
15711
15890
  * This parameter is required.
15712
15891
  *
@@ -15740,13 +15919,13 @@ export class CreateClusterRequestWorkerDataDisks extends $tea.Model {
15740
15919
  export class CreateClusterNodePoolRequestAutoScaling extends $tea.Model {
15741
15920
  /**
15742
15921
  * @remarks
15743
- * This parameter is discontinued.
15922
+ * This parameter is deprecated.
15744
15923
  *
15745
15924
  * The maximum bandwidth of the EIP. Unit: Mbit/s.
15746
15925
  *
15747
15926
  * **
15748
15927
  *
15749
- * **Important** This parameter is discontinued. Use internet_charge_type and internet_max_bandwidth_out.
15928
+ * **Important** This parameter is deprecated. Use internet_charge_type and internet_max_bandwidth_out.
15750
15929
  *
15751
15930
  * @example
15752
15931
  * 5
@@ -15756,18 +15935,18 @@ export class CreateClusterNodePoolRequestAutoScaling extends $tea.Model {
15756
15935
  eipBandwidth?: number;
15757
15936
  /**
15758
15937
  * @remarks
15759
- * This parameter is discontinued.
15938
+ * This parameter is deprecated.
15760
15939
  *
15761
- * The billing method of the EIP. Valid values:
15940
+ * The metering method of the EIP. Valid values:
15762
15941
  *
15763
- * * `PayByBandwidth`: pay-by-bandwidth
15764
- * * `PayByTraffic`: pay-by-data-transfer
15942
+ * * `PayByBandwidth`: pay-by-bandwidth.
15943
+ * * `PayByTraffic`: pay-by-data-transfer.
15765
15944
  *
15766
15945
  * Default value: `PayByBandwidth`.
15767
15946
  *
15768
15947
  * **
15769
15948
  *
15770
- * **Important** This parameter is discontinued. Use internet_charge_type and internet_max_bandwidth_out.
15949
+ * **Important** This parameter is deprecated. Use internet_charge_type and internet_max_bandwidth_out.
15771
15950
  *
15772
15951
  * @example
15773
15952
  * PayByBandwidth
@@ -15779,8 +15958,8 @@ export class CreateClusterNodePoolRequestAutoScaling extends $tea.Model {
15779
15958
  * @remarks
15780
15959
  * Specifies whether to enable auto scaling for the node pool. Valid values:
15781
15960
  *
15782
- * * `true`
15783
- * * `false`: If you set this parameter to false, other parameters of `auto_scaling` object do not take effect.
15961
+ * * `true`: enables auto scaling.
15962
+ * * `false`: disables auto scaling. If you set this parameter to false, other parameters in the `auto_scaling` section do not take effect.
15784
15963
  *
15785
15964
  * Default value: `false`.
15786
15965
  *
@@ -15790,18 +15969,18 @@ export class CreateClusterNodePoolRequestAutoScaling extends $tea.Model {
15790
15969
  enable?: boolean;
15791
15970
  /**
15792
15971
  * @remarks
15793
- * This parameter is discontinued.
15972
+ * This parameter is deprecated.
15794
15973
  *
15795
15974
  * Specifies whether to associate an elastic IP address (EIP) with the node pool. Valid values:
15796
15975
  *
15797
- * * `true`
15798
- * * `false`
15976
+ * * `true`: associates an EIP with the node pool.
15977
+ * * `false`: does not associate an EIP with the node pool.
15799
15978
  *
15800
15979
  * Default value: `false`.
15801
15980
  *
15802
15981
  * **
15803
15982
  *
15804
- * **Important** This parameter is discontinued. Use internet_charge_type and internet_max_bandwidth_out.
15983
+ * **Important** This parameter is deprecated. Use internet_charge_type and internet_max_bandwidth_out.
15805
15984
  *
15806
15985
  * @example
15807
15986
  * true
@@ -15811,7 +15990,7 @@ export class CreateClusterNodePoolRequestAutoScaling extends $tea.Model {
15811
15990
  isBondEip?: boolean;
15812
15991
  /**
15813
15992
  * @remarks
15814
- * The maximum number of instances that can be automatically scaled. The number of nodes in the node pool cannot be greater than this value. This parameter takes effect only if `enable` is set to true. Valid values: [min_instances, 2000]. Default value: 0.
15993
+ * The maximum number to which the Elastic Compute Service (ECS) instances in the node pool can be scaled. The number of nodes in the node pool cannot be greater than this value. This parameter takes effect only if `enable` is set to true. Valid values: [min_instances, 2000]. Default value: 0.
15815
15994
  *
15816
15995
  * @example
15817
15996
  * 10
@@ -15819,7 +15998,7 @@ export class CreateClusterNodePoolRequestAutoScaling extends $tea.Model {
15819
15998
  maxInstances?: number;
15820
15999
  /**
15821
16000
  * @remarks
15822
- * The minimum number of instances that can be automatically scaled. The number of nodes in the node pool cannot be smaller than this value. This parameter takes effect only if `enable` is set to true. Valid values: [0, max_instances]. Default value: 0.
16001
+ * The minimum number to which the ECS instances in the node pool can be scaled. The number of nodes in the node pool cannot be smaller than this value. This parameter takes effect only if `enable` is set to true. Valid values: [0, max_instances]. Default value: 0.
15823
16002
  *
15824
16003
  * @example
15825
16004
  * 1
@@ -15827,12 +16006,12 @@ export class CreateClusterNodePoolRequestAutoScaling extends $tea.Model {
15827
16006
  minInstances?: number;
15828
16007
  /**
15829
16008
  * @remarks
15830
- * The type of instances that are automatically scaled. This parameter takes effect only if `enable` is set to true. Valid values:
16009
+ * The instance type that is used for auto scaling. This parameter takes effect only if `enable` is set to true. Valid values:
15831
16010
  *
15832
- * * `cpu`: regular instance
15833
- * * `gpu`: GPU-accelerated instance
15834
- * * `gpushare`: shared GPU-accelerated instance
15835
- * * `spot`: preemptible instance
16011
+ * * `cpu`: regular instance.
16012
+ * * `gpu`: GPU-accelerated instance.
16013
+ * * `gpushare`: shared GPU-accelerated instance.
16014
+ * * `spot`: preemptible instance.
15836
16015
  *
15837
16016
  * Default value: `cpu`.
15838
16017
  *
@@ -15874,7 +16053,7 @@ export class CreateClusterNodePoolRequestAutoScaling extends $tea.Model {
15874
16053
  export class CreateClusterNodePoolRequestInterconnectConfig extends $tea.Model {
15875
16054
  /**
15876
16055
  * @remarks
15877
- * This parameter is discontinued.
16056
+ * This parameter is deprecated.
15878
16057
  *
15879
16058
  * The bandwidth of the enhanced edge node pool. Unit: Mbit/s.
15880
16059
  *
@@ -15884,7 +16063,7 @@ export class CreateClusterNodePoolRequestInterconnectConfig extends $tea.Model {
15884
16063
  bandwidth?: number;
15885
16064
  /**
15886
16065
  * @remarks
15887
- * This parameter is discontinued.
16066
+ * This parameter is deprecated.
15888
16067
  *
15889
16068
  * The ID of the Cloud Connect Network (CCN) instance that is associated with the enhanced edge node pool.
15890
16069
  *
@@ -15894,9 +16073,9 @@ export class CreateClusterNodePoolRequestInterconnectConfig extends $tea.Model {
15894
16073
  ccnId?: string;
15895
16074
  /**
15896
16075
  * @remarks
15897
- * This parameter is discontinued.
16076
+ * This parameter is deprecated.
15898
16077
  *
15899
- * The region in which the CCN instance that is associated with the enhanced edge node pool resides.
16078
+ * The region to which the CCN instance that is associated with the enhanced edge node pool belongs.
15900
16079
  *
15901
16080
  * @example
15902
16081
  * cn-shanghai
@@ -15904,7 +16083,7 @@ export class CreateClusterNodePoolRequestInterconnectConfig extends $tea.Model {
15904
16083
  ccnRegionId?: string;
15905
16084
  /**
15906
16085
  * @remarks
15907
- * This parameter is discontinued.
16086
+ * This parameter is deprecated.
15908
16087
  *
15909
16088
  * The ID of the Cloud Enterprise Network (CEN) instance that is associated with the enhanced edge node pool.
15910
16089
  *
@@ -15914,9 +16093,9 @@ export class CreateClusterNodePoolRequestInterconnectConfig extends $tea.Model {
15914
16093
  cenId?: string;
15915
16094
  /**
15916
16095
  * @remarks
15917
- * This parameter is discontinued.
16096
+ * This parameter is deprecated.
15918
16097
  *
15919
- * The subscription duration of the enhanced edge node pool. Unit: months.
16098
+ * The subscription duration of the enhanced edge node pool. The duration is measured in months.
15920
16099
  *
15921
16100
  * @example
15922
16101
  * 1
@@ -15950,10 +16129,10 @@ export class CreateClusterNodePoolRequestInterconnectConfig extends $tea.Model {
15950
16129
  export class CreateClusterNodePoolRequestKubernetesConfig extends $tea.Model {
15951
16130
  /**
15952
16131
  * @remarks
15953
- * Specifies whether to install the CloudMonitor agent on ECS nodes. After the CloudMonitor agent is installed on ECS nodes, you can view the monitoring information about the instances in the CloudMonitor console. We recommend that you install the CloudMonitor agent. Valid values:
16132
+ * Specifies whether to install the CloudMonitor agent on ECS nodes. After the CloudMonitor agent is installed on ECS nodes, you can view monitoring information about the instances in the CloudMonitor console. We recommend that you install the CloudMonitor agent. Valid values:
15954
16133
  *
15955
- * * `true`
15956
- * * `false`
16134
+ * * `true`: installs the CloudMonitor agent on ECS nodes.
16135
+ * * `false`: does not install the CloudMonitor agent on ECS nodes.
15957
16136
  *
15958
16137
  * Default value: `false`.
15959
16138
  *
@@ -15963,9 +16142,9 @@ export class CreateClusterNodePoolRequestKubernetesConfig extends $tea.Model {
15963
16142
  cmsEnabled?: boolean;
15964
16143
  /**
15965
16144
  * @remarks
15966
- * The CPU management policy of the nodes in the node pool. The following policies are supported if the version of the cluster is Kubernetes 1.12.6 or later:
16145
+ * 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:
15967
16146
  *
15968
- * * `static`: allows pods with specific resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.
16147
+ * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
15969
16148
  * * `none`: specifies that the default CPU affinity is used.
15970
16149
  *
15971
16150
  * Default value: `none`.
@@ -15976,17 +16155,17 @@ export class CreateClusterNodePoolRequestKubernetesConfig extends $tea.Model {
15976
16155
  cpuPolicy?: string;
15977
16156
  /**
15978
16157
  * @remarks
15979
- * The labels that you want to add to the nodes in the cluster.
16158
+ * The labels that you want to add to nodes in the cluster.
15980
16159
  */
15981
16160
  labels?: Tag[];
15982
16161
  /**
15983
16162
  * @remarks
15984
16163
  * The custom node name. A custom node name consists of a prefix, a node IP address, and a suffix.
15985
16164
  *
15986
- * * The prefix and 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.
15987
- * * The node IP address is the complete private IP address of the node.
16165
+ * * 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.
16166
+ * * The node IP address in a custom node name is the private IP address of the node.
15988
16167
  *
15989
- * Set the parameter to a value that is in the customized,aliyun,ip,com format. The value consists of four parts that are separated by commas (,). customized and ip are fixed content. aliyun is the prefix and com is the suffix. Example: aliyun.192.168.xxx.xxx.com.
16168
+ * Set the parameter to a value in the customized,aliyun,ip,com format. The value consists of four parts that are separated by commas (,). customized and ip are fixed content. aliyun is the prefix and com is the suffix. Example: aliyun.192.168.xxx.xxx.com.
15990
16169
  *
15991
16170
  * @example
15992
16171
  * customized,aliyun,ip,com
@@ -15994,7 +16173,13 @@ export class CreateClusterNodePoolRequestKubernetesConfig extends $tea.Model {
15994
16173
  nodeNameMode?: string;
15995
16174
  /**
15996
16175
  * @remarks
15997
- * The container runtime.
16176
+ * The name of the container runtime. The following types of runtime are supported by Container Service for Kubernetes (ACK):
16177
+ *
16178
+ * * containerd: containerd is the recommended runtime and supports all Kubernetes versions.
16179
+ * * Sandboxed-Container.runv: The Sandbox-Container runtime provides improved isolation and supports Kubernetes 1.24 and earlier.
16180
+ * * docker: The Docker runtime supports Kubernetes 1.22 and earlier.
16181
+ *
16182
+ * Default value: containerd.
15998
16183
  *
15999
16184
  * @example
16000
16185
  * docker
@@ -16010,7 +16195,7 @@ export class CreateClusterNodePoolRequestKubernetesConfig extends $tea.Model {
16010
16195
  runtimeVersion?: string;
16011
16196
  /**
16012
16197
  * @remarks
16013
- * The taint configurations.
16198
+ * The taints.
16014
16199
  */
16015
16200
  taints?: Taint[];
16016
16201
  /**
@@ -16023,7 +16208,7 @@ export class CreateClusterNodePoolRequestKubernetesConfig extends $tea.Model {
16023
16208
  unschedulable?: boolean;
16024
16209
  /**
16025
16210
  * @remarks
16026
- * The user-defined data on nodes.
16211
+ * The user data on the node.
16027
16212
  *
16028
16213
  * @example
16029
16214
  * dGhpcyBpcyBhIGV4YW1wbGU=
@@ -16067,8 +16252,8 @@ export class CreateClusterNodePoolRequestManagementAutoRepairPolicy extends $tea
16067
16252
  * @remarks
16068
16253
  * Specifies whether to allow node restart. This parameter takes effect only if `auto_repair` is set to true. Valid values:
16069
16254
  *
16070
- * * `true`
16071
- * * `false`
16255
+ * * `true`: allows node restart.
16256
+ * * `false`: does not allow node restart.
16072
16257
  *
16073
16258
  * If `auto_repair` is set to true, the default value of this parameter is `true`. If `auto_repair` is set to false, the default value of this parameter is `false`.
16074
16259
  *
@@ -16098,8 +16283,8 @@ export class CreateClusterNodePoolRequestManagementAutoUpgradePolicy extends $te
16098
16283
  * @remarks
16099
16284
  * Specifies whether to allow auto update of the kubelet. This parameter takes effect only if `auto_upgrade` is set to true. Valid values:
16100
16285
  *
16101
- * * `true`
16102
- * * `false`
16286
+ * * `true`: allows auto update of the kubelet.
16287
+ * * `false`: does not allow auto update of the kubelet.
16103
16288
  *
16104
16289
  * If `auto_upgrade` is set to true, the default value of this parameter is `true`. If `auto_upgrade` is set to false, the default value of this parameter is `false`.
16105
16290
  *
@@ -16109,21 +16294,22 @@ export class CreateClusterNodePoolRequestManagementAutoUpgradePolicy extends $te
16109
16294
  autoUpgradeKubelet?: boolean;
16110
16295
  /**
16111
16296
  * @remarks
16112
- * 是否允许自动升级操作系统,仅当`auto_upgrade=true`时生效。取值:
16113
- * - `true`:允许自动升级操作系统。
16114
- * - `false`:不允许自动升级操作系统。
16297
+ * Specifies whether to allow auto update of the OS. This parameter takes effect only if `auto_upgrade` is set to true. Valid values:
16115
16298
  *
16299
+ * * `true`: allows auto update of the OS.
16300
+ * * `false`: does not allow auto update of the OS.
16116
16301
  *
16117
- * 默认值为`false`
16302
+ * Default value: `false`.
16118
16303
  */
16119
16304
  autoUpgradeOs?: boolean;
16120
16305
  /**
16121
16306
  * @remarks
16122
- * 是否允许自动升级运行时,仅当`auto_upgrade=true`时生效。取值:
16123
- * - `true`:允许自动升级运行时。
16124
- * - `false`:不允许自动升级运行时。
16307
+ * Specifies whether to allow auto update of the runtime. This parameter takes effect only if `auto_upgrade` is set to true. Valid values:
16125
16308
  *
16126
- * 默认值为`false`
16309
+ * * `true`: allows auto update of the runtime.
16310
+ * * `false`: does not allow auto update of the runtime.
16311
+ *
16312
+ * Default value: `false`.
16127
16313
  */
16128
16314
  autoUpgradeRuntime?: boolean;
16129
16315
  static names(): { [key: string]: string } {
@@ -16152,8 +16338,8 @@ export class CreateClusterNodePoolRequestManagementAutoVulFixPolicy extends $tea
16152
16338
  * @remarks
16153
16339
  * Specifies whether to allow node restart. This parameter takes effect only if `auto_vul_fix` is set to true. Valid values:
16154
16340
  *
16155
- * * `true`
16156
- * * `false` If `auto_vul_fix` is set to true, the default value of this parameter is `false`. If `auto_vul_fix` is set to false, the default value of this parameter is `false`.
16341
+ * * `true`: allows node restart.
16342
+ * * `false`: does not allow node restart. If `auto_vul_fix` is set to true, the default value of this parameter is `false`. If `auto_vul_fix` is set to false, the default value of this parameter is `false`.
16157
16343
  *
16158
16344
  * @example
16159
16345
  * true
@@ -16161,11 +16347,11 @@ export class CreateClusterNodePoolRequestManagementAutoVulFixPolicy extends $tea
16161
16347
  restartNode?: boolean;
16162
16348
  /**
16163
16349
  * @remarks
16164
- * The level of CVEs that can be automatically patched. Separate multiple levels with commas (,). Example: `asap,later`. Valid values:
16350
+ * The severity levels of CVEs that can be automatically patched. Separate multiple levels with commas (,). Example: `asap,later`. Valid values:
16165
16351
  *
16166
- * * `asap`: high
16167
- * * `later`: medium
16168
- * * `nntf`: low
16352
+ * * `asap`: high.
16353
+ * * `later`: medium.
16354
+ * * `nntf`: low.
16169
16355
  *
16170
16356
  * If `auto_vul_fix` is set to true, the default value of this parameter is `asap`.
16171
16357
  *
@@ -16197,12 +16383,12 @@ export class CreateClusterNodePoolRequestManagementUpgradeConfig extends $tea.Mo
16197
16383
  * @remarks
16198
16384
  * Specifies whether to enable auto update. Valid values:
16199
16385
  *
16200
- * * `true`
16201
- * * `false`
16386
+ * * `true`: enables auto update.
16387
+ * * `false`: disables auto update.
16202
16388
  *
16203
16389
  * **
16204
16390
  *
16205
- * **Important** This parameter is discontinued. Use the preceding auto_upgrade parameter.
16391
+ * **Caution** This parameter is deprecated. Use the preceding auto_upgrade parameter.
16206
16392
  *
16207
16393
  * @example
16208
16394
  * false
@@ -16222,7 +16408,7 @@ export class CreateClusterNodePoolRequestManagementUpgradeConfig extends $tea.Mo
16222
16408
  maxUnavailable?: number;
16223
16409
  /**
16224
16410
  * @remarks
16225
- * The number of additional nodes.
16411
+ * The number of additional nodes that are temporarily added to the node pool during an auto update.
16226
16412
  *
16227
16413
  * @example
16228
16414
  * 0
@@ -16230,7 +16416,7 @@ export class CreateClusterNodePoolRequestManagementUpgradeConfig extends $tea.Mo
16230
16416
  surge?: number;
16231
16417
  /**
16232
16418
  * @remarks
16233
- * The percentage of additional nodes to the total nodes in the node pool. You must specify this parameter or the `surge` parameter.
16419
+ * The percentage of additional nodes that are temporarily added to the node pool during an auto update. You must set this parameter or `surge`.
16234
16420
  *
16235
16421
  * @example
16236
16422
  * 0
@@ -16264,8 +16450,8 @@ export class CreateClusterNodePoolRequestManagement extends $tea.Model {
16264
16450
  * @remarks
16265
16451
  * Specifies whether to enable auto node repair. This parameter takes effect only if `enable` is set to true.
16266
16452
  *
16267
- * * `true`
16268
- * * `false`
16453
+ * * `true`: enables auto node repair.
16454
+ * * `false`: disables auto node repair.
16269
16455
  *
16270
16456
  * If `enable` is set to true, the default value of this parameter is `true`. If `enable` is set to false, the default value of this parameter is `false`.
16271
16457
  *
@@ -16282,8 +16468,8 @@ export class CreateClusterNodePoolRequestManagement extends $tea.Model {
16282
16468
  * @remarks
16283
16469
  * Specifies whether to enable auto node update. This parameter takes effect only if `enable` is set to true.
16284
16470
  *
16285
- * * `true`
16286
- * * `false`
16471
+ * * `true`: enables auto node update.
16472
+ * * `false`: disables auto node update.
16287
16473
  *
16288
16474
  * If `enable` is set to true, the default value of this parameter is `true`. If `enable` is set to false, the default value of this parameter is `false`.
16289
16475
  *
@@ -16298,10 +16484,10 @@ export class CreateClusterNodePoolRequestManagement extends $tea.Model {
16298
16484
  autoUpgradePolicy?: CreateClusterNodePoolRequestManagementAutoUpgradePolicy;
16299
16485
  /**
16300
16486
  * @remarks
16301
- * Specifies whether to enable auto CVE patching. This parameter takes effect only if `enable` is set to true.
16487
+ * Specifies whether to enable auto Common Vulnerabilities and Exposures (CVE) patching. This parameter takes effect only if `enable` is set to true.
16302
16488
  *
16303
- * * `true`
16304
- * * `false`
16489
+ * * `true`: enables auto CVE patching.
16490
+ * * `false`: disables auto CVE patching.
16305
16491
  *
16306
16492
  * If `enable` is set to true, the default value of this parameter is `true`. If `enable` is set to false, the default value of this parameter is `false`.
16307
16493
  *
@@ -16318,10 +16504,10 @@ export class CreateClusterNodePoolRequestManagement extends $tea.Model {
16318
16504
  * @remarks
16319
16505
  * Specifies whether to enable the managed node pool feature. Valid values:
16320
16506
  *
16321
- * * `true`
16322
- * * `false`: If you set this parameter to false, other parameters of management do not take effect.
16507
+ * * `true`: enables the managed node pool feature.
16508
+ * * `false`: disables the managed node pool feature. Other parameters in this section take effect only if enable is set to true.
16323
16509
  *
16324
- * Default value: false.
16510
+ * Default value: false
16325
16511
  *
16326
16512
  * @example
16327
16513
  * false
@@ -16329,7 +16515,7 @@ export class CreateClusterNodePoolRequestManagement extends $tea.Model {
16329
16515
  enable?: boolean;
16330
16516
  /**
16331
16517
  * @remarks
16332
- * The configurations of auto update. This parameter takes effect only if `enable` is set to true.
16518
+ * The configurations of auto update. The configurations take effects only if `enable` is set to true.
16333
16519
  *
16334
16520
  * @deprecated
16335
16521
  */
@@ -16368,7 +16554,7 @@ export class CreateClusterNodePoolRequestManagement extends $tea.Model {
16368
16554
  export class CreateClusterNodePoolRequestNodeConfig extends $tea.Model {
16369
16555
  /**
16370
16556
  * @remarks
16371
- * The parameter settings of the kubelet.
16557
+ * The configurations of the kubelet.
16372
16558
  */
16373
16559
  kubeletConfiguration?: KubeletConfig;
16374
16560
  static names(): { [key: string]: string } {
@@ -16401,7 +16587,7 @@ export class CreateClusterNodePoolRequestNodepoolInfo extends $tea.Model {
16401
16587
  name?: string;
16402
16588
  /**
16403
16589
  * @remarks
16404
- * The ID of the resource group. Instances that are added to the node pool belong to this resource group.
16590
+ * The ID of the resource group to which the node pool belongs. Instances that are added to the node pool belong to this resource group.
16405
16591
  *
16406
16592
  * @example
16407
16593
  * rg-acfmyvw3wjmb****
@@ -16409,9 +16595,9 @@ export class CreateClusterNodePoolRequestNodepoolInfo extends $tea.Model {
16409
16595
  resourceGroupId?: string;
16410
16596
  /**
16411
16597
  * @remarks
16412
- * The type of the node pool. Valid values:
16598
+ * The type of node pool. Valid values:
16413
16599
  *
16414
- * * `ess`: regular node pool, which supports the managed node pool feature and auto scaling feature.
16600
+ * * `ess`: regular node pool, which supports the managed node pool feature and the auto scaling feature.
16415
16601
  * * `edge`: edge node pool.
16416
16602
  * * `lingjun`: Lingjun node pool.
16417
16603
  *
@@ -16443,7 +16629,7 @@ export class CreateClusterNodePoolRequestNodepoolInfo extends $tea.Model {
16443
16629
  export class CreateClusterNodePoolRequestScalingGroupPrivatePoolOptions extends $tea.Model {
16444
16630
  /**
16445
16631
  * @remarks
16446
- * The ID of the private node pool.
16632
+ * The private node pool ID.
16447
16633
  *
16448
16634
  * @example
16449
16635
  * eap-bp67acfmxazb4****
@@ -16451,11 +16637,11 @@ export class CreateClusterNodePoolRequestScalingGroupPrivatePoolOptions extends
16451
16637
  id?: string;
16452
16638
  /**
16453
16639
  * @remarks
16454
- * The type of the private node pool. This parameter specifies the type of private node pool that is used to create instances. A private node pool is generated when an elasticity assurance or a capacity reservation service takes effect. The system selects a private node pool to launch instances. Valid values:
16640
+ * 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:
16455
16641
  *
16456
- * * `Open`: uses open private pool. The system selects an open private pool to start instances. If no matching open private node pool is available, the resources in the public node pool are used.
16457
- * * `Target`: uses the specified 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.
16458
- * * `None`: No private pool is used. The resources of private pools are not used to start instances.
16642
+ * * `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.
16643
+ * * `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.
16644
+ * * `None`: does not use private pools. The resources of private node pools are not used to launch instances.
16459
16645
  *
16460
16646
  * @example
16461
16647
  * Open
@@ -16483,7 +16669,7 @@ export class CreateClusterNodePoolRequestScalingGroupPrivatePoolOptions extends
16483
16669
  export class CreateClusterNodePoolRequestScalingGroupSpotPriceLimit extends $tea.Model {
16484
16670
  /**
16485
16671
  * @remarks
16486
- * The instance type of preemptible instance.
16672
+ * The instance type of preemptible instances.
16487
16673
  *
16488
16674
  * @example
16489
16675
  * ecs.c6.large
@@ -16491,7 +16677,7 @@ export class CreateClusterNodePoolRequestScalingGroupSpotPriceLimit extends $tea
16491
16677
  instanceType?: string;
16492
16678
  /**
16493
16679
  * @remarks
16494
- * The price cap of a preemptible instance of the type.
16680
+ * The price cap of a preemptible instance.
16495
16681
  *
16496
16682
  * @example
16497
16683
  * 0.39
@@ -16519,7 +16705,7 @@ export class CreateClusterNodePoolRequestScalingGroupSpotPriceLimit extends $tea
16519
16705
  export class CreateClusterNodePoolRequestScalingGroupTags extends $tea.Model {
16520
16706
  /**
16521
16707
  * @remarks
16522
- * The tag key.
16708
+ * The label key.
16523
16709
  *
16524
16710
  * @example
16525
16711
  * node-k-1
@@ -16527,7 +16713,7 @@ export class CreateClusterNodePoolRequestScalingGroupTags extends $tea.Model {
16527
16713
  key?: string;
16528
16714
  /**
16529
16715
  * @remarks
16530
- * The tag value.
16716
+ * The label value.
16531
16717
  *
16532
16718
  * @example
16533
16719
  * node-v-1
@@ -16555,12 +16741,12 @@ export class CreateClusterNodePoolRequestScalingGroupTags extends $tea.Model {
16555
16741
  export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16556
16742
  /**
16557
16743
  * @remarks
16558
- * Specifies whether to enable auto-renewal for the nodes in the node pool. This parameter takes effect only if you set `instance_charge_type` to `PrePaid`. Valid values:
16744
+ * Specifies whether to enable auto-renewal for nodes in the node pool. This parameter takes effect only when you set `instance_charge_type` to `PrePaid`. Valid values:
16559
16745
  *
16560
- * * `true`
16561
- * * `false`
16746
+ * * `true`: enables auto-renewal.
16747
+ * * `false`: disables auto-renewal.
16562
16748
  *
16563
- * Default value: `true`.
16749
+ * Default value: `false`.
16564
16750
  *
16565
16751
  * @example
16566
16752
  * true
@@ -16568,7 +16754,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16568
16754
  autoRenew?: boolean;
16569
16755
  /**
16570
16756
  * @remarks
16571
- * The duration of the auto-renewal. This parameter takes effect and is required only if you set instance_charge_type to PrePaid and auto_renew to true. Valid values if `period_unit` is set to Month: 1, 2, 3, 6, and 12.
16757
+ * The auto-renewal duration of nodes in the node pool. This parameter is available and required only if you set instance_charge_type to PrePaid and auto_renew to true. If `PeriodUnit=Month` is configured, the valid values are 1, 2, 3, 6, and 12.
16572
16758
  *
16573
16759
  * Default value: 1.
16574
16760
  *
@@ -16578,7 +16764,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16578
16764
  autoRenewPeriod?: number;
16579
16765
  /**
16580
16766
  * @remarks
16581
- * Specifies whether to enable Center for Internet Security (CIS) reinforcement. CIS reinforcement can be enabled only if Alibaba Cloud Linux 2 or Alibaba Cloud Linux 3 is installed on nodes.
16767
+ * This parameter is deprecated. Use security_hardening_os instead.
16582
16768
  *
16583
16769
  * @example
16584
16770
  * false
@@ -16588,10 +16774,10 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16588
16774
  cisEnabled?: boolean;
16589
16775
  /**
16590
16776
  * @remarks
16591
- * 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 if you set `multi_az_policy` to `COST_OPTIMIZED`. Valid values:
16777
+ * 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 price or insufficient inventory. This parameter takes effect when you set `multi_az_policy` to `COST_OPTIMIZED`. Valid values:
16592
16778
  *
16593
- * * `true`
16594
- * * `false`
16779
+ * * `true`: automatically creates pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created.
16780
+ * * `false`: does not create pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created.
16595
16781
  *
16596
16782
  * @example
16597
16783
  * true
@@ -16599,12 +16785,12 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16599
16785
  compensateWithOnDemand?: boolean;
16600
16786
  /**
16601
16787
  * @remarks
16602
- * The configurations of the data disks that are mounted to the nodes in the node pool.
16788
+ * The configurations of the data disks that are mounted to nodes in the node pool.
16603
16789
  */
16604
16790
  dataDisks?: DataDisk[];
16605
16791
  /**
16606
16792
  * @remarks
16607
- * The deployment set ID.
16793
+ * The ID of the deployment set.
16608
16794
  *
16609
16795
  * @example
16610
16796
  * ds-bp1d19mmbsv3jf6xxxxx
@@ -16620,7 +16806,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16620
16806
  desiredSize?: number;
16621
16807
  /**
16622
16808
  * @remarks
16623
- * The custom image ID. By default, the image provided by the system is used.
16809
+ * The custom image ID. By default, the image provided by ACK is used.
16624
16810
  *
16625
16811
  * @example
16626
16812
  * aliyun_2_1903_x64_20G_alibase_20200529.vhd
@@ -16628,16 +16814,17 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16628
16814
  imageId?: string;
16629
16815
  /**
16630
16816
  * @remarks
16631
- * The type of the operating system image. You must specify this parameter or the `platform` parameter. Valid values:
16817
+ * The type of the OS image. You must specify this parameter or `platform`. Valid values:
16632
16818
  *
16633
- * * `AliyunLinux`: Alinux2
16634
- * * `AliyunLinux3`: Alinux3
16635
- * * `AliyunLinux3Arm64`: Alinux3 ARM
16636
- * * `AliyunLinuxUEFI`: Alinux2 UEFI
16637
- * * `CentOS`
16638
- * * `Windows`
16639
- * * `WindowsCore`: Windows Core
16640
- * * `ContainerOS`
16819
+ * * `AliyunLinux`: Alibaba Cloud Linux 2.
16820
+ * * `AliyunLinuxSecurity`: Alibaba Cloud Linux 2 (UEFI).
16821
+ * * `AliyunLinux3`: Alibaba Cloud Linux 3.
16822
+ * * `AliyunLinux3Arm64`: Alibaba Cloud Linux 3 (ARM).
16823
+ * * `AliyunLinux3Security`: Alibaba Cloud Linux 3 (UEFI).
16824
+ * * `CentOS`: CentOS.
16825
+ * * `Windows`: Windows.
16826
+ * * `WindowsCore`: Windows Core.
16827
+ * * `ContainerOS`: ContainerOS.
16641
16828
  *
16642
16829
  * @example
16643
16830
  * AliyunLinux
@@ -16645,10 +16832,10 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16645
16832
  imageType?: string;
16646
16833
  /**
16647
16834
  * @remarks
16648
- * The billing method of the nodes in the node pool. Valid values:
16835
+ * The billing method of nodes in the node pool. Valid values:
16649
16836
  *
16650
- * * `PrePaid`: subscription
16651
- * * `PostPaid`: pay-as-you-go
16837
+ * * `PrePaid`: subscription.
16838
+ * * `PostPaid`: pay-as-you-go.
16652
16839
  *
16653
16840
  * Default value: `PostPaid`.
16654
16841
  *
@@ -16658,10 +16845,14 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16658
16845
  * PrePaid
16659
16846
  */
16660
16847
  instanceChargeType?: string;
16848
+ /**
16849
+ * @remarks
16850
+ * The instance attributes.
16851
+ */
16661
16852
  instancePatterns?: InstancePatterns[];
16662
16853
  /**
16663
16854
  * @remarks
16664
- * The instance types of nodes in the node pool. A node that is added to the node pool is assigned one of the specified instance types that is the most appropriate. You can specify 1 to 10 instance types.
16855
+ * The instance types of nodes in the node pool. When the system adds a node to the node pool, the system selects the most appropriate one from the specified instance types for the node. You can specify 1 to 10 instance types.
16665
16856
  *
16666
16857
  * > To ensure high availability, we recommend that you specify multiple instance types.
16667
16858
  *
@@ -16670,10 +16861,10 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16670
16861
  instanceTypes?: string[];
16671
16862
  /**
16672
16863
  * @remarks
16673
- * The billing method of the public IP address. Valid values:
16864
+ * The metering method of the public IP address. Valid values:
16674
16865
  *
16675
- * * PayByBandwidth: pay-by-bandwidth
16676
- * * PayByTraffic: pay-by-data-transfer
16866
+ * * PayByBandwidth: pay-by-bandwidth.
16867
+ * * PayByTraffic: pay-by-data-transfer.
16677
16868
  *
16678
16869
  * @example
16679
16870
  * PayByTraffic
@@ -16689,9 +16880,9 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16689
16880
  internetMaxBandwidthOut?: number;
16690
16881
  /**
16691
16882
  * @remarks
16692
- * The name of the key pair. You must specify this parameter or the `login_password` parameter.
16883
+ * The name of the key pair used to log on to nodes in the node pool. You must set this parameter or `login_password`.
16693
16884
  *
16694
- * > If you want to create a managed node pool, you must specify `key_pair`.
16885
+ * > If you select ContainerOS as the OS of nodes in the node pool, you must specify `key_pair`.
16695
16886
  *
16696
16887
  * @example
16697
16888
  * np-key-name
@@ -16699,7 +16890,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16699
16890
  keyPair?: string;
16700
16891
  /**
16701
16892
  * @remarks
16702
- * Specifies whether a non-root user can log on to the ECS instance that is added to the node pool.
16893
+ * Specifies whether to allow a non-root user to log on to an ECS instance that is added to the node pool.
16703
16894
  *
16704
16895
  * @example
16705
16896
  * true
@@ -16707,7 +16898,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16707
16898
  loginAsNonRoot?: boolean;
16708
16899
  /**
16709
16900
  * @remarks
16710
- * 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.
16901
+ * 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.
16711
16902
  *
16712
16903
  * @example
16713
16904
  * Hello1234
@@ -16717,15 +16908,15 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16717
16908
  * @remarks
16718
16909
  * The ECS instance scaling policy for the multi-zone scaling group. Valid values:
16719
16910
  *
16720
- * * `PRIORITY`: ECS instances are created based on the VSwitchIds.N parameter. If Auto Scaling fails to create an ECS instance in the zone of the vSwitch that has the highest priority, Auto Scaling attempts to create the ECS instance in the zone of the vSwitch that has a lower priority.
16911
+ * * `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.
16721
16912
  *
16722
- * * `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 specify `CompensateWithOnDemand` to specify whether to automatically create pay-as-you-go instances if preemptible instances cannot be created due to insufficient resources.
16913
+ * * `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.
16723
16914
  *
16724
16915
  * **
16725
16916
  *
16726
- * **Note** `COST_OPTIMIZED` takes effect only if multiple instance types are specified or at least one preemptible instance type is specified.
16917
+ * **Note** `COST_OPTIMIZED` is valid only when multiple instance types are specified or at least one preemptible instance type is specified.
16727
16918
  *
16728
- * * `BALANCE`: ECS instances are evenly distributed across multiple zones specified by the scaling group. If the distribution of ECS instances across zones is not balanced due to reasons such as insufficient inventory, you can call the [RebalanceInstances](https://help.aliyun.com/document_detail/71516.html) operation to evenly distribute the ECS instances across zones.
16919
+ * * `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.
16729
16920
  *
16730
16921
  * Default value: `PRIORITY`.
16731
16922
  *
@@ -16751,7 +16942,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16751
16942
  onDemandPercentageAboveBaseCapacity?: number;
16752
16943
  /**
16753
16944
  * @remarks
16754
- * The subscription duration of the nodes in the node pool. This parameter takes effect and is required if you set `instance_charge_type` to `PrePaid`.
16945
+ * The subscription duration of nodes in the node pool. This parameter takes effect and is required if you set `instance_charge_type` to `PrePaid`.
16755
16946
  *
16756
16947
  * * If `period_unit` is set to Week, the valid values of `period` are 1, 2, 3, and 4.
16757
16948
  * * If `period_unit` is set to Month, the valid values of `period` are 1, 2, 3, 4, 5, 6, 7, 8, 9, 12, 24, 36, 48, and 60.
@@ -16762,7 +16953,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16762
16953
  period?: number;
16763
16954
  /**
16764
16955
  * @remarks
16765
- * The billing cycle of the nodes in the node pool. This parameter takes effect and is required if you set `instance_charge_type` to `PrePaid`. Valid values:
16956
+ * The billing cycle of nodes in the node pool. This parameter takes effect and is required if you set `instance_charge_type` to `PrePaid`. Valid values:
16766
16957
  *
16767
16958
  * * `Month`: The subscription duration is measured in months.
16768
16959
  * * `Week`: The subscription duration is measured in weeks.
@@ -16775,7 +16966,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16775
16966
  periodUnit?: string;
16776
16967
  /**
16777
16968
  * @remarks
16778
- * The operating system distribution. Valid values:
16969
+ * The OS distribution that is used. Valid values:
16779
16970
  *
16780
16971
  * * `CentOS`
16781
16972
  * * `AliyunLinux`
@@ -16796,20 +16987,30 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16796
16987
  */
16797
16988
  privatePoolOptions?: CreateClusterNodePoolRequestScalingGroupPrivatePoolOptions;
16798
16989
  /**
16990
+ * @remarks
16991
+ * The name of the worker Resource Access Management (RAM) role.
16992
+ *
16993
+ * * If you do not specify this parameter, the default worker RAM role created by the cluster is used.
16994
+ * * 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-`.
16995
+ *
16996
+ * This parameter is available only to users in the whitelist. To use this parameter, submit a ticket.
16997
+ *
16998
+ * > This parameter is available only for ACK managed clusters that run Kubernetes 1.22 or later.
16999
+ *
16799
17000
  * @example
16800
17001
  * example-role
16801
17002
  */
16802
17003
  ramRoleName?: string;
16803
17004
  /**
16804
17005
  * @remarks
16805
- * The ApsaraDB RDS instances.
17006
+ * A list of ApsaraDB RDS instances.
16806
17007
  */
16807
17008
  rdsInstances?: string[];
16808
17009
  /**
16809
17010
  * @remarks
16810
17011
  * The scaling mode of the scaling group. Valid values:
16811
17012
  *
16812
- * * `release`: the standard mode. ECS instances are created and released based on the resource usage.
17013
+ * * `release`: the standard mode. ECS instances are created and released based on resource usage.
16813
17014
  * * `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.
16814
17015
  *
16815
17016
  * Default value: `release`.
@@ -16830,22 +17031,22 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16830
17031
  securityGroupId?: string;
16831
17032
  /**
16832
17033
  * @remarks
16833
- * The security group IDs. You must specify this parameter or the `security_group_id` parameter. We recommend that you specify `security_group_ids`. If you specify both `security_group_id` and `security_group_ids`, `security_group_ids` is used.
17034
+ * The IDs of security groups. You must specify this parameter or `security_group_id`. We recommend that you specify `security_group_ids`. If you specify both `security_group_id` and `security_group_ids`, `security_group_ids` is used.
16834
17035
  */
16835
17036
  securityGroupIds?: string[];
16836
17037
  /**
16837
17038
  * @remarks
16838
- * 阿里云OS安全加固。取值:
17039
+ * Specifies whether to enable Alibaba Cloud Linux Security Hardening. Valid values:
16839
17040
  *
16840
- * - `true`:开启阿里云OS安全加固。
16841
- * - `false`:不开启阿里云OS安全加固。
17041
+ * * `true`: enables Alibaba Cloud Linux Security Hardening.
17042
+ * * `false`: disables Alibaba Cloud Linux Security Hardening.
16842
17043
  *
16843
- * 默认值:`false`。
17044
+ * Default value: `false`.
16844
17045
  */
16845
17046
  securityHardeningOs?: boolean;
16846
17047
  /**
16847
17048
  * @remarks
16848
- * Specifies whether to enable reinforcement based on classified protection. You can enable reinforcement based on classified protection only if Alibaba Cloud Linux 2 or Alibaba Cloud Linux 3 is installed on nodes. Alibaba Cloud provides standards for baseline check and a scanner to ensure the compliance of Alibaba Cloud Linux 2 and Alibaba Cloud Linux 3 images with the level 3 standards of classified protection.
17049
+ * 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.
16849
17050
  *
16850
17051
  * @example
16851
17052
  * false
@@ -16861,10 +17062,10 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16861
17062
  spotInstancePools?: number;
16862
17063
  /**
16863
17064
  * @remarks
16864
- * Specifies whether to enable the supplementation of preemptible instances. If the supplementation of preemptible instances is enabled, when the scaling group receives a system message that a preemptible instance is to be reclaimed, the scaling group attempts to create a new instance to replace this instance. Valid values:
17065
+ * 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:
16865
17066
  *
16866
- * * `true`
16867
- * * `false`
17067
+ * * `true`: supplements preemptible instances.
17068
+ * * `false`: does not supplement preemptible instances.
16868
17069
  *
16869
17070
  * @example
16870
17071
  * false
@@ -16872,7 +17073,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16872
17073
  spotInstanceRemedy?: boolean;
16873
17074
  /**
16874
17075
  * @remarks
16875
- * The instance type of preemptible instance and the price cap for the instance type.
17076
+ * The instance type of preemptible instances and the price cap for the instance type.
16876
17077
  */
16877
17078
  spotPriceLimit?: CreateClusterNodePoolRequestScalingGroupSpotPriceLimit[];
16878
17079
  /**
@@ -16883,7 +17084,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16883
17084
  * * `SpotWithPriceLimit`: specifies the highest bid.
16884
17085
  * * `SpotAsPriceGo`: automatically submits bids based on the up-to-date market price.
16885
17086
  *
16886
- * For more information, see [Use preemptible instances](https://help.aliyun.com/document_detail/165053.html).
17087
+ * For more information, see [Preemptible instances](https://help.aliyun.com/document_detail/165053.html).
16887
17088
  *
16888
17089
  * @example
16889
17090
  * NoSpot
@@ -16893,10 +17094,10 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16893
17094
  * @remarks
16894
17095
  * Specifies whether to enable the burst feature for the system disk. Valid values:
16895
17096
  *
16896
- * * true
16897
- * * false
17097
+ * * true: enables the burst feature.
17098
+ * * false: disables the burst feature.
16898
17099
  *
16899
- * This parameter is available only if `SystemDiskCategory` is set to `cloud_auto`. For more information, see [ESSD AutoPL disks](https://help.aliyun.com/document_detail/368372.html).
17100
+ * 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).
16900
17101
  *
16901
17102
  * @example
16902
17103
  * true
@@ -16904,16 +17105,26 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16904
17105
  systemDiskBurstingEnabled?: boolean;
16905
17106
  /**
16906
17107
  * @remarks
16907
- * The system disk types. The system attempts to create system disks of a disk type with a lower priority if the disk type with a higher priority is unavailable. Valid values: cloud: disk cloud_efficiency: ultra disk cloud_ssd: standard SSD cloud_essd: ESSD
17108
+ * 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:
17109
+ *
17110
+ * * `cloud`: basic disk.
17111
+ * * `cloud_efficiency`: ultra disk.
17112
+ * * `cloud_ssd`: standard SSD.
17113
+ * * `cloud_essd`: ESSD.
17114
+ * * `cloud_auto`: ESSD AutoPL disk.
17115
+ * * `cloud_essd_entry`: ESSD Entry disk.
16908
17116
  */
16909
17117
  systemDiskCategories?: string[];
16910
17118
  /**
16911
17119
  * @remarks
16912
17120
  * The system disk type. Valid values:
16913
17121
  *
16914
- * * `cloud_efficiency`: ultra disk
16915
- * * `cloud_ssd`: standard SSD
16916
- * * `cloud_essd`: Enterprise SSD (ESSD)
17122
+ * * `cloud`: basic disk.
17123
+ * * `cloud_efficiency`: ultra disk.
17124
+ * * `cloud_ssd`: standard SSD.
17125
+ * * `cloud_essd`: Enterprise SSD (ESSD).
17126
+ * * `cloud_auto`: ESSD AutoPL disk.
17127
+ * * `cloud_essd_entry`: ESSD Entry disk.
16917
17128
  *
16918
17129
  * Default value: `cloud_efficiency`.
16919
17130
  *
@@ -16931,7 +17142,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16931
17142
  systemDiskEncryptAlgorithm?: string;
16932
17143
  /**
16933
17144
  * @remarks
16934
- * Specifies whether to encrypt the system disk. Valid values: true false
17145
+ * Specifies whether to encrypt the system disk. Valid values: true: encrypts the system disk. false: does not encrypt the system disk.
16935
17146
  *
16936
17147
  * @example
16937
17148
  * false
@@ -16947,14 +17158,14 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16947
17158
  systemDiskKmsKeyId?: string;
16948
17159
  /**
16949
17160
  * @remarks
16950
- * The performance level (PL) of the system disk. This parameter takes effect only for an ESSD. Valid values:
17161
+ * The performance level (PL) of the system disk. This parameter takes effect only for an ESSD.
16951
17162
  *
16952
- * * PL0: moderate maximum concurrent I/O performance and low I/O latency
16953
- * * PL1: moderate maximum concurrent I/O performance and low I/O latency
16954
- * * PL2: high maximum concurrent I/O performance and low I/O latency
16955
- * * PL3: ultra-high maximum concurrent I/O performance and ultra-low I/O latency
17163
+ * * PL0: moderate maximum concurrent I/O performance and low I/O latency.
17164
+ * * PL1: moderate maximum concurrent I/O performance and low I/O latency.
17165
+ * * PL2: high maximum concurrent I/O performance and low I/O latency.
17166
+ * * PL3: ultra-high maximum concurrent I/O performance and ultra-low I/O latency.
16956
17167
  *
16957
- * > Disks support all of the preceding PLs. However, when you create a disk, the available PLs vary based on the Elastic Compute Service (ECS) instance type that you selected. For more information, see [Overview of ECS instance families](https://help.aliyun.com/document_detail/25378.html).
17168
+ * > Disks support all of the preceding PLs. However, when you create a disk, the available PLs vary based on the ECS instance type that you selected. For more information, see [Overview of ECS instance families](https://help.aliyun.com/document_detail/25378.html).
16958
17169
  *
16959
17170
  * @example
16960
17171
  * PL1
@@ -16962,9 +17173,9 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16962
17173
  systemDiskPerformanceLevel?: string;
16963
17174
  /**
16964
17175
  * @remarks
16965
- * The preset IOPS of the system disk. Valid values: 0 to min{50,000, 1,000 × Capacity - Baseline IOPS}. Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}.
17176
+ * 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}.
16966
17177
  *
16967
- * This parameter is available only if `SystemDiskCategory` is set to `cloud_auto`. For more information, see [ESSD AutoPL disks](https://help.aliyun.com/document_detail/368372.html).
17178
+ * 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).
16968
17179
  *
16969
17180
  * @example
16970
17181
  * 1000
@@ -16974,7 +17185,7 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16974
17185
  * @remarks
16975
17186
  * The size of the system disk. Unit: GiB.
16976
17187
  *
16977
- * Valid values: 20 to 20,248.
17188
+ * Valid values: 20 to 20248.
16978
17189
  *
16979
17190
  * @example
16980
17191
  * 120
@@ -16982,16 +17193,16 @@ export class CreateClusterNodePoolRequestScalingGroup extends $tea.Model {
16982
17193
  systemDiskSize?: number;
16983
17194
  /**
16984
17195
  * @remarks
16985
- * The tag that you want to add only to ECS instances.
17196
+ * The labels that you want to add only to ECS instances.
16986
17197
  *
16987
- * The tag key must be unique and can be up to 128 characters in length. The tag key and value cannot start with aliyun or acs: or contain https:// or http://.
17198
+ * 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://.
16988
17199
  */
16989
17200
  tags?: CreateClusterNodePoolRequestScalingGroupTags[];
16990
17201
  /**
16991
17202
  * @remarks
16992
- * Th vSwitch IDs. You can specify one to eight vSwitch IDs.
17203
+ * The vSwitch IDs. You can specify one to eight vSwitch IDs.
16993
17204
  *
16994
- * > To ensure high availability, we recommend that you select vSwitches in different zones.
17205
+ * > To ensure high availability, we recommend that you select vSwitches that reside in different zones.
16995
17206
  *
16996
17207
  * This parameter is required.
16997
17208
  */
@@ -17212,7 +17423,7 @@ export class DeleteClusterRequestDeleteOptions extends $tea.Model {
17212
17423
  deleteMode?: string;
17213
17424
  /**
17214
17425
  * @remarks
17215
- * Valid values:
17426
+ * The type of the resource. Valid values:
17216
17427
  *
17217
17428
  * * SLB: SLB resources created for Services. By default, the SLB resources are automatically deleted.
17218
17429
  * * ALB: Application Load Balancer (ALB) resources created by the ALB Ingress controller. By default, the ALB resources are retained.
@@ -19895,7 +20106,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup extends $
19895
20106
  privatePoolOptions?: DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroupPrivatePoolOptions;
19896
20107
  /**
19897
20108
  * @remarks
19898
- * The name of the worker Resource Access Management (RAM) role. The RAM role is assigned to the worker nodes of the cluster to allow the worker nodes to manage ECS instances.
20109
+ * This field is deprecated and replaced by the ram_role_name parameter.
19899
20110
  *
19900
20111
  * @example
19901
20112
  * KubernetesWorkerRole-021dc54f-929b-437a-8ae0-34c24d3e****
@@ -19943,15 +20154,6 @@ export class DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup extends $
19943
20154
  * The IDs of security groups for the node pool.
19944
20155
  */
19945
20156
  securityGroupIds?: string[];
19946
- /**
19947
- * @remarks
19948
- * 阿里云OS安全加固。取值:
19949
- *
19950
- * - `true`:开启阿里云OS安全加固。
19951
- * - `false`:不开启阿里云OS安全加固。
19952
- *
19953
- * 默认值:`false`。
19954
- */
19955
20157
  securityHardeningOs?: boolean;
19956
20158
  /**
19957
20159
  * @remarks
@@ -20383,7 +20585,7 @@ export class DescribeClusterNodePoolsResponseBodyNodepools extends $tea.Model {
20383
20585
  nodepoolInfo?: DescribeClusterNodePoolsResponseBodyNodepoolsNodepoolInfo;
20384
20586
  /**
20385
20587
  * @remarks
20386
- * The configurations of the scaling group.
20588
+ * The configuration of the scaling group.
20387
20589
  */
20388
20590
  scalingGroup?: DescribeClusterNodePoolsResponseBodyNodepoolsScalingGroup;
20389
20591
  /**
@@ -20909,11 +21111,11 @@ export class DescribeClusterResourcesResponseBody extends $tea.Model {
20909
21111
  deleteBehavior?: DescribeClusterResourcesResponseBodyDeleteBehavior;
20910
21112
  /**
20911
21113
  * @remarks
20912
- * The type of the resource creator. Valid values:
21114
+ * The resource creator. Valid values:
20913
21115
  *
20914
- * * user: the resource is created by the user.
20915
- * * system: the resource is created by the ACK management system.
20916
- * * addon: the resource is created by a cluster component.
21116
+ * * user: The resource is created by the user.
21117
+ * * system: The resource is created by the ACK management system.
21118
+ * * addon: The resource is created by a cluster component.
20917
21119
  *
20918
21120
  * @example
20919
21121
  * addon
@@ -21365,10 +21567,10 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21365
21567
  clusterId?: string;
21366
21568
  /**
21367
21569
  * @remarks
21368
- * The type of ACK managed cluster. This parameter is available only for ACK managed clusters. Valid values:
21570
+ * After you set `cluster_type` to `ManagedKubernetes` and configure the `profile` parameter, you can further specify the edition of the cluster. Valid values:
21369
21571
  *
21370
- * * `ack.pro.small`: ACK Pro cluster
21371
- * * `ack.standard`: ACK Basic cluster
21572
+ * * `ack.pro.small`: ACK Pro cluster.
21573
+ * * `ack.standard`: ACK Basic cluster. If you leave the parameter empty, ACK Basic cluster is selected.
21372
21574
  *
21373
21575
  * @example
21374
21576
  * ack.standard
@@ -21376,12 +21578,9 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21376
21578
  clusterSpec?: string;
21377
21579
  /**
21378
21580
  * @remarks
21379
- * The cluster type. Valid values:
21380
- *
21381
- * * `Kubernetes`: ACK dedicated cluster
21382
- * * `ManagedKubernetes`: ACK managed cluster
21383
- * * `Ask`: ACK Serverless cluster
21384
- * * `ExternalKubernetes`: registered cluster
21581
+ * * `Kubernetes`: ACK dedicated cluster.
21582
+ * * `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.
21583
+ * * `ExternalKubernetes`: registered cluster.
21385
21584
  *
21386
21585
  * @example
21387
21586
  * Kubernetes
@@ -21405,10 +21604,10 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21405
21604
  currentVersion?: string;
21406
21605
  /**
21407
21606
  * @remarks
21408
- * Indicates whether deletion protection is enabled for the cluster. If deletion protection is enabled, the cluster cannot be deleted in the ACK console or by calling API operations. Valid values:
21607
+ * 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:
21409
21608
  *
21410
- * * `true`: Deletion protection is enabled for the cluster. The cluster cannot be deleted in the ACK console or by calling API operations.
21411
- * * `false`: Deletion protection is disabled for the cluster. The cluster can be deleted in the ACK console or by calling API operations.
21609
+ * * `true`: enables deletion protection for the cluster. This way, the cluster cannot be deleted in the ACK console or by calling API operations.
21610
+ * * `false`: disables deletion protection for the cluster. This way, the cluster can be deleted in the ACK console or by calling API operations.
21412
21611
  *
21413
21612
  * @example
21414
21613
  * true
@@ -21424,7 +21623,7 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21424
21623
  dockerVersion?: string;
21425
21624
  /**
21426
21625
  * @remarks
21427
- * The ID of the Server Load Balancer (SLB) instance that is used by the Ingress of the cluster.
21626
+ * The ID of the Server Load Balancer (SLB) instance that is used by the Ingresses of the cluster.
21428
21627
  *
21429
21628
  * The default SLB specification is slb.s1.small, which belongs to the high-performance instance type.
21430
21629
  *
@@ -21434,9 +21633,9 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21434
21633
  externalLoadbalancerId?: string;
21435
21634
  /**
21436
21635
  * @remarks
21437
- * The Kubernetes version of the cluster. The Kubernetes versions supported by ACK are the same as the versions of open source Kubernetes. We recommend that you specify the latest Kubernetes version. If you do not specify this parameter, the latest Kubernetes version is used.
21636
+ * The Kubernetes version of the cluster. The Kubernetes versions supported by ACK are the same as the Kubernetes versions supported by open source Kubernetes. We recommend that you specify the latest Kubernetes version. If you do not configure this parameter, the latest Kubernetes version is used.
21438
21637
  *
21439
- * You can create clusters of the latest two Kubernetes versions in the ACK console. You can call the corresponding ACK API operation to create clusters of other Kubernetes versions. For more information about the Kubernetes versions supported by ACK, see [Release notes for Kubernetes versions](https://help.aliyun.com/document_detail/185269.html).
21638
+ * You can create clusters that run the latest two Kubernetes versions in the ACK console. You can call the API operation to create clusters of other Kubernetes versions. For more information about the Kubernetes versions supported by ACK, see [Release notes for Kubernetes versions](https://help.aliyun.com/document_detail/185269.html).
21440
21639
  *
21441
21640
  * @example
21442
21641
  * 1.16.9-aliyun.1
@@ -21444,12 +21643,12 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21444
21643
  initVersion?: string;
21445
21644
  /**
21446
21645
  * @remarks
21447
- * The maintenance window of the cluster. This feature is available only for ACK Pro clusters.
21646
+ * The maintenance window of the cluster. This feature is available only for ACK managed clusters and ACK Serverless clusters.
21448
21647
  */
21449
21648
  maintenanceWindow?: MaintenanceWindow;
21450
21649
  /**
21451
21650
  * @remarks
21452
- * The endpoint of the cluster API server, including an internal endpoint and a public endpoint.
21651
+ * The address of the cluster API server. It includes an internal endpoint and a public endpoint.
21453
21652
  *
21454
21653
  * @example
21455
21654
  * {\\"api_server_endpoint\\":\\"\\",\\"intranet_api_server_endpoint\\":\\"https://192.168.0.251:6443\\"}
@@ -21467,7 +21666,7 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21467
21666
  * @remarks
21468
21667
  * The cluster name.
21469
21668
  *
21470
- * The name must be 1 to 63 characters in length and can contain digits, letters, and hyphens (-). The name cannot start with a hyphen (-).
21669
+ * The name must be 1 to 63 characters in length, and can contain digits, letters, and hyphens (-). The name cannot start with a hyphen (-).
21471
21670
  *
21472
21671
  * @example
21473
21672
  * cluster-demo
@@ -21477,9 +21676,9 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21477
21676
  * @remarks
21478
21677
  * The network mode of the cluster. Valid values:
21479
21678
  *
21480
- * * `classic`: classic network
21481
- * * `vpc`: virtual private cloud (VPC)
21482
- * * `overlay`: overlay network
21679
+ * * `classic`: classic network.
21680
+ * * `vpc`: virtual private cloud (VPC).
21681
+ * * `overlay`: overlay network.
21483
21682
  * * `calico`: network powered by Calico.
21484
21683
  *
21485
21684
  * @example
@@ -21509,8 +21708,10 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21509
21708
  * @remarks
21510
21709
  * The cluster identifier. Valid values:
21511
21710
  *
21512
- * * `Edge`: The cluster is an ACK Edge cluster.
21513
- * * `Default`: The cluster is not an ACK Edge cluster.
21711
+ * * `Default`: ACK managed cluster. ACK managed clusters include ACK Basic clusters and ACK Pro clusters.
21712
+ * * `Edge`: ACK Edge cluster. ACK Edge clusters include ACK Edge Basic clusters and ACK Edge Pro clusters.
21713
+ * * `Serverless`: ACK Serverless cluster. ACK Serverless clusters include ACK Serverless Basic clusters and ACK Serverless Pro clusters.
21714
+ * * `Lingjun`: ACK Lingjun Pro cluster.
21514
21715
  *
21515
21716
  * @example
21516
21717
  * Default
@@ -21534,7 +21735,7 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21534
21735
  resourceGroupId?: string;
21535
21736
  /**
21536
21737
  * @remarks
21537
- * The ID of the security group to which the instances of the cluster belong.
21738
+ * The ID of the security group of the cluster.
21538
21739
  *
21539
21740
  * @example
21540
21741
  * sg-2vcgwsrwgt5mp0yi****
@@ -21575,9 +21776,9 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21575
21776
  * * 172.16-31.0.0/12-16
21576
21777
  * * 192.168.0.0/16
21577
21778
  *
21578
- * The CIDR block of pods 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 the cluster is created.
21779
+ * 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.
21579
21780
  *
21580
- * For more information, see [Plan CIDR blocks for an ACK cluster](https://help.aliyun.com/document_detail/86500.html).
21781
+ * 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).
21581
21782
  *
21582
21783
  * @example
21583
21784
  * 172.21.0.0/16
@@ -21614,7 +21815,7 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21614
21815
  vswitchId?: string;
21615
21816
  /**
21616
21817
  * @remarks
21617
- * The name of the worker Resource Access Management (RAM) role. The RAM role is assigned to the worker nodes of the cluster to allow the worker nodes to manage Elastic Compute Service (ECS) instances.
21818
+ * The name of the worker Resource Access Management (RAM) role. The RAM role is assigned to the worker nodes of the cluster to allow the worker nodes to manage ECS instances.
21618
21819
  *
21619
21820
  * @example
21620
21821
  * KubernetesWorkerRole-ec87d15b-edca-4302-933f-c8a16bf0****
@@ -21622,7 +21823,7 @@ export class DescribeClustersV1ResponseBodyClusters extends $tea.Model {
21622
21823
  workerRamRoleName?: string;
21623
21824
  /**
21624
21825
  * @remarks
21625
- * The zone ID.
21826
+ * The ID of the zone where the cluster is deployed.
21626
21827
  *
21627
21828
  * @example
21628
21829
  * cn-beijing-b
@@ -22256,7 +22457,7 @@ export class DescribeKubernetesVersionMetadataResponseBodyImages extends $tea.Mo
22256
22457
  imageType?: string;
22257
22458
  /**
22258
22459
  * @remarks
22259
- * The type of operating system. Examples:
22460
+ * The type of OS. Examples:
22260
22461
  *
22261
22462
  * * `Windows`
22262
22463
  * * `Linux`
@@ -22340,7 +22541,7 @@ export class DescribeKubernetesVersionMetadataResponseBody extends $tea.Model {
22340
22541
  runtimes?: Runtime[];
22341
22542
  /**
22342
22543
  * @remarks
22343
- * The Kubernetes version that is supported by ACK. For more information, see [Release notes for Kubernetes versions](https://help.aliyun.com/document_detail/185269.html).
22544
+ * The Kubernetes version supported by ACK. For more information, see [Release notes for Kubernetes versions](https://help.aliyun.com/document_detail/185269.html).
22344
22545
  *
22345
22546
  * @example
22346
22547
  * 1.16.9-aliyun.1
@@ -22370,6 +22571,10 @@ export class DescribeKubernetesVersionMetadataResponseBody extends $tea.Model {
22370
22571
  * true
22371
22572
  */
22372
22573
  creatable?: boolean;
22574
+ /**
22575
+ * @remarks
22576
+ * The list of available versions for updates.
22577
+ */
22373
22578
  upgradableVersions?: string[];
22374
22579
  static names(): { [key: string]: string } {
22375
22580
  return {
@@ -23051,7 +23256,7 @@ export class DescribePolicyInstancesResponseBody extends $tea.Model {
23051
23256
  export class DescribePolicyInstancesStatusResponseBodyPolicyInstances extends $tea.Model {
23052
23257
  /**
23053
23258
  * @remarks
23054
- * The policy type. For more information about different types of policies and their descriptions, see [Predefined security policies of ACK](https://help.aliyun.com/document_detail/359819.html).
23259
+ * The type of the policy. For more information about different types of policies and their descriptions, see [Predefined security policies of ACK](https://help.aliyun.com/document_detail/359819.html).
23055
23260
  *
23056
23261
  * @example
23057
23262
  * compliance
@@ -23917,9 +24122,9 @@ export class DescribeUserPermissionResponseBody extends $tea.Model {
23917
24122
  export class DescribeUserQuotaResponseBodyEdgeImprovedNodepoolQuota extends $tea.Model {
23918
24123
  /**
23919
24124
  * @remarks
23920
- * This parameter is deprecated.
24125
+ * This parameter is discontinued.
23921
24126
  *
23922
- * The maximum bandwidth of each enhanced node pool. Unit: Mbit/s.
24127
+ * The maximum bandwidth of each enhanced edge node pool. Unit: Mbit/s.
23923
24128
  *
23924
24129
  * @example
23925
24130
  * 10
@@ -23927,9 +24132,9 @@ export class DescribeUserQuotaResponseBodyEdgeImprovedNodepoolQuota extends $tea
23927
24132
  bandwidth?: number;
23928
24133
  /**
23929
24134
  * @remarks
23930
- * This parameter is deprecated.
24135
+ * This parameter is discontinued.
23931
24136
  *
23932
- * The quota of enhanced edge node pools that belong to an Alibaba Cloud account.
24137
+ * The maximum number of enhanced edge node pools that you can create within an Alibaba Cloud account.
23933
24138
  *
23934
24139
  * @example
23935
24140
  * 3
@@ -23937,11 +24142,11 @@ export class DescribeUserQuotaResponseBodyEdgeImprovedNodepoolQuota extends $tea
23937
24142
  count?: number;
23938
24143
  /**
23939
24144
  * @remarks
23940
- * This parameter is deprecated.
24145
+ * This parameter is discontinued.
23941
24146
  *
23942
24147
  * The maximum subscription duration of an enhanced edge node pool. Unit: months.
23943
24148
  *
23944
- * > You can ignore this parameter because enhanced edge node pools are pay-as-you-go resources.
24149
+ * > You are charged for enhanced edge node pools based on the pay-as-you-go billing method. Therefore, you can ignore this parameter.
23945
24150
  *
23946
24151
  * @example
23947
24152
  * 3
@@ -24098,41 +24303,71 @@ export class GetClusterAddonInstanceResponseBodyLogging extends $tea.Model {
24098
24303
 
24099
24304
  export class GetClusterDiagnosisCheckItemsResponseBodyCheckItems extends $tea.Model {
24100
24305
  /**
24306
+ * @remarks
24307
+ * The description.
24308
+ *
24101
24309
  * @example
24102
24310
  * Check whether the node can access host dns service
24103
24311
  */
24104
24312
  desc?: string;
24105
24313
  /**
24314
+ * @remarks
24315
+ * The display name.
24316
+ *
24106
24317
  * @example
24107
24318
  * HostDNS
24108
24319
  */
24109
24320
  display?: string;
24110
24321
  /**
24322
+ * @remarks
24323
+ * The name of the group to which the check item belongs.
24324
+ *
24111
24325
  * @example
24112
24326
  * Node
24113
24327
  */
24114
24328
  group?: string;
24115
24329
  /**
24330
+ * @remarks
24331
+ * The severity level of the check result.
24332
+ *
24333
+ * Valid values:
24334
+ *
24335
+ * * normal
24336
+ * * warning
24337
+ * * error
24338
+ *
24116
24339
  * @example
24117
24340
  * normal
24118
24341
  */
24119
24342
  level?: string;
24120
24343
  /**
24344
+ * @remarks
24345
+ * The check result.
24346
+ *
24121
24347
  * @example
24122
24348
  * success
24123
24349
  */
24124
24350
  message?: string;
24125
24351
  /**
24352
+ * @remarks
24353
+ * The name of the check item.
24354
+ *
24126
24355
  * @example
24127
24356
  * HostDNS
24128
24357
  */
24129
24358
  name?: string;
24130
24359
  /**
24360
+ * @remarks
24361
+ * The reference value.
24362
+ *
24131
24363
  * @example
24132
24364
  * True
24133
24365
  */
24134
24366
  refer?: string;
24135
24367
  /**
24368
+ * @remarks
24369
+ * The value of the check item.
24370
+ *
24136
24371
  * @example
24137
24372
  * True
24138
24373
  */
@@ -24725,7 +24960,7 @@ export class ListClusterKubeconfigStatesResponseBodyPage extends $tea.Model {
24725
24960
  export class ListClusterKubeconfigStatesResponseBodyStates extends $tea.Model {
24726
24961
  /**
24727
24962
  * @remarks
24728
- * The display name of the account.
24963
+ * The displayed name or role name of the RAM user.
24729
24964
  *
24730
24965
  * @example
24731
24966
  * tom
@@ -24741,7 +24976,7 @@ export class ListClusterKubeconfigStatesResponseBodyStates extends $tea.Model {
24741
24976
  accountId?: string;
24742
24977
  /**
24743
24978
  * @remarks
24744
- * The name of the account.
24979
+ * The logon name or role name of the RAM user.
24745
24980
  *
24746
24981
  * @example
24747
24982
  * tom
@@ -24749,7 +24984,7 @@ export class ListClusterKubeconfigStatesResponseBodyStates extends $tea.Model {
24749
24984
  accountName?: string;
24750
24985
  /**
24751
24986
  * @remarks
24752
- * The status of the account. Valid values:
24987
+ * The status of the account.
24753
24988
  *
24754
24989
  * * Active: The account is active.
24755
24990
  * * InActive: The account is locked.
@@ -24761,7 +24996,7 @@ export class ListClusterKubeconfigStatesResponseBodyStates extends $tea.Model {
24761
24996
  accountState?: string;
24762
24997
  /**
24763
24998
  * @remarks
24764
- * The type of the account. Valid values:
24999
+ * The type of the account.
24765
25000
  *
24766
25001
  * * RootAccount: Alibaba Cloud account.
24767
25002
  * * RamUser: RAM user.
@@ -24773,7 +25008,7 @@ export class ListClusterKubeconfigStatesResponseBodyStates extends $tea.Model {
24773
25008
  accountType?: string;
24774
25009
  /**
24775
25010
  * @remarks
24776
- * Expiration time of the certificate.
25011
+ * The expiration time of the client certificate for the kubeconfig file.
24777
25012
  *
24778
25013
  * @example
24779
25014
  * 2027-07-15T01:32:20Z
@@ -24781,7 +25016,7 @@ export class ListClusterKubeconfigStatesResponseBodyStates extends $tea.Model {
24781
25016
  certExpireTime?: string;
24782
25017
  /**
24783
25018
  * @remarks
24784
- * The status of the certificate.
25019
+ * The status of the client certificate for the kubeconfig file.
24785
25020
  *
24786
25021
  * * Unexpired: The certificate is not expired.
24787
25022
  * * Expired: The certificate is expired.
@@ -24793,7 +25028,7 @@ export class ListClusterKubeconfigStatesResponseBodyStates extends $tea.Model {
24793
25028
  certState?: string;
24794
25029
  /**
24795
25030
  * @remarks
24796
- * Indicates whether the certificate can be revoked.
25031
+ * Indicates whether the client certificate for the kubeconfig file can be revoked.
24797
25032
  *
24798
25033
  * @example
24799
25034
  * true
@@ -25155,10 +25390,20 @@ export class ListUserKubeConfigStatesResponseBodyStates extends $tea.Model {
25155
25390
 
25156
25391
  export class ModifyClusterRequestApiServerCustomCertSans extends $tea.Model {
25157
25392
  /**
25393
+ * @remarks
25394
+ * Specifies whether to overwrite or add SANs. Valid values:
25395
+ *
25396
+ * * overwrite: overwrites SANs.
25397
+ * * append: adds SANs.
25398
+ *
25158
25399
  * @example
25159
25400
  * append
25160
25401
  */
25161
25402
  action?: string;
25403
+ /**
25404
+ * @remarks
25405
+ * The SANs.
25406
+ */
25162
25407
  subjectAlternativeNames?: string[];
25163
25408
  static names(): { [key: string]: string } {
25164
25409
  return {
@@ -25181,11 +25426,21 @@ export class ModifyClusterRequestApiServerCustomCertSans extends $tea.Model {
25181
25426
 
25182
25427
  export class ModifyClusterRequestOperationPolicyClusterAutoUpgrade extends $tea.Model {
25183
25428
  /**
25429
+ * @remarks
25430
+ * The frequency of auto cluster updates. Valid values:
25431
+ *
25432
+ * * patch
25433
+ * * stable
25434
+ * * rapid
25435
+ *
25184
25436
  * @example
25185
25437
  * patch
25186
25438
  */
25187
25439
  channel?: string;
25188
25440
  /**
25441
+ * @remarks
25442
+ * Specifies whether to enable auto cluster update.
25443
+ *
25189
25444
  * @example
25190
25445
  * true
25191
25446
  */
@@ -25210,6 +25465,10 @@ export class ModifyClusterRequestOperationPolicyClusterAutoUpgrade extends $tea.
25210
25465
  }
25211
25466
 
25212
25467
  export class ModifyClusterRequestOperationPolicy extends $tea.Model {
25468
+ /**
25469
+ * @remarks
25470
+ * The configurations of auto cluster update.
25471
+ */
25213
25472
  clusterAutoUpgrade?: ModifyClusterRequestOperationPolicyClusterAutoUpgrade;
25214
25473
  static names(): { [key: string]: string } {
25215
25474
  return {
@@ -25239,7 +25498,7 @@ export class ModifyClusterRequestSystemEventsLogging extends $tea.Model {
25239
25498
  enabled?: boolean;
25240
25499
  /**
25241
25500
  * @remarks
25242
- * The name of the LogProject that stores system events.
25501
+ * The name of the Simple Log Service project that stores system events.
25243
25502
  *
25244
25503
  * @example
25245
25504
  * k8s-log-cb95aa626a47740afbf6aa099b65****
@@ -25346,7 +25605,7 @@ export class ModifyClusterNodePoolRequestAutoScaling extends $tea.Model {
25346
25605
  eipBandwidth?: number;
25347
25606
  /**
25348
25607
  * @remarks
25349
- * The metering method of the EIP. Valid values:
25608
+ * The metering method of the elastic IP address (EIP). Valid values:
25350
25609
  *
25351
25610
  * * `PayByBandwidth`: pay-by-bandwidth.
25352
25611
  * * `PayByTraffic`: pay-by-data-transfer.
@@ -25374,10 +25633,10 @@ export class ModifyClusterNodePoolRequestAutoScaling extends $tea.Model {
25374
25633
  enable?: boolean;
25375
25634
  /**
25376
25635
  * @remarks
25377
- * Specifies whether to associate an elastic IP address (EIP) with the node pool. Valid values:
25636
+ * Specifies whether to associate an EIP with the node pool. Valid values:
25378
25637
  *
25379
25638
  * * `true`: associates an EIP with the node pool.
25380
- * * `false`: does not associate an EIP with the node pool.
25639
+ * * `false`: No EIP is associated with the node pool.
25381
25640
  *
25382
25641
  * Default value: `false`.
25383
25642
  *
@@ -25405,7 +25664,7 @@ export class ModifyClusterNodePoolRequestAutoScaling extends $tea.Model {
25405
25664
  minInstances?: number;
25406
25665
  /**
25407
25666
  * @remarks
25408
- * The instance types that can be used for auto scaling of the node pool. Valid values:
25667
+ * The instance type that is used for auto scaling. Valid values:
25409
25668
  *
25410
25669
  * * `cpu`: regular instance.
25411
25670
  * * `gpu`: GPU-accelerated instance.
@@ -25465,9 +25724,9 @@ export class ModifyClusterNodePoolRequestKubernetesConfig extends $tea.Model {
25465
25724
  cmsEnabled?: boolean;
25466
25725
  /**
25467
25726
  * @remarks
25468
- * The CPU management policy of the nodes in the node pool. The following policies are supported if the Kubernetes version of the cluster is 1.12.6 or later:
25727
+ * 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:
25469
25728
  *
25470
- * * `static`: allows pods with specific resource characteristics on the node to be granted enhanced CPU affinity and exclusivity.
25729
+ * * `static`: allows pods with specific resource characteristics on the node to be granted with enhanced CPU affinity and exclusivity.
25471
25730
  * * `none`: specifies that the default CPU affinity is used.
25472
25731
  *
25473
25732
  * Default value: `none`.
@@ -25478,9 +25737,9 @@ export class ModifyClusterNodePoolRequestKubernetesConfig extends $tea.Model {
25478
25737
  cpuPolicy?: string;
25479
25738
  /**
25480
25739
  * @remarks
25481
- * The labels of the nodes in the node pool. You can add labels to the nodes in the cluster. You must add labels based on the following rules:
25740
+ * The labels that you want to add to nodes in the cluster. You must add labels based on the following rules:
25482
25741
  *
25483
- * * A tag is a case-sensitive key-value pair. You can add up to 20 tags.
25742
+ * * A label is a case-sensitive key-value pair. You can add up to 20 labels.
25484
25743
  * * 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).
25485
25744
  */
25486
25745
  labels?: Tag[];
@@ -25502,7 +25761,7 @@ export class ModifyClusterNodePoolRequestKubernetesConfig extends $tea.Model {
25502
25761
  runtimeVersion?: string;
25503
25762
  /**
25504
25763
  * @remarks
25505
- * The configuration of a node taint.
25764
+ * The taints.
25506
25765
  */
25507
25766
  taints?: Taint[];
25508
25767
  /**
@@ -25515,7 +25774,7 @@ export class ModifyClusterNodePoolRequestKubernetesConfig extends $tea.Model {
25515
25774
  unschedulable?: boolean;
25516
25775
  /**
25517
25776
  * @remarks
25518
- * The user-defined data of the node pool. For more information, see [Prepare user data](https://help.aliyun.com/document_detail/49121.html).
25777
+ * The user data on the node. For more information, see [Prepare user data](https://help.aliyun.com/document_detail/49121.html).
25519
25778
  *
25520
25779
  * @example
25521
25780
  * IyEvdXNyL2Jpbi9iYXNoCmVjaG8gIkhlbGxvIEFDSyEi
@@ -25555,10 +25814,10 @@ export class ModifyClusterNodePoolRequestKubernetesConfig extends $tea.Model {
25555
25814
  export class ModifyClusterNodePoolRequestManagementAutoRepairPolicy extends $tea.Model {
25556
25815
  /**
25557
25816
  * @remarks
25558
- * Specifies whether ACK is allowed to automatically restart nodes after repairing the nodes. Valid values:
25817
+ * Specifies whether to allow node restart. Valid values:
25559
25818
  *
25560
- * * `true`: yes.
25561
- * * `false`: no.
25819
+ * * `true`: allows node restart.
25820
+ * * `false`: does not allow node restart.
25562
25821
  *
25563
25822
  * @example
25564
25823
  * true
@@ -25584,10 +25843,10 @@ export class ModifyClusterNodePoolRequestManagementAutoRepairPolicy extends $tea
25584
25843
  export class ModifyClusterNodePoolRequestManagementAutoUpgradePolicy extends $tea.Model {
25585
25844
  /**
25586
25845
  * @remarks
25587
- * Specifies whether ACK is allowed to automatically update the kubelet. Valid values:
25846
+ * Specifies whether to allow auto update of the kubelet. Valid values:
25588
25847
  *
25589
- * * `true`: yes.
25590
- * * `false`: no.
25848
+ * * `true`: allows auto update of the kubelet.
25849
+ * * `false`: does not allow auto update of the kubelet.
25591
25850
  *
25592
25851
  * @example
25593
25852
  * true
@@ -25595,20 +25854,20 @@ export class ModifyClusterNodePoolRequestManagementAutoUpgradePolicy extends $te
25595
25854
  autoUpgradeKubelet?: boolean;
25596
25855
  /**
25597
25856
  * @remarks
25598
- * Specifies whether ACK is allowed to automatically update the operating system. This parameter takes effect only when you specify `auto_upgrade=true`. Valid values:
25857
+ * Specifies whether to allow auto update of the OS. This parameter takes effect only when you specify `auto_upgrade=true`. Valid values:
25599
25858
  *
25600
- * * `true`: yes.
25601
- * * `false`: no.
25859
+ * * `true`: allows auto update of the OS.
25860
+ * * `false`: does not allow auto update of the OS.
25602
25861
  *
25603
25862
  * Default value: `false`.
25604
25863
  */
25605
25864
  autoUpgradeOs?: boolean;
25606
25865
  /**
25607
25866
  * @remarks
25608
- * Specifies whether ACK is allowed to automatically update the runtime. This parameter takes effect only when you specify `auto_upgrade=true`. Valid values:
25867
+ * Specifies whether to allow auto update of the runtime. This parameter takes effect only when you specify `auto_upgrade=true`. Valid values:
25609
25868
  *
25610
- * * `true`: yes.
25611
- * * `false`: no.
25869
+ * * `true`: allows auto update of the runtime.
25870
+ * * `false`: does not allow auto update of the runtime.
25612
25871
  *
25613
25872
  * Default value: `false`.
25614
25873
  */
@@ -25637,10 +25896,10 @@ export class ModifyClusterNodePoolRequestManagementAutoUpgradePolicy extends $te
25637
25896
  export class ModifyClusterNodePoolRequestManagementAutoVulFixPolicy extends $tea.Model {
25638
25897
  /**
25639
25898
  * @remarks
25640
- * Specifies whether ACK is allowed to automatically restart nodes after patching CVE vulnerabilities. Valid values:
25899
+ * Specifies whether to allow node restart. Valid values:
25641
25900
  *
25642
- * * `true`: yes.
25643
- * * `false`: no.
25901
+ * * `true`: allows node restart.
25902
+ * * `false`: does not allow node restart.
25644
25903
  *
25645
25904
  * @example
25646
25905
  * true
@@ -25648,7 +25907,7 @@ export class ModifyClusterNodePoolRequestManagementAutoVulFixPolicy extends $tea
25648
25907
  restartNode?: boolean;
25649
25908
  /**
25650
25909
  * @remarks
25651
- * The severity levels of vulnerabilities that ACK is allowed to automatically patch. Multiple severity levels are separated by commas (,).
25910
+ * The severity levels of CVEs that can be automatically patched. Separate multiple levels with commas (,).
25652
25911
  *
25653
25912
  * @example
25654
25913
  * asap,nntf
@@ -25676,7 +25935,7 @@ export class ModifyClusterNodePoolRequestManagementAutoVulFixPolicy extends $tea
25676
25935
  export class ModifyClusterNodePoolRequestManagementUpgradeConfig extends $tea.Model {
25677
25936
  /**
25678
25937
  * @remarks
25679
- * Specifies whether to enable auto update.
25938
+ * Specifies whether to enable auto update. Valid values:
25680
25939
  *
25681
25940
  * * true: enables auto update.
25682
25941
  * * false: disables auto update.
@@ -25691,7 +25950,7 @@ export class ModifyClusterNodePoolRequestManagementUpgradeConfig extends $tea.Mo
25691
25950
  autoUpgrade?: boolean;
25692
25951
  /**
25693
25952
  * @remarks
25694
- * The maximum number of nodes that can be in the Unavailable state.
25953
+ * The maximum number of unavailable nodes.
25695
25954
  *
25696
25955
  * Valid values: 1 to 1000.
25697
25956
  *
@@ -25703,9 +25962,9 @@ export class ModifyClusterNodePoolRequestManagementUpgradeConfig extends $tea.Mo
25703
25962
  maxUnavailable?: number;
25704
25963
  /**
25705
25964
  * @remarks
25706
- * The number of nodes that are temporarily added to the node pool during an auto update. Additional nodes are used to host the workloads of nodes that are being updated.
25965
+ * The number of additional nodes that are temporarily added to the node pool during an auto update. A node is unavailable during an update. Additional nodes are used to temporarily host the workloads of nodes that are being updated.
25707
25966
  *
25708
- * > We recommend that you set the number of additional nodes to a value that does not exceed the current number of existing nodes.
25967
+ * > We recommend that you set the number of additional nodes to a value that does not exceed the current number of existing nodes in the node pool.
25709
25968
  *
25710
25969
  * @example
25711
25970
  * 5
@@ -25713,7 +25972,7 @@ export class ModifyClusterNodePoolRequestManagementUpgradeConfig extends $tea.Mo
25713
25972
  surge?: number;
25714
25973
  /**
25715
25974
  * @remarks
25716
- * The percentage of additional nodes to the nodes in the node pool. You must set this parameter or `surge`.
25975
+ * The percentage of additional nodes that are temporarily added to the node pool during an auto update. You must set this parameter or `surge`.
25717
25976
  *
25718
25977
  * @example
25719
25978
  * 0
@@ -25779,10 +26038,10 @@ export class ModifyClusterNodePoolRequestManagement extends $tea.Model {
25779
26038
  autoUpgradePolicy?: ModifyClusterNodePoolRequestManagementAutoUpgradePolicy;
25780
26039
  /**
25781
26040
  * @remarks
25782
- * Specifies whether ACK is allowed to automatically patch CVE vulnerabilities. Valid values:
26041
+ * Specifies whether to enable auto Common Vulnerabilities and Exposures (CVE) patching. Valid values:
25783
26042
  *
25784
- * * `true`: yes.
25785
- * * `true`: no.
26043
+ * * `true`: enables auto CVE patching.
26044
+ * * `true`: disables auto CVE patching.
25786
26045
  *
25787
26046
  * @example
25788
26047
  * true
@@ -25808,7 +26067,7 @@ export class ModifyClusterNodePoolRequestManagement extends $tea.Model {
25808
26067
  enable?: boolean;
25809
26068
  /**
25810
26069
  * @remarks
25811
- * The configuration of auto update. The configuration takes effect only when `enable=true` is specified.
26070
+ * The configurations of auto update. The configuration takes effect only when you specify `enable=true`.
25812
26071
  *
25813
26072
  * @deprecated
25814
26073
  */
@@ -25857,7 +26116,7 @@ export class ModifyClusterNodePoolRequestNodepoolInfo extends $tea.Model {
25857
26116
  name?: string;
25858
26117
  /**
25859
26118
  * @remarks
25860
- * The ID of the resource group.
26119
+ * The resource group ID.
25861
26120
  *
25862
26121
  * @example
25863
26122
  * rg-acfmyvw3wjm****
@@ -25885,7 +26144,7 @@ export class ModifyClusterNodePoolRequestNodepoolInfo extends $tea.Model {
25885
26144
  export class ModifyClusterNodePoolRequestScalingGroupPrivatePoolOptions extends $tea.Model {
25886
26145
  /**
25887
26146
  * @remarks
25888
- * The ID of the private node pool.
26147
+ * The private node pool ID.
25889
26148
  *
25890
26149
  * @example
25891
26150
  * eap-bp67acfmxazb4****
@@ -25893,11 +26152,11 @@ export class ModifyClusterNodePoolRequestScalingGroupPrivatePoolOptions extends
25893
26152
  id?: string;
25894
26153
  /**
25895
26154
  * @remarks
25896
- * The type of the private node pool. This parameter specifies the type of private node pool that you want to use to create instances. A private node pool is generated when an elasticity assurance or a capacity reservation service takes effect. The system selects a private node pool to launch instances. Valid values:
26155
+ * The type of private node pool. This parameter specifies the type of private node pool that you want to use to create instances. A private pool is generated when an elasticity assurance or a capacity reservation takes effect. The system selects a private pool to start instances. Valid values:
25897
26156
  *
25898
- * * `Open`: specifies an open private node pool. The system selects an open private node pool to launch instances. If no matching open private node pool is available, the resources in the public node pool are used.
25899
- * * `Target`: specifies a private node pool. The system uses the resources of the specified private node pool to launch instances. If the specified private node pool is unavailable, instances cannot be launched.
25900
- * * `None`: no private node pool is used. The resources of private node pools are not used to launch the instances.
26157
+ * * `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.
26158
+ * * `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.
26159
+ * * `None`: does not use private pools. The resources of private node pools are not used to launch instances.
25901
26160
  *
25902
26161
  * @example
25903
26162
  * Open
@@ -25925,7 +26184,7 @@ export class ModifyClusterNodePoolRequestScalingGroupPrivatePoolOptions extends
25925
26184
  export class ModifyClusterNodePoolRequestScalingGroupSpotPriceLimit extends $tea.Model {
25926
26185
  /**
25927
26186
  * @remarks
25928
- * The instance type of preemptible instances.
26187
+ * The price cap of a preemptible instance.
25929
26188
  *
25930
26189
  * @example
25931
26190
  * ecs.c6.large
@@ -25933,7 +26192,7 @@ export class ModifyClusterNodePoolRequestScalingGroupSpotPriceLimit extends $tea
25933
26192
  instanceType?: string;
25934
26193
  /**
25935
26194
  * @remarks
25936
- * The maximum bid price of a preemptible instance.
26195
+ * The price cap of a preemptible instance.
25937
26196
  *
25938
26197
  * Unit: USD/hour.
25939
26198
  *
@@ -25963,7 +26222,7 @@ export class ModifyClusterNodePoolRequestScalingGroupSpotPriceLimit extends $tea
25963
26222
  export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
25964
26223
  /**
25965
26224
  * @remarks
25966
- * Specifies whether to enable auto-renewal for the nodes in the node pool. This parameter takes effect only when you set `instance_charge_type` to `PrePaid`. Valid values:
26225
+ * Specifies whether to enable auto-renewal for nodes in the node pool. This parameter takes effect only when you set `instance_charge_type` to `PrePaid`. Valid values:
25967
26226
  *
25968
26227
  * * `true`: enables auto-renewal.
25969
26228
  * * `false`: disables auto-renewal.
@@ -25976,7 +26235,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
25976
26235
  autoRenew?: boolean;
25977
26236
  /**
25978
26237
  * @remarks
25979
- * The auto-renewal duration. This parameter takes effect and is required only when you set `instance_charge_type` to `PrePaid`.
26238
+ * The auto-renewal duration of nodes in the node pool. This parameter takes effect and is required only when you set `instance_charge_type` to `PrePaid`.
25980
26239
  *
25981
26240
  * If you specify `PeriodUnit=Month`, the valid values are 1, 2, 3, 6, and 12.
25982
26241
  *
@@ -25986,7 +26245,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
25986
26245
  autoRenewPeriod?: number;
25987
26246
  /**
25988
26247
  * @remarks
25989
- * 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 when you set `multi_az_policy` to `COST_OPTIMIZED`. Valid values:
26248
+ * 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 cost or insufficient inventory. This parameter takes effect only when you set `multi_az_policy` to `COST_OPTIMIZED`. Valid values:
25990
26249
  *
25991
26250
  * * `true`: automatically creates pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created
25992
26251
  * * `false`: does not create pay-as-you-go instances to meet the required number of ECS instances if preemptible instances cannot be created.
@@ -25997,7 +26256,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
25997
26256
  compensateWithOnDemand?: boolean;
25998
26257
  /**
25999
26258
  * @remarks
26000
- * The configurations of the data disks that are mounted to the nodes in the node pool. You can mount at most 10 data disks to the nodes in the node pool.
26259
+ * The configurations of the data disks that are mounted to nodes in the node pool. Valid values: 0 to 10. You can mount at most 10 data disks to nodes in the node pool.
26001
26260
  */
26002
26261
  dataDisks?: DataDisk[];
26003
26262
  /**
@@ -26010,7 +26269,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26010
26269
  desiredSize?: number;
26011
26270
  /**
26012
26271
  * @remarks
26013
- * The ID of the custom image. You can call the `DescribeKubernetesVersionMetadata` operation to query the supported images. By default, the latest image is used.
26272
+ * The custom image ID. You can call the `DescribeKubernetesVersionMetadata` operation to query the supported images. By default, the latest image provided by the system is used.
26014
26273
  *
26015
26274
  * @example
26016
26275
  * aliyun_2_1903_x64_20G_alibase_20200904.vhd
@@ -26018,7 +26277,17 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26018
26277
  imageId?: string;
26019
26278
  /**
26020
26279
  * @remarks
26021
- * The type of OS distribution that you want to use. To specify the node OS, we recommend that you use this parameter. Valid values: CentOS, AliyunLinux, AliyunLinux Qboot, AliyunLinuxUEFI, AliyunLinux3, Windows, WindowsCore, AliyunLinux3Arm64, and ContainerOS.
26280
+ * The type of OS distribution that you want to use. To specify the node OS, we recommend that you use this parameter. Valid values:
26281
+ *
26282
+ * * `AliyunLinux`: Alibaba Cloud Linux 2.
26283
+ * * `AliyunLinuxSecurity`: Alibaba Cloud Linux 2 (UEFI).
26284
+ * * `AliyunLinux3`: Alibaba Cloud Linux 3
26285
+ * * `AliyunLinux3Arm64`: Alibaba Cloud Linux 3 (ARM).
26286
+ * * `AliyunLinux3Security`: Alibaba Cloud Linux 3 (UEFI).
26287
+ * * `CentOS`: CentOS.
26288
+ * * `Windows`: Windows.
26289
+ * * `WindowsCore`: Windows Core.
26290
+ * * `ContainerOS`: ContainerOS.
26022
26291
  *
26023
26292
  * @example
26024
26293
  * AliyunLinux
@@ -26026,7 +26295,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26026
26295
  imageType?: string;
26027
26296
  /**
26028
26297
  * @remarks
26029
- * The billing method of the nodes in the node pool. Valid values:
26298
+ * The billing method of nodes in the node pool. Valid values:
26030
26299
  *
26031
26300
  * * `PrePaid`: subscription.
26032
26301
  * * `PostPaid`: pay-as-you-go.
@@ -26040,7 +26309,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26040
26309
  instancePatterns?: InstancePatterns[];
26041
26310
  /**
26042
26311
  * @remarks
26043
- * A list of instance types. You can select multiple instance types. When the system needs to create a node, it starts from the first instance type until the node is created. The instance type that is used to create the node varies based on the actual instance stock.
26312
+ * The instance types of nodes in the node pool. When the system adds a node to the node pool, the system selects the most appropriate one from the specified instance types for the node. The instance type that is used to create the node varies based on the actual instance stock.
26044
26313
  */
26045
26314
  instanceTypes?: string[];
26046
26315
  /**
@@ -26056,7 +26325,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26056
26325
  internetChargeType?: string;
26057
26326
  /**
26058
26327
  * @remarks
26059
- * The maximum outbound bandwidth of the public IP address of the node. Unit: Mbit/s. Valid values: 1 to 100.
26328
+ * The maximum outbound bandwidth of the public IP address. Unit: Mbit/s. Valid values: 1 to 100.
26060
26329
  *
26061
26330
  * @example
26062
26331
  * 5
@@ -26064,7 +26333,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26064
26333
  internetMaxBandwidthOut?: number;
26065
26334
  /**
26066
26335
  * @remarks
26067
- * The name of the key pair. You must set this parameter or the `login_password` parameter. You must set `key_pair` if the node pool is a managed node pool.
26336
+ * 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.
26068
26337
  *
26069
26338
  * @example
26070
26339
  * pro-nodepool
@@ -26072,7 +26341,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26072
26341
  keyPair?: string;
26073
26342
  /**
26074
26343
  * @remarks
26075
- * The password for SSH logon. You must set 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.
26344
+ * 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.
26076
26345
  *
26077
26346
  * @example
26078
26347
  * Hello1234
@@ -26082,15 +26351,15 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26082
26351
  * @remarks
26083
26352
  * The ECS instance scaling policy for the multi-zone scaling group. Valid values:
26084
26353
  *
26085
- * * `PRIORITY`: The scaling group is scaled based on the VSwitchIds.N parameter. If an ECS instance cannot be created in the zone where the vSwitch that has the highest priority resides, Auto Scaling creates the ECS instance in the zone where the vSwitch that has the next highest priority resides.
26354
+ * * `PRIORITY`: ECS instances are scaled based on the VSwitchIds.N parameter. If an ECS instance cannot be created in the zone in which the vSwitch that has the highest priority resides, Auto Scaling creates the ECS instance in the zone in which the vSwitch that has the next highest priority resides.
26086
26355
  *
26087
- * * `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 configuration. 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 resources.
26356
+ * * `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.
26088
26357
  *
26089
26358
  * **
26090
26359
  *
26091
26360
  * **Note** `COST_OPTIMIZED` is valid only when multiple instance types are specified or at least one preemptible instance type is specified.
26092
26361
  *
26093
- * * `BALANCE`: ECS instances are evenly distributed across multiple zones specified by the scaling group. If ECS instances become imbalanced among multiple zones due to the insufficient inventory, you can call the `RebalanceInstances` operation of Auto Scaling to balance the instance distribution among zones. For more information, see [RebalanceInstances](https://help.aliyun.com/document_detail/71516.html).
26362
+ * * `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` operation of Auto Scaling to evenly distribute the ECS instances among zones. For more information, see [RebalanceInstances](https://help.aliyun.com/document_detail/71516.html).
26094
26363
  *
26095
26364
  * Default value: `PRIORITY`.
26096
26365
  *
@@ -26100,7 +26369,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26100
26369
  multiAzPolicy?: string;
26101
26370
  /**
26102
26371
  * @remarks
26103
- * 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, Auto Scaling preferably creates pay-as-you-go instances.
26372
+ * 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.
26104
26373
  *
26105
26374
  * @example
26106
26375
  * 0
@@ -26116,7 +26385,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26116
26385
  onDemandPercentageAboveBaseCapacity?: number;
26117
26386
  /**
26118
26387
  * @remarks
26119
- * The subscription duration of the nodes in the node pool. This parameter takes effect and is required only when you set `instance_charge_type` to `PrePaid`.
26388
+ * The subscription duration of nodes in the node pool. This parameter takes effect and is required if you set `instance_charge_type` to `PrePaid`.
26120
26389
  *
26121
26390
  * If `PeriodUnit=Month` is specified, the valid values are 1, 2, 3, 6, 12, 24, 36, 48, and 60.
26122
26391
  *
@@ -26126,7 +26395,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26126
26395
  period?: number;
26127
26396
  /**
26128
26397
  * @remarks
26129
- * The billing cycle of the nodes in the node pool. This parameter is required if you set `instance_charge_type` to `PrePaid`.
26398
+ * The billing cycle of nodes in the node pool. This parameter is required if you set `instance_charge_type` to `PrePaid`. Valid values:
26130
26399
  *
26131
26400
  * The billing cycle is measured only in months.
26132
26401
  *
@@ -26138,7 +26407,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26138
26407
  periodUnit?: string;
26139
26408
  /**
26140
26409
  * @remarks
26141
- * The operating system. Valid values:
26410
+ * The OS platform. Valid values:
26142
26411
  *
26143
26412
  * * `AliyunLinux`
26144
26413
  * * `CentOS`
@@ -26153,7 +26422,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26153
26422
  platform?: string;
26154
26423
  /**
26155
26424
  * @remarks
26156
- * The configuration of the private node pool.
26425
+ * The configurations of the private node pool.
26157
26426
  */
26158
26427
  privatePoolOptions?: ModifyClusterNodePoolRequestScalingGroupPrivatePoolOptions;
26159
26428
  /**
@@ -26165,8 +26434,8 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26165
26434
  * @remarks
26166
26435
  * The scaling mode of the scaling group. Valid values:
26167
26436
  *
26168
- * * `release`: the standard mode. ECS instances are created and released based on the resource usage.
26169
- * * `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.
26437
+ * * `release`: the standard mode. ECS instances are created and released based on resource usage.
26438
+ * * `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 to local disks.
26170
26439
  *
26171
26440
  * @example
26172
26441
  * release
@@ -26182,10 +26451,10 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26182
26451
  spotInstancePools?: number;
26183
26452
  /**
26184
26453
  * @remarks
26185
- * Specifies whether to supplement preemptible instances. If this parameter is set to true, when the scaling group receives a system message that a preemptible instance is to be reclaimed, the scaling group attempts to create a new instance to replace this instance. Valid values:
26454
+ * 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:
26186
26455
  *
26187
- * * `true`: enables the supplementation of preemptible instances.
26188
- * * `false`: disables the supplementation of preemptible instances.
26456
+ * * `true`: supplements preemptible instances.
26457
+ * * `false`: does not supplement preemptible instances.
26189
26458
  *
26190
26459
  * @example
26191
26460
  * false
@@ -26193,7 +26462,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26193
26462
  spotInstanceRemedy?: boolean;
26194
26463
  /**
26195
26464
  * @remarks
26196
- * The bid configurations of preemptible instances.
26465
+ * The instance type of preemptible instances and the price cap for the instance type.
26197
26466
  */
26198
26467
  spotPriceLimit?: ModifyClusterNodePoolRequestScalingGroupSpotPriceLimit[];
26199
26468
  /**
@@ -26201,7 +26470,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26201
26470
  * The bidding policy of preemptible instances. Valid values:
26202
26471
  *
26203
26472
  * * `NoSpot`: non-preemptible instance.
26204
- * * `SpotWithPriceLimit`: specifies the highest bid for the preemptible instance.
26473
+ * * `SpotWithPriceLimit`: specifies the highest bid.
26205
26474
  * * `SpotAsPriceGo`: automatically submits bids based on the up-to-date market price.
26206
26475
  *
26207
26476
  * For more information, see [Preemptible instances](https://help.aliyun.com/document_detail/157759.html).
@@ -26212,7 +26481,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26212
26481
  spotStrategy?: string;
26213
26482
  /**
26214
26483
  * @remarks
26215
- * Specifies whether to enable Burst for the system disk when the disk type is cloud_auto.
26484
+ * Specifies whether to enable the burst feature for the system disk when the disk type is cloud_auto.
26216
26485
  *
26217
26486
  * @example
26218
26487
  * true
@@ -26220,12 +26489,12 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26220
26489
  systemDiskBurstingEnabled?: boolean;
26221
26490
  /**
26222
26491
  * @remarks
26223
- * The types of system disks. 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: ultra disk. cloud_ssd: standard SSD. cloud_essd: enhanced SSD (ESSD).
26492
+ * 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: cloud (basic disk), cloud_efficiency (ultra disk), cloud_ssd (standard SSD), and cloud_essd: (ESSD).
26224
26493
  */
26225
26494
  systemDiskCategories?: string[];
26226
26495
  /**
26227
26496
  * @remarks
26228
- * The type of the system disk. Valid values:
26497
+ * The system disk type. Valid values:
26229
26498
  *
26230
26499
  * * `cloud_efficiency`: ultra disk.
26231
26500
  * * `cloud_ssd`: standard SSD.
@@ -26238,7 +26507,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26238
26507
  systemDiskCategory?: string;
26239
26508
  /**
26240
26509
  * @remarks
26241
- * The algorithm that you want to use to encrypt the system disk. The value is aes-256.
26510
+ * The encryption algorithm that is used to encrypt the system disk. Set the value to aes-256.
26242
26511
  *
26243
26512
  * @example
26244
26513
  * aes-256
@@ -26262,7 +26531,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26262
26531
  systemDiskKmsKeyId?: string;
26263
26532
  /**
26264
26533
  * @remarks
26265
- * The performance level (PL) of the system disk that you want to use for the node. This parameter takes effect only for enhanced SSDs. You can specify a higher PL if you increase the size of the system disk. For more information, see [ESSDs](https://help.aliyun.com/document_detail/122389.html).
26534
+ * The performance level (PL) of the system disk. This parameter takes effect only for an Enterprise SSD (ESSD). You can specify a higher PL if you increase the size of the data disk. For more information, see [ESSDs](https://help.aliyun.com/document_detail/122389.html).
26266
26535
  *
26267
26536
  * @example
26268
26537
  * PL1
@@ -26270,7 +26539,7 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26270
26539
  systemDiskPerformanceLevel?: string;
26271
26540
  /**
26272
26541
  * @remarks
26273
- * The predefined read and write IOPS of the system disk when the disk type is cloud_auto.
26542
+ * The preset read/write IOPS of the system disk when the disk type is cloud_auto.
26274
26543
  *
26275
26544
  * @example
26276
26545
  * 1000
@@ -26278,11 +26547,11 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26278
26547
  systemDiskProvisionedIops?: number;
26279
26548
  /**
26280
26549
  * @remarks
26281
- * The size of the system disk in GiB.
26550
+ * The size of the system disk. Unit: GiB.
26282
26551
  *
26283
26552
  * Valid values: 20 to 500.
26284
26553
  *
26285
- * The value of this parameter must be at least 20 and greater than or equal to the size of the image.
26554
+ * The value of this parameter must be at least 20 and greater than or equal to the image size.
26286
26555
  *
26287
26556
  * Default value: the greater value between 40 and the image size.
26288
26557
  *
@@ -26294,14 +26563,14 @@ export class ModifyClusterNodePoolRequestScalingGroup extends $tea.Model {
26294
26563
  * @remarks
26295
26564
  * The labels that you want to add only to ECS instances.
26296
26565
  *
26297
- * 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://.
26566
+ * 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://.
26298
26567
  */
26299
26568
  tags?: Tag[];
26300
26569
  /**
26301
26570
  * @remarks
26302
- * The IDs of vSwitches. You can specify 1 to 20 vSwitches.
26571
+ * The vSwitch IDs. You can specify 1 to 20 vSwitches.
26303
26572
  *
26304
- * > To ensure high availability, we recommend that you select vSwitches in different zones.
26573
+ * > To ensure high availability, we recommend that you select vSwitches that reside in different zones.
26305
26574
  */
26306
26575
  vswitchIds?: string[];
26307
26576
  static names(): { [key: string]: string } {
@@ -26565,9 +26834,9 @@ export class ScaleClusterRequestWorkerDataDisks extends $tea.Model {
26565
26834
  export class ScaleOutClusterRequestWorkerDataDisks extends $tea.Model {
26566
26835
  /**
26567
26836
  * @remarks
26568
- * The ID of an automatic snapshot policy. Automatic backup is performed for a disk based on the specified automatic snapshot policy.
26837
+ * The ID of the automatic snapshot policy. The system performs automatic backup for a cloud disk based on the specified automatic snapshot policy.
26569
26838
  *
26570
- * By default, this parameter is empty, which indicates that automatic backup is disabled.
26839
+ * By default, this parameter is left empty, which indicates that automatic backup is disabled.
26571
26840
  *
26572
26841
  * @example
26573
26842
  * sp-bp14yziiuvu3s6jn****
@@ -26583,10 +26852,10 @@ export class ScaleOutClusterRequestWorkerDataDisks extends $tea.Model {
26583
26852
  category?: string;
26584
26853
  /**
26585
26854
  * @remarks
26586
- * Specifies whether to encrypt the data disks. Valid values:
26855
+ * Specifies whether to encrypt the data disk. Valid values:
26587
26856
  *
26588
- * * `true`: encrypts data disks.
26589
- * * `false`: does not encrypt data disks.
26857
+ * * `true`: encrypts the data disk.
26858
+ * * `false`: does not encrypt the data disk.
26590
26859
  *
26591
26860
  * Default value: `false`.
26592
26861
  *
@@ -26596,7 +26865,7 @@ export class ScaleOutClusterRequestWorkerDataDisks extends $tea.Model {
26596
26865
  encrypted?: string;
26597
26866
  /**
26598
26867
  * @remarks
26599
- * The size of the data disk. Valid values: 40 to 32767.
26868
+ * The data disk size. Valid values: 40 to 32767.
26600
26869
  *
26601
26870
  * @example
26602
26871
  * 120
@@ -26842,8 +27111,33 @@ export class UpgradeClusterAddonsRequestBody extends $tea.Model {
26842
27111
  }
26843
27112
 
26844
27113
  export class UpgradeClusterNodepoolRequestRollingPolicy extends $tea.Model {
27114
+ /**
27115
+ * @remarks
27116
+ * The update interval between batches takes effect only when the pause policy is set to NotPause. Unit: minutes. Valid values: 5 to 120.
27117
+ *
27118
+ * @example
27119
+ * 5 minutes
27120
+ */
26845
27121
  batchInterval?: number;
27122
+ /**
27123
+ * @remarks
27124
+ * The maximum number of unavailable nodes.
27125
+ *
27126
+ * @example
27127
+ * 3
27128
+ */
26846
27129
  maxParallelism?: number;
27130
+ /**
27131
+ * @remarks
27132
+ * The policy that is used to pause the update. Valid values:
27133
+ *
27134
+ * * FirstBatch: pauses the update after the first batch is completed.
27135
+ * * EveryBatch: pauses after each batch is completed.
27136
+ * * NotPause: does not pause.
27137
+ *
27138
+ * @example
27139
+ * NotPause
27140
+ */
26847
27141
  pausePolicy?: string;
26848
27142
  static names(): { [key: string]: string } {
26849
27143
  return {
@@ -26923,7 +27217,7 @@ export default class Client extends OpenApi {
26923
27217
  }
26924
27218
 
26925
27219
  /**
26926
- * You can call the AttachInstances operation to add existing Elastic Compute Service (ECS) instances to a cluster.
27220
+ * Adds existing Elastic Compute Service (ECS) instances to a Container Service for Kubernetes (ACK) cluster.
26927
27221
  *
26928
27222
  * @param request - AttachInstancesRequest
26929
27223
  * @param headers - map
@@ -27004,7 +27298,7 @@ export default class Client extends OpenApi {
27004
27298
  }
27005
27299
 
27006
27300
  /**
27007
- * You can call the AttachInstances operation to add existing Elastic Compute Service (ECS) instances to a cluster.
27301
+ * Adds existing Elastic Compute Service (ECS) instances to a Container Service for Kubernetes (ACK) cluster.
27008
27302
  *
27009
27303
  * @param request - AttachInstancesRequest
27010
27304
  * @returns AttachInstancesResponse
@@ -27311,7 +27605,7 @@ export default class Client extends OpenApi {
27311
27605
  }
27312
27606
 
27313
27607
  /**
27314
- * 检查是否授权指定服务角色
27608
+ * Checks whether the specified service role is granted required permissions within the current Alibaba Cloud account.
27315
27609
  *
27316
27610
  * @param request - CheckServiceRoleRequest
27317
27611
  * @param headers - map
@@ -27344,7 +27638,7 @@ export default class Client extends OpenApi {
27344
27638
  }
27345
27639
 
27346
27640
  /**
27347
- * 检查是否授权指定服务角色
27641
+ * Checks whether the specified service role is granted required permissions within the current Alibaba Cloud account.
27348
27642
  *
27349
27643
  * @param request - CheckServiceRoleRequest
27350
27644
  * @returns CheckServiceRoleResponse
@@ -27360,7 +27654,7 @@ export default class Client extends OpenApi {
27360
27654
  *
27361
27655
  * @remarks
27362
27656
  * >
27363
- * * To call this operation, make sure that you have the AliyunCSFullAccess permissions.
27657
+ * * To call this operation, make sure that you have the AliyunCSFullAccess permission.
27364
27658
  * * You cannot revoke the permissions of an Alibaba Cloud account.
27365
27659
  * * You cannot revoke the permissions of the account that you use to call this operation.
27366
27660
  *
@@ -27399,7 +27693,7 @@ export default class Client extends OpenApi {
27399
27693
  *
27400
27694
  * @remarks
27401
27695
  * >
27402
- * * To call this operation, make sure that you have the AliyunCSFullAccess permissions.
27696
+ * * To call this operation, make sure that you have the AliyunCSFullAccess permission.
27403
27697
  * * You cannot revoke the permissions of an Alibaba Cloud account.
27404
27698
  * * You cannot revoke the permissions of the account that you use to call this operation.
27405
27699
  *
@@ -27578,13 +27872,13 @@ export default class Client extends OpenApi {
27578
27872
  * You can call the CreateCluster operation to create a Container Service for Kubernetes (ACK) cluster. ACK clusters include ACK managed clusters, ACK dedicated clusters, ACK Serverless clusters, ACK Edge clusters, ACK clusters that support sandboxed containers, and registered clusters. For more information about how to create different types of ACK clusters, see the following usage notes.
27579
27873
  *
27580
27874
  * @remarks
27581
- * This topic describes all parameters for creating an ACK cluster. You can create the following types of ACK clusters.
27582
- * * [Create an ACK managed cluster](https://help.aliyun.com/document_detail/90776.html)
27583
- * * [Create an ACK dedicated cluster](https://help.aliyun.com/document_detail/197620.html)
27584
- * * [Create an ACK Serverless cluster](https://help.aliyun.com/document_detail/144246.html)
27585
- * * [Create an ACK Edge cluster](https://help.aliyun.com/document_detail/128204.html)
27586
- * * [Create an ACK Basic cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/196321.html)
27587
- * * [Create an ACK Pro cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/140623.html)
27875
+ * This topic describes all request parameters for creating a Container Service for Kubernetes (ACK) cluster. For more information about how to call the API to create each type of ACK cluster, refer to the following topics:
27876
+ * * [Call the API to create an ACK managed cluster](https://help.aliyun.com/document_detail/90776.html)
27877
+ * * [Call the API to create an ACK dedicated cluster](https://help.aliyun.com/document_detail/197620.html)
27878
+ * * [Call the API to create an ACK Serverless cluster](https://help.aliyun.com/document_detail/144246.html)
27879
+ * * [Call the API to create an ACK Edge cluster](https://help.aliyun.com/document_detail/128204.html)
27880
+ * * [Call the API to create an ACK Basic cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/196321.html)
27881
+ * * [Call the API to create an ACK Pro cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/140623.html)
27588
27882
  *
27589
27883
  * @param request - CreateClusterRequest
27590
27884
  * @param headers - map
@@ -27606,6 +27900,14 @@ export default class Client extends OpenApi {
27606
27900
  body["api_audiences"] = request.apiAudiences;
27607
27901
  }
27608
27902
 
27903
+ if (!Util.isUnset(request.autoRenew)) {
27904
+ body["auto_renew"] = request.autoRenew;
27905
+ }
27906
+
27907
+ if (!Util.isUnset(request.autoRenewPeriod)) {
27908
+ body["auto_renew_period"] = request.autoRenewPeriod;
27909
+ }
27910
+
27609
27911
  if (!Util.isUnset(request.chargeType)) {
27610
27912
  body["charge_type"] = request.chargeType;
27611
27913
  }
@@ -27962,6 +28264,10 @@ export default class Client extends OpenApi {
27962
28264
  body["zone_id"] = request.zoneId;
27963
28265
  }
27964
28266
 
28267
+ if (!Util.isUnset(request.zoneIds)) {
28268
+ body["zone_ids"] = request.zoneIds;
28269
+ }
28270
+
27965
28271
  let req = new $OpenApi.OpenApiRequest({
27966
28272
  headers: headers,
27967
28273
  body: OpenApiUtil.parseToMap(body),
@@ -27984,13 +28290,13 @@ export default class Client extends OpenApi {
27984
28290
  * You can call the CreateCluster operation to create a Container Service for Kubernetes (ACK) cluster. ACK clusters include ACK managed clusters, ACK dedicated clusters, ACK Serverless clusters, ACK Edge clusters, ACK clusters that support sandboxed containers, and registered clusters. For more information about how to create different types of ACK clusters, see the following usage notes.
27985
28291
  *
27986
28292
  * @remarks
27987
- * This topic describes all parameters for creating an ACK cluster. You can create the following types of ACK clusters.
27988
- * * [Create an ACK managed cluster](https://help.aliyun.com/document_detail/90776.html)
27989
- * * [Create an ACK dedicated cluster](https://help.aliyun.com/document_detail/197620.html)
27990
- * * [Create an ACK Serverless cluster](https://help.aliyun.com/document_detail/144246.html)
27991
- * * [Create an ACK Edge cluster](https://help.aliyun.com/document_detail/128204.html)
27992
- * * [Create an ACK Basic cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/196321.html)
27993
- * * [Create an ACK Pro cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/140623.html)
28293
+ * This topic describes all request parameters for creating a Container Service for Kubernetes (ACK) cluster. For more information about how to call the API to create each type of ACK cluster, refer to the following topics:
28294
+ * * [Call the API to create an ACK managed cluster](https://help.aliyun.com/document_detail/90776.html)
28295
+ * * [Call the API to create an ACK dedicated cluster](https://help.aliyun.com/document_detail/197620.html)
28296
+ * * [Call the API to create an ACK Serverless cluster](https://help.aliyun.com/document_detail/144246.html)
28297
+ * * [Call the API to create an ACK Edge cluster](https://help.aliyun.com/document_detail/128204.html)
28298
+ * * [Call the API to create an ACK Basic cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/196321.html)
28299
+ * * [Call the API to create an ACK Pro cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/140623.html)
27994
28300
  *
27995
28301
  * @param request - CreateClusterRequest
27996
28302
  * @returns CreateClusterResponse
@@ -28307,7 +28613,7 @@ export default class Client extends OpenApi {
28307
28613
  }
28308
28614
 
28309
28615
  /**
28310
- * You can call the CreateTrigger operation to create a trigger for an application.
28616
+ * Creates a trigger for an application to redeploy the application pods when specific conditions are met.
28311
28617
  *
28312
28618
  * @param request - CreateTriggerRequest
28313
28619
  * @param headers - map
@@ -28352,7 +28658,7 @@ export default class Client extends OpenApi {
28352
28658
  }
28353
28659
 
28354
28660
  /**
28355
- * You can call the CreateTrigger operation to create a trigger for an application.
28661
+ * Creates a trigger for an application to redeploy the application pods when specific conditions are met.
28356
28662
  *
28357
28663
  * @param request - CreateTriggerRequest
28358
28664
  * @returns CreateTriggerResponse
@@ -28581,8 +28887,10 @@ export default class Client extends OpenApi {
28581
28887
  * Removes nodes from a Container Service for Kubernetes (ACK) cluster. When you remove nodes, you can specify whether to release the Elastic Compute Service (ECS) instances and drain the nodes. When you remove nodes, pods on the nodes are migrated. This may adversely affect your businesses. We recommend that you back up data and perform this operation during off-peak hours.
28582
28888
  *
28583
28889
  * @remarks
28584
- * >
28585
- * * When you remove a node, the pods that run on the node are migrated to other nodes. This may cause service interruptions. We recommend that you remove nodes during off-peak hours. - The operation may have unexpected risks. Back up the data before you perform this operation. - When the system removes a node, it sets the status of the node to Unschedulable. - The system removes only worker nodes. It does not remove master nodes.
28890
+ * When you remove a node, the pods that run on the node are migrated to other nodes. This may cause service interruptions. We recommend that you remove nodes during off-peak hours.
28891
+ * * The operation may have unexpected risks. Back up the data before you perform this operation.
28892
+ * * When the system removes a node, it sets the status of the node to Unschedulable.
28893
+ * * The system removes only worker nodes. It does not remove master nodes.
28586
28894
  *
28587
28895
  * @param request - DeleteClusterNodesRequest
28588
28896
  * @param headers - map
@@ -28626,8 +28934,10 @@ export default class Client extends OpenApi {
28626
28934
  * Removes nodes from a Container Service for Kubernetes (ACK) cluster. When you remove nodes, you can specify whether to release the Elastic Compute Service (ECS) instances and drain the nodes. When you remove nodes, pods on the nodes are migrated. This may adversely affect your businesses. We recommend that you back up data and perform this operation during off-peak hours.
28627
28935
  *
28628
28936
  * @remarks
28629
- * >
28630
- * * When you remove a node, the pods that run on the node are migrated to other nodes. This may cause service interruptions. We recommend that you remove nodes during off-peak hours. - The operation may have unexpected risks. Back up the data before you perform this operation. - When the system removes a node, it sets the status of the node to Unschedulable. - The system removes only worker nodes. It does not remove master nodes.
28937
+ * When you remove a node, the pods that run on the node are migrated to other nodes. This may cause service interruptions. We recommend that you remove nodes during off-peak hours.
28938
+ * * The operation may have unexpected risks. Back up the data before you perform this operation.
28939
+ * * When the system removes a node, it sets the status of the node to Unschedulable.
28940
+ * * The system removes only worker nodes. It does not remove master nodes.
28631
28941
  *
28632
28942
  * @param request - DeleteClusterNodesRequest
28633
28943
  * @returns DeleteClusterNodesResponse
@@ -28799,7 +29109,7 @@ export default class Client extends OpenApi {
28799
29109
  }
28800
29110
 
28801
29111
  /**
28802
- * You can call the DeleteTrigger operation to delete an application trigger.
29112
+ * Deletes an application trigger.
28803
29113
  *
28804
29114
  * @param headers - map
28805
29115
  * @param runtime - runtime options for this request RuntimeOptions
@@ -28824,7 +29134,7 @@ export default class Client extends OpenApi {
28824
29134
  }
28825
29135
 
28826
29136
  /**
28827
- * You can call the DeleteTrigger operation to delete an application trigger.
29137
+ * Deletes an application trigger.
28828
29138
  * @returns DeleteTriggerResponse
28829
29139
  */
28830
29140
  async deleteTrigger(clusterId: string, Id: string): Promise<DeleteTriggerResponse> {
@@ -28928,7 +29238,7 @@ export default class Client extends OpenApi {
28928
29238
  }
28929
29239
 
28930
29240
  /**
28931
- * 查询指定集群组件
29241
+ * Queries the information about a component based on specific conditions such as the region, cluster type, cluster subtype defined by cluster profile, cluster version, and component name. The information includes whether the component is managed, the component type, supported custom parameter schema, compatible operating system architecture, and earliest supported cluster version.
28932
29242
  *
28933
29243
  * @param request - DescribeAddonRequest
28934
29244
  * @param headers - map
@@ -28985,7 +29295,7 @@ export default class Client extends OpenApi {
28985
29295
  }
28986
29296
 
28987
29297
  /**
28988
- * 查询指定集群组件
29298
+ * Queries the information about a component based on specific conditions such as the region, cluster type, cluster subtype defined by cluster profile, cluster version, and component name. The information includes whether the component is managed, the component type, supported custom parameter schema, compatible operating system architecture, and earliest supported cluster version.
28989
29299
  *
28990
29300
  * @param request - DescribeAddonRequest
28991
29301
  * @returns DescribeAddonResponse
@@ -29295,7 +29605,7 @@ export default class Client extends OpenApi {
29295
29605
  }
29296
29606
 
29297
29607
  /**
29298
- * Queries the script that is used to add existing nodes to a Container Service for Kubernetes (ACK) cluster. You can manually add existing Elastic Compute Service (ECS) instances to an ACK cluster as worker nodes or re-add the worker nodes that you have removed to a node pool.
29608
+ * Queries the scripts used to add existing nodes to a Container Service for Kubernetes (ACK) cluster. ACK allows you to manually add existing Elastic Compute Service (ECS) instances to an ACK cluster as worker nodes or re-add worker nodes that you remove from the cluster to a node pool.
29299
29609
  *
29300
29610
  * @param request - DescribeClusterAttachScriptsRequest
29301
29611
  * @param headers - map
@@ -29348,7 +29658,7 @@ export default class Client extends OpenApi {
29348
29658
  }
29349
29659
 
29350
29660
  /**
29351
- * Queries the script that is used to add existing nodes to a Container Service for Kubernetes (ACK) cluster. You can manually add existing Elastic Compute Service (ECS) instances to an ACK cluster as worker nodes or re-add the worker nodes that you have removed to a node pool.
29661
+ * Queries the scripts used to add existing nodes to a Container Service for Kubernetes (ACK) cluster. ACK allows you to manually add existing Elastic Compute Service (ECS) instances to an ACK cluster as worker nodes or re-add worker nodes that you remove from the cluster to a node pool.
29352
29662
  *
29353
29663
  * @param request - DescribeClusterAttachScriptsRequest
29354
29664
  * @returns DescribeClusterAttachScriptsResponse
@@ -29721,8 +30031,7 @@ export default class Client extends OpenApi {
29721
30031
  * Kubeconfig files store identity and authentication information that is used by clients to access Container Service for Kubernetes (ACK) clusters. To use a kubectl client to manage an ACK cluster, you need to use the corresponding kubeconfig file to connect to the ACK cluster. We recommend that you keep kubeconfig files confidential and revoke kubeconfig files that are not in use. This helps prevent data leaks caused by the disclosure of kubeconfig files.
29722
30032
  *
29723
30033
  * @remarks
29724
- * *
29725
- * ****The default validity period of a kubeconfig file is 3 years. Two months before a kubeconfig file expires, you can renew it in the Container Service for Kubernetes (ACK) console or by calling API operations. After a kubeconfig file is renewed, the secret is valid for 3 years. The previous kubeconfig secret remains valid until expiration. We recommend that you renew your kubeconfig file at the earliest opportunity.
30034
+ * > The default validity period of a kubeconfig file is 3 years. 180 days before a kubeconfig file expires, you can renew it in the Container Service for Kubernetes (ACK) console or by calling API operations. After a kubeconfig file is renewed, the kubeconfig file is valid for 3 years. The previous kubeconfig file still remains valid until expiration. We recommend that you renew your kubeconfig file at the earliest opportunity.
29726
30035
  *
29727
30036
  * @param request - DescribeClusterUserKubeconfigRequest
29728
30037
  * @param headers - map
@@ -29762,8 +30071,7 @@ export default class Client extends OpenApi {
29762
30071
  * Kubeconfig files store identity and authentication information that is used by clients to access Container Service for Kubernetes (ACK) clusters. To use a kubectl client to manage an ACK cluster, you need to use the corresponding kubeconfig file to connect to the ACK cluster. We recommend that you keep kubeconfig files confidential and revoke kubeconfig files that are not in use. This helps prevent data leaks caused by the disclosure of kubeconfig files.
29763
30072
  *
29764
30073
  * @remarks
29765
- * *
29766
- * ****The default validity period of a kubeconfig file is 3 years. Two months before a kubeconfig file expires, you can renew it in the Container Service for Kubernetes (ACK) console or by calling API operations. After a kubeconfig file is renewed, the secret is valid for 3 years. The previous kubeconfig secret remains valid until expiration. We recommend that you renew your kubeconfig file at the earliest opportunity.
30074
+ * > The default validity period of a kubeconfig file is 3 years. 180 days before a kubeconfig file expires, you can renew it in the Container Service for Kubernetes (ACK) console or by calling API operations. After a kubeconfig file is renewed, the kubeconfig file is valid for 3 years. The previous kubeconfig file still remains valid until expiration. We recommend that you renew your kubeconfig file at the earliest opportunity.
29767
30075
  *
29768
30076
  * @param request - DescribeClusterUserKubeconfigRequest
29769
30077
  * @returns DescribeClusterUserKubeconfigResponse
@@ -29861,7 +30169,7 @@ export default class Client extends OpenApi {
29861
30169
  }
29862
30170
 
29863
30171
  /**
29864
- * You can call the DescribeClusters operation to query all the clusters that belong to the current Alibaba Cloud account, including Kubernetes clusters and Swarm clusters.
30172
+ * Queries all the clusters that belong to the current Alibaba Cloud account, including Kubernetes clusters and Swarm clusters.
29865
30173
  *
29866
30174
  * @deprecated OpenAPI DescribeClusters is deprecated
29867
30175
  *
@@ -29905,7 +30213,7 @@ export default class Client extends OpenApi {
29905
30213
  }
29906
30214
 
29907
30215
  /**
29908
- * You can call the DescribeClusters operation to query all the clusters that belong to the current Alibaba Cloud account, including Kubernetes clusters and Swarm clusters.
30216
+ * Queries all the clusters that belong to the current Alibaba Cloud account, including Kubernetes clusters and Swarm clusters.
29909
30217
  *
29910
30218
  * @deprecated OpenAPI DescribeClusters is deprecated
29911
30219
  *
@@ -29920,7 +30228,7 @@ export default class Client extends OpenApi {
29920
30228
  }
29921
30229
 
29922
30230
  /**
29923
- * You can call the DescribeClustersV1 operation to query the details about all Container Service for Kubernetes (ACK) clusters.
30231
+ * Queries the details about Container Service for Kubernetes (ACK) clusters of specified types or specifications within an account.
29924
30232
  *
29925
30233
  * @param request - DescribeClustersV1Request
29926
30234
  * @param headers - map
@@ -29981,7 +30289,7 @@ export default class Client extends OpenApi {
29981
30289
  }
29982
30290
 
29983
30291
  /**
29984
- * You can call the DescribeClustersV1 operation to query the details about all Container Service for Kubernetes (ACK) clusters.
30292
+ * Queries the details about Container Service for Kubernetes (ACK) clusters of specified types or specifications within an account.
29985
30293
  *
29986
30294
  * @param request - DescribeClustersV1Request
29987
30295
  * @returns DescribeClustersV1Response
@@ -30220,7 +30528,7 @@ export default class Client extends OpenApi {
30220
30528
  }
30221
30529
 
30222
30530
  /**
30223
- * You can call the DescribeExternalAgent operation to query the agent configurations of a registered cluster by cluster ID.
30531
+ * Queries the proxy configurations of a registered cluster based on the cluster ID.
30224
30532
  *
30225
30533
  * @remarks
30226
30534
  * For more information, see [Register an external Kubernetes cluster](https://help.aliyun.com/document_detail/121053.html).
@@ -30260,7 +30568,7 @@ export default class Client extends OpenApi {
30260
30568
  }
30261
30569
 
30262
30570
  /**
30263
- * You can call the DescribeExternalAgent operation to query the agent configurations of a registered cluster by cluster ID.
30571
+ * Queries the proxy configurations of a registered cluster based on the cluster ID.
30264
30572
  *
30265
30573
  * @remarks
30266
30574
  * For more information, see [Register an external Kubernetes cluster](https://help.aliyun.com/document_detail/121053.html).
@@ -30424,7 +30732,7 @@ export default class Client extends OpenApi {
30424
30732
  }
30425
30733
 
30426
30734
  /**
30427
- * Container security policies for Container Service for Kubernetes (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. You can call the DescribePolicyDetails operation to query information about a policy, such as the content, action, and severity level of the policy.
30735
+ * Queries the detailed information about a policy. The information includes the content, action, and severity level of the policy. Container Service for Kubernetes (ACK) provides the following types of predefined security policies: Compliance, Infra, K8s-general, and pod security policy (PSP). These policies ensure that containers are running in the production environment in a secure manner.
30428
30736
  *
30429
30737
  * @param headers - map
30430
30738
  * @param runtime - runtime options for this request RuntimeOptions
@@ -30449,7 +30757,7 @@ export default class Client extends OpenApi {
30449
30757
  }
30450
30758
 
30451
30759
  /**
30452
- * Container security policies for Container Service for Kubernetes (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. You can call the DescribePolicyDetails operation to query information about a policy, such as the content, action, and severity level of the policy.
30760
+ * Queries the detailed information about a policy. The information includes the content, action, and severity level of the policy. Container Service for Kubernetes (ACK) provides the following types of predefined security policies: Compliance, Infra, K8s-general, and pod security policy (PSP). These policies ensure that containers are running in the production environment in a secure manner.
30453
30761
  * @returns DescribePolicyDetailsResponse
30454
30762
  */
30455
30763
  async describePolicyDetails(policyName: string): Promise<DescribePolicyDetailsResponse> {
@@ -30459,7 +30767,7 @@ export default class Client extends OpenApi {
30459
30767
  }
30460
30768
 
30461
30769
  /**
30462
- * Queries the details of policies for a Container Service for Kubernetes (ACK) cluster. For example, you can query the number of multi-level policies that are enabled for the cluster, audit logs of the policies, and denying and alerting information. Container security policies for ACK clusters offer a variety of built-in policies, such as cis-k8s, infra, k8s-general, and PodSecurityPolicy. You can use these policies to ensure the security of containers running in a production environment.
30770
+ * 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. You can call the DescribePolicyGovernanceInCluster operation to query the details of policies for an ACK cluster. For example, you can query the number of policies that are enabled per severity level, the audit logs of policies, and the blocking and alerting information.
30463
30771
  *
30464
30772
  * @param headers - map
30465
30773
  * @param runtime - runtime options for this request RuntimeOptions
@@ -30484,7 +30792,7 @@ export default class Client extends OpenApi {
30484
30792
  }
30485
30793
 
30486
30794
  /**
30487
- * Queries the details of policies for a Container Service for Kubernetes (ACK) cluster. For example, you can query the number of multi-level policies that are enabled for the cluster, audit logs of the policies, and denying and alerting information. Container security policies for ACK clusters offer a variety of built-in policies, such as cis-k8s, infra, k8s-general, and PodSecurityPolicy. You can use these policies to ensure the security of containers running in a production environment.
30795
+ * 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. You can call the DescribePolicyGovernanceInCluster operation to query the details of policies for an ACK cluster. For example, you can query the number of policies that are enabled per severity level, the audit logs of policies, and the blocking and alerting information.
30488
30796
  * @returns DescribePolicyGovernanceInClusterResponse
30489
30797
  */
30490
30798
  async describePolicyGovernanceInCluster(clusterId: string): Promise<DescribePolicyGovernanceInClusterResponse> {
@@ -30817,7 +31125,7 @@ export default class Client extends OpenApi {
30817
31125
  }
30818
31126
 
30819
31127
  /**
30820
- * You can call the DescribeTrigger operation to query triggers.
31128
+ * Queries triggers that match specific conditions.
30821
31129
  *
30822
31130
  * @param request - DescribeTriggerRequest
30823
31131
  * @param headers - map
@@ -30862,7 +31170,7 @@ export default class Client extends OpenApi {
30862
31170
  }
30863
31171
 
30864
31172
  /**
30865
- * You can call the DescribeTrigger operation to query triggers.
31173
+ * Queries triggers that match specific conditions.
30866
31174
  *
30867
31175
  * @param request - DescribeTriggerRequest
30868
31176
  * @returns DescribeTriggerResponse
@@ -30874,7 +31182,7 @@ export default class Client extends OpenApi {
30874
31182
  }
30875
31183
 
30876
31184
  /**
30877
- * Queries the Role-Based Access Control (RBAC) permissions that are granted to the current Resource Access Management (RAM) user or RAM role on a Container Service for Kubernetes (ACK) cluster. You can use Kubernetes namespaces to limit users from accessing resources in an ACK cluster. Users that are granted RBAC permissions only on one namespace cannot access resources in other namespaces.
31185
+ * You can use Kubernetes namespaces to limit users from accessing resources in a Container Service for Kubernetes (ACK) cluster. Users that are granted Role-Based Access Control (RBAC) permissions only on one namespace cannot access resources in other namespaces. Queries the RBAC permissions that are granted to the current Resource Access Management (RAM) user or RAM role on an ACK cluster.
30878
31186
  *
30879
31187
  * @param headers - map
30880
31188
  * @param runtime - runtime options for this request RuntimeOptions
@@ -30899,7 +31207,7 @@ export default class Client extends OpenApi {
30899
31207
  }
30900
31208
 
30901
31209
  /**
30902
- * Queries the Role-Based Access Control (RBAC) permissions that are granted to the current Resource Access Management (RAM) user or RAM role on a Container Service for Kubernetes (ACK) cluster. You can use Kubernetes namespaces to limit users from accessing resources in an ACK cluster. Users that are granted RBAC permissions only on one namespace cannot access resources in other namespaces.
31210
+ * You can use Kubernetes namespaces to limit users from accessing resources in a Container Service for Kubernetes (ACK) cluster. Users that are granted Role-Based Access Control (RBAC) permissions only on one namespace cannot access resources in other namespaces. Queries the RBAC permissions that are granted to the current Resource Access Management (RAM) user or RAM role on an ACK cluster.
30903
31211
  * @returns DescribeUserClusterNamespacesResponse
30904
31212
  */
30905
31213
  async describeUserClusterNamespaces(ClusterId: string): Promise<DescribeUserClusterNamespacesResponse> {
@@ -30911,6 +31219,10 @@ export default class Client extends OpenApi {
30911
31219
  /**
30912
31220
  * In an Container Service for Kubernetes (ACK) cluster, you can create and specify different Resource Access Management (RAM) users or roles to have different access permissions. This ensures access control and resource isolation. You can call the DescribeUserPermission operation to query the permissions that are granted to a RAM user or RAM role on ACK clusters, including the resources that are allowed to access, the scope of the permissions, the predefined role, and the permission source.
30913
31221
  *
31222
+ * @remarks
31223
+ * *Precautions**:
31224
+ * * If you call this operation as a Resource Access Management (RAM) user or by assuming a RAM role, only the permissions granted on the clusters on which the current account has the role-based access control (RBAC) administrator permissions are returned. If you want to query the permissions on all clusters, you must use an account that has the RBAC administrator permissions on all clusters.
31225
+ *
30914
31226
  * @param headers - map
30915
31227
  * @param runtime - runtime options for this request RuntimeOptions
30916
31228
  * @returns DescribeUserPermissionResponse
@@ -30935,6 +31247,10 @@ export default class Client extends OpenApi {
30935
31247
 
30936
31248
  /**
30937
31249
  * In an Container Service for Kubernetes (ACK) cluster, you can create and specify different Resource Access Management (RAM) users or roles to have different access permissions. This ensures access control and resource isolation. You can call the DescribeUserPermission operation to query the permissions that are granted to a RAM user or RAM role on ACK clusters, including the resources that are allowed to access, the scope of the permissions, the predefined role, and the permission source.
31250
+ *
31251
+ * @remarks
31252
+ * *Precautions**:
31253
+ * * If you call this operation as a Resource Access Management (RAM) user or by assuming a RAM role, only the permissions granted on the clusters on which the current account has the role-based access control (RBAC) administrator permissions are returned. If you want to query the permissions on all clusters, you must use an account that has the RBAC administrator permissions on all clusters.
30938
31254
  * @returns DescribeUserPermissionResponse
30939
31255
  */
30940
31256
  async describeUserPermission(uid: string): Promise<DescribeUserPermissionResponse> {
@@ -31504,7 +31820,7 @@ export default class Client extends OpenApi {
31504
31820
  }
31505
31821
 
31506
31822
  /**
31507
- * You can call the ListAddons operation to query all available components in a cluster. You can query all available components in a cluster by specifying the ID of the cluster. You can also specify parameters such as the region, cluster type, cluster subtype (profile), cluster specification, and cluster version to get a list of available components in clusters that meet the conditions.
31823
+ * Queries the available components based on specific conditions such as the region, cluster type, cluster subtype defined by cluster profile, and cluster version and queries the detailed information about a component. The information includes whether the component is managed, the supported custom parameter schema, and compatible operating system architecture.
31508
31824
  *
31509
31825
  * @param request - ListAddonsRequest
31510
31826
  * @param headers - map
@@ -31557,7 +31873,7 @@ export default class Client extends OpenApi {
31557
31873
  }
31558
31874
 
31559
31875
  /**
31560
- * You can call the ListAddons operation to query all available components in a cluster. You can query all available components in a cluster by specifying the ID of the cluster. You can also specify parameters such as the region, cluster type, cluster subtype (profile), cluster specification, and cluster version to get a list of available components in clusters that meet the conditions.
31876
+ * Queries the available components based on specific conditions such as the region, cluster type, cluster subtype defined by cluster profile, and cluster version and queries the detailed information about a component. The information includes whether the component is managed, the supported custom parameter schema, and compatible operating system architecture.
31561
31877
  *
31562
31878
  * @param request - ListAddonsRequest
31563
31879
  * @returns ListAddonsResponse
@@ -31569,7 +31885,7 @@ export default class Client extends OpenApi {
31569
31885
  }
31570
31886
 
31571
31887
  /**
31572
- * You can call the ListClusterAddonInstances operation to query information about the components that are installed in a cluster.
31888
+ * Queries the component instances that are running in the specified cluster and the information about the component instances. The information includes the component version and status.
31573
31889
  *
31574
31890
  * @param headers - map
31575
31891
  * @param runtime - runtime options for this request RuntimeOptions
@@ -31594,7 +31910,7 @@ export default class Client extends OpenApi {
31594
31910
  }
31595
31911
 
31596
31912
  /**
31597
- * You can call the ListClusterAddonInstances operation to query information about the components that are installed in a cluster.
31913
+ * Queries the component instances that are running in the specified cluster and the information about the component instances. The information includes the component version and status.
31598
31914
  * @returns ListClusterAddonInstancesResponse
31599
31915
  */
31600
31916
  async listClusterAddonInstances(clusterId: string): Promise<ListClusterAddonInstancesResponse> {
@@ -31656,9 +31972,8 @@ export default class Client extends OpenApi {
31656
31972
  * You can call the ListClusterKubeconfigStates operation to query the kubeconfig files that are issued to users for the current cluster and the status of the kubeconfig files.
31657
31973
  *
31658
31974
  * @remarks
31659
- * >
31660
- * * To call this operation, make sure that you have ram:ListUsers and ram:ListRoles permissions.
31661
- * * To call this operation, make sure that you have the AliyunCSFullAccess permissions.
31975
+ * > - To call this operation, make sure that you have ram:ListUsers and ram:ListRoles permissions.
31976
+ * > - To call this operation, make sure that you have the AliyunCSFullAccess permissions.
31662
31977
  *
31663
31978
  * @param request - ListClusterKubeconfigStatesRequest
31664
31979
  * @param headers - map
@@ -31698,9 +32013,8 @@ export default class Client extends OpenApi {
31698
32013
  * You can call the ListClusterKubeconfigStates operation to query the kubeconfig files that are issued to users for the current cluster and the status of the kubeconfig files.
31699
32014
  *
31700
32015
  * @remarks
31701
- * >
31702
- * * To call this operation, make sure that you have ram:ListUsers and ram:ListRoles permissions.
31703
- * * To call this operation, make sure that you have the AliyunCSFullAccess permissions.
32016
+ * > - To call this operation, make sure that you have ram:ListUsers and ram:ListRoles permissions.
32017
+ * > - To call this operation, make sure that you have the AliyunCSFullAccess permissions.
31704
32018
  *
31705
32019
  * @param request - ListClusterKubeconfigStatesRequest
31706
32020
  * @returns ListClusterKubeconfigStatesResponse
@@ -31712,7 +32026,7 @@ export default class Client extends OpenApi {
31712
32026
  }
31713
32027
 
31714
32028
  /**
31715
- * 获取自动运维执行计划列表
32029
+ * Queries the auto O\\&M schedules of a cluster.
31716
32030
  *
31717
32031
  * @param request - ListOperationPlansRequest
31718
32032
  * @param headers - map
@@ -31749,7 +32063,7 @@ export default class Client extends OpenApi {
31749
32063
  }
31750
32064
 
31751
32065
  /**
31752
- * 获取自动运维执行计划列表
32066
+ * Queries the auto O\\&M schedules of a cluster.
31753
32067
  *
31754
32068
  * @param request - ListOperationPlansRequest
31755
32069
  * @returns ListOperationPlansResponse
@@ -32037,8 +32351,8 @@ export default class Client extends OpenApi {
32037
32351
  *
32038
32352
  * @remarks
32039
32353
  * You can use this API operation to modify the components in a Container Service for Kubernetes (ACK) cluster or the control plane components in an ACK Pro cluster.
32040
- * * To query the customizable parameters of a component, call the `DescribeClusterAddonMetadata` API operation. For more information, see [Query the metadata of a specified component version](https://www.alibabacloud.com/help/zh/container-service-for-kubernetes/latest/query).
32041
- * * For more information about the customizable parameters of control plane components in ACK Pro clusters, see [Customize the parameters of control plane components in ACK Pro clusters](https://www.alibabacloud.com/help/zh/container-service-for-kubernetes/latest/customize-control-plane-parameters-for-a-professional-kubernetes-cluster).
32354
+ * * To query the customizable parameters of a component, call the `DescribeClusterAddonMetadata` API operation. For more information, see [Query the metadata of a specified component version](https://help.aliyun.com/document_detail/2667944.html).
32355
+ * * For more information about the customizable parameters of control plane components in ACK Pro clusters, see [Customize the parameters of control plane components in ACK Pro clusters](https://help.aliyun.com/document_detail/199588.html).
32042
32356
  * After you call this operation, the component may be redeployed and restarted. We recommend that you assess the impact before you call this operation.
32043
32357
  *
32044
32358
  * @param request - ModifyClusterAddonRequest
@@ -32076,8 +32390,8 @@ export default class Client extends OpenApi {
32076
32390
  *
32077
32391
  * @remarks
32078
32392
  * You can use this API operation to modify the components in a Container Service for Kubernetes (ACK) cluster or the control plane components in an ACK Pro cluster.
32079
- * * To query the customizable parameters of a component, call the `DescribeClusterAddonMetadata` API operation. For more information, see [Query the metadata of a specified component version](https://www.alibabacloud.com/help/zh/container-service-for-kubernetes/latest/query).
32080
- * * For more information about the customizable parameters of control plane components in ACK Pro clusters, see [Customize the parameters of control plane components in ACK Pro clusters](https://www.alibabacloud.com/help/zh/container-service-for-kubernetes/latest/customize-control-plane-parameters-for-a-professional-kubernetes-cluster).
32393
+ * * To query the customizable parameters of a component, call the `DescribeClusterAddonMetadata` API operation. For more information, see [Query the metadata of a specified component version](https://help.aliyun.com/document_detail/2667944.html).
32394
+ * * For more information about the customizable parameters of control plane components in ACK Pro clusters, see [Customize the parameters of control plane components in ACK Pro clusters](https://help.aliyun.com/document_detail/199588.html).
32081
32395
  * After you call this operation, the component may be redeployed and restarted. We recommend that you assess the impact before you call this operation.
32082
32396
  *
32083
32397
  * @param request - ModifyClusterAddonRequest
@@ -32208,7 +32522,7 @@ export default class Client extends OpenApi {
32208
32522
  }
32209
32523
 
32210
32524
  /**
32211
- * Modifies the labels of a Container Service for Kubernetes (ACK) cluster. You can use labels (key-value pairs) to classify and manage ACK clusters in order to meet monitoring, cost analysis, and tenant isolation requirements.
32525
+ * You can add labels in key-value pairs to clusters. This allows cluster developers or O\\&M engineers to classify and manage clusters in a more flexible manner. This also meets the requirements for monitoring, cost analysis, and tenant isolation. You can call the ModifyClusterTags operation to modify the labels of a cluster.
32212
32526
  *
32213
32527
  * @param request - ModifyClusterTagsRequest
32214
32528
  * @param headers - map
@@ -32236,7 +32550,7 @@ export default class Client extends OpenApi {
32236
32550
  }
32237
32551
 
32238
32552
  /**
32239
- * Modifies the labels of a Container Service for Kubernetes (ACK) cluster. You can use labels (key-value pairs) to classify and manage ACK clusters in order to meet monitoring, cost analysis, and tenant isolation requirements.
32553
+ * You can add labels in key-value pairs to clusters. This allows cluster developers or O\\&M engineers to classify and manage clusters in a more flexible manner. This also meets the requirements for monitoring, cost analysis, and tenant isolation. You can call the ModifyClusterTags operation to modify the labels of a cluster.
32240
32554
  *
32241
32555
  * @param request - ModifyClusterTagsRequest
32242
32556
  * @returns ModifyClusterTagsResponse
@@ -32364,7 +32678,7 @@ export default class Client extends OpenApi {
32364
32678
  }
32365
32679
 
32366
32680
  /**
32367
- * You can call the OpenAckService operation to activate Container Service for Kubernetes (ACK).
32681
+ * When you use Container Service for Kubernetes (ACK) for the first time, you must activate ACK by using an Alibaba Cloud account or RAM user with the required permissions and complete ACK authorization.
32368
32682
  *
32369
32683
  * @remarks
32370
32684
  * You can activate ACK by using Alibaba Cloud accounts.
@@ -32401,7 +32715,7 @@ export default class Client extends OpenApi {
32401
32715
  }
32402
32716
 
32403
32717
  /**
32404
- * You can call the OpenAckService operation to activate Container Service for Kubernetes (ACK).
32718
+ * When you use Container Service for Kubernetes (ACK) for the first time, you must activate ACK by using an Alibaba Cloud account or RAM user with the required permissions and complete ACK authorization.
32405
32719
  *
32406
32720
  * @remarks
32407
32721
  * You can activate ACK by using Alibaba Cloud accounts.
@@ -32729,7 +33043,7 @@ export default class Client extends OpenApi {
32729
33043
  }
32730
33044
 
32731
33045
  /**
32732
- * You can call the RepairClusterNodePool operation to fix issues on specified nodes in a managed node pool.
33046
+ * Fixes issues on abnormal nodes in a node pool to ensure that the nodes can run as normal.
32733
33047
  *
32734
33048
  * @param request - RepairClusterNodePoolRequest
32735
33049
  * @param headers - map
@@ -32770,7 +33084,7 @@ export default class Client extends OpenApi {
32770
33084
  }
32771
33085
 
32772
33086
  /**
32773
- * You can call the RepairClusterNodePool operation to fix issues on specified nodes in a managed node pool.
33087
+ * Fixes issues on abnormal nodes in a node pool to ensure that the nodes can run as normal.
32774
33088
  *
32775
33089
  * @param request - RepairClusterNodePoolRequest
32776
33090
  * @returns RepairClusterNodePoolResponse
@@ -32899,7 +33213,7 @@ export default class Client extends OpenApi {
32899
33213
  }
32900
33214
 
32901
33215
  /**
32902
- * You can call the RevokeK8sClusterKubeConfig operation to revoke the kubeconfig file that the current Resource Access Management (RAM) user uses to log on to a Kubernetes cluster. The kubeconfig file contains the identity information of the RAM user.
33216
+ * You can call the RevokeK8sClusterKubeConfig operation to revoke the kubeconfig file of a cluster that belongs to the current Alibaba Cloud account or RAM user. After the kubeconfig file is revoked, the cluster generates a new kubeconfig file, and the original kubeconfig file becomes invalid.
32903
33217
  *
32904
33218
  * @param headers - map
32905
33219
  * @param runtime - runtime options for this request RuntimeOptions
@@ -32924,7 +33238,7 @@ export default class Client extends OpenApi {
32924
33238
  }
32925
33239
 
32926
33240
  /**
32927
- * You can call the RevokeK8sClusterKubeConfig operation to revoke the kubeconfig file that the current Resource Access Management (RAM) user uses to log on to a Kubernetes cluster. The kubeconfig file contains the identity information of the RAM user.
33241
+ * You can call the RevokeK8sClusterKubeConfig operation to revoke the kubeconfig file of a cluster that belongs to the current Alibaba Cloud account or RAM user. After the kubeconfig file is revoked, the cluster generates a new kubeconfig file, and the original kubeconfig file becomes invalid.
32928
33242
  * @returns RevokeK8sClusterKubeConfigResponse
32929
33243
  */
32930
33244
  async revokeK8sClusterKubeConfig(ClusterId: string): Promise<RevokeK8sClusterKubeConfigResponse> {
@@ -32934,7 +33248,7 @@ export default class Client extends OpenApi {
32934
33248
  }
32935
33249
 
32936
33250
  /**
32937
- * Initiates cluster checks such as cluster update checks.
33251
+ * Container Intelligence Service (CIS) provides a variety of cluster check capabilities to allow you to perform cluster update check, cluster migration check, component installation check, component update check, and node pool check. A precheck is automatically triggered before an update, migration, or installation is performed. You can perform changes only if the cluster passes the precheck. You can also manually call the RunClusterCheck operation to initiate cluster checks. We recommend that you periodically check and maintain your cluster to mitigate potential risks.
32938
33252
  *
32939
33253
  * @param request - RunClusterCheckRequest
32940
33254
  * @param headers - map
@@ -32975,7 +33289,7 @@ export default class Client extends OpenApi {
32975
33289
  }
32976
33290
 
32977
33291
  /**
32978
- * Initiates cluster checks such as cluster update checks.
33292
+ * Container Intelligence Service (CIS) provides a variety of cluster check capabilities to allow you to perform cluster update check, cluster migration check, component installation check, component update check, and node pool check. A precheck is automatically triggered before an update, migration, or installation is performed. You can perform changes only if the cluster passes the precheck. You can also manually call the RunClusterCheck operation to initiate cluster checks. We recommend that you periodically check and maintain your cluster to mitigate potential risks.
32979
33293
  *
32980
33294
  * @param request - RunClusterCheckRequest
32981
33295
  * @returns RunClusterCheckResponse
@@ -33575,7 +33889,7 @@ export default class Client extends OpenApi {
33575
33889
  }
33576
33890
 
33577
33891
  /**
33578
- * Adds labels to a Container Service for Kubernetes (ACK) cluster. You can use labels to classify and manage ACK clusters in order to meet monitoring, cost analysis, and tenant isolation requirements.
33892
+ * You can add labels in key-value pairs to clusters. This allows cluster developers or O\\&M engineers to classify and manage clusters in a more flexible manner. This also meets the requirements for monitoring, cost analysis, and tenant isolation. You can call the TagResources operation to add labels to a cluster.
33579
33893
  *
33580
33894
  * @param request - TagResourcesRequest
33581
33895
  * @param headers - map
@@ -33620,7 +33934,7 @@ export default class Client extends OpenApi {
33620
33934
  }
33621
33935
 
33622
33936
  /**
33623
- * Adds labels to a Container Service for Kubernetes (ACK) cluster. You can use labels to classify and manage ACK clusters in order to meet monitoring, cost analysis, and tenant isolation requirements.
33937
+ * You can add labels in key-value pairs to clusters. This allows cluster developers or O\\&M engineers to classify and manage clusters in a more flexible manner. This also meets the requirements for monitoring, cost analysis, and tenant isolation. You can call the TagResources operation to add labels to a cluster.
33624
33938
  *
33625
33939
  * @param request - TagResourcesRequest
33626
33940
  * @returns TagResourcesResponse
@@ -33672,7 +33986,7 @@ export default class Client extends OpenApi {
33672
33986
  }
33673
33987
 
33674
33988
  /**
33675
- * Removes labels from a Container Service for Kubernetes (ACK) cluster.
33989
+ * If you no longer need the labels (key-value pairs) of a cluster, you can call the UntagResources operation to delete the labels.
33676
33990
  *
33677
33991
  * @param tmpReq - UntagResourcesRequest
33678
33992
  * @param headers - map
@@ -33731,7 +34045,7 @@ export default class Client extends OpenApi {
33731
34045
  }
33732
34046
 
33733
34047
  /**
33734
- * Removes labels from a Container Service for Kubernetes (ACK) cluster.
34048
+ * If you no longer need the labels (key-value pairs) of a cluster, you can call the UntagResources operation to delete the labels.
33735
34049
  *
33736
34050
  * @param request - UntagResourcesRequest
33737
34051
  * @returns UntagResourcesResponse
@@ -33798,7 +34112,7 @@ export default class Client extends OpenApi {
33798
34112
  }
33799
34113
 
33800
34114
  /**
33801
- * 为集群中报警规则集设置订阅的通知对象联系人组
34115
+ * null
33802
34116
  *
33803
34117
  * @param request - UpdateContactGroupForAlertRequest
33804
34118
  * @param headers - map
@@ -33843,7 +34157,7 @@ export default class Client extends OpenApi {
33843
34157
  }
33844
34158
 
33845
34159
  /**
33846
- * 为集群中报警规则集设置订阅的通知对象联系人组
34160
+ * null
33847
34161
  *
33848
34162
  * @param request - UpdateContactGroupForAlertRequest
33849
34163
  * @returns UpdateContactGroupForAlertResponse
@@ -33855,7 +34169,7 @@ export default class Client extends OpenApi {
33855
34169
  }
33856
34170
 
33857
34171
  /**
33858
- * You can call the UpdateControlPlaneLog operation to modify the log collection configurations for control plane components in a Container Service for Kubernetes (ACK) managed cluster.
34172
+ * Modifies the log configurations of control plane components. The configurations include the log retention period and components whose logs that you want to collect. Container Service for Kubernetes (ACK) managed clusters can collect the logs of control plane components and deliver the logs to projects in Simple Log Service. These control plane components include Kube-apiserver, kube-scheduler, Kubernetes controller manager, and cloud controller manager (CCM).
33859
34173
  *
33860
34174
  * @param request - UpdateControlPlaneLogRequest
33861
34175
  * @param headers - map
@@ -33900,7 +34214,7 @@ export default class Client extends OpenApi {
33900
34214
  }
33901
34215
 
33902
34216
  /**
33903
- * You can call the UpdateControlPlaneLog operation to modify the log collection configurations for control plane components in a Container Service for Kubernetes (ACK) managed cluster.
34217
+ * Modifies the log configurations of control plane components. The configurations include the log retention period and components whose logs that you want to collect. Container Service for Kubernetes (ACK) managed clusters can collect the logs of control plane components and deliver the logs to projects in Simple Log Service. These control plane components include Kube-apiserver, kube-scheduler, Kubernetes controller manager, and cloud controller manager (CCM).
33904
34218
  *
33905
34219
  * @param request - UpdateControlPlaneLogRequest
33906
34220
  * @returns UpdateControlPlaneLogResponse
@@ -33915,8 +34229,8 @@ export default class Client extends OpenApi {
33915
34229
  * Sets the validity period of a kubeconfig file used by a Resource Access Management (RAM) user or RAM role to connect to a Container Service for Kubernetes (ACK) cluster. The validity period ranges from 1 to 876,000 hours. You can call this API operation when you customize configurations by using an Alibaba Cloud account. The default validity period of a kubeconfig file is three years.
33916
34230
  *
33917
34231
  * @remarks
33918
- * - You can call this operation only with an Alibaba Cloud account.
33919
- * - If the kubeconfig file used by your cluster is revoked, the custom validity period of the kubeconfig file is reset. In this case, you need to call this API operation to reconfigure the validity period of the kubeconfig file.
34232
+ * You can call this operation only with an Alibaba Cloud account.
34233
+ * * If the kubeconfig file used by your cluster is revoked, the custom validity period of the kubeconfig file is reset. In this case, you need to call this API operation to reconfigure the validity period of the kubeconfig file.
33920
34234
  *
33921
34235
  * @param request - UpdateK8sClusterUserConfigExpireRequest
33922
34236
  * @param headers - map
@@ -33956,8 +34270,8 @@ export default class Client extends OpenApi {
33956
34270
  * Sets the validity period of a kubeconfig file used by a Resource Access Management (RAM) user or RAM role to connect to a Container Service for Kubernetes (ACK) cluster. The validity period ranges from 1 to 876,000 hours. You can call this API operation when you customize configurations by using an Alibaba Cloud account. The default validity period of a kubeconfig file is three years.
33957
34271
  *
33958
34272
  * @remarks
33959
- * - You can call this operation only with an Alibaba Cloud account.
33960
- * - If the kubeconfig file used by your cluster is revoked, the custom validity period of the kubeconfig file is reset. In this case, you need to call this API operation to reconfigure the validity period of the kubeconfig file.
34273
+ * You can call this operation only with an Alibaba Cloud account.
34274
+ * * If the kubeconfig file used by your cluster is revoked, the custom validity period of the kubeconfig file is reset. In this case, you need to call this API operation to reconfigure the validity period of the kubeconfig file.
33961
34275
  *
33962
34276
  * @param request - UpdateK8sClusterUserConfigExpireRequest
33963
34277
  * @returns UpdateK8sClusterUserConfigExpireResponse