@alicloud/cs20151215 7.0.2 → 7.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (45) hide show
  1. package/dist/client.d.ts +50 -28
  2. package/dist/client.js +53 -28
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/CreateClusterNodePoolRequest.d.ts +134 -83
  5. package/dist/models/CreateClusterNodePoolRequest.js +31 -1
  6. package/dist/models/CreateClusterNodePoolRequest.js.map +1 -1
  7. package/dist/models/CreateClusterRequest.d.ts +372 -345
  8. package/dist/models/CreateClusterRequest.js +27 -1
  9. package/dist/models/CreateClusterRequest.js.map +1 -1
  10. package/dist/models/CreateClusterResponseBody.d.ts +3 -3
  11. package/dist/models/DescribeClusterDetailResponseBody.d.ts +147 -106
  12. package/dist/models/DescribeClusterDetailResponseBody.js +29 -1
  13. package/dist/models/DescribeClusterDetailResponseBody.js.map +1 -1
  14. package/dist/models/DescribeClusterNodePoolDetailResponseBody.d.ts +119 -91
  15. package/dist/models/DescribeClusterNodePoolDetailResponseBody.js +31 -1
  16. package/dist/models/DescribeClusterNodePoolDetailResponseBody.js.map +1 -1
  17. package/dist/models/DescribeClusterNodePoolsResponseBody.d.ts +175 -130
  18. package/dist/models/DescribeClusterNodePoolsResponseBody.js +31 -1
  19. package/dist/models/DescribeClusterNodePoolsResponseBody.js.map +1 -1
  20. package/dist/models/ModifyClusterNodePoolRequest.d.ts +121 -95
  21. package/dist/models/ModifyClusterNodePoolRequest.js +6 -0
  22. package/dist/models/ModifyClusterNodePoolRequest.js.map +1 -1
  23. package/dist/models/ModifyClusterRequest.d.ts +151 -112
  24. package/dist/models/ModifyClusterRequest.js +29 -1
  25. package/dist/models/ModifyClusterRequest.js.map +1 -1
  26. package/dist/models/ModifyClusterResponseBody.d.ts +3 -3
  27. package/dist/models/Nodepool.d.ts +266 -220
  28. package/dist/models/Nodepool.js +31 -1
  29. package/dist/models/Nodepool.js.map +1 -1
  30. package/dist/models/model.d.ts +7 -0
  31. package/dist/models/model.js +80 -66
  32. package/dist/models/model.js.map +1 -1
  33. package/package.json +2 -2
  34. package/src/client.ts +54 -28
  35. package/src/models/CreateClusterNodePoolRequest.ts +155 -83
  36. package/src/models/CreateClusterRequest.ts +389 -345
  37. package/src/models/CreateClusterResponseBody.ts +3 -3
  38. package/src/models/DescribeClusterDetailResponseBody.ts +166 -106
  39. package/src/models/DescribeClusterNodePoolDetailResponseBody.ts +140 -91
  40. package/src/models/DescribeClusterNodePoolsResponseBody.ts +196 -130
  41. package/src/models/ModifyClusterNodePoolRequest.ts +127 -95
  42. package/src/models/ModifyClusterRequest.ts +170 -112
  43. package/src/models/ModifyClusterResponseBody.ts +3 -3
  44. package/src/models/Nodepool.ts +287 -220
  45. package/src/models/model.ts +7 -0
package/dist/client.d.ts CHANGED
@@ -250,16 +250,16 @@ export default class Client extends OpenApi {
250
250
  */
251
251
  createAutoscalingConfig(ClusterId: string, request: $_model.CreateAutoscalingConfigRequest): Promise<$_model.CreateAutoscalingConfigResponse>;
252
252
  /**
253
- * You can create ACK clusters through OpenAPI, including ACK managed clusters, ACK Serverless clusters, ACK Edge clusters, and registered clusters. When creating a cluster, you will configure the cluster information, cluster components, and ACK-related cloud resources.
253
+ * Creates an ACK cluster, including ACK managed clusters, ACK Serverless clusters, ACK Edge clusters, and registered clusters. When creating a cluster, you configure cluster information, cluster components, and ACK-related cloud resources.
254
254
  *
255
255
  * @remarks
256
- * ### Generate OpenAPI request parameters through the console
257
- * When calling the CreateCluster API to create a cluster, if the API call fails due to incorrect request parameter combinations, you can generate the required request parameter combinations through the console. Follow these steps:
258
- * 1. Log in to the [Container Service management console](https://csnew.console.aliyun.com) and choose **Clusters** in the left navigation pane.
259
- * 1. On the **Clusters** page, click **Cluster Template**.
260
- * 1. In the dialog box, select the cluster type to create, click Create, and then configure the cluster information on the cluster configuration page.
261
- * 1. After the configuration is complete, on the **Confirm Configuration** page, click **Equivalent Code** in the upper-right corner. The dialog box will display the parameter combinations required for creating the cluster, which you can copy and use.
262
- * >Notice: Starting from July 4, 2026, some request parameters will no longer take effect. For change details and alternative parameter descriptions, see [Announcement on OpenAPI parameter changes and API deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
256
+ * ### Generate OpenAPI request parameters from the console
257
+ * When you call the CreateCluster operation to create a cluster, if the API call fails due to incorrect request parameter combinations, you can generate the required request parameter combinations from the console. Perform the following steps:
258
+ * 1. Log on to the [Container Service console](https://csnew.console.aliyun.com) and choose **Cluster List** in the left-side navigation pane.
259
+ * 1. On the **Cluster List** page, click **Cluster Template**.
260
+ * 1. In the dialog box, select the cluster type that you want to create, click Create, and then configure the cluster information on the cluster configuration page.
261
+ * 1. After the configuration is complete, on the **Confirm Configuration** page, click **Equivalent Code** in the upper-right corner. The dialog box displays the parameter combinations required to create the cluster, which you can copy and use.
262
+ * >Notice: Starting from July 4, 2026, some request parameters will no longer take effect. For details about the changes and override parameter descriptions, see [Notice on changes to OpenAPI parameters and offline of OpenAPIs for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
263
263
  *
264
264
  * @param request - CreateClusterRequest
265
265
  * @param headers - map
@@ -270,16 +270,16 @@ export default class Client extends OpenApi {
270
270
  [key: string]: string;
271
271
  }, runtime: $dara.RuntimeOptions): Promise<$_model.CreateClusterResponse>;
272
272
  /**
273
- * You can create ACK clusters through OpenAPI, including ACK managed clusters, ACK Serverless clusters, ACK Edge clusters, and registered clusters. When creating a cluster, you will configure the cluster information, cluster components, and ACK-related cloud resources.
273
+ * Creates an ACK cluster, including ACK managed clusters, ACK Serverless clusters, ACK Edge clusters, and registered clusters. When creating a cluster, you configure cluster information, cluster components, and ACK-related cloud resources.
274
274
  *
275
275
  * @remarks
276
- * ### Generate OpenAPI request parameters through the console
277
- * When calling the CreateCluster API to create a cluster, if the API call fails due to incorrect request parameter combinations, you can generate the required request parameter combinations through the console. Follow these steps:
278
- * 1. Log in to the [Container Service management console](https://csnew.console.aliyun.com) and choose **Clusters** in the left navigation pane.
279
- * 1. On the **Clusters** page, click **Cluster Template**.
280
- * 1. In the dialog box, select the cluster type to create, click Create, and then configure the cluster information on the cluster configuration page.
281
- * 1. After the configuration is complete, on the **Confirm Configuration** page, click **Equivalent Code** in the upper-right corner. The dialog box will display the parameter combinations required for creating the cluster, which you can copy and use.
282
- * >Notice: Starting from July 4, 2026, some request parameters will no longer take effect. For change details and alternative parameter descriptions, see [Announcement on OpenAPI parameter changes and API deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
276
+ * ### Generate OpenAPI request parameters from the console
277
+ * When you call the CreateCluster operation to create a cluster, if the API call fails due to incorrect request parameter combinations, you can generate the required request parameter combinations from the console. Perform the following steps:
278
+ * 1. Log on to the [Container Service console](https://csnew.console.aliyun.com) and choose **Cluster List** in the left-side navigation pane.
279
+ * 1. On the **Cluster List** page, click **Cluster Template**.
280
+ * 1. In the dialog box, select the cluster type that you want to create, click Create, and then configure the cluster information on the cluster configuration page.
281
+ * 1. After the configuration is complete, on the **Confirm Configuration** page, click **Equivalent Code** in the upper-right corner. The dialog box displays the parameter combinations required to create the cluster, which you can copy and use.
282
+ * >Notice: Starting from July 4, 2026, some request parameters will no longer take effect. For details about the changes and override parameter descriptions, see [Notice on changes to OpenAPI parameters and offline of OpenAPIs for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
283
283
  *
284
284
  * @param request - CreateClusterRequest
285
285
  * @returns CreateClusterResponse
@@ -322,7 +322,7 @@ export default class Client extends OpenApi {
322
322
  */
323
323
  createClusterInspectConfig(clusterId: string, request: $_model.CreateClusterInspectConfigRequest): Promise<$_model.CreateClusterInspectConfigResponse>;
324
324
  /**
325
- * A node pool is a logical collection of nodes that share the same attributes, allowing unified management and operations such as node upgrades and elastic scaling. You can further use the automated O&M capabilities of node pools, including automatic OS CVE vulnerability patching, automatic faulty node recovery, and automatic kubelet and containerd version upgrades, to reduce O&M costs. You can call CreateClusterNodePool to create a node pool for a cluster.
325
+ * Creates a node pool for a cluster. A node pool is a logical collection of nodes that share the same attributes, allowing unified management and O&M operations such as node upgrades and elastic scaling. You can further leverage the automated O&M capabilities of node pools, including automatic OS CVE vulnerability patching, automatic faulty node recovery, and automatic kubelet and containerd version upgrades, to reduce O&M costs.
326
326
  *
327
327
  * @param request - CreateClusterNodePoolRequest
328
328
  * @param headers - map
@@ -333,7 +333,7 @@ export default class Client extends OpenApi {
333
333
  [key: string]: string;
334
334
  }, runtime: $dara.RuntimeOptions): Promise<$_model.CreateClusterNodePoolResponse>;
335
335
  /**
336
- * A node pool is a logical collection of nodes that share the same attributes, allowing unified management and operations such as node upgrades and elastic scaling. You can further use the automated O&M capabilities of node pools, including automatic OS CVE vulnerability patching, automatic faulty node recovery, and automatic kubelet and containerd version upgrades, to reduce O&M costs. You can call CreateClusterNodePool to create a node pool for a cluster.
336
+ * Creates a node pool for a cluster. A node pool is a logical collection of nodes that share the same attributes, allowing unified management and O&M operations such as node upgrades and elastic scaling. You can further leverage the automated O&M capabilities of node pools, including automatic OS CVE vulnerability patching, automatic faulty node recovery, and automatic kubelet and containerd version upgrades, to reduce O&M costs.
337
337
  *
338
338
  * @param request - CreateClusterNodePoolRequest
339
339
  * @returns CreateClusterNodePoolResponse
@@ -827,7 +827,7 @@ export default class Client extends OpenApi {
827
827
  */
828
828
  describeClusterAttachScripts(ClusterId: string, request: $_model.DescribeClusterAttachScriptsRequest): Promise<$_model.DescribeClusterAttachScriptsResponse>;
829
829
  /**
830
- * You can call the DescribeClusterDetail API to query the detailed information of a specified cluster by cluster ID.
830
+ * Queries the details of a specified cluster by cluster ID.
831
831
  *
832
832
  * @param headers - map
833
833
  * @param runtime - runtime options for this request RuntimeOptions
@@ -837,7 +837,7 @@ export default class Client extends OpenApi {
837
837
  [key: string]: string;
838
838
  }, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeClusterDetailResponse>;
839
839
  /**
840
- * You can call the DescribeClusterDetail API to query the detailed information of a specified cluster by cluster ID.
840
+ * Queries the details of a specified cluster by cluster ID.
841
841
  * @returns DescribeClusterDetailResponse
842
842
  */
843
843
  describeClusterDetail(ClusterId: string): Promise<$_model.DescribeClusterDetailResponse>;
@@ -890,7 +890,15 @@ export default class Client extends OpenApi {
890
890
  */
891
891
  describeClusterNodePoolDetail(ClusterId: string, NodepoolId: string): Promise<$_model.DescribeClusterNodePoolDetailResponse>;
892
892
  /**
893
- * Queries all node pools in a cluster.
893
+ * Queries the list of all node pools in a cluster.
894
+ *
895
+ * @remarks
896
+ * - When removing nodes, perform standardized operations through this API or the [Container Service console](https://cs.console.aliyun.com). Do not manually remove nodes by using `kubectl delete node`.
897
+ * - Do not directly release nodes, remove instances, or allow nodes to be passively released due to subscription instance expires in the ECS or ESS console (or through related APIs). In these cases, nodes are directly stopped and automatically removed from the Container Service console.
898
+ * - If the node pool has a desired node count configured, the node pool automatically scales out other instances based on the corresponding configuration to maintain the node count at the desired number.
899
+ * - Removing nodes involves Pod migration, which may affect your services. Perform this operation during off-peak hours. Unexpected risks may occur during the operation. Back up relevant data in advance.
900
+ * - When removing nodes, ACK executes a drain operation. Ensure that other nodes in the cluster have sufficient resources to avoid application Pods that cannot be scheduling.
901
+ * - Check the node affinity rules and scheduling policies of Pods on the nodes to be removed to ensure that Pods are not left unschedulable after node removal.
894
902
  *
895
903
  * @param request - DescribeClusterNodePoolsRequest
896
904
  * @param headers - map
@@ -901,7 +909,15 @@ export default class Client extends OpenApi {
901
909
  [key: string]: string;
902
910
  }, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeClusterNodePoolsResponse>;
903
911
  /**
904
- * Queries all node pools in a cluster.
912
+ * Queries the list of all node pools in a cluster.
913
+ *
914
+ * @remarks
915
+ * - When removing nodes, perform standardized operations through this API or the [Container Service console](https://cs.console.aliyun.com). Do not manually remove nodes by using `kubectl delete node`.
916
+ * - Do not directly release nodes, remove instances, or allow nodes to be passively released due to subscription instance expires in the ECS or ESS console (or through related APIs). In these cases, nodes are directly stopped and automatically removed from the Container Service console.
917
+ * - If the node pool has a desired node count configured, the node pool automatically scales out other instances based on the corresponding configuration to maintain the node count at the desired number.
918
+ * - Removing nodes involves Pod migration, which may affect your services. Perform this operation during off-peak hours. Unexpected risks may occur during the operation. Back up relevant data in advance.
919
+ * - When removing nodes, ACK executes a drain operation. Ensure that other nodes in the cluster have sufficient resources to avoid application Pods that cannot be scheduling.
920
+ * - Check the node affinity rules and scheduling policies of Pods on the nodes to be removed to ensure that Pods are not left unschedulable after node removal.
905
921
  *
906
922
  * @param request - DescribeClusterNodePoolsRequest
907
923
  * @returns DescribeClusterNodePoolsResponse
@@ -1945,10 +1961,10 @@ export default class Client extends OpenApi {
1945
1961
  */
1946
1962
  modifyAutoRepairPolicy(clusterId: string, policyId: string, request: $_model.ModifyAutoRepairPolicyRequest): Promise<$_model.ModifyAutoRepairPolicyResponse>;
1947
1963
  /**
1948
- * You can call the ModifyCluster operation to modify the configuration of an ACK cluster.
1964
+ * Modifies the configuration of an ACK cluster.
1949
1965
  *
1950
1966
  * @remarks
1951
- * <notice>Starting from July 04, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For details about the changes, see [Announcement on Changes to ACK Cluster Management OpenAPI Parameters and OpenAPI Deprecation](https://help.aliyun.com/document_detail/2932733.html).</notice>
1967
+ * <notice>Starting July 4, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For more information about the changes, see [Announcement on changes to OpenAPI request and response parameters and OpenAPI deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
1952
1968
  *
1953
1969
  * @param request - ModifyClusterRequest
1954
1970
  * @param headers - map
@@ -1959,10 +1975,10 @@ export default class Client extends OpenApi {
1959
1975
  [key: string]: string;
1960
1976
  }, runtime: $dara.RuntimeOptions): Promise<$_model.ModifyClusterResponse>;
1961
1977
  /**
1962
- * You can call the ModifyCluster operation to modify the configuration of an ACK cluster.
1978
+ * Modifies the configuration of an ACK cluster.
1963
1979
  *
1964
1980
  * @remarks
1965
- * <notice>Starting from July 04, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For details about the changes, see [Announcement on Changes to ACK Cluster Management OpenAPI Parameters and OpenAPI Deprecation](https://help.aliyun.com/document_detail/2932733.html).</notice>
1981
+ * <notice>Starting July 4, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For more information about the changes, see [Announcement on changes to OpenAPI request and response parameters and OpenAPI deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
1966
1982
  *
1967
1983
  * @param request - ModifyClusterRequest
1968
1984
  * @returns ModifyClusterResponse
@@ -1999,7 +2015,10 @@ export default class Client extends OpenApi {
1999
2015
  */
2000
2016
  modifyClusterAddon(clusterId: string, componentId: string, request: $_model.ModifyClusterAddonRequest): Promise<$_model.ModifyClusterAddonResponse>;
2001
2017
  /**
2002
- * Updates the configuration of a node pool based on the node pool ID by calling the ModifyClusterNodePool operation.
2018
+ * Modifies the configuration of a node pool based on the node pool ID by calling the ModifyClusterNodePool operation.
2019
+ *
2020
+ * @remarks
2021
+ * <notice>Starting from July 4, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For more information about the changes, see [Notice on changes to OpenAPI request and response parameters and OpenAPI deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
2003
2022
  *
2004
2023
  * @param request - ModifyClusterNodePoolRequest
2005
2024
  * @param headers - map
@@ -2010,7 +2029,10 @@ export default class Client extends OpenApi {
2010
2029
  [key: string]: string;
2011
2030
  }, runtime: $dara.RuntimeOptions): Promise<$_model.ModifyClusterNodePoolResponse>;
2012
2031
  /**
2013
- * Updates the configuration of a node pool based on the node pool ID by calling the ModifyClusterNodePool operation.
2032
+ * Modifies the configuration of a node pool based on the node pool ID by calling the ModifyClusterNodePool operation.
2033
+ *
2034
+ * @remarks
2035
+ * <notice>Starting from July 4, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For more information about the changes, see [Notice on changes to OpenAPI request and response parameters and OpenAPI deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
2014
2036
  *
2015
2037
  * @param request - ModifyClusterNodePoolRequest
2016
2038
  * @returns ModifyClusterNodePoolResponse
package/dist/client.js CHANGED
@@ -740,16 +740,16 @@ class Client extends openapi_core_1.default {
740
740
  return await this.createAutoscalingConfigWithOptions(ClusterId, request, headers, runtime);
741
741
  }
742
742
  /**
743
- * You can create ACK clusters through OpenAPI, including ACK managed clusters, ACK Serverless clusters, ACK Edge clusters, and registered clusters. When creating a cluster, you will configure the cluster information, cluster components, and ACK-related cloud resources.
743
+ * Creates an ACK cluster, including ACK managed clusters, ACK Serverless clusters, ACK Edge clusters, and registered clusters. When creating a cluster, you configure cluster information, cluster components, and ACK-related cloud resources.
744
744
  *
745
745
  * @remarks
746
- * ### Generate OpenAPI request parameters through the console
747
- * When calling the CreateCluster API to create a cluster, if the API call fails due to incorrect request parameter combinations, you can generate the required request parameter combinations through the console. Follow these steps:
748
- * 1. Log in to the [Container Service management console](https://csnew.console.aliyun.com) and choose **Clusters** in the left navigation pane.
749
- * 1. On the **Clusters** page, click **Cluster Template**.
750
- * 1. In the dialog box, select the cluster type to create, click Create, and then configure the cluster information on the cluster configuration page.
751
- * 1. After the configuration is complete, on the **Confirm Configuration** page, click **Equivalent Code** in the upper-right corner. The dialog box will display the parameter combinations required for creating the cluster, which you can copy and use.
752
- * >Notice: Starting from July 4, 2026, some request parameters will no longer take effect. For change details and alternative parameter descriptions, see [Announcement on OpenAPI parameter changes and API deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
746
+ * ### Generate OpenAPI request parameters from the console
747
+ * When you call the CreateCluster operation to create a cluster, if the API call fails due to incorrect request parameter combinations, you can generate the required request parameter combinations from the console. Perform the following steps:
748
+ * 1. Log on to the [Container Service console](https://csnew.console.aliyun.com) and choose **Cluster List** in the left-side navigation pane.
749
+ * 1. On the **Cluster List** page, click **Cluster Template**.
750
+ * 1. In the dialog box, select the cluster type that you want to create, click Create, and then configure the cluster information on the cluster configuration page.
751
+ * 1. After the configuration is complete, on the **Confirm Configuration** page, click **Equivalent Code** in the upper-right corner. The dialog box displays the parameter combinations required to create the cluster, which you can copy and use.
752
+ * >Notice: Starting from July 4, 2026, some request parameters will no longer take effect. For details about the changes and override parameter descriptions, see [Notice on changes to OpenAPI parameters and offline of OpenAPIs for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
753
753
  *
754
754
  * @param request - CreateClusterRequest
755
755
  * @param headers - map
@@ -1086,16 +1086,16 @@ class Client extends openapi_core_1.default {
1086
1086
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateClusterResponse({}));
1087
1087
  }
1088
1088
  /**
1089
- * You can create ACK clusters through OpenAPI, including ACK managed clusters, ACK Serverless clusters, ACK Edge clusters, and registered clusters. When creating a cluster, you will configure the cluster information, cluster components, and ACK-related cloud resources.
1089
+ * Creates an ACK cluster, including ACK managed clusters, ACK Serverless clusters, ACK Edge clusters, and registered clusters. When creating a cluster, you configure cluster information, cluster components, and ACK-related cloud resources.
1090
1090
  *
1091
1091
  * @remarks
1092
- * ### Generate OpenAPI request parameters through the console
1093
- * When calling the CreateCluster API to create a cluster, if the API call fails due to incorrect request parameter combinations, you can generate the required request parameter combinations through the console. Follow these steps:
1094
- * 1. Log in to the [Container Service management console](https://csnew.console.aliyun.com) and choose **Clusters** in the left navigation pane.
1095
- * 1. On the **Clusters** page, click **Cluster Template**.
1096
- * 1. In the dialog box, select the cluster type to create, click Create, and then configure the cluster information on the cluster configuration page.
1097
- * 1. After the configuration is complete, on the **Confirm Configuration** page, click **Equivalent Code** in the upper-right corner. The dialog box will display the parameter combinations required for creating the cluster, which you can copy and use.
1098
- * >Notice: Starting from July 4, 2026, some request parameters will no longer take effect. For change details and alternative parameter descriptions, see [Announcement on OpenAPI parameter changes and API deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
1092
+ * ### Generate OpenAPI request parameters from the console
1093
+ * When you call the CreateCluster operation to create a cluster, if the API call fails due to incorrect request parameter combinations, you can generate the required request parameter combinations from the console. Perform the following steps:
1094
+ * 1. Log on to the [Container Service console](https://csnew.console.aliyun.com) and choose **Cluster List** in the left-side navigation pane.
1095
+ * 1. On the **Cluster List** page, click **Cluster Template**.
1096
+ * 1. In the dialog box, select the cluster type that you want to create, click Create, and then configure the cluster information on the cluster configuration page.
1097
+ * 1. After the configuration is complete, on the **Confirm Configuration** page, click **Equivalent Code** in the upper-right corner. The dialog box displays the parameter combinations required to create the cluster, which you can copy and use.
1098
+ * >Notice: Starting from July 4, 2026, some request parameters will no longer take effect. For details about the changes and override parameter descriptions, see [Notice on changes to OpenAPI parameters and offline of OpenAPIs for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
1099
1099
  *
1100
1100
  * @param request - CreateClusterRequest
1101
1101
  * @returns CreateClusterResponse
@@ -1199,7 +1199,7 @@ class Client extends openapi_core_1.default {
1199
1199
  return await this.createClusterInspectConfigWithOptions(clusterId, request, headers, runtime);
1200
1200
  }
1201
1201
  /**
1202
- * A node pool is a logical collection of nodes that share the same attributes, allowing unified management and operations such as node upgrades and elastic scaling. You can further use the automated O&M capabilities of node pools, including automatic OS CVE vulnerability patching, automatic faulty node recovery, and automatic kubelet and containerd version upgrades, to reduce O&M costs. You can call CreateClusterNodePool to create a node pool for a cluster.
1202
+ * Creates a node pool for a cluster. A node pool is a logical collection of nodes that share the same attributes, allowing unified management and O&M operations such as node upgrades and elastic scaling. You can further leverage the automated O&M capabilities of node pools, including automatic OS CVE vulnerability patching, automatic faulty node recovery, and automatic kubelet and containerd version upgrades, to reduce O&M costs.
1203
1203
  *
1204
1204
  * @param request - CreateClusterNodePoolRequest
1205
1205
  * @param headers - map
@@ -1275,7 +1275,7 @@ class Client extends openapi_core_1.default {
1275
1275
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateClusterNodePoolResponse({}));
1276
1276
  }
1277
1277
  /**
1278
- * A node pool is a logical collection of nodes that share the same attributes, allowing unified management and operations such as node upgrades and elastic scaling. You can further use the automated O&M capabilities of node pools, including automatic OS CVE vulnerability patching, automatic faulty node recovery, and automatic kubelet and containerd version upgrades, to reduce O&M costs. You can call CreateClusterNodePool to create a node pool for a cluster.
1278
+ * Creates a node pool for a cluster. A node pool is a logical collection of nodes that share the same attributes, allowing unified management and O&M operations such as node upgrades and elastic scaling. You can further leverage the automated O&M capabilities of node pools, including automatic OS CVE vulnerability patching, automatic faulty node recovery, and automatic kubelet and containerd version upgrades, to reduce O&M costs.
1279
1279
  *
1280
1280
  * @param request - CreateClusterNodePoolRequest
1281
1281
  * @returns CreateClusterNodePoolResponse
@@ -2428,7 +2428,7 @@ class Client extends openapi_core_1.default {
2428
2428
  return await this.describeClusterAttachScriptsWithOptions(ClusterId, request, headers, runtime);
2429
2429
  }
2430
2430
  /**
2431
- * You can call the DescribeClusterDetail API to query the detailed information of a specified cluster by cluster ID.
2431
+ * Queries the details of a specified cluster by cluster ID.
2432
2432
  *
2433
2433
  * @param headers - map
2434
2434
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2452,7 +2452,7 @@ class Client extends openapi_core_1.default {
2452
2452
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeClusterDetailResponse({}));
2453
2453
  }
2454
2454
  /**
2455
- * You can call the DescribeClusterDetail API to query the detailed information of a specified cluster by cluster ID.
2455
+ * Queries the details of a specified cluster by cluster ID.
2456
2456
  * @returns DescribeClusterDetailResponse
2457
2457
  */
2458
2458
  async describeClusterDetail(ClusterId) {
@@ -2581,7 +2581,15 @@ class Client extends openapi_core_1.default {
2581
2581
  return await this.describeClusterNodePoolDetailWithOptions(ClusterId, NodepoolId, headers, runtime);
2582
2582
  }
2583
2583
  /**
2584
- * Queries all node pools in a cluster.
2584
+ * Queries the list of all node pools in a cluster.
2585
+ *
2586
+ * @remarks
2587
+ * - When removing nodes, perform standardized operations through this API or the [Container Service console](https://cs.console.aliyun.com). Do not manually remove nodes by using `kubectl delete node`.
2588
+ * - Do not directly release nodes, remove instances, or allow nodes to be passively released due to subscription instance expires in the ECS or ESS console (or through related APIs). In these cases, nodes are directly stopped and automatically removed from the Container Service console.
2589
+ * - If the node pool has a desired node count configured, the node pool automatically scales out other instances based on the corresponding configuration to maintain the node count at the desired number.
2590
+ * - Removing nodes involves Pod migration, which may affect your services. Perform this operation during off-peak hours. Unexpected risks may occur during the operation. Back up relevant data in advance.
2591
+ * - When removing nodes, ACK executes a drain operation. Ensure that other nodes in the cluster have sufficient resources to avoid application Pods that cannot be scheduling.
2592
+ * - Check the node affinity rules and scheduling policies of Pods on the nodes to be removed to ensure that Pods are not left unschedulable after node removal.
2585
2593
  *
2586
2594
  * @param request - DescribeClusterNodePoolsRequest
2587
2595
  * @param headers - map
@@ -2612,7 +2620,15 @@ class Client extends openapi_core_1.default {
2612
2620
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeClusterNodePoolsResponse({}));
2613
2621
  }
2614
2622
  /**
2615
- * Queries all node pools in a cluster.
2623
+ * Queries the list of all node pools in a cluster.
2624
+ *
2625
+ * @remarks
2626
+ * - When removing nodes, perform standardized operations through this API or the [Container Service console](https://cs.console.aliyun.com). Do not manually remove nodes by using `kubectl delete node`.
2627
+ * - Do not directly release nodes, remove instances, or allow nodes to be passively released due to subscription instance expires in the ECS or ESS console (or through related APIs). In these cases, nodes are directly stopped and automatically removed from the Container Service console.
2628
+ * - If the node pool has a desired node count configured, the node pool automatically scales out other instances based on the corresponding configuration to maintain the node count at the desired number.
2629
+ * - Removing nodes involves Pod migration, which may affect your services. Perform this operation during off-peak hours. Unexpected risks may occur during the operation. Back up relevant data in advance.
2630
+ * - When removing nodes, ACK executes a drain operation. Ensure that other nodes in the cluster have sufficient resources to avoid application Pods that cannot be scheduling.
2631
+ * - Check the node affinity rules and scheduling policies of Pods on the nodes to be removed to ensure that Pods are not left unschedulable after node removal.
2616
2632
  *
2617
2633
  * @param request - DescribeClusterNodePoolsRequest
2618
2634
  * @returns DescribeClusterNodePoolsResponse
@@ -5141,10 +5157,10 @@ class Client extends openapi_core_1.default {
5141
5157
  return await this.modifyAutoRepairPolicyWithOptions(clusterId, policyId, request, headers, runtime);
5142
5158
  }
5143
5159
  /**
5144
- * You can call the ModifyCluster operation to modify the configuration of an ACK cluster.
5160
+ * Modifies the configuration of an ACK cluster.
5145
5161
  *
5146
5162
  * @remarks
5147
- * <notice>Starting from July 04, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For details about the changes, see [Announcement on Changes to ACK Cluster Management OpenAPI Parameters and OpenAPI Deprecation](https://help.aliyun.com/document_detail/2932733.html).</notice>
5163
+ * <notice>Starting July 4, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For more information about the changes, see [Announcement on changes to OpenAPI request and response parameters and OpenAPI deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
5148
5164
  *
5149
5165
  * @param request - ModifyClusterRequest
5150
5166
  * @param headers - map
@@ -5166,6 +5182,9 @@ class Client extends openapi_core_1.default {
5166
5182
  if (!$dara.isNull(request.apiServerEipId)) {
5167
5183
  body["api_server_eip_id"] = request.apiServerEipId;
5168
5184
  }
5185
+ if (!$dara.isNull(request.clientToken)) {
5186
+ body["client_token"] = request.clientToken;
5187
+ }
5169
5188
  if (!$dara.isNull(request.clusterName)) {
5170
5189
  body["cluster_name"] = request.clusterName;
5171
5190
  }
@@ -5232,10 +5251,10 @@ class Client extends openapi_core_1.default {
5232
5251
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.ModifyClusterResponse({}));
5233
5252
  }
5234
5253
  /**
5235
- * You can call the ModifyCluster operation to modify the configuration of an ACK cluster.
5254
+ * Modifies the configuration of an ACK cluster.
5236
5255
  *
5237
5256
  * @remarks
5238
- * <notice>Starting from July 04, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For details about the changes, see [Announcement on Changes to ACK Cluster Management OpenAPI Parameters and OpenAPI Deprecation](https://help.aliyun.com/document_detail/2932733.html).</notice>
5257
+ * <notice>Starting July 4, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For more information about the changes, see [Announcement on changes to OpenAPI request and response parameters and OpenAPI deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
5239
5258
  *
5240
5259
  * @param request - ModifyClusterRequest
5241
5260
  * @returns ModifyClusterResponse
@@ -5300,7 +5319,10 @@ class Client extends openapi_core_1.default {
5300
5319
  return await this.modifyClusterAddonWithOptions(clusterId, componentId, request, headers, runtime);
5301
5320
  }
5302
5321
  /**
5303
- * Updates the configuration of a node pool based on the node pool ID by calling the ModifyClusterNodePool operation.
5322
+ * Modifies the configuration of a node pool based on the node pool ID by calling the ModifyClusterNodePool operation.
5323
+ *
5324
+ * @remarks
5325
+ * <notice>Starting from July 4, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For more information about the changes, see [Notice on changes to OpenAPI request and response parameters and OpenAPI deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
5304
5326
  *
5305
5327
  * @param request - ModifyClusterNodePoolRequest
5306
5328
  * @param headers - map
@@ -5355,7 +5377,10 @@ class Client extends openapi_core_1.default {
5355
5377
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.ModifyClusterNodePoolResponse({}));
5356
5378
  }
5357
5379
  /**
5358
- * Updates the configuration of a node pool based on the node pool ID by calling the ModifyClusterNodePool operation.
5380
+ * Modifies the configuration of a node pool based on the node pool ID by calling the ModifyClusterNodePool operation.
5381
+ *
5382
+ * @remarks
5383
+ * <notice>Starting from July 4, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For more information about the changes, see [Notice on changes to OpenAPI request and response parameters and OpenAPI deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
5359
5384
  *
5360
5385
  * @param request - ModifyClusterNodePoolRequest
5361
5386
  * @returns ModifyClusterNodePoolResponse