@alicloud/cs20151215 4.8.11 → 4.8.12

package/dist/client.js

@@ -8890,6 +8890,7 @@ class DescribeClusterAttachScriptsRequest extends $dara.Model {
     static names() {
         return {
             arch: 'arch',
+            expired: 'expired',
             formatDisk: 'format_disk',
             keepInstanceName: 'keep_instance_name',
             nodepoolId: 'nodepool_id',
@@ -8900,6 +8901,7 @@ class DescribeClusterAttachScriptsRequest extends $dara.Model {
     static types() {
         return {
             arch: 'string',
+            expired: 'number',
             formatDisk: 'boolean',
             keepInstanceName: 'boolean',
             nodepoolId: 'string',
@@ -12736,7 +12738,9 @@ class ModifyClusterRequest extends $dara.Model {
             maintenanceWindow: 'maintenance_window',
             operationPolicy: 'operation_policy',
             resourceGroupId: 'resource_group_id',
+            securityGroupId: 'security_group_id',
             systemEventsLogging: 'system_events_logging',
+            timezone: 'timezone',
             vswitchIds: 'vswitch_ids',
         };
     }
@@ -12756,7 +12760,9 @@ class ModifyClusterRequest extends $dara.Model {
             maintenanceWindow: MaintenanceWindow,
             operationPolicy: ModifyClusterRequestOperationPolicy,
             resourceGroupId: 'string',
+            securityGroupId: 'string',
             systemEventsLogging: ModifyClusterRequestSystemEventsLogging,
+            timezone: 'string',
             vswitchIds: { 'type': 'array', 'itemType': 'string' },
         };
     }
@@ -15740,7 +15746,7 @@ class Client extends openapi_core_1.default {
         return await this.checkControlPlaneLogEnableWithOptions(ClusterId, headers, runtime);
     }
     /**
-     * Checks whether the specified service role is granted required permissions within the current Alibaba Cloud account.
+     * Checks whether the specified service roles are granted to Container Service for Kubernetes (ACK) within the current Alibaba Cloud account. ACK can access other cloud services, such as Elastic Compute Service (ECS), Object Storage Service (OSS), File Storage NAS (NAS), and Server Load Balancer (SLB), only after ACK is assigned the required service roles.
      *
      * @param request - CheckServiceRoleRequest
      * @param headers - map
@@ -15776,7 +15782,7 @@ class Client extends openapi_core_1.default {
         }
     }
     /**
-     * Checks whether the specified service role is granted required permissions within the current Alibaba Cloud account.
+     * Checks whether the specified service roles are granted to Container Service for Kubernetes (ACK) within the current Alibaba Cloud account. ACK can access other cloud services, such as Elastic Compute Service (ECS), Object Storage Service (OSS), File Storage NAS (NAS), and Server Load Balancer (SLB), only after ACK is assigned the required service roles.
      *
      * @param request - CheckServiceRoleRequest
      * @returns CheckServiceRoleResponse
@@ -16003,16 +16009,16 @@ class Client extends openapi_core_1.default {
         return await this.createAutoscalingConfigWithOptions(ClusterId, request, headers, runtime);
     }
     /**
-     * You can call the CreateCluster operation to create a Container Service for Kubernetes (ACK) cluster. ACK clusters include ACK managed clusters, ACK dedicated clusters, ACK Serverless clusters, ACK Edge clusters, ACK clusters that support sandboxed containers, and registered clusters. For more information about how to create different types of ACK clusters, see the following usage notes.
+     * 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.
      *
      * @remarks
-     * This topic describes all request parameters for creating a Container Service for Kubernetes (ACK) cluster. For more information about how to call the API to create each type of ACK cluster, refer to the following topics:
-     * *   [Call the API to create an ACK managed cluster](https://help.aliyun.com/document_detail/90776.html)
-     * *   [Call the API to create an ACK dedicated cluster](https://help.aliyun.com/document_detail/197620.html)
-     * *   [Call the API to create an ACK Serverless cluster](https://help.aliyun.com/document_detail/144246.html)
-     * *   [Call the API to create an ACK Edge cluster](https://help.aliyun.com/document_detail/128204.html)
-     * *   [Call the API to create an ACK Basic cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/196321.html)
-     * *   [Call the API to create an ACK Pro cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/140623.html)
+     * ### [](#-openapi-)Generate API request parameters in the ACK console
+     * When you fail to create an ACK cluster by calling the CreateCluster operation due to invalid parameter settings, you can generate valid API request parameters in the ACK console. Procedure:
+     * 1.  Log on to the [ACK console](javascript:void\\(0\\)). In the left-side navigation pane, click **Clusters**.
+     * 2.  On the **Cluster** page, click **Cluster Templates**.
+     * 3.  In the Select Cluster Template dialog box, select the type of cluster that you want to create and click Create. Then, configure the cluster setting parameters.
+     * 4.  After you configure the cluster parameters, click **Generate API Request Parameters** in the **Confirm Order** step.
+     *     The API request parameters are displayed in the API Request Parameters dialog box.
      *
      * @param request - CreateClusterRequest
      * @param headers - map
@@ -16339,16 +16345,16 @@ class Client extends openapi_core_1.default {
         }
     }
     /**
-     * You can call the CreateCluster operation to create a Container Service for Kubernetes (ACK) cluster. ACK clusters include ACK managed clusters, ACK dedicated clusters, ACK Serverless clusters, ACK Edge clusters, ACK clusters that support sandboxed containers, and registered clusters. For more information about how to create different types of ACK clusters, see the following usage notes.
+     * 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.
      *
      * @remarks
-     * This topic describes all request parameters for creating a Container Service for Kubernetes (ACK) cluster. For more information about how to call the API to create each type of ACK cluster, refer to the following topics:
-     * *   [Call the API to create an ACK managed cluster](https://help.aliyun.com/document_detail/90776.html)
-     * *   [Call the API to create an ACK dedicated cluster](https://help.aliyun.com/document_detail/197620.html)
-     * *   [Call the API to create an ACK Serverless cluster](https://help.aliyun.com/document_detail/144246.html)
-     * *   [Call the API to create an ACK Edge cluster](https://help.aliyun.com/document_detail/128204.html)
-     * *   [Call the API to create an ACK Basic cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/196321.html)
-     * *   [Call the API to create an ACK Pro cluster that supports sandboxed containers](https://help.aliyun.com/document_detail/140623.html)
+     * ### [](#-openapi-)Generate API request parameters in the ACK console
+     * When you fail to create an ACK cluster by calling the CreateCluster operation due to invalid parameter settings, you can generate valid API request parameters in the ACK console. Procedure:
+     * 1.  Log on to the [ACK console](javascript:void\\(0\\)). In the left-side navigation pane, click **Clusters**.
+     * 2.  On the **Cluster** page, click **Cluster Templates**.
+     * 3.  In the Select Cluster Template dialog box, select the type of cluster that you want to create and click Create. Then, configure the cluster setting parameters.
+     * 4.  After you configure the cluster parameters, click **Generate API Request Parameters** in the **Confirm Order** step.
+     *     The API request parameters are displayed in the API Request Parameters dialog box.
      *
      * @param request - CreateClusterRequest
      * @returns CreateClusterResponse
@@ -16828,6 +16834,14 @@ class Client extends openapi_core_1.default {
     /**
      * 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.
      *
+     * @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.
+     *
      * @param tmpReq - DeleteClusterRequest
      * @param headers - map
      * @param runtime - runtime options for this request RuntimeOptions
@@ -16881,6 +16895,14 @@ class Client extends openapi_core_1.default {
     /**
      * 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.
      *
+     * @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.
+     *
      * @param request - DeleteClusterRequest
      * @returns DeleteClusterResponse
      */
@@ -17653,6 +17675,9 @@ class Client extends openapi_core_1.default {
         if (!$dara.isNull(request.arch)) {
             body["arch"] = request.arch;
         }
+        if (!$dara.isNull(request.expired)) {
+            body["expired"] = request.expired;
+        }
         if (!$dara.isNull(request.formatDisk)) {
             body["format_disk"] = request.formatDisk;
         }
@@ -18705,7 +18730,7 @@ class Client extends openapi_core_1.default {
         return await this.describeEventsForRegionWithOptions(regionId, request, headers, runtime);
     }
     /**
-     * Queries the proxy configurations of a registered cluster based on the cluster ID.
+     * Queries the proxy configurations of a registered cluster by cluster ID.
      *
      * @remarks
      * For more information, see [Register an external Kubernetes cluster](https://help.aliyun.com/document_detail/121053.html).
@@ -18750,7 +18775,7 @@ class Client extends openapi_core_1.default {
         }
     }
     /**
-     * Queries the proxy configurations of a registered cluster based on the cluster ID.
+     * Queries the proxy configurations of a registered cluster by cluster ID.
      *
      * @remarks
      * For more information, see [Register an external Kubernetes cluster](https://help.aliyun.com/document_detail/121053.html).
@@ -19668,7 +19693,7 @@ class Client extends openapi_core_1.default {
         return await this.getClusterAddonInstanceWithOptions(clusterId, instanceName, headers, runtime);
     }
     /**
-     * You can call the GetClusterAuditProject operation to query the Simple Log Service (SLS) project that stores the audit logs of the API server of a cluster.
+     * You can call the GetClusterAuditProject operation to check whether the cluster has API Server auditing enabled and the corresponding Simple Log Service project that stores API Server audit logs.
      *
      * @param headers - map
      * @param runtime - runtime options for this request RuntimeOptions
@@ -19697,7 +19722,7 @@ class Client extends openapi_core_1.default {
         }
     }
     /**
-     * You can call the GetClusterAuditProject operation to query the Simple Log Service (SLS) project that stores the audit logs of the API server of a cluster.
+     * You can call the GetClusterAuditProject operation to check whether the cluster has API Server auditing enabled and the corresponding Simple Log Service project that stores API Server audit logs.
      * @returns GetClusterAuditProjectResponse
      */
     async getClusterAuditProject(clusterid) {
@@ -20523,9 +20548,15 @@ class Client extends openapi_core_1.default {
         if (!$dara.isNull(request.resourceGroupId)) {
             body["resource_group_id"] = request.resourceGroupId;
         }
+        if (!$dara.isNull(request.securityGroupId)) {
+            body["security_group_id"] = request.securityGroupId;
+        }
         if (!$dara.isNull(request.systemEventsLogging)) {
             body["system_events_logging"] = request.systemEventsLogging;
         }
+        if (!$dara.isNull(request.timezone)) {
+            body["timezone"] = request.timezone;
+        }
         if (!$dara.isNull(request.vswitchIds)) {
             body["vswitch_ids"] = request.vswitchIds;
         }
@@ -21816,7 +21847,7 @@ class Client extends openapi_core_1.default {
         return await this.scanClusterVulsWithOptions(clusterId, headers, runtime);
     }
     /**
-     * 启用告警
+     * Activates the specified alert rule(s).
      *
      * @param request - StartAlertRequest
      * @param headers - map
@@ -21855,7 +21886,7 @@ class Client extends openapi_core_1.default {
         }
     }
     /**
-     * 启用告警
+     * Activates the specified alert rule(s).
      *
      * @param request - StartAlertRequest
      * @returns StartAlertResponse
@@ -22123,7 +22154,7 @@ class Client extends openapi_core_1.default {
      * You can call the UpdateClusterAuditLogConfig operation to enable or disable the audit log feature in a Container Service for Kubernetes (ACK) cluster and update the audit log configuration. This operation also allows you to record requests to the Kubernetes API and the responses, which can be used to trace cluster operation history and troubleshoot cluster issues.
      *
      * @remarks
-     * Before you call this operation, ensure that you understand the billing methods and pricing of [Simple Log Service](https://www.alibabacloud.com/product/log-service/pricing) (SLS).
+     * Before you call this operation, ensure that you understand the billing methods and pricing of [Simple Log Service](https://www.alibabacloud.com/product/log-service/pricing).
      *
      * @param request - UpdateClusterAuditLogConfigRequest
      * @param headers - map
@@ -22165,7 +22196,7 @@ class Client extends openapi_core_1.default {
      * You can call the UpdateClusterAuditLogConfig operation to enable or disable the audit log feature in a Container Service for Kubernetes (ACK) cluster and update the audit log configuration. This operation also allows you to record requests to the Kubernetes API and the responses, which can be used to trace cluster operation history and troubleshoot cluster issues.
      *
      * @remarks
-     * Before you call this operation, ensure that you understand the billing methods and pricing of [Simple Log Service](https://www.alibabacloud.com/product/log-service/pricing) (SLS).
+     * Before you call this operation, ensure that you understand the billing methods and pricing of [Simple Log Service](https://www.alibabacloud.com/product/log-service/pricing).
      *
      * @param request - UpdateClusterAuditLogConfigRequest
      * @returns UpdateClusterAuditLogConfigResponse
@@ -22346,7 +22377,7 @@ class Client extends openapi_core_1.default {
         return await this.updateK8sClusterUserConfigExpireWithOptions(ClusterId, request, headers, runtime);
     }
     /**
-     * Updates the deletion protection status of the specified resources. You can enable or disable deletion protection for namespaces and Services.
+     * 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.
      *
      * @param request - UpdateResourcesDeleteProtectionRequest
      * @param headers - map
@@ -22391,7 +22422,7 @@ class Client extends openapi_core_1.default {
         }
     }
     /**
-     * Updates the deletion protection status of the specified resources. You can enable or disable deletion protection for namespaces and Services.
+     * 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.
      *
      * @param request - UpdateResourcesDeleteProtectionRequest
      * @returns UpdateResourcesDeleteProtectionResponse