@alicloud/ecs20140526 7.8.6 → 7.9.0

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 (249) hide show
  1. package/dist/client.d.ts +843 -846
  2. package/dist/client.js +872 -842
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/AcceptInquiredSystemEventRequest.d.ts +3 -3
  5. package/dist/models/AssignIpv6addressesRequest.d.ts +7 -7
  6. package/dist/models/AssignIpv6addressesResponseBody.d.ts +1 -1
  7. package/dist/models/AssignPrivateIpAddressesRequest.d.ts +13 -16
  8. package/dist/models/AssignPrivateIpAddressesRequest.js.map +1 -1
  9. package/dist/models/AssignPrivateIpAddressesResponseBody.d.ts +2 -2
  10. package/dist/models/AttachNetworkInterfaceRequest.d.ts +6 -7
  11. package/dist/models/AttachNetworkInterfaceRequest.js.map +1 -1
  12. package/dist/models/AuthorizeSecurityGroupEgressRequest.d.ts +73 -100
  13. package/dist/models/AuthorizeSecurityGroupEgressRequest.js.map +1 -1
  14. package/dist/models/AuthorizeSecurityGroupRequest.d.ts +70 -91
  15. package/dist/models/AuthorizeSecurityGroupRequest.js.map +1 -1
  16. package/dist/models/AuthorizeSecurityGroupResponseBody.d.ts +1 -1
  17. package/dist/models/CancelImagePipelineExecutionRequest.d.ts +2 -2
  18. package/dist/models/CreateActivationRequest.d.ts +17 -16
  19. package/dist/models/CreateActivationRequest.js.map +1 -1
  20. package/dist/models/CreateActivationResponseBody.d.ts +3 -3
  21. package/dist/models/CreateCommandRequest.d.ts +52 -73
  22. package/dist/models/CreateCommandRequest.js.map +1 -1
  23. package/dist/models/CreateCommandResponseBody.d.ts +2 -2
  24. package/dist/models/CreateDiskRequest.d.ts +57 -59
  25. package/dist/models/CreateDiskRequest.js.map +1 -1
  26. package/dist/models/CreateDiskResponseBody.d.ts +3 -3
  27. package/dist/models/CreateHpcClusterRequest.d.ts +5 -5
  28. package/dist/models/CreateHpcClusterResponseBody.d.ts +2 -2
  29. package/dist/models/CreateImageComponentRequest.d.ts +7 -7
  30. package/dist/models/CreateImageComponentResponseBody.d.ts +1 -1
  31. package/dist/models/CreateInstanceRequest.d.ts +184 -274
  32. package/dist/models/CreateInstanceRequest.js.map +1 -1
  33. package/dist/models/CreateInstanceResponseBody.d.ts +2 -2
  34. package/dist/models/CreateLaunchTemplateVersionRequest.d.ts +215 -244
  35. package/dist/models/CreateLaunchTemplateVersionRequest.js.map +1 -1
  36. package/dist/models/CreateLaunchTemplateVersionResponseBody.d.ts +2 -2
  37. package/dist/models/CreateSecurityGroupRequest.d.ts +13 -16
  38. package/dist/models/CreateSecurityGroupRequest.js.map +1 -1
  39. package/dist/models/CreateSecurityGroupResponseBody.d.ts +1 -1
  40. package/dist/models/DeleteHpcClusterRequest.d.ts +2 -2
  41. package/dist/models/DeleteImagePipelineRequest.d.ts +1 -1
  42. package/dist/models/DescribeAutoProvisioningGroupInstancesRequest.d.ts +5 -5
  43. package/dist/models/DescribeAutoProvisioningGroupInstancesResponseBody.d.ts +1 -1
  44. package/dist/models/DescribeAutoSnapshotPolicyExRequest.d.ts +11 -11
  45. package/dist/models/DescribeAutoSnapshotPolicyExResponseBody.d.ts +3 -3
  46. package/dist/models/DescribeAvailableResourceRequest.d.ts +50 -84
  47. package/dist/models/DescribeAvailableResourceRequest.js.map +1 -1
  48. package/dist/models/DescribeAvailableResourceResponseBody.d.ts +0 -4
  49. package/dist/models/DescribeAvailableResourceResponseBody.js.map +1 -1
  50. package/dist/models/DescribeDisksRequest.d.ts +40 -40
  51. package/dist/models/DescribeDisksResponseBody.d.ts +3 -3
  52. package/dist/models/DescribeImageComponentsRequest.d.ts +3 -3
  53. package/dist/models/DescribeImageComponentsResponseBody.d.ts +1 -1
  54. package/dist/models/DescribeInstanceAttributeRequest.d.ts +1 -1
  55. package/dist/models/DescribeInstanceAttributeResponseBody.d.ts +64 -96
  56. package/dist/models/DescribeInstanceAttributeResponseBody.js.map +1 -1
  57. package/dist/models/DescribeInstanceHistoryEventsRequest.d.ts +50 -85
  58. package/dist/models/DescribeInstanceHistoryEventsRequest.js.map +1 -1
  59. package/dist/models/DescribeInstanceHistoryEventsResponseBody.d.ts +16 -18
  60. package/dist/models/DescribeInstanceHistoryEventsResponseBody.js +2 -0
  61. package/dist/models/DescribeInstanceHistoryEventsResponseBody.js.map +1 -1
  62. package/dist/models/DescribeInstanceTopologyResponseBody.d.ts +14 -0
  63. package/dist/models/DescribeInstanceTopologyResponseBody.js +28 -1
  64. package/dist/models/DescribeInstanceTopologyResponseBody.js.map +1 -1
  65. package/dist/models/DescribeInstancesRequest.d.ts +54 -68
  66. package/dist/models/DescribeInstancesRequest.js.map +1 -1
  67. package/dist/models/DescribeInstancesResponseBody.d.ts +5 -5
  68. package/dist/models/DescribeInvocationResultsRequest.d.ts +52 -69
  69. package/dist/models/DescribeInvocationResultsRequest.js.map +1 -1
  70. package/dist/models/DescribeInvocationResultsResponseBody.d.ts +6 -52
  71. package/dist/models/DescribeInvocationResultsResponseBody.js.map +1 -1
  72. package/dist/models/DescribeInvocationsRequest.d.ts +49 -76
  73. package/dist/models/DescribeInvocationsRequest.js.map +1 -1
  74. package/dist/models/DescribeInvocationsResponseBody.d.ts +5 -5
  75. package/dist/models/DescribeLaunchTemplateVersionsRequest.d.ts +14 -14
  76. package/dist/models/DescribeLaunchTemplateVersionsResponseBody.d.ts +3 -3
  77. package/dist/models/DescribeNetworkInterfacePermissionsRequest.d.ts +4 -4
  78. package/dist/models/DescribePriceRequest.d.ts +158 -242
  79. package/dist/models/DescribePriceRequest.js.map +1 -1
  80. package/dist/models/DescribePriceResponseBody.d.ts +15 -15
  81. package/dist/models/DescribeRecommendInstanceTypeRequest.d.ts +45 -57
  82. package/dist/models/DescribeRecommendInstanceTypeRequest.js.map +1 -1
  83. package/dist/models/DescribeResourcesModificationRequest.d.ts +26 -37
  84. package/dist/models/DescribeResourcesModificationRequest.js.map +1 -1
  85. package/dist/models/DescribeSecurityGroupAttributeRequest.d.ts +17 -28
  86. package/dist/models/DescribeSecurityGroupAttributeRequest.js.map +1 -1
  87. package/dist/models/DescribeSecurityGroupAttributeResponseBody.d.ts +10 -9
  88. package/dist/models/DescribeSecurityGroupAttributeResponseBody.js.map +1 -1
  89. package/dist/models/DescribeSecurityGroupsRequest.d.ts +20 -20
  90. package/dist/models/DescribeSecurityGroupsResponseBody.d.ts +4 -4
  91. package/dist/models/DescribeSendFileResultsRequest.d.ts +21 -25
  92. package/dist/models/DescribeSendFileResultsRequest.js.map +1 -1
  93. package/dist/models/DescribeSendFileResultsResponseBody.d.ts +3 -3
  94. package/dist/models/DescribeSnapshotsRequest.d.ts +44 -59
  95. package/dist/models/DescribeSnapshotsRequest.js.map +1 -1
  96. package/dist/models/DescribeSnapshotsResponseBody.d.ts +4 -8
  97. package/dist/models/DescribeSnapshotsResponseBody.js.map +1 -1
  98. package/dist/models/DescribeSpotPriceHistoryRequest.d.ts +22 -28
  99. package/dist/models/DescribeSpotPriceHistoryRequest.js.map +1 -1
  100. package/dist/models/DescribeSpotPriceHistoryResponseBody.d.ts +7 -3
  101. package/dist/models/DescribeSpotPriceHistoryResponseBody.js.map +1 -1
  102. package/dist/models/DescribeTerminalSessionsRequest.d.ts +3 -3
  103. package/dist/models/DescribeTerminalSessionsResponseBody.d.ts +1 -1
  104. package/dist/models/DescribeZonesRequest.d.ts +18 -28
  105. package/dist/models/DescribeZonesRequest.js.map +1 -1
  106. package/dist/models/DescribeZonesResponseBody.d.ts +1 -1
  107. package/dist/models/GetInstanceConsoleOutputRequest.d.ts +1 -1
  108. package/dist/models/GetInstanceConsoleOutputResponseBody.d.ts +2 -2
  109. package/dist/models/ModifyHpcClusterAttributeRequest.d.ts +1 -1
  110. package/dist/models/ModifyInstanceAttributeRequest.d.ts +78 -106
  111. package/dist/models/ModifyInstanceAttributeRequest.js.map +1 -1
  112. package/dist/models/ModifyInstanceNetworkSpecRequest.d.ts +14 -14
  113. package/dist/models/ModifyInstanceNetworkSpecResponseBody.d.ts +1 -1
  114. package/dist/models/ModifyInstanceSpecRequest.d.ts +16 -16
  115. package/dist/models/ModifyPlanMaintenanceWindowRequest.d.ts +4 -4
  116. package/dist/models/ModifyPrepayInstanceSpecRequest.d.ts +28 -46
  117. package/dist/models/ModifyPrepayInstanceSpecRequest.js.map +1 -1
  118. package/dist/models/ModifyPrepayInstanceSpecResponseBody.d.ts +2 -2
  119. package/dist/models/ModifySecurityGroupEgressRuleRequest.d.ts +47 -46
  120. package/dist/models/ModifySecurityGroupEgressRuleRequest.js.map +1 -1
  121. package/dist/models/ModifySecurityGroupRuleRequest.d.ts +27 -24
  122. package/dist/models/ModifySecurityGroupRuleRequest.js.map +1 -1
  123. package/dist/models/ModifySystemEventAttributeRequest.d.ts +45 -0
  124. package/dist/models/ModifySystemEventAttributeRequest.js +64 -0
  125. package/dist/models/ModifySystemEventAttributeRequest.js.map +1 -0
  126. package/dist/models/ModifySystemEventAttributeResponse.d.ts +19 -0
  127. package/dist/models/ModifySystemEventAttributeResponse.js +69 -0
  128. package/dist/models/ModifySystemEventAttributeResponse.js.map +1 -0
  129. package/dist/models/ModifySystemEventAttributeResponseBody.d.ts +18 -0
  130. package/dist/models/ModifySystemEventAttributeResponseBody.js +58 -0
  131. package/dist/models/ModifySystemEventAttributeResponseBody.js.map +1 -0
  132. package/dist/models/RenewElasticityAssurancesRequest.d.ts +28 -24
  133. package/dist/models/RenewElasticityAssurancesRequest.js.map +1 -1
  134. package/dist/models/RenewElasticityAssurancesResponseBody.d.ts +1 -1
  135. package/dist/models/RevokeSecurityGroupEgressRequest.d.ts +35 -37
  136. package/dist/models/RevokeSecurityGroupEgressRequest.js.map +1 -1
  137. package/dist/models/RevokeSecurityGroupRequest.d.ts +71 -89
  138. package/dist/models/RevokeSecurityGroupRequest.js.map +1 -1
  139. package/dist/models/StartTerminalSessionRequest.d.ts +24 -32
  140. package/dist/models/StartTerminalSessionRequest.js.map +1 -1
  141. package/dist/models/StartTerminalSessionResponseBody.d.ts +2 -2
  142. package/dist/models/StartTerminalSessionShrinkRequest.d.ts +16 -18
  143. package/dist/models/StartTerminalSessionShrinkRequest.js.map +1 -1
  144. package/dist/models/StopInstanceRequest.d.ts +20 -27
  145. package/dist/models/StopInstanceRequest.js.map +1 -1
  146. package/dist/models/StopInstancesRequest.d.ts +24 -35
  147. package/dist/models/StopInstancesRequest.js.map +1 -1
  148. package/dist/models/UnassignIpv6addressesRequest.d.ts +3 -3
  149. package/dist/models/model.d.ts +4 -0
  150. package/dist/models/model.js +45 -37
  151. package/dist/models/model.js.map +1 -1
  152. package/package.json +1 -1
  153. package/src/client.ts +878 -842
  154. package/src/models/AcceptInquiredSystemEventRequest.ts +3 -3
  155. package/src/models/AssignIpv6addressesRequest.ts +7 -7
  156. package/src/models/AssignIpv6addressesResponseBody.ts +1 -1
  157. package/src/models/AssignPrivateIpAddressesRequest.ts +13 -16
  158. package/src/models/AssignPrivateIpAddressesResponseBody.ts +2 -2
  159. package/src/models/AttachNetworkInterfaceRequest.ts +6 -7
  160. package/src/models/AuthorizeSecurityGroupEgressRequest.ts +79 -106
  161. package/src/models/AuthorizeSecurityGroupRequest.ts +70 -91
  162. package/src/models/AuthorizeSecurityGroupResponseBody.ts +1 -1
  163. package/src/models/CancelImagePipelineExecutionRequest.ts +2 -2
  164. package/src/models/CreateActivationRequest.ts +17 -16
  165. package/src/models/CreateActivationResponseBody.ts +3 -3
  166. package/src/models/CreateCommandRequest.ts +52 -73
  167. package/src/models/CreateCommandResponseBody.ts +2 -2
  168. package/src/models/CreateDiskRequest.ts +57 -59
  169. package/src/models/CreateDiskResponseBody.ts +3 -3
  170. package/src/models/CreateHpcClusterRequest.ts +5 -5
  171. package/src/models/CreateHpcClusterResponseBody.ts +2 -2
  172. package/src/models/CreateImageComponentRequest.ts +7 -7
  173. package/src/models/CreateImageComponentResponseBody.ts +1 -1
  174. package/src/models/CreateInstanceRequest.ts +185 -275
  175. package/src/models/CreateInstanceResponseBody.ts +2 -2
  176. package/src/models/CreateLaunchTemplateVersionRequest.ts +215 -244
  177. package/src/models/CreateLaunchTemplateVersionResponseBody.ts +2 -2
  178. package/src/models/CreateSecurityGroupRequest.ts +13 -16
  179. package/src/models/CreateSecurityGroupResponseBody.ts +1 -1
  180. package/src/models/DeleteHpcClusterRequest.ts +2 -2
  181. package/src/models/DeleteImagePipelineRequest.ts +1 -1
  182. package/src/models/DescribeAutoProvisioningGroupInstancesRequest.ts +5 -5
  183. package/src/models/DescribeAutoProvisioningGroupInstancesResponseBody.ts +1 -1
  184. package/src/models/DescribeAutoSnapshotPolicyExRequest.ts +11 -11
  185. package/src/models/DescribeAutoSnapshotPolicyExResponseBody.ts +3 -3
  186. package/src/models/DescribeAvailableResourceRequest.ts +62 -96
  187. package/src/models/DescribeAvailableResourceResponseBody.ts +0 -4
  188. package/src/models/DescribeDisksRequest.ts +40 -40
  189. package/src/models/DescribeDisksResponseBody.ts +3 -3
  190. package/src/models/DescribeImageComponentsRequest.ts +3 -3
  191. package/src/models/DescribeImageComponentsResponseBody.ts +1 -1
  192. package/src/models/DescribeInstanceAttributeRequest.ts +1 -1
  193. package/src/models/DescribeInstanceAttributeResponseBody.ts +66 -98
  194. package/src/models/DescribeInstanceHistoryEventsRequest.ts +50 -85
  195. package/src/models/DescribeInstanceHistoryEventsResponseBody.ts +18 -18
  196. package/src/models/DescribeInstanceTopologyResponseBody.ts +32 -0
  197. package/src/models/DescribeInstancesRequest.ts +57 -71
  198. package/src/models/DescribeInstancesResponseBody.ts +5 -5
  199. package/src/models/DescribeInvocationResultsRequest.ts +52 -69
  200. package/src/models/DescribeInvocationResultsResponseBody.ts +6 -52
  201. package/src/models/DescribeInvocationsRequest.ts +50 -77
  202. package/src/models/DescribeInvocationsResponseBody.ts +5 -5
  203. package/src/models/DescribeLaunchTemplateVersionsRequest.ts +14 -14
  204. package/src/models/DescribeLaunchTemplateVersionsResponseBody.ts +3 -3
  205. package/src/models/DescribeNetworkInterfacePermissionsRequest.ts +4 -4
  206. package/src/models/DescribePriceRequest.ts +160 -244
  207. package/src/models/DescribePriceResponseBody.ts +15 -15
  208. package/src/models/DescribeRecommendInstanceTypeRequest.ts +45 -57
  209. package/src/models/DescribeResourcesModificationRequest.ts +30 -41
  210. package/src/models/DescribeSecurityGroupAttributeRequest.ts +18 -29
  211. package/src/models/DescribeSecurityGroupAttributeResponseBody.ts +11 -10
  212. package/src/models/DescribeSecurityGroupsRequest.ts +21 -21
  213. package/src/models/DescribeSecurityGroupsResponseBody.ts +4 -4
  214. package/src/models/DescribeSendFileResultsRequest.ts +21 -25
  215. package/src/models/DescribeSendFileResultsResponseBody.ts +3 -3
  216. package/src/models/DescribeSnapshotsRequest.ts +48 -63
  217. package/src/models/DescribeSnapshotsResponseBody.ts +4 -8
  218. package/src/models/DescribeSpotPriceHistoryRequest.ts +22 -28
  219. package/src/models/DescribeSpotPriceHistoryResponseBody.ts +7 -3
  220. package/src/models/DescribeTerminalSessionsRequest.ts +3 -3
  221. package/src/models/DescribeTerminalSessionsResponseBody.ts +1 -1
  222. package/src/models/DescribeZonesRequest.ts +20 -30
  223. package/src/models/DescribeZonesResponseBody.ts +1 -1
  224. package/src/models/GetInstanceConsoleOutputRequest.ts +1 -1
  225. package/src/models/GetInstanceConsoleOutputResponseBody.ts +2 -2
  226. package/src/models/ModifyHpcClusterAttributeRequest.ts +1 -1
  227. package/src/models/ModifyInstanceAttributeRequest.ts +80 -108
  228. package/src/models/ModifyInstanceNetworkSpecRequest.ts +14 -14
  229. package/src/models/ModifyInstanceNetworkSpecResponseBody.ts +1 -1
  230. package/src/models/ModifyInstanceSpecRequest.ts +16 -16
  231. package/src/models/ModifyPlanMaintenanceWindowRequest.ts +4 -4
  232. package/src/models/ModifyPrepayInstanceSpecRequest.ts +28 -46
  233. package/src/models/ModifyPrepayInstanceSpecResponseBody.ts +2 -2
  234. package/src/models/ModifySecurityGroupEgressRuleRequest.ts +47 -46
  235. package/src/models/ModifySecurityGroupRuleRequest.ts +27 -24
  236. package/src/models/ModifySystemEventAttributeRequest.ts +64 -0
  237. package/src/models/ModifySystemEventAttributeResponse.ts +40 -0
  238. package/src/models/ModifySystemEventAttributeResponseBody.ts +31 -0
  239. package/src/models/RenewElasticityAssurancesRequest.ts +28 -24
  240. package/src/models/RenewElasticityAssurancesResponseBody.ts +1 -1
  241. package/src/models/RevokeSecurityGroupEgressRequest.ts +35 -37
  242. package/src/models/RevokeSecurityGroupRequest.ts +75 -93
  243. package/src/models/StartTerminalSessionRequest.ts +24 -32
  244. package/src/models/StartTerminalSessionResponseBody.ts +2 -2
  245. package/src/models/StartTerminalSessionShrinkRequest.ts +16 -18
  246. package/src/models/StopInstanceRequest.ts +21 -28
  247. package/src/models/StopInstancesRequest.ts +25 -36
  248. package/src/models/UnassignIpv6addressesRequest.ts +3 -3
  249. package/src/models/model.ts +4 -0
package/dist/client.d.ts CHANGED
@@ -9,7 +9,7 @@ export default class Client extends OpenApi {
9
9
  [key: string]: string;
10
10
  }, endpoint: string): string;
11
11
  /**
12
- * Invoke AcceptInquiredSystemEvent to accept and authorize the execution of a system event operation. For a system event in the Inquiring status, this operation accepts the default action of the system event and authorizes the system to execute the default action.
12
+ * Accepts and authorizes the execution of a system event operation. For system events in the Inquiring state, this operation accepts the default action of the system event and authorizes the system to execute the default action.
13
13
  *
14
14
  * @param request - AcceptInquiredSystemEventRequest
15
15
  * @param runtime - runtime options for this request RuntimeOptions
@@ -17,7 +17,7 @@ export default class Client extends OpenApi {
17
17
  */
18
18
  acceptInquiredSystemEventWithOptions(request: $_model.AcceptInquiredSystemEventRequest, runtime: $dara.RuntimeOptions): Promise<$_model.AcceptInquiredSystemEventResponse>;
19
19
  /**
20
- * Invoke AcceptInquiredSystemEvent to accept and authorize the execution of a system event operation. For a system event in the Inquiring status, this operation accepts the default action of the system event and authorizes the system to execute the default action.
20
+ * Accepts and authorizes the execution of a system event operation. For system events in the Inquiring state, this operation accepts the default action of the system event and authorizes the system to execute the default action.
21
21
  *
22
22
  * @param request - AcceptInquiredSystemEventRequest
23
23
  * @returns AcceptInquiredSystemEventResponse
@@ -218,9 +218,9 @@ export default class Client extends OpenApi {
218
218
  * You can specify IPv6 addresses from the CIDR block of the vSwitch to which the Elastic Network Interface (ENI) belongs, or specify the number of IPv6 addresses for automatic creation. Note the following items:
219
219
  * - The vSwitch to which the ENI belongs must have IPv6 enabled. For more information, see [Enable an IPv6 CIDR block for an existing vSwitch](https://help.aliyun.com/document_detail/98923.html).
220
220
  * - The ENI must be in the Active (Available) or InUse state.
221
- * - When you operate on a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
222
- * - The number of IPv6 addresses that can be allocated to a single ENI depends on the instance type of the instance to which the ENI is attached.
223
- * - If the ENI is in the Active (Available) state, up to 10 IPv6 addresses can be allocated.
221
+ * - When you operate a primary ENI, the instance to which the network interface controller (NIC) is attached must be in the Running or Stopped state.
222
+ * - The number of IPv6 addresses that can be allocated to a single network interface controller (NIC) depends on the instance type of the instance to which the ENI is attached.
223
+ * - If the ENI is in the Active (Available) state, you can allocate up to 10 IPv6 addresses to it.
224
224
  * - If the ENI is attached to an instance, the number of IPv6 addresses that can be allocated is limited by the instance type. For more information, see [Instance family](https://help.aliyun.com/document_detail/25378.html).
225
225
  * - After you successfully invoke this operation, you can obtain the allocated IPv6 address information from the response.
226
226
  *
@@ -237,9 +237,9 @@ export default class Client extends OpenApi {
237
237
  * You can specify IPv6 addresses from the CIDR block of the vSwitch to which the Elastic Network Interface (ENI) belongs, or specify the number of IPv6 addresses for automatic creation. Note the following items:
238
238
  * - The vSwitch to which the ENI belongs must have IPv6 enabled. For more information, see [Enable an IPv6 CIDR block for an existing vSwitch](https://help.aliyun.com/document_detail/98923.html).
239
239
  * - The ENI must be in the Active (Available) or InUse state.
240
- * - When you operate on a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
241
- * - The number of IPv6 addresses that can be allocated to a single ENI depends on the instance type of the instance to which the ENI is attached.
242
- * - If the ENI is in the Active (Available) state, up to 10 IPv6 addresses can be allocated.
240
+ * - When you operate a primary ENI, the instance to which the network interface controller (NIC) is attached must be in the Running or Stopped state.
241
+ * - The number of IPv6 addresses that can be allocated to a single network interface controller (NIC) depends on the instance type of the instance to which the ENI is attached.
242
+ * - If the ENI is in the Active (Available) state, you can allocate up to 10 IPv6 addresses to it.
243
243
  * - If the ENI is attached to an instance, the number of IPv6 addresses that can be allocated is limited by the instance type. For more information, see [Instance family](https://help.aliyun.com/document_detail/25378.html).
244
244
  * - After you successfully invoke this operation, you can obtain the allocated IPv6 address information from the response.
245
245
  *
@@ -248,14 +248,14 @@ export default class Client extends OpenApi {
248
248
  */
249
249
  assignIpv6Addresses(request: $_model.AssignIpv6AddressesRequest): Promise<$_model.AssignIpv6AddressesResponse>;
250
250
  /**
251
- * Assigns secondary private IP addresses to an elastic network interface (ENI). You can specify available private IP addresses within the CIDR block of the vSwitch that is connected to the ENI. Alternatively, you can specify the number of private IP addresses that are automatically assigned from the CIDR block of the vSwitch to the ENI.
251
+ * Allocates one or more secondary private IP addresses to an Elastic Network Interface (ENI). You can specify available private IP addresses from the vSwitch to which the ENI belongs, or automatically allocate private IP addresses by specifying the number of private endpoint addresses.
252
252
  *
253
253
  * @remarks
254
- * ## [](#)Usage notes
255
- * - The ENI to which you want to assign IP prefixes must be in the Available (Available) or InUse (InUse) state.
256
- * - When you assign private IP addresses to a primary ENI, the Elastic Compute Service (ECS) instance to which the ENI is attached must be in the Running (Running) or Stopped (Stopped) state.
257
- * - When an ENI is in the Available state, you can assign up to 49 secondary private IP addresses to the ENI. When an ENI is attached to an instance, the number of secondary private IP addresses that can be assigned to the ENI varies based on the instance type. For more information, see [Overview of instance families](https://help.aliyun.com/document_detail/25378.html).
258
- * - After the operation is called, you can obtain the assigned secondary private IP addresses from the response.
254
+ * ## Operation description
255
+ * - Only ENIs in the Available or InUse state are supported.
256
+ * - When you operate a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
257
+ * - When an ENI is in the Available state, you can allocate up to 49 secondary private IP addresses to it. After the ENI is attached to an instance, the number of secondary private IP addresses that can be allocated is limited by the instance type. For more information, see [Instance families](https://help.aliyun.com/document_detail/25378.html).
258
+ * - After you call this operation, you can obtain the allocated secondary private IP address information from the response.
259
259
  *
260
260
  * @param request - AssignPrivateIpAddressesRequest
261
261
  * @param runtime - runtime options for this request RuntimeOptions
@@ -263,14 +263,14 @@ export default class Client extends OpenApi {
263
263
  */
264
264
  assignPrivateIpAddressesWithOptions(request: $_model.AssignPrivateIpAddressesRequest, runtime: $dara.RuntimeOptions): Promise<$_model.AssignPrivateIpAddressesResponse>;
265
265
  /**
266
- * Assigns secondary private IP addresses to an elastic network interface (ENI). You can specify available private IP addresses within the CIDR block of the vSwitch that is connected to the ENI. Alternatively, you can specify the number of private IP addresses that are automatically assigned from the CIDR block of the vSwitch to the ENI.
266
+ * Allocates one or more secondary private IP addresses to an Elastic Network Interface (ENI). You can specify available private IP addresses from the vSwitch to which the ENI belongs, or automatically allocate private IP addresses by specifying the number of private endpoint addresses.
267
267
  *
268
268
  * @remarks
269
- * ## [](#)Usage notes
270
- * - The ENI to which you want to assign IP prefixes must be in the Available (Available) or InUse (InUse) state.
271
- * - When you assign private IP addresses to a primary ENI, the Elastic Compute Service (ECS) instance to which the ENI is attached must be in the Running (Running) or Stopped (Stopped) state.
272
- * - When an ENI is in the Available state, you can assign up to 49 secondary private IP addresses to the ENI. When an ENI is attached to an instance, the number of secondary private IP addresses that can be assigned to the ENI varies based on the instance type. For more information, see [Overview of instance families](https://help.aliyun.com/document_detail/25378.html).
273
- * - After the operation is called, you can obtain the assigned secondary private IP addresses from the response.
269
+ * ## Operation description
270
+ * - Only ENIs in the Available or InUse state are supported.
271
+ * - When you operate a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
272
+ * - When an ENI is in the Available state, you can allocate up to 49 secondary private IP addresses to it. After the ENI is attached to an instance, the number of secondary private IP addresses that can be allocated is limited by the instance type. For more information, see [Instance families](https://help.aliyun.com/document_detail/25378.html).
273
+ * - After you call this operation, you can obtain the allocated secondary private IP address information from the response.
274
274
  *
275
275
  * @param request - AssignPrivateIpAddressesRequest
276
276
  * @returns AssignPrivateIpAddressesResponse
@@ -445,21 +445,22 @@ export default class Client extends OpenApi {
445
445
  */
446
446
  attachKeyPair(request: $_model.AttachKeyPairRequest): Promise<$_model.AttachKeyPairResponse>;
447
447
  /**
448
- * Attaches an elastic network interface (ENI) to an Elastic Compute Service (ECS) instance that resides in a virtual private cloud (VPC). When you call this operation, you can specify parameters, such as NetworkInterfaceId, InstanceId, and NetworkCardIndex, in the request.
448
+ * Calls the AttachNetworkInterface operation to attach an Elastic Network Interface (ENI) to a VPC-connected ECS instance. You can specify parameters such as NetworkInterfaceId, InstanceId, and NetworkCardIndex.
449
449
  *
450
450
  * @remarks
451
- * Take note of the following items:
452
- * - The ENI must be in the **Available** state. You can attach an ENI to only one instance that resides in the same zone and VPC as the ENI.
453
- * - The instance must be in the Running or Stopped state. When you attach ENIs to instances of specific instance types, make sure that the instances are in the Stopped state. For more information, see the "Instance types of the ECS instances that must be in the Stopped (Stopped) state" section in the [Bind an ENI](https://help.aliyun.com/document_detail/58503.html) topic.
454
- * > If the last start time of the instance (including the start time of the instance if it is a new instance, the last restart time of the instance, and the last reactivation time of the instance) is before April 1st, 2018 and the instance is in the Running state, you must call the RebootInstance operation to restart the instance. If you do not call the RebootInstance operation to restart the instance, you cannot attach the ENI to the instance.
455
- * - You can attach multiple ENIs to one instance. For more information, see [ENI overview](https://help.aliyun.com/document_detail/58496.html).
456
- * - The vSwitch to which the ENI is connected must be in the same zone and VPC as the vSwitch to which the instance is connected.
457
- * - This operation is an asynchronous operation. After you call this operation to attach an ENI, you can view the status or events of the ENI to check whether the ENI is attached. The following figure shows the transitions between the statuses of the ENI.
458
- * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/en-US/20230223/vqky/AttachNetworkInterface.png)
459
- * * If the ENI is in the Attaching state, the ENI attachment request is sent and the ENI is being attached to the specified instance.
460
- * * If the ENI is in the InUse state, the ENI is attached to the specified instance.
461
- * * If the ENI is in the Available state, the ENI failed to be attached.
462
- * **For examples on how to call this operation, see** [Attach an ENI](https://help.aliyun.com/document_detail/471550.html).
451
+ * When you call this operation, take note of the following items:
452
+ * - The Elastic Network Interface (ENI) must be in the **active** (`Available`) state. An ENI can be attached to only one instance that resides in the same zone and VPC as the network interface controller (NIC).
453
+ * - The ECS instance must be in the Running or Stopped state. Some ECS instance types require the ECS instance to be in the Stopped state when you attach an Elastic Network Interface (ENI). For more information, see the section about ECS instance types that require the ECS instance to be stopped in [Attach an ENI](https://help.aliyun.com/document_detail/58503.html).
454
+ * > If the instance was last started before April 1, 2018 (including but not limited to starting a newly purchased instance, restarting, or powering on), you must invoke RebootInstance to restart the instance that has been in the Running state. Otherwise, the network interface controller (NIC) cannot be attached.
455
+ * - Multiple Elastic Network Interfaces (ENIs) can be attached to a single instance at the same time. For more information, see [ENI overview](https://help.aliyun.com/document_detail/58496.html).
456
+ *
457
+ * - The vSwitch to which the network interface controller (NIC) belongs must be in the same zone and VPC as the instance.
458
+ * - This is an asynchronous operation. After a successful invocation, you can check the Elastic Network Interface (ENI) status or listen for network interface controller (NIC) operation events to obtain the result. The ENI state machine is shown in the following figure:
459
+ * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221124/esgu/AttachNetworkInterface.jpg)
460
+ * - Attaching indicates that the request to attach the ENI was sent successfully and the ENI is being attached to the ECS instance.
461
+ * - InUse indicates that the ENI has been attached to the ECS instance.
462
+ * - Available indicates that the ENI failed to be attached to the ECS instance.
463
+ * **For details, see** [Attach a network interface controller (NIC)](https://help.aliyun.com/document_detail/471550.html).
463
464
  *
464
465
  * @param request - AttachNetworkInterfaceRequest
465
466
  * @param runtime - runtime options for this request RuntimeOptions
@@ -467,75 +468,76 @@ export default class Client extends OpenApi {
467
468
  */
468
469
  attachNetworkInterfaceWithOptions(request: $_model.AttachNetworkInterfaceRequest, runtime: $dara.RuntimeOptions): Promise<$_model.AttachNetworkInterfaceResponse>;
469
470
  /**
470
- * Attaches an elastic network interface (ENI) to an Elastic Compute Service (ECS) instance that resides in a virtual private cloud (VPC). When you call this operation, you can specify parameters, such as NetworkInterfaceId, InstanceId, and NetworkCardIndex, in the request.
471
+ * Calls the AttachNetworkInterface operation to attach an Elastic Network Interface (ENI) to a VPC-connected ECS instance. You can specify parameters such as NetworkInterfaceId, InstanceId, and NetworkCardIndex.
471
472
  *
472
473
  * @remarks
473
- * Take note of the following items:
474
- * - The ENI must be in the **Available** state. You can attach an ENI to only one instance that resides in the same zone and VPC as the ENI.
475
- * - The instance must be in the Running or Stopped state. When you attach ENIs to instances of specific instance types, make sure that the instances are in the Stopped state. For more information, see the "Instance types of the ECS instances that must be in the Stopped (Stopped) state" section in the [Bind an ENI](https://help.aliyun.com/document_detail/58503.html) topic.
476
- * > If the last start time of the instance (including the start time of the instance if it is a new instance, the last restart time of the instance, and the last reactivation time of the instance) is before April 1st, 2018 and the instance is in the Running state, you must call the RebootInstance operation to restart the instance. If you do not call the RebootInstance operation to restart the instance, you cannot attach the ENI to the instance.
477
- * - You can attach multiple ENIs to one instance. For more information, see [ENI overview](https://help.aliyun.com/document_detail/58496.html).
478
- * - The vSwitch to which the ENI is connected must be in the same zone and VPC as the vSwitch to which the instance is connected.
479
- * - This operation is an asynchronous operation. After you call this operation to attach an ENI, you can view the status or events of the ENI to check whether the ENI is attached. The following figure shows the transitions between the statuses of the ENI.
480
- * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/en-US/20230223/vqky/AttachNetworkInterface.png)
481
- * * If the ENI is in the Attaching state, the ENI attachment request is sent and the ENI is being attached to the specified instance.
482
- * * If the ENI is in the InUse state, the ENI is attached to the specified instance.
483
- * * If the ENI is in the Available state, the ENI failed to be attached.
484
- * **For examples on how to call this operation, see** [Attach an ENI](https://help.aliyun.com/document_detail/471550.html).
474
+ * When you call this operation, take note of the following items:
475
+ * - The Elastic Network Interface (ENI) must be in the **active** (`Available`) state. An ENI can be attached to only one instance that resides in the same zone and VPC as the network interface controller (NIC).
476
+ * - The ECS instance must be in the Running or Stopped state. Some ECS instance types require the ECS instance to be in the Stopped state when you attach an Elastic Network Interface (ENI). For more information, see the section about ECS instance types that require the ECS instance to be stopped in [Attach an ENI](https://help.aliyun.com/document_detail/58503.html).
477
+ * > If the instance was last started before April 1, 2018 (including but not limited to starting a newly purchased instance, restarting, or powering on), you must invoke RebootInstance to restart the instance that has been in the Running state. Otherwise, the network interface controller (NIC) cannot be attached.
478
+ * - Multiple Elastic Network Interfaces (ENIs) can be attached to a single instance at the same time. For more information, see [ENI overview](https://help.aliyun.com/document_detail/58496.html).
479
+ *
480
+ * - The vSwitch to which the network interface controller (NIC) belongs must be in the same zone and VPC as the instance.
481
+ * - This is an asynchronous operation. After a successful invocation, you can check the Elastic Network Interface (ENI) status or listen for network interface controller (NIC) operation events to obtain the result. The ENI state machine is shown in the following figure:
482
+ * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221124/esgu/AttachNetworkInterface.jpg)
483
+ * - Attaching indicates that the request to attach the ENI was sent successfully and the ENI is being attached to the ECS instance.
484
+ * - InUse indicates that the ENI has been attached to the ECS instance.
485
+ * - Available indicates that the ENI failed to be attached to the ECS instance.
486
+ * **For details, see** [Attach a network interface controller (NIC)](https://help.aliyun.com/document_detail/471550.html).
485
487
  *
486
488
  * @param request - AttachNetworkInterfaceRequest
487
489
  * @returns AttachNetworkInterfaceResponse
488
490
  */
489
491
  attachNetworkInterface(request: $_model.AttachNetworkInterfaceRequest): Promise<$_model.AttachNetworkInterfaceResponse>;
490
492
  /**
491
- * Creates inbound security group rules in a security group. You can use the created rules to allow or deny inbound traffic from other objects to Elastic Compute Service (ECS) instances in the security group for fine-grained network access control.
493
+ * Adds one or more inbound rules to a security group. You can use this operation to specify inbound access permissions for a security group, allowing or denying other devices from sending inbound traffic to instances in the security group, which enables fine-grained network access control.
492
494
  *
493
495
  * @remarks
494
- * ### 使用须知
495
- * - **数量限制:** 单张弹性网卡关联的所有安全组的规则(包括入方向规则与出方向规则)数量之和不能超过 1000。具体限制请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
496
- * - **优先级设置:** 安全组入方向规则优先级(Priority)可选范围为 1\\~100。数字越小,代表优先级越高,优先级相同的安全组规则,优先以拒绝访问(drop)的规则为准。
497
- * ### 注意事项
498
- * 如果指定的安全组规则已存在,此次调用成功,但不会增加规则。
499
- * ### 规则确定方式
500
- * 确定一条安全组入方向规则必要的一组相关参数:
501
- * - 源端设置:选择 SourceCidrIpIPv4 地址)、Ipv6SourceCidrIpIPv6 地址)、SourcetPrefixListId(前缀列表 ID)、SourceGroupId(源端安全组)中的一项。
502
- * - 目的端口范围:PortRange
503
- * - 协议类型:IpProtocol
504
- * - 权限策略:Policy
505
- * > 企业安全组不支持授权其他安全组访问,普通安全组支持授权的安全组数量最多为 20 个。
506
- * ### 请求示例
507
- * 假设要在杭州地域下指定安全组中增加几条不同源端的入方向规则:
508
- * - 增加指定 IP 地址段的访问权限。
509
- * ```
510
- * "RegionId":"cn-hangzhou", //设置地域
511
- * "SecurityGroupId":"sg-bp67acfmxazb4p****", //设置安全组
512
- * "Permissions":[
513
- * {
514
- * "SourceCidrIp":"10.0.0.0/8", //设置源端 IPv4 地址
515
- * "PortRange":"22/22", //设置端口范围
516
- * "IpProtocol":"TCP", //设置协议类型
517
- * "Policy":"Accept" //设置访问策略
518
- * }
519
- * ]
520
- * ```
521
- * - 增加一条其他安全组和一条前缀列表的访问权限。
522
- * ```
523
- * "RegionId":"cn-hangzhou",
524
- * "SecurityGroupId":"sg-bp67acfmxazb4p****",
525
- * "Permissions":[
526
- * {
527
- * "SourceGroupId":"sg-bp17vs63txqxbd****", //设置源端安全组
528
- * "PortRange":"22/22",
529
- * "IpProtocol":"TCP",
530
- * "Policy":"Drop"
531
- * },{
532
- * "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置源端前缀列表
533
- * "PortRange":"22/22",
534
- * "IpProtocol":"TCP",
535
- * "Policy":"Drop"
536
- * }
537
- * ]
538
- * ```
496
+ * ### Before you begin
497
+ * - **Quantity limit:** The total number of security group rules (including inbound rules and outbound rules) across all security groups associated with a single network interface controller (NIC) cannot exceed 1,000. For more information, see [Security group limits](~~25412#SecurityGroupQuota1~~).
498
+ * - **Priority settings:** The priority (Priority) of inbound security group rules ranges from 1 to 100. A smaller number indicates a higher priority. If two security group rules have the same priority, the deny (drop) rule takes precedence. Access is denied first.
499
+ * ### Notes
500
+ * If the specified security group rule already exists, the call succeeds but no rule is added.
501
+ * ### How to determine a rule
502
+ * The following parameters are required to determine an inbound security group rule:
503
+ * - Source settings: Specify one of the following: SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
504
+ * - Destination port range: PortRange.
505
+ * - Protocol type: IpProtocol.
506
+ * - Access policy: Policy.
507
+ * > Advanced security groups do not support authorization for access from other security groups. Basic security groups support a maximum of 20 authorized security groups.
508
+ * ### Request examples
509
+ * The following examples show how to add inbound rules with different sources to a security group in the China (Hangzhou) region:
510
+ * - Add access permissions for a specified IP address range.
511
+ * ```
512
+ * "RegionId":"cn-hangzhou", // Specify the region.
513
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group.
514
+ * "Permissions":[
515
+ * {
516
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IPv4 address.
517
+ * "PortRange":"22/22", // Specify the port range.
518
+ * "IpProtocol":"TCP", // Specify the protocol type.
519
+ * "Policy":"Accept" // Specify the access policy.
520
+ * }
521
+ * ]
522
+ * ```
523
+ * - Add access permissions for another security group and a prefix list.
524
+ * ```
525
+ * "RegionId":"cn-hangzhou",
526
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****",
527
+ * "Permissions":[
528
+ * {
529
+ * "SourceGroupId":"sg-bp17vs63txqxbd****", // Specify the source security group.
530
+ * "PortRange":"22/22",
531
+ * "IpProtocol":"TCP",
532
+ * "Policy":"Drop"
533
+ * },{
534
+ * "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list.
535
+ * "PortRange":"22/22",
536
+ * "IpProtocol":"TCP",
537
+ * "Policy":"Drop"
538
+ * }
539
+ * ]
540
+ * ```
539
541
  *
540
542
  * @param request - AuthorizeSecurityGroupRequest
541
543
  * @param runtime - runtime options for this request RuntimeOptions
@@ -543,108 +545,108 @@ export default class Client extends OpenApi {
543
545
  */
544
546
  authorizeSecurityGroupWithOptions(request: $_model.AuthorizeSecurityGroupRequest, runtime: $dara.RuntimeOptions): Promise<$_model.AuthorizeSecurityGroupResponse>;
545
547
  /**
546
- * Creates inbound security group rules in a security group. You can use the created rules to allow or deny inbound traffic from other objects to Elastic Compute Service (ECS) instances in the security group for fine-grained network access control.
548
+ * Adds one or more inbound rules to a security group. You can use this operation to specify inbound access permissions for a security group, allowing or denying other devices from sending inbound traffic to instances in the security group, which enables fine-grained network access control.
547
549
  *
548
550
  * @remarks
549
- * ### 使用须知
550
- * - **数量限制:** 单张弹性网卡关联的所有安全组的规则(包括入方向规则与出方向规则)数量之和不能超过 1000。具体限制请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
551
- * - **优先级设置:** 安全组入方向规则优先级(Priority)可选范围为 1\\~100。数字越小,代表优先级越高,优先级相同的安全组规则,优先以拒绝访问(drop)的规则为准。
552
- * ### 注意事项
553
- * 如果指定的安全组规则已存在,此次调用成功,但不会增加规则。
554
- * ### 规则确定方式
555
- * 确定一条安全组入方向规则必要的一组相关参数:
556
- * - 源端设置:选择 SourceCidrIpIPv4 地址)、Ipv6SourceCidrIpIPv6 地址)、SourcetPrefixListId(前缀列表 ID)、SourceGroupId(源端安全组)中的一项。
557
- * - 目的端口范围:PortRange
558
- * - 协议类型:IpProtocol
559
- * - 权限策略:Policy
560
- * > 企业安全组不支持授权其他安全组访问,普通安全组支持授权的安全组数量最多为 20 个。
561
- * ### 请求示例
562
- * 假设要在杭州地域下指定安全组中增加几条不同源端的入方向规则:
563
- * - 增加指定 IP 地址段的访问权限。
564
- * ```
565
- * "RegionId":"cn-hangzhou", //设置地域
566
- * "SecurityGroupId":"sg-bp67acfmxazb4p****", //设置安全组
567
- * "Permissions":[
568
- * {
569
- * "SourceCidrIp":"10.0.0.0/8", //设置源端 IPv4 地址
570
- * "PortRange":"22/22", //设置端口范围
571
- * "IpProtocol":"TCP", //设置协议类型
572
- * "Policy":"Accept" //设置访问策略
573
- * }
574
- * ]
575
- * ```
576
- * - 增加一条其他安全组和一条前缀列表的访问权限。
577
- * ```
578
- * "RegionId":"cn-hangzhou",
579
- * "SecurityGroupId":"sg-bp67acfmxazb4p****",
580
- * "Permissions":[
581
- * {
582
- * "SourceGroupId":"sg-bp17vs63txqxbd****", //设置源端安全组
583
- * "PortRange":"22/22",
584
- * "IpProtocol":"TCP",
585
- * "Policy":"Drop"
586
- * },{
587
- * "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置源端前缀列表
588
- * "PortRange":"22/22",
589
- * "IpProtocol":"TCP",
590
- * "Policy":"Drop"
591
- * }
592
- * ]
593
- * ```
551
+ * ### Before you begin
552
+ * - **Quantity limit:** The total number of security group rules (including inbound rules and outbound rules) across all security groups associated with a single network interface controller (NIC) cannot exceed 1,000. For more information, see [Security group limits](~~25412#SecurityGroupQuota1~~).
553
+ * - **Priority settings:** The priority (Priority) of inbound security group rules ranges from 1 to 100. A smaller number indicates a higher priority. If two security group rules have the same priority, the deny (drop) rule takes precedence. Access is denied first.
554
+ * ### Notes
555
+ * If the specified security group rule already exists, the call succeeds but no rule is added.
556
+ * ### How to determine a rule
557
+ * The following parameters are required to determine an inbound security group rule:
558
+ * - Source settings: Specify one of the following: SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
559
+ * - Destination port range: PortRange.
560
+ * - Protocol type: IpProtocol.
561
+ * - Access policy: Policy.
562
+ * > Advanced security groups do not support authorization for access from other security groups. Basic security groups support a maximum of 20 authorized security groups.
563
+ * ### Request examples
564
+ * The following examples show how to add inbound rules with different sources to a security group in the China (Hangzhou) region:
565
+ * - Add access permissions for a specified IP address range.
566
+ * ```
567
+ * "RegionId":"cn-hangzhou", // Specify the region.
568
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group.
569
+ * "Permissions":[
570
+ * {
571
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IPv4 address.
572
+ * "PortRange":"22/22", // Specify the port range.
573
+ * "IpProtocol":"TCP", // Specify the protocol type.
574
+ * "Policy":"Accept" // Specify the access policy.
575
+ * }
576
+ * ]
577
+ * ```
578
+ * - Add access permissions for another security group and a prefix list.
579
+ * ```
580
+ * "RegionId":"cn-hangzhou",
581
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****",
582
+ * "Permissions":[
583
+ * {
584
+ * "SourceGroupId":"sg-bp17vs63txqxbd****", // Specify the source security group.
585
+ * "PortRange":"22/22",
586
+ * "IpProtocol":"TCP",
587
+ * "Policy":"Drop"
588
+ * },{
589
+ * "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list.
590
+ * "PortRange":"22/22",
591
+ * "IpProtocol":"TCP",
592
+ * "Policy":"Drop"
593
+ * }
594
+ * ]
595
+ * ```
594
596
  *
595
597
  * @param request - AuthorizeSecurityGroupRequest
596
598
  * @returns AuthorizeSecurityGroupResponse
597
599
  */
598
600
  authorizeSecurityGroup(request: $_model.AuthorizeSecurityGroupRequest): Promise<$_model.AuthorizeSecurityGroupResponse>;
599
601
  /**
600
- * Creates outbound rules in a security group. You can use the created rules to allow or deny outbound traffic from Elastic Compute Service (ECS) instances in the security group to other objects for fine-grained network access control.
602
+ * Adds one or more outbound rules to a security group. You can use this operation to specify outbound access permissions for a security group, allowing or denying instances in the security group from sending outbound traffic to other devices, which enables fine-grained network access control.
601
603
  *
602
604
  * @remarks
603
- * ### 使用须知
604
- * - **数量限制:** 单张弹性网卡关联的所有安全组的规则(包括入方向规则与出方向规则)数量之和不能超过 1000。具体限制请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
605
- * - **优先级设置:** 安全组出方向规则优先级(Priority)可选范围为 1\\~100。数字越小,代表优先级越高,优先级相同的安全组规则,优先以拒绝访问(drop)的规则为准。
606
- * ### 注意事项
607
- * 如果指定的安全组规则已存在,此次调用成功,但不会增加规则。
608
- * ### 规则确定方式
609
- * 确定一条安全组出方向规则必要的一组相关参数:
610
- * - 目的端设置:选择 DestCidrIpIPv4 地址)、Ipv6DestCidrIpIPv6 地址)、DestPrefixListId(前缀列表 ID)、DestGroupId(目的端安全组)中的一项。
611
- * - 目的端口范围:PortRange
612
- * - 协议类型:IpProtocol
613
- * - 权限策略:Policy
614
- * > 企业安全组不支持授权其他安全组访问,普通安全组支持授权的安全组数量最多为 20 个。
615
- * ### 请求示例
616
- * 假设要在杭州地域下指定安全组中增加几条不同目的端的出方向规则:
617
- * - 增加指定 IP 地址段的访问权限。
618
- * ```
619
- * "RegionId":"cn-hangzhou", //设置地域
620
- * "SecurityGroupId":"sg-bp17vs63txqxbds9***", //设置安全组
621
- * "Permissions":[
622
- * {
623
- * "DestCidrIp":"10.0.0.0/8", //设置目的端 IPv4 地址
624
- * "PortRange":"-1/-1", //设置端口范围
625
- * "IpProtocol":"ICMP", //设置协议类型
626
- * "Policy":"Accept" //设置访问策略
627
- * }
628
- * ]
629
- * ```
630
- * - 增加一条其他安全组和一条前缀列表的访问权限。
631
- * ```
632
- * "RegionId":"cn-hangzhou",
633
- * "SecurityGroupId":"sg-bp17vs63txqxbds9***",
634
- * "Permissions":[
635
- * {
636
- * "DestGroupId":"sg-bp67acfmxazb4pi***", //设置目的端安全组
637
- * "PortRange":"22/22",
638
- * "IpProtocol":"TCP",
639
- * "Policy":"Drop"
640
- * },{
641
- * "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置目的端前缀列表
642
- * "PortRange":"22/22",
643
- * "IpProtocol":"TCP",
644
- * "Policy":"Drop"
645
- * }
646
- * ]
647
- * ```
605
+ * ### Before you begin
606
+ * - **Quantity limit:** The total number of rules (including both inbound rules and outbound rules) across all security groups associated with a single network interface controller (NIC) cannot exceed 1,000. For more information, see [Security group limits](~~25412#SecurityGroupQuota1~~).
607
+ * - **Priority settings:** The priority (Priority) of outbound security group rules ranges from 1 to 100. A smaller number indicates a higher priority. If two security group rules have the same priority, the deny (drop) rule takes precedence.
608
+ * ### Notes
609
+ * If the specified security group rule already exists, the call succeeds but no rule is added.
610
+ * ### How to determine a rule
611
+ * The following parameters are required to determine an outbound rule:
612
+ * - Destination settings: Specify one of the following: DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
613
+ * - Destination port range: PortRange.
614
+ * - Protocol type: IpProtocol.
615
+ * - Access policy: Policy.
616
+ * > Advanced security groups do not support authorization of other security groups for access. Custom security groups support a maximum of 20 authorized security groups.
617
+ * ### Request examples
618
+ * The following examples show how to add outbound rules with different destinations to a security group in the China (Hangzhou) region:
619
+ * - Add access permissions for a specified IP address range.
620
+ * ```
621
+ * "RegionId":"ap-southeast-1", // Specify the region.
622
+ * "SecurityGroupId":"sg-bp17vs63txqxbds9***", // Specify the security group.
623
+ * "Permissions":[
624
+ * {
625
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IPv4 address.
626
+ * "PortRange":"-1/-1", // Specify the port range.
627
+ * "IpProtocol":"ICMP", // Specify the protocol type.
628
+ * "Policy":"Accept" // Specify the access policy.
629
+ * }
630
+ * ]
631
+ * ```
632
+ * - Add access permissions for another security group and a prefix list.
633
+ * ```
634
+ * "RegionId":"ap-southeast-1",
635
+ * "SecurityGroupId":"sg-bp17vs63txqxbds9***",
636
+ * "Permissions":[
637
+ * {
638
+ * "DestGroupId":"sg-bp67acfmxazb4pi***", // Specify the destination security group.
639
+ * "PortRange":"22/22",
640
+ * "IpProtocol":"TCP",
641
+ * "Policy":"Drop"
642
+ * },{
643
+ * "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", // Specify the destination prefix list.
644
+ * "PortRange":"22/22",
645
+ * "IpProtocol":"TCP",
646
+ * "Policy":"Drop"
647
+ * }
648
+ * ]
649
+ * ```
648
650
  *
649
651
  * @param request - AuthorizeSecurityGroupEgressRequest
650
652
  * @param runtime - runtime options for this request RuntimeOptions
@@ -652,54 +654,54 @@ export default class Client extends OpenApi {
652
654
  */
653
655
  authorizeSecurityGroupEgressWithOptions(request: $_model.AuthorizeSecurityGroupEgressRequest, runtime: $dara.RuntimeOptions): Promise<$_model.AuthorizeSecurityGroupEgressResponse>;
654
656
  /**
655
- * Creates outbound rules in a security group. You can use the created rules to allow or deny outbound traffic from Elastic Compute Service (ECS) instances in the security group to other objects for fine-grained network access control.
657
+ * Adds one or more outbound rules to a security group. You can use this operation to specify outbound access permissions for a security group, allowing or denying instances in the security group from sending outbound traffic to other devices, which enables fine-grained network access control.
656
658
  *
657
659
  * @remarks
658
- * ### 使用须知
659
- * - **数量限制:** 单张弹性网卡关联的所有安全组的规则(包括入方向规则与出方向规则)数量之和不能超过 1000。具体限制请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
660
- * - **优先级设置:** 安全组出方向规则优先级(Priority)可选范围为 1\\~100。数字越小,代表优先级越高,优先级相同的安全组规则,优先以拒绝访问(drop)的规则为准。
661
- * ### 注意事项
662
- * 如果指定的安全组规则已存在,此次调用成功,但不会增加规则。
663
- * ### 规则确定方式
664
- * 确定一条安全组出方向规则必要的一组相关参数:
665
- * - 目的端设置:选择 DestCidrIpIPv4 地址)、Ipv6DestCidrIpIPv6 地址)、DestPrefixListId(前缀列表 ID)、DestGroupId(目的端安全组)中的一项。
666
- * - 目的端口范围:PortRange
667
- * - 协议类型:IpProtocol
668
- * - 权限策略:Policy
669
- * > 企业安全组不支持授权其他安全组访问,普通安全组支持授权的安全组数量最多为 20 个。
670
- * ### 请求示例
671
- * 假设要在杭州地域下指定安全组中增加几条不同目的端的出方向规则:
672
- * - 增加指定 IP 地址段的访问权限。
673
- * ```
674
- * "RegionId":"cn-hangzhou", //设置地域
675
- * "SecurityGroupId":"sg-bp17vs63txqxbds9***", //设置安全组
676
- * "Permissions":[
677
- * {
678
- * "DestCidrIp":"10.0.0.0/8", //设置目的端 IPv4 地址
679
- * "PortRange":"-1/-1", //设置端口范围
680
- * "IpProtocol":"ICMP", //设置协议类型
681
- * "Policy":"Accept" //设置访问策略
682
- * }
683
- * ]
684
- * ```
685
- * - 增加一条其他安全组和一条前缀列表的访问权限。
686
- * ```
687
- * "RegionId":"cn-hangzhou",
688
- * "SecurityGroupId":"sg-bp17vs63txqxbds9***",
689
- * "Permissions":[
690
- * {
691
- * "DestGroupId":"sg-bp67acfmxazb4pi***", //设置目的端安全组
692
- * "PortRange":"22/22",
693
- * "IpProtocol":"TCP",
694
- * "Policy":"Drop"
695
- * },{
696
- * "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置目的端前缀列表
697
- * "PortRange":"22/22",
698
- * "IpProtocol":"TCP",
699
- * "Policy":"Drop"
700
- * }
701
- * ]
702
- * ```
660
+ * ### Before you begin
661
+ * - **Quantity limit:** The total number of rules (including both inbound rules and outbound rules) across all security groups associated with a single network interface controller (NIC) cannot exceed 1,000. For more information, see [Security group limits](~~25412#SecurityGroupQuota1~~).
662
+ * - **Priority settings:** The priority (Priority) of outbound security group rules ranges from 1 to 100. A smaller number indicates a higher priority. If two security group rules have the same priority, the deny (drop) rule takes precedence.
663
+ * ### Notes
664
+ * If the specified security group rule already exists, the call succeeds but no rule is added.
665
+ * ### How to determine a rule
666
+ * The following parameters are required to determine an outbound rule:
667
+ * - Destination settings: Specify one of the following: DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
668
+ * - Destination port range: PortRange.
669
+ * - Protocol type: IpProtocol.
670
+ * - Access policy: Policy.
671
+ * > Advanced security groups do not support authorization of other security groups for access. Custom security groups support a maximum of 20 authorized security groups.
672
+ * ### Request examples
673
+ * The following examples show how to add outbound rules with different destinations to a security group in the China (Hangzhou) region:
674
+ * - Add access permissions for a specified IP address range.
675
+ * ```
676
+ * "RegionId":"ap-southeast-1", // Specify the region.
677
+ * "SecurityGroupId":"sg-bp17vs63txqxbds9***", // Specify the security group.
678
+ * "Permissions":[
679
+ * {
680
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IPv4 address.
681
+ * "PortRange":"-1/-1", // Specify the port range.
682
+ * "IpProtocol":"ICMP", // Specify the protocol type.
683
+ * "Policy":"Accept" // Specify the access policy.
684
+ * }
685
+ * ]
686
+ * ```
687
+ * - Add access permissions for another security group and a prefix list.
688
+ * ```
689
+ * "RegionId":"ap-southeast-1",
690
+ * "SecurityGroupId":"sg-bp17vs63txqxbds9***",
691
+ * "Permissions":[
692
+ * {
693
+ * "DestGroupId":"sg-bp67acfmxazb4pi***", // Specify the destination security group.
694
+ * "PortRange":"22/22",
695
+ * "IpProtocol":"TCP",
696
+ * "Policy":"Drop"
697
+ * },{
698
+ * "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", // Specify the destination prefix list.
699
+ * "PortRange":"22/22",
700
+ * "IpProtocol":"TCP",
701
+ * "Policy":"Drop"
702
+ * }
703
+ * ]
704
+ * ```
703
705
  *
704
706
  * @param request - AuthorizeSecurityGroupEgressRequest
705
707
  * @returns AuthorizeSecurityGroupEgressResponse
@@ -746,10 +748,10 @@ export default class Client extends OpenApi {
746
748
  */
747
749
  cancelCopyImage(request: $_model.CancelCopyImageRequest): Promise<$_model.CancelCopyImageResponse>;
748
750
  /**
749
- * Cancels an image building task.
751
+ * Cancels an image build task.
750
752
  *
751
753
  * @remarks
752
- * Before you call the CancelImagePipelineExecution operation, make sure that the image building task to be canceled is in the BUILDING, PREPARING, or REPAIRING state.
754
+ * Before you call this operation, make sure that the image build task you want to cancel is in the PREPARING, REPAIRING, or BUILDING state.
753
755
  *
754
756
  * @param request - CancelImagePipelineExecutionRequest
755
757
  * @param runtime - runtime options for this request RuntimeOptions
@@ -757,10 +759,10 @@ export default class Client extends OpenApi {
757
759
  */
758
760
  cancelImagePipelineExecutionWithOptions(request: $_model.CancelImagePipelineExecutionRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CancelImagePipelineExecutionResponse>;
759
761
  /**
760
- * Cancels an image building task.
762
+ * Cancels an image build task.
761
763
  *
762
764
  * @remarks
763
- * Before you call the CancelImagePipelineExecution operation, make sure that the image building task to be canceled is in the BUILDING, PREPARING, or REPAIRING state.
765
+ * Before you call this operation, make sure that the image build task you want to cancel is in the PREPARING, REPAIRING, or BUILDING state.
764
766
  *
765
767
  * @param request - CancelImagePipelineExecutionRequest
766
768
  * @returns CancelImagePipelineExecutionResponse
@@ -991,12 +993,12 @@ export default class Client extends OpenApi {
991
993
  */
992
994
  copySnapshot(request: $_model.CopySnapshotRequest): Promise<$_model.CopySnapshotResponse>;
993
995
  /**
994
- * This API is used to create an activation code, which is used to register non-Alibaba Cloud servers as Alibaba Cloud managed instances.
996
+ * Creates an activation code that is used to register non-Alibaba Cloud servers as Alibaba Cloud managed instances.
995
997
  *
996
998
  * @remarks
997
- * ## API Guide
998
- * After you register a non-Alibaba Cloud server as an Alibaba Cloud managed instance by using an activation code, you can use various online services provided by Alibaba Cloud on the managed instance (such as Cloud Assistant, CloudOps Orchestration Service, and Alibaba Cloud DevOps).
999
- * The operating system of the non-Alibaba Cloud server must meet one of the following versions, and the server must be able to access the Internet to be registered as an Alibaba Cloud managed instance.
999
+ * ## Operation description
1000
+ * After you use an activation code to register a non-Alibaba Cloud server as an Alibaba Cloud managed instance, you can use various online services provided by Alibaba Cloud in the managed instance, such as Cloud Assistant, CloudOps Orchestration Service, and Alibaba Cloud DevOps.
1001
+ * The operating system of the non-Elastic Compute Service (ECS) server must meet the following version requirements, and the server must have Internet access to be registered as an Alibaba Cloud managed instance.
1000
1002
  * - Alibaba Cloud Linux 2/3 and later
1001
1003
  * - CentOS 6/7/8 and later
1002
1004
  * - Debian 8/9/10 and later
@@ -1005,9 +1007,9 @@ export default class Client extends OpenApi {
1005
1007
  * - OpenSUSE
1006
1008
  * - RedHat 5/6/7 and later
1007
1009
  * - SUSE Linux Enterprise Server 11/12/15 and later
1008
- * - Windows Server 2012/2016/2019 and later
1009
- * In each Alibaba Cloud Region, you can have up to 5,000 activation codes for managed instances. When the number of activation codes exceeds 1,000, you must maintain an activation code usage rate greater than 50% to continue creating new activation codes.
1010
- * > You can click **Register New Instance** on the **Managed Instances** tab of the **ECS Cloud Assistant** page to view activation code usage data.
1010
+ * - Window Server 2012/2016/2019 and later
1011
+ * In each Alibaba Cloud region, you can have up to 10 managed instance activation codes. Each activation code can be used to register up to 10 instances, and each activation code is valid for up to 4 hours.
1012
+ * > On the **ECS Cloud Assistant** page, click the **Managed Instances** tab, and then click **Register New Instance** to view the usage data of activation codes.
1011
1013
  *
1012
1014
  * @param request - CreateActivationRequest
1013
1015
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1015,12 +1017,12 @@ export default class Client extends OpenApi {
1015
1017
  */
1016
1018
  createActivationWithOptions(request: $_model.CreateActivationRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateActivationResponse>;
1017
1019
  /**
1018
- * This API is used to create an activation code, which is used to register non-Alibaba Cloud servers as Alibaba Cloud managed instances.
1020
+ * Creates an activation code that is used to register non-Alibaba Cloud servers as Alibaba Cloud managed instances.
1019
1021
  *
1020
1022
  * @remarks
1021
- * ## API Guide
1022
- * After you register a non-Alibaba Cloud server as an Alibaba Cloud managed instance by using an activation code, you can use various online services provided by Alibaba Cloud on the managed instance (such as Cloud Assistant, CloudOps Orchestration Service, and Alibaba Cloud DevOps).
1023
- * The operating system of the non-Alibaba Cloud server must meet one of the following versions, and the server must be able to access the Internet to be registered as an Alibaba Cloud managed instance.
1023
+ * ## Operation description
1024
+ * After you use an activation code to register a non-Alibaba Cloud server as an Alibaba Cloud managed instance, you can use various online services provided by Alibaba Cloud in the managed instance, such as Cloud Assistant, CloudOps Orchestration Service, and Alibaba Cloud DevOps.
1025
+ * The operating system of the non-Elastic Compute Service (ECS) server must meet the following version requirements, and the server must have Internet access to be registered as an Alibaba Cloud managed instance.
1024
1026
  * - Alibaba Cloud Linux 2/3 and later
1025
1027
  * - CentOS 6/7/8 and later
1026
1028
  * - Debian 8/9/10 and later
@@ -1029,9 +1031,9 @@ export default class Client extends OpenApi {
1029
1031
  * - OpenSUSE
1030
1032
  * - RedHat 5/6/7 and later
1031
1033
  * - SUSE Linux Enterprise Server 11/12/15 and later
1032
- * - Windows Server 2012/2016/2019 and later
1033
- * In each Alibaba Cloud Region, you can have up to 5,000 activation codes for managed instances. When the number of activation codes exceeds 1,000, you must maintain an activation code usage rate greater than 50% to continue creating new activation codes.
1034
- * > You can click **Register New Instance** on the **Managed Instances** tab of the **ECS Cloud Assistant** page to view activation code usage data.
1034
+ * - Window Server 2012/2016/2019 and later
1035
+ * In each Alibaba Cloud region, you can have up to 10 managed instance activation codes. Each activation code can be used to register up to 10 instances, and each activation code is valid for up to 4 hours.
1036
+ * > On the **ECS Cloud Assistant** page, click the **Managed Instances** tab, and then click **Register New Instance** to view the usage data of activation codes.
1035
1037
  *
1036
1038
  * @param request - CreateActivationRequest
1037
1039
  * @returns CreateActivationResponse
@@ -1129,23 +1131,23 @@ export default class Client extends OpenApi {
1129
1131
  */
1130
1132
  createCapacityReservation(request: $_model.CreateCapacityReservationRequest): Promise<$_model.CreateCapacityReservationResponse>;
1131
1133
  /**
1132
- * Create a Cloud Assistant command of the Shell, PowerShell, or Bat script type.
1134
+ * Creates a Cloud Assistant command of the Shell, PowerShell, or Bat script type.
1133
1135
  *
1134
1136
  * @remarks
1135
- * ## API Guide
1136
- * - You can create commands of the following types:
1137
- * - Bat scripts (RunBatScript) for Windows instances.
1138
- * - PowerShell scripts (RunPowerShellScript) for Windows instances.
1139
- * - Shell scripts (RunShellScript) for Linux instances.
1140
- * - You can specify the Timeout parameter to set the maximum timeout duration (in seconds) for command execution on an ECS instance. If the command execution times out, the [Cloud Assistant Agent](https://help.aliyun.com/document_detail/64921.html) forcibly terminates the command process by canceling its PID.
1141
- * - For one-time execution, if the command times out, the execution status ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) for the specified ECS instance changes to Failed.
1142
- * - For scheduled execution:
1143
- * - The timeout setting applies to each individual execution record.
1144
- * - If a specific execution times out, the status of that execution record ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) changes to Failed.
1145
- * - Whether the previous execution timed out does not affect the next execution.
1146
- * - Within a Region, you can retain between 500 and 50,000 Cloud Assistant commands. You can request a quota increase. For details on how to query and upgrade your quota, see [Quota Management](https://help.aliyun.com/document_detail/184116.html).
1147
- * - You can use the WorkingDir parameter to specify the execution path for the command. For Linux instances, the default path is the home directory of the root user, specifically the `/root` folder. For Windows instances, the default path is the directory where the Cloud Assistant Agent process resides, such as `C:\\Windows\\System32`.
1148
- * - You can enable the Custom Parameter feature by setting EnableParameter=true. In the CommandContent, you can represent custom parameters using the `{{parameter}}` syntax. When running the command ([InvokeCommand](https://help.aliyun.com/document_detail/64841.html)), you pass key-value pairs for these custom parameters. For example, if you create a command `echo {{name}}` during command creation, and then pass the key-value pair `<name, Jack>` via the Parameters parameter in InvokeCommand, the custom parameter is automatically replaced, resulting in the new command `echo Jack`, which is then executed on the instance.
1137
+ * ## Operation description
1138
+ * - You can create the following types of commands:
1139
+ * - Bat scripts for Windows instances (RunBatScript).
1140
+ * - PowerShell scripts for Windows instances (RunPowerShellScript).
1141
+ * - Shell scripts for Linux instances (RunShellScript).
1142
+ * - You can specify the Timeout parameter to set the maximum timeout period for a command to run on an ECS instance. If the command times out, [Cloud Assistant Agent](https://help.aliyun.com/document_detail/64921.html) forcefully terminates the command process by canceling the PID of the command.
1143
+ * - For a one-time execution, after the command times out, the execution status ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) of the command on the specified ECS instance changes to Failed.
1144
+ * - For a scheduled execution:
1145
+ * - The timeout period takes effect for each execution record.
1146
+ * - After a specific execution times out, the status ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) of that execution record changes to Failed.
1147
+ * - The timeout of a previous execution does not affect the next execution.
1148
+ * - You can retain up to 500 to 50,000 Cloud Assistant commands in a region. You can also request a quota increase. For information about how to query and increase quotas, refer to [Quota management](https://help.aliyun.com/document_detail/184116.html).
1149
+ * - You can specify the WorkingDir parameter to set the execution path of a command. For Linux instances, the default path is the home directory of the root user, which is `/root`. For Windows instances, the default path is the directory where the Cloud Assistant Agent process is located, such as `C:\\Windows\\System32`.
1150
+ * - You can set EnableParameter to true to enable the custom parameter feature. When you set CommandContent, you can define custom parameters in the {{parameter}} format and pass in custom parameter key-value pairs when you run the command by calling [InvokeCommand](https://help.aliyun.com/document_detail/64841.html). For example, if you create the command `echo {{name}}` and pass in the key-value pair `<name, Jack>` through the Parameters parameter when you call InvokeCommand, the custom parameter is automatically replaced. The resulting command `echo Jack` is then run on the instance.
1149
1151
  *
1150
1152
  * @param request - CreateCommandRequest
1151
1153
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1153,23 +1155,23 @@ export default class Client extends OpenApi {
1153
1155
  */
1154
1156
  createCommandWithOptions(request: $_model.CreateCommandRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateCommandResponse>;
1155
1157
  /**
1156
- * Create a Cloud Assistant command of the Shell, PowerShell, or Bat script type.
1158
+ * Creates a Cloud Assistant command of the Shell, PowerShell, or Bat script type.
1157
1159
  *
1158
1160
  * @remarks
1159
- * ## API Guide
1160
- * - You can create commands of the following types:
1161
- * - Bat scripts (RunBatScript) for Windows instances.
1162
- * - PowerShell scripts (RunPowerShellScript) for Windows instances.
1163
- * - Shell scripts (RunShellScript) for Linux instances.
1164
- * - You can specify the Timeout parameter to set the maximum timeout duration (in seconds) for command execution on an ECS instance. If the command execution times out, the [Cloud Assistant Agent](https://help.aliyun.com/document_detail/64921.html) forcibly terminates the command process by canceling its PID.
1165
- * - For one-time execution, if the command times out, the execution status ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) for the specified ECS instance changes to Failed.
1166
- * - For scheduled execution:
1167
- * - The timeout setting applies to each individual execution record.
1168
- * - If a specific execution times out, the status of that execution record ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) changes to Failed.
1169
- * - Whether the previous execution timed out does not affect the next execution.
1170
- * - Within a Region, you can retain between 500 and 50,000 Cloud Assistant commands. You can request a quota increase. For details on how to query and upgrade your quota, see [Quota Management](https://help.aliyun.com/document_detail/184116.html).
1171
- * - You can use the WorkingDir parameter to specify the execution path for the command. For Linux instances, the default path is the home directory of the root user, specifically the `/root` folder. For Windows instances, the default path is the directory where the Cloud Assistant Agent process resides, such as `C:\\Windows\\System32`.
1172
- * - You can enable the Custom Parameter feature by setting EnableParameter=true. In the CommandContent, you can represent custom parameters using the `{{parameter}}` syntax. When running the command ([InvokeCommand](https://help.aliyun.com/document_detail/64841.html)), you pass key-value pairs for these custom parameters. For example, if you create a command `echo {{name}}` during command creation, and then pass the key-value pair `<name, Jack>` via the Parameters parameter in InvokeCommand, the custom parameter is automatically replaced, resulting in the new command `echo Jack`, which is then executed on the instance.
1161
+ * ## Operation description
1162
+ * - You can create the following types of commands:
1163
+ * - Bat scripts for Windows instances (RunBatScript).
1164
+ * - PowerShell scripts for Windows instances (RunPowerShellScript).
1165
+ * - Shell scripts for Linux instances (RunShellScript).
1166
+ * - You can specify the Timeout parameter to set the maximum timeout period for a command to run on an ECS instance. If the command times out, [Cloud Assistant Agent](https://help.aliyun.com/document_detail/64921.html) forcefully terminates the command process by canceling the PID of the command.
1167
+ * - For a one-time execution, after the command times out, the execution status ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) of the command on the specified ECS instance changes to Failed.
1168
+ * - For a scheduled execution:
1169
+ * - The timeout period takes effect for each execution record.
1170
+ * - After a specific execution times out, the status ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) of that execution record changes to Failed.
1171
+ * - The timeout of a previous execution does not affect the next execution.
1172
+ * - You can retain up to 500 to 50,000 Cloud Assistant commands in a region. You can also request a quota increase. For information about how to query and increase quotas, refer to [Quota management](https://help.aliyun.com/document_detail/184116.html).
1173
+ * - You can specify the WorkingDir parameter to set the execution path of a command. For Linux instances, the default path is the home directory of the root user, which is `/root`. For Windows instances, the default path is the directory where the Cloud Assistant Agent process is located, such as `C:\\Windows\\System32`.
1174
+ * - You can set EnableParameter to true to enable the custom parameter feature. When you set CommandContent, you can define custom parameters in the {{parameter}} format and pass in custom parameter key-value pairs when you run the command by calling [InvokeCommand](https://help.aliyun.com/document_detail/64841.html). For example, if you create the command `echo {{name}}` and pass in the key-value pair `<name, Jack>` through the Parameters parameter when you call InvokeCommand, the custom parameter is automatically replaced. The resulting command `echo Jack` is then run on the instance.
1173
1175
  *
1174
1176
  * @param request - CreateCommandRequest
1175
1177
  * @returns CreateCommandResponse
@@ -1239,14 +1241,14 @@ export default class Client extends OpenApi {
1239
1241
  * Creates a pay-as-you-go or subscription data disk.
1240
1242
  *
1241
1243
  * @remarks
1242
- * - When creating a disk, you can enable the multi-attach feature (`MultiAttach`). We recommend that you understand this feature and its usage restrictions first. For more information, see [NVMe support for ESSDs](https://help.aliyun.com/document_detail/256487.html) and [Use the multi-attach feature](https://help.aliyun.com/document_detail/262105.html).
1243
- * - Supported disk types: basic disk, ultra disk, standard SSD, ESSD, ESSD Entry disk, ESSD zone-redundant disk, ESSD AutoPL disk, elastic ephemeral disk - standard, and elastic ephemeral disk - premium.
1244
- * - Creating a disk requires real-name verification. Go to [Real-name verification](https://account.console.aliyun.com/#/auth/home) in account information.
1245
- * - Creating a disk involves resource billing. We recommend that you understand the billing methods of ECS in advance. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
1246
- * - Default settings when creating a disk:
1247
- * - Automatic snapshots of the disk are deleted when the disk is deleted, that is, `DeleteAutoSnapshot` is set to `true`. You can call [DescribeDisks](https://help.aliyun.com/document_detail/2679767.html) to query this parameter and call [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to modify it.
1248
- * - When creating an ESSD, if you do not set the disk performance level, the default is PL1. You can modify the disk performance level through [ModifyDiskSpec](https://help.aliyun.com/document_detail/123780.html).
1249
- * - The billing method is pay-as-you-go, that is, the default `Portable` attribute is `true`.
1244
+ * - When you create a disk, you can enable the multi-attach feature (`MultiAttach`). Learn about this attribute and its limits before you use it. For more information, see [ESSD cloud disks that support NVMe](https://help.aliyun.com/document_detail/256487.html) and [Use the multi-attach feature](https://help.aliyun.com/document_detail/262105.html).
1245
+ * - The following disk types can be created: basic disks, ultra disks, standard SSDs, enterprise SSDs, ESSD Entry disks, regional Enterprise SSDs (ESSDs), ESSD AutoPL disks, elastic ephemeral disks - Standard Edition, and elastic ephemeral disks - Premium Edition.
1246
+ * - To create a disk, complete [real-name registration](https://account.console.aliyun.com/#/auth/home).
1247
+ * - Creating a disk incurs fees. Learn about the billing method of Elastic Compute Service (ECS) in advance. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
1248
+ * - Default settings when you create a disk:
1249
+ * - Automatic snapshots of the disk are deleted when the disk is deleted. That is, `DeleteAutoSnapshot` is set to `true`. You can call [DescribeDisks](https://help.aliyun.com/document_detail/2679767.html) to query the parameter settings, and call [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to modify the property.
1250
+ * - When you create an enterprise SSD, if you do not configure a performance level, the default level is PL1. You can call [ModifyDiskSpec](https://help.aliyun.com/document_detail/123780.html) to change the performance level.
1251
+ * - The billing method is pay-as-you-go, which means the `Portable` property defaults to `true`.
1250
1252
  *
1251
1253
  * @param request - CreateDiskRequest
1252
1254
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1257,14 +1259,14 @@ export default class Client extends OpenApi {
1257
1259
  * Creates a pay-as-you-go or subscription data disk.
1258
1260
  *
1259
1261
  * @remarks
1260
- * - When creating a disk, you can enable the multi-attach feature (`MultiAttach`). We recommend that you understand this feature and its usage restrictions first. For more information, see [NVMe support for ESSDs](https://help.aliyun.com/document_detail/256487.html) and [Use the multi-attach feature](https://help.aliyun.com/document_detail/262105.html).
1261
- * - Supported disk types: basic disk, ultra disk, standard SSD, ESSD, ESSD Entry disk, ESSD zone-redundant disk, ESSD AutoPL disk, elastic ephemeral disk - standard, and elastic ephemeral disk - premium.
1262
- * - Creating a disk requires real-name verification. Go to [Real-name verification](https://account.console.aliyun.com/#/auth/home) in account information.
1263
- * - Creating a disk involves resource billing. We recommend that you understand the billing methods of ECS in advance. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
1264
- * - Default settings when creating a disk:
1265
- * - Automatic snapshots of the disk are deleted when the disk is deleted, that is, `DeleteAutoSnapshot` is set to `true`. You can call [DescribeDisks](https://help.aliyun.com/document_detail/2679767.html) to query this parameter and call [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to modify it.
1266
- * - When creating an ESSD, if you do not set the disk performance level, the default is PL1. You can modify the disk performance level through [ModifyDiskSpec](https://help.aliyun.com/document_detail/123780.html).
1267
- * - The billing method is pay-as-you-go, that is, the default `Portable` attribute is `true`.
1262
+ * - When you create a disk, you can enable the multi-attach feature (`MultiAttach`). Learn about this attribute and its limits before you use it. For more information, see [ESSD cloud disks that support NVMe](https://help.aliyun.com/document_detail/256487.html) and [Use the multi-attach feature](https://help.aliyun.com/document_detail/262105.html).
1263
+ * - The following disk types can be created: basic disks, ultra disks, standard SSDs, enterprise SSDs, ESSD Entry disks, regional Enterprise SSDs (ESSDs), ESSD AutoPL disks, elastic ephemeral disks - Standard Edition, and elastic ephemeral disks - Premium Edition.
1264
+ * - To create a disk, complete [real-name registration](https://account.console.aliyun.com/#/auth/home).
1265
+ * - Creating a disk incurs fees. Learn about the billing method of Elastic Compute Service (ECS) in advance. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
1266
+ * - Default settings when you create a disk:
1267
+ * - Automatic snapshots of the disk are deleted when the disk is deleted. That is, `DeleteAutoSnapshot` is set to `true`. You can call [DescribeDisks](https://help.aliyun.com/document_detail/2679767.html) to query the parameter settings, and call [ModifyDiskAttribute](https://help.aliyun.com/document_detail/25517.html) to modify the property.
1268
+ * - When you create an enterprise SSD, if you do not configure a performance level, the default level is PL1. You can call [ModifyDiskSpec](https://help.aliyun.com/document_detail/123780.html) to change the performance level.
1269
+ * - The billing method is pay-as-you-go, which means the `Portable` property defaults to `true`.
1268
1270
  *
1269
1271
  * @param request - CreateDiskRequest
1270
1272
  * @returns CreateDiskResponse
@@ -1336,7 +1338,7 @@ export default class Client extends OpenApi {
1336
1338
  */
1337
1339
  createHaVip(request: $_model.CreateHaVipRequest): Promise<$_model.CreateHaVipResponse>;
1338
1340
  /**
1339
- * Creates a high performance computing (HPC) cluster.
1341
+ * Creates an HPC cluster by calling CreateHpcCluster.
1340
1342
  *
1341
1343
  * @param request - CreateHpcClusterRequest
1342
1344
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1344,7 +1346,7 @@ export default class Client extends OpenApi {
1344
1346
  */
1345
1347
  createHpcClusterWithOptions(request: $_model.CreateHpcClusterRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateHpcClusterResponse>;
1346
1348
  /**
1347
- * Creates a high performance computing (HPC) cluster.
1349
+ * Creates an HPC cluster by calling CreateHpcCluster.
1348
1350
  *
1349
1351
  * @param request - CreateHpcClusterRequest
1350
1352
  * @returns CreateHpcClusterResponse
@@ -1404,13 +1406,13 @@ export default class Client extends OpenApi {
1404
1406
  */
1405
1407
  createImage(request: $_model.CreateImageRequest): Promise<$_model.CreateImageResponse>;
1406
1408
  /**
1407
- * Creates an image component. Image components store commonly used build template commands for image building.
1409
+ * Creates an image component. Image components are used to store commonly used build template commands for image building.
1408
1410
  *
1409
1411
  * @remarks
1410
1412
  * ## Operation description
1411
1413
  * Before you create an image component, take note of the following items:
1412
- * - You can create only custom image components.
1413
- * - Component version numbers must be unique for components with the same name. When you use a component in a template, you can reference it by name and version number.
1414
+ * - Only custom image components can be created.
1415
+ * - Component version numbers must be unique for the same component name. When using a component in a template, you can reference it by name and version number.
1414
1416
  * - The content size of an image component cannot exceed 16 KB. For details about supported commands, see [Commands supported by Image Builder](https://help.aliyun.com/document_detail/200206.html).
1415
1417
  * For more information, see [Image Builder overview](https://help.aliyun.com/document_detail/197410.html).
1416
1418
  *
@@ -1420,13 +1422,13 @@ export default class Client extends OpenApi {
1420
1422
  */
1421
1423
  createImageComponentWithOptions(request: $_model.CreateImageComponentRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateImageComponentResponse>;
1422
1424
  /**
1423
- * Creates an image component. Image components store commonly used build template commands for image building.
1425
+ * Creates an image component. Image components are used to store commonly used build template commands for image building.
1424
1426
  *
1425
1427
  * @remarks
1426
1428
  * ## Operation description
1427
1429
  * Before you create an image component, take note of the following items:
1428
- * - You can create only custom image components.
1429
- * - Component version numbers must be unique for components with the same name. When you use a component in a template, you can reference it by name and version number.
1430
+ * - Only custom image components can be created.
1431
+ * - Component version numbers must be unique for the same component name. When using a component in a template, you can reference it by name and version number.
1430
1432
  * - The content size of an image component cannot exceed 16 KB. For details about supported commands, see [Commands supported by Image Builder](https://help.aliyun.com/document_detail/200206.html).
1431
1433
  * For more information, see [Image Builder overview](https://help.aliyun.com/document_detail/197410.html).
1432
1434
  *
@@ -1472,31 +1474,32 @@ export default class Client extends OpenApi {
1472
1474
  */
1473
1475
  createImagePipeline(request: $_model.CreateImagePipelineRequest): Promise<$_model.CreateImagePipelineResponse>;
1474
1476
  /**
1475
- * Use this API to create a single subscription or pay-as-you-go Alibaba Cloud ECS instance. You can configure parameters to customize the instance.
1477
+ * Creates a subscription or pay-as-you-go Elastic Compute Service (ECS) instance with customizable parameters.
1476
1478
  *
1477
1479
  * @remarks
1478
- * > This API is deprecated. We recommend that you use the [RunInstances](https://help.aliyun.com/document_detail/2679677.html) API instead.
1480
+ * > This operation is no longer maintained. Use [RunInstances](https://help.aliyun.com/document_detail/2679677.html) instead.
1479
1481
  * <props="china">
1480
- * **Before using this API, ensure you understand the billing methods and [Pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS.**
1482
+ * **Before you call this operation, make sure that you fully understand the billing methods and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS.**
1481
1483
  * <props="intl">
1482
- * **Before using this API, ensure you understand the billing methods and [Pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS.**
1483
- * A successful call to this API returns an instance ID, but the instance is created asynchronously. Call [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) to query the instance\\"s status. The instance is successfully created when its status becomes `Stopped`. You can then call [StartInstance](https://help.aliyun.com/document_detail/2679679.html) to start the instance.
1484
- * ### Usage notes
1484
+ * **Before you call this operation, make sure that you fully understand the billing methods and [pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS.**
1485
+ * This is an asynchronous operation. After a request to create an instance is sent, the instance ID is returned. The instance is not immediately created. Call [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) to query the instance status. When the status is `Stopped`, the instance is created. Then you can call [StartInstance](https://help.aliyun.com/document_detail/2679679.html) to start the instance.
1486
+ * ### Before you begin
1485
1487
  * <props="china">
1486
- * - Make sure that your account has passed real-name verification. For more information, see [Account real-name verification](https://help.aliyun.com/document_detail/48263.html).
1487
- * - Creating an instance incurs charges. Make sure that you understand the billing methods for ECS. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
1488
- * - Ensure you do not exceed your quotas for the total number of instances or vCPUs. For more information, see [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas).
1489
- * - Before creating a VPC-type instance, you must [create a VPC](https://help.aliyun.com/document_detail/65430.html) in the same region.
1490
- * ### Precautions
1491
- * - Calling this API does not trigger system notifications (such as SMS messages, emails, or in-site messages) to indicate that the instance is successfully created.
1492
- * - If the billing method for the instance is subscription (`PrePaid`), your available coupons are automatically used at checkout.
1493
- * - Instances with 512 MiB of memory support only Windows Server images from the semiannual channel. Instances with 4 GiB or more of memory do not support 32-bit operating system images.
1494
- * - Instances created with this API are not assigned a public IP address. If the public bandwidth is greater than 0, you can call [AllocatePublicIpAddress](https://help.aliyun.com/document_detail/25544.html) to assign one. If the public bandwidth is 0, you must first call [ModifyInstanceNetworkSpec](https://help.aliyun.com/document_detail/2679879.html) to adjust the bandwidth, and then call [AllocatePublicIpAddress](https://help.aliyun.com/document_detail/25544.html) to assign a public IP address.
1495
- * > A single Alibaba Cloud account has a limit on the total peak public bandwidth for all pay-by-bandwidth resources within a region. For more information, see [Public bandwidth limits](~~25412#BandwidthQuota~~).
1488
+ * - Make sure that your account has passed real-name registration. For more information, see [Real-name registration documentation](https://help.aliyun.com/document_detail/48263.html).
1489
+ * - Creating an instance incurs charges. Make sure that you understand the billable methods of Elastic Computing Service (ECS). For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
1490
+ *
1491
+ * - Make sure that the total number of instances or the total number of vCPUs across all instance types does not exceed the quota. For more information, see [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas).
1492
+ * - Before creating a VPC-connected instance, create a VPC in the corresponding region. For more information, see [Create a VPC](https://help.aliyun.com/document_detail/65430.html).
1493
+ * ### Before you begin
1494
+ * - When you invoke this operation, the system does not send notifications (including text messages, emails, or internal messages) about instance creation.
1495
+ * - If the billable methods of the instance is subscription (`PrePaid`), active coupon in your account are used by default during payment.
1496
+ * - If the instance memory is 512 MiB, you cannot use Windows Server images except through the half-year channel. If the instance memory is 4 GiB or more, you cannot use 32-bit operating system images.
1497
+ * - Instances created by invoking this operation are not assigned Internet IP addresses. If the public bandwidth is greater than 0, invoke [AllocatePublicIpAddress](https://help.aliyun.com/document_detail/25544.html) to assign a public IP address. If the public bandwidth is 0, invoke [ModifyInstanceNetworkSpec](https://help.aliyun.com/document_detail/2679879.html) to adjust the bandwidth and then invoke [AllocatePublicIpAddress](https://help.aliyun.com/document_detail/25544.html) to assign a public IP address.
1498
+ * > In a single region, the total peak pay-by-bandwidth Internet bandwidth for a single Alibaba Cloud account is limited. For more information, see [Public bandwidth limits](~~25412#BandwidthQuota~~).
1496
1499
  * ### Recommendations
1497
- * - **Select an instance type**: See [Instance type families](https://help.aliyun.com/document_detail/25378.html), call [DescribeInstanceTypes](https://help.aliyun.com/document_detail/25620.html) to view the performance data of your target instance type, or see [Select an instance type](https://help.aliyun.com/document_detail/58291.html) for guidance on how to select an instance type.
1498
- * - **Check resource availability**: Call [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) to check the availability of resources in a specific region or zone.
1499
- * - **User data**: If your instance meets the requirements described in [Use instance user data](https://help.aliyun.com/document_detail/49121.html), you can pass user data to it. The `UserData` parameter is sent unencrypted. We recommend that you do not pass confidential information, such as passwords and private keys, in plaintext. If you must pass such information, encrypt and then Base64-encode it before passing it. The instance can then decrypt and use the data.
1500
+ * - **Instance type selection**: See [Instance family](https://help.aliyun.com/document_detail/25378.html) or invoke [DescribeInstanceTypes](https://help.aliyun.com/document_detail/25620.html) to query the performance data of the target instance type. You can also see [Settings for instance type selection](https://help.aliyun.com/document_detail/58291.html) to learn how to select an instance type.
1501
+ * - **Check active resources**: Invoke [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) to query active resources in a specific region or zone.
1502
+ * - **User data**: If the instance meets the requirements for [instance user data](https://help.aliyun.com/document_detail/49121.html), you can pass in UserData. The `UserData` data is not encrypted when the API request is sent. Do not send confidential information such as passwords or private keys in plaintext. If you must pass in such information, encrypt it and use Base64 encoding before passing it in. Then perform decryption inside the instance.
1500
1503
  *
1501
1504
  * @param request - CreateInstanceRequest
1502
1505
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1504,31 +1507,32 @@ export default class Client extends OpenApi {
1504
1507
  */
1505
1508
  createInstanceWithOptions(request: $_model.CreateInstanceRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateInstanceResponse>;
1506
1509
  /**
1507
- * Use this API to create a single subscription or pay-as-you-go Alibaba Cloud ECS instance. You can configure parameters to customize the instance.
1510
+ * Creates a subscription or pay-as-you-go Elastic Compute Service (ECS) instance with customizable parameters.
1508
1511
  *
1509
1512
  * @remarks
1510
- * > This API is deprecated. We recommend that you use the [RunInstances](https://help.aliyun.com/document_detail/2679677.html) API instead.
1513
+ * > This operation is no longer maintained. Use [RunInstances](https://help.aliyun.com/document_detail/2679677.html) instead.
1511
1514
  * <props="china">
1512
- * **Before using this API, ensure you understand the billing methods and [Pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS.**
1515
+ * **Before you call this operation, make sure that you fully understand the billing methods and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS.**
1513
1516
  * <props="intl">
1514
- * **Before using this API, ensure you understand the billing methods and [Pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS.**
1515
- * A successful call to this API returns an instance ID, but the instance is created asynchronously. Call [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) to query the instance\\"s status. The instance is successfully created when its status becomes `Stopped`. You can then call [StartInstance](https://help.aliyun.com/document_detail/2679679.html) to start the instance.
1516
- * ### Usage notes
1517
+ * **Before you call this operation, make sure that you fully understand the billing methods and [pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS.**
1518
+ * This is an asynchronous operation. After a request to create an instance is sent, the instance ID is returned. The instance is not immediately created. Call [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) to query the instance status. When the status is `Stopped`, the instance is created. Then you can call [StartInstance](https://help.aliyun.com/document_detail/2679679.html) to start the instance.
1519
+ * ### Before you begin
1517
1520
  * <props="china">
1518
- * - Make sure that your account has passed real-name verification. For more information, see [Account real-name verification](https://help.aliyun.com/document_detail/48263.html).
1519
- * - Creating an instance incurs charges. Make sure that you understand the billing methods for ECS. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
1520
- * - Ensure you do not exceed your quotas for the total number of instances or vCPUs. For more information, see [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas).
1521
- * - Before creating a VPC-type instance, you must [create a VPC](https://help.aliyun.com/document_detail/65430.html) in the same region.
1522
- * ### Precautions
1523
- * - Calling this API does not trigger system notifications (such as SMS messages, emails, or in-site messages) to indicate that the instance is successfully created.
1524
- * - If the billing method for the instance is subscription (`PrePaid`), your available coupons are automatically used at checkout.
1525
- * - Instances with 512 MiB of memory support only Windows Server images from the semiannual channel. Instances with 4 GiB or more of memory do not support 32-bit operating system images.
1526
- * - Instances created with this API are not assigned a public IP address. If the public bandwidth is greater than 0, you can call [AllocatePublicIpAddress](https://help.aliyun.com/document_detail/25544.html) to assign one. If the public bandwidth is 0, you must first call [ModifyInstanceNetworkSpec](https://help.aliyun.com/document_detail/2679879.html) to adjust the bandwidth, and then call [AllocatePublicIpAddress](https://help.aliyun.com/document_detail/25544.html) to assign a public IP address.
1527
- * > A single Alibaba Cloud account has a limit on the total peak public bandwidth for all pay-by-bandwidth resources within a region. For more information, see [Public bandwidth limits](~~25412#BandwidthQuota~~).
1521
+ * - Make sure that your account has passed real-name registration. For more information, see [Real-name registration documentation](https://help.aliyun.com/document_detail/48263.html).
1522
+ * - Creating an instance incurs charges. Make sure that you understand the billable methods of Elastic Computing Service (ECS). For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
1523
+ *
1524
+ * - Make sure that the total number of instances or the total number of vCPUs across all instance types does not exceed the quota. For more information, see [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas).
1525
+ * - Before creating a VPC-connected instance, create a VPC in the corresponding region. For more information, see [Create a VPC](https://help.aliyun.com/document_detail/65430.html).
1526
+ * ### Before you begin
1527
+ * - When you invoke this operation, the system does not send notifications (including text messages, emails, or internal messages) about instance creation.
1528
+ * - If the billable methods of the instance is subscription (`PrePaid`), active coupon in your account are used by default during payment.
1529
+ * - If the instance memory is 512 MiB, you cannot use Windows Server images except through the half-year channel. If the instance memory is 4 GiB or more, you cannot use 32-bit operating system images.
1530
+ * - Instances created by invoking this operation are not assigned Internet IP addresses. If the public bandwidth is greater than 0, invoke [AllocatePublicIpAddress](https://help.aliyun.com/document_detail/25544.html) to assign a public IP address. If the public bandwidth is 0, invoke [ModifyInstanceNetworkSpec](https://help.aliyun.com/document_detail/2679879.html) to adjust the bandwidth and then invoke [AllocatePublicIpAddress](https://help.aliyun.com/document_detail/25544.html) to assign a public IP address.
1531
+ * > In a single region, the total peak pay-by-bandwidth Internet bandwidth for a single Alibaba Cloud account is limited. For more information, see [Public bandwidth limits](~~25412#BandwidthQuota~~).
1528
1532
  * ### Recommendations
1529
- * - **Select an instance type**: See [Instance type families](https://help.aliyun.com/document_detail/25378.html), call [DescribeInstanceTypes](https://help.aliyun.com/document_detail/25620.html) to view the performance data of your target instance type, or see [Select an instance type](https://help.aliyun.com/document_detail/58291.html) for guidance on how to select an instance type.
1530
- * - **Check resource availability**: Call [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) to check the availability of resources in a specific region or zone.
1531
- * - **User data**: If your instance meets the requirements described in [Use instance user data](https://help.aliyun.com/document_detail/49121.html), you can pass user data to it. The `UserData` parameter is sent unencrypted. We recommend that you do not pass confidential information, such as passwords and private keys, in plaintext. If you must pass such information, encrypt and then Base64-encode it before passing it. The instance can then decrypt and use the data.
1533
+ * - **Instance type selection**: See [Instance family](https://help.aliyun.com/document_detail/25378.html) or invoke [DescribeInstanceTypes](https://help.aliyun.com/document_detail/25620.html) to query the performance data of the target instance type. You can also see [Settings for instance type selection](https://help.aliyun.com/document_detail/58291.html) to learn how to select an instance type.
1534
+ * - **Check active resources**: Invoke [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) to query active resources in a specific region or zone.
1535
+ * - **User data**: If the instance meets the requirements for [instance user data](https://help.aliyun.com/document_detail/49121.html), you can pass in UserData. The `UserData` data is not encrypted when the API request is sent. Do not send confidential information such as passwords or private keys in plaintext. If you must pass in such information, encrypt it and use Base64 encoding before passing it in. Then perform decryption inside the instance.
1532
1536
  *
1533
1537
  * @param request - CreateInstanceRequest
1534
1538
  * @returns CreateInstanceResponse
@@ -1589,11 +1593,11 @@ export default class Client extends OpenApi {
1589
1593
  */
1590
1594
  createLaunchTemplate(request: $_model.CreateLaunchTemplateRequest): Promise<$_model.CreateLaunchTemplateResponse>;
1591
1595
  /**
1592
- * Create a new version under the specified ECS instance launch template for subsequent creation of ECS instances, scaling groups, or auto provisioning groups.
1596
+ * Creates a new version in a specified ECS launch template for subsequent creation of ECS instances, elastic scaling groups, or auto provisioning groups.
1593
1597
  *
1594
1598
  * @remarks
1595
- * ## API Guide
1596
- * When you want to modify parameters of a specific version, you can do so by creating a new template version. Each launch template supports up to 30 versions.
1599
+ * ## Operation description
1600
+ * To modify the parameters of a specific version, create a new template version. Each instance launch template supports a maximum of 30 versions.
1597
1601
  *
1598
1602
  * @param request - CreateLaunchTemplateVersionRequest
1599
1603
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1601,11 +1605,11 @@ export default class Client extends OpenApi {
1601
1605
  */
1602
1606
  createLaunchTemplateVersionWithOptions(request: $_model.CreateLaunchTemplateVersionRequest, runtime: $dara.RuntimeOptions): Promise<$_model.CreateLaunchTemplateVersionResponse>;
1603
1607
  /**
1604
- * Create a new version under the specified ECS instance launch template for subsequent creation of ECS instances, scaling groups, or auto provisioning groups.
1608
+ * Creates a new version in a specified ECS launch template for subsequent creation of ECS instances, elastic scaling groups, or auto provisioning groups.
1605
1609
  *
1606
1610
  * @remarks
1607
- * ## API Guide
1608
- * When you want to modify parameters of a specific version, you can do so by creating a new template version. Each launch template supports up to 30 versions.
1611
+ * ## Operation description
1612
+ * To modify the parameters of a specific version, create a new template version. Each instance launch template supports a maximum of 30 versions.
1609
1613
  *
1610
1614
  * @param request - CreateLaunchTemplateVersionRequest
1611
1615
  * @returns CreateLaunchTemplateVersionResponse
@@ -1865,10 +1869,10 @@ export default class Client extends OpenApi {
1865
1869
  * Creates a security group.
1866
1870
  *
1867
1871
  * @remarks
1868
- * - 通过该接口创建的普通安全组组内连通策略默认是**组内互通**,您可以通过 [ModifySecurityGroupPolicy](https://help.aliyun.com/document_detail/2679846.html) 进行修改。
1869
- * - 通过该接口创建的企业安全组组内连通策略默认是**组内隔离**,并且不能修改。
1870
- * - 单个地域下,安全组的数量有限制,您最少可以创建 100 个安全组。详细信息,请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
1871
- * - 创建专有网络 VPC 类型的安全组时,您必须指定参数 VpcId
1872
+ * - The default internal connectivity policy for a basic security group created by this operation is **intra-group connectivity**. You can modify this policy by calling [ModifySecurityGroupPolicy](https://help.aliyun.com/document_detail/2679846.html).
1873
+ * - The default internal connectivity policy for an advanced security group created by this operation is **internal isolation**, and this policy cannot be modified.
1874
+ * - The number of security groups in a single region is limited. You can create a minimum of 100 security groups. For more information, see [Security group limits](~~25412#SecurityGroupQuota1~~).
1875
+ * - To create a security group of the VPC type, you must specify the VpcId parameter.
1872
1876
  *
1873
1877
  * @param request - CreateSecurityGroupRequest
1874
1878
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1879,10 +1883,10 @@ export default class Client extends OpenApi {
1879
1883
  * Creates a security group.
1880
1884
  *
1881
1885
  * @remarks
1882
- * - 通过该接口创建的普通安全组组内连通策略默认是**组内互通**,您可以通过 [ModifySecurityGroupPolicy](https://help.aliyun.com/document_detail/2679846.html) 进行修改。
1883
- * - 通过该接口创建的企业安全组组内连通策略默认是**组内隔离**,并且不能修改。
1884
- * - 单个地域下,安全组的数量有限制,您最少可以创建 100 个安全组。详细信息,请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
1885
- * - 创建专有网络 VPC 类型的安全组时,您必须指定参数 VpcId
1886
+ * - The default internal connectivity policy for a basic security group created by this operation is **intra-group connectivity**. You can modify this policy by calling [ModifySecurityGroupPolicy](https://help.aliyun.com/document_detail/2679846.html).
1887
+ * - The default internal connectivity policy for an advanced security group created by this operation is **internal isolation**, and this policy cannot be modified.
1888
+ * - The number of security groups in a single region is limited. You can create a minimum of 100 security groups. For more information, see [Security group limits](~~25412#SecurityGroupQuota1~~).
1889
+ * - To create a security group of the VPC type, you must specify the VpcId parameter.
1886
1890
  *
1887
1891
  * @param request - CreateSecurityGroupRequest
1888
1892
  * @returns CreateSecurityGroupResponse
@@ -2358,7 +2362,7 @@ export default class Client extends OpenApi {
2358
2362
  */
2359
2363
  deleteHaVip(request: $_model.DeleteHaVipRequest): Promise<$_model.DeleteHaVipResponse>;
2360
2364
  /**
2361
- * Deletes a High Performance Computing (HPC) cluster.
2365
+ * Calls DeleteHpcCluster to delete an HPC cluster.
2362
2366
  *
2363
2367
  * @param request - DeleteHpcClusterRequest
2364
2368
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2366,7 +2370,7 @@ export default class Client extends OpenApi {
2366
2370
  */
2367
2371
  deleteHpcClusterWithOptions(request: $_model.DeleteHpcClusterRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DeleteHpcClusterResponse>;
2368
2372
  /**
2369
- * Deletes a High Performance Computing (HPC) cluster.
2373
+ * Calls DeleteHpcCluster to delete an HPC cluster.
2370
2374
  *
2371
2375
  * @param request - DeleteHpcClusterRequest
2372
2376
  * @returns DeleteHpcClusterResponse
@@ -2420,7 +2424,7 @@ export default class Client extends OpenApi {
2420
2424
  * Deletes an image template.
2421
2425
  *
2422
2426
  * @remarks
2423
- * If a build task is running, you cannot directly delete the template. Wait until the build task reaches a desired state: SUCCESS, FAILED, TEST_FAILED, PARTITION_SUCCESS, or CANCELLED. You can call [DescribeImagePipelineExecutions](https://help.aliyun.com/document_detail/25609.html) to query the details of build tasks.
2427
+ * If a build task is currently running, you cannot directly delete the template. Wait until the build task reaches a desired state: SUCCESS, FAILED, TEST_FAILED, PARTITION_SUCCESS, or CANCELLED. You can call [DescribeImagePipelineExecutions](https://help.aliyun.com/document_detail/25609.html) to query the details of build tasks.
2424
2428
  *
2425
2429
  * @param request - DeleteImagePipelineRequest
2426
2430
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2431,7 +2435,7 @@ export default class Client extends OpenApi {
2431
2435
  * Deletes an image template.
2432
2436
  *
2433
2437
  * @remarks
2434
- * If a build task is running, you cannot directly delete the template. Wait until the build task reaches a desired state: SUCCESS, FAILED, TEST_FAILED, PARTITION_SUCCESS, or CANCELLED. You can call [DescribeImagePipelineExecutions](https://help.aliyun.com/document_detail/25609.html) to query the details of build tasks.
2438
+ * If a build task is currently running, you cannot directly delete the template. Wait until the build task reaches a desired state: SUCCESS, FAILED, TEST_FAILED, PARTITION_SUCCESS, or CANCELLED. You can call [DescribeImagePipelineExecutions](https://help.aliyun.com/document_detail/25609.html) to query the details of build tasks.
2435
2439
  *
2436
2440
  * @param request - DeleteImagePipelineRequest
2437
2441
  * @returns DeleteImagePipelineResponse
@@ -2719,10 +2723,10 @@ export default class Client extends OpenApi {
2719
2723
  */
2720
2724
  deletePortRangeList(request: $_model.DeletePortRangeListRequest): Promise<$_model.DeletePortRangeListResponse>;
2721
2725
  /**
2722
- * Deletes a specified prefix list and all entries in the prefix list.
2726
+ * Calls DeletePrefixList to delete a specified prefix list and all entries in the prefix list.
2723
2727
  *
2724
2728
  * @remarks
2725
- * If a prefix list is associated with other resources, you cannot directly delete it. Dissociate the prefix list from the resources first, and then delete it. You can call [DescribePrefixListAssociations](https://help.aliyun.com/document_detail/204724.html) to query the resources that are associated with a specified prefix list.
2729
+ * If a prefix list is associated with other resources, you cannot directly delete it. Dissociate the prefix list from the other resources first, and then delete it. You can call [DescribePrefixListAssociations](https://help.aliyun.com/document_detail/204724.html) to query the resources associated with a specified prefix list.
2726
2730
  *
2727
2731
  * @param request - DeletePrefixListRequest
2728
2732
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2730,10 +2734,10 @@ export default class Client extends OpenApi {
2730
2734
  */
2731
2735
  deletePrefixListWithOptions(request: $_model.DeletePrefixListRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DeletePrefixListResponse>;
2732
2736
  /**
2733
- * Deletes a specified prefix list and all entries in the prefix list.
2737
+ * Calls DeletePrefixList to delete a specified prefix list and all entries in the prefix list.
2734
2738
  *
2735
2739
  * @remarks
2736
- * If a prefix list is associated with other resources, you cannot directly delete it. Dissociate the prefix list from the resources first, and then delete it. You can call [DescribePrefixListAssociations](https://help.aliyun.com/document_detail/204724.html) to query the resources that are associated with a specified prefix list.
2740
+ * If a prefix list is associated with other resources, you cannot directly delete it. Dissociate the prefix list from the other resources first, and then delete it. You can call [DescribePrefixListAssociations](https://help.aliyun.com/document_detail/204724.html) to query the resources associated with a specified prefix list.
2737
2741
  *
2738
2742
  * @param request - DeletePrefixListRequest
2739
2743
  * @returns DeletePrefixListResponse
@@ -3051,7 +3055,7 @@ export default class Client extends OpenApi {
3051
3055
  */
3052
3056
  describeAutoProvisioningGroupHistory(request: $_model.DescribeAutoProvisioningGroupHistoryRequest): Promise<$_model.DescribeAutoProvisioningGroupHistoryResponse>;
3053
3057
  /**
3054
- * Queries information about Elastic Compute Service (ECS) instances in an auto provisioning group.
3058
+ * Queries information about instances in an auto provisioning group.
3055
3059
  *
3056
3060
  * @param request - DescribeAutoProvisioningGroupInstancesRequest
3057
3061
  * @param runtime - runtime options for this request RuntimeOptions
@@ -3059,7 +3063,7 @@ export default class Client extends OpenApi {
3059
3063
  */
3060
3064
  describeAutoProvisioningGroupInstancesWithOptions(request: $_model.DescribeAutoProvisioningGroupInstancesRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeAutoProvisioningGroupInstancesResponse>;
3061
3065
  /**
3062
- * Queries information about Elastic Compute Service (ECS) instances in an auto provisioning group.
3066
+ * Queries information about instances in an auto provisioning group.
3063
3067
  *
3064
3068
  * @param request - DescribeAutoProvisioningGroupInstancesRequest
3065
3069
  * @returns DescribeAutoProvisioningGroupInstancesResponse
@@ -3096,7 +3100,7 @@ export default class Client extends OpenApi {
3096
3100
  */
3097
3101
  describeAutoSnapshotPolicyAssociations(request: $_model.DescribeAutoSnapshotPolicyAssociationsRequest): Promise<$_model.DescribeAutoSnapshotPolicyAssociationsResponse>;
3098
3102
  /**
3099
- * Queries the details of automatic snapshot policies that are created in a specific region.
3103
+ * Queries the details of automatic snapshot policies that are created in a specified region.
3100
3104
  *
3101
3105
  * @param request - DescribeAutoSnapshotPolicyExRequest
3102
3106
  * @param runtime - runtime options for this request RuntimeOptions
@@ -3104,50 +3108,44 @@ export default class Client extends OpenApi {
3104
3108
  */
3105
3109
  describeAutoSnapshotPolicyExWithOptions(request: $_model.DescribeAutoSnapshotPolicyExRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeAutoSnapshotPolicyExResponse>;
3106
3110
  /**
3107
- * Queries the details of automatic snapshot policies that are created in a specific region.
3111
+ * Queries the details of automatic snapshot policies that are created in a specified region.
3108
3112
  *
3109
3113
  * @param request - DescribeAutoSnapshotPolicyExRequest
3110
3114
  * @returns DescribeAutoSnapshotPolicyExResponse
3111
3115
  */
3112
3116
  describeAutoSnapshotPolicyEx(request: $_model.DescribeAutoSnapshotPolicyExRequest): Promise<$_model.DescribeAutoSnapshotPolicyExResponse>;
3113
3117
  /**
3114
- * Use this API to check if a target resource, such as an instance type or a system disk type, has sufficient inventory in a specific availability zone before you call `RunInstances` or `ModifyInstanceSpec`.
3118
+ * Queries the inventory status of resources in a specified zone. This operation is primarily used to check whether target resources, such as instance types and system disk types, are available in a specific zone before you create instances (RunInstances) or modify instance specifications (ModifyInstanceSpec).
3115
3119
  *
3116
3120
  * @remarks
3117
- * The value of the `DestinationResource` parameter determines which other parameters are required. Values with lower precedence require more parameters. You cannot use a lower-precedence value to filter for a higher-precedence resource category.
3118
- * - Value precedence: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
3121
+ * The DestinationResource parameter has different logic and requirements depending on its value. In the following ordered list, a lower-ranked value requires more parameters to be set. You cannot use a lower-ranked value to filter resources of a higher-ranked category.
3122
+ * - Value order: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
3119
3123
  * - Examples:
3120
- * - If `DestinationResource` is set to `DataDisk`:
3121
- * - If you set `ResourceType` to `disk`, you query for data disk types that are independent of a specific ECS instance type. You do not need to specify the `InstanceType` parameter.
3122
- * - If you set `ResourceType` to `instance`, you query for data disk types to be attached to an ECS instance. Because the instance type imposes limits on compatible data disks, both the `InstanceType` and `DataDiskCategory` parameters are required.
3123
- * - When `DestinationResource` is set to `SystemDisk` and `ResourceType` is set to `instance`, the `InstanceType` parameter is required because the instance type imposes limits on the system disk.
3124
- * - If `DestinationResource` is set to `InstanceType`, we recommend specifying the `IoOptimized` and `InstanceType` parameters.
3125
- * - To query the inventory of the `ecs.g5.large` instance type in all availability zones in the `cn-hangzhou` region: `RegionId=cn-hangzhou &DestinationResource=InstanceType &IoOptimized=optimized &InstanceType=ecs.g5.large`.
3126
- * - To query for availability zones in the `cn-hangzhou` region that have `ecs.g5.large` inventory: `RegionId=cn-hangzhou &DestinationResource=Zone &IoOptimized=optimized &InstanceType=ecs.g5.large`.
3124
+ * - If DestinationResource is set to `DataDisk`:
3125
+ * - If `ResourceType` is set to `disk`, the operation queries data disk types that are not associated with a specific ECS instance type. In this case, the InstanceType parameter is optional.
3126
+ * - If `ResourceType` is set to `instance`, the operation queries data disk types that can be attached to an ECS instance. Because instance types impose restrictions on data disks, you must specify both `InstanceType` and `DataDiskCategory`.
3127
+ * - If DestinationResource is set to `SystemDisk` and `ResourceType` is set to `instance`, you must specify the InstanceType parameter because ECS instance types impose restrictions on system disks.
3128
+ * - If DestinationResource is set to `InstanceType`, specify the IoOptimized and InstanceType parameters.
3129
+ * - Query the inventory of ecs.g5.large across all zones in a specified region: `RegionId=ap-southeast-1 &DestinationResource=InstanceType &IoOptimized=optimized &InstanceType=ecs.g5.large`.
3130
+ * - Query the zones in a specified region where ecs.g5.large is available: `RegionId=ap-southeast-1 &DestinationResource=Zone &IoOptimized=optimized &InstanceType=ecs.g5.large`.
3127
3131
  * <details>
3128
- * <summary>
3129
- * Query for availability zones in the China (Hangzhou) region that have the `ecs.g5.large` instance type.
3130
- * </summary>
3132
+ * <summary>Query the zones in the China (Hangzhou) region where the ecs.g5.large instance type is available.</summary>
3131
3133
  * ```
3132
3134
  * "RegionId": "cn-hangzhou",
3133
- * "DestinationResource": "Zone",
3135
+ * "DestinationResource": "Zone"
3134
3136
  * "InstanceType": "ecs.g5.large"
3135
3137
  * ```
3136
3138
  * </details>
3137
3139
  * <details>
3138
- * <summary>
3139
- * Query the inventory of the `ecs.g5.large` instance type across all availability zones in the China (Hangzhou) region.
3140
- * </summary>
3140
+ * <summary>Query the inventory of the ecs.g5.large instance type across all zones in the China (Hangzhou) region.</summary>
3141
3141
  * ```
3142
3142
  * "RegionId": "cn-hangzhou",
3143
- * "DestinationResource": "InstanceType",
3143
+ * "DestinationResource": "InstanceType"
3144
3144
  * "InstanceType": "ecs.g5.large"
3145
3145
  * ```
3146
3146
  * </details>
3147
3147
  * <details>
3148
- * <summary>
3149
- * Query the inventory of `cloud_efficiency` data disks in availability zone b of the China (Hangzhou) region, independent of any ECS instance type.
3150
- * </summary>
3148
+ * <summary>[Purchase only a data disk] Query the inventory of the cloud_efficiency data disk type in Zone B of the China (Hangzhou) region.</summary>
3151
3149
  * ```
3152
3150
  * "RegionId": "cn-hangzhou",
3153
3151
  * "ZoneId": "cn-hangzhou-b",
@@ -3156,9 +3154,7 @@ export default class Client extends OpenApi {
3156
3154
  * ```
3157
3155
  * </details>
3158
3156
  * <details>
3159
- * <summary>
3160
- * Query the inventory of `cloud_essd` system disks for the `ecs.g7.large` instance type in availability zone b of the China (Hangzhou) region.
3161
- * </summary>
3157
+ * <summary>[Purchase an ECS instance and a system disk] Query the inventory of the ecs.g7.large instance type with the cloud_essd system disk type in Zone B of the China (Hangzhou) region.</summary>
3162
3158
  * ```
3163
3159
  * "RegionId": "cn-hangzhou",
3164
3160
  * "ZoneId": "cn-hangzhou-b",
@@ -3175,43 +3171,37 @@ export default class Client extends OpenApi {
3175
3171
  */
3176
3172
  describeAvailableResourceWithOptions(request: $_model.DescribeAvailableResourceRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeAvailableResourceResponse>;
3177
3173
  /**
3178
- * Use this API to check if a target resource, such as an instance type or a system disk type, has sufficient inventory in a specific availability zone before you call `RunInstances` or `ModifyInstanceSpec`.
3174
+ * Queries the inventory status of resources in a specified zone. This operation is primarily used to check whether target resources, such as instance types and system disk types, are available in a specific zone before you create instances (RunInstances) or modify instance specifications (ModifyInstanceSpec).
3179
3175
  *
3180
3176
  * @remarks
3181
- * The value of the `DestinationResource` parameter determines which other parameters are required. Values with lower precedence require more parameters. You cannot use a lower-precedence value to filter for a higher-precedence resource category.
3182
- * - Value precedence: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
3177
+ * The DestinationResource parameter has different logic and requirements depending on its value. In the following ordered list, a lower-ranked value requires more parameters to be set. You cannot use a lower-ranked value to filter resources of a higher-ranked category.
3178
+ * - Value order: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
3183
3179
  * - Examples:
3184
- * - If `DestinationResource` is set to `DataDisk`:
3185
- * - If you set `ResourceType` to `disk`, you query for data disk types that are independent of a specific ECS instance type. You do not need to specify the `InstanceType` parameter.
3186
- * - If you set `ResourceType` to `instance`, you query for data disk types to be attached to an ECS instance. Because the instance type imposes limits on compatible data disks, both the `InstanceType` and `DataDiskCategory` parameters are required.
3187
- * - When `DestinationResource` is set to `SystemDisk` and `ResourceType` is set to `instance`, the `InstanceType` parameter is required because the instance type imposes limits on the system disk.
3188
- * - If `DestinationResource` is set to `InstanceType`, we recommend specifying the `IoOptimized` and `InstanceType` parameters.
3189
- * - To query the inventory of the `ecs.g5.large` instance type in all availability zones in the `cn-hangzhou` region: `RegionId=cn-hangzhou &DestinationResource=InstanceType &IoOptimized=optimized &InstanceType=ecs.g5.large`.
3190
- * - To query for availability zones in the `cn-hangzhou` region that have `ecs.g5.large` inventory: `RegionId=cn-hangzhou &DestinationResource=Zone &IoOptimized=optimized &InstanceType=ecs.g5.large`.
3180
+ * - If DestinationResource is set to `DataDisk`:
3181
+ * - If `ResourceType` is set to `disk`, the operation queries data disk types that are not associated with a specific ECS instance type. In this case, the InstanceType parameter is optional.
3182
+ * - If `ResourceType` is set to `instance`, the operation queries data disk types that can be attached to an ECS instance. Because instance types impose restrictions on data disks, you must specify both `InstanceType` and `DataDiskCategory`.
3183
+ * - If DestinationResource is set to `SystemDisk` and `ResourceType` is set to `instance`, you must specify the InstanceType parameter because ECS instance types impose restrictions on system disks.
3184
+ * - If DestinationResource is set to `InstanceType`, specify the IoOptimized and InstanceType parameters.
3185
+ * - Query the inventory of ecs.g5.large across all zones in a specified region: `RegionId=ap-southeast-1 &DestinationResource=InstanceType &IoOptimized=optimized &InstanceType=ecs.g5.large`.
3186
+ * - Query the zones in a specified region where ecs.g5.large is available: `RegionId=ap-southeast-1 &DestinationResource=Zone &IoOptimized=optimized &InstanceType=ecs.g5.large`.
3191
3187
  * <details>
3192
- * <summary>
3193
- * Query for availability zones in the China (Hangzhou) region that have the `ecs.g5.large` instance type.
3194
- * </summary>
3188
+ * <summary>Query the zones in the China (Hangzhou) region where the ecs.g5.large instance type is available.</summary>
3195
3189
  * ```
3196
3190
  * "RegionId": "cn-hangzhou",
3197
- * "DestinationResource": "Zone",
3191
+ * "DestinationResource": "Zone"
3198
3192
  * "InstanceType": "ecs.g5.large"
3199
3193
  * ```
3200
3194
  * </details>
3201
3195
  * <details>
3202
- * <summary>
3203
- * Query the inventory of the `ecs.g5.large` instance type across all availability zones in the China (Hangzhou) region.
3204
- * </summary>
3196
+ * <summary>Query the inventory of the ecs.g5.large instance type across all zones in the China (Hangzhou) region.</summary>
3205
3197
  * ```
3206
3198
  * "RegionId": "cn-hangzhou",
3207
- * "DestinationResource": "InstanceType",
3199
+ * "DestinationResource": "InstanceType"
3208
3200
  * "InstanceType": "ecs.g5.large"
3209
3201
  * ```
3210
3202
  * </details>
3211
3203
  * <details>
3212
- * <summary>
3213
- * Query the inventory of `cloud_efficiency` data disks in availability zone b of the China (Hangzhou) region, independent of any ECS instance type.
3214
- * </summary>
3204
+ * <summary>[Purchase only a data disk] Query the inventory of the cloud_efficiency data disk type in Zone B of the China (Hangzhou) region.</summary>
3215
3205
  * ```
3216
3206
  * "RegionId": "cn-hangzhou",
3217
3207
  * "ZoneId": "cn-hangzhou-b",
@@ -3220,9 +3210,7 @@ export default class Client extends OpenApi {
3220
3210
  * ```
3221
3211
  * </details>
3222
3212
  * <details>
3223
- * <summary>
3224
- * Query the inventory of `cloud_essd` system disks for the `ecs.g7.large` instance type in availability zone b of the China (Hangzhou) region.
3225
- * </summary>
3213
+ * <summary>[Purchase an ECS instance and a system disk] Query the inventory of the ecs.g7.large instance type with the cloud_essd system disk type in Zone B of the China (Hangzhou) region.</summary>
3226
3214
  * ```
3227
3215
  * "RegionId": "cn-hangzhou",
3228
3216
  * "ZoneId": "cn-hangzhou-b",
@@ -3664,14 +3652,14 @@ export default class Client extends OpenApi {
3664
3652
  */
3665
3653
  describeDiskMonitorData(request: $_model.DescribeDiskMonitorDataRequest): Promise<$_model.DescribeDiskMonitorDataResponse>;
3666
3654
  /**
3667
- * Queries information about one or more created block storage devices, including disks, local disks, and elastic ephemeral disks.
3655
+ * Queries information about one or more created block storage devices, including cloud disks, local disks, and elastic ephemeral disks.
3668
3656
  *
3669
3657
  * @remarks
3670
- * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. The logical relationship among these parameters is AND.
3671
- * - The DiskIds request parameter is a JSON format array. If DiskIds is not specified, the filter does not take effect. If DiskIds is set to an empty JSON array, the filter is considered valid and an empty result is returned.
3672
- * - Token-based paged query is supported. Set NextToken to the NextToken value returned in the previous call of DescribeDisks, and set MaxResults to specify the maximum number of entries per page.
3673
- * - A disk with the multi-attach feature enabled can be attached to multiple instances. You can check the Attachment list in the response to view all attachment information of the disk.
3674
- * When you call an API operation by using Cloud Assistant CLI, specify request parameters of different data types in the required formats. For more information, see [Parameter format of CLI](https://help.aliyun.com/document_detail/110340.html).
3658
+ * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. These parameters have a logical AND relationship.
3659
+ * - The DiskIds request parameter is a JSON format array. If this parameter is empty, the filter does not take effect. However, if DiskIds is an empty array, the filter is considered valid and an empty result is returned.
3660
+ * - Token-based paged query is supported. Set the NextToken parameter to specify the query token. Its value is the NextToken value returned in the previous call of DescribeDisks. Use MaxResults to settings the maximum number of entries per page.
3661
+ * - A cloud disk with the multi-attach feature enabled can be attached to multiple instances. You can view all attachment information for the disk from the Attachment list in the response.
3662
+ * When you invoke an API operation by using Cloud Assistant CLI, specify request parameters of different data types in the required formats. For more information, see [Parameter format overview](https://help.aliyun.com/document_detail/110340.html).
3675
3663
  *
3676
3664
  * @param request - DescribeDisksRequest
3677
3665
  * @param runtime - runtime options for this request RuntimeOptions
@@ -3679,14 +3667,14 @@ export default class Client extends OpenApi {
3679
3667
  */
3680
3668
  describeDisksWithOptions(request: $_model.DescribeDisksRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeDisksResponse>;
3681
3669
  /**
3682
- * Queries information about one or more created block storage devices, including disks, local disks, and elastic ephemeral disks.
3670
+ * Queries information about one or more created block storage devices, including cloud disks, local disks, and elastic ephemeral disks.
3683
3671
  *
3684
3672
  * @remarks
3685
- * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. The logical relationship among these parameters is AND.
3686
- * - The DiskIds request parameter is a JSON format array. If DiskIds is not specified, the filter does not take effect. If DiskIds is set to an empty JSON array, the filter is considered valid and an empty result is returned.
3687
- * - Token-based paged query is supported. Set NextToken to the NextToken value returned in the previous call of DescribeDisks, and set MaxResults to specify the maximum number of entries per page.
3688
- * - A disk with the multi-attach feature enabled can be attached to multiple instances. You can check the Attachment list in the response to view all attachment information of the disk.
3689
- * When you call an API operation by using Cloud Assistant CLI, specify request parameters of different data types in the required formats. For more information, see [Parameter format of CLI](https://help.aliyun.com/document_detail/110340.html).
3673
+ * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. These parameters have a logical AND relationship.
3674
+ * - The DiskIds request parameter is a JSON format array. If this parameter is empty, the filter does not take effect. However, if DiskIds is an empty array, the filter is considered valid and an empty result is returned.
3675
+ * - Token-based paged query is supported. Set the NextToken parameter to specify the query token. Its value is the NextToken value returned in the previous call of DescribeDisks. Use MaxResults to settings the maximum number of entries per page.
3676
+ * - A cloud disk with the multi-attach feature enabled can be attached to multiple instances. You can view all attachment information for the disk from the Attachment list in the response.
3677
+ * When you invoke an API operation by using Cloud Assistant CLI, specify request parameters of different data types in the required formats. For more information, see [Parameter format overview](https://help.aliyun.com/document_detail/110340.html).
3690
3678
  *
3691
3679
  * @param request - DescribeDisksRequest
3692
3680
  * @returns DescribeDisksResponse
@@ -3888,7 +3876,7 @@ export default class Client extends OpenApi {
3888
3876
  * Queries the details of one or more image components.
3889
3877
  *
3890
3878
  * @remarks
3891
- * You can set `NextToken` to the value of `NextToken` returned in the previous call to DescribeImageComponents, and set `MaxResults` to specify the maximum number of entries per page for the query.
3879
+ * You can set NextToken to the value of NextToken returned by the previous call to DescribeImageComponents, and set MaxResults to specify the maximum number of entries per page.
3892
3880
  *
3893
3881
  * @param request - DescribeImageComponentsRequest
3894
3882
  * @param runtime - runtime options for this request RuntimeOptions
@@ -3899,7 +3887,7 @@ export default class Client extends OpenApi {
3899
3887
  * Queries the details of one or more image components.
3900
3888
  *
3901
3889
  * @remarks
3902
- * You can set `NextToken` to the value of `NextToken` returned in the previous call to DescribeImageComponents, and set `MaxResults` to specify the maximum number of entries per page for the query.
3890
+ * You can set NextToken to the value of NextToken returned by the previous call to DescribeImageComponents, and set MaxResults to specify the maximum number of entries per page.
3903
3891
  *
3904
3892
  * @param request - DescribeImageComponentsRequest
3905
3893
  * @returns DescribeImageComponentsResponse
@@ -4059,7 +4047,7 @@ export default class Client extends OpenApi {
4059
4047
  */
4060
4048
  describeInstanceAttachmentAttributes(request: $_model.DescribeInstanceAttachmentAttributesRequest): Promise<$_model.DescribeInstanceAttachmentAttributesResponse>;
4061
4049
  /**
4062
- * This API is used to query the attribute information of a specified ECS instance.
4050
+ * Queries the attribute information of a specified ECS instance.
4063
4051
  *
4064
4052
  * @param request - DescribeInstanceAttributeRequest
4065
4053
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4067,7 +4055,7 @@ export default class Client extends OpenApi {
4067
4055
  */
4068
4056
  describeInstanceAttributeWithOptions(request: $_model.DescribeInstanceAttributeRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeInstanceAttributeResponse>;
4069
4057
  /**
4070
- * This API is used to query the attribute information of a specified ECS instance.
4058
+ * Queries the attribute information of a specified ECS instance.
4071
4059
  *
4072
4060
  * @param request - DescribeInstanceAttributeRequest
4073
4061
  * @returns DescribeInstanceAttributeResponse
@@ -4097,12 +4085,12 @@ export default class Client extends OpenApi {
4097
4085
  */
4098
4086
  describeInstanceAutoRenewAttribute(request: $_model.DescribeInstanceAutoRenewAttributeRequest): Promise<$_model.DescribeInstanceAutoRenewAttributeResponse>;
4099
4087
  /**
4100
- * Invoke the DescribeInstanceHistoryEvents API and specify parameters such as InstanceId and EventType to query system event information for a specified instance. By default, this operation queries historical system events that are in a non-active state.
4088
+ * Queries system event information for a specified instance by calling the DescribeInstanceHistoryEvents operation. You can specify parameters such as InstanceId and EventType. By default, this operation queries historical system events in inactive states.
4101
4089
  *
4102
4090
  * @remarks
4103
- * - You can query completed historical system events from up to the last 30 days. There is no time limit for querying incomplete system events.
4104
- * - When neither the EventCycleStatus nor the InstanceEventCycleStatus parameter is specified, the query results include only system events in the Avoided (event avoided), Executed (event execution completed), Canceled (event canceled), or Failed (event execution failed) status by default.
4105
- * - By specifying the InstanceEventCycleStatus parameter, you can also query system events in the Scheduled (awaiting execution), Executing (execution in progress), or Inquiring (inquiry in progress) status.
4091
+ * - You can query completed historical system events from the last 30 days. There is no time limit for querying uncompleted system events.
4092
+ * - If neither EventCycleStatus nor InstanceEventCycleStatus is specified, the query results include only system events in the Avoided, Executed, Canceled, and Failed states by default.
4093
+ * - By specifying the InstanceEventCycleStatus parameter, you can also query system events in the Scheduled, Executing, and Inquiring states.
4106
4094
  *
4107
4095
  * @param request - DescribeInstanceHistoryEventsRequest
4108
4096
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4110,12 +4098,12 @@ export default class Client extends OpenApi {
4110
4098
  */
4111
4099
  describeInstanceHistoryEventsWithOptions(request: $_model.DescribeInstanceHistoryEventsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeInstanceHistoryEventsResponse>;
4112
4100
  /**
4113
- * Invoke the DescribeInstanceHistoryEvents API and specify parameters such as InstanceId and EventType to query system event information for a specified instance. By default, this operation queries historical system events that are in a non-active state.
4101
+ * Queries system event information for a specified instance by calling the DescribeInstanceHistoryEvents operation. You can specify parameters such as InstanceId and EventType. By default, this operation queries historical system events in inactive states.
4114
4102
  *
4115
4103
  * @remarks
4116
- * - You can query completed historical system events from up to the last 30 days. There is no time limit for querying incomplete system events.
4117
- * - When neither the EventCycleStatus nor the InstanceEventCycleStatus parameter is specified, the query results include only system events in the Avoided (event avoided), Executed (event execution completed), Canceled (event canceled), or Failed (event execution failed) status by default.
4118
- * - By specifying the InstanceEventCycleStatus parameter, you can also query system events in the Scheduled (awaiting execution), Executing (execution in progress), or Inquiring (inquiry in progress) status.
4104
+ * - You can query completed historical system events from the last 30 days. There is no time limit for querying uncompleted system events.
4105
+ * - If neither EventCycleStatus nor InstanceEventCycleStatus is specified, the query results include only system events in the Avoided, Executed, Canceled, and Failed states by default.
4106
+ * - By specifying the InstanceEventCycleStatus parameter, you can also query system events in the Scheduled, Executing, and Inquiring states.
4119
4107
  *
4120
4108
  * @param request - DescribeInstanceHistoryEventsRequest
4121
4109
  * @returns DescribeInstanceHistoryEventsResponse
@@ -4393,14 +4381,14 @@ export default class Client extends OpenApi {
4393
4381
  */
4394
4382
  describeInstanceVncUrl(request: $_model.DescribeInstanceVncUrlRequest): Promise<$_model.DescribeInstanceVncUrlResponse>;
4395
4383
  /**
4396
- * This operation queries a list of instances based on specified conditions and returns detailed information about the instances.
4384
+ * Queries a list of instances based on specified request conditions and returns the associated detailed information of the instances.
4397
4385
  *
4398
4386
  * @remarks
4387
+ * ### Before you begin
4388
+ * - When you invoke API operations by using Cloud Assistant CLI, make sure that request parameters of different data types are in the required formats. For more information, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
4399
4389
  * ### Usage notes
4400
- * - When you call this operation using Alibaba Cloud CLI, request parameter values of different data types must be in specific formats. For more information, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
4401
- * ### Recommendations
4402
- * - We recommend that you perform a dry run by setting the DryRun parameter to check parameter validity and authorization status.
4403
- * - To query the first page of results, set the `MaxResults` parameter to limit the number of entries returned. Use the `NextToken` value in the response to retrieve subsequent pages. For subsequent page queries, set the `NextToken` parameter to the value from the previous response and set `MaxResults` to limit the number of entries returned.
4390
+ * - Send a dry run request by using the DryRun request parameter to check the validity of parameters and authorization.
4391
+ * - When performing a paging query for the first page of results, set only `MaxResults` to limit the number of entries to return. The `NextToken` value in the response is used as the credential for querying subsequent pages. When performing a paging query for subsequent pages, set `NextToken` to the `NextToken` value obtained from the previous response and set `MaxResults` to limit the number of entries to return.
4404
4392
  *
4405
4393
  * @param request - DescribeInstancesRequest
4406
4394
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4408,14 +4396,14 @@ export default class Client extends OpenApi {
4408
4396
  */
4409
4397
  describeInstancesWithOptions(request: $_model.DescribeInstancesRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeInstancesResponse>;
4410
4398
  /**
4411
- * This operation queries a list of instances based on specified conditions and returns detailed information about the instances.
4399
+ * Queries a list of instances based on specified request conditions and returns the associated detailed information of the instances.
4412
4400
  *
4413
4401
  * @remarks
4402
+ * ### Before you begin
4403
+ * - When you invoke API operations by using Cloud Assistant CLI, make sure that request parameters of different data types are in the required formats. For more information, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
4414
4404
  * ### Usage notes
4415
- * - When you call this operation using Alibaba Cloud CLI, request parameter values of different data types must be in specific formats. For more information, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
4416
- * ### Recommendations
4417
- * - We recommend that you perform a dry run by setting the DryRun parameter to check parameter validity and authorization status.
4418
- * - To query the first page of results, set the `MaxResults` parameter to limit the number of entries returned. Use the `NextToken` value in the response to retrieve subsequent pages. For subsequent page queries, set the `NextToken` parameter to the value from the previous response and set `MaxResults` to limit the number of entries returned.
4405
+ * - Send a dry run request by using the DryRun request parameter to check the validity of parameters and authorization.
4406
+ * - When performing a paging query for the first page of results, set only `MaxResults` to limit the number of entries to return. The `NextToken` value in the response is used as the credential for querying subsequent pages. When performing a paging query for subsequent pages, set `NextToken` to the `NextToken` value obtained from the previous response and set `MaxResults` to limit the number of entries to return.
4419
4407
  *
4420
4408
  * @param request - DescribeInstancesRequest
4421
4409
  * @returns DescribeInstancesResponse
@@ -4447,22 +4435,22 @@ export default class Client extends OpenApi {
4447
4435
  */
4448
4436
  describeInstancesFullStatus(request: $_model.DescribeInstancesFullStatusRequest): Promise<$_model.DescribeInstancesFullStatusResponse>;
4449
4437
  /**
4450
- * $.parameters[11].schema.items.properties.Value.example
4438
+ * Queries the execution results of one or more Cloud Assistant commands, which are the actual execution results on ECS instances.
4451
4439
  *
4452
4440
  * @remarks
4453
- * ## API Guide
4454
- * - After you execute a command, it does not necessarily mean that the command was successfully executed or produced the expected effect. You must use this API to check the actual execution results, and the actual output takes precedence.
4455
- * - You can query execution information from the last four weeks, with a maximum retention limit of 100,000 records.
4456
- * - You can obtain job results through [management event subscription for Cloud Assistant task status](https://help.aliyun.com/document_detail/2669130.html), which avoids frequent polling and improves efficiency.
4457
- * - When performing a paged query on the home page, you only need to set `MaxResults` to limit the number of returned entries. The `NextToken` in the return result serves as the credential for querying subsequent pages. When querying subsequent pages, set the `NextToken` parameter to the `NextToken` value obtained from the previous response as the query credential, and set `MaxResults` to limit the number of returned entries.
4441
+ * ## Operation description
4442
+ * - After you run a command, the command is not guaranteed to succeed or produce the expected results. Call this operation to view the actual execution results based on the actual output.
4443
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
4444
+ * - You can use [Cloud Assistant task status event subscription](https://help.aliyun.com/document_detail/2669130.html) to obtain task results through events, which avoids frequent polling and improves efficiency.
4445
+ * - When paged query the first page, set only MaxResults to limit the number of entries to return. The NextToken value in the response serves as the token for querying subsequent pages. When paged query subsequent pages, set NextToken to the NextToken value obtained from the previous response and set MaxResults to limit the number of entries to return.
4458
4446
  * - Differences between `DescribeInvocations` and `DescribeInvocationResults`:
4459
- * - When a single `RunCommand`/`InvokeCommand` invocation targets multiple instances:
4460
- * - `DescribeInvocations` provides the execution status on each instance and an aggregation status across all instances.
4461
- * - `DescribeInvocationResults` only provides individual execution statuses per instance, without aggregated multi-instance status.
4462
- * - When a single `RunCommand`/`InvokeCommand` invocation targets one instance:
4463
- * - There is little difference between `DescribeInvocations` and `DescribeInvocationResults`, and they can fully replace each other.
4464
- * - When you need to view the execution history of scheduled (periodic) tasks or automatic startup tasks (`RepeatMode=Period, EveryReboot`), only `DescribeInvocationResults` can retrieve historical execution records (by specifying `IncludeHistory=true`). In contrast, `DescribeInvocations` only returns the latest task status.
4465
- * - When you need to view the command content or parameters, only `DescribeInvocations` returns `CommandContent`.
4447
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
4448
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
4449
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status across instances.
4450
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
4451
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
4452
+ * - When you want to view the execution history of scheduled (periodic) tasks or tasks that run at each system startup (`RepeatMode=Period, EveryReboot`), only `DescribeInvocationResults` can return historical execution records (you must specify `IncludeHistory=true`). `DescribeInvocations` returns only the latest task status.
4453
+ * - When you want to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
4466
4454
  *
4467
4455
  * @param request - DescribeInvocationResultsRequest
4468
4456
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4470,43 +4458,43 @@ export default class Client extends OpenApi {
4470
4458
  */
4471
4459
  describeInvocationResultsWithOptions(request: $_model.DescribeInvocationResultsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeInvocationResultsResponse>;
4472
4460
  /**
4473
- * $.parameters[11].schema.items.properties.Value.example
4461
+ * Queries the execution results of one or more Cloud Assistant commands, which are the actual execution results on ECS instances.
4474
4462
  *
4475
4463
  * @remarks
4476
- * ## API Guide
4477
- * - After you execute a command, it does not necessarily mean that the command was successfully executed or produced the expected effect. You must use this API to check the actual execution results, and the actual output takes precedence.
4478
- * - You can query execution information from the last four weeks, with a maximum retention limit of 100,000 records.
4479
- * - You can obtain job results through [management event subscription for Cloud Assistant task status](https://help.aliyun.com/document_detail/2669130.html), which avoids frequent polling and improves efficiency.
4480
- * - When performing a paged query on the home page, you only need to set `MaxResults` to limit the number of returned entries. The `NextToken` in the return result serves as the credential for querying subsequent pages. When querying subsequent pages, set the `NextToken` parameter to the `NextToken` value obtained from the previous response as the query credential, and set `MaxResults` to limit the number of returned entries.
4464
+ * ## Operation description
4465
+ * - After you run a command, the command is not guaranteed to succeed or produce the expected results. Call this operation to view the actual execution results based on the actual output.
4466
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
4467
+ * - You can use [Cloud Assistant task status event subscription](https://help.aliyun.com/document_detail/2669130.html) to obtain task results through events, which avoids frequent polling and improves efficiency.
4468
+ * - When paged query the first page, set only MaxResults to limit the number of entries to return. The NextToken value in the response serves as the token for querying subsequent pages. When paged query subsequent pages, set NextToken to the NextToken value obtained from the previous response and set MaxResults to limit the number of entries to return.
4481
4469
  * - Differences between `DescribeInvocations` and `DescribeInvocationResults`:
4482
- * - When a single `RunCommand`/`InvokeCommand` invocation targets multiple instances:
4483
- * - `DescribeInvocations` provides the execution status on each instance and an aggregation status across all instances.
4484
- * - `DescribeInvocationResults` only provides individual execution statuses per instance, without aggregated multi-instance status.
4485
- * - When a single `RunCommand`/`InvokeCommand` invocation targets one instance:
4486
- * - There is little difference between `DescribeInvocations` and `DescribeInvocationResults`, and they can fully replace each other.
4487
- * - When you need to view the execution history of scheduled (periodic) tasks or automatic startup tasks (`RepeatMode=Period, EveryReboot`), only `DescribeInvocationResults` can retrieve historical execution records (by specifying `IncludeHistory=true`). In contrast, `DescribeInvocations` only returns the latest task status.
4488
- * - When you need to view the command content or parameters, only `DescribeInvocations` returns `CommandContent`.
4470
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
4471
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
4472
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status across instances.
4473
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
4474
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
4475
+ * - When you want to view the execution history of scheduled (periodic) tasks or tasks that run at each system startup (`RepeatMode=Period, EveryReboot`), only `DescribeInvocationResults` can return historical execution records (you must specify `IncludeHistory=true`). `DescribeInvocations` returns only the latest task status.
4476
+ * - When you want to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
4489
4477
  *
4490
4478
  * @param request - DescribeInvocationResultsRequest
4491
4479
  * @returns DescribeInvocationResultsResponse
4492
4480
  */
4493
4481
  describeInvocationResults(request: $_model.DescribeInvocationResultsRequest): Promise<$_model.DescribeInvocationResultsResponse>;
4494
4482
  /**
4495
- * Invoke the DescribeInvocations API to query the execution list and status of Cloud Assistant commands.
4483
+ * Queries the execution list and status of Cloud Assistant commands.
4496
4484
  *
4497
4485
  * @remarks
4498
- * - After you execute a command, it does not necessarily mean that the command has run successfully or produced the expected effect. You must check the actual execution result through the API return value, and the actual output result takes precedence.
4499
- * - You can query execution information from the past four weeks, with a maximum retention limit of 100,000 records.
4500
- * - You can subscribe to [Cloud Assistant task status event notifications](https://help.aliyun.com/document_detail/2669130.html) to obtain task results via events, avoiding frequent polling and thereby improving efficiency.
4501
- * - When performing a paged query on the home page, you only need to set `MaxResults` to limit the number of returned entries. The `NextToken` in the return result serves as the credential for querying subsequent pages. When querying subsequent pages, set the `NextToken` parameter to the `NextToken` obtained from the previous response as the query credential, and also set `MaxResults` to limit the number of returned entries.
4486
+ * - After you run a command, the command does not necessarily run successfully or produce the expected results. You must check the actual execution results based on the return values of this operation. The actual output takes precedence.
4487
+ * - You can query execution information from the last 30 days. A maximum of 10,000 execution records are retained.
4488
+ * - You can subscribe to [Cloud Assistant task status events](https://help.aliyun.com/document_detail/2669130.html) to obtain task results through events, which avoids frequent polling and improves efficiency.
4489
+ * - When paged query the first page, set only MaxResults to limit the number of entries to return. The NextToken value in the response serves as the token for querying subsequent pages. When paged query subsequent pages, set NextToken to the NextToken value obtained from the previous response and set MaxResults to limit the number of entries to return.
4502
4490
  * - Differences between `DescribeInvocations` and `DescribeInvocationResults`:
4503
- * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
4504
- * - `DescribeInvocations` provides the execution status on each instance as well as the aggregated status across all instances.
4505
- * - `DescribeInvocationResults` only provides the individual execution status per instance, without the aggregated multi-instance status.
4506
- * - When a single `RunCommand`/`InvokeCommand` call specifies only one instance:
4507
- * - There is little difference between `DescribeInvocations` and `DescribeInvocationResults`, and they can be used interchangeably.
4508
- * - When you need to view the execution history of scheduled (periodic) tasks or tasks that automatically run at system startup (`RepeatMode=Period, EveryReboot`), only `DescribeInvocationResults` can retrieve historical execution records (by specifying `IncludeHistory=true`). In contrast, `DescribeInvocations` only returns the latest task status.
4509
- * - When you need to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
4491
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
4492
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
4493
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status.
4494
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
4495
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
4496
+ * - To view the execution details of each run for scheduled (periodic) or boot-triggered tasks (`RepeatMode=Period, EveryReboot`), only `DescribeInvocationResults` can return historical execution records (with `IncludeHistory=true` specified). `DescribeInvocations` returns only the latest task status.
4497
+ * - To view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
4510
4498
  *
4511
4499
  * @param request - DescribeInvocationsRequest
4512
4500
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4514,21 +4502,21 @@ export default class Client extends OpenApi {
4514
4502
  */
4515
4503
  describeInvocationsWithOptions(request: $_model.DescribeInvocationsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeInvocationsResponse>;
4516
4504
  /**
4517
- * Invoke the DescribeInvocations API to query the execution list and status of Cloud Assistant commands.
4505
+ * Queries the execution list and status of Cloud Assistant commands.
4518
4506
  *
4519
4507
  * @remarks
4520
- * - After you execute a command, it does not necessarily mean that the command has run successfully or produced the expected effect. You must check the actual execution result through the API return value, and the actual output result takes precedence.
4521
- * - You can query execution information from the past four weeks, with a maximum retention limit of 100,000 records.
4522
- * - You can subscribe to [Cloud Assistant task status event notifications](https://help.aliyun.com/document_detail/2669130.html) to obtain task results via events, avoiding frequent polling and thereby improving efficiency.
4523
- * - When performing a paged query on the home page, you only need to set `MaxResults` to limit the number of returned entries. The `NextToken` in the return result serves as the credential for querying subsequent pages. When querying subsequent pages, set the `NextToken` parameter to the `NextToken` obtained from the previous response as the query credential, and also set `MaxResults` to limit the number of returned entries.
4508
+ * - After you run a command, the command does not necessarily run successfully or produce the expected results. You must check the actual execution results based on the return values of this operation. The actual output takes precedence.
4509
+ * - You can query execution information from the last 30 days. A maximum of 10,000 execution records are retained.
4510
+ * - You can subscribe to [Cloud Assistant task status events](https://help.aliyun.com/document_detail/2669130.html) to obtain task results through events, which avoids frequent polling and improves efficiency.
4511
+ * - When paged query the first page, set only MaxResults to limit the number of entries to return. The NextToken value in the response serves as the token for querying subsequent pages. When paged query subsequent pages, set NextToken to the NextToken value obtained from the previous response and set MaxResults to limit the number of entries to return.
4524
4512
  * - Differences between `DescribeInvocations` and `DescribeInvocationResults`:
4525
- * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
4526
- * - `DescribeInvocations` provides the execution status on each instance as well as the aggregated status across all instances.
4527
- * - `DescribeInvocationResults` only provides the individual execution status per instance, without the aggregated multi-instance status.
4528
- * - When a single `RunCommand`/`InvokeCommand` call specifies only one instance:
4529
- * - There is little difference between `DescribeInvocations` and `DescribeInvocationResults`, and they can be used interchangeably.
4530
- * - When you need to view the execution history of scheduled (periodic) tasks or tasks that automatically run at system startup (`RepeatMode=Period, EveryReboot`), only `DescribeInvocationResults` can retrieve historical execution records (by specifying `IncludeHistory=true`). In contrast, `DescribeInvocations` only returns the latest task status.
4531
- * - When you need to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
4513
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
4514
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
4515
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status.
4516
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
4517
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
4518
+ * - To view the execution details of each run for scheduled (periodic) or boot-triggered tasks (`RepeatMode=Period, EveryReboot`), only `DescribeInvocationResults` can return historical execution records (with `IncludeHistory=true` specified). `DescribeInvocations` returns only the latest task status.
4519
+ * - To view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
4532
4520
  *
4533
4521
  * @param request - DescribeInvocationsRequest
4534
4522
  * @returns DescribeInvocationsResponse
@@ -4550,7 +4538,7 @@ export default class Client extends OpenApi {
4550
4538
  */
4551
4539
  describeKeyPairs(request: $_model.DescribeKeyPairsRequest): Promise<$_model.DescribeKeyPairsResponse>;
4552
4540
  /**
4553
- * Query information about ECS instance launch template versions, such as the total number of launch templates, template name, and template version number.
4541
+ * Queries information about launch template versions of ECS instances, such as the total number of launch templates, template names, and template version numbers.
4554
4542
  *
4555
4543
  * @param request - DescribeLaunchTemplateVersionsRequest
4556
4544
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4558,7 +4546,7 @@ export default class Client extends OpenApi {
4558
4546
  */
4559
4547
  describeLaunchTemplateVersionsWithOptions(request: $_model.DescribeLaunchTemplateVersionsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeLaunchTemplateVersionsResponse>;
4560
4548
  /**
4561
- * Query information about ECS instance launch template versions, such as the total number of launch templates, template name, and template version number.
4549
+ * Queries information about launch template versions of ECS instances, such as the total number of launch templates, template names, and template version numbers.
4562
4550
  *
4563
4551
  * @param request - DescribeLaunchTemplateVersionsRequest
4564
4552
  * @returns DescribeLaunchTemplateVersionsResponse
@@ -4870,17 +4858,18 @@ export default class Client extends OpenApi {
4870
4858
  */
4871
4859
  describePrefixLists(request: $_model.DescribePrefixListsRequest): Promise<$_model.DescribePrefixListsResponse>;
4872
4860
  /**
4873
- * Use this operation to query the latest prices for specified resources by resource type, such as ECS instances, cloud disks, dedicated hosts, Elastic Assurance, and Capacity Reservation. The response includes promotional rules, prices, and discounts.
4861
+ * Queries the latest prices of specified resources. You can query the latest prices of ECS instances, disks, dedicated hosts, elasticity assurance services, and capacity reservation services based on resource type. The response includes promotion rules, prices, and discounts.
4874
4862
  *
4875
4863
  * @remarks
4876
- * Parameter settings vary depending on the resource type you are querying:
4877
- * - If you set `ResourceType` to `instance`, you must also specify `InstanceType`. By default, this operation returns prices for the pay-as-you-go billing method (`PostPaid`). You can specify the `PriceUnit` parameter to query prices for different ECS billing cycles.
4878
- * - If you set `ResourceType` to `disk`, you must also specify `DataDisk.1.Category` and `DataDisk.1.Size`. When you query prices for `disk` resources, this operation returns only pay-as-you-go prices, so the `PriceUnit` parameter must be set to `Hour`.
4879
- * - If you set `ResourceType` to `diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
4880
- * - If you set `ResourceType` to `ddh`, you must also specify `DedicatedHostType`.
4881
- * - If you set `ResourceType` to `ElasticityAssurance`, you must also specify `InstanceType`.
4882
- * - If you set `ResourceType` to `CapacityReservation`, you must also specify `InstanceType`.
4883
- * - If you set `ResourceType` to `bandwidth`, this operation returns only pay-by-traffic (`PayByTraffic`) prices.
4864
+ * The parameter settings vary based on the resource type:
4865
+ * - When `ResourceType=instance`, you must also specify `InstanceType`.
4866
+ * By default, the price of the pay-as-you-go (`PostPaid`) billing method (`ChargeType`) is queried. You can specify the `PriceUnit` parameter to query Elastic Compute Service (ECS) prices for different billing cycles.
4867
+ * - When `ResourceType=disk`, you must also specify `DataDisk.1.Category` and `DataDisk.1.Size`. When you query the price of `disk` resources, only the pay-as-you-go price of disks is returned. This means that the `PriceUnit` parameter can only be set to `Hour`.
4868
+ * - When `ResourceType=diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
4869
+ * - When `ResourceType=ddh`, you must also specify `DedicatedHostType`.
4870
+ * - When `ResourceType=ElasticityAssurance`, you must also specify `InstanceType`.
4871
+ * - When `ResourceType=CapacityReservation`, you must also specify `InstanceType`.
4872
+ * - When `ResourceType=bandwidth`, only the pay-by-traffic (`PayByTraffic`) price is returned.
4884
4873
  *
4885
4874
  * @param request - DescribePriceRequest
4886
4875
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4888,24 +4877,25 @@ export default class Client extends OpenApi {
4888
4877
  */
4889
4878
  describePriceWithOptions(request: $_model.DescribePriceRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribePriceResponse>;
4890
4879
  /**
4891
- * Use this operation to query the latest prices for specified resources by resource type, such as ECS instances, cloud disks, dedicated hosts, Elastic Assurance, and Capacity Reservation. The response includes promotional rules, prices, and discounts.
4880
+ * Queries the latest prices of specified resources. You can query the latest prices of ECS instances, disks, dedicated hosts, elasticity assurance services, and capacity reservation services based on resource type. The response includes promotion rules, prices, and discounts.
4892
4881
  *
4893
4882
  * @remarks
4894
- * Parameter settings vary depending on the resource type you are querying:
4895
- * - If you set `ResourceType` to `instance`, you must also specify `InstanceType`. By default, this operation returns prices for the pay-as-you-go billing method (`PostPaid`). You can specify the `PriceUnit` parameter to query prices for different ECS billing cycles.
4896
- * - If you set `ResourceType` to `disk`, you must also specify `DataDisk.1.Category` and `DataDisk.1.Size`. When you query prices for `disk` resources, this operation returns only pay-as-you-go prices, so the `PriceUnit` parameter must be set to `Hour`.
4897
- * - If you set `ResourceType` to `diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
4898
- * - If you set `ResourceType` to `ddh`, you must also specify `DedicatedHostType`.
4899
- * - If you set `ResourceType` to `ElasticityAssurance`, you must also specify `InstanceType`.
4900
- * - If you set `ResourceType` to `CapacityReservation`, you must also specify `InstanceType`.
4901
- * - If you set `ResourceType` to `bandwidth`, this operation returns only pay-by-traffic (`PayByTraffic`) prices.
4883
+ * The parameter settings vary based on the resource type:
4884
+ * - When `ResourceType=instance`, you must also specify `InstanceType`.
4885
+ * By default, the price of the pay-as-you-go (`PostPaid`) billing method (`ChargeType`) is queried. You can specify the `PriceUnit` parameter to query Elastic Compute Service (ECS) prices for different billing cycles.
4886
+ * - When `ResourceType=disk`, you must also specify `DataDisk.1.Category` and `DataDisk.1.Size`. When you query the price of `disk` resources, only the pay-as-you-go price of disks is returned. This means that the `PriceUnit` parameter can only be set to `Hour`.
4887
+ * - When `ResourceType=diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
4888
+ * - When `ResourceType=ddh`, you must also specify `DedicatedHostType`.
4889
+ * - When `ResourceType=ElasticityAssurance`, you must also specify `InstanceType`.
4890
+ * - When `ResourceType=CapacityReservation`, you must also specify `InstanceType`.
4891
+ * - When `ResourceType=bandwidth`, only the pay-by-traffic (`PayByTraffic`) price is returned.
4902
4892
  *
4903
4893
  * @param request - DescribePriceRequest
4904
4894
  * @returns DescribePriceResponse
4905
4895
  */
4906
4896
  describePrice(request: $_model.DescribePriceRequest): Promise<$_model.DescribePriceResponse>;
4907
4897
  /**
4908
- * Queries alternative instance types of an instance type. This operation is in internal preview. This operation lists all alternative instance types of an instance type that has been or is planed to be retired.
4898
+ * (Beta)调用 DescribeRecommendInstanceType 根据一个指定的实例规格,查找一个或多个备选的实例规格。针对已经或者即将停售的实例规格,DescribeRecommendInstanceType会罗列出作为替补的所有实例规格。
4909
4899
  *
4910
4900
  * @param request - DescribeRecommendInstanceTypeRequest
4911
4901
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4913,7 +4903,7 @@ export default class Client extends OpenApi {
4913
4903
  */
4914
4904
  describeRecommendInstanceTypeWithOptions(request: $_model.DescribeRecommendInstanceTypeRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeRecommendInstanceTypeResponse>;
4915
4905
  /**
4916
- * Queries alternative instance types of an instance type. This operation is in internal preview. This operation lists all alternative instance types of an instance type that has been or is planed to be retired.
4906
+ * (Beta)调用 DescribeRecommendInstanceType 根据一个指定的实例规格,查找一个或多个备选的实例规格。针对已经或者即将停售的实例规格,DescribeRecommendInstanceType会罗列出作为替补的所有实例规格。
4917
4907
  *
4918
4908
  * @param request - DescribeRecommendInstanceTypeRequest
4919
4909
  * @returns DescribeRecommendInstanceTypeResponse
@@ -5059,42 +5049,42 @@ export default class Client extends OpenApi {
5059
5049
  */
5060
5050
  describeResourceByTags(request: $_model.DescribeResourceByTagsRequest): Promise<$_model.DescribeResourceByTagsResponse>;
5061
5051
  /**
5062
- * Queries available instance types or system disk categories in a specific zone before you change the instance type or system disk category of an Elastic Compute Service (ECS) instance.
5052
+ * Queries the inventory of instance types or system disk types in a zone before you change the instance type or system disk type of an instance.
5063
5053
  *
5064
5054
  * @remarks
5065
- * Examples of common scenarios in which this operation is used:
5066
- * ### [](#-1)Example 1: Query the instance types to which you can change the instance type of an instance.
5067
- * Query the instance types to which you can change the instance type of the i-bp67acfmxazb4p\\*\\*\\*\\* instance and the inventory of the queried instance types in the zone in which the instance resides.
5055
+ * The following examples describe common change scenarios:
5056
+ * ### Example 1: Query instance types to which the current instance can be changed
5057
+ * Query the instance types to which instance i-bp67acfmxazb4p**** can be changed, and the inventory of the corresponding instance types in the zone where the instance resides.
5068
5058
  * ```
5069
5059
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
5070
- * &RegionId=cn-hangzhou
5060
+ * &RegionId=ap-southeast-1
5071
5061
  * &ResourceId=i-bp67acfmxazb4p****
5072
5062
  * &DestinationResource=InstanceType
5073
5063
  * &OperationType=Upgrade
5074
- * &<Common request parameters>
5064
+ * &Common request parameters
5075
5065
  * ```
5076
- * ### [](#-2)Example 2: Query the instance types to which you can change the instance type of an instance after a system disk category change.
5077
- * Query the instance types to which you can change the instance type of the i-bp67acfmxazb4p\\*\\*\\*\\* instance after a system disk category change and the inventory of the queried instance types in the zone in which the instance resides.
5066
+ * ### Example 2: Query instance types available after changing the disk type of the current instance
5067
+ * Query the instance types to which instance i-bp67acfmxazb4p**** can be changed after the disk type is changed, and the inventory of the corresponding instance types in the zone where the instance resides.
5078
5068
  * ```
5079
5069
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
5080
- * &RegionId=cn-hangzhou
5070
+ * &RegionId=ap-southeast-1
5081
5071
  * &ResourceId=i-bp67acfmxazb4p****
5082
5072
  * &DestinationResource=InstanceType
5083
5073
  * &OperationType=Upgrade
5084
5074
  * &Conditions.0=DiskCategory
5085
- * &<Common request parameters>
5075
+ * &Common request parameters
5086
5076
  * ```
5087
- * ### [](#-3)Example 3: Query the system disk categories supported by the instance type to which you want to change the instance type of an instance.
5088
- * Query the system disk categories supported by the instance type to which you want to change the instance type of the i-bp67acfmxazb4p\\*\\*\\*\\* instance and the inventory of the disk categories in the zone in which the instance resides. In this example, the ecs.g7.large instance type is used. To change to the instance type, you must change the system disk category of the instance to a category supported by the instance type.
5089
- * > You can call this operation as described in Example 2 to query the instance types to which you can change the instance type of an instance.
5077
+ * ### Example 3: Query the disk type required by the target instance type
5078
+ * Query the disk type required by the target instance type (for example, ecs.g7.large). The current instance i-bp67acfmxazb4p**** must be changed to this disk type before it can be changed to the target instance type. Also query the inventory of the disk type in the zone where the instance resides.
5079
+ * > The target instance type must be obtained by using Example 2.
5090
5080
  * ```
5091
5081
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
5092
- * &RegionId=cn-hangzhou
5082
+ * &RegionId=ap-southeast-1
5093
5083
  * &ResourceId=i-bp67acfmxazb4p****
5094
5084
  * &DestinationResource=SystemDisk
5095
5085
  * &OperationType=Upgrade
5096
5086
  * &InstanceType=ecs.g7.large
5097
- * &<Common request parameters>
5087
+ * &Common request parameters
5098
5088
  * ```
5099
5089
  *
5100
5090
  * @param request - DescribeResourcesModificationRequest
@@ -5103,42 +5093,42 @@ export default class Client extends OpenApi {
5103
5093
  */
5104
5094
  describeResourcesModificationWithOptions(request: $_model.DescribeResourcesModificationRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeResourcesModificationResponse>;
5105
5095
  /**
5106
- * Queries available instance types or system disk categories in a specific zone before you change the instance type or system disk category of an Elastic Compute Service (ECS) instance.
5096
+ * Queries the inventory of instance types or system disk types in a zone before you change the instance type or system disk type of an instance.
5107
5097
  *
5108
5098
  * @remarks
5109
- * Examples of common scenarios in which this operation is used:
5110
- * ### [](#-1)Example 1: Query the instance types to which you can change the instance type of an instance.
5111
- * Query the instance types to which you can change the instance type of the i-bp67acfmxazb4p\\*\\*\\*\\* instance and the inventory of the queried instance types in the zone in which the instance resides.
5099
+ * The following examples describe common change scenarios:
5100
+ * ### Example 1: Query instance types to which the current instance can be changed
5101
+ * Query the instance types to which instance i-bp67acfmxazb4p**** can be changed, and the inventory of the corresponding instance types in the zone where the instance resides.
5112
5102
  * ```
5113
5103
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
5114
- * &RegionId=cn-hangzhou
5104
+ * &RegionId=ap-southeast-1
5115
5105
  * &ResourceId=i-bp67acfmxazb4p****
5116
5106
  * &DestinationResource=InstanceType
5117
5107
  * &OperationType=Upgrade
5118
- * &<Common request parameters>
5108
+ * &Common request parameters
5119
5109
  * ```
5120
- * ### [](#-2)Example 2: Query the instance types to which you can change the instance type of an instance after a system disk category change.
5121
- * Query the instance types to which you can change the instance type of the i-bp67acfmxazb4p\\*\\*\\*\\* instance after a system disk category change and the inventory of the queried instance types in the zone in which the instance resides.
5110
+ * ### Example 2: Query instance types available after changing the disk type of the current instance
5111
+ * Query the instance types to which instance i-bp67acfmxazb4p**** can be changed after the disk type is changed, and the inventory of the corresponding instance types in the zone where the instance resides.
5122
5112
  * ```
5123
5113
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
5124
- * &RegionId=cn-hangzhou
5114
+ * &RegionId=ap-southeast-1
5125
5115
  * &ResourceId=i-bp67acfmxazb4p****
5126
5116
  * &DestinationResource=InstanceType
5127
5117
  * &OperationType=Upgrade
5128
5118
  * &Conditions.0=DiskCategory
5129
- * &<Common request parameters>
5119
+ * &Common request parameters
5130
5120
  * ```
5131
- * ### [](#-3)Example 3: Query the system disk categories supported by the instance type to which you want to change the instance type of an instance.
5132
- * Query the system disk categories supported by the instance type to which you want to change the instance type of the i-bp67acfmxazb4p\\*\\*\\*\\* instance and the inventory of the disk categories in the zone in which the instance resides. In this example, the ecs.g7.large instance type is used. To change to the instance type, you must change the system disk category of the instance to a category supported by the instance type.
5133
- * > You can call this operation as described in Example 2 to query the instance types to which you can change the instance type of an instance.
5121
+ * ### Example 3: Query the disk type required by the target instance type
5122
+ * Query the disk type required by the target instance type (for example, ecs.g7.large). The current instance i-bp67acfmxazb4p**** must be changed to this disk type before it can be changed to the target instance type. Also query the inventory of the disk type in the zone where the instance resides.
5123
+ * > The target instance type must be obtained by using Example 2.
5134
5124
  * ```
5135
5125
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
5136
- * &RegionId=cn-hangzhou
5126
+ * &RegionId=ap-southeast-1
5137
5127
  * &ResourceId=i-bp67acfmxazb4p****
5138
5128
  * &DestinationResource=SystemDisk
5139
5129
  * &OperationType=Upgrade
5140
5130
  * &InstanceType=ecs.g7.large
5141
- * &<Common request parameters>
5131
+ * &Common request parameters
5142
5132
  * ```
5143
5133
  *
5144
5134
  * @param request - DescribeResourcesModificationRequest
@@ -5214,7 +5204,7 @@ export default class Client extends OpenApi {
5214
5204
  */
5215
5205
  describeSavingsPlanPrice(request: $_model.DescribeSavingsPlanPriceRequest): Promise<$_model.DescribeSavingsPlanPriceResponse>;
5216
5206
  /**
5217
- * Queries the details of a specified security group and the security group rules of the security group.
5207
+ * Queries the details of a specified security group, including the list of security group rules.
5218
5208
  *
5219
5209
  * @param request - DescribeSecurityGroupAttributeRequest
5220
5210
  * @param runtime - runtime options for this request RuntimeOptions
@@ -5222,7 +5212,7 @@ export default class Client extends OpenApi {
5222
5212
  */
5223
5213
  describeSecurityGroupAttributeWithOptions(request: $_model.DescribeSecurityGroupAttributeRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeSecurityGroupAttributeResponse>;
5224
5214
  /**
5225
- * Queries the details of a specified security group and the security group rules of the security group.
5215
+ * Queries the details of a specified security group, including the list of security group rules.
5226
5216
  *
5227
5217
  * @param request - DescribeSecurityGroupAttributeRequest
5228
5218
  * @returns DescribeSecurityGroupAttributeResponse
@@ -5250,14 +5240,14 @@ export default class Client extends OpenApi {
5250
5240
  */
5251
5241
  describeSecurityGroupReferences(request: $_model.DescribeSecurityGroupReferencesRequest): Promise<$_model.DescribeSecurityGroupReferencesResponse>;
5252
5242
  /**
5253
- * This API operation is used to query a list of basic information about security groups. You can query by different parameters such as region, security group ID, and security group type.
5243
+ * Queries the basic information about security groups. You can filter results by region, security group ID, security group type, and other parameters through parameter query.
5254
5244
  *
5255
5245
  * @remarks
5256
- * - **Paged queries**: We recommend that you use the `MaxResults` and `NextToken` parameters for queries.
5257
- * - When the response does not contain `NextToken`, the current page is the last page and no more pages are available.
5258
- * - When querying the first page, you only need to set `MaxResults` to limit the number of entries returned. The `NextToken` in the response is used as the token for querying subsequent pages.
5259
- * - When querying subsequent pages, set the `NextToken` parameter to the `NextToken` value obtained from the previous response as the query token, and set `MaxResults` to limit the number of entries returned.
5260
- * - When calling the API through Alibaba Cloud CLI, the values of request parameters of different data types must follow certain format requirements. For more information, see [CLI parameter format description](https://help.aliyun.com/document_detail/110340.html).
5246
+ * - **Paging query**: Use `MaxResults` and `NextToken` for paging query.
5247
+ * - If `NextToken` is not returned, the current page is the last page.
5248
+ * - For the first page, set only `MaxResults` to limit the number of entries to return. The `NextToken` value in the response is used to query subsequent pages.
5249
+ * - For subsequent pages, set `NextToken` to the `NextToken` value returned in the previous response and set `MaxResults` to limit the number of entries to return.
5250
+ * - When you invoke an API operation by using Cloud Assistant CLI, specify request parameters in the required format. For more information, see [Parameter format of CLI commands](https://help.aliyun.com/document_detail/110340.html).
5261
5251
  *
5262
5252
  * @param request - DescribeSecurityGroupsRequest
5263
5253
  * @param runtime - runtime options for this request RuntimeOptions
@@ -5265,27 +5255,27 @@ export default class Client extends OpenApi {
5265
5255
  */
5266
5256
  describeSecurityGroupsWithOptions(request: $_model.DescribeSecurityGroupsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeSecurityGroupsResponse>;
5267
5257
  /**
5268
- * This API operation is used to query a list of basic information about security groups. You can query by different parameters such as region, security group ID, and security group type.
5258
+ * Queries the basic information about security groups. You can filter results by region, security group ID, security group type, and other parameters through parameter query.
5269
5259
  *
5270
5260
  * @remarks
5271
- * - **Paged queries**: We recommend that you use the `MaxResults` and `NextToken` parameters for queries.
5272
- * - When the response does not contain `NextToken`, the current page is the last page and no more pages are available.
5273
- * - When querying the first page, you only need to set `MaxResults` to limit the number of entries returned. The `NextToken` in the response is used as the token for querying subsequent pages.
5274
- * - When querying subsequent pages, set the `NextToken` parameter to the `NextToken` value obtained from the previous response as the query token, and set `MaxResults` to limit the number of entries returned.
5275
- * - When calling the API through Alibaba Cloud CLI, the values of request parameters of different data types must follow certain format requirements. For more information, see [CLI parameter format description](https://help.aliyun.com/document_detail/110340.html).
5261
+ * - **Paging query**: Use `MaxResults` and `NextToken` for paging query.
5262
+ * - If `NextToken` is not returned, the current page is the last page.
5263
+ * - For the first page, set only `MaxResults` to limit the number of entries to return. The `NextToken` value in the response is used to query subsequent pages.
5264
+ * - For subsequent pages, set `NextToken` to the `NextToken` value returned in the previous response and set `MaxResults` to limit the number of entries to return.
5265
+ * - When you invoke an API operation by using Cloud Assistant CLI, specify request parameters in the required format. For more information, see [Parameter format of CLI commands](https://help.aliyun.com/document_detail/110340.html).
5276
5266
  *
5277
5267
  * @param request - DescribeSecurityGroupsRequest
5278
5268
  * @returns DescribeSecurityGroupsResponse
5279
5269
  */
5280
5270
  describeSecurityGroups(request: $_model.DescribeSecurityGroupsRequest): Promise<$_model.DescribeSecurityGroupsResponse>;
5281
5271
  /**
5282
- * Queries the files sent by Cloud Assistant and their status.
5272
+ * Queries the list and status of files sent by Cloud Assistant by calling DescribeSendFileResults.
5283
5273
  *
5284
5274
  * @remarks
5285
- * ## [](#)Usage notes
5286
- * - When you send a file, the file may fail to be sent to specific Elastic Compute Service (ECS) instances. You can call this operation to check the file sending results.
5287
- * - You can call this operation to query the file sending records within the last six weeks.
5288
- * - During a paged query, when you call the DescribeSendFileResults operation to retrieve the first page of results, set `MaxResults` to specify the maximum number of entries to return in the call. The return value of `NextToken` is a pagination token that can be used in the next call to retrieve a new page of results. When you call the DescribeSendFileResults operation to retrieve a new page of results, set `NextToken` to the `NextToken` value returned in the previous call and set `MaxResults` to specify the maximum number of entries to return in this call.
5275
+ * ## Operation description:
5276
+ * - After you send a file, the file is not necessarily sent. You must check the actual sending result based on the return value of this operation.
5277
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
5278
+ * - When paged query the first page, set only MaxResults to limit the number of entries to return. The NextToken value returned in the result serves as the token for querying subsequent pages. When paged query subsequent pages, set NextToken to the value obtained from the previous response and set MaxResults to limit the number of entries to return.
5289
5279
  *
5290
5280
  * @param request - DescribeSendFileResultsRequest
5291
5281
  * @param runtime - runtime options for this request RuntimeOptions
@@ -5293,13 +5283,13 @@ export default class Client extends OpenApi {
5293
5283
  */
5294
5284
  describeSendFileResultsWithOptions(request: $_model.DescribeSendFileResultsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeSendFileResultsResponse>;
5295
5285
  /**
5296
- * Queries the files sent by Cloud Assistant and their status.
5286
+ * Queries the list and status of files sent by Cloud Assistant by calling DescribeSendFileResults.
5297
5287
  *
5298
5288
  * @remarks
5299
- * ## [](#)Usage notes
5300
- * - When you send a file, the file may fail to be sent to specific Elastic Compute Service (ECS) instances. You can call this operation to check the file sending results.
5301
- * - You can call this operation to query the file sending records within the last six weeks.
5302
- * - During a paged query, when you call the DescribeSendFileResults operation to retrieve the first page of results, set `MaxResults` to specify the maximum number of entries to return in the call. The return value of `NextToken` is a pagination token that can be used in the next call to retrieve a new page of results. When you call the DescribeSendFileResults operation to retrieve a new page of results, set `NextToken` to the `NextToken` value returned in the previous call and set `MaxResults` to specify the maximum number of entries to return in this call.
5289
+ * ## Operation description:
5290
+ * - After you send a file, the file is not necessarily sent. You must check the actual sending result based on the return value of this operation.
5291
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
5292
+ * - When paged query the first page, set only MaxResults to limit the number of entries to return. The NextToken value returned in the result serves as the token for querying subsequent pages. When paged query subsequent pages, set NextToken to the value obtained from the previous response and set MaxResults to limit the number of entries to return.
5303
5293
  *
5304
5294
  * @param request - DescribeSendFileResultsRequest
5305
5295
  * @returns DescribeSendFileResultsResponse
@@ -5396,47 +5386,39 @@ export default class Client extends OpenApi {
5396
5386
  */
5397
5387
  describeSnapshotPackage(request: $_model.DescribeSnapshotPackageRequest): Promise<$_model.DescribeSnapshotPackageResponse>;
5398
5388
  /**
5399
- * Queries details about a cloud disk\\"s snapshots, including their status, the time remaining until completion, and the retention days for automatic snapshots.
5389
+ * Queries the snapshot list of a disk, including snapshot status, remaining time for a snapshot being created, and automatic snapshot retention days.
5400
5390
  *
5401
5391
  * @remarks
5402
- * The `InstanceId`, `DiskId`, and `SnapshotIds` request parameters are optional and can be used to create a filter. The parameters are combined with a logical AND.
5403
- * When you call an API using Alibaba Cloud CLI, the values for request parameters of different data types must be in specific formats. For more information, see [CLI parameter format description](https://help.aliyun.com/document_detail/110340.html).
5392
+ * InstanceId, DiskId, and SnapshotIds are not required request parameters, but you can use them to build filter logic. These parameters are evaluated by using a logical AND.
5393
+ * When you invoke an API operation by using Cloud Assistant CLI, specify request parameter values in the required formats based on their data types. For details, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
5404
5394
  * Request examples:
5405
5395
  * <details>
5406
- * <summary>
5407
- * Query the snapshots of all cloud disks attached to an ECS instance in the China (Hangzhou) region
5408
- * </summary>
5396
+ * <summary>Query the snapshot list of all disks attached to an ECS instance in the China (Hangzhou) region</summary>
5409
5397
  * ```
5410
- * RegionId: cn-hangzhou, // The ID of the region.
5411
- * InstanceId: i-bp1fh7by6d9mw7zr**** // The ID of the instance to query.
5398
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
5399
+ * InstanceId: i-bp1fh7by6d9mw7zr**** // Set the instance ID to query.
5412
5400
  * ```
5413
5401
  * </details>
5414
5402
  * <details>
5415
- * <summary>
5416
- * Query the snapshots of a cloud disk in the China (Hangzhou) region
5417
- * </summary>
5403
+ * <summary>Query the snapshot information of a specific disk in the China (Hangzhou) region</summary>
5418
5404
  * ```
5419
- * RegionId: cn-hangzhou, // The ID of the region.
5420
- * DiskId: d-bp10e7ej8z743dmu**** // The ID of the cloud disk to query.
5405
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
5406
+ * DiskId: d-bp10e7ej8z743dmu**** // Set the disk ID to query.
5421
5407
  * ```
5422
5408
  * </details>
5423
5409
  * <details>
5424
- * <summary>
5425
- * Query two snapshots in the China (Hangzhou) region by snapshot ID
5426
- * </summary>
5410
+ * <summary>Query the information of two snapshots in the China (Hangzhou) region by snapshot ID</summary>
5427
5411
  * ```
5428
- * RegionId: cn-hangzhou, // The ID of the region.
5429
- * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // The snapshot IDs to query.
5412
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
5413
+ * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // Set the array of snapshot IDs to query.
5430
5414
  * ```
5431
5415
  * </details>
5432
5416
  * <details>
5433
- * <summary>
5434
- * Query snapshots created after a specific time in the China (Hangzhou) region
5435
- * </summary>
5417
+ * <summary>Query the snapshot information created after a specific point in time in the China (Hangzhou) region</summary>
5436
5418
  * ```
5437
- * RegionId: cn-hangzhou, // The ID of the region.
5438
- * Filter.1.Key: CreationStartTime, // Filters by the creation start time.
5439
- * Filter.1.Value: 2024-11-27T00:00Z
5419
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
5420
+ * Filter.1.Key: CreationStartTime, // Set the filter key for the creation start time.
5421
+ * Filter.1.Value: 2024-11-27T00:00Z.
5440
5422
  * ```
5441
5423
  * </details>
5442
5424
  *
@@ -5446,47 +5428,39 @@ export default class Client extends OpenApi {
5446
5428
  */
5447
5429
  describeSnapshotsWithOptions(request: $_model.DescribeSnapshotsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeSnapshotsResponse>;
5448
5430
  /**
5449
- * Queries details about a cloud disk\\"s snapshots, including their status, the time remaining until completion, and the retention days for automatic snapshots.
5431
+ * Queries the snapshot list of a disk, including snapshot status, remaining time for a snapshot being created, and automatic snapshot retention days.
5450
5432
  *
5451
5433
  * @remarks
5452
- * The `InstanceId`, `DiskId`, and `SnapshotIds` request parameters are optional and can be used to create a filter. The parameters are combined with a logical AND.
5453
- * When you call an API using Alibaba Cloud CLI, the values for request parameters of different data types must be in specific formats. For more information, see [CLI parameter format description](https://help.aliyun.com/document_detail/110340.html).
5434
+ * InstanceId, DiskId, and SnapshotIds are not required request parameters, but you can use them to build filter logic. These parameters are evaluated by using a logical AND.
5435
+ * When you invoke an API operation by using Cloud Assistant CLI, specify request parameter values in the required formats based on their data types. For details, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
5454
5436
  * Request examples:
5455
5437
  * <details>
5456
- * <summary>
5457
- * Query the snapshots of all cloud disks attached to an ECS instance in the China (Hangzhou) region
5458
- * </summary>
5438
+ * <summary>Query the snapshot list of all disks attached to an ECS instance in the China (Hangzhou) region</summary>
5459
5439
  * ```
5460
- * RegionId: cn-hangzhou, // The ID of the region.
5461
- * InstanceId: i-bp1fh7by6d9mw7zr**** // The ID of the instance to query.
5440
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
5441
+ * InstanceId: i-bp1fh7by6d9mw7zr**** // Set the instance ID to query.
5462
5442
  * ```
5463
5443
  * </details>
5464
5444
  * <details>
5465
- * <summary>
5466
- * Query the snapshots of a cloud disk in the China (Hangzhou) region
5467
- * </summary>
5445
+ * <summary>Query the snapshot information of a specific disk in the China (Hangzhou) region</summary>
5468
5446
  * ```
5469
- * RegionId: cn-hangzhou, // The ID of the region.
5470
- * DiskId: d-bp10e7ej8z743dmu**** // The ID of the cloud disk to query.
5447
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
5448
+ * DiskId: d-bp10e7ej8z743dmu**** // Set the disk ID to query.
5471
5449
  * ```
5472
5450
  * </details>
5473
5451
  * <details>
5474
- * <summary>
5475
- * Query two snapshots in the China (Hangzhou) region by snapshot ID
5476
- * </summary>
5452
+ * <summary>Query the information of two snapshots in the China (Hangzhou) region by snapshot ID</summary>
5477
5453
  * ```
5478
- * RegionId: cn-hangzhou, // The ID of the region.
5479
- * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // The snapshot IDs to query.
5454
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
5455
+ * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // Set the array of snapshot IDs to query.
5480
5456
  * ```
5481
5457
  * </details>
5482
5458
  * <details>
5483
- * <summary>
5484
- * Query snapshots created after a specific time in the China (Hangzhou) region
5485
- * </summary>
5459
+ * <summary>Query the snapshot information created after a specific point in time in the China (Hangzhou) region</summary>
5486
5460
  * ```
5487
- * RegionId: cn-hangzhou, // The ID of the region.
5488
- * Filter.1.Key: CreationStartTime, // Filters by the creation start time.
5489
- * Filter.1.Value: 2024-11-27T00:00Z
5461
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
5462
+ * Filter.1.Key: CreationStartTime, // Set the filter key for the creation start time.
5463
+ * Filter.1.Value: 2024-11-27T00:00Z.
5490
5464
  * ```
5491
5465
  * </details>
5492
5466
  *
@@ -5549,11 +5523,11 @@ export default class Client extends OpenApi {
5549
5523
  */
5550
5524
  describeSpotAdvice(request: $_model.DescribeSpotAdviceRequest): Promise<$_model.DescribeSpotAdviceResponse>;
5551
5525
  /**
5552
- * Queries the historical prices of spot instances within up to the previous 30 days. You can set the maximum price of a spot instance based on the historical prices.
5526
+ * Queries the historical prices of spot instances. You can query price data from the last 30 days. The historical price data helps you set a reasonable maximum price for a spot instance.
5553
5527
  *
5554
5528
  * @remarks
5555
- * - This operation is applicable only to I/O optimized spot instances.
5556
- * - The data returned by the interface may be paginated. If the returned data contains the `NextOffset` parameter, you can set the `Offset` parameter in the request to the value of the `NextOffset` parameter for subsequent data query.
5529
+ * - Only I/O optimized spot instances are supported.
5530
+ * - The data returned by this operation may be paginated. If the response contains the `NextOffset` parameter, set the `Offset` request parameter to the value of `NextOffset` to query the next page of data.
5557
5531
  *
5558
5532
  * @param request - DescribeSpotPriceHistoryRequest
5559
5533
  * @param runtime - runtime options for this request RuntimeOptions
@@ -5561,11 +5535,11 @@ export default class Client extends OpenApi {
5561
5535
  */
5562
5536
  describeSpotPriceHistoryWithOptions(request: $_model.DescribeSpotPriceHistoryRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeSpotPriceHistoryResponse>;
5563
5537
  /**
5564
- * Queries the historical prices of spot instances within up to the previous 30 days. You can set the maximum price of a spot instance based on the historical prices.
5538
+ * Queries the historical prices of spot instances. You can query price data from the last 30 days. The historical price data helps you set a reasonable maximum price for a spot instance.
5565
5539
  *
5566
5540
  * @remarks
5567
- * - This operation is applicable only to I/O optimized spot instances.
5568
- * - The data returned by the interface may be paginated. If the returned data contains the `NextOffset` parameter, you can set the `Offset` parameter in the request to the value of the `NextOffset` parameter for subsequent data query.
5541
+ * - Only I/O optimized spot instances are supported.
5542
+ * - The data returned by this operation may be paginated. If the response contains the `NextOffset` parameter, set the `Offset` request parameter to the value of `NextOffset` to query the next page of data.
5569
5543
  *
5570
5544
  * @param request - DescribeSpotPriceHistoryRequest
5571
5545
  * @returns DescribeSpotPriceHistoryResponse
@@ -5672,10 +5646,10 @@ export default class Client extends OpenApi {
5672
5646
  */
5673
5647
  describeTasks(request: $_model.DescribeTasksRequest): Promise<$_model.DescribeTasksResponse>;
5674
5648
  /**
5675
- * Queries the session records of Elastic Compute Service (ECS) Session Manager.
5649
+ * Queries the session history of Session Manager.
5676
5650
  *
5677
5651
  * @remarks
5678
- * You can query the session records of Session Manager that were generated in the last four weeks.
5652
+ * You can query Session Manager session records created within the last 30 days. A maximum of 1,000 successful records are retained.
5679
5653
  *
5680
5654
  * @param request - DescribeTerminalSessionsRequest
5681
5655
  * @param runtime - runtime options for this request RuntimeOptions
@@ -5683,10 +5657,10 @@ export default class Client extends OpenApi {
5683
5657
  */
5684
5658
  describeTerminalSessionsWithOptions(request: $_model.DescribeTerminalSessionsRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeTerminalSessionsResponse>;
5685
5659
  /**
5686
- * Queries the session records of Elastic Compute Service (ECS) Session Manager.
5660
+ * Queries the session history of Session Manager.
5687
5661
  *
5688
5662
  * @remarks
5689
- * You can query the session records of Session Manager that were generated in the last four weeks.
5663
+ * You can query Session Manager session records created within the last 30 days. A maximum of 1,000 successful records are retained.
5690
5664
  *
5691
5665
  * @param request - DescribeTerminalSessionsRequest
5692
5666
  * @returns DescribeTerminalSessionsResponse
@@ -5849,11 +5823,10 @@ export default class Client extends OpenApi {
5849
5823
  */
5850
5824
  describeVscs(request: $_model.DescribeVscsRequest): Promise<$_model.DescribeVscsResponse>;
5851
5825
  /**
5852
- * Queries Alibaba Cloud regions. You can specify parameters, such as InstanceChargeType and ResourceType, in the request.
5826
+ * Queries the list of active zones based on parameters such as region ID and billing method.
5853
5827
  *
5854
5828
  * @remarks
5855
- * ## [](#)Usage notes
5856
- * When you call this operation, only a list of zones and some resource information of each zone are returned. If you want to query instance types and disk categories that are available for purchase in a specific zone, we recommend that you call the [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) operation.
5829
+ * DescribeZones only queries the list of zones provided by Alibaba Cloud and returns limited inventory information. To query the instance types and disk categories available for purchase in a specific zone, use [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html).
5857
5830
  *
5858
5831
  * @param request - DescribeZonesRequest
5859
5832
  * @param runtime - runtime options for this request RuntimeOptions
@@ -5861,11 +5834,10 @@ export default class Client extends OpenApi {
5861
5834
  */
5862
5835
  describeZonesWithOptions(request: $_model.DescribeZonesRequest, runtime: $dara.RuntimeOptions): Promise<$_model.DescribeZonesResponse>;
5863
5836
  /**
5864
- * Queries Alibaba Cloud regions. You can specify parameters, such as InstanceChargeType and ResourceType, in the request.
5837
+ * Queries the list of active zones based on parameters such as region ID and billing method.
5865
5838
  *
5866
5839
  * @remarks
5867
- * ## [](#)Usage notes
5868
- * When you call this operation, only a list of zones and some resource information of each zone are returned. If you want to query instance types and disk categories that are available for purchase in a specific zone, we recommend that you call the [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) operation.
5840
+ * DescribeZones only queries the list of zones provided by Alibaba Cloud and returns limited inventory information. To query the instance types and disk categories available for purchase in a specific zone, use [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html).
5869
5841
  *
5870
5842
  * @param request - DescribeZonesRequest
5871
5843
  * @returns DescribeZonesResponse
@@ -6282,7 +6254,7 @@ export default class Client extends OpenApi {
6282
6254
  */
6283
6255
  exportSnapshot(request: $_model.ExportSnapshotRequest): Promise<$_model.ExportSnapshotResponse>;
6284
6256
  /**
6285
- * Retrieves the system command line output of an instance. The data is returned in Base64 encoding.
6257
+ * Retrieves the system command-line output of an instance. The data is returned in Base64-encoded format.
6286
6258
  *
6287
6259
  * @remarks
6288
6260
  * - Elastic Compute Service (ECS) is a virtualization-based cloud server that cannot be connected to display devices or manually screenshotted. However, Alibaba Cloud caches the system command line output from the last time an instance was started, restarted, or shut down. You can invoke GetInstanceConsoleOutput to retrieve this output.
@@ -6295,7 +6267,7 @@ export default class Client extends OpenApi {
6295
6267
  */
6296
6268
  getInstanceConsoleOutputWithOptions(request: $_model.GetInstanceConsoleOutputRequest, runtime: $dara.RuntimeOptions): Promise<$_model.GetInstanceConsoleOutputResponse>;
6297
6269
  /**
6298
- * Retrieves the system command line output of an instance. The data is returned in Base64 encoding.
6270
+ * Retrieves the system command-line output of an instance. The data is returned in Base64-encoded format.
6299
6271
  *
6300
6272
  * @remarks
6301
6273
  * - Elastic Compute Service (ECS) is a virtualization-based cloud server that cannot be connected to display devices or manually screenshotted. However, Alibaba Cloud caches the system command line output from the last time an instance was started, restarted, or shut down. You can invoke GetInstanceConsoleOutput to retrieve this output.
@@ -6307,13 +6279,13 @@ export default class Client extends OpenApi {
6307
6279
  */
6308
6280
  getInstanceConsoleOutput(request: $_model.GetInstanceConsoleOutputRequest): Promise<$_model.GetInstanceConsoleOutputResponse>;
6309
6281
  /**
6310
- * Calls GetInstanceScreenshot to obtain the screenshot information of an instance.
6282
+ * Calls GetInstanceScreenshot to retrieve the screenshot information of an instance.
6311
6283
  *
6312
6284
  * @remarks
6313
- * After Elastic Compute Service (ECS) returns the instance screenshot as a Base64-encoded JPG image, you must decode it yourself. You can call this operation when troubleshooting faults. Note the following items:
6285
+ * After Elastic Compute Service (ECS) returns the instance screenshot in Base64-encoded JPG image format, you must decode it yourself. You can call this operation when troubleshooting faults. Note the following items:
6314
6286
  * - The instance must be in the Running state.
6315
- * - You cannot obtain screenshot information for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
6316
- * - If you call this operation multiple times on the same instance, the interval between calls must be at least 10 seconds. Otherwise, the `Throttling` error code is returned.
6287
+ * - Screenshots cannot be retrieved for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
6288
+ * - If you call this operation multiple times on the same instance, the interval between calls must be at least 10 seconds. Otherwise, the Throttling error code is returned.
6317
6289
  *
6318
6290
  * @param request - GetInstanceScreenshotRequest
6319
6291
  * @param runtime - runtime options for this request RuntimeOptions
@@ -6321,13 +6293,13 @@ export default class Client extends OpenApi {
6321
6293
  */
6322
6294
  getInstanceScreenshotWithOptions(request: $_model.GetInstanceScreenshotRequest, runtime: $dara.RuntimeOptions): Promise<$_model.GetInstanceScreenshotResponse>;
6323
6295
  /**
6324
- * Calls GetInstanceScreenshot to obtain the screenshot information of an instance.
6296
+ * Calls GetInstanceScreenshot to retrieve the screenshot information of an instance.
6325
6297
  *
6326
6298
  * @remarks
6327
- * After Elastic Compute Service (ECS) returns the instance screenshot as a Base64-encoded JPG image, you must decode it yourself. You can call this operation when troubleshooting faults. Note the following items:
6299
+ * After Elastic Compute Service (ECS) returns the instance screenshot in Base64-encoded JPG image format, you must decode it yourself. You can call this operation when troubleshooting faults. Note the following items:
6328
6300
  * - The instance must be in the Running state.
6329
- * - You cannot obtain screenshot information for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
6330
- * - If you call this operation multiple times on the same instance, the interval between calls must be at least 10 seconds. Otherwise, the `Throttling` error code is returned.
6301
+ * - Screenshots cannot be retrieved for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
6302
+ * - If you call this operation multiple times on the same instance, the interval between calls must be at least 10 seconds. Otherwise, the Throttling error code is returned.
6331
6303
  *
6332
6304
  * @param request - GetInstanceScreenshotRequest
6333
6305
  * @returns GetInstanceScreenshotResponse
@@ -7359,7 +7331,7 @@ export default class Client extends OpenApi {
7359
7331
  */
7360
7332
  modifyHaVipAttribute(request: $_model.ModifyHaVipAttributeRequest): Promise<$_model.ModifyHaVipAttributeResponse>;
7361
7333
  /**
7362
- * Modifies the description of an HPC cluster by calling ModifyHpcClusterAttribute.
7334
+ * Modifies the description of an HPC cluster.
7363
7335
  *
7364
7336
  * @param request - ModifyHpcClusterAttributeRequest
7365
7337
  * @param runtime - runtime options for this request RuntimeOptions
@@ -7367,7 +7339,7 @@ export default class Client extends OpenApi {
7367
7339
  */
7368
7340
  modifyHpcClusterAttributeWithOptions(request: $_model.ModifyHpcClusterAttributeRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ModifyHpcClusterAttributeResponse>;
7369
7341
  /**
7370
- * Modifies the description of an HPC cluster by calling ModifyHpcClusterAttribute.
7342
+ * Modifies the description of an HPC cluster.
7371
7343
  *
7372
7344
  * @param request - ModifyHpcClusterAttributeRequest
7373
7345
  * @returns ModifyHpcClusterAttributeResponse
@@ -7486,10 +7458,10 @@ export default class Client extends OpenApi {
7486
7458
  */
7487
7459
  modifyInstanceAttachmentAttributes(request: $_model.ModifyInstanceAttachmentAttributesRequest): Promise<$_model.ModifyInstanceAttachmentAttributesResponse>;
7488
7460
  /**
7489
- * This API modifies attributes of an ECS instance, such as the password, instance name, hostname, security group, MTU, and user data.
7461
+ * Modifies some properties of an ECS instance, including the password, instance name, hostname, security group membership, MTU, and instance user data.
7490
7462
  *
7491
7463
  * @remarks
7492
- * This API call is not supported for instances protected by a resource security lock. For more information, see [How resource security locks affect API calls](https://help.aliyun.com/document_detail/25695.html).
7464
+ * Instances that are locked for security reasons do not support this operation. For more information, see [Impact of resource security locks on API calls](https://help.aliyun.com/document_detail/25695.html).
7493
7465
  *
7494
7466
  * @param request - ModifyInstanceAttributeRequest
7495
7467
  * @param runtime - runtime options for this request RuntimeOptions
@@ -7497,10 +7469,10 @@ export default class Client extends OpenApi {
7497
7469
  */
7498
7470
  modifyInstanceAttributeWithOptions(request: $_model.ModifyInstanceAttributeRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ModifyInstanceAttributeResponse>;
7499
7471
  /**
7500
- * This API modifies attributes of an ECS instance, such as the password, instance name, hostname, security group, MTU, and user data.
7472
+ * Modifies some properties of an ECS instance, including the password, instance name, hostname, security group membership, MTU, and instance user data.
7501
7473
  *
7502
7474
  * @remarks
7503
- * This API call is not supported for instances protected by a resource security lock. For more information, see [How resource security locks affect API calls](https://help.aliyun.com/document_detail/25695.html).
7475
+ * Instances that are locked for security reasons do not support this operation. For more information, see [Impact of resource security locks on API calls](https://help.aliyun.com/document_detail/25695.html).
7504
7476
  *
7505
7477
  * @param request - ModifyInstanceAttributeRequest
7506
7478
  * @returns ModifyInstanceAttributeResponse
@@ -7724,15 +7696,14 @@ export default class Client extends OpenApi {
7724
7696
  * Modifies the bandwidth configuration of an ECS instance, allocates a public IP address, or converts the network billing method. Both upgrades and downgrades are supported.
7725
7697
  *
7726
7698
  * @remarks
7727
- * - When modifying the bandwidth configuration of a subscription (PrePaid) instance, a public IP address is automatically allocated when the maximum outbound public bandwidth (InternetMaxBandwidthOut) is upgraded from 0 Mbit/s to a non-zero value.
7728
- * - When modifying the bandwidth configuration of a pay-as-you-go (PostPaid) instance, a public IP address is not automatically allocated when the maximum outbound public bandwidth (InternetMaxBandwidthOut) is upgraded from 0 Mbit/s to a non-zero value. You need to set the `AllocatePublicIp` parameter to `true` to allocate a public IP address.
7729
- * - For classic network (Classic) instances, when the maximum outbound public bandwidth (InternetMaxBandwidthOut) is upgraded from 0 Mbit/s to a non-zero value, the instance must be in the Stopped state.
7730
- * > Within a single region, there is a limit on the total peak pay-by-bandwidth public bandwidth for a single Alibaba Cloud account. For more information, see [Public bandwidth limits](~~25412#BandwidthQuota~~).
7699
+ * - When you modify the bandwidth configuration of a subscription (PrePaid) instance, a public IP address is automatically allocated if the outbound public bandwidth (InternetMaxBandwidthOut) is upgraded from 0 Mbit/s to a non-zero value.
7700
+ * - When you modify the bandwidth configuration of a pay-as-you-go (PostPaid) instance, a public IP address is not automatically allocated if the outbound public bandwidth (InternetMaxBandwidthOut) is upgraded from 0 Mbit/s to a non-zero value. You need to set the `AllocatePublicIp` parameter to `true` to allocate a public IP address.
7701
+ * > In a single region, the total peak pay-by-bandwidth public bandwidth of a single Alibaba Cloud account is subject to a limit. For more information, see [Public bandwidth limits](~~25412#BandwidthQuota~~).
7731
7702
  *
7732
7703
  * - Fees:
7733
7704
  *
7734
- * - After upgrading bandwidth, the payment is automatically deducted by default. Make sure your payment method has sufficient balance. Otherwise, an abnormal order will be generated and can only be voided. If your account balance is insufficient, you can set the AutoPay parameter to false. In this case, an unpaid order is generated, and you can log on to the ECS console to pay for the order.
7735
- * - After downgrading bandwidth, the price difference is refunded through the original payment method. Coupons that have already been used are not refunded.
7705
+ * - After the bandwidth is upgraded, the payment is automatically deducted by default. Make sure that your payment method has sufficient balance. Otherwise, an abnormal order is generated, and you can only cancel the order. If your account balance is insufficient, you can set the AutoPay parameter to false. In this case, a normal unpaid order is generated. You can log on to the ECS console to pay for the order.
7706
+ * - After the bandwidth is downgraded, the price difference is refunded to the original payment method. Vouchers that have been used are not refundable.
7736
7707
  *
7737
7708
  * @param request - ModifyInstanceNetworkSpecRequest
7738
7709
  * @param runtime - runtime options for this request RuntimeOptions
@@ -7743,15 +7714,14 @@ export default class Client extends OpenApi {
7743
7714
  * Modifies the bandwidth configuration of an ECS instance, allocates a public IP address, or converts the network billing method. Both upgrades and downgrades are supported.
7744
7715
  *
7745
7716
  * @remarks
7746
- * - When modifying the bandwidth configuration of a subscription (PrePaid) instance, a public IP address is automatically allocated when the maximum outbound public bandwidth (InternetMaxBandwidthOut) is upgraded from 0 Mbit/s to a non-zero value.
7747
- * - When modifying the bandwidth configuration of a pay-as-you-go (PostPaid) instance, a public IP address is not automatically allocated when the maximum outbound public bandwidth (InternetMaxBandwidthOut) is upgraded from 0 Mbit/s to a non-zero value. You need to set the `AllocatePublicIp` parameter to `true` to allocate a public IP address.
7748
- * - For classic network (Classic) instances, when the maximum outbound public bandwidth (InternetMaxBandwidthOut) is upgraded from 0 Mbit/s to a non-zero value, the instance must be in the Stopped state.
7749
- * > Within a single region, there is a limit on the total peak pay-by-bandwidth public bandwidth for a single Alibaba Cloud account. For more information, see [Public bandwidth limits](~~25412#BandwidthQuota~~).
7717
+ * - When you modify the bandwidth configuration of a subscription (PrePaid) instance, a public IP address is automatically allocated if the outbound public bandwidth (InternetMaxBandwidthOut) is upgraded from 0 Mbit/s to a non-zero value.
7718
+ * - When you modify the bandwidth configuration of a pay-as-you-go (PostPaid) instance, a public IP address is not automatically allocated if the outbound public bandwidth (InternetMaxBandwidthOut) is upgraded from 0 Mbit/s to a non-zero value. You need to set the `AllocatePublicIp` parameter to `true` to allocate a public IP address.
7719
+ * > In a single region, the total peak pay-by-bandwidth public bandwidth of a single Alibaba Cloud account is subject to a limit. For more information, see [Public bandwidth limits](~~25412#BandwidthQuota~~).
7750
7720
  *
7751
7721
  * - Fees:
7752
7722
  *
7753
- * - After upgrading bandwidth, the payment is automatically deducted by default. Make sure your payment method has sufficient balance. Otherwise, an abnormal order will be generated and can only be voided. If your account balance is insufficient, you can set the AutoPay parameter to false. In this case, an unpaid order is generated, and you can log on to the ECS console to pay for the order.
7754
- * - After downgrading bandwidth, the price difference is refunded through the original payment method. Coupons that have already been used are not refunded.
7723
+ * - After the bandwidth is upgraded, the payment is automatically deducted by default. Make sure that your payment method has sufficient balance. Otherwise, an abnormal order is generated, and you can only cancel the order. If your account balance is insufficient, you can set the AutoPay parameter to false. In this case, a normal unpaid order is generated. You can log on to the ECS console to pay for the order.
7724
+ * - After the bandwidth is downgraded, the price difference is refunded to the original payment method. Vouchers that have been used are not refundable.
7755
7725
  *
7756
7726
  * @param request - ModifyInstanceNetworkSpecRequest
7757
7727
  * @returns ModifyInstanceNetworkSpecResponse
@@ -7762,18 +7732,18 @@ export default class Client extends OpenApi {
7762
7732
  *
7763
7733
  * @remarks
7764
7734
  * <props="china">.
7765
- * **Before you call this operation, make sure that you fully understand the billing methods and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS.**.
7735
+ * **Before you use this operation, make sure that you fully understand the billing methods and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS.**.
7766
7736
  * .
7767
7737
  * <props="intl">.
7768
- * **Before you call this operation, make sure that you fully understand the billing methods and [pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS.**.
7738
+ * **Before you use this operation, make sure that you fully understand the billing methods and [pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS.**.
7769
7739
  * .
7770
7740
  * Before you [change the instance type of a pay-as-you-go instance](https://help.aliyun.com/document_detail/60051.html), you can call [DescribeResourcesModification](https://help.aliyun.com/document_detail/66187.html) to query the instance types to which the current instance can be changed.
7771
7741
  * **Before you begin**.
7772
7742
  * - Your account must not have overdue payments.
7773
- * - Each call can modify only one configuration. You can change only the instance type or adjust only the public bandwidth in a single request.
7743
+ * - Each call can modify only one configuration at a time. You can modify only the instance type or adjust only the public bandwidth in a single request.
7774
7744
  * - The instance status must be **Running** (`Running`) or **Stopped** (`Stopped`) before you can adjust the public bandwidth. The change takes effect immediately.
7775
- * - The instance status must be **Stopped** (`Stopped`) before you can change the instance type. After the change, you must [start the instance](https://help.aliyun.com/document_detail/25441.html) for the change to take effect.
7776
- * > The total peak public bandwidth billed on a pay-by-bandwidth basis in a single region for a single Alibaba Cloud account is subject to limits. For more information, see [Public bandwidth limits](~~25412#BandwidthQuota~~).
7745
+ * - The instance status must be **Stopped** (`Stopped`) before you can modify the instance type. After the modification, you must [start the instance](https://help.aliyun.com/document_detail/25441.html) for the change to take effect.
7746
+ * > In a single region, the total peak pay-by-bandwidth public bandwidth for a single Alibaba Cloud account is limited. For more information, see [Public bandwidth limits](~~25412#BandwidthQuota~~).
7777
7747
  *
7778
7748
  * @param request - ModifyInstanceSpecRequest
7779
7749
  * @param runtime - runtime options for this request RuntimeOptions
@@ -7785,18 +7755,18 @@ export default class Client extends OpenApi {
7785
7755
  *
7786
7756
  * @remarks
7787
7757
  * <props="china">.
7788
- * **Before you call this operation, make sure that you fully understand the billing methods and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS.**.
7758
+ * **Before you use this operation, make sure that you fully understand the billing methods and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS.**.
7789
7759
  * .
7790
7760
  * <props="intl">.
7791
- * **Before you call this operation, make sure that you fully understand the billing methods and [pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS.**.
7761
+ * **Before you use this operation, make sure that you fully understand the billing methods and [pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS.**.
7792
7762
  * .
7793
7763
  * Before you [change the instance type of a pay-as-you-go instance](https://help.aliyun.com/document_detail/60051.html), you can call [DescribeResourcesModification](https://help.aliyun.com/document_detail/66187.html) to query the instance types to which the current instance can be changed.
7794
7764
  * **Before you begin**.
7795
7765
  * - Your account must not have overdue payments.
7796
- * - Each call can modify only one configuration. You can change only the instance type or adjust only the public bandwidth in a single request.
7766
+ * - Each call can modify only one configuration at a time. You can modify only the instance type or adjust only the public bandwidth in a single request.
7797
7767
  * - The instance status must be **Running** (`Running`) or **Stopped** (`Stopped`) before you can adjust the public bandwidth. The change takes effect immediately.
7798
- * - The instance status must be **Stopped** (`Stopped`) before you can change the instance type. After the change, you must [start the instance](https://help.aliyun.com/document_detail/25441.html) for the change to take effect.
7799
- * > The total peak public bandwidth billed on a pay-by-bandwidth basis in a single region for a single Alibaba Cloud account is subject to limits. For more information, see [Public bandwidth limits](~~25412#BandwidthQuota~~).
7768
+ * - The instance status must be **Stopped** (`Stopped`) before you can modify the instance type. After the modification, you must [start the instance](https://help.aliyun.com/document_detail/25441.html) for the change to take effect.
7769
+ * > In a single region, the total peak pay-by-bandwidth public bandwidth for a single Alibaba Cloud account is limited. For more information, see [Public bandwidth limits](~~25412#BandwidthQuota~~).
7800
7770
  *
7801
7771
  * @param request - ModifyInstanceSpecRequest
7802
7772
  * @returns ModifyInstanceSpecResponse
@@ -8015,7 +7985,7 @@ export default class Client extends OpenApi {
8015
7985
  * Updates an O&M window.
8016
7986
  *
8017
7987
  * @remarks
8018
- * Modifies the attributes of an O&M window. When the TargetResource parameter of an O&M window is set to associate ECS instances and an underlying hardware risk is detected that requires scheduled O&M to mitigate, the execution time of the scheduled O&M is determined based on the time range specified by the TimePeriod parameter of the O&M window. When the execution time of an O&M event is reached, the platform automatically performs the corresponding O&M operation based on the event type.
7988
+ * Modifies the attributes of an O&M window. When the TargetResource parameter of an O&M window is set to associate ECS instances and underlying hardware risks are detected that require scheduled O&M to mitigate, the execution time of the scheduled O&M is determined based on the time range specified by the TimePeriod parameter of the O&M window. When the execution time of an O&M event is reached, the platform automatically performs the corresponding O&M operation based on the type of the O&M event.
8019
7989
  *
8020
7990
  * @param tmpReq - ModifyPlanMaintenanceWindowRequest
8021
7991
  * @param runtime - runtime options for this request RuntimeOptions
@@ -8026,7 +7996,7 @@ export default class Client extends OpenApi {
8026
7996
  * Updates an O&M window.
8027
7997
  *
8028
7998
  * @remarks
8029
- * Modifies the attributes of an O&M window. When the TargetResource parameter of an O&M window is set to associate ECS instances and an underlying hardware risk is detected that requires scheduled O&M to mitigate, the execution time of the scheduled O&M is determined based on the time range specified by the TimePeriod parameter of the O&M window. When the execution time of an O&M event is reached, the platform automatically performs the corresponding O&M operation based on the event type.
7999
+ * Modifies the attributes of an O&M window. When the TargetResource parameter of an O&M window is set to associate ECS instances and underlying hardware risks are detected that require scheduled O&M to mitigate, the execution time of the scheduled O&M is determined based on the time range specified by the TimePeriod parameter of the O&M window. When the execution time of an O&M event is reached, the platform automatically performs the corresponding O&M operation based on the type of the O&M event.
8030
8000
  *
8031
8001
  * @param request - ModifyPlanMaintenanceWindowRequest
8032
8002
  * @returns ModifyPlanMaintenanceWindowResponse
@@ -8081,20 +8051,24 @@ export default class Client extends OpenApi {
8081
8051
  */
8082
8052
  modifyPrefixList(request: $_model.ModifyPrefixListRequest): Promise<$_model.ModifyPrefixListResponse>;
8083
8053
  /**
8084
- * Changes the instance type of a subscription Elastic Compute Service (ECS) instance. You can upgrade or downgrade the instance type. The new instance type takes effect for the entire lifecycle of the subscription ECS instance.
8054
+ * Modifies the instance type of a subscription ECS instance. You can upgrade or downgrade the instance type. The new instance type takes effect for the entire lifecycle of the instance.
8085
8055
  *
8086
8056
  * @remarks
8087
- * *Before you call this operation, make sure that you are familiar with the billing methods, [prices](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl), and [rules for unsubscribing from resources](https://help.aliyun.com/document_detail/476339.html) of ECS.**
8088
- * ModifyPrepayInstanceSpec is an asynchronous operation. After a request is sent, wait for 5 to 10 seconds for the instance type change to complete. Before you change the instance type of a subscription ECS instance, call the [DescribeResourcesModification](https://help.aliyun.com/document_detail/66187.html) operation to query the instance types to which you can change the instance.
8089
- * **Considerations**
8090
- * - Before you change the instance type of an expired instance, you must renew the instance.
8091
- * - When you downgrade the instance type of a subscription ECS instance, take note of the following items:
8092
- * - The instance must be in the **Stopped** (`Stopped`) state.
8093
- * - The price difference is refunded to the payment account that you used. Redeemed vouchers are not refundable.
8094
- * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html).
8095
- * - When you upgrade the instance type of a subscription ECS instance, take note of the following items:
8096
- * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
8097
- * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html) or [restart the instance](https://help.aliyun.com/document_detail/25440.html).
8057
+ * <props="china">
8058
+ * **Before you call this operation, make sure that you fully understand the billing methods, [pricing](https://www.aliyun.com/price/product#/ecs/detail), and [downgrade refund rules](https://help.aliyun.com/document_detail/116043.html) of ECS.**
8059
+ * <props="intl">
8060
+ * **Before you call this operation, make sure that you fully understand the billing methods, [pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl), and [downgrade refund rules](https://help.aliyun.com/document_detail/476339.html) of ECS.**
8061
+ * This operation is asynchronous. The configuration change takes effect after approximately 5 to 10 seconds. Before you upgrade or downgrade ECS instance type of a subscription ECS instance, you can call [DescribeResourcesModification](https://help.aliyun.com/document_detail/2679954.html) to query ECS instance types to which the current instance can be changed.
8062
+ * **Precautions**
8063
+ * - If the NVMe property of the source and target instance types are different (the `NvmeSupport` field returned by [DescribeInstanceTypes](https://help.aliyun.com/document_detail/2679699.html)) and the operating system is Windows (the `OSType` field returned by [DescribeInstances](https://help.aliyun.com/document_detail/2679689.html)), complete the [preventive measures](~~2978777#7de04a1c9fo50~~) before you perform the Upgrade/Downgrade.
8064
+ * - Expired instances cannot be changed to a different instance type. Complete the renewal and try again.
8065
+ * - Downgrade the instance type:
8066
+ * - The instance must be in the **Stopped** (`Stopped`) state.
8067
+ * - The price difference between the original and new instance types is refunded to your original billing method. Used vouchers are not refundable. The payer receives the refund.
8068
+ * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html) after the Upgrade/Downgrade.
8069
+ * - Upgrade the instance type:
8070
+ * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
8071
+ * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html) or [restart the instance](https://help.aliyun.com/document_detail/25440.html).
8098
8072
  *
8099
8073
  * @param request - ModifyPrepayInstanceSpecRequest
8100
8074
  * @param runtime - runtime options for this request RuntimeOptions
@@ -8102,20 +8076,24 @@ export default class Client extends OpenApi {
8102
8076
  */
8103
8077
  modifyPrepayInstanceSpecWithOptions(request: $_model.ModifyPrepayInstanceSpecRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ModifyPrepayInstanceSpecResponse>;
8104
8078
  /**
8105
- * Changes the instance type of a subscription Elastic Compute Service (ECS) instance. You can upgrade or downgrade the instance type. The new instance type takes effect for the entire lifecycle of the subscription ECS instance.
8079
+ * Modifies the instance type of a subscription ECS instance. You can upgrade or downgrade the instance type. The new instance type takes effect for the entire lifecycle of the instance.
8106
8080
  *
8107
8081
  * @remarks
8108
- * *Before you call this operation, make sure that you are familiar with the billing methods, [prices](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl), and [rules for unsubscribing from resources](https://help.aliyun.com/document_detail/476339.html) of ECS.**
8109
- * ModifyPrepayInstanceSpec is an asynchronous operation. After a request is sent, wait for 5 to 10 seconds for the instance type change to complete. Before you change the instance type of a subscription ECS instance, call the [DescribeResourcesModification](https://help.aliyun.com/document_detail/66187.html) operation to query the instance types to which you can change the instance.
8110
- * **Considerations**
8111
- * - Before you change the instance type of an expired instance, you must renew the instance.
8112
- * - When you downgrade the instance type of a subscription ECS instance, take note of the following items:
8113
- * - The instance must be in the **Stopped** (`Stopped`) state.
8114
- * - The price difference is refunded to the payment account that you used. Redeemed vouchers are not refundable.
8115
- * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html).
8116
- * - When you upgrade the instance type of a subscription ECS instance, take note of the following items:
8117
- * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
8118
- * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html) or [restart the instance](https://help.aliyun.com/document_detail/25440.html).
8082
+ * <props="china">
8083
+ * **Before you call this operation, make sure that you fully understand the billing methods, [pricing](https://www.aliyun.com/price/product#/ecs/detail), and [downgrade refund rules](https://help.aliyun.com/document_detail/116043.html) of ECS.**
8084
+ * <props="intl">
8085
+ * **Before you call this operation, make sure that you fully understand the billing methods, [pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl), and [downgrade refund rules](https://help.aliyun.com/document_detail/476339.html) of ECS.**
8086
+ * This operation is asynchronous. The configuration change takes effect after approximately 5 to 10 seconds. Before you upgrade or downgrade ECS instance type of a subscription ECS instance, you can call [DescribeResourcesModification](https://help.aliyun.com/document_detail/2679954.html) to query ECS instance types to which the current instance can be changed.
8087
+ * **Precautions**
8088
+ * - If the NVMe property of the source and target instance types are different (the `NvmeSupport` field returned by [DescribeInstanceTypes](https://help.aliyun.com/document_detail/2679699.html)) and the operating system is Windows (the `OSType` field returned by [DescribeInstances](https://help.aliyun.com/document_detail/2679689.html)), complete the [preventive measures](~~2978777#7de04a1c9fo50~~) before you perform the Upgrade/Downgrade.
8089
+ * - Expired instances cannot be changed to a different instance type. Complete the renewal and try again.
8090
+ * - Downgrade the instance type:
8091
+ * - The instance must be in the **Stopped** (`Stopped`) state.
8092
+ * - The price difference between the original and new instance types is refunded to your original billing method. Used vouchers are not refundable. The payer receives the refund.
8093
+ * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html) after the Upgrade/Downgrade.
8094
+ * - Upgrade the instance type:
8095
+ * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
8096
+ * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html) or [restart the instance](https://help.aliyun.com/document_detail/25440.html).
8119
8097
  *
8120
8098
  * @param request - ModifyPrepayInstanceSpecRequest
8121
8099
  * @returns ModifyPrepayInstanceSpecResponse
@@ -8334,12 +8312,12 @@ export default class Client extends OpenApi {
8334
8312
  */
8335
8313
  modifySecurityGroupAttribute(request: $_model.ModifySecurityGroupAttributeRequest): Promise<$_model.ModifySecurityGroupAttributeResponse>;
8336
8314
  /**
8337
- * Modifies an egress security group rule.
8315
+ * Modifies an outbound security group rule.
8338
8316
  *
8339
8317
  * @remarks
8340
- * When modifying security group rules by specifying the security group rule ID, note the following usage limits:
8341
- * - Authorization objects of security group rules include IPv4 CIDR blocks (or IP addresses), IPv6 CIDR blocks (or IP addresses), security groups, and prefix lists. You cannot use this API to change the authorization object type of an existing security group rule. For example, if the original authorization object type is an IPv4 CIDR block, you can change it to another IPv4 CIDR block (or IP address), but you cannot change it to an IPv6 CIDR block (or IP address), a security group, or a prefix list.
8342
- * - Fields cannot be changed from non-empty to empty. If modification is needed, we recommend that you add a new rule first and then delete the current rule.
8318
+ * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
8319
+ * - The authorization object of a security group rule can be an IPv4 Classless Inter-Domain Routing (CIDR) block (or IP address), an IPv6 CIDR block (or IP address), a security group, or a prefix list. You cannot use this operation to change the type of the authorization object of an existing security group rule. For example, if the original authorization object type is an IPv4 CIDR block, you can change it to another IPv4 CIDR block (or IP address), but you cannot change it to an IPv6 CIDR block (or IP address), a security group, or a prefix list.
8320
+ * - You cannot change a field value from a non-empty value to an empty value. To modify security group rules in this case, increase a new rule and then delete the current rule.
8343
8321
  *
8344
8322
  * @param request - ModifySecurityGroupEgressRuleRequest
8345
8323
  * @param runtime - runtime options for this request RuntimeOptions
@@ -8347,12 +8325,12 @@ export default class Client extends OpenApi {
8347
8325
  */
8348
8326
  modifySecurityGroupEgressRuleWithOptions(request: $_model.ModifySecurityGroupEgressRuleRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ModifySecurityGroupEgressRuleResponse>;
8349
8327
  /**
8350
- * Modifies an egress security group rule.
8328
+ * Modifies an outbound security group rule.
8351
8329
  *
8352
8330
  * @remarks
8353
- * When modifying security group rules by specifying the security group rule ID, note the following usage limits:
8354
- * - Authorization objects of security group rules include IPv4 CIDR blocks (or IP addresses), IPv6 CIDR blocks (or IP addresses), security groups, and prefix lists. You cannot use this API to change the authorization object type of an existing security group rule. For example, if the original authorization object type is an IPv4 CIDR block, you can change it to another IPv4 CIDR block (or IP address), but you cannot change it to an IPv6 CIDR block (or IP address), a security group, or a prefix list.
8355
- * - Fields cannot be changed from non-empty to empty. If modification is needed, we recommend that you add a new rule first and then delete the current rule.
8331
+ * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
8332
+ * - The authorization object of a security group rule can be an IPv4 Classless Inter-Domain Routing (CIDR) block (or IP address), an IPv6 CIDR block (or IP address), a security group, or a prefix list. You cannot use this operation to change the type of the authorization object of an existing security group rule. For example, if the original authorization object type is an IPv4 CIDR block, you can change it to another IPv4 CIDR block (or IP address), but you cannot change it to an IPv6 CIDR block (or IP address), a security group, or a prefix list.
8333
+ * - You cannot change a field value from a non-empty value to an empty value. To modify security group rules in this case, increase a new rule and then delete the current rule.
8356
8334
  *
8357
8335
  * @param request - ModifySecurityGroupEgressRuleRequest
8358
8336
  * @returns ModifySecurityGroupEgressRuleResponse
@@ -8391,7 +8369,7 @@ export default class Client extends OpenApi {
8391
8369
  * @remarks
8392
8370
  * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
8393
8371
  * - The authorization object of a security group rule can be an IPv4 Classless Inter-Domain Routing (CIDR) block (or IP address), an IPv6 CIDR block (or IP address), a security group, or a prefix list. You cannot use this operation to change the type of the authorization object of an existing security group rule. For example, if the original authorization object type is an IPv4 CIDR block, you can change it to another IPv4 CIDR block (or IP address), but you cannot change it to an IPv6 CIDR block (or IP address), a security group, or a prefix list.
8394
- * - You cannot change a field from a non-empty value to an empty value. To modify security group rules in this case, increase a new rule and then delete the current rule.
8372
+ * - You cannot change a field value from a non-empty value to an empty value. To modify security group rules in this case, increase a new rule and then delete the current rule.
8395
8373
  *
8396
8374
  * @param request - ModifySecurityGroupRuleRequest
8397
8375
  * @param runtime - runtime options for this request RuntimeOptions
@@ -8404,7 +8382,7 @@ export default class Client extends OpenApi {
8404
8382
  * @remarks
8405
8383
  * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
8406
8384
  * - The authorization object of a security group rule can be an IPv4 Classless Inter-Domain Routing (CIDR) block (or IP address), an IPv6 CIDR block (or IP address), a security group, or a prefix list. You cannot use this operation to change the type of the authorization object of an existing security group rule. For example, if the original authorization object type is an IPv4 CIDR block, you can change it to another IPv4 CIDR block (or IP address), but you cannot change it to an IPv6 CIDR block (or IP address), a security group, or a prefix list.
8407
- * - You cannot change a field from a non-empty value to an empty value. To modify security group rules in this case, increase a new rule and then delete the current rule.
8385
+ * - You cannot change a field value from a non-empty value to an empty value. To modify security group rules in this case, increase a new rule and then delete the current rule.
8408
8386
  *
8409
8387
  * @param request - ModifySecurityGroupRuleRequest
8410
8388
  * @returns ModifySecurityGroupRuleResponse
@@ -8499,6 +8477,33 @@ export default class Client extends OpenApi {
8499
8477
  * @returns ModifyStorageSetAttributeResponse
8500
8478
  */
8501
8479
  modifyStorageSetAttribute(request: $_model.ModifyStorageSetAttributeRequest): Promise<$_model.ModifyStorageSetAttributeResponse>;
8480
+ /**
8481
+ * 修改计划内运维事件属性
8482
+ *
8483
+ * @remarks
8484
+ * ## 接口说明
8485
+ * - 只能修改状态为Scheduled的计划内运维事件。
8486
+ * - 传入的NotBefore不早于当前时间。
8487
+ * - 传入的NotBefore不晚于事件产生时初始的计划执行时间。
8488
+ *
8489
+ * @param request - ModifySystemEventAttributeRequest
8490
+ * @param runtime - runtime options for this request RuntimeOptions
8491
+ * @returns ModifySystemEventAttributeResponse
8492
+ */
8493
+ modifySystemEventAttributeWithOptions(request: $_model.ModifySystemEventAttributeRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ModifySystemEventAttributeResponse>;
8494
+ /**
8495
+ * 修改计划内运维事件属性
8496
+ *
8497
+ * @remarks
8498
+ * ## 接口说明
8499
+ * - 只能修改状态为Scheduled的计划内运维事件。
8500
+ * - 传入的NotBefore不早于当前时间。
8501
+ * - 传入的NotBefore不晚于事件产生时初始的计划执行时间。
8502
+ *
8503
+ * @param request - ModifySystemEventAttributeRequest
8504
+ * @returns ModifySystemEventAttributeResponse
8505
+ */
8506
+ modifySystemEventAttribute(request: $_model.ModifySystemEventAttributeRequest): Promise<$_model.ModifySystemEventAttributeResponse>;
8502
8507
  /**
8503
8508
  * Modifies the default user-level attributes.
8504
8509
  *
@@ -9067,7 +9072,7 @@ export default class Client extends OpenApi {
9067
9072
  */
9068
9073
  renewDedicatedHosts(request: $_model.RenewDedicatedHostsRequest): Promise<$_model.RenewDedicatedHostsResponse>;
9069
9074
  /**
9070
- * Renews elasticity assurances that you purchased.
9075
+ * Renews one or more purchased elasticity assurance services.
9071
9076
  *
9072
9077
  * @param request - RenewElasticityAssurancesRequest
9073
9078
  * @param runtime - runtime options for this request RuntimeOptions
@@ -9075,7 +9080,7 @@ export default class Client extends OpenApi {
9075
9080
  */
9076
9081
  renewElasticityAssurancesWithOptions(request: $_model.RenewElasticityAssurancesRequest, runtime: $dara.RuntimeOptions): Promise<$_model.RenewElasticityAssurancesResponse>;
9077
9082
  /**
9078
- * Renews elasticity assurances that you purchased.
9083
+ * Renews one or more purchased elasticity assurance services.
9079
9084
  *
9080
9085
  * @param request - RenewElasticityAssurancesRequest
9081
9086
  * @returns RenewElasticityAssurancesResponse
@@ -9306,61 +9311,57 @@ export default class Client extends OpenApi {
9306
9311
  */
9307
9312
  resizeDisk(request: $_model.ResizeDiskRequest): Promise<$_model.ResizeDiskResponse>;
9308
9313
  /**
9309
- * Deletes inbound security group rules from a specific security group.
9310
- *
9311
- * @remarks
9312
- * > Alibaba Cloud modified verification rules for the RevokeSecurityGroup operation on July 8, 2024. When you call the RevokeSecurityGroup operation to delete a security group rule that does not exist, the "InvalidParam.SecurityGroupRuleId" error code is returned instead of a success response. Update the RevokeSecurityGroup operation to use the new verification rules with the new error code based on your business requirements.
9313
- * You can use one of the following groups of parameters to specify the security group rules that you want to delete:
9314
- * - Parameters used to specify the IDs of security group rules. We recommend that you specify the IDs of security group rules to delete the rules.
9315
- * - If a specified security group rule ID does not exist, the call to RevokeSecurityGroup fails.
9316
- * - Parameters that start with Permissions.
9317
- * - If no security group rule matches the specified parameters, the call to RevokeSecurityGroup is successful but no security group rules are deleted.
9318
- * - Define an inbound security group rule by configuring the following parameters together:
9319
- * - Source: You can specify one parameter from SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcetPrefixListId (prefix list ID), and SourceGroupId (source security group ID).
9320
- * - PortRange: specifies the destination port range.
9321
- * - IpProtocol: specifies the protocol.
9322
- * - Policy: specifies the action.
9323
- * > You cannot specify the IDs of security group rules and the parameters that start with Permissions in the same request.
9324
- * ### [](#)Sample requests
9325
- * - Delete a security group rule based on the rule ID:
9326
- * <!---->
9314
+ * Deletes one or more inbound security group rules from a specified security group.
9315
+ *
9316
+ * @remarks
9317
+ * >Notice: Starting July 8, 2024, Alibaba Cloud adjusted the validation rules for this operation. When you attempt to delete a security group rule that does not exist, the operation now returns the error code "InvalidParam.SecurityGroupRuleId" instead of a success response. Update your error code handling to be compatible accordingly to avoid impact on your production workloads.
9318
+ * You can use one of the following methods to pass parameters to delete rules:
9319
+ * - Specify security group rule IDs to delete rules (recommended).
9320
+ * - If a specified security group rule ID does not exist, the API invocation fails.
9321
+ * - Specify Permissions to delete rules.
9322
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
9323
+ * - The following parameters are required to identify an inbound rule:
9324
+ * - Source settings: Set one of SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
9325
+ * - Destination port range: PortRange.
9326
+ * - Protocol type: IpProtocol.
9327
+ * - Access policy: Policy.
9328
+ * > You cannot specify both security group rule IDs and Permissions at the same time.
9329
+ * ### Request examples
9330
+ * - Delete by specifying security group rule IDs.
9327
9331
  * ```
9328
- * "SecurityGroupId":"sg-bp67acfmxazb4p****", //Specify the ID of the security group.
9329
- * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] //Specify the ID of the security group rule.
9332
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
9333
+ * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
9330
9334
  * ```
9331
- * - Delete a security group rule based on an IPv4 CIDR block:
9332
- * <!---->
9335
+ * - Delete by specifying an IP address range.
9333
9336
  * ```
9334
9337
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
9335
9338
  * "Permissions":[
9336
9339
  * {
9337
- * "SourceCidrIp":"10.0.0.0/8", //Specify the source IPv4 CIDR block.
9338
- * "IpProtocol":"TCP", //Specify the protocol.
9339
- * "PortRange":"80/80", //Specify the destination port range.
9340
- * "Policy":"accept" //Specify the action.
9340
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IP address range.
9341
+ * "IpProtocol":"TCP", // Specify the protocol type.
9342
+ * "PortRange":"80/80", // Specify the destination port range.
9343
+ * "Policy":"accept" // Specify the access policy.
9341
9344
  * }
9342
9345
  * ]
9343
9346
  * ```
9344
- * - Delete a security group rule in which a security group is referenced:
9345
- * <!---->
9347
+ * - Delete by specifying another security group.
9346
9348
  * ```
9347
9349
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
9348
9350
  * "Permissions":[
9349
9351
  * {
9350
- * "SourceGroupId":"sg-bp67acfmxa123b****", //Specify the ID of the source security group.
9352
+ * "SourceGroupId":"sg-bp67acfmxa123b****", // Specify the source security group ID.
9351
9353
  * "IpProtocol":"TCP,"
9352
9354
  * "PortRange":"80/80",
9353
9355
  * "Policy":"accept"
9354
9356
  * ]
9355
9357
  * }
9356
9358
  * ```
9357
- * - Delete a security group rule in which a prefix list is referenced:
9358
- * <!---->
9359
+ * - Delete by specifying a prefix list.
9359
9360
  * ```
9360
9361
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
9361
9362
  * "Permissions":[
9362
9363
  * {
9363
- * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", //Specify the ID of the source prefix list.
9364
+ * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list ID.
9364
9365
  * "IpProtocol":"TCP",
9365
9366
  * "PortRange":"80/80",
9366
9367
  * "Policy":"accept"
@@ -9374,61 +9375,57 @@ export default class Client extends OpenApi {
9374
9375
  */
9375
9376
  revokeSecurityGroupWithOptions(request: $_model.RevokeSecurityGroupRequest, runtime: $dara.RuntimeOptions): Promise<$_model.RevokeSecurityGroupResponse>;
9376
9377
  /**
9377
- * Deletes inbound security group rules from a specific security group.
9378
- *
9379
- * @remarks
9380
- * > Alibaba Cloud modified verification rules for the RevokeSecurityGroup operation on July 8, 2024. When you call the RevokeSecurityGroup operation to delete a security group rule that does not exist, the "InvalidParam.SecurityGroupRuleId" error code is returned instead of a success response. Update the RevokeSecurityGroup operation to use the new verification rules with the new error code based on your business requirements.
9381
- * You can use one of the following groups of parameters to specify the security group rules that you want to delete:
9382
- * - Parameters used to specify the IDs of security group rules. We recommend that you specify the IDs of security group rules to delete the rules.
9383
- * - If a specified security group rule ID does not exist, the call to RevokeSecurityGroup fails.
9384
- * - Parameters that start with Permissions.
9385
- * - If no security group rule matches the specified parameters, the call to RevokeSecurityGroup is successful but no security group rules are deleted.
9386
- * - Define an inbound security group rule by configuring the following parameters together:
9387
- * - Source: You can specify one parameter from SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcetPrefixListId (prefix list ID), and SourceGroupId (source security group ID).
9388
- * - PortRange: specifies the destination port range.
9389
- * - IpProtocol: specifies the protocol.
9390
- * - Policy: specifies the action.
9391
- * > You cannot specify the IDs of security group rules and the parameters that start with Permissions in the same request.
9392
- * ### [](#)Sample requests
9393
- * - Delete a security group rule based on the rule ID:
9394
- * <!---->
9378
+ * Deletes one or more inbound security group rules from a specified security group.
9379
+ *
9380
+ * @remarks
9381
+ * >Notice: Starting July 8, 2024, Alibaba Cloud adjusted the validation rules for this operation. When you attempt to delete a security group rule that does not exist, the operation now returns the error code "InvalidParam.SecurityGroupRuleId" instead of a success response. Update your error code handling to be compatible accordingly to avoid impact on your production workloads.
9382
+ * You can use one of the following methods to pass parameters to delete rules:
9383
+ * - Specify security group rule IDs to delete rules (recommended).
9384
+ * - If a specified security group rule ID does not exist, the API invocation fails.
9385
+ * - Specify Permissions to delete rules.
9386
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
9387
+ * - The following parameters are required to identify an inbound rule:
9388
+ * - Source settings: Set one of SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
9389
+ * - Destination port range: PortRange.
9390
+ * - Protocol type: IpProtocol.
9391
+ * - Access policy: Policy.
9392
+ * > You cannot specify both security group rule IDs and Permissions at the same time.
9393
+ * ### Request examples
9394
+ * - Delete by specifying security group rule IDs.
9395
9395
  * ```
9396
- * "SecurityGroupId":"sg-bp67acfmxazb4p****", //Specify the ID of the security group.
9397
- * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] //Specify the ID of the security group rule.
9396
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
9397
+ * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
9398
9398
  * ```
9399
- * - Delete a security group rule based on an IPv4 CIDR block:
9400
- * <!---->
9399
+ * - Delete by specifying an IP address range.
9401
9400
  * ```
9402
9401
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
9403
9402
  * "Permissions":[
9404
9403
  * {
9405
- * "SourceCidrIp":"10.0.0.0/8", //Specify the source IPv4 CIDR block.
9406
- * "IpProtocol":"TCP", //Specify the protocol.
9407
- * "PortRange":"80/80", //Specify the destination port range.
9408
- * "Policy":"accept" //Specify the action.
9404
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IP address range.
9405
+ * "IpProtocol":"TCP", // Specify the protocol type.
9406
+ * "PortRange":"80/80", // Specify the destination port range.
9407
+ * "Policy":"accept" // Specify the access policy.
9409
9408
  * }
9410
9409
  * ]
9411
9410
  * ```
9412
- * - Delete a security group rule in which a security group is referenced:
9413
- * <!---->
9411
+ * - Delete by specifying another security group.
9414
9412
  * ```
9415
9413
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
9416
9414
  * "Permissions":[
9417
9415
  * {
9418
- * "SourceGroupId":"sg-bp67acfmxa123b****", //Specify the ID of the source security group.
9416
+ * "SourceGroupId":"sg-bp67acfmxa123b****", // Specify the source security group ID.
9419
9417
  * "IpProtocol":"TCP,"
9420
9418
  * "PortRange":"80/80",
9421
9419
  * "Policy":"accept"
9422
9420
  * ]
9423
9421
  * }
9424
9422
  * ```
9425
- * - Delete a security group rule in which a prefix list is referenced:
9426
- * <!---->
9423
+ * - Delete by specifying a prefix list.
9427
9424
  * ```
9428
9425
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
9429
9426
  * "Permissions":[
9430
9427
  * {
9431
- * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", //Specify the ID of the source prefix list.
9428
+ * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list ID.
9432
9429
  * "IpProtocol":"TCP",
9433
9430
  * "PortRange":"80/80",
9434
9431
  * "Policy":"accept"
@@ -9444,14 +9441,14 @@ export default class Client extends OpenApi {
9444
9441
  * Deletes one or more outbound security group rules from a specified security group.
9445
9442
  *
9446
9443
  * @remarks
9447
- * >Notice: On July 8, 2024, Alibaba Cloud adjusted the validation rules for this operation. When you attempt to delete a security group rule that does not exist, the operation now returns the error code "InvalidSecurityGroupRule.RuleNotExist" instead of a success response. Ensure that your application is compatible with this error code to avoid impacts on your online services.
9444
+ * >Notice: Alibaba Cloud adjusted the validation rules for this operation on July 8, 2024. When you attempt to delete a security group rule that does not exist, the operation now returns the error code "InvalidSecurityGroupRule.RuleNotExist" instead of a success response. Update your error code handling to be compatible with this change to avoid impacts on your production workloads.
9448
9445
  * You can use one of the following methods to pass parameters to delete security group rules:
9449
9446
  * - Delete rules by specifying security group rule IDs (recommended).
9450
- * - If the specified security group rule ID does not exist, an error is returned.
9447
+ * - If a specified security group rule ID does not exist, a fault is returned.
9451
9448
  * - Delete rules by specifying the Permissions parameter.
9452
- * - If the matching security group rule does not exist, the invoke succeeds but no rule is deleted.
9449
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
9453
9450
  * - The following parameters are required to delete a security group rule:
9454
- * - Destination settings: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
9451
+ * - Destination: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
9455
9452
  * - Destination port range: PortRange.
9456
9453
  * - Protocol type: IpProtocol.
9457
9454
  * - Access policy: Policy.
@@ -9462,15 +9459,15 @@ export default class Client extends OpenApi {
9462
9459
  * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
9463
9460
  * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
9464
9461
  * ```
9465
- * - Delete by IP address CIDR block.
9462
+ * - Delete by IP CIDR block.
9466
9463
  * ```
9467
9464
  * "SecurityGroupId":"sg-bp67acfmxazb4ph***",
9468
9465
  * "Permissions":[
9469
9466
  * {
9470
9467
  * "IpProtocol":"TCP", // Specify the protocol type.
9471
- * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP address CIDR block.
9468
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP CIDR block.
9472
9469
  * "PortRange":"22/22", // Specify the destination port range.
9473
- * "Policy":"accept" // Specify the access policy.
9470
+ * "Policy":"accept" // Specify the authorization policy.
9474
9471
  * }
9475
9472
  * ]
9476
9473
  * ```
@@ -9498,7 +9495,7 @@ export default class Client extends OpenApi {
9498
9495
  * "Policy":"accept",
9499
9496
  * }
9500
9497
  * ]
9501
- * ```.
9498
+ * ```
9502
9499
  *
9503
9500
  * @param request - RevokeSecurityGroupEgressRequest
9504
9501
  * @param runtime - runtime options for this request RuntimeOptions
@@ -9509,14 +9506,14 @@ export default class Client extends OpenApi {
9509
9506
  * Deletes one or more outbound security group rules from a specified security group.
9510
9507
  *
9511
9508
  * @remarks
9512
- * >Notice: On July 8, 2024, Alibaba Cloud adjusted the validation rules for this operation. When you attempt to delete a security group rule that does not exist, the operation now returns the error code "InvalidSecurityGroupRule.RuleNotExist" instead of a success response. Ensure that your application is compatible with this error code to avoid impacts on your online services.
9509
+ * >Notice: Alibaba Cloud adjusted the validation rules for this operation on July 8, 2024. When you attempt to delete a security group rule that does not exist, the operation now returns the error code "InvalidSecurityGroupRule.RuleNotExist" instead of a success response. Update your error code handling to be compatible with this change to avoid impacts on your production workloads.
9513
9510
  * You can use one of the following methods to pass parameters to delete security group rules:
9514
9511
  * - Delete rules by specifying security group rule IDs (recommended).
9515
- * - If the specified security group rule ID does not exist, an error is returned.
9512
+ * - If a specified security group rule ID does not exist, a fault is returned.
9516
9513
  * - Delete rules by specifying the Permissions parameter.
9517
- * - If the matching security group rule does not exist, the invoke succeeds but no rule is deleted.
9514
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
9518
9515
  * - The following parameters are required to delete a security group rule:
9519
- * - Destination settings: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
9516
+ * - Destination: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
9520
9517
  * - Destination port range: PortRange.
9521
9518
  * - Protocol type: IpProtocol.
9522
9519
  * - Access policy: Policy.
@@ -9527,15 +9524,15 @@ export default class Client extends OpenApi {
9527
9524
  * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
9528
9525
  * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
9529
9526
  * ```
9530
- * - Delete by IP address CIDR block.
9527
+ * - Delete by IP CIDR block.
9531
9528
  * ```
9532
9529
  * "SecurityGroupId":"sg-bp67acfmxazb4ph***",
9533
9530
  * "Permissions":[
9534
9531
  * {
9535
9532
  * "IpProtocol":"TCP", // Specify the protocol type.
9536
- * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP address CIDR block.
9533
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP CIDR block.
9537
9534
  * "PortRange":"22/22", // Specify the destination port range.
9538
- * "Policy":"accept" // Specify the access policy.
9535
+ * "Policy":"accept" // Specify the authorization policy.
9539
9536
  * }
9540
9537
  * ]
9541
9538
  * ```
@@ -9563,7 +9560,7 @@ export default class Client extends OpenApi {
9563
9560
  * "Policy":"accept",
9564
9561
  * }
9565
9562
  * ]
9566
- * ```.
9563
+ * ```
9567
9564
  *
9568
9565
  * @param request - RevokeSecurityGroupEgressRequest
9569
9566
  * @returns RevokeSecurityGroupEgressResponse
@@ -9986,22 +9983,22 @@ export default class Client extends OpenApi {
9986
9983
  */
9987
9984
  startInstances(request: $_model.StartInstancesRequest): Promise<$_model.StartInstancesResponse>;
9988
9985
  /**
9989
- * Invoke StartTerminalSession to create a session based on the Session Manager feature. You can establish a WebSocket session with an ECS instance by specifying its instance ID. Use the WebSocketUrl returned by the API to remotely connect to the ECS instance.
9986
+ * Invokes StartTerminalSession to create a session based on the session management feature. You can establish a WebSocket session with an ECS instance by specifying the instance ID. The WebSocketUrl returned by this operation can be used to establish a remote connection to the ECS instance.
9990
9987
  *
9991
9988
  * @remarks
9992
- * ## API Guide
9993
- * When you customize a remote connection client through code, you can invoke this API to obtain the WebSocketUrl for remotely connecting to an ECS instance. Note the following when invoking this API:
9994
- * - The specified ECS instance must be in the running state.
9995
- * - The specified ECS instance must have the Cloud Assistant Agent installed. You can invoke [DescribeCloudAssistantStatus](https://help.aliyun.com/document_detail/87346.html) to check whether the Cloud Assistant Agent is installed on the ECS instance and to query its version number.
9996
- * - If the Cloud Assistant Agent is not installed on your ECS instance, invoke [InstallCloudAssistant](https://help.aliyun.com/document_detail/85916.html) to install it.
9997
- * - The Cloud Assistant Agent version must be higher than the following versions to support the Session Manager feature. To upgrade the Cloud Assistant Agent version, see [Upgrade or disable automatic upgrade of Cloud Assistant Agent](https://help.aliyun.com/document_detail/134383.html).
9998
- * - Linux operating system: 2.2.3.256
9999
- * - Windows operating system: 2.1.3.256
10000
- * - After successful invocation of this API, the WebSocketUrl remains valid for 10 minutes.
10001
- * - If no data transmission occurs within 3 minutes after the session is established, Cloud Assistant shuts down the connection.
10002
- * - Within the same Region, the number of created and active sessions cannot exceed 1,000. The number of sessions in Connection Status per ECS instance cannot exceed 20. The bandwidth limit for a single session is 200 kb/s.
10003
- * - The port forwarding feature currently supports TCP port forwarding only and does not support UDP.
10004
- * - To permanently close a session and invalidate the WebSocketUrl, invoke the EndTerminalSession API.
9989
+ * ## Operation description
9990
+ * When you customize a remote connection client by using code, you can invoke this operation to obtain the WebSocketUrl for establishing a remote connection to an ECS instance. Take note of the following items:
9991
+ * - The specified ECS instance must be in the Running state.
9992
+ * - Cloud Assistant Agent must be installed on the specified ECS instance. You can invoke [DescribeCloudAssistantStatus](https://help.aliyun.com/document_detail/87346.html) to check whether Cloud Assistant Agent is installed on the ECS instance and query the version number of Cloud Assistant Agent.
9993
+ * - If Cloud Assistant Agent is not installed on the ECS instance, invoke [InstallCloudAssistant](https://help.aliyun.com/document_detail/85916.html) to install it.
9994
+ * - The version number of Cloud Assistant Agent must be later than the following versions to support the session management feature. To upgrade Cloud Assistant Agent, see [Update or disable updates for Cloud Assistant Agent](https://help.aliyun.com/document_detail/134383.html).
9995
+ * - Linux operating system: 2.2.3.256
9996
+ * - Windows operating system: 2.1.3.256
9997
+ * - After this operation is invoked, the WebSocketUrl is valid for 10 minutes.
9998
+ * - After a session is established, Cloud Assistant closes the connection if no data is transmitted for 3 minutes.
9999
+ * - In a single region, a maximum of 100 sessions can be created and active. A maximum of 20 sessions can be in the connected state for a single ECS instance. The bandwidth limit for a single session is 200 KB/s.
10000
+ * - The port forwarding feature supports only TCP port forwarding. UDP is not supported.
10001
+ * - To permanently shutdown a session and invalidate the WebSocketUrl, invoke the EndTerminalSession operation.
10005
10002
  *
10006
10003
  * @param tmpReq - StartTerminalSessionRequest
10007
10004
  * @param runtime - runtime options for this request RuntimeOptions
@@ -10009,35 +10006,35 @@ export default class Client extends OpenApi {
10009
10006
  */
10010
10007
  startTerminalSessionWithOptions(tmpReq: $_model.StartTerminalSessionRequest, runtime: $dara.RuntimeOptions): Promise<$_model.StartTerminalSessionResponse>;
10011
10008
  /**
10012
- * Invoke StartTerminalSession to create a session based on the Session Manager feature. You can establish a WebSocket session with an ECS instance by specifying its instance ID. Use the WebSocketUrl returned by the API to remotely connect to the ECS instance.
10009
+ * Invokes StartTerminalSession to create a session based on the session management feature. You can establish a WebSocket session with an ECS instance by specifying the instance ID. The WebSocketUrl returned by this operation can be used to establish a remote connection to the ECS instance.
10013
10010
  *
10014
10011
  * @remarks
10015
- * ## API Guide
10016
- * When you customize a remote connection client through code, you can invoke this API to obtain the WebSocketUrl for remotely connecting to an ECS instance. Note the following when invoking this API:
10017
- * - The specified ECS instance must be in the running state.
10018
- * - The specified ECS instance must have the Cloud Assistant Agent installed. You can invoke [DescribeCloudAssistantStatus](https://help.aliyun.com/document_detail/87346.html) to check whether the Cloud Assistant Agent is installed on the ECS instance and to query its version number.
10019
- * - If the Cloud Assistant Agent is not installed on your ECS instance, invoke [InstallCloudAssistant](https://help.aliyun.com/document_detail/85916.html) to install it.
10020
- * - The Cloud Assistant Agent version must be higher than the following versions to support the Session Manager feature. To upgrade the Cloud Assistant Agent version, see [Upgrade or disable automatic upgrade of Cloud Assistant Agent](https://help.aliyun.com/document_detail/134383.html).
10021
- * - Linux operating system: 2.2.3.256
10022
- * - Windows operating system: 2.1.3.256
10023
- * - After successful invocation of this API, the WebSocketUrl remains valid for 10 minutes.
10024
- * - If no data transmission occurs within 3 minutes after the session is established, Cloud Assistant shuts down the connection.
10025
- * - Within the same Region, the number of created and active sessions cannot exceed 1,000. The number of sessions in Connection Status per ECS instance cannot exceed 20. The bandwidth limit for a single session is 200 kb/s.
10026
- * - The port forwarding feature currently supports TCP port forwarding only and does not support UDP.
10027
- * - To permanently close a session and invalidate the WebSocketUrl, invoke the EndTerminalSession API.
10012
+ * ## Operation description
10013
+ * When you customize a remote connection client by using code, you can invoke this operation to obtain the WebSocketUrl for establishing a remote connection to an ECS instance. Take note of the following items:
10014
+ * - The specified ECS instance must be in the Running state.
10015
+ * - Cloud Assistant Agent must be installed on the specified ECS instance. You can invoke [DescribeCloudAssistantStatus](https://help.aliyun.com/document_detail/87346.html) to check whether Cloud Assistant Agent is installed on the ECS instance and query the version number of Cloud Assistant Agent.
10016
+ * - If Cloud Assistant Agent is not installed on the ECS instance, invoke [InstallCloudAssistant](https://help.aliyun.com/document_detail/85916.html) to install it.
10017
+ * - The version number of Cloud Assistant Agent must be later than the following versions to support the session management feature. To upgrade Cloud Assistant Agent, see [Update or disable updates for Cloud Assistant Agent](https://help.aliyun.com/document_detail/134383.html).
10018
+ * - Linux operating system: 2.2.3.256
10019
+ * - Windows operating system: 2.1.3.256
10020
+ * - After this operation is invoked, the WebSocketUrl is valid for 10 minutes.
10021
+ * - After a session is established, Cloud Assistant closes the connection if no data is transmitted for 3 minutes.
10022
+ * - In a single region, a maximum of 100 sessions can be created and active. A maximum of 20 sessions can be in the connected state for a single ECS instance. The bandwidth limit for a single session is 200 KB/s.
10023
+ * - The port forwarding feature supports only TCP port forwarding. UDP is not supported.
10024
+ * - To permanently shutdown a session and invalidate the WebSocketUrl, invoke the EndTerminalSession operation.
10028
10025
  *
10029
10026
  * @param request - StartTerminalSessionRequest
10030
10027
  * @returns StartTerminalSessionResponse
10031
10028
  */
10032
10029
  startTerminalSession(request: $_model.StartTerminalSessionRequest): Promise<$_model.StartTerminalSessionResponse>;
10033
10030
  /**
10034
- * Stops an Elastic Compute Service (ECS) instance. You can specify parameters to determine whether to forcefully stop the instance and the stop mode.
10031
+ * Stops an Elastic Compute Service (ECS) instance. You can specify different stop strategies, stop modes, and batch operation modes to stop the ECS instance.
10035
10032
  *
10036
10033
  * @remarks
10037
- * 该接口为异步接口,实例的停止不是立即完成的,成功调用后,实例会先进入停止中(Stoping)状态,你可以调用 [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) 查看实例状态,当返回的状态为`Stopped `时代表启动成功。
10038
- * ### 使用须知
10039
- * - 被安全锁定的实例不能通过调用该接口停止。更多信息,请参见[资源安全锁定对调用 API 的影响](https://help.aliyun.com/document_detail/25695.html)
10040
- * - 开启 VPC 内实例节省停机模式后,您可以通过设置`StoppedMode=KeepCharging`开启普通停机模式,ECS 实例停止后会继续计费,并为您保留 ECS 实例规格库存和公网 IP 地址。
10034
+ * This is an asynchronous operation. The ECS instance is not stopped immediately after a successful invocation. The ECS instance first enters the Stopping state. You can invoke [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) to query the instance status. When the returned status is `Stopped`, the ECS instance is stopped.
10035
+ * ### Before you begin
10036
+ * - ECS instances that are locked for security reasons cannot be stopped by invoking this operation. For more information, see [Impact of resource security locks on API calls](https://help.aliyun.com/document_detail/25695.html).
10037
+ * - After you enable the economical mode for VPC-connected instances, you can set `StoppedMode=KeepCharging` to enable the standard stop mode. The ECS instance continues billing after it is stopped, and the ECS instance type inventory and Internet IP address are retained.
10041
10038
  *
10042
10039
  * @param request - StopInstanceRequest
10043
10040
  * @param runtime - runtime options for this request RuntimeOptions
@@ -10045,26 +10042,26 @@ export default class Client extends OpenApi {
10045
10042
  */
10046
10043
  stopInstanceWithOptions(request: $_model.StopInstanceRequest, runtime: $dara.RuntimeOptions): Promise<$_model.StopInstanceResponse>;
10047
10044
  /**
10048
- * Stops an Elastic Compute Service (ECS) instance. You can specify parameters to determine whether to forcefully stop the instance and the stop mode.
10045
+ * Stops an Elastic Compute Service (ECS) instance. You can specify different stop strategies, stop modes, and batch operation modes to stop the ECS instance.
10049
10046
  *
10050
10047
  * @remarks
10051
- * 该接口为异步接口,实例的停止不是立即完成的,成功调用后,实例会先进入停止中(Stoping)状态,你可以调用 [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) 查看实例状态,当返回的状态为`Stopped `时代表启动成功。
10052
- * ### 使用须知
10053
- * - 被安全锁定的实例不能通过调用该接口停止。更多信息,请参见[资源安全锁定对调用 API 的影响](https://help.aliyun.com/document_detail/25695.html)
10054
- * - 开启 VPC 内实例节省停机模式后,您可以通过设置`StoppedMode=KeepCharging`开启普通停机模式,ECS 实例停止后会继续计费,并为您保留 ECS 实例规格库存和公网 IP 地址。
10048
+ * This is an asynchronous operation. The ECS instance is not stopped immediately after a successful invocation. The ECS instance first enters the Stopping state. You can invoke [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) to query the instance status. When the returned status is `Stopped`, the ECS instance is stopped.
10049
+ * ### Before you begin
10050
+ * - ECS instances that are locked for security reasons cannot be stopped by invoking this operation. For more information, see [Impact of resource security locks on API calls](https://help.aliyun.com/document_detail/25695.html).
10051
+ * - After you enable the economical mode for VPC-connected instances, you can set `StoppedMode=KeepCharging` to enable the standard stop mode. The ECS instance continues billing after it is stopped, and the ECS instance type inventory and Internet IP address are retained.
10055
10052
  *
10056
10053
  * @param request - StopInstanceRequest
10057
10054
  * @returns StopInstanceResponse
10058
10055
  */
10059
10056
  stopInstance(request: $_model.StopInstanceRequest): Promise<$_model.StopInstanceResponse>;
10060
10057
  /**
10061
- * Stops Elastic Compute Service (ECS) instances. You can specify parameters to determine whether to forcefully stop the instances and the stop mode.
10058
+ * Stops one or more ECS instances. You can specify the stop method, stop mode, and batch operation mode.
10062
10059
  *
10063
10060
  * @remarks
10064
- * 该接口为异步接口,实例的停止不是立即完成的,成功调用后,实例会先进入停止中(Stoping)状态,你可以调用 [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) 查看实例状态,当返回的状态为`Stopped `时代表停止成功。
10065
- * ### 使用须知
10066
- * - 停止实例后实例不可用,请确认停止实例不会对您的业务造成影响。您可以调用 [StartInstance](https://help.aliyun.com/document_detail/2679679.html) [StartInstances](https://help.aliyun.com/document_detail/2679680.html) 接口启动实例。
10067
- * - 被安全锁定的实例不能通过调用该接口停止。更多信息,请参见[资源安全锁定对调用 API 的影响](https://help.aliyun.com/document_detail/25695.html)
10061
+ * This is an asynchronous operation. After a successful call, the instance enters the Stopping state. Call [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) to query the instance status. When the returned status is `Stopped`, the instance is stopped.
10062
+ * ### Before you begin
10063
+ * - After an instance is stopped, it becomes unavailable. Make sure that stopping the instance does not affect your business. Call [StartInstance](https://help.aliyun.com/document_detail/2679679.html) or [StartInstances](https://help.aliyun.com/document_detail/2679680.html) to start the instance.
10064
+ * - Instances that are locked for security reasons cannot be stopped by calling this operation. For more information, see [Impacts of resource security locks on API calls](https://help.aliyun.com/document_detail/25695.html).
10068
10065
  *
10069
10066
  * @param request - StopInstancesRequest
10070
10067
  * @param runtime - runtime options for this request RuntimeOptions
@@ -10072,13 +10069,13 @@ export default class Client extends OpenApi {
10072
10069
  */
10073
10070
  stopInstancesWithOptions(request: $_model.StopInstancesRequest, runtime: $dara.RuntimeOptions): Promise<$_model.StopInstancesResponse>;
10074
10071
  /**
10075
- * Stops Elastic Compute Service (ECS) instances. You can specify parameters to determine whether to forcefully stop the instances and the stop mode.
10072
+ * Stops one or more ECS instances. You can specify the stop method, stop mode, and batch operation mode.
10076
10073
  *
10077
10074
  * @remarks
10078
- * 该接口为异步接口,实例的停止不是立即完成的,成功调用后,实例会先进入停止中(Stoping)状态,你可以调用 [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) 查看实例状态,当返回的状态为`Stopped `时代表停止成功。
10079
- * ### 使用须知
10080
- * - 停止实例后实例不可用,请确认停止实例不会对您的业务造成影响。您可以调用 [StartInstance](https://help.aliyun.com/document_detail/2679679.html) [StartInstances](https://help.aliyun.com/document_detail/2679680.html) 接口启动实例。
10081
- * - 被安全锁定的实例不能通过调用该接口停止。更多信息,请参见[资源安全锁定对调用 API 的影响](https://help.aliyun.com/document_detail/25695.html)
10075
+ * This is an asynchronous operation. After a successful call, the instance enters the Stopping state. Call [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) to query the instance status. When the returned status is `Stopped`, the instance is stopped.
10076
+ * ### Before you begin
10077
+ * - After an instance is stopped, it becomes unavailable. Make sure that stopping the instance does not affect your business. Call [StartInstance](https://help.aliyun.com/document_detail/2679679.html) or [StartInstances](https://help.aliyun.com/document_detail/2679680.html) to start the instance.
10078
+ * - Instances that are locked for security reasons cannot be stopped by calling this operation. For more information, see [Impacts of resource security locks on API calls](https://help.aliyun.com/document_detail/25695.html).
10082
10079
  *
10083
10080
  * @param request - StopInstancesRequest
10084
10081
  * @returns StopInstancesResponse
@@ -10178,8 +10175,8 @@ export default class Client extends OpenApi {
10178
10175
  * @remarks
10179
10176
  * ## Operation description
10180
10177
  * When you invoke this operation, take note of the following items:
10181
- * - The Elastic Network Interface (ENI) must be in the **Active** (Available) or **InUse** state.
10182
- * - If you are operating on a primary ENI, the ECS instance to which the network interface controller (NIC) is attached must be in the **Running** or **Stopped** state.
10178
+ * - The Elastic Network Interface (ENI) must be in the **Active** or **InUse** state.
10179
+ * - If you are operating on a primary network interface controller (NIC), the ECS instance to which the NIC is attached must be in the **Running** or **Stopped** state.
10183
10180
  *
10184
10181
  * @param request - UnassignIpv6AddressesRequest
10185
10182
  * @param runtime - runtime options for this request RuntimeOptions
@@ -10192,8 +10189,8 @@ export default class Client extends OpenApi {
10192
10189
  * @remarks
10193
10190
  * ## Operation description
10194
10191
  * When you invoke this operation, take note of the following items:
10195
- * - The Elastic Network Interface (ENI) must be in the **Active** (Available) or **InUse** state.
10196
- * - If you are operating on a primary ENI, the ECS instance to which the network interface controller (NIC) is attached must be in the **Running** or **Stopped** state.
10192
+ * - The Elastic Network Interface (ENI) must be in the **Active** or **InUse** state.
10193
+ * - If you are operating on a primary network interface controller (NIC), the ECS instance to which the NIC is attached must be in the **Running** or **Stopped** state.
10197
10194
  *
10198
10195
  * @param request - UnassignIpv6AddressesRequest
10199
10196
  * @returns UnassignIpv6AddressesResponse