@alicloud/cs20151215 6.5.2 → 6.6.1

package/dist/client.js

@@ -94,7 +94,7 @@ class Client extends openapi_core_1.default {
         return openapi_core_2.OpenApiUtil.getEndpointRules(productId, regionId, endpointRule, network, suffix);
     }
     /**
-     * Adds existing Elastic Compute Service (ECS) instances to a Container Service for Kubernetes (ACK) cluster.
+     * 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.
      *
      * @param request - AttachInstancesRequest
      * @param headers - map
@@ -161,7 +161,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.AttachInstancesResponse({}));
     }
     /**
-     * Adds existing Elastic Compute Service (ECS) instances to a Container Service for Kubernetes (ACK) cluster.
+     * 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.
      *
      * @param request - AttachInstancesRequest
      * @returns AttachInstancesResponse
@@ -299,7 +299,7 @@ class Client extends openapi_core_1.default {
         return await this.cancelComponentUpgradeWithOptions(clusterId, componentId, headers, runtime);
     }
     /**
-     * You can call the CancelOperationPlan operation to cancel a pending auto O\\\\\\\\\\\\&M plan.
+     * You can call the CancelOperationPlan operation to cancel a pending auto O\\\\\\\\\\\\\\\\\\\\&M plan.
      *
      * @param headers - map
      * @param runtime - runtime options for this request RuntimeOptions
@@ -323,7 +323,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CancelOperationPlanResponse({}));
     }
     /**
-     * You can call the CancelOperationPlan operation to cancel a pending auto O\\\\\\\\\\\\&M plan.
+     * You can call the CancelOperationPlan operation to cancel a pending auto O\\\\\\\\\\\\\\\\\\\\&M plan.
      * @returns CancelOperationPlanResponse
      */
     async cancelOperationPlan(planId) {
@@ -554,7 +554,7 @@ class Client extends openapi_core_1.default {
         return await this.cleanUserPermissionsWithOptions(Uid, request, headers, runtime);
     }
     /**
-     * 查询自愈规则
+     * Creates an auto-repair policy.
      *
      * @param request - CreateAutoRepairPolicyRequest
      * @param headers - map
@@ -594,7 +594,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateAutoRepairPolicyResponse({}));
     }
     /**
-     * 查询自愈规则
+     * Creates an auto-repair policy.
      *
      * @param request - CreateAutoRepairPolicyRequest
      * @returns CreateAutoRepairPolicyResponse
@@ -1151,7 +1151,7 @@ class Client extends openapi_core_1.default {
         return await this.createClusterInspectConfigWithOptions(clusterId, request, headers, runtime);
     }
     /**
-     * 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.
+     * 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.
      *
      * @param request - CreateClusterNodePoolRequest
      * @param headers - map
@@ -1227,7 +1227,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateClusterNodePoolResponse({}));
     }
     /**
-     * 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.
+     * 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.
      *
      * @param request - CreateClusterNodePoolRequest
      * @returns CreateClusterNodePoolResponse
@@ -1634,7 +1634,7 @@ class Client extends openapi_core_1.default {
         return await this.deleteClusterInspectConfigWithOptions(clusterId, headers, runtime);
     }
     /**
-     * null
+     * Deletes unused node pools. Deleting a node pool terminates all pods on its nodes, which triggers pod rescheduling. Insufficient cluster resources may cause scheduling failures and business impact.
      *
      * @param request - DeleteClusterNodepoolRequest
      * @param headers - map
@@ -1665,7 +1665,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteClusterNodepoolResponse({}));
     }
     /**
-     * null
+     * Deletes unused node pools. Deleting a node pool terminates all pods on its nodes, which triggers pod rescheduling. Insufficient cluster resources may cause scheduling failures and business impact.
      *
      * @param request - DeleteClusterNodepoolRequest
      * @returns DeleteClusterNodepoolResponse
@@ -2405,6 +2405,12 @@ class Client extends openapi_core_1.default {
     async describeClusterEventsWithOptions(ClusterId, request, headers, runtime) {
         request.validate();
         let query = {};
+        if (!$dara.isNull(request.maxResults)) {
+            query["max_results"] = request.maxResults;
+        }
+        if (!$dara.isNull(request.nextToken)) {
+            query["next_token"] = request.nextToken;
+        }
         if (!$dara.isNull(request.pageNumber)) {
             query["page_number"] = request.pageNumber;
         }
@@ -2657,6 +2663,12 @@ class Client extends openapi_core_1.default {
     async describeClusterTasksWithOptions(clusterId, request, headers, runtime) {
         request.validate();
         let query = {};
+        if (!$dara.isNull(request.maxResults)) {
+            query["max_results"] = request.maxResults;
+        }
+        if (!$dara.isNull(request.nextToken)) {
+            query["next_token"] = request.nextToken;
+        }
         if (!$dara.isNull(request.pageNumber)) {
             query["page_number"] = request.pageNumber;
         }
@@ -2828,7 +2840,7 @@ class Client extends openapi_core_1.default {
         return await this.describeClusterVulsWithOptions(clusterId, headers, runtime);
     }
     /**
-     * Queries all the clusters that belong to the current Alibaba Cloud account, including Kubernetes clusters and Swarm clusters.
+     * Queries all existing clusters in ACK, including Kubernetes clusters and Swarm clusters.
      *
      * @deprecated OpenAPI DescribeClusters is deprecated
      *
@@ -2867,7 +2879,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeClustersResponse({}));
     }
     /**
-     * Queries all the clusters that belong to the current Alibaba Cloud account, including Kubernetes clusters and Swarm clusters.
+     * Queries all existing clusters in ACK, including Kubernetes clusters and Swarm clusters.
      *
      * @deprecated OpenAPI DescribeClusters is deprecated
      *
@@ -3017,6 +3029,12 @@ class Client extends openapi_core_1.default {
         if (!$dara.isNull(request.clusterId)) {
             query["cluster_id"] = request.clusterId;
         }
+        if (!$dara.isNull(request.maxResults)) {
+            query["max_results"] = request.maxResults;
+        }
+        if (!$dara.isNull(request.nextToken)) {
+            query["next_token"] = request.nextToken;
+        }
         if (!$dara.isNull(request.pageNumber)) {
             query["page_number"] = request.pageNumber;
         }
@@ -3068,6 +3086,12 @@ class Client extends openapi_core_1.default {
         if (!$dara.isNull(request.clusterId)) {
             query["cluster_id"] = request.clusterId;
         }
+        if (!$dara.isNull(request.maxResults)) {
+            query["max_results"] = request.maxResults;
+        }
+        if (!$dara.isNull(request.nextToken)) {
+            query["next_token"] = request.nextToken;
+        }
         if (!$dara.isNull(request.pageNumber)) {
             query["page_number"] = request.pageNumber;
         }
@@ -3438,7 +3462,7 @@ class Client extends openapi_core_1.default {
         return await this.describePolicyInstancesStatusWithOptions(clusterId, headers, runtime);
     }
     /**
-     * 查询地域列表
+     * Queries the list of available regions.
      *
      * @param request - DescribeRegionsRequest
      * @param headers - map
@@ -3475,7 +3499,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeRegionsResponse({}));
     }
     /**
-     * 查询地域列表
+     * Queries the list of available regions.
      *
      * @param request - DescribeRegionsRequest
      * @returns DescribeRegionsResponse
@@ -4296,7 +4320,7 @@ class Client extends openapi_core_1.default {
         return await this.getUpgradeStatusWithOptions(ClusterId, headers, runtime);
     }
     /**
-     * Updates the role-based access control (RBAC) permissions of a Resource Access Management (RAM) user or RAM role. By default, you do not have the RBAC permissions on a Container Service for Kubernetes (ACK) cluster if you are not the cluster owner or you are not using an Alibaba Cloud account. You can call this operation to specify the resources that can be accessed, permission scope, and predefined roles. This helps you better manage the access control on resources in ACK clusters.
+     * 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.
      *
      * @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).
@@ -4327,7 +4351,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.GrantPermissionsResponse({}));
     }
     /**
-     * Updates the role-based access control (RBAC) permissions of a Resource Access Management (RAM) user or RAM role. By default, you do not have the RBAC permissions on a Container Service for Kubernetes (ACK) cluster if you are not the cluster owner or you are not using an Alibaba Cloud account. You can call this operation to specify the resources that can be accessed, permission scope, and predefined roles. This helps you better manage the access control on resources in ACK clusters.
+     * 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.
      *
      * @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).
@@ -4342,7 +4366,7 @@ class Client extends openapi_core_1.default {
         return await this.grantPermissionsWithOptions(uid, request, headers, runtime);
     }
     /**
-     * 为了增强Kubernetes能力，ACK集群支持了多种组件，例如托管的核心组件，应用、日志和监控、网络、存储、安全组件等。您可以调用InstallClusterAddons接口，通过组件名称和版本安装组件。
+     * Installs a component by specifying the name and version of the component. To enhance Kubernetes capabilities, you can install a variety of components in Container Service for Kubernetes (ACK) clusters, such as fully-managed core components and application, logging and monitoring, network, storage, and security group components.
      *
      * @param request - InstallClusterAddonsRequest
      * @param headers - map
@@ -4369,7 +4393,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.InstallClusterAddonsResponse({}));
     }
     /**
-     * 为了增强Kubernetes能力，ACK集群支持了多种组件，例如托管的核心组件，应用、日志和监控、网络、存储、安全组件等。您可以调用InstallClusterAddons接口，通过组件名称和版本安装组件。
+     * Installs a component by specifying the name and version of the component. To enhance Kubernetes capabilities, you can install a variety of components in Container Service for Kubernetes (ACK) clusters, such as fully-managed core components and application, logging and monitoring, network, storage, and security group components.
      *
      * @param request - InstallClusterAddonsRequest
      * @returns InstallClusterAddonsResponse
@@ -4380,7 +4404,7 @@ class Client extends openapi_core_1.default {
         return await this.installClusterAddonsWithOptions(ClusterId, request, headers, runtime);
     }
     /**
-     * 为ACK集群节点池安装节点组件
+     * Installs components onto the nodes within a specified node pool. This API supports custom configurations and allows you to target specific nodes for the installation.
      *
      * @param request - InstallNodePoolComponentsRequest
      * @param headers - map
@@ -4417,7 +4441,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.InstallNodePoolComponentsResponse({}));
     }
     /**
-     * 为ACK集群节点池安装节点组件
+     * Installs components onto the nodes within a specified node pool. This API supports custom configurations and allows you to target specific nodes for the installation.
      *
      * @param request - InstallNodePoolComponentsRequest
      * @returns InstallNodePoolComponentsResponse
@@ -4485,7 +4509,7 @@ class Client extends openapi_core_1.default {
         return await this.listAddonsWithOptions(request, headers, runtime);
     }
     /**
-     * 查询自愈规则
+     * List auto-repair policies.
      *
      * @param headers - map
      * @param runtime - runtime options for this request RuntimeOptions
@@ -4509,7 +4533,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListAutoRepairPoliciesResponse({}));
     }
     /**
-     * 查询自愈规则
+     * List auto-repair policies.
      * @returns ListAutoRepairPoliciesResponse
      */
     async listAutoRepairPolicies(clusterId) {
@@ -4518,7 +4542,7 @@ class Client extends openapi_core_1.default {
         return await this.listAutoRepairPoliciesWithOptions(clusterId, headers, runtime);
     }
     /**
-     * 获取集群组件实例的资源列表
+     * Queries the list of resources associated with installed cluster add-ons, including Kubernetes resources and Helm release information.
      *
      * @param headers - map
      * @param runtime - runtime options for this request RuntimeOptions
@@ -4542,7 +4566,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListClusterAddonInstanceResourcesResponse({}));
     }
     /**
-     * 获取集群组件实例的资源列表
+     * Queries the list of resources associated with installed cluster add-ons, including Kubernetes resources and Helm release information.
      * @returns ListClusterAddonInstanceResourcesResponse
      */
     async listClusterAddonInstanceResources(clusterId, instanceName) {
@@ -6278,7 +6302,7 @@ class Client extends openapi_core_1.default {
         return await this.syncClusterNodePoolWithOptions(ClusterId, headers, runtime);
     }
     /**
-     * You can add labels in key-value pairs to clusters. This allows cluster developers or O\\&M engineers to classify and manage clusters in a more flexible manner. This also meets the requirements for monitoring, cost analysis, and tenant isolation. You can call the TagResources operation to add labels to a cluster.
+     * You can add labels in key-value pairs to clusters. This allows cluster developers or O\\\\\\\\\\\\&M engineers to classify and manage clusters in a more flexible manner. This also meets the requirements for monitoring, cost analysis, and tenant isolation. You can call the TagResources operation to add labels to a cluster.
      *
      * @param request - TagResourcesRequest
      * @param headers - map
@@ -6318,7 +6342,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.TagResourcesResponse({}));
     }
     /**
-     * You can add labels in key-value pairs to clusters. This allows cluster developers or O\\&M engineers to classify and manage clusters in a more flexible manner. This also meets the requirements for monitoring, cost analysis, and tenant isolation. You can call the TagResources operation to add labels to a cluster.
+     * You can add labels in key-value pairs to clusters. This allows cluster developers or O\\\\\\\\\\\\&M engineers to classify and manage clusters in a more flexible manner. This also meets the requirements for monitoring, cost analysis, and tenant isolation. You can call the TagResources operation to add labels to a cluster.
      *
      * @param request - TagResourcesRequest
      * @returns TagResourcesResponse
@@ -6683,7 +6707,52 @@ class Client extends openapi_core_1.default {
         return await this.updateK8sClusterUserConfigExpireWithOptions(ClusterId, request, headers, runtime);
     }
     /**
-     * 更新节点组件
+     * Updates the Secret encryption at rest configuration for a specified cluster by cluster ID.
+     *
+     * @param request - UpdateKMSEncryptionRequest
+     * @param headers - map
+     * @param runtime - runtime options for this request RuntimeOptions
+     * @returns UpdateKMSEncryptionResponse
+     */
+    async updateKMSEncryptionWithOptions(ClusterId, request, headers, runtime) {
+        request.validate();
+        let body = {};
+        if (!$dara.isNull(request.disableEncryption)) {
+            body["disable_encryption"] = request.disableEncryption;
+        }
+        if (!$dara.isNull(request.kmsKeyId)) {
+            body["kms_key_id"] = request.kmsKeyId;
+        }
+        let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
+            headers: headers,
+            body: openapi_core_2.OpenApiUtil.parseToMap(body),
+        });
+        let params = new openapi_core_2.$OpenApiUtil.Params({
+            action: "UpdateKMSEncryption",
+            version: "2015-12-15",
+            protocol: "HTTPS",
+            pathname: `/clusters/${$dara.URL.percentEncode(ClusterId)}/kms`,
+            method: "PUT",
+            authType: "AK",
+            style: "ROA",
+            reqBodyType: "json",
+            bodyType: "none",
+        });
+        return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateKMSEncryptionResponse({}));
+    }
+    /**
+     * Updates the Secret encryption at rest configuration for a specified cluster by cluster ID.
+     *
+     * @param request - UpdateKMSEncryptionRequest
+     * @returns UpdateKMSEncryptionResponse
+     */
+    async updateKMSEncryption(ClusterId, request) {
+        let runtime = new $dara.RuntimeOptions({});
+        let headers = {};
+        return await this.updateKMSEncryptionWithOptions(ClusterId, request, headers, runtime);
+    }
+    /**
+     * Updates a specific component within a node pool, such as the kubelet.
      *
      * @param request - UpdateNodePoolComponentRequest
      * @param headers - map
@@ -6729,7 +6798,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateNodePoolComponentResponse({}));
     }
     /**
-     * 更新节点组件
+     * Updates a specific component within a node pool, such as the kubelet.
      *
      * @param request - UpdateNodePoolComponentRequest
      * @returns UpdateNodePoolComponentResponse
@@ -6845,7 +6914,7 @@ class Client extends openapi_core_1.default {
         return await this.updateTemplateWithOptions(TemplateId, request, headers, runtime);
     }
     /**
-     * Updates the role-based access control (RBAC) permissions of a Resource Access Management (RAM) user or RAM role. By default, you do not have the RBAC permissions on a Container Service for Kubernetes (ACK) cluster if you are not the cluster owner or you are not using an Alibaba Cloud account. You can call this operation to specify the resources that can be accessed, permission scope, and predefined roles. This helps you better manage the access control on resources in ACK clusters.
+     * In a Container Service for Kubernetes (ACK) cluster, non-cluster creators, Resource Access Management (RAM) users, and RAM roles do not have any Role-Based Access Control (RBAC) permissions in the cluster by default. You can call this operation to specify the resources that can be accessed, permission scope, and predefined roles. This helps you better manage the access control on resources in ACK clusters.
      *
      * @remarks
      * *Precautions**:
@@ -6881,7 +6950,7 @@ class Client extends openapi_core_1.default {
         return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateUserPermissionsResponse({}));
     }
     /**
-     * Updates the role-based access control (RBAC) permissions of a Resource Access Management (RAM) user or RAM role. By default, you do not have the RBAC permissions on a Container Service for Kubernetes (ACK) cluster if you are not the cluster owner or you are not using an Alibaba Cloud account. You can call this operation to specify the resources that can be accessed, permission scope, and predefined roles. This helps you better manage the access control on resources in ACK clusters.
+     * In a Container Service for Kubernetes (ACK) cluster, non-cluster creators, Resource Access Management (RAM) users, and RAM roles do not have any Role-Based Access Control (RBAC) permissions in the cluster by default. You can call this operation to specify the resources that can be accessed, permission scope, and predefined roles. This helps you better manage the access control on resources in ACK clusters.
      *
      * @remarks
      * *Precautions**: