@alicloud/cs20151215 6.6.4 → 6.6.5

package/src/client.ts

@@ -64,6 +64,9 @@ export default class Client extends OpenApi {
   /**
    * Adds existing Elastic Compute Service (ECS) instances to a Container Service for Kubernetes (ACK) cluster. When you need to add an ECS instance as a worker node to an ACK cluster or re-add a worker node to the cluster, you can call this operation.
    * 
+   * @remarks
+   * 调用本接口前，请仔细阅读[使用限制](https://help.aliyun.com/document_detail/86919.html)，确保待添加的ECS实例满足条件。
+   * 
    * @param request - AttachInstancesRequest
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -145,6 +148,9 @@ export default class Client extends OpenApi {
   /**
    * Adds existing Elastic Compute Service (ECS) instances to a Container Service for Kubernetes (ACK) cluster. When you need to add an ECS instance as a worker node to an ACK cluster or re-add a worker node to the cluster, you can call this operation.
    * 
+   * @remarks
+   * 调用本接口前，请仔细阅读[使用限制](https://help.aliyun.com/document_detail/86919.html)，确保待添加的ECS实例满足条件。
+   * 
    * @param request - AttachInstancesRequest
    * @returns AttachInstancesResponse
    */
@@ -564,7 +570,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates an auto-repair policy.
+   * Create a self-healing rule.
+   * 
+   * @remarks
+   * >Notice: 
+   * This API is not yet available.
    * 
    * @param request - CreateAutoRepairPolicyRequest
    * @param headers - map
@@ -609,7 +619,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates an auto-repair policy.
+   * Create a self-healing rule.
+   * 
+   * @remarks
+   * >Notice: 
+   * This API is not yet available.
    * 
    * @param request - CreateAutoRepairPolicyRequest
    * @returns CreateAutoRepairPolicyResponse
@@ -621,7 +635,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates a scaling configuration to allow the system to scale resources based on the given scaling rules. When you create a scaling configuration, you can specify the scaling metrics, thresholds, scaling order, and scaling interval.
+   * Create an auto scaling policy to automatically add or remove compute resources based on configured scaling rules to handle your cluster\\"s workload. You can specify metrics and thresholds, scaling order, a cooldown period, and more.
    * 
    * @param request - CreateAutoscalingConfigRequest
    * @param headers - map
@@ -714,7 +728,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates a scaling configuration to allow the system to scale resources based on the given scaling rules. When you create a scaling configuration, you can specify the scaling metrics, thresholds, scaling order, and scaling interval.
+   * Create an auto scaling policy to automatically add or remove compute resources based on configured scaling rules to handle your cluster\\"s workload. You can specify metrics and thresholds, scaling order, a cooldown period, and more.
    * 
    * @param request - CreateAutoscalingConfigRequest
    * @returns CreateAutoscalingConfigResponse
@@ -726,16 +740,17 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates a Container Service for Kubernetes (ACK) cluster. For example, you can create an ACK managed cluster, ACK Serverless cluster, ACK Edge cluster, or registered cluster. When you create an ACK cluster, you need to configure the cluster information, components, and cloud resources used by ACK.
+   * Create an ACK cluster using OpenAPI. Supported cluster types include ACK managed clusters, ACK serverless clusters, ACK Edge clusters, and registered clusters. When creating a cluster, configure the cluster information, components, and related Alibaba Cloud resources.
    * 
    * @remarks
-   * ### [](#-openapi-)Generate API request parameters through the ACK console
-   * When calling the CreateCluster operation to create a cluster, if the API call fails due to invalid parameter settings, you can generate valid request parameters through the ACK console. Follow these steps:
-   * 1.  Log on to the [ACK console](https://csnew.console.aliyun.com). In the left-side navigation pane, click **Clusters**.
-   * 2.  On the **Clusters** page, click **Cluster Templates**.
-   * 3.  In the Select Cluster Template dialog box, select the type of cluster you want to create and click Create. Then, configure the cluster parameters.
-   * 4.  In the **Confirm** step, click **Generate API Request Parameters**.
-   *     The API request parameters are displayed in the API Request Parameters dialog box.
+   * ### Generate OpenAPI request parameters in the console
+   * If your CreateCluster API call fails due to invalid parameter combinations, you can generate valid request parameters directly in the console. Follow these steps:
+   * 1. Log on to the [Container Service for Kubernetes console](https://csnew.console.aliyun.com). In the left navigation pane, select **Clusters**.
+   * 2. On the **Clusters** page, click **Cluster Templates**.
+   * 3. In the dialog box, select the cluster type you want to create and click Create. Then configure your cluster on the cluster configuration page.
+   * 4. After completing your configuration, go to the **Review Configuration** page and click **Equivalent Code** in the upper-right corner. The dialog box displays the required parameter combination for cluster creation. Copy and use it as needed.
+   * >Notice: 
+   * Starting July 4, 2026, some request parameters will no longer take effect. For details about the changes and replacement parameters, see [Announcement on Changes and Deprecation of OpenAPI Parameters for ACK Cluster Management](https://help.aliyun.com/document_detail/2932733.html).
    * 
    * @param request - CreateClusterRequest
    * @param headers - map
@@ -1176,16 +1191,17 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates a Container Service for Kubernetes (ACK) cluster. For example, you can create an ACK managed cluster, ACK Serverless cluster, ACK Edge cluster, or registered cluster. When you create an ACK cluster, you need to configure the cluster information, components, and cloud resources used by ACK.
+   * Create an ACK cluster using OpenAPI. Supported cluster types include ACK managed clusters, ACK serverless clusters, ACK Edge clusters, and registered clusters. When creating a cluster, configure the cluster information, components, and related Alibaba Cloud resources.
    * 
    * @remarks
-   * ### [](#-openapi-)Generate API request parameters through the ACK console
-   * When calling the CreateCluster operation to create a cluster, if the API call fails due to invalid parameter settings, you can generate valid request parameters through the ACK console. Follow these steps:
-   * 1.  Log on to the [ACK console](https://csnew.console.aliyun.com). In the left-side navigation pane, click **Clusters**.
-   * 2.  On the **Clusters** page, click **Cluster Templates**.
-   * 3.  In the Select Cluster Template dialog box, select the type of cluster you want to create and click Create. Then, configure the cluster parameters.
-   * 4.  In the **Confirm** step, click **Generate API Request Parameters**.
-   *     The API request parameters are displayed in the API Request Parameters dialog box.
+   * ### Generate OpenAPI request parameters in the console
+   * If your CreateCluster API call fails due to invalid parameter combinations, you can generate valid request parameters directly in the console. Follow these steps:
+   * 1. Log on to the [Container Service for Kubernetes console](https://csnew.console.aliyun.com). In the left navigation pane, select **Clusters**.
+   * 2. On the **Clusters** page, click **Cluster Templates**.
+   * 3. In the dialog box, select the cluster type you want to create and click Create. Then configure your cluster on the cluster configuration page.
+   * 4. After completing your configuration, go to the **Review Configuration** page and click **Equivalent Code** in the upper-right corner. The dialog box displays the required parameter combination for cluster creation. Copy and use it as needed.
+   * >Notice: 
+   * Starting July 4, 2026, some request parameters will no longer take effect. For details about the changes and replacement parameters, see [Announcement on Changes and Deprecation of OpenAPI Parameters for ACK Cluster Management](https://help.aliyun.com/document_detail/2932733.html).
    * 
    * @param request - CreateClusterRequest
    * @returns CreateClusterResponse
@@ -1299,7 +1315,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates a node pool for a Container Service for Kubernetes (ACK) cluster. You can use node pools to facilitate node management. For example, you can schedule, configure, or maintain nodes by node pool, and enable auto scaling for a node pool. We recommend that you use a managed node pool, which can help automate specific O\\\\\\\\\\\\&M tasks for nodes, such as Common Vulnerabilities and Exposures (CVE) patching and node repair. This reduces your O\\\\\\\\\\\\&M workload.
+   * A node pool is a logical collection of nodes that share the same properties, enabling unified management and O&M operations such as node upgrades and Auto Scaling. You can further leverage the automated O&M capabilities of node pools to reduce operational costs—for example, by automatically patching OS CVE vulnerabilities, automatically recovering failed nodes, and automatically upgrading kubelet and containerd versions. You can invoke CreateClusterNodePool to create a node pool for a cluster.
    * 
    * @param request - CreateClusterNodePoolRequest
    * @param headers - map
@@ -1392,7 +1408,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Creates a node pool for a Container Service for Kubernetes (ACK) cluster. You can use node pools to facilitate node management. For example, you can schedule, configure, or maintain nodes by node pool, and enable auto scaling for a node pool. We recommend that you use a managed node pool, which can help automate specific O\\\\\\\\\\\\&M tasks for nodes, such as Common Vulnerabilities and Exposures (CVE) patching and node repair. This reduces your O\\\\\\\\\\\\&M workload.
+   * A node pool is a logical collection of nodes that share the same properties, enabling unified management and O&M operations such as node upgrades and Auto Scaling. You can further leverage the automated O&M capabilities of node pools to reduce operational costs—for example, by automatically patching OS CVE vulnerabilities, automatically recovering failed nodes, and automatically upgrading kubelet and containerd versions. You can invoke CreateClusterNodePool to create a node pool for a cluster.
    * 
    * @param request - CreateClusterNodePoolRequest
    * @returns CreateClusterNodePoolResponse
@@ -1529,6 +1545,9 @@ export default class Client extends OpenApi {
   /**
    * Creates a trigger for an application to redeploy the application pods when specific conditions are met.
    * 
+   * @remarks
+   * > 创建触发器仅支持Pod的重新部署。
+   * 
    * @param request - CreateTriggerRequest
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -1574,6 +1593,9 @@ export default class Client extends OpenApi {
   /**
    * Creates a trigger for an application to redeploy the application pods when specific conditions are met.
    * 
+   * @remarks
+   * > 创建触发器仅支持Pod的重新部署。
+   * 
    * @param request - CreateTriggerRequest
    * @returns CreateTriggerResponse
    */
@@ -1584,7 +1606,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Deletes one or more ACK alert contacts.
+   * Deletes ACK alert contacts.
    * 
    * @param tmpReq - DeleteAlertContactRequest
    * @param headers - map
@@ -1623,7 +1645,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Deletes one or more ACK alert contacts.
+   * Deletes ACK alert contacts.
    * 
    * @param request - DeleteAlertContactRequest
    * @returns DeleteAlertContactResponse
@@ -1686,7 +1708,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询自愈规则
+   * Deletes an auto repair policy.
+   * 
+   * @remarks
+   * >Notice: 
+   * This API is not yet publicly available.
    * 
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -1711,7 +1737,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询自愈规则
+   * Deletes an auto repair policy.
+   * 
+   * @remarks
+   * >Notice: 
+   * This API is not yet publicly available.
    * @returns DeleteAutoRepairPolicyResponse
    */
   async deleteAutoRepairPolicy(clusterId: string, policyId: string): Promise<$_model.DeleteAutoRepairPolicyResponse> {
@@ -1721,15 +1751,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the DeleteCluster operation to delete a cluster and specify whether to delete or retain the relevant cluster resources. Before you delete a cluster, you must manually delete workloads in the cluster, such as Deployments, StatefulSets, Jobs, and CronJobs. Otherwise, you may fail to delete the cluster.
+   * When you no longer need a cluster, you can delete it and choose whether to delete or retain its associated resources. Before deleting a cluster, you must manually remove its workloads, such as stateless applications, stateful applications, jobs, and cronjobs. Otherwise, the deletion might fail.
    * 
    * @remarks
-   * Warning:
-   * *   Subscription ECS instances and Lingjun nodes in a cluster cannot be automatically released. To avoid unnecessary costs, we recommend that you manually release the resources. For more information, see \\<a href="{0}" target="_blank">Rules for deleting clusters and releasing nodes\\</a>.
-   * *   If the SLB instance of the API server uses the subscription billing method, it cannot be automatically released. To avoid unnecessary costs, we recommend that you manually release it.
-   * *   By default, virtual private clouds (VPCs), vSwitches, security groups, and RAM roles are retained if they are used by other resources. To avoid unnecessary costs, we recommend that you manually release the resources.
-   * *   Elastic container instances created on virtual nodes are automatically released.
-   * *   Some resources created together with a cluster are not automatically released when the cluster is deleted. After the cluster is deleted, you are still charged for the resources. Release or retain the resources based on your actual needs. The resources include Simple Log Service projects automatically created by the cluster and dynamically provisioned disks.
+   * Important
+   * - Subscription-based resources, such as ECS instances and Lingjun computing nodes, are not automatically released. You must manually release them to avoid unnecessary charges. For more details, see Cluster deletion and node release rules.
+   * - Subscription-based APIServer SLB resources are not automatically released. You must manually release them to avoid unnecessary charges.
+   * - If resources such as VPCs, VSwitches, security groups, and RAM roles are in use by other resources, they are retained by default. You must release them manually.
+   * - ECIs created with virtual nodes are automatically released.
+   * - Some cloud resources created with the cluster are not automatically released when you delete the cluster and continue to incur charges. You can choose to retain or release them. These resources include SLS projects automatically created by the cluster and cloud disks purchased via dynamic volumes.
    * 
    * @param tmpReq - DeleteClusterRequest
    * @param headers - map
@@ -1784,15 +1814,15 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the DeleteCluster operation to delete a cluster and specify whether to delete or retain the relevant cluster resources. Before you delete a cluster, you must manually delete workloads in the cluster, such as Deployments, StatefulSets, Jobs, and CronJobs. Otherwise, you may fail to delete the cluster.
+   * When you no longer need a cluster, you can delete it and choose whether to delete or retain its associated resources. Before deleting a cluster, you must manually remove its workloads, such as stateless applications, stateful applications, jobs, and cronjobs. Otherwise, the deletion might fail.
    * 
    * @remarks
-   * Warning:
-   * *   Subscription ECS instances and Lingjun nodes in a cluster cannot be automatically released. To avoid unnecessary costs, we recommend that you manually release the resources. For more information, see \\<a href="{0}" target="_blank">Rules for deleting clusters and releasing nodes\\</a>.
-   * *   If the SLB instance of the API server uses the subscription billing method, it cannot be automatically released. To avoid unnecessary costs, we recommend that you manually release it.
-   * *   By default, virtual private clouds (VPCs), vSwitches, security groups, and RAM roles are retained if they are used by other resources. To avoid unnecessary costs, we recommend that you manually release the resources.
-   * *   Elastic container instances created on virtual nodes are automatically released.
-   * *   Some resources created together with a cluster are not automatically released when the cluster is deleted. After the cluster is deleted, you are still charged for the resources. Release or retain the resources based on your actual needs. The resources include Simple Log Service projects automatically created by the cluster and dynamically provisioned disks.
+   * Important
+   * - Subscription-based resources, such as ECS instances and Lingjun computing nodes, are not automatically released. You must manually release them to avoid unnecessary charges. For more details, see Cluster deletion and node release rules.
+   * - Subscription-based APIServer SLB resources are not automatically released. You must manually release them to avoid unnecessary charges.
+   * - If resources such as VPCs, VSwitches, security groups, and RAM roles are in use by other resources, they are retained by default. You must release them manually.
+   * - ECIs created with virtual nodes are automatically released.
+   * - Some cloud resources created with the cluster are not automatically released when you delete the cluster and continue to incur charges. You can choose to retain or release them. These resources include SLS projects automatically created by the cluster and cloud disks purchased via dynamic volumes.
    * 
    * @param request - DeleteClusterRequest
    * @returns DeleteClusterResponse
@@ -2108,7 +2138,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Deploys a policy in the specified namespaces of a specific Container Service for Kubernetes (ACK) cluster. You can create and deploy a security policy by specifying the policy type, action of the policy such as alerting or denying, and namespaces to which the policy applies.
+   * Call the `DeployPolicyInstance` operation to deploy a policy instance to specified namespaces in an ACK cluster. To create a policy instance, select a security policy, configure a governance action (alert or deny), and specify the target namespaces for the policy.
    * 
    * @param request - DeployPolicyInstanceRequest
    * @param headers - map
@@ -2149,7 +2179,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Deploys a policy in the specified namespaces of a specific Container Service for Kubernetes (ACK) cluster. You can create and deploy a security policy by specifying the policy type, action of the policy such as alerting or denying, and namespaces to which the policy applies.
+   * Call the `DeployPolicyInstance` operation to deploy a policy instance to specified namespaces in an ACK cluster. To create a policy instance, select a security policy, configure a governance action (alert or deny), and specify the target namespaces for the policy.
    * 
    * @param request - DeployPolicyInstanceRequest
    * @returns DeployPolicyInstanceResponse
@@ -2296,7 +2326,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询自愈规则
+   * View self-healing rules.
+   * 
+   * @remarks
+   * >Notice: 
+   * This API is not yet available.
    * 
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2321,7 +2355,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询自愈规则
+   * View self-healing rules.
+   * 
+   * @remarks
+   * >Notice: 
+   * This API is not yet available.
    * @returns DescribeAutoRepairPolicyResponse
    */
   async describeAutoRepairPolicy(clusterId: string, policyId: string): Promise<$_model.DescribeAutoRepairPolicyResponse> {
@@ -2557,7 +2595,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 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.
+   * To manually add existing ECS instances to an ACK cluster as worker nodes or add nodes back to a node pool, call the DescribeClusterAttachScripts operation to obtain the required attachment script.
    * 
    * @param request - DescribeClusterAttachScriptsRequest
    * @param headers - map
@@ -2618,7 +2656,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 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.
+   * To manually add existing ECS instances to an ACK cluster as worker nodes or add nodes back to a node pool, call the DescribeClusterAttachScripts operation to obtain the required attachment script.
    * 
    * @param request - DescribeClusterAttachScriptsRequest
    * @returns DescribeClusterAttachScriptsResponse
@@ -2630,7 +2668,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the DescribeClusterDetail operation to query the details of a Container Service for Kubernetes (ACK) cluster by cluster ID.
+   * You can call the DescribeClusterDetail operation to query detailed information about a specified cluster by its cluster ID.
    * 
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2655,7 +2693,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the DescribeClusterDetail operation to query the details of a Container Service for Kubernetes (ACK) cluster by cluster ID.
+   * You can call the DescribeClusterDetail operation to query detailed information about a specified cluster by its cluster ID.
    * @returns DescribeClusterDetailResponse
    */
   async describeClusterDetail(ClusterId: string): Promise<$_model.DescribeClusterDetailResponse> {
@@ -2665,7 +2703,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries events and event details in a Container Service for Kubernetes (ACK) cluster, including the severity level, status, and start time of each event. Events are generated when clusters created, modified, and updated, node pools are created and scaled out, and components are installed.
+   * Cluster operation events include cluster creation, modification, and upgrades, node pool creation and scale-out, and add-on installations. You can call the `DescribeClusterEvents` operation to retrieve events for a specified cluster and query their details, such as the severity level, status, and time.
    * 
    * @param request - DescribeClusterEventsRequest
    * @param headers - map
@@ -2714,7 +2752,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries events and event details in a Container Service for Kubernetes (ACK) cluster, including the severity level, status, and start time of each event. Events are generated when clusters created, modified, and updated, node pools are created and scaled out, and components are installed.
+   * Cluster operation events include cluster creation, modification, and upgrades, node pool creation and scale-out, and add-on installations. You can call the `DescribeClusterEvents` operation to retrieve events for a specified cluster and query their details, such as the severity level, status, and time.
    * 
    * @param request - DescribeClusterEventsRequest
    * @returns DescribeClusterEventsResponse
@@ -2761,7 +2799,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the DescribeClusterNodePoolDetail.html operation to query the details about a node pool in a cluster by node pool ID.
+   * You can call the DescribeClusterNodePoolDetail operation with a node pool ID to query the configuration of a specific node pool in a cluster.
    * 
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -2786,7 +2824,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the DescribeClusterNodePoolDetail.html operation to query the details about a node pool in a cluster by node pool ID.
+   * You can call the DescribeClusterNodePoolDetail operation with a node pool ID to query the configuration of a specific node pool in a cluster.
    * @returns DescribeClusterNodePoolDetailResponse
    */
   async describeClusterNodePoolDetail(ClusterId: string, NodepoolId: string): Promise<$_model.DescribeClusterNodePoolDetailResponse> {
@@ -2796,7 +2834,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the information about all node pools in a cluster.
+   * Lists all node pools in a cluster.
    * 
    * @param request - DescribeClusterNodePoolsRequest
    * @param headers - map
@@ -2829,7 +2867,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the information about all node pools in a cluster.
+   * Lists all node pools in a cluster.
    * 
    * @param request - DescribeClusterNodePoolsRequest
    * @returns DescribeClusterNodePoolsResponse
@@ -2902,7 +2940,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the DescribeClusterResources operation to query all resources in a cluster by cluster ID.
+   * Container Service for Kubernetes uses other Alibaba Cloud resources, such as VPCs and SLBs. To query the resources associated with a specific cluster, call the `DescribeClusterResources` operation. To query node pools or nodes, call the `DescribeClusterNodePools` or `DescribeClusterNodes` operations.
    * 
    * @param request - DescribeClusterResourcesRequest
    * @param headers - map
@@ -2935,7 +2973,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the DescribeClusterResources operation to query all resources in a cluster by cluster ID.
+   * Container Service for Kubernetes uses other Alibaba Cloud resources, such as VPCs and SLBs. To query the resources associated with a specific cluster, call the `DescribeClusterResources` operation. To query node pools or nodes, call the `DescribeClusterNodePools` or `DescribeClusterNodes` operations.
    * 
    * @param request - DescribeClusterResourcesRequest
    * @returns DescribeClusterResourcesResponse
@@ -2947,7 +2985,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries tasks in a Container Service for Kubernetes (ACK) cluster.
+   * Lists the tasks in a specified cluster.
    * 
    * @param request - DescribeClusterTasksRequest
    * @param headers - map
@@ -2992,7 +3030,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries tasks in a Container Service for Kubernetes (ACK) cluster.
+   * Lists the tasks in a specified cluster.
    * 
    * @param request - DescribeClusterTasksRequest
    * @returns DescribeClusterTasksResponse
@@ -3061,7 +3099,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 获取集群kubeconfig接口
+   * Obtain the kubeconfig API for a cluster
    * 
    * @deprecated OpenAPI DescribeClusterV2UserKubeconfig is deprecated
    * 
@@ -3100,7 +3138,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 获取集群kubeconfig接口
+   * Obtain the kubeconfig API for a cluster
    * 
    * @deprecated OpenAPI DescribeClusterV2UserKubeconfig is deprecated
    * 
@@ -3150,7 +3188,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries all existing clusters in ACK, including Kubernetes clusters and Swarm clusters.
+   * View all clusters (including Swarm and Kubernetes clusters) created in the container service.
    * 
    * @deprecated OpenAPI DescribeClusters is deprecated
    * 
@@ -3193,7 +3231,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries all existing clusters in ACK, including Kubernetes clusters and Swarm clusters.
+   * View all clusters (including Swarm and Kubernetes clusters) created in the container service.
    * 
    * @deprecated OpenAPI DescribeClusters is deprecated
    * 
@@ -3208,7 +3246,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries all clusters in a specified region.
+   * Lists all clusters in a specified region.
    * 
    * @param request - DescribeClustersForRegionRequest
    * @param headers - map
@@ -3265,7 +3303,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries all clusters in a specified region.
+   * Lists all clusters in a specified region.
    * 
    * @param request - DescribeClustersForRegionRequest
    * @returns DescribeClustersForRegionResponse
@@ -3277,7 +3315,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the details about Container Service for Kubernetes (ACK) clusters of specified types or specifications within an account.
+   * Use the DescribeClustersV1 API to list ACK clusters by criteria such as cluster type and cluster specification.
    * 
    * @param request - DescribeClustersV1Request
    * @param headers - map
@@ -3338,7 +3376,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the details about Container Service for Kubernetes (ACK) clusters of specified types or specifications within an account.
+   * Use the DescribeClustersV1 API to list ACK clusters by criteria such as cluster type and cluster specification.
    * 
    * @param request - DescribeClustersV1Request
    * @returns DescribeClustersV1Response
@@ -3350,7 +3388,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the detailed information about a type of events, including the severity level, status, and time. Events are generated when clusters are created, modified, and updated, node pools are created and scaled out, and components are installed.
+   * Cluster operation events include cluster creation, cluster changes, node pool creation, node pool scale-out, add-on installation, and cluster upgrade. Use the `DescribeEvents` API to query details for a specific event type, including its level, status, and timestamp.
    * 
    * @param request - DescribeEventsRequest
    * @param headers - map
@@ -3403,7 +3441,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the detailed information about a type of events, including the severity level, status, and time. Events are generated when clusters are created, modified, and updated, node pools are created and scaled out, and components are installed.
+   * Cluster operation events include cluster creation, cluster changes, node pool creation, node pool scale-out, add-on installation, and cluster upgrade. Use the `DescribeEvents` API to query details for a specific event type, including its level, status, and timestamp.
    * 
    * @param request - DescribeEventsRequest
    * @returns DescribeEventsResponse
@@ -3415,7 +3453,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries all events in a specified region.
+   * Retrieves a list of events in a specified region.
    * 
    * @param request - DescribeEventsForRegionRequest
    * @param headers - map
@@ -3464,7 +3502,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries all events in a specified region.
+   * Retrieves a list of events in a specified region.
    * 
    * @param request - DescribeEventsForRegionRequest
    * @returns DescribeEventsForRegionResponse
@@ -3720,7 +3758,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 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.
+   * Container security policies for ACK clusters provide a rich set of built-in rule libraries, including `Compliance`, `Infra`, `K8s-general`, and `PSP`, to secure containers in a production environment. Call the `DescribePolicyGovernanceInCluster` API to retrieve policy governance details for a target cluster, such as policy statistics by severity, audit logs, and interception and alert events.
    * 
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -3745,7 +3783,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 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.
+   * Container security policies for ACK clusters provide a rich set of built-in rule libraries, including `Compliance`, `Infra`, `K8s-general`, and `PSP`, to secure containers in a production environment. Call the `DescribePolicyGovernanceInCluster` API to retrieve policy governance details for a target cluster, such as policy statistics by severity, audit logs, and interception and alert events.
    * @returns DescribePolicyGovernanceInClusterResponse
    */
   async describePolicyGovernanceInCluster(clusterId: string): Promise<$_model.DescribePolicyGovernanceInClusterResponse> {
@@ -3996,7 +4034,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries detailed information about a task, such as the task type, status, and progress.
+   * Use the DescribeTaskInfo operation to query details about a cluster task, such as its task type, running state, and running stage.
    * 
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -4021,7 +4059,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries detailed information about a task, such as the task type, status, and progress.
+   * Use the DescribeTaskInfo operation to query details about a cluster task, such as its task type, running state, and running stage.
    * @returns DescribeTaskInfoResponse
    */
   async describeTaskInfo(taskId: string): Promise<$_model.DescribeTaskInfoResponse> {
@@ -4769,11 +4807,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * By default, RAM users or roles who aren\\"t cluster creators and haven\\"t been granted full cluster permissions have no RBAC permissions in the cluster. You can call this interface to update RBAC access permissions for RAM users/roles, including accessible resources, permission scopes, and preset roles, for enhanced security control on resources in Container Service for Kubernetes (ACK) clusters.
+   * By default, a RAM user or RAM role has no RBAC permissions in a cluster they did not create, unless granted permissions at the all-clusters scope. Call the GrantPermissions operation to update the RBAC permissions for a RAM user or RAM role. This operation lets you configure accessible resources, permission scopes, and predefined roles to manage cluster access control.
    * 
    * @remarks
-   *   If you use a Resource Access Management (RAM) account to call this operation, make sure it has permissions to modify cluster authorization information for other RAM users or RAM roles. Otherwise, the `StatusForbidden` or `ForbiddenGrantPermissions` error code is returned. For more information, see [Use a RAM user to grant RBAC permissions to other RAM users](https://help.aliyun.com/document_detail/119035.html).
-   * *   This operation overwrites all existing cluster permissions for the target RAM user or RAM role. You must specify all the permissions you want to grant to the RAM user or RAM role in the request.
+   * - If you call this operation as a RAM user, you must have permission to modify the cluster permissions of other RAM users or RAM roles. Otherwise, the API call fails and returns the `StatusForbidden` or `ForbiddenGrantPermissions` error code. For more information, see [Authorize a RAM user to manage the RBAC permissions of other RAM users](https://help.aliyun.com/document_detail/119035.html).
+   * - This operation overwrites all existing cluster permissions for the specified RAM user or RAM role. Your request must include the complete set of permissions you want to grant.
    * 
    * @param request - GrantPermissionsRequest
    * @param headers - map
@@ -4801,11 +4839,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * By default, RAM users or roles who aren\\"t cluster creators and haven\\"t been granted full cluster permissions have no RBAC permissions in the cluster. You can call this interface to update RBAC access permissions for RAM users/roles, including accessible resources, permission scopes, and preset roles, for enhanced security control on resources in Container Service for Kubernetes (ACK) clusters.
+   * By default, a RAM user or RAM role has no RBAC permissions in a cluster they did not create, unless granted permissions at the all-clusters scope. Call the GrantPermissions operation to update the RBAC permissions for a RAM user or RAM role. This operation lets you configure accessible resources, permission scopes, and predefined roles to manage cluster access control.
    * 
    * @remarks
-   *   If you use a Resource Access Management (RAM) account to call this operation, make sure it has permissions to modify cluster authorization information for other RAM users or RAM roles. Otherwise, the `StatusForbidden` or `ForbiddenGrantPermissions` error code is returned. For more information, see [Use a RAM user to grant RBAC permissions to other RAM users](https://help.aliyun.com/document_detail/119035.html).
-   * *   This operation overwrites all existing cluster permissions for the target RAM user or RAM role. You must specify all the permissions you want to grant to the RAM user or RAM role in the request.
+   * - If you call this operation as a RAM user, you must have permission to modify the cluster permissions of other RAM users or RAM roles. Otherwise, the API call fails and returns the `StatusForbidden` or `ForbiddenGrantPermissions` error code. For more information, see [Authorize a RAM user to manage the RBAC permissions of other RAM users](https://help.aliyun.com/document_detail/119035.html).
+   * - This operation overwrites all existing cluster permissions for the specified RAM user or RAM role. Your request must include the complete set of permissions you want to grant.
    * 
    * @param request - GrantPermissionsRequest
    * @returns GrantPermissionsResponse
@@ -4975,7 +5013,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * List auto-repair policies.
+   * Returns a list of self-healing rules.
+   * 
+   * @remarks
+   * >Notice: 
+   * This API will be available in a future release.
    * 
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -5000,7 +5042,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * List auto-repair policies.
+   * Returns a list of self-healing rules.
+   * 
+   * @remarks
+   * >Notice: 
+   * This API will be available in a future release.
    * @returns ListAutoRepairPoliciesResponse
    */
   async listAutoRepairPolicies(clusterId: string): Promise<$_model.ListAutoRepairPoliciesResponse> {
@@ -5178,11 +5224,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the kubeconfig files that are issued to users for the current cluster and the status of the kubeconfig files.
+   * If you need to view the access control status of the current cluster, you can invoke the ListClusterKubeconfigStates API to obtain the list and status of KubeConfig configurations that have been issued to users for the current cluster.
    * 
    * @remarks
-   * > - To call this operation, make sure that you have ram:ListUsers and ram:ListRoles permissions.
-   * > - To call this operation, make sure that you have the AliyunCSFullAccess permissions.
+   * > - Invoking this API requires the ram:ListUsers and ram:ListRoles permissions.  
+   * > - Invoking this API requires permissions to manage Container Service (CS) (AliyunCSFullAccess).
    * 
    * @param request - ListClusterKubeconfigStatesRequest
    * @param headers - map
@@ -5223,11 +5269,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Queries the kubeconfig files that are issued to users for the current cluster and the status of the kubeconfig files.
+   * If you need to view the access control status of the current cluster, you can invoke the ListClusterKubeconfigStates API to obtain the list and status of KubeConfig configurations that have been issued to users for the current cluster.
    * 
    * @remarks
-   * > - To call this operation, make sure that you have ram:ListUsers and ram:ListRoles permissions.
-   * > - To call this operation, make sure that you have the AliyunCSFullAccess permissions.
+   * > - Invoking this API requires the ram:ListUsers and ram:ListRoles permissions.  
+   * > - Invoking this API requires permissions to manage Container Service (CS) (AliyunCSFullAccess).
    * 
    * @param request - ListClusterKubeconfigStatesRequest
    * @returns ListClusterKubeconfigStatesResponse
@@ -5288,7 +5334,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 获取单个地域的自动运维执行计划列表
+   * Query the list of the latest 100 automated O&M execution plans in a specified region. When features such as Auto Mode for Intelligent Cluster Management, automatic cluster upgrade, and node pool automated O&M are enabled, you can use this API to query O&M plans automatically generated by the System and their execution status, such as cluster upgrades or CVE fixes for node pools.
    * 
    * @param request - ListOperationPlansForRegionRequest
    * @param headers - map
@@ -5329,7 +5375,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 获取单个地域的自动运维执行计划列表
+   * Query the list of the latest 100 automated O&M execution plans in a specified region. When features such as Auto Mode for Intelligent Cluster Management, automatic cluster upgrade, and node pool automated O&M are enabled, you can use this API to query O&M plans automatically generated by the System and their execution status, such as cluster upgrades or CVE fixes for node pools.
    * 
    * @param request - ListOperationPlansForRegionRequest
    * @returns ListOperationPlansForRegionResponse
@@ -5469,6 +5515,9 @@ export default class Client extends OpenApi {
   /**
    * The Container Service for Kubernetes (ACK) managed Pro cluster type is developed based on the ACK managed Basic cluster type. It inherits all benefits of ACK managed clusters, such as fully-managed control planes and control plane high availability. It further enhances reliability, security, scheduling capabilities, and offers service level agreement (SLA)-backed guarantees, making it ideal for enterprise customers with large-scale production workloads requiring high stability and security. You can call the MigrateCluster operation to migrate an ACK managed Basic cluster to an ACK managed Pro cluster.
    * 
+   * @remarks
+   * ACK托管集群基础版迁移至ACK托管集群Pro版后，将新增[集群管理费用](https://help.aliyun.com/document_detail/462278.html)（由ACK收取），其他云资源计费保持不变。
+   * 
    * @param request - MigrateClusterRequest
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -5506,6 +5555,9 @@ export default class Client extends OpenApi {
   /**
    * The Container Service for Kubernetes (ACK) managed Pro cluster type is developed based on the ACK managed Basic cluster type. It inherits all benefits of ACK managed clusters, such as fully-managed control planes and control plane high availability. It further enhances reliability, security, scheduling capabilities, and offers service level agreement (SLA)-backed guarantees, making it ideal for enterprise customers with large-scale production workloads requiring high stability and security. You can call the MigrateCluster operation to migrate an ACK managed Basic cluster to an ACK managed Pro cluster.
    * 
+   * @remarks
+   * ACK托管集群基础版迁移至ACK托管集群Pro版后，将新增[集群管理费用](https://help.aliyun.com/document_detail/462278.html)（由ACK收取），其他云资源计费保持不变。
+   * 
    * @param request - MigrateClusterRequest
    * @returns MigrateClusterResponse
    */
@@ -5516,7 +5568,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询自愈规则
+   * Modify a self-healing rule
+   * 
+   * @remarks
+   * >Notice: 
+   * This API is not yet available.
    * 
    * @param request - ModifyAutoRepairPolicyRequest
    * @param headers - map
@@ -5553,7 +5609,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * 查询自愈规则
+   * Modify a self-healing rule
+   * 
+   * @remarks
+   * >Notice: 
+   * This API is not yet available.
    * 
    * @param request - ModifyAutoRepairPolicyRequest
    * @returns ModifyAutoRepairPolicyResponse
@@ -5565,7 +5625,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the ModifyCluster operation to modify the cluster configurations by cluster ID.
+   * You can call the ModifyCluster operation to modify the configuration of an ACK cluster.
+   * 
+   * @remarks
+   * >Notice: 
+   * Starting July 4, 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 input and output parameters and deprecation of OpenAPI operations related to ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).
    * 
    * @param request - ModifyClusterRequest
    * @param headers - map
@@ -5674,7 +5738,11 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the ModifyCluster operation to modify the cluster configurations by cluster ID.
+   * You can call the ModifyCluster operation to modify the configuration of an ACK cluster.
+   * 
+   * @remarks
+   * >Notice: 
+   * Starting July 4, 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 input and output parameters and deprecation of OpenAPI operations related to ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).
    * 
    * @param request - ModifyClusterRequest
    * @returns ModifyClusterResponse
@@ -5743,7 +5811,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the ModifyClusterNodePool operation to modify the configuration of a node pool with the specified node pool ID.
+   * You can call the ModifyClusterNodePool API to update the configuration of a node pool by specifying its node pool ID.
    * 
    * @param request - ModifyClusterNodePoolRequest
    * @param headers - map
@@ -5804,7 +5872,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the ModifyClusterNodePool operation to modify the configuration of a node pool with the specified node pool ID.
+   * You can call the ModifyClusterNodePool API to update the configuration of a node pool by specifying its node pool ID.
    * 
    * @param request - ModifyClusterNodePoolRequest
    * @returns ModifyClusterNodePoolResponse
@@ -5818,6 +5886,9 @@ export default class Client extends OpenApi {
   /**
    * 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.
    * 
+   * @remarks
+   * - 该API为全量更新，使用时请注意将完整的目标Tags设定为入参，避免丢失已有Tags。如需增量更新，请使用[TagResources接口为集群绑定标签](https://help.aliyun.com/document_detail/2667969.html)。
+   * 
    * @param request - ModifyClusterTagsRequest
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -5846,6 +5917,9 @@ export default class Client extends OpenApi {
   /**
    * 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.
    * 
+   * @remarks
+   * - 该API为全量更新，使用时请注意将完整的目标Tags设定为入参，避免丢失已有Tags。如需增量更新，请使用[TagResources接口为集群绑定标签](https://help.aliyun.com/document_detail/2667969.html)。
+   * 
    * @param request - ModifyClusterTagsRequest
    * @returns ModifyClusterTagsResponse
    */
@@ -6148,14 +6222,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the RemoveClusterNodes operation to remove nodes from a Container Service for Kubernetes (ACK) cluster.
-   * 
-   * @remarks
-   * ***
-   * *   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.
-   * *   Unknown errors may occur when you remove nodes. Before you remove nodes, back up the data on the nodes.
-   * *   Nodes remain in the Unschedulable state when they are being removed.
-   * *   You can remove only worker nodes. You cannot remove master nodes.
+   * 移除集群节点
    * 
    * @deprecated OpenAPI RemoveClusterNodes is deprecated
    * 
@@ -6198,14 +6265,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the RemoveClusterNodes operation to remove nodes from a Container Service for Kubernetes (ACK) cluster.
-   * 
-   * @remarks
-   * ***
-   * *   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.
-   * *   Unknown errors may occur when you remove nodes. Before you remove nodes, back up the data on the nodes.
-   * *   Nodes remain in the Unschedulable state when they are being removed.
-   * *   You can remove only worker nodes. You cannot remove master nodes.
+   * 移除集群节点
    * 
    * @deprecated OpenAPI RemoveClusterNodes is deprecated
    * 
@@ -6651,11 +6711,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the ScaleOutCluster operation to scale out a cluster by cluster ID.
-   * 
-   * @remarks
-   * *
-   * ****The ScaleOutCluster API operation is phased out. You must call the node pool-related API operations to manage nodes. If you want to add worker nodes to a Container Service for Kubernetes (ACK) cluster, call the ScaleClusterNodePool API operation. For more information, see [ScaleClusterNodePool](https://help.aliyun.com/document_detail/184928.html).
+   * 扩容Kubernetes集群
    * 
    * @param request - ScaleOutClusterRequest
    * @param headers - map
@@ -6768,11 +6824,7 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * You can call the ScaleOutCluster operation to scale out a cluster by cluster ID.
-   * 
-   * @remarks
-   * *
-   * ****The ScaleOutCluster API operation is phased out. You must call the node pool-related API operations to manage nodes. If you want to add worker nodes to a Container Service for Kubernetes (ACK) cluster, call the ScaleClusterNodePool API operation. For more information, see [ScaleClusterNodePool](https://help.aliyun.com/document_detail/184928.html).
+   * 扩容Kubernetes集群
    * 
    * @param request - ScaleOutClusterRequest
    * @returns ScaleOutClusterResponse
@@ -7399,7 +7451,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Updates the Secret encryption at rest configuration for a specified cluster by cluster ID.
+   * Update the configuration of the Secret-at-rest encryption feature for a specified cluster by cluster ID.
+   * 
+   * @remarks
+   * 开启或关闭落盘加密功能的过程中以及成功开启该功能后，请勿使用 KMS 控制台或 OpenAPI 禁用或删除该功能所使用的 KMS 密钥，否则会导致集群 API Server 不可用，继而无法正常获取 Secret 和 ServiceAccount 等对象，影响业务应用的正常运行。更多信息，请参见[使用阿里云KMS进行Secret的落盘加密](https://help.aliyun.com/document_detail/177372.html)。
+   * * 调用该 API 的用户或角色需要额外被授予所需的集群 RBAC 权限（需要被授予运维人员或管理员权限），否则将返回“ForbiddenUpdateKMSState”错误码。
+   * * 成功调用该 API 后，集群状态将被变更为“更新中”，待变更完成后集群状态将恢复为“运行中”。针对同一个集群的变更完成后，需要间隔 5 分钟以上才能再次调用该 API，否则将返回“409”状态码。
    * 
    * @param request - UpdateKMSEncryptionRequest
    * @param headers - map
@@ -7436,7 +7493,12 @@ export default class Client extends OpenApi {
   }
 
   /**
-   * Updates the Secret encryption at rest configuration for a specified cluster by cluster ID.
+   * Update the configuration of the Secret-at-rest encryption feature for a specified cluster by cluster ID.
+   * 
+   * @remarks
+   * 开启或关闭落盘加密功能的过程中以及成功开启该功能后，请勿使用 KMS 控制台或 OpenAPI 禁用或删除该功能所使用的 KMS 密钥，否则会导致集群 API Server 不可用，继而无法正常获取 Secret 和 ServiceAccount 等对象，影响业务应用的正常运行。更多信息，请参见[使用阿里云KMS进行Secret的落盘加密](https://help.aliyun.com/document_detail/177372.html)。
+   * * 调用该 API 的用户或角色需要额外被授予所需的集群 RBAC 权限（需要被授予运维人员或管理员权限），否则将返回“ForbiddenUpdateKMSState”错误码。
+   * * 成功调用该 API 后，集群状态将被变更为“更新中”，待变更完成后集群状态将恢复为“运行中”。针对同一个集群的变更完成后，需要间隔 5 分钟以上才能再次调用该 API，否则将返回“409”状态码。
    * 
    * @param request - UpdateKMSEncryptionRequest
    * @returns UpdateKMSEncryptionResponse
@@ -7515,6 +7577,9 @@ export default class Client extends OpenApi {
   /**
    * Updates the deletion protection status of the specified resources. You can enable or disable deletion protection for namespaces and Services. You can call this operation to enable deletion protection for namespaces or Services that involve businesses-critical and sensitive data to avoid incurring maintenance costs caused by accidental namespace or Service deletion.
    * 
+   * @remarks
+   * 调用本接口前，您需要先为集群安装或升级安全策略组件。具体操作，请参见[启用安全策略管理](https://help.aliyun.com/document_detail/359818.html)。
+   * 
    * @param request - UpdateResourcesDeleteProtectionRequest
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -7560,6 +7625,9 @@ export default class Client extends OpenApi {
   /**
    * Updates the deletion protection status of the specified resources. You can enable or disable deletion protection for namespaces and Services. You can call this operation to enable deletion protection for namespaces or Services that involve businesses-critical and sensitive data to avoid incurring maintenance costs caused by accidental namespace or Service deletion.
    * 
+   * @remarks
+   * 调用本接口前，您需要先为集群安装或升级安全策略组件。具体操作，请参见[启用安全策略管理](https://help.aliyun.com/document_detail/359818.html)。
+   * 
    * @param request - UpdateResourcesDeleteProtectionRequest
    * @returns UpdateResourcesDeleteProtectionResponse
    */
@@ -7762,6 +7830,11 @@ export default class Client extends OpenApi {
   /**
    * Updates cluster components to use new features and patch vulnerabilities. You must update cluster components one after one and update a component only after the previous one is successfully updated. Before you update a component, we recommend that you read the update notes for each component. Cluster component updates may affect your businesses. Assess the impact, back up data, and perform the update during off-peak hours.
    * 
+   * @remarks
+   * - 升级集群组件实例版本可能会影响业务，请评估影响后在业务低峰期操作并提前做好相关的数据备份。
+   * - 升级组件前，请参考[组件发布记录](https://help.aliyun.com/document_detail/176087.html)了解指定组件的变更内容和变更影响。
+   * - 请依次逐个组件升级，确认一个组件升级成功后再升级下一个组件。
+   * 
    * @param request - UpgradeClusterAddonsRequest
    * @param headers - map
    * @param runtime - runtime options for this request RuntimeOptions
@@ -7790,6 +7863,11 @@ export default class Client extends OpenApi {
   /**
    * Updates cluster components to use new features and patch vulnerabilities. You must update cluster components one after one and update a component only after the previous one is successfully updated. Before you update a component, we recommend that you read the update notes for each component. Cluster component updates may affect your businesses. Assess the impact, back up data, and perform the update during off-peak hours.
    * 
+   * @remarks
+   * - 升级集群组件实例版本可能会影响业务，请评估影响后在业务低峰期操作并提前做好相关的数据备份。
+   * - 升级组件前，请参考[组件发布记录](https://help.aliyun.com/document_detail/176087.html)了解指定组件的变更内容和变更影响。
+   * - 请依次逐个组件升级，确认一个组件升级成功后再升级下一个组件。
+   * 
    * @param request - UpgradeClusterAddonsRequest
    * @returns UpgradeClusterAddonsResponse
    */