@alicloud/cs20151215 7.0.2 → 7.0.4

package/src/client.ts

@@ -774,16 +774,16 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 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.
+   * 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.
    * 
    * @remarks
-   * ### Generate OpenAPI request parameters through the console
-   * 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:
-   * 1. Log in to the [Container Service management console](https://csnew.console.aliyun.com) and choose **Clusters** in the left navigation pane.
-   * 1. On the **Clusters** page, click **Cluster Template**.
-   * 1. In the dialog box, select the cluster type to create, click Create, and then configure the cluster information on the cluster configuration page.
-   * 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.
-   * >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>
+   * ### Generate OpenAPI request parameters from the console
+   * 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:
+   * 1. Log on to the [Container Service console](https://csnew.console.aliyun.com) and choose **Cluster List** in the left-side navigation pane.
+   * 1. On the **Cluster List** page, click **Cluster Template**.
+   * 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.
+   * 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.
+   * >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>
    * 
    * @param request - CreateClusterRequest
    * @param headers - map
@@ -1224,16 +1224,16 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 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.
+   * 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.
    * 
    * @remarks
-   * ### Generate OpenAPI request parameters through the console
-   * 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:
-   * 1. Log in to the [Container Service management console](https://csnew.console.aliyun.com) and choose **Clusters** in the left navigation pane.
-   * 1. On the **Clusters** page, click **Cluster Template**.
-   * 1. In the dialog box, select the cluster type to create, click Create, and then configure the cluster information on the cluster configuration page.
-   * 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.
-   * >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>
+   * ### Generate OpenAPI request parameters from the console
+   * 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:
+   * 1. Log on to the [Container Service console](https://csnew.console.aliyun.com) and choose **Cluster List** in the left-side navigation pane.
+   * 1. On the **Cluster List** page, click **Cluster Template**.
+   * 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.
+   * 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.
+   * >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>
    * 
    * @param request - CreateClusterRequest
    * @returns CreateClusterResponse
@@ -1347,7 +1347,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 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.
+   * 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.
    * 
    * @param request - CreateClusterNodePoolRequest
    * @param headers - map
@@ -1440,7 +1440,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 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.
+   * 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.
    * 
    * @param request - CreateClusterNodePoolRequest
    * @returns CreateClusterNodePoolResponse
@@ -2696,7 +2696,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the DescribeClusterDetail API to query the detailed information of a specified cluster by cluster ID.
+   * Queries the details of a specified cluster by cluster ID.
    * 
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2721,7 +2721,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the DescribeClusterDetail API to query the detailed information of a specified cluster by cluster ID.
+   * Queries the details of a specified cluster by cluster ID.
    * @returns DescribeClusterDetailResponse
    */
   async describeClusterDetail(ClusterId: string): Promise<$_model.DescribeClusterDetailResponse> {
@@ -2862,7 +2862,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries all node pools in a cluster.
+   * Queries the list of all node pools in a cluster.
+   * 
+   * @remarks
+   * - 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`.
+   * - 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.
+   * - 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.
+   * - 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.
+   * - 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.
+   * - 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.
    * 
    * @param request - DescribeClusterNodePoolsRequest
    * @param headers - map
@@ -2895,7 +2903,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries all node pools in a cluster.
+   * Queries the list of all node pools in a cluster.
+   * 
+   * @remarks
+   * - 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`.
+   * - 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.
+   * - 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.
+   * - 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.
+   * - 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.
+   * - 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.
    * 
    * @param request - DescribeClusterNodePoolsRequest
    * @returns DescribeClusterNodePoolsResponse
@@ -5659,10 +5675,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the ModifyCluster operation to modify the configuration of an ACK cluster.
+   * Modifies the configuration of an ACK cluster.
    * 
    * @remarks
-   * <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>
+   * <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>
    * 
    * @param request - ModifyClusterRequest
    * @param headers - map
@@ -5688,6 +5704,10 @@ export default class Client extends OpenApi {
       body["api_server_eip_id"] = request.apiServerEipId;
     }
 
+    if (!$dara.isNull(request.clientToken)) {
+      body["client_token"] = request.clientToken;
+    }
+
     if (!$dara.isNull(request.clusterName)) {
       body["cluster_name"] = request.clusterName;
     }
@@ -5771,10 +5791,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the ModifyCluster operation to modify the configuration of an ACK cluster.
+   * Modifies the configuration of an ACK cluster.
    * 
    * @remarks
-   * <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>
+   * <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>
    * 
    * @param request - ModifyClusterRequest
    * @returns ModifyClusterResponse
@@ -5843,7 +5863,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Updates the configuration of a node pool based on the node pool ID by calling the ModifyClusterNodePool operation.
+   * Modifies the configuration of a node pool based on the node pool ID by calling the ModifyClusterNodePool operation.
+   * 
+   * @remarks
+   * <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>
    * 
    * @param request - ModifyClusterNodePoolRequest
    * @param headers - map
@@ -5908,7 +5931,10 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Updates the configuration of a node pool based on the node pool ID by calling the ModifyClusterNodePool operation.
+   * Modifies the configuration of a node pool based on the node pool ID by calling the ModifyClusterNodePool operation.
+   * 
+   * @remarks
+   * <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>
    * 
    * @param request - ModifyClusterNodePoolRequest
    * @returns ModifyClusterNodePoolResponse