@alicloud/cs20151215 7.2.5 → 7.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. package/dist/client.d.ts +72 -72
  2. package/dist/client.js +82 -72
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/AttachInstancesToNodePoolRequest.d.ts +3 -13
  5. package/dist/models/AttachInstancesToNodePoolRequest.js.map +1 -1
  6. package/dist/models/CleanClusterUserPermissionsRequest.d.ts +1 -1
  7. package/dist/models/CleanUserPermissionsRequest.d.ts +2 -2
  8. package/dist/models/CleanUserPermissionsShrinkRequest.d.ts +2 -2
  9. package/dist/models/CreateClusterRequest.d.ts +305 -392
  10. package/dist/models/CreateClusterRequest.js.map +1 -1
  11. package/dist/models/DeleteClusterNodesRequest.d.ts +15 -7
  12. package/dist/models/DeleteClusterNodesRequest.js +2 -0
  13. package/dist/models/DeleteClusterNodesRequest.js.map +1 -1
  14. package/dist/models/DescribeClusterAttachScriptsRequest.d.ts +9 -17
  15. package/dist/models/DescribeClusterAttachScriptsRequest.js.map +1 -1
  16. package/dist/models/DescribeClusterDetailResponseBody.d.ts +80 -77
  17. package/dist/models/DescribeClusterDetailResponseBody.js.map +1 -1
  18. package/dist/models/DescribeClustersForRegionRequest.d.ts +14 -14
  19. package/dist/models/DescribeClustersForRegionResponseBody.d.ts +18 -12
  20. package/dist/models/DescribeClustersForRegionResponseBody.js.map +1 -1
  21. package/dist/models/DescribeKubernetesVersionMetadataRequest.d.ts +22 -15
  22. package/dist/models/DescribeKubernetesVersionMetadataRequest.js.map +1 -1
  23. package/dist/models/DescribeKubernetesVersionMetadataResponse.d.ts +23 -17
  24. package/dist/models/DescribeKubernetesVersionMetadataResponse.js.map +1 -1
  25. package/dist/models/ListUserKubeConfigStatesRequest.d.ts +3 -3
  26. package/dist/models/ListUserKubeConfigStatesResponseBody.d.ts +4 -5
  27. package/dist/models/ListUserKubeConfigStatesResponseBody.js.map +1 -1
  28. package/dist/models/ModifyClusterRequest.d.ts +106 -99
  29. package/dist/models/ModifyClusterRequest.js.map +1 -1
  30. package/dist/models/ModifyClusterResponseBody.d.ts +2 -2
  31. package/dist/models/RemoveNodePoolNodesRequest.d.ts +18 -11
  32. package/dist/models/RemoveNodePoolNodesRequest.js +2 -0
  33. package/dist/models/RemoveNodePoolNodesRequest.js.map +1 -1
  34. package/dist/models/RemoveNodePoolNodesShrinkRequest.d.ts +18 -11
  35. package/dist/models/RemoveNodePoolNodesShrinkRequest.js +2 -0
  36. package/dist/models/RemoveNodePoolNodesShrinkRequest.js.map +1 -1
  37. package/dist/models/UpdateClusterAuditLogConfigRequest.d.ts +4 -3
  38. package/dist/models/UpdateClusterAuditLogConfigRequest.js.map +1 -1
  39. package/dist/models/UpdateUserPermissionsRequest.d.ts +22 -22
  40. package/dist/models/UpdateUserPermissionsRequest.js.map +1 -1
  41. package/package.json +2 -1
  42. package/src/client.ts +84 -72
  43. package/src/models/AttachInstancesToNodePoolRequest.ts +3 -13
  44. package/src/models/CleanClusterUserPermissionsRequest.ts +1 -1
  45. package/src/models/CleanUserPermissionsRequest.ts +2 -2
  46. package/src/models/CleanUserPermissionsShrinkRequest.ts +2 -2
  47. package/src/models/CreateClusterRequest.ts +305 -392
  48. package/src/models/DeleteClusterNodesRequest.ts +17 -7
  49. package/src/models/DescribeClusterAttachScriptsRequest.ts +9 -17
  50. package/src/models/DescribeClusterDetailResponseBody.ts +80 -77
  51. package/src/models/DescribeClustersForRegionRequest.ts +14 -14
  52. package/src/models/DescribeClustersForRegionResponseBody.ts +18 -12
  53. package/src/models/DescribeKubernetesVersionMetadataRequest.ts +22 -15
  54. package/src/models/DescribeKubernetesVersionMetadataResponse.ts +23 -17
  55. package/src/models/ListUserKubeConfigStatesRequest.ts +3 -3
  56. package/src/models/ListUserKubeConfigStatesResponseBody.ts +4 -5
  57. package/src/models/ModifyClusterRequest.ts +106 -99
  58. package/src/models/ModifyClusterResponseBody.ts +2 -2
  59. package/src/models/RemoveNodePoolNodesRequest.ts +20 -11
  60. package/src/models/RemoveNodePoolNodesShrinkRequest.ts +20 -11
  61. package/src/models/UpdateClusterAuditLogConfigRequest.ts +4 -3
  62. package/src/models/UpdateUserPermissionsRequest.ts +22 -22
package/dist/client.js CHANGED
@@ -41,6 +41,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
41
41
  Object.defineProperty(exports, "__esModule", { value: true });
42
42
  // This file is auto-generated, don't edit it
43
43
  const $dara = __importStar(require("@darabonba/typescript"));
44
+ const gateway_pop_1 = __importDefault(require("@alicloud/gateway-pop"));
44
45
  const openapi_core_1 = __importDefault(require("@alicloud/openapi-core"));
45
46
  const openapi_core_2 = require("@alicloud/openapi-core");
46
47
  const $_model = __importStar(require("./models/model"));
@@ -48,6 +49,9 @@ __exportStar(require("./models/model"), exports);
48
49
  class Client extends openapi_core_1.default {
49
50
  constructor(config) {
50
51
  super(config);
52
+ this._productId = "CS";
53
+ let gatewayClient = new gateway_pop_1.default();
54
+ this._spi = gatewayClient;
51
55
  this._endpointRule = "regional";
52
56
  this._endpointMap = {
53
57
  'ap-northeast-2-pop': "cs.aliyuncs.com",
@@ -178,7 +182,7 @@ class Client extends openapi_core_1.default {
178
182
  return await this.attachInstancesWithOptions(ClusterId, request, headers, runtime);
179
183
  }
180
184
  /**
181
- * Adds existing ECS instances to a node pool as worker nodes in an ACK cluster, or re-adds removed worker nodes to a node pool.
185
+ * Adds existing ECS instances to an ACK cluster as worker nodes, or re-adds removed node instances to a node pool. You can invoke AttachInstancesToNodePool to add existing nodes to a node pool.
182
186
  *
183
187
  * @param request - AttachInstancesToNodePoolRequest
184
188
  * @param headers - map
@@ -218,7 +222,7 @@ class Client extends openapi_core_1.default {
218
222
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.AttachInstancesToNodePoolResponse({}));
219
223
  }
220
224
  /**
221
- * Adds existing ECS instances to a node pool as worker nodes in an ACK cluster, or re-adds removed worker nodes to a node pool.
225
+ * Adds existing ECS instances to an ACK cluster as worker nodes, or re-adds removed node instances to a node pool. You can invoke AttachInstancesToNodePool to add existing nodes to a node pool.
222
226
  *
223
227
  * @param request - AttachInstancesToNodePoolRequest
224
228
  * @returns AttachInstancesToNodePoolResponse
@@ -446,12 +450,12 @@ class Client extends openapi_core_1.default {
446
450
  return await this.checkServiceRoleWithOptions(request, headers, runtime);
447
451
  }
448
452
  /**
449
- * Clears the issued KubeConfig credentials and Role-Based Access Control (RBAC) permissions of a specified user in a specified cluster. You can call this operation to clean up and revoke authorization for KubeConfig files that pose security risks.
453
+ * Clears the issued KubeConfig credentials and revokes the RBAC authorization of a specified user in a specified cluster. You can invoke CleanClusterUserPermissions to clean up and revoke authorization for KubeConfigs that pose a security risk.
450
454
  *
451
455
  * @remarks
452
- * > 1. You must have the permissions to manage Container Service for Kubernetes (CS). The required policy is AliyunCSFullAccess.
453
- * > 2. You cannot clear the permissions of an Alibaba Cloud account.
454
- * > 3. You cannot clear the permissions of the user who performs this operation.
456
+ * > 1. You must have the permissions to manage Container Service for Kubernetes (CS) (AliyunCSFullAccess).
457
+ * > 2. This operation does not support clearing the permissions of an Alibaba Cloud account.
458
+ * > 3. This operation does not support clearing the permissions of the current user.
455
459
  *
456
460
  * @param request - CleanClusterUserPermissionsRequest
457
461
  * @param headers - map
@@ -482,12 +486,12 @@ class Client extends openapi_core_1.default {
482
486
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CleanClusterUserPermissionsResponse({}));
483
487
  }
484
488
  /**
485
- * Clears the issued KubeConfig credentials and Role-Based Access Control (RBAC) permissions of a specified user in a specified cluster. You can call this operation to clean up and revoke authorization for KubeConfig files that pose security risks.
489
+ * Clears the issued KubeConfig credentials and revokes the RBAC authorization of a specified user in a specified cluster. You can invoke CleanClusterUserPermissions to clean up and revoke authorization for KubeConfigs that pose a security risk.
486
490
  *
487
491
  * @remarks
488
- * > 1. You must have the permissions to manage Container Service for Kubernetes (CS). The required policy is AliyunCSFullAccess.
489
- * > 2. You cannot clear the permissions of an Alibaba Cloud account.
490
- * > 3. You cannot clear the permissions of the user who performs this operation.
492
+ * > 1. You must have the permissions to manage Container Service for Kubernetes (CS) (AliyunCSFullAccess).
493
+ * > 2. This operation does not support clearing the permissions of an Alibaba Cloud account.
494
+ * > 3. This operation does not support clearing the permissions of the current user.
491
495
  *
492
496
  * @param request - CleanClusterUserPermissionsRequest
493
497
  * @returns CleanClusterUserPermissionsResponse
@@ -498,12 +502,12 @@ class Client extends openapi_core_1.default {
498
502
  return await this.cleanClusterUserPermissionsWithOptions(ClusterId, Uid, request, headers, runtime);
499
503
  }
500
504
  /**
501
- * Cleans up and revokes the KubeConfig credentials and RBAC permissions issued to a specified user, such as resigned employees or users with frozen accounts.
505
+ * Clears the issued KubeConfig credentials and RBAC permissions of a specified user to revoke authorizations for risky users, such as resigned employees or users with frozen accounts.
502
506
  *
503
507
  * @remarks
504
- * >- Requires the permissions to manage Container Service for Kubernetes (CS) (AliyunCSFullAccess).
505
- * >- Clearing the permissions of Alibaba Cloud accounts is not supported.
506
- * >- Clearing the permissions of the calling user is not supported.
508
+ * >- You must have the permissions to manage Container Service for Kubernetes (CS) (AliyunCSFullAccess).
509
+ * >- You cannot clear the permissions of an Alibaba Cloud account.
510
+ * >- You cannot clear your own permissions.
507
511
  *
508
512
  * @param tmpReq - CleanUserPermissionsRequest
509
513
  * @param headers - map
@@ -542,12 +546,12 @@ class Client extends openapi_core_1.default {
542
546
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CleanUserPermissionsResponse({}));
543
547
  }
544
548
  /**
545
- * Cleans up and revokes the KubeConfig credentials and RBAC permissions issued to a specified user, such as resigned employees or users with frozen accounts.
549
+ * Clears the issued KubeConfig credentials and RBAC permissions of a specified user to revoke authorizations for risky users, such as resigned employees or users with frozen accounts.
546
550
  *
547
551
  * @remarks
548
- * >- Requires the permissions to manage Container Service for Kubernetes (CS) (AliyunCSFullAccess).
549
- * >- Clearing the permissions of Alibaba Cloud accounts is not supported.
550
- * >- Clearing the permissions of the calling user is not supported.
552
+ * >- You must have the permissions to manage Container Service for Kubernetes (CS) (AliyunCSFullAccess).
553
+ * >- You cannot clear the permissions of an Alibaba Cloud account.
554
+ * >- You cannot clear your own permissions.
551
555
  *
552
556
  * @param request - CleanUserPermissionsRequest
553
557
  * @returns CleanUserPermissionsResponse
@@ -702,16 +706,16 @@ class Client extends openapi_core_1.default {
702
706
  return await this.createAutoscalingConfigWithOptions(ClusterId, request, headers, runtime);
703
707
  }
704
708
  /**
705
- * Creates an ACK cluster, including ACK managed clusters, ACK Serverless clusters, ACK Edge clusters, and registered clusters. When you create a cluster, you configure cluster information, cluster components, and ACK-related cloud resources.
709
+ * Creates an ACK cluster, including ACK managed clusters, ACK Serverless clusters, ACK Edge clusters, and registered clusters. When creating a cluster, you configure cluster information, cluster components, and ACK-related cloud resources.
706
710
  *
707
711
  * @remarks
708
712
  * ### Generate OpenAPI request parameters by using the console
709
- * When you call the CreateCluster operation to create a cluster, if the API call fails due to incorrect combinations of request parameters, you can use the console to generate the required request parameter combinations. Perform the following steps:
710
- * 1. Log on to the [Container Service for Kubernetes (ACK) console](https://csnew.console.aliyun.com) and choose **Clusters** in the left-side navigation pane.
711
- * 1. On the **Clusters** page, click **Cluster Template**.
712
- * 1. In the dialog box, select the cluster type that you want to create, click Create, and then configure the cluster information on the cluster configuration page.
713
- * 1. After the configuration is complete, on the **Confirm Configuration** page, click **Equivalent Code** in the upper-right corner. The dialog box displays the parameter combinations required for creating the cluster. You can copy and use them.
714
- * >Notice: Starting from July 04, 2026, some request parameters will no longer take effect. For details about the changes and replacement parameter descriptions, see [Notice on changes to OpenAPI request and response parameters for ACK cluster management and OpenAPI offline](https://help.aliyun.com/document_detail/2932733.html).</notice>
713
+ * When you call the CreateCluster API operation to create a cluster, if the API call fails due to an incorrect combination of request parameters, you can generate the required combination of request parameters for cluster creation by using the console. Proceed as follows:
714
+ * 1. Log on to the [Container Service console](https://csnew.console.aliyun.com). In the left-side navigation pane, click **Clusters**.
715
+ * 1. On the **Clusters** page, click **Cluster Templates**.
716
+ * 1. In the dialog box, select the type of cluster that you want to create, click Create, and then configure the cluster information on the cluster configuration page.
717
+ * 1. After the configuration is complete, on the **Confirm** page, click **Equivalent Code** in the upper-right corner. The dialog box displays the combination of parameters required for cluster creation. You can copy and use the parameters.
718
+ * >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 to input and output parameters of ACK cluster management-related OpenAPIs and OpenAPI deprecation](https://help.aliyun.com/document_detail/2932733.html).</notice>
715
719
  *
716
720
  * @param request - CreateClusterRequest
717
721
  * @param headers - map
@@ -1054,16 +1058,16 @@ class Client extends openapi_core_1.default {
1054
1058
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateClusterResponse({}));
1055
1059
  }
1056
1060
  /**
1057
- * Creates an ACK cluster, including ACK managed clusters, ACK Serverless clusters, ACK Edge clusters, and registered clusters. When you create a cluster, you configure cluster information, cluster components, and ACK-related cloud resources.
1061
+ * Creates an ACK cluster, including ACK managed clusters, ACK Serverless clusters, ACK Edge clusters, and registered clusters. When creating a cluster, you configure cluster information, cluster components, and ACK-related cloud resources.
1058
1062
  *
1059
1063
  * @remarks
1060
1064
  * ### Generate OpenAPI request parameters by using the console
1061
- * When you call the CreateCluster operation to create a cluster, if the API call fails due to incorrect combinations of request parameters, you can use the console to generate the required request parameter combinations. Perform the following steps:
1062
- * 1. Log on to the [Container Service for Kubernetes (ACK) console](https://csnew.console.aliyun.com) and choose **Clusters** in the left-side navigation pane.
1063
- * 1. On the **Clusters** page, click **Cluster Template**.
1064
- * 1. In the dialog box, select the cluster type that you want to create, click Create, and then configure the cluster information on the cluster configuration page.
1065
- * 1. After the configuration is complete, on the **Confirm Configuration** page, click **Equivalent Code** in the upper-right corner. The dialog box displays the parameter combinations required for creating the cluster. You can copy and use them.
1066
- * >Notice: Starting from July 04, 2026, some request parameters will no longer take effect. For details about the changes and replacement parameter descriptions, see [Notice on changes to OpenAPI request and response parameters for ACK cluster management and OpenAPI offline](https://help.aliyun.com/document_detail/2932733.html).</notice>
1065
+ * When you call the CreateCluster API operation to create a cluster, if the API call fails due to an incorrect combination of request parameters, you can generate the required combination of request parameters for cluster creation by using the console. Proceed as follows:
1066
+ * 1. Log on to the [Container Service console](https://csnew.console.aliyun.com). In the left-side navigation pane, click **Clusters**.
1067
+ * 1. On the **Clusters** page, click **Cluster Templates**.
1068
+ * 1. In the dialog box, select the type of cluster that you want to create, click Create, and then configure the cluster information on the cluster configuration page.
1069
+ * 1. After the configuration is complete, on the **Confirm** page, click **Equivalent Code** in the upper-right corner. The dialog box displays the combination of parameters required for cluster creation. You can copy and use the parameters.
1070
+ * >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 to input and output parameters of ACK cluster management-related OpenAPIs and OpenAPI deprecation](https://help.aliyun.com/document_detail/2932733.html).</notice>
1067
1071
  *
1068
1072
  * @param request - CreateClusterRequest
1069
1073
  * @returns CreateClusterResponse
@@ -1752,14 +1756,14 @@ class Client extends openapi_core_1.default {
1752
1756
  return await this.deleteClusterNodepoolWithOptions(ClusterId, NodepoolId, request, headers, runtime);
1753
1757
  }
1754
1758
  /**
1755
- * Removes nodes from a cluster. When you remove nodes, you can specify whether to release the associated ECS instances and whether to automatically drain the nodes.
1759
+ * Removes nodes from a cluster. When removing nodes, you can specify whether to release the associated ECS instances and whether to automatically drain the nodes.
1756
1760
  *
1757
1761
  * @remarks
1758
- * - When removing nodes, perform standard operations by calling this API operation or using the [Container Service console](https://cs.console.aliyun.com). Do not manually remove nodes by running the `kubectl delete node` command.
1759
- * - Do not manually release nodes or remove instances in the ECS or Auto Scaling (ESS) console or by calling related API operations, or passively release nodes when a subscription instance expires. In these cases, the nodes are directly shut down and automatically removed from the Container Service console.
1760
- * - If the expected number of nodes is configured for a node pool, the node pool automatically scales out other instances based on the corresponding configurations to maintain the expected number of nodes.
1761
- * - Removing nodes involves pod migration and may affect your services. Perform this operation during off-peak hours. Unexpected risks may occur during the operation. Back up your data in advance.
1762
- * - When you remove nodes, ACK executes drain operations. Make sure that other nodes in the cluster have sufficient resources to avoid application pod scheduling failures.
1762
+ * - When removing nodes, perform standard operations by using this API operation or the [Container Service console](https://cs.console.aliyun.com). Do not manually remove nodes by running the `kubectl delete node` command.
1763
+ * - Do not manually release nodes or remove instances in the ECS or Auto Scaling (ESS) console (or by calling related API operations), or passively release nodes when a subscription instance expires. In these cases, the nodes are directly stopped and automatically removed from the Container Service console.
1764
+ * - If the expected number of nodes is configured for a node pool, the node pool automatically scales out other instances based on the configuration to maintain the expected number of nodes.
1765
+ * - Removing nodes involves pod migration, which may affect your services. Perform this operation during off-peak hours. Unexpected risks may occur during the operation. Back up your data in advance.
1766
+ * - When removing nodes, ACK executes a drain operation. Ensure that other nodes in the cluster have sufficient resources to avoid application pod scheduling failures.
1763
1767
  * - Check the node affinity rules and scheduling policies of the pods on the nodes to be removed to ensure that the pods can be scheduled to other nodes after the nodes are removed.
1764
1768
  *
1765
1769
  * @param request - DeleteClusterNodesRequest
@@ -1773,6 +1777,9 @@ class Client extends openapi_core_1.default {
1773
1777
  if (!$dara.isNull(request.drainNode)) {
1774
1778
  body["drain_node"] = request.drainNode;
1775
1779
  }
1780
+ if (!$dara.isNull(request.drainTimeoutSeconds)) {
1781
+ body["drain_timeout_seconds"] = request.drainTimeoutSeconds;
1782
+ }
1776
1783
  if (!$dara.isNull(request.nodes)) {
1777
1784
  body["nodes"] = request.nodes;
1778
1785
  }
@@ -1797,14 +1804,14 @@ class Client extends openapi_core_1.default {
1797
1804
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteClusterNodesResponse({}));
1798
1805
  }
1799
1806
  /**
1800
- * Removes nodes from a cluster. When you remove nodes, you can specify whether to release the associated ECS instances and whether to automatically drain the nodes.
1807
+ * Removes nodes from a cluster. When removing nodes, you can specify whether to release the associated ECS instances and whether to automatically drain the nodes.
1801
1808
  *
1802
1809
  * @remarks
1803
- * - When removing nodes, perform standard operations by calling this API operation or using the [Container Service console](https://cs.console.aliyun.com). Do not manually remove nodes by running the `kubectl delete node` command.
1804
- * - Do not manually release nodes or remove instances in the ECS or Auto Scaling (ESS) console or by calling related API operations, or passively release nodes when a subscription instance expires. In these cases, the nodes are directly shut down and automatically removed from the Container Service console.
1805
- * - If the expected number of nodes is configured for a node pool, the node pool automatically scales out other instances based on the corresponding configurations to maintain the expected number of nodes.
1806
- * - Removing nodes involves pod migration and may affect your services. Perform this operation during off-peak hours. Unexpected risks may occur during the operation. Back up your data in advance.
1807
- * - When you remove nodes, ACK executes drain operations. Make sure that other nodes in the cluster have sufficient resources to avoid application pod scheduling failures.
1810
+ * - When removing nodes, perform standard operations by using this API operation or the [Container Service console](https://cs.console.aliyun.com). Do not manually remove nodes by running the `kubectl delete node` command.
1811
+ * - Do not manually release nodes or remove instances in the ECS or Auto Scaling (ESS) console (or by calling related API operations), or passively release nodes when a subscription instance expires. In these cases, the nodes are directly stopped and automatically removed from the Container Service console.
1812
+ * - If the expected number of nodes is configured for a node pool, the node pool automatically scales out other instances based on the configuration to maintain the expected number of nodes.
1813
+ * - Removing nodes involves pod migration, which may affect your services. Perform this operation during off-peak hours. Unexpected risks may occur during the operation. Back up your data in advance.
1814
+ * - When removing nodes, ACK executes a drain operation. Ensure that other nodes in the cluster have sufficient resources to avoid application pod scheduling failures.
1808
1815
  * - Check the node affinity rules and scheduling policies of the pods on the nodes to be removed to ensure that the pods can be scheduled to other nodes after the nodes are removed.
1809
1816
  *
1810
1817
  * @param request - DeleteClusterNodesRequest
@@ -2440,7 +2447,7 @@ class Client extends openapi_core_1.default {
2440
2447
  return await this.describeClusterAddonsVersionWithOptions(ClusterId, headers, runtime);
2441
2448
  }
2442
2449
  /**
2443
- * Retrieves the script used to add existing ECS instances to an ACK cluster as worker nodes, or to re-add removed worker nodes to a node pool. ACK supports manually adding existing nodes to a node pool. You can invoke the DescribeClusterAttachScripts operation to obtain the script for adding existing nodes.
2450
+ * Queries the script for adding existing nodes to a cluster node pool. Container Service for Kubernetes (ACK) supports manually adding existing nodes to a node pool if you need to add existing ECS instances to an ACK cluster as worker nodes or re-add node instances to a node pool after removing worker nodes. You can invoke the DescribeClusterAttachScripts operation to obtain the script for adding existing nodes.
2444
2451
  *
2445
2452
  * @param request - DescribeClusterAttachScriptsRequest
2446
2453
  * @param headers - map
@@ -2492,7 +2499,7 @@ class Client extends openapi_core_1.default {
2492
2499
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeClusterAttachScriptsResponse({}));
2493
2500
  }
2494
2501
  /**
2495
- * Retrieves the script used to add existing ECS instances to an ACK cluster as worker nodes, or to re-add removed worker nodes to a node pool. ACK supports manually adding existing nodes to a node pool. You can invoke the DescribeClusterAttachScripts operation to obtain the script for adding existing nodes.
2502
+ * Queries the script for adding existing nodes to a cluster node pool. Container Service for Kubernetes (ACK) supports manually adding existing nodes to a node pool if you need to add existing ECS instances to an ACK cluster as worker nodes or re-add node instances to a node pool after removing worker nodes. You can invoke the DescribeClusterAttachScripts operation to obtain the script for adding existing nodes.
2496
2503
  *
2497
2504
  * @param request - DescribeClusterAttachScriptsRequest
2498
2505
  * @returns DescribeClusterAttachScriptsResponse
@@ -3059,7 +3066,7 @@ class Client extends openapi_core_1.default {
3059
3066
  return await this.describeClustersWithOptions(request, headers, runtime);
3060
3067
  }
3061
3068
  /**
3062
- * Queries the list of all clusters in a specified region.
3069
+ * Queries all clusters in a specified region.
3063
3070
  *
3064
3071
  * @param request - DescribeClustersForRegionRequest
3065
3072
  * @param headers - map
@@ -3108,7 +3115,7 @@ class Client extends openapi_core_1.default {
3108
3115
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeClustersForRegionResponse({}));
3109
3116
  }
3110
3117
  /**
3111
- * Queries the list of all clusters in a specified region.
3118
+ * Queries all clusters in a specified region.
3112
3119
  *
3113
3120
  * @param request - DescribeClustersForRegionRequest
3114
3121
  * @returns DescribeClustersForRegionResponse
@@ -3349,7 +3356,7 @@ class Client extends openapi_core_1.default {
3349
3356
  return await this.describeExternalAgentWithOptions(ClusterId, request, headers, runtime);
3350
3357
  }
3351
3358
  /**
3352
- * Queries the details of Kubernetes versions, including version information, release dates, expiration dates, compatible operating systems, and supported runtimes.
3359
+ * Queries the details of Kubernetes versions, including version information, release dates, expiration dates, compatible operating systems, and runtimes.
3353
3360
  *
3354
3361
  * @param request - DescribeKubernetesVersionMetadataRequest
3355
3362
  * @param headers - map
@@ -3401,7 +3408,7 @@ class Client extends openapi_core_1.default {
3401
3408
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeKubernetesVersionMetadataResponse({}));
3402
3409
  }
3403
3410
  /**
3404
- * Queries the details of Kubernetes versions, including version information, release dates, expiration dates, compatible operating systems, and supported runtimes.
3411
+ * Queries the details of Kubernetes versions, including version information, release dates, expiration dates, compatible operating systems, and runtimes.
3405
3412
  *
3406
3413
  * @param request - DescribeKubernetesVersionMetadataRequest
3407
3414
  * @returns DescribeKubernetesVersionMetadataResponse
@@ -5251,10 +5258,10 @@ class Client extends openapi_core_1.default {
5251
5258
  return await this.listTagResourcesWithOptions(request, headers, runtime);
5252
5259
  }
5253
5260
  /**
5254
- * Queries the KubeConfig status list of all clusters for the current user.
5261
+ * Queries the KubeConfig status list for all clusters of the current user.
5255
5262
  *
5256
5263
  * @remarks
5257
- * > To call this operation, you must have the permissions to manage Container Service (CS) (AliyunCSFullAccess).
5264
+ * > To call this operation, you must have the AliyunCSFullAccess permission to manage Container Service for Kubernetes (CS).
5258
5265
  *
5259
5266
  * @param request - ListUserKubeConfigStatesRequest
5260
5267
  * @param headers - map
@@ -5288,10 +5295,10 @@ class Client extends openapi_core_1.default {
5288
5295
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.ListUserKubeConfigStatesResponse({}));
5289
5296
  }
5290
5297
  /**
5291
- * Queries the KubeConfig status list of all clusters for the current user.
5298
+ * Queries the KubeConfig status list for all clusters of the current user.
5292
5299
  *
5293
5300
  * @remarks
5294
- * > To call this operation, you must have the permissions to manage Container Service (CS) (AliyunCSFullAccess).
5301
+ * > To call this operation, you must have the AliyunCSFullAccess permission to manage Container Service for Kubernetes (CS).
5295
5302
  *
5296
5303
  * @param request - ListUserKubeConfigStatesRequest
5297
5304
  * @returns ListUserKubeConfigStatesResponse
@@ -5404,10 +5411,10 @@ class Client extends openapi_core_1.default {
5404
5411
  return await this.modifyAutoRepairPolicyWithOptions(clusterId, policyId, request, headers, runtime);
5405
5412
  }
5406
5413
  /**
5407
- * Modifies the configuration of an ACK cluster.
5414
+ * Modifies the configurations of an ACK cluster.
5408
5415
  *
5409
5416
  * @remarks
5410
- * <notice>Starting from July 4, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For more information about the changes, see [Announcement on changes to OpenAPI request and response parameters and OpenAPI deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
5417
+ * <notice>Starting July 4, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For more information about the changes, see [Announcement on changes to request and response parameters of ACK cluster management API operations and API operation deprecation](https://help.aliyun.com/document_detail/2932733.html).</notice>
5411
5418
  *
5412
5419
  * @param request - ModifyClusterRequest
5413
5420
  * @param headers - map
@@ -5501,10 +5508,10 @@ class Client extends openapi_core_1.default {
5501
5508
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.ModifyClusterResponse({}));
5502
5509
  }
5503
5510
  /**
5504
- * Modifies the configuration of an ACK cluster.
5511
+ * Modifies the configurations of an ACK cluster.
5505
5512
  *
5506
5513
  * @remarks
5507
- * <notice>Starting from July 4, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For more information about the changes, see [Announcement on changes to OpenAPI request and response parameters and OpenAPI deprecation for ACK cluster management](https://help.aliyun.com/document_detail/2932733.html).</notice>
5514
+ * <notice>Starting July 4, 2026, the request parameters instance_deletion_protection, ingress_loadbalancer_id, and access_control_list will no longer take effect. For more information about the changes, see [Announcement on changes to request and response parameters of ACK cluster management API operations and API operation deprecation](https://help.aliyun.com/document_detail/2932733.html).</notice>
5508
5515
  *
5509
5516
  * @param request - ModifyClusterRequest
5510
5517
  * @returns ModifyClusterResponse
@@ -6008,14 +6015,14 @@ class Client extends openapi_core_1.default {
6008
6015
  return await this.removeClusterNodesWithOptions(ClusterId, request, headers, runtime);
6009
6016
  }
6010
6017
  /**
6011
- * Removes nodes from a node pool in a cluster and adjusts the expected number of nodes when the nodes are no longer needed. When removing nodes, you can specify whether to release the associated ECS instances and whether to automatically drain the nodes. Removing nodes involves pod migration and may affect your services. Perform this operation during off-peak hours and back up your data in advance.
6018
+ * Removes nodes from a node pool in a cluster and adjusts the expected number of nodes when the nodes are no longer needed. When removing nodes, you can specify whether to release the associated Elastic Compute Service (ECS) instances and whether to automatically drain the nodes. Removing nodes involves pod migration, which may affect your services. Perform this operation during off-peak hours and back up your data in advance.
6012
6019
  *
6013
6020
  * @remarks
6014
- * - Removing nodes involves pod migration and may affect your services. Perform this operation during off-peak hours.
6021
+ * - Removing nodes involves pod migration, which may affect your services. Perform this operation during off-peak hours.
6015
6022
  * - Unexpected risks may occur during the operation. Back up your data in advance.
6016
- * - During the operation, the system sets the nodes to the unschedulable state.
6023
+ * - During the operation, the system sets the current nodes to the unschedulable state.
6017
6024
  * - Only worker nodes are removed. Master nodes are not removed.
6018
- * - Even if you choose to release nodes (by setting `release_node` to `true`), subscription nodes are not released. To release subscription nodes, you must first [change their billing method to pay-as-you-go](https://www.alibabacloud.com/help/en/ecs/change-the-billing-method-of-an-instance-from-subscription-to-pay-as-you-go-1) and then release them in the [ECS console](https://ecs.console.aliyun.com/).
6025
+ * - Even if you choose to release nodes (that is, set `release_node` to `true`), subscription nodes are not released. To release subscription nodes, you must remove them first and then release them in the [ECS console](https://ecs.console.aliyun.com/).
6019
6026
  *
6020
6027
  * @param tmpReq - RemoveNodePoolNodesRequest
6021
6028
  * @param headers - map
@@ -6039,6 +6046,9 @@ class Client extends openapi_core_1.default {
6039
6046
  if (!$dara.isNull(request.drainNode)) {
6040
6047
  query["drain_node"] = request.drainNode;
6041
6048
  }
6049
+ if (!$dara.isNull(request.drainTimeoutSeconds)) {
6050
+ query["drain_timeout_seconds"] = request.drainTimeoutSeconds;
6051
+ }
6042
6052
  if (!$dara.isNull(request.instanceIdsShrink)) {
6043
6053
  query["instance_ids"] = request.instanceIdsShrink;
6044
6054
  }
@@ -6066,14 +6076,14 @@ class Client extends openapi_core_1.default {
6066
6076
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.RemoveNodePoolNodesResponse({}));
6067
6077
  }
6068
6078
  /**
6069
- * Removes nodes from a node pool in a cluster and adjusts the expected number of nodes when the nodes are no longer needed. When removing nodes, you can specify whether to release the associated ECS instances and whether to automatically drain the nodes. Removing nodes involves pod migration and may affect your services. Perform this operation during off-peak hours and back up your data in advance.
6079
+ * Removes nodes from a node pool in a cluster and adjusts the expected number of nodes when the nodes are no longer needed. When removing nodes, you can specify whether to release the associated Elastic Compute Service (ECS) instances and whether to automatically drain the nodes. Removing nodes involves pod migration, which may affect your services. Perform this operation during off-peak hours and back up your data in advance.
6070
6080
  *
6071
6081
  * @remarks
6072
- * - Removing nodes involves pod migration and may affect your services. Perform this operation during off-peak hours.
6082
+ * - Removing nodes involves pod migration, which may affect your services. Perform this operation during off-peak hours.
6073
6083
  * - Unexpected risks may occur during the operation. Back up your data in advance.
6074
- * - During the operation, the system sets the nodes to the unschedulable state.
6084
+ * - During the operation, the system sets the current nodes to the unschedulable state.
6075
6085
  * - Only worker nodes are removed. Master nodes are not removed.
6076
- * - Even if you choose to release nodes (by setting `release_node` to `true`), subscription nodes are not released. To release subscription nodes, you must first [change their billing method to pay-as-you-go](https://www.alibabacloud.com/help/en/ecs/change-the-billing-method-of-an-instance-from-subscription-to-pay-as-you-go-1) and then release them in the [ECS console](https://ecs.console.aliyun.com/).
6086
+ * - Even if you choose to release nodes (that is, set `release_node` to `true`), subscription nodes are not released. To release subscription nodes, you must remove them first and then release them in the [ECS console](https://ecs.console.aliyun.com/).
6077
6087
  *
6078
6088
  * @param request - RemoveNodePoolNodesRequest
6079
6089
  * @returns RemoveNodePoolNodesResponse
@@ -6860,7 +6870,7 @@ class Client extends openapi_core_1.default {
6860
6870
  return await this.untagResourcesWithOptions(request, headers, runtime);
6861
6871
  }
6862
6872
  /**
6863
- * Enables or disables the audit log feature for a specified ACK cluster, or updates the audit log configurations to record requests to the Kubernetes API and the corresponding results for tracing cluster operation history and troubleshooting cluster faults.
6873
+ * Updates the audit log configuration of a specified ACK cluster. You can call this operation to enable or disable the audit log feature, or update the audit log configuration to record requests to the Kubernetes API and their results for tracing cluster operation history and troubleshooting cluster faults.
6864
6874
  *
6865
6875
  * @remarks
6866
6876
  * Before you call this operation, make sure that you fully understand the billing methods and pricing of <props="china">[Simple Log Service](https://www.aliyun.com/price/product#/sls/detail/sls)<props="intl">[Simple Log Service](https://www.alibabacloud.com/product/log-service/pricing).
@@ -6897,7 +6907,7 @@ class Client extends openapi_core_1.default {
6897
6907
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateClusterAuditLogConfigResponse({}));
6898
6908
  }
6899
6909
  /**
6900
- * Enables or disables the audit log feature for a specified ACK cluster, or updates the audit log configurations to record requests to the Kubernetes API and the corresponding results for tracing cluster operation history and troubleshooting cluster faults.
6910
+ * Updates the audit log configuration of a specified ACK cluster. You can call this operation to enable or disable the audit log feature, or update the audit log configuration to record requests to the Kubernetes API and their results for tracing cluster operation history and troubleshooting cluster faults.
6901
6911
  *
6902
6912
  * @remarks
6903
6913
  * Before you call this operation, make sure that you fully understand the billing methods and pricing of <props="china">[Simple Log Service](https://www.aliyun.com/price/product#/sls/detail/sls)<props="intl">[Simple Log Service](https://www.alibabacloud.com/product/log-service/pricing).
@@ -7391,10 +7401,10 @@ class Client extends openapi_core_1.default {
7391
7401
  return await this.updateTemplateWithOptions(TemplateId, request, headers, runtime);
7392
7402
  }
7393
7403
  /**
7394
- * Updates the Role-Based Access Control (RBAC) access permissions of a Resource Access Management (RAM) user or RAM role in an ACK cluster. By default, RAM users, RAM roles, and users other than the cluster creator do not have any RBAC access permissions in the cluster. You can invoke the UpdateUserPermissions operation to update the RBAC access permissions of a RAM user or RAM role, including the accessible resources, the scope of the permissions, and the preset role types, to improve secure access control in cluster management.
7404
+ * Updates the RBAC access permissions of a Resource Access Management (RAM) user or RAM role in an ACK cluster. By default, RAM users and RAM roles other than the cluster creator do not have any RBAC access permissions in the cluster. You can invoke the UpdateUserPermissions operation to update the RBAC access permissions of a RAM user or role, including the accessible resources, the scope of the permissions, and the preset role types, to improve secure access control in cluster management.
7395
7405
  *
7396
7406
  * @remarks
7397
- * You can update the cluster authorization information of a target Resource Access Management (RAM) user or RAM role by using a full update or an incremental update. A full update overwrites the existing cluster permissions of the target RAM user or RAM role. The request must include all permission configurations that you want to grant to the target RAM user or RAM role. An incremental update includes add and delete operations. It only modifies the permissions based on the cluster authorization information included in the request and does not affect other cluster permissions of the RAM user or RAM role.
7407
+ * You can update the cluster authorization information of a target Resource Access Management (RAM) user or RAM role by using full update or incremental update. A full update overwrites the existing cluster permissions of the target RAM user or RAM role. The request must include all permission configurations that you want to grant to the target RAM user or RAM role. An incremental update includes add and delete operations. It only modifies the permissions based on the cluster authorization information included in the request and does not affect other cluster permissions of the RAM user or RAM role.
7398
7408
  *
7399
7409
  * @param request - UpdateUserPermissionsRequest
7400
7410
  * @param headers - map
@@ -7426,10 +7436,10 @@ class Client extends openapi_core_1.default {
7426
7436
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.UpdateUserPermissionsResponse({}));
7427
7437
  }
7428
7438
  /**
7429
- * Updates the Role-Based Access Control (RBAC) access permissions of a Resource Access Management (RAM) user or RAM role in an ACK cluster. By default, RAM users, RAM roles, and users other than the cluster creator do not have any RBAC access permissions in the cluster. You can invoke the UpdateUserPermissions operation to update the RBAC access permissions of a RAM user or RAM role, including the accessible resources, the scope of the permissions, and the preset role types, to improve secure access control in cluster management.
7439
+ * Updates the RBAC access permissions of a Resource Access Management (RAM) user or RAM role in an ACK cluster. By default, RAM users and RAM roles other than the cluster creator do not have any RBAC access permissions in the cluster. You can invoke the UpdateUserPermissions operation to update the RBAC access permissions of a RAM user or role, including the accessible resources, the scope of the permissions, and the preset role types, to improve secure access control in cluster management.
7430
7440
  *
7431
7441
  * @remarks
7432
- * You can update the cluster authorization information of a target Resource Access Management (RAM) user or RAM role by using a full update or an incremental update. A full update overwrites the existing cluster permissions of the target RAM user or RAM role. The request must include all permission configurations that you want to grant to the target RAM user or RAM role. An incremental update includes add and delete operations. It only modifies the permissions based on the cluster authorization information included in the request and does not affect other cluster permissions of the RAM user or RAM role.
7442
+ * You can update the cluster authorization information of a target Resource Access Management (RAM) user or RAM role by using full update or incremental update. A full update overwrites the existing cluster permissions of the target RAM user or RAM role. The request must include all permission configurations that you want to grant to the target RAM user or RAM role. An incremental update includes add and delete operations. It only modifies the permissions based on the cluster authorization information included in the request and does not affect other cluster permissions of the RAM user or RAM role.
7433
7443
  *
7434
7444
  * @param request - UpdateUserPermissionsRequest
7435
7445
  * @returns UpdateUserPermissionsResponse