@alicloud/ecs20140526 7.8.6 → 7.9.1

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 (281) hide show
  1. package/dist/client.d.ts +949 -954
  2. package/dist/client.js +978 -950
  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/CloneDisksRequest.d.ts +55 -80
  19. package/dist/models/CloneDisksRequest.js.map +1 -1
  20. package/dist/models/CloneDisksResponseBody.d.ts +2 -2
  21. package/dist/models/CreateActivationRequest.d.ts +17 -16
  22. package/dist/models/CreateActivationRequest.js.map +1 -1
  23. package/dist/models/CreateActivationResponseBody.d.ts +3 -3
  24. package/dist/models/CreateAutoProvisioningGroupRequest.d.ts +286 -380
  25. package/dist/models/CreateAutoProvisioningGroupRequest.js.map +1 -1
  26. package/dist/models/CreateAutoProvisioningGroupShrinkRequest.d.ts +282 -375
  27. package/dist/models/CreateAutoProvisioningGroupShrinkRequest.js.map +1 -1
  28. package/dist/models/CreateCommandRequest.d.ts +52 -73
  29. package/dist/models/CreateCommandRequest.js.map +1 -1
  30. package/dist/models/CreateCommandResponseBody.d.ts +2 -2
  31. package/dist/models/CreateDiskRequest.d.ts +57 -59
  32. package/dist/models/CreateDiskRequest.js.map +1 -1
  33. package/dist/models/CreateDiskResponseBody.d.ts +3 -3
  34. package/dist/models/CreateHpcClusterRequest.d.ts +5 -5
  35. package/dist/models/CreateHpcClusterResponseBody.d.ts +2 -2
  36. package/dist/models/CreateImageComponentRequest.d.ts +7 -7
  37. package/dist/models/CreateImageComponentResponseBody.d.ts +1 -1
  38. package/dist/models/CreateImageRequest.d.ts +43 -88
  39. package/dist/models/CreateImageRequest.js.map +1 -1
  40. package/dist/models/CreateImageResponseBody.d.ts +2 -2
  41. package/dist/models/CreateInstanceRequest.d.ts +184 -274
  42. package/dist/models/CreateInstanceRequest.js.map +1 -1
  43. package/dist/models/CreateInstanceResponseBody.d.ts +2 -2
  44. package/dist/models/CreateLaunchTemplateRequest.d.ts +235 -278
  45. package/dist/models/CreateLaunchTemplateRequest.js.map +1 -1
  46. package/dist/models/CreateLaunchTemplateResponseBody.d.ts +3 -3
  47. package/dist/models/CreateLaunchTemplateVersionRequest.d.ts +215 -244
  48. package/dist/models/CreateLaunchTemplateVersionRequest.js.map +1 -1
  49. package/dist/models/CreateLaunchTemplateVersionResponseBody.d.ts +2 -2
  50. package/dist/models/CreateSecurityGroupRequest.d.ts +13 -16
  51. package/dist/models/CreateSecurityGroupRequest.js.map +1 -1
  52. package/dist/models/CreateSecurityGroupResponseBody.d.ts +1 -1
  53. package/dist/models/CreateVswitchRequest.d.ts +0 -29
  54. package/dist/models/CreateVswitchRequest.js.map +1 -1
  55. package/dist/models/CreateVswitchResponseBody.d.ts +0 -8
  56. package/dist/models/CreateVswitchResponseBody.js.map +1 -1
  57. package/dist/models/DeleteHpcClusterRequest.d.ts +2 -2
  58. package/dist/models/DeleteImagePipelineRequest.d.ts +1 -1
  59. package/dist/models/DescribeAutoProvisioningGroupInstancesRequest.d.ts +5 -5
  60. package/dist/models/DescribeAutoProvisioningGroupInstancesResponseBody.d.ts +1 -1
  61. package/dist/models/DescribeAutoSnapshotPolicyExRequest.d.ts +11 -11
  62. package/dist/models/DescribeAutoSnapshotPolicyExResponseBody.d.ts +3 -3
  63. package/dist/models/DescribeAvailableResourceRequest.d.ts +50 -84
  64. package/dist/models/DescribeAvailableResourceRequest.js.map +1 -1
  65. package/dist/models/DescribeAvailableResourceResponseBody.d.ts +0 -4
  66. package/dist/models/DescribeAvailableResourceResponseBody.js.map +1 -1
  67. package/dist/models/DescribeDisksRequest.d.ts +40 -40
  68. package/dist/models/DescribeDisksResponseBody.d.ts +3 -3
  69. package/dist/models/DescribeImageComponentsRequest.d.ts +3 -3
  70. package/dist/models/DescribeImageComponentsResponseBody.d.ts +1 -1
  71. package/dist/models/DescribeImagesRequest.d.ts +61 -89
  72. package/dist/models/DescribeImagesRequest.js.map +1 -1
  73. package/dist/models/DescribeImagesResponseBody.d.ts +5 -5
  74. package/dist/models/DescribeInstanceAttributeRequest.d.ts +1 -1
  75. package/dist/models/DescribeInstanceAttributeResponseBody.d.ts +64 -96
  76. package/dist/models/DescribeInstanceAttributeResponseBody.js.map +1 -1
  77. package/dist/models/DescribeInstanceHistoryEventsRequest.d.ts +50 -85
  78. package/dist/models/DescribeInstanceHistoryEventsRequest.js.map +1 -1
  79. package/dist/models/DescribeInstanceHistoryEventsResponseBody.d.ts +16 -18
  80. package/dist/models/DescribeInstanceHistoryEventsResponseBody.js +2 -0
  81. package/dist/models/DescribeInstanceHistoryEventsResponseBody.js.map +1 -1
  82. package/dist/models/DescribeInstanceTopologyResponseBody.d.ts +14 -0
  83. package/dist/models/DescribeInstanceTopologyResponseBody.js +28 -1
  84. package/dist/models/DescribeInstanceTopologyResponseBody.js.map +1 -1
  85. package/dist/models/DescribeInstancesRequest.d.ts +54 -68
  86. package/dist/models/DescribeInstancesRequest.js.map +1 -1
  87. package/dist/models/DescribeInstancesResponseBody.d.ts +5 -5
  88. package/dist/models/DescribeInvocationResultsRequest.d.ts +52 -69
  89. package/dist/models/DescribeInvocationResultsRequest.js.map +1 -1
  90. package/dist/models/DescribeInvocationResultsResponseBody.d.ts +6 -52
  91. package/dist/models/DescribeInvocationResultsResponseBody.js.map +1 -1
  92. package/dist/models/DescribeInvocationsRequest.d.ts +49 -76
  93. package/dist/models/DescribeInvocationsRequest.js.map +1 -1
  94. package/dist/models/DescribeInvocationsResponseBody.d.ts +5 -5
  95. package/dist/models/DescribeLaunchTemplateVersionsRequest.d.ts +14 -14
  96. package/dist/models/DescribeLaunchTemplateVersionsResponseBody.d.ts +3 -3
  97. package/dist/models/DescribeNetworkInterfacePermissionsRequest.d.ts +4 -4
  98. package/dist/models/DescribePriceRequest.d.ts +158 -242
  99. package/dist/models/DescribePriceRequest.js.map +1 -1
  100. package/dist/models/DescribePriceResponseBody.d.ts +15 -15
  101. package/dist/models/DescribeRecommendInstanceTypeRequest.d.ts +45 -57
  102. package/dist/models/DescribeRecommendInstanceTypeRequest.js.map +1 -1
  103. package/dist/models/DescribeResourcesModificationRequest.d.ts +26 -37
  104. package/dist/models/DescribeResourcesModificationRequest.js.map +1 -1
  105. package/dist/models/DescribeSecurityGroupAttributeRequest.d.ts +17 -28
  106. package/dist/models/DescribeSecurityGroupAttributeRequest.js.map +1 -1
  107. package/dist/models/DescribeSecurityGroupAttributeResponseBody.d.ts +10 -9
  108. package/dist/models/DescribeSecurityGroupAttributeResponseBody.js.map +1 -1
  109. package/dist/models/DescribeSecurityGroupsRequest.d.ts +20 -20
  110. package/dist/models/DescribeSecurityGroupsResponseBody.d.ts +4 -4
  111. package/dist/models/DescribeSendFileResultsRequest.d.ts +21 -25
  112. package/dist/models/DescribeSendFileResultsRequest.js.map +1 -1
  113. package/dist/models/DescribeSendFileResultsResponseBody.d.ts +3 -3
  114. package/dist/models/DescribeSnapshotsRequest.d.ts +44 -59
  115. package/dist/models/DescribeSnapshotsRequest.js.map +1 -1
  116. package/dist/models/DescribeSnapshotsResponseBody.d.ts +4 -8
  117. package/dist/models/DescribeSnapshotsResponseBody.js.map +1 -1
  118. package/dist/models/DescribeSpotPriceHistoryRequest.d.ts +22 -28
  119. package/dist/models/DescribeSpotPriceHistoryRequest.js.map +1 -1
  120. package/dist/models/DescribeSpotPriceHistoryResponseBody.d.ts +7 -3
  121. package/dist/models/DescribeSpotPriceHistoryResponseBody.js.map +1 -1
  122. package/dist/models/DescribeTerminalSessionsRequest.d.ts +3 -3
  123. package/dist/models/DescribeTerminalSessionsResponseBody.d.ts +1 -1
  124. package/dist/models/DescribeZonesRequest.d.ts +18 -28
  125. package/dist/models/DescribeZonesRequest.js.map +1 -1
  126. package/dist/models/DescribeZonesResponseBody.d.ts +1 -1
  127. package/dist/models/GetInstanceConsoleOutputRequest.d.ts +1 -1
  128. package/dist/models/GetInstanceConsoleOutputResponseBody.d.ts +2 -2
  129. package/dist/models/ModifyHpcClusterAttributeRequest.d.ts +1 -1
  130. package/dist/models/ModifyInstanceAttributeRequest.d.ts +78 -106
  131. package/dist/models/ModifyInstanceAttributeRequest.js.map +1 -1
  132. package/dist/models/ModifyInstanceNetworkSpecRequest.d.ts +14 -14
  133. package/dist/models/ModifyInstanceNetworkSpecResponseBody.d.ts +1 -1
  134. package/dist/models/ModifyInstanceSpecRequest.d.ts +16 -16
  135. package/dist/models/ModifyPlanMaintenanceWindowRequest.d.ts +4 -4
  136. package/dist/models/ModifyPrepayInstanceSpecRequest.d.ts +28 -46
  137. package/dist/models/ModifyPrepayInstanceSpecRequest.js.map +1 -1
  138. package/dist/models/ModifyPrepayInstanceSpecResponseBody.d.ts +2 -2
  139. package/dist/models/ModifySecurityGroupEgressRuleRequest.d.ts +47 -46
  140. package/dist/models/ModifySecurityGroupEgressRuleRequest.js.map +1 -1
  141. package/dist/models/ModifySecurityGroupRuleRequest.d.ts +27 -24
  142. package/dist/models/ModifySecurityGroupRuleRequest.js.map +1 -1
  143. package/dist/models/ModifySystemEventAttributeRequest.d.ts +45 -0
  144. package/dist/models/ModifySystemEventAttributeRequest.js +64 -0
  145. package/dist/models/ModifySystemEventAttributeRequest.js.map +1 -0
  146. package/dist/models/ModifySystemEventAttributeResponse.d.ts +19 -0
  147. package/dist/models/ModifySystemEventAttributeResponse.js +69 -0
  148. package/dist/models/ModifySystemEventAttributeResponse.js.map +1 -0
  149. package/dist/models/ModifySystemEventAttributeResponseBody.d.ts +18 -0
  150. package/dist/models/ModifySystemEventAttributeResponseBody.js +58 -0
  151. package/dist/models/ModifySystemEventAttributeResponseBody.js.map +1 -0
  152. package/dist/models/RenewElasticityAssurancesRequest.d.ts +27 -23
  153. package/dist/models/RenewElasticityAssurancesRequest.js.map +1 -1
  154. package/dist/models/RenewElasticityAssurancesResponseBody.d.ts +1 -1
  155. package/dist/models/RevokeSecurityGroupEgressRequest.d.ts +35 -37
  156. package/dist/models/RevokeSecurityGroupEgressRequest.js.map +1 -1
  157. package/dist/models/RevokeSecurityGroupRequest.d.ts +71 -89
  158. package/dist/models/RevokeSecurityGroupRequest.js.map +1 -1
  159. package/dist/models/StartTerminalSessionRequest.d.ts +24 -32
  160. package/dist/models/StartTerminalSessionRequest.js.map +1 -1
  161. package/dist/models/StartTerminalSessionResponseBody.d.ts +2 -2
  162. package/dist/models/StartTerminalSessionShrinkRequest.d.ts +16 -18
  163. package/dist/models/StartTerminalSessionShrinkRequest.js.map +1 -1
  164. package/dist/models/StopInstanceRequest.d.ts +20 -27
  165. package/dist/models/StopInstanceRequest.js.map +1 -1
  166. package/dist/models/StopInstancesRequest.d.ts +24 -35
  167. package/dist/models/StopInstancesRequest.js.map +1 -1
  168. package/dist/models/UnassignIpv6addressesRequest.d.ts +3 -3
  169. package/dist/models/model.d.ts +4 -0
  170. package/dist/models/model.js +45 -37
  171. package/dist/models/model.js.map +1 -1
  172. package/package.json +1 -1
  173. package/src/client.ts +984 -950
  174. package/src/models/AcceptInquiredSystemEventRequest.ts +3 -3
  175. package/src/models/AssignIpv6addressesRequest.ts +7 -7
  176. package/src/models/AssignIpv6addressesResponseBody.ts +1 -1
  177. package/src/models/AssignPrivateIpAddressesRequest.ts +13 -16
  178. package/src/models/AssignPrivateIpAddressesResponseBody.ts +2 -2
  179. package/src/models/AttachNetworkInterfaceRequest.ts +6 -7
  180. package/src/models/AuthorizeSecurityGroupEgressRequest.ts +79 -106
  181. package/src/models/AuthorizeSecurityGroupRequest.ts +70 -91
  182. package/src/models/AuthorizeSecurityGroupResponseBody.ts +1 -1
  183. package/src/models/CancelImagePipelineExecutionRequest.ts +2 -2
  184. package/src/models/CloneDisksRequest.ts +55 -80
  185. package/src/models/CloneDisksResponseBody.ts +2 -2
  186. package/src/models/CreateActivationRequest.ts +17 -16
  187. package/src/models/CreateActivationResponseBody.ts +3 -3
  188. package/src/models/CreateAutoProvisioningGroupRequest.ts +287 -381
  189. package/src/models/CreateAutoProvisioningGroupShrinkRequest.ts +283 -376
  190. package/src/models/CreateCommandRequest.ts +52 -73
  191. package/src/models/CreateCommandResponseBody.ts +2 -2
  192. package/src/models/CreateDiskRequest.ts +57 -59
  193. package/src/models/CreateDiskResponseBody.ts +3 -3
  194. package/src/models/CreateHpcClusterRequest.ts +5 -5
  195. package/src/models/CreateHpcClusterResponseBody.ts +2 -2
  196. package/src/models/CreateImageComponentRequest.ts +7 -7
  197. package/src/models/CreateImageComponentResponseBody.ts +1 -1
  198. package/src/models/CreateImageRequest.ts +43 -88
  199. package/src/models/CreateImageResponseBody.ts +2 -2
  200. package/src/models/CreateInstanceRequest.ts +185 -275
  201. package/src/models/CreateInstanceResponseBody.ts +2 -2
  202. package/src/models/CreateLaunchTemplateRequest.ts +235 -278
  203. package/src/models/CreateLaunchTemplateResponseBody.ts +3 -3
  204. package/src/models/CreateLaunchTemplateVersionRequest.ts +215 -244
  205. package/src/models/CreateLaunchTemplateVersionResponseBody.ts +2 -2
  206. package/src/models/CreateSecurityGroupRequest.ts +13 -16
  207. package/src/models/CreateSecurityGroupResponseBody.ts +1 -1
  208. package/src/models/CreateVswitchRequest.ts +0 -29
  209. package/src/models/CreateVswitchResponseBody.ts +0 -8
  210. package/src/models/DeleteHpcClusterRequest.ts +2 -2
  211. package/src/models/DeleteImagePipelineRequest.ts +1 -1
  212. package/src/models/DescribeAutoProvisioningGroupInstancesRequest.ts +5 -5
  213. package/src/models/DescribeAutoProvisioningGroupInstancesResponseBody.ts +1 -1
  214. package/src/models/DescribeAutoSnapshotPolicyExRequest.ts +11 -11
  215. package/src/models/DescribeAutoSnapshotPolicyExResponseBody.ts +3 -3
  216. package/src/models/DescribeAvailableResourceRequest.ts +62 -96
  217. package/src/models/DescribeAvailableResourceResponseBody.ts +0 -4
  218. package/src/models/DescribeDisksRequest.ts +40 -40
  219. package/src/models/DescribeDisksResponseBody.ts +3 -3
  220. package/src/models/DescribeImageComponentsRequest.ts +3 -3
  221. package/src/models/DescribeImageComponentsResponseBody.ts +1 -1
  222. package/src/models/DescribeImagesRequest.ts +62 -90
  223. package/src/models/DescribeImagesResponseBody.ts +5 -5
  224. package/src/models/DescribeInstanceAttributeRequest.ts +1 -1
  225. package/src/models/DescribeInstanceAttributeResponseBody.ts +66 -98
  226. package/src/models/DescribeInstanceHistoryEventsRequest.ts +50 -85
  227. package/src/models/DescribeInstanceHistoryEventsResponseBody.ts +18 -18
  228. package/src/models/DescribeInstanceTopologyResponseBody.ts +32 -0
  229. package/src/models/DescribeInstancesRequest.ts +57 -71
  230. package/src/models/DescribeInstancesResponseBody.ts +5 -5
  231. package/src/models/DescribeInvocationResultsRequest.ts +52 -69
  232. package/src/models/DescribeInvocationResultsResponseBody.ts +6 -52
  233. package/src/models/DescribeInvocationsRequest.ts +50 -77
  234. package/src/models/DescribeInvocationsResponseBody.ts +5 -5
  235. package/src/models/DescribeLaunchTemplateVersionsRequest.ts +14 -14
  236. package/src/models/DescribeLaunchTemplateVersionsResponseBody.ts +3 -3
  237. package/src/models/DescribeNetworkInterfacePermissionsRequest.ts +4 -4
  238. package/src/models/DescribePriceRequest.ts +160 -244
  239. package/src/models/DescribePriceResponseBody.ts +15 -15
  240. package/src/models/DescribeRecommendInstanceTypeRequest.ts +45 -57
  241. package/src/models/DescribeResourcesModificationRequest.ts +30 -41
  242. package/src/models/DescribeSecurityGroupAttributeRequest.ts +18 -29
  243. package/src/models/DescribeSecurityGroupAttributeResponseBody.ts +11 -10
  244. package/src/models/DescribeSecurityGroupsRequest.ts +21 -21
  245. package/src/models/DescribeSecurityGroupsResponseBody.ts +4 -4
  246. package/src/models/DescribeSendFileResultsRequest.ts +21 -25
  247. package/src/models/DescribeSendFileResultsResponseBody.ts +3 -3
  248. package/src/models/DescribeSnapshotsRequest.ts +48 -63
  249. package/src/models/DescribeSnapshotsResponseBody.ts +4 -8
  250. package/src/models/DescribeSpotPriceHistoryRequest.ts +22 -28
  251. package/src/models/DescribeSpotPriceHistoryResponseBody.ts +7 -3
  252. package/src/models/DescribeTerminalSessionsRequest.ts +3 -3
  253. package/src/models/DescribeTerminalSessionsResponseBody.ts +1 -1
  254. package/src/models/DescribeZonesRequest.ts +20 -30
  255. package/src/models/DescribeZonesResponseBody.ts +1 -1
  256. package/src/models/GetInstanceConsoleOutputRequest.ts +1 -1
  257. package/src/models/GetInstanceConsoleOutputResponseBody.ts +2 -2
  258. package/src/models/ModifyHpcClusterAttributeRequest.ts +1 -1
  259. package/src/models/ModifyInstanceAttributeRequest.ts +80 -108
  260. package/src/models/ModifyInstanceNetworkSpecRequest.ts +14 -14
  261. package/src/models/ModifyInstanceNetworkSpecResponseBody.ts +1 -1
  262. package/src/models/ModifyInstanceSpecRequest.ts +16 -16
  263. package/src/models/ModifyPlanMaintenanceWindowRequest.ts +4 -4
  264. package/src/models/ModifyPrepayInstanceSpecRequest.ts +28 -46
  265. package/src/models/ModifyPrepayInstanceSpecResponseBody.ts +2 -2
  266. package/src/models/ModifySecurityGroupEgressRuleRequest.ts +47 -46
  267. package/src/models/ModifySecurityGroupRuleRequest.ts +27 -24
  268. package/src/models/ModifySystemEventAttributeRequest.ts +64 -0
  269. package/src/models/ModifySystemEventAttributeResponse.ts +40 -0
  270. package/src/models/ModifySystemEventAttributeResponseBody.ts +31 -0
  271. package/src/models/RenewElasticityAssurancesRequest.ts +27 -23
  272. package/src/models/RenewElasticityAssurancesResponseBody.ts +1 -1
  273. package/src/models/RevokeSecurityGroupEgressRequest.ts +35 -37
  274. package/src/models/RevokeSecurityGroupRequest.ts +75 -93
  275. package/src/models/StartTerminalSessionRequest.ts +24 -32
  276. package/src/models/StartTerminalSessionResponseBody.ts +2 -2
  277. package/src/models/StartTerminalSessionShrinkRequest.ts +16 -18
  278. package/src/models/StopInstanceRequest.ts +21 -28
  279. package/src/models/StopInstancesRequest.ts +25 -36
  280. package/src/models/UnassignIpv6addressesRequest.ts +3 -3
  281. package/src/models/model.ts +4 -0
package/dist/client.js CHANGED
@@ -137,7 +137,7 @@ class Client extends openapi_core_1.default {
137
137
  return openapi_core_2.OpenApiUtil.getEndpointRules(productId, regionId, endpointRule, network, suffix);
138
138
  }
139
139
  /**
140
- * 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.
140
+ * 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.
141
141
  *
142
142
  * @param request - AcceptInquiredSystemEventRequest
143
143
  * @param runtime - runtime options for this request RuntimeOptions
@@ -187,7 +187,7 @@ class Client extends openapi_core_1.default {
187
187
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.AcceptInquiredSystemEventResponse({}));
188
188
  }
189
189
  /**
190
- * 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.
190
+ * 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.
191
191
  *
192
192
  * @param request - AcceptInquiredSystemEventRequest
193
193
  * @returns AcceptInquiredSystemEventResponse
@@ -746,9 +746,9 @@ class Client extends openapi_core_1.default {
746
746
  * 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:
747
747
  * - 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).
748
748
  * - The ENI must be in the Active (Available) or InUse state.
749
- * - When you operate on a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
750
- * - 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.
751
- * - If the ENI is in the Active (Available) state, up to 10 IPv6 addresses can be allocated.
749
+ * - 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.
750
+ * - 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.
751
+ * - If the ENI is in the Active (Available) state, you can allocate up to 10 IPv6 addresses to it.
752
752
  * - 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).
753
753
  * - After you successfully invoke this operation, you can obtain the allocated IPv6 address information from the response.
754
754
  *
@@ -819,9 +819,9 @@ class Client extends openapi_core_1.default {
819
819
  * 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:
820
820
  * - 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).
821
821
  * - The ENI must be in the Active (Available) or InUse state.
822
- * - When you operate on a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
823
- * - 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.
824
- * - If the ENI is in the Active (Available) state, up to 10 IPv6 addresses can be allocated.
822
+ * - 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.
823
+ * - 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.
824
+ * - If the ENI is in the Active (Available) state, you can allocate up to 10 IPv6 addresses to it.
825
825
  * - 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).
826
826
  * - After you successfully invoke this operation, you can obtain the allocated IPv6 address information from the response.
827
827
  *
@@ -833,14 +833,14 @@ class Client extends openapi_core_1.default {
833
833
  return await this.assignIpv6AddressesWithOptions(request, runtime);
834
834
  }
835
835
  /**
836
- * 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.
836
+ * 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.
837
837
  *
838
838
  * @remarks
839
- * ## [](#)Usage notes
840
- * - The ENI to which you want to assign IP prefixes must be in the Available (Available) or InUse (InUse) state.
841
- * - 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.
842
- * - 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).
843
- * - After the operation is called, you can obtain the assigned secondary private IP addresses from the response.
839
+ * ## Operation description
840
+ * - Only ENIs in the Available or InUse state are supported.
841
+ * - When you operate a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
842
+ * - 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).
843
+ * - After you call this operation, you can obtain the allocated secondary private IP address information from the response.
844
844
  *
845
845
  * @param request - AssignPrivateIpAddressesRequest
846
846
  * @param runtime - runtime options for this request RuntimeOptions
@@ -902,14 +902,14 @@ class Client extends openapi_core_1.default {
902
902
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.AssignPrivateIpAddressesResponse({}));
903
903
  }
904
904
  /**
905
- * 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.
905
+ * 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.
906
906
  *
907
907
  * @remarks
908
- * ## [](#)Usage notes
909
- * - The ENI to which you want to assign IP prefixes must be in the Available (Available) or InUse (InUse) state.
910
- * - 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.
911
- * - 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).
912
- * - After the operation is called, you can obtain the assigned secondary private IP addresses from the response.
908
+ * ## Operation description
909
+ * - Only ENIs in the Available or InUse state are supported.
910
+ * - When you operate a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
911
+ * - 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).
912
+ * - After you call this operation, you can obtain the allocated secondary private IP address information from the response.
913
913
  *
914
914
  * @param request - AssignPrivateIpAddressesRequest
915
915
  * @returns AssignPrivateIpAddressesResponse
@@ -1356,21 +1356,22 @@ class Client extends openapi_core_1.default {
1356
1356
  return await this.attachKeyPairWithOptions(request, runtime);
1357
1357
  }
1358
1358
  /**
1359
- * 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.
1359
+ * 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.
1360
1360
  *
1361
1361
  * @remarks
1362
- * Take note of the following items:
1363
- * - 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.
1364
- * - 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.
1365
- * > 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.
1366
- * - You can attach multiple ENIs to one instance. For more information, see [ENI overview](https://help.aliyun.com/document_detail/58496.html).
1367
- * - 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.
1368
- * - 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.
1369
- * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/en-US/20230223/vqky/AttachNetworkInterface.png)
1370
- * * If the ENI is in the Attaching state, the ENI attachment request is sent and the ENI is being attached to the specified instance.
1371
- * * If the ENI is in the InUse state, the ENI is attached to the specified instance.
1372
- * * If the ENI is in the Available state, the ENI failed to be attached.
1373
- * **For examples on how to call this operation, see** [Attach an ENI](https://help.aliyun.com/document_detail/471550.html).
1362
+ * When you call this operation, take note of the following items:
1363
+ * - 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).
1364
+ * - 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).
1365
+ * > 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.
1366
+ * - 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).
1367
+ *
1368
+ * - The vSwitch to which the network interface controller (NIC) belongs must be in the same zone and VPC as the instance.
1369
+ * - 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:
1370
+ * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221124/esgu/AttachNetworkInterface.jpg)
1371
+ * - Attaching indicates that the request to attach the ENI was sent successfully and the ENI is being attached to the ECS instance.
1372
+ * - InUse indicates that the ENI has been attached to the ECS instance.
1373
+ * - Available indicates that the ENI failed to be attached to the ECS instance.
1374
+ * **For details, see** [Attach a network interface controller (NIC)](https://help.aliyun.com/document_detail/471550.html).
1374
1375
  *
1375
1376
  * @param request - AttachNetworkInterfaceRequest
1376
1377
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1429,21 +1430,22 @@ class Client extends openapi_core_1.default {
1429
1430
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.AttachNetworkInterfaceResponse({}));
1430
1431
  }
1431
1432
  /**
1432
- * 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.
1433
+ * 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.
1433
1434
  *
1434
1435
  * @remarks
1435
- * Take note of the following items:
1436
- * - 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.
1437
- * - 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.
1438
- * > 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.
1439
- * - You can attach multiple ENIs to one instance. For more information, see [ENI overview](https://help.aliyun.com/document_detail/58496.html).
1440
- * - 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.
1441
- * - 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.
1442
- * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/en-US/20230223/vqky/AttachNetworkInterface.png)
1443
- * * If the ENI is in the Attaching state, the ENI attachment request is sent and the ENI is being attached to the specified instance.
1444
- * * If the ENI is in the InUse state, the ENI is attached to the specified instance.
1445
- * * If the ENI is in the Available state, the ENI failed to be attached.
1446
- * **For examples on how to call this operation, see** [Attach an ENI](https://help.aliyun.com/document_detail/471550.html).
1436
+ * When you call this operation, take note of the following items:
1437
+ * - 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).
1438
+ * - 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).
1439
+ * > 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.
1440
+ * - 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).
1441
+ *
1442
+ * - The vSwitch to which the network interface controller (NIC) belongs must be in the same zone and VPC as the instance.
1443
+ * - 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:
1444
+ * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221124/esgu/AttachNetworkInterface.jpg)
1445
+ * - Attaching indicates that the request to attach the ENI was sent successfully and the ENI is being attached to the ECS instance.
1446
+ * - InUse indicates that the ENI has been attached to the ECS instance.
1447
+ * - Available indicates that the ENI failed to be attached to the ECS instance.
1448
+ * **For details, see** [Attach a network interface controller (NIC)](https://help.aliyun.com/document_detail/471550.html).
1447
1449
  *
1448
1450
  * @param request - AttachNetworkInterfaceRequest
1449
1451
  * @returns AttachNetworkInterfaceResponse
@@ -1453,54 +1455,54 @@ class Client extends openapi_core_1.default {
1453
1455
  return await this.attachNetworkInterfaceWithOptions(request, runtime);
1454
1456
  }
1455
1457
  /**
1456
- * 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.
1458
+ * 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.
1457
1459
  *
1458
1460
  * @remarks
1459
- * ### 使用须知
1460
- * - **数量限制:** 单张弹性网卡关联的所有安全组的规则(包括入方向规则与出方向规则)数量之和不能超过 1000。具体限制请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
1461
- * - **优先级设置:** 安全组入方向规则优先级(Priority)可选范围为 1\\~100。数字越小,代表优先级越高,优先级相同的安全组规则,优先以拒绝访问(drop)的规则为准。
1462
- * ### 注意事项
1463
- * 如果指定的安全组规则已存在,此次调用成功,但不会增加规则。
1464
- * ### 规则确定方式
1465
- * 确定一条安全组入方向规则必要的一组相关参数:
1466
- * - 源端设置:选择 SourceCidrIpIPv4 地址)、Ipv6SourceCidrIpIPv6 地址)、SourcetPrefixListId(前缀列表 ID)、SourceGroupId(源端安全组)中的一项。
1467
- * - 目的端口范围:PortRange
1468
- * - 协议类型:IpProtocol
1469
- * - 权限策略:Policy
1470
- * > 企业安全组不支持授权其他安全组访问,普通安全组支持授权的安全组数量最多为 20 个。
1471
- * ### 请求示例
1472
- * 假设要在杭州地域下指定安全组中增加几条不同源端的入方向规则:
1473
- * - 增加指定 IP 地址段的访问权限。
1474
- * ```
1475
- * "RegionId":"cn-hangzhou", //设置地域
1476
- * "SecurityGroupId":"sg-bp67acfmxazb4p****", //设置安全组
1477
- * "Permissions":[
1478
- * {
1479
- * "SourceCidrIp":"10.0.0.0/8", //设置源端 IPv4 地址
1480
- * "PortRange":"22/22", //设置端口范围
1481
- * "IpProtocol":"TCP", //设置协议类型
1482
- * "Policy":"Accept" //设置访问策略
1483
- * }
1484
- * ]
1485
- * ```
1486
- * - 增加一条其他安全组和一条前缀列表的访问权限。
1487
- * ```
1488
- * "RegionId":"cn-hangzhou",
1489
- * "SecurityGroupId":"sg-bp67acfmxazb4p****",
1490
- * "Permissions":[
1491
- * {
1492
- * "SourceGroupId":"sg-bp17vs63txqxbd****", //设置源端安全组
1493
- * "PortRange":"22/22",
1494
- * "IpProtocol":"TCP",
1495
- * "Policy":"Drop"
1496
- * },{
1497
- * "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置源端前缀列表
1498
- * "PortRange":"22/22",
1499
- * "IpProtocol":"TCP",
1500
- * "Policy":"Drop"
1501
- * }
1502
- * ]
1503
- * ```
1461
+ * ### Before you begin
1462
+ * - **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~~).
1463
+ * - **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.
1464
+ * ### Notes
1465
+ * If the specified security group rule already exists, the call succeeds but no rule is added.
1466
+ * ### How to determine a rule
1467
+ * The following parameters are required to determine an inbound security group rule:
1468
+ * - Source settings: Specify one of the following: SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
1469
+ * - Destination port range: PortRange.
1470
+ * - Protocol type: IpProtocol.
1471
+ * - Access policy: Policy.
1472
+ * > Advanced security groups do not support authorization for access from other security groups. Basic security groups support a maximum of 20 authorized security groups.
1473
+ * ### Request examples
1474
+ * The following examples show how to add inbound rules with different sources to a security group in the China (Hangzhou) region:
1475
+ * - Add access permissions for a specified IP address range.
1476
+ * ```
1477
+ * "RegionId":"cn-hangzhou", // Specify the region.
1478
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group.
1479
+ * "Permissions":[
1480
+ * {
1481
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IPv4 address.
1482
+ * "PortRange":"22/22", // Specify the port range.
1483
+ * "IpProtocol":"TCP", // Specify the protocol type.
1484
+ * "Policy":"Accept" // Specify the access policy.
1485
+ * }
1486
+ * ]
1487
+ * ```
1488
+ * - Add access permissions for another security group and a prefix list.
1489
+ * ```
1490
+ * "RegionId":"cn-hangzhou",
1491
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****",
1492
+ * "Permissions":[
1493
+ * {
1494
+ * "SourceGroupId":"sg-bp17vs63txqxbd****", // Specify the source security group.
1495
+ * "PortRange":"22/22",
1496
+ * "IpProtocol":"TCP",
1497
+ * "Policy":"Drop"
1498
+ * },{
1499
+ * "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list.
1500
+ * "PortRange":"22/22",
1501
+ * "IpProtocol":"TCP",
1502
+ * "Policy":"Drop"
1503
+ * }
1504
+ * ]
1505
+ * ```
1504
1506
  *
1505
1507
  * @param request - AuthorizeSecurityGroupRequest
1506
1508
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1607,54 +1609,54 @@ class Client extends openapi_core_1.default {
1607
1609
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.AuthorizeSecurityGroupResponse({}));
1608
1610
  }
1609
1611
  /**
1610
- * 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.
1612
+ * 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.
1611
1613
  *
1612
1614
  * @remarks
1613
- * ### 使用须知
1614
- * - **数量限制:** 单张弹性网卡关联的所有安全组的规则(包括入方向规则与出方向规则)数量之和不能超过 1000。具体限制请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
1615
- * - **优先级设置:** 安全组入方向规则优先级(Priority)可选范围为 1\\~100。数字越小,代表优先级越高,优先级相同的安全组规则,优先以拒绝访问(drop)的规则为准。
1616
- * ### 注意事项
1617
- * 如果指定的安全组规则已存在,此次调用成功,但不会增加规则。
1618
- * ### 规则确定方式
1619
- * 确定一条安全组入方向规则必要的一组相关参数:
1620
- * - 源端设置:选择 SourceCidrIpIPv4 地址)、Ipv6SourceCidrIpIPv6 地址)、SourcetPrefixListId(前缀列表 ID)、SourceGroupId(源端安全组)中的一项。
1621
- * - 目的端口范围:PortRange
1622
- * - 协议类型:IpProtocol
1623
- * - 权限策略:Policy
1624
- * > 企业安全组不支持授权其他安全组访问,普通安全组支持授权的安全组数量最多为 20 个。
1625
- * ### 请求示例
1626
- * 假设要在杭州地域下指定安全组中增加几条不同源端的入方向规则:
1627
- * - 增加指定 IP 地址段的访问权限。
1628
- * ```
1629
- * "RegionId":"cn-hangzhou", //设置地域
1630
- * "SecurityGroupId":"sg-bp67acfmxazb4p****", //设置安全组
1631
- * "Permissions":[
1632
- * {
1633
- * "SourceCidrIp":"10.0.0.0/8", //设置源端 IPv4 地址
1634
- * "PortRange":"22/22", //设置端口范围
1635
- * "IpProtocol":"TCP", //设置协议类型
1636
- * "Policy":"Accept" //设置访问策略
1637
- * }
1638
- * ]
1639
- * ```
1640
- * - 增加一条其他安全组和一条前缀列表的访问权限。
1641
- * ```
1642
- * "RegionId":"cn-hangzhou",
1643
- * "SecurityGroupId":"sg-bp67acfmxazb4p****",
1644
- * "Permissions":[
1645
- * {
1646
- * "SourceGroupId":"sg-bp17vs63txqxbd****", //设置源端安全组
1647
- * "PortRange":"22/22",
1648
- * "IpProtocol":"TCP",
1649
- * "Policy":"Drop"
1650
- * },{
1651
- * "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置源端前缀列表
1652
- * "PortRange":"22/22",
1653
- * "IpProtocol":"TCP",
1654
- * "Policy":"Drop"
1655
- * }
1656
- * ]
1657
- * ```
1615
+ * ### Before you begin
1616
+ * - **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~~).
1617
+ * - **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.
1618
+ * ### Notes
1619
+ * If the specified security group rule already exists, the call succeeds but no rule is added.
1620
+ * ### How to determine a rule
1621
+ * The following parameters are required to determine an inbound security group rule:
1622
+ * - Source settings: Specify one of the following: SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
1623
+ * - Destination port range: PortRange.
1624
+ * - Protocol type: IpProtocol.
1625
+ * - Access policy: Policy.
1626
+ * > Advanced security groups do not support authorization for access from other security groups. Basic security groups support a maximum of 20 authorized security groups.
1627
+ * ### Request examples
1628
+ * The following examples show how to add inbound rules with different sources to a security group in the China (Hangzhou) region:
1629
+ * - Add access permissions for a specified IP address range.
1630
+ * ```
1631
+ * "RegionId":"cn-hangzhou", // Specify the region.
1632
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group.
1633
+ * "Permissions":[
1634
+ * {
1635
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IPv4 address.
1636
+ * "PortRange":"22/22", // Specify the port range.
1637
+ * "IpProtocol":"TCP", // Specify the protocol type.
1638
+ * "Policy":"Accept" // Specify the access policy.
1639
+ * }
1640
+ * ]
1641
+ * ```
1642
+ * - Add access permissions for another security group and a prefix list.
1643
+ * ```
1644
+ * "RegionId":"cn-hangzhou",
1645
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****",
1646
+ * "Permissions":[
1647
+ * {
1648
+ * "SourceGroupId":"sg-bp17vs63txqxbd****", // Specify the source security group.
1649
+ * "PortRange":"22/22",
1650
+ * "IpProtocol":"TCP",
1651
+ * "Policy":"Drop"
1652
+ * },{
1653
+ * "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list.
1654
+ * "PortRange":"22/22",
1655
+ * "IpProtocol":"TCP",
1656
+ * "Policy":"Drop"
1657
+ * }
1658
+ * ]
1659
+ * ```
1658
1660
  *
1659
1661
  * @param request - AuthorizeSecurityGroupRequest
1660
1662
  * @returns AuthorizeSecurityGroupResponse
@@ -1664,54 +1666,54 @@ class Client extends openapi_core_1.default {
1664
1666
  return await this.authorizeSecurityGroupWithOptions(request, runtime);
1665
1667
  }
1666
1668
  /**
1667
- * 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.
1669
+ * 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.
1668
1670
  *
1669
1671
  * @remarks
1670
- * ### 使用须知
1671
- * - **数量限制:** 单张弹性网卡关联的所有安全组的规则(包括入方向规则与出方向规则)数量之和不能超过 1000。具体限制请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
1672
- * - **优先级设置:** 安全组出方向规则优先级(Priority)可选范围为 1\\~100。数字越小,代表优先级越高,优先级相同的安全组规则,优先以拒绝访问(drop)的规则为准。
1673
- * ### 注意事项
1674
- * 如果指定的安全组规则已存在,此次调用成功,但不会增加规则。
1675
- * ### 规则确定方式
1676
- * 确定一条安全组出方向规则必要的一组相关参数:
1677
- * - 目的端设置:选择 DestCidrIpIPv4 地址)、Ipv6DestCidrIpIPv6 地址)、DestPrefixListId(前缀列表 ID)、DestGroupId(目的端安全组)中的一项。
1678
- * - 目的端口范围:PortRange
1679
- * - 协议类型:IpProtocol
1680
- * - 权限策略:Policy
1681
- * > 企业安全组不支持授权其他安全组访问,普通安全组支持授权的安全组数量最多为 20 个。
1682
- * ### 请求示例
1683
- * 假设要在杭州地域下指定安全组中增加几条不同目的端的出方向规则:
1684
- * - 增加指定 IP 地址段的访问权限。
1685
- * ```
1686
- * "RegionId":"cn-hangzhou", //设置地域
1687
- * "SecurityGroupId":"sg-bp17vs63txqxbds9***", //设置安全组
1688
- * "Permissions":[
1689
- * {
1690
- * "DestCidrIp":"10.0.0.0/8", //设置目的端 IPv4 地址
1691
- * "PortRange":"-1/-1", //设置端口范围
1692
- * "IpProtocol":"ICMP", //设置协议类型
1693
- * "Policy":"Accept" //设置访问策略
1694
- * }
1695
- * ]
1696
- * ```
1697
- * - 增加一条其他安全组和一条前缀列表的访问权限。
1698
- * ```
1699
- * "RegionId":"cn-hangzhou",
1700
- * "SecurityGroupId":"sg-bp17vs63txqxbds9***",
1701
- * "Permissions":[
1702
- * {
1703
- * "DestGroupId":"sg-bp67acfmxazb4pi***", //设置目的端安全组
1704
- * "PortRange":"22/22",
1705
- * "IpProtocol":"TCP",
1706
- * "Policy":"Drop"
1707
- * },{
1708
- * "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置目的端前缀列表
1709
- * "PortRange":"22/22",
1710
- * "IpProtocol":"TCP",
1711
- * "Policy":"Drop"
1712
- * }
1713
- * ]
1714
- * ```
1672
+ * ### Before you begin
1673
+ * - **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~~).
1674
+ * - **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.
1675
+ * ### Notes
1676
+ * If the specified security group rule already exists, the call succeeds but no rule is added.
1677
+ * ### How to determine a rule
1678
+ * The following parameters are required to determine an outbound rule:
1679
+ * - Destination settings: Specify one of the following: DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
1680
+ * - Destination port range: PortRange.
1681
+ * - Protocol type: IpProtocol.
1682
+ * - Access policy: Policy.
1683
+ * > Advanced security groups do not support authorization of other security groups for access. Custom security groups support a maximum of 20 authorized security groups.
1684
+ * ### Request examples
1685
+ * The following examples show how to add outbound rules with different destinations to a security group in the China (Hangzhou) region:
1686
+ * - Add access permissions for a specified IP address range.
1687
+ * ```
1688
+ * "RegionId":"ap-southeast-1", // Specify the region.
1689
+ * "SecurityGroupId":"sg-bp17vs63txqxbds9***", // Specify the security group.
1690
+ * "Permissions":[
1691
+ * {
1692
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IPv4 address.
1693
+ * "PortRange":"-1/-1", // Specify the port range.
1694
+ * "IpProtocol":"ICMP", // Specify the protocol type.
1695
+ * "Policy":"Accept" // Specify the access policy.
1696
+ * }
1697
+ * ]
1698
+ * ```
1699
+ * - Add access permissions for another security group and a prefix list.
1700
+ * ```
1701
+ * "RegionId":"ap-southeast-1",
1702
+ * "SecurityGroupId":"sg-bp17vs63txqxbds9***",
1703
+ * "Permissions":[
1704
+ * {
1705
+ * "DestGroupId":"sg-bp67acfmxazb4pi***", // Specify the destination security group.
1706
+ * "PortRange":"22/22",
1707
+ * "IpProtocol":"TCP",
1708
+ * "Policy":"Drop"
1709
+ * },{
1710
+ * "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", // Specify the destination prefix list.
1711
+ * "PortRange":"22/22",
1712
+ * "IpProtocol":"TCP",
1713
+ * "Policy":"Drop"
1714
+ * }
1715
+ * ]
1716
+ * ```
1715
1717
  *
1716
1718
  * @param request - AuthorizeSecurityGroupEgressRequest
1717
1719
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1818,54 +1820,54 @@ class Client extends openapi_core_1.default {
1818
1820
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.AuthorizeSecurityGroupEgressResponse({}));
1819
1821
  }
1820
1822
  /**
1821
- * 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.
1823
+ * 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.
1822
1824
  *
1823
1825
  * @remarks
1824
- * ### 使用须知
1825
- * - **数量限制:** 单张弹性网卡关联的所有安全组的规则(包括入方向规则与出方向规则)数量之和不能超过 1000。具体限制请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
1826
- * - **优先级设置:** 安全组出方向规则优先级(Priority)可选范围为 1\\~100。数字越小,代表优先级越高,优先级相同的安全组规则,优先以拒绝访问(drop)的规则为准。
1827
- * ### 注意事项
1828
- * 如果指定的安全组规则已存在,此次调用成功,但不会增加规则。
1829
- * ### 规则确定方式
1830
- * 确定一条安全组出方向规则必要的一组相关参数:
1831
- * - 目的端设置:选择 DestCidrIpIPv4 地址)、Ipv6DestCidrIpIPv6 地址)、DestPrefixListId(前缀列表 ID)、DestGroupId(目的端安全组)中的一项。
1832
- * - 目的端口范围:PortRange
1833
- * - 协议类型:IpProtocol
1834
- * - 权限策略:Policy
1835
- * > 企业安全组不支持授权其他安全组访问,普通安全组支持授权的安全组数量最多为 20 个。
1836
- * ### 请求示例
1837
- * 假设要在杭州地域下指定安全组中增加几条不同目的端的出方向规则:
1838
- * - 增加指定 IP 地址段的访问权限。
1839
- * ```
1840
- * "RegionId":"cn-hangzhou", //设置地域
1841
- * "SecurityGroupId":"sg-bp17vs63txqxbds9***", //设置安全组
1842
- * "Permissions":[
1843
- * {
1844
- * "DestCidrIp":"10.0.0.0/8", //设置目的端 IPv4 地址
1845
- * "PortRange":"-1/-1", //设置端口范围
1846
- * "IpProtocol":"ICMP", //设置协议类型
1847
- * "Policy":"Accept" //设置访问策略
1848
- * }
1849
- * ]
1850
- * ```
1851
- * - 增加一条其他安全组和一条前缀列表的访问权限。
1852
- * ```
1853
- * "RegionId":"cn-hangzhou",
1854
- * "SecurityGroupId":"sg-bp17vs63txqxbds9***",
1855
- * "Permissions":[
1856
- * {
1857
- * "DestGroupId":"sg-bp67acfmxazb4pi***", //设置目的端安全组
1858
- * "PortRange":"22/22",
1859
- * "IpProtocol":"TCP",
1860
- * "Policy":"Drop"
1861
- * },{
1862
- * "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置目的端前缀列表
1863
- * "PortRange":"22/22",
1864
- * "IpProtocol":"TCP",
1865
- * "Policy":"Drop"
1866
- * }
1867
- * ]
1868
- * ```
1826
+ * ### Before you begin
1827
+ * - **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~~).
1828
+ * - **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.
1829
+ * ### Notes
1830
+ * If the specified security group rule already exists, the call succeeds but no rule is added.
1831
+ * ### How to determine a rule
1832
+ * The following parameters are required to determine an outbound rule:
1833
+ * - Destination settings: Specify one of the following: DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
1834
+ * - Destination port range: PortRange.
1835
+ * - Protocol type: IpProtocol.
1836
+ * - Access policy: Policy.
1837
+ * > Advanced security groups do not support authorization of other security groups for access. Custom security groups support a maximum of 20 authorized security groups.
1838
+ * ### Request examples
1839
+ * The following examples show how to add outbound rules with different destinations to a security group in the China (Hangzhou) region:
1840
+ * - Add access permissions for a specified IP address range.
1841
+ * ```
1842
+ * "RegionId":"ap-southeast-1", // Specify the region.
1843
+ * "SecurityGroupId":"sg-bp17vs63txqxbds9***", // Specify the security group.
1844
+ * "Permissions":[
1845
+ * {
1846
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IPv4 address.
1847
+ * "PortRange":"-1/-1", // Specify the port range.
1848
+ * "IpProtocol":"ICMP", // Specify the protocol type.
1849
+ * "Policy":"Accept" // Specify the access policy.
1850
+ * }
1851
+ * ]
1852
+ * ```
1853
+ * - Add access permissions for another security group and a prefix list.
1854
+ * ```
1855
+ * "RegionId":"ap-southeast-1",
1856
+ * "SecurityGroupId":"sg-bp17vs63txqxbds9***",
1857
+ * "Permissions":[
1858
+ * {
1859
+ * "DestGroupId":"sg-bp67acfmxazb4pi***", // Specify the destination security group.
1860
+ * "PortRange":"22/22",
1861
+ * "IpProtocol":"TCP",
1862
+ * "Policy":"Drop"
1863
+ * },{
1864
+ * "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", // Specify the destination prefix list.
1865
+ * "PortRange":"22/22",
1866
+ * "IpProtocol":"TCP",
1867
+ * "Policy":"Drop"
1868
+ * }
1869
+ * ]
1870
+ * ```
1869
1871
  *
1870
1872
  * @param request - AuthorizeSecurityGroupEgressRequest
1871
1873
  * @returns AuthorizeSecurityGroupEgressResponse
@@ -1993,10 +1995,10 @@ class Client extends openapi_core_1.default {
1993
1995
  return await this.cancelCopyImageWithOptions(request, runtime);
1994
1996
  }
1995
1997
  /**
1996
- * Cancels an image building task.
1998
+ * Cancels an image build task.
1997
1999
  *
1998
2000
  * @remarks
1999
- * Before you call the CancelImagePipelineExecution operation, make sure that the image building task to be canceled is in the BUILDING, PREPARING, or REPAIRING state.
2001
+ * Before you call this operation, make sure that the image build task you want to cancel is in the PREPARING, REPAIRING, or BUILDING state.
2000
2002
  *
2001
2003
  * @param request - CancelImagePipelineExecutionRequest
2002
2004
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2046,10 +2048,10 @@ class Client extends openapi_core_1.default {
2046
2048
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CancelImagePipelineExecutionResponse({}));
2047
2049
  }
2048
2050
  /**
2049
- * Cancels an image building task.
2051
+ * Cancels an image build task.
2050
2052
  *
2051
2053
  * @remarks
2052
- * Before you call the CancelImagePipelineExecution operation, make sure that the image building task to be canceled is in the BUILDING, PREPARING, or REPAIRING state.
2054
+ * Before you call this operation, make sure that the image build task you want to cancel is in the PREPARING, REPAIRING, or BUILDING state.
2053
2055
  *
2054
2056
  * @param request - CancelImagePipelineExecutionRequest
2055
2057
  * @returns CancelImagePipelineExecutionResponse
@@ -2232,29 +2234,29 @@ class Client extends openapi_core_1.default {
2232
2234
  return await this.cancelTaskWithOptions(request, runtime);
2233
2235
  }
2234
2236
  /**
2235
- * Cloud disk cloning allows you to quickly create a new cloud disk in the same availability zone containing the same data as the source disk. You can customize the new disk\\"s capacity, type, and encryption attributes. After attaching the disk to an instance, you can use it to rapidly replicate business data or scale your services horizontally.
2237
+ * Disk cloning allows you to quickly create a new disk with the same data as the source disk in the same zone. The new disk supports custom capacity, type, and encryption attributes. After the new disk is attached to an instance, you can quickly replicate business data or horizontally scale your services.
2236
2238
  *
2237
2239
  * @remarks
2238
- * > The cloud disk cloning feature is free. However, the resulting destination disk is billed based on block storage rules. Charges vary by disk type and can include capacity, provisioned performance, and burst performance. Billing for all items begins at creation—except for burst performance fees, which are charged only after a burst occurs—and applies regardless of whether the disk is attached to an instance.
2239
- * ### Usage
2240
- * - This is an asynchronous operation. After a successful call, call the DescribeTasks operation with the returned taskGroupId to query the task\\"s status.
2240
+ * > The disk cloning feature itself is free of charge, but the new disk generated by cloning is billed based on block storage billing rules. Billable items vary by disk type and include disk capacity fees, provisioned performance fees, and performance burst fees. Except for performance burst fees, which are billed after a burst occurs, all other fees start to accrue after the disk is created, regardless of whether the disk is attached to an instance.
2241
+ * ### How to use
2242
+ * - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to obtain the execution result.
2241
2243
  * ### Features
2242
- * - You can only clone ESSD cloud disks (cloud_essd, cloud_auto, cloud_essd_entry, and cloud_regional_disk_auto) to create a `destination disk`, which must also be an ESSD type.
2243
- * - A non-zone-redundant cloud disk can only be cloned to a non-zone-redundant disk. A zone-redundant cloud disk can only be cloned to another zone-redundant cloud disk.
2244
- * - Local disks and elastic ephemeral disks do not support cloning and cannot be used as either a source disk or a destination disk.
2245
- * - You can specify the type and performance level for the `destination disk`.
2246
- * - You can specify the capacity for the `destination disk`, but its capacity must be greater than or equal to that of the `source disk`.
2247
- * - You can configure provisioned performance and burst performance for the `destination disk`, provided that the destination disk type supports these features.
2248
- * - You can enable encryption and change the encryption key for the `destination disk`. If the `source disk` is encrypted, the destination disk must also be encrypted. However, you can use a different encryption key.
2249
- * - You can use a subscription cloud disk as the `source disk`. The disk can still be used as a `source disk` even after its subscription expires.
2250
- * - A `destination disk` created by cloning cannot be re-initialized.
2251
- * - While you cannot clone entire storage sets or dedicated storage clusters, you can use a disk from within them as a `source disk`. The resulting destination disk is a standalone disk and will not belong to the original storage set or cluster.
2252
- * - `source disk` status requirements
2253
- * - The `source disk` must be "In Use", and its attached instance must be "Running" or "Stopped".
2254
- * - The `source disk` must be "Available" and have been attached to an instance at least once.
2255
- * - A disk undergoing a configuration modification cannot be used as a `source disk`.
2256
- * - A disk that is being scaled up cannot be used as a `source disk`.
2257
- * - As cloud disk cloning is not supported for hibernated instances, a disk attached to a hibernated instance cannot be used as a `source disk`.
2244
+ * - Cloning supports only ESSD series disks (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) as the source, and the `new disk` can only be an ESSD series disk type.
2245
+ * - Non-regional disks can only be cloned to non-regional disk types. Regional disks can only be cloned to regional disk types.
2246
+ * - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
2247
+ * - You can specify the `new disk` type and performance level (PL) during cloning.
2248
+ * - You can specify the `new disk` capacity during cloning, but the new disk capacity must be greater than or equal to the `source disk` capacity.
2249
+ * - You can configure provisioned performance and performance burst for the `new disk`, provided that the destination disk type supports provisioned performance and performance burst.
2250
+ * - You can specify encryption for the `new disk` and change the encryption key. If the `source disk` is encrypted, you cannot clone it into an unencrypted disk, but you can change the encryption key.
2251
+ * - You can use a subscription disk as the `source disk`. Even if the subscription disk has expired, it can still be used as the `source disk`.
2252
+ * - The `new disk` created by cloning does not support reinitialization.
2253
+ * - Cloning does not support storage sets or dedicated block storage clusters, but disks in them can be used as the `source disk`. The cloned disk will not be in the storage set or dedicated block storage cluster.
2254
+ * - `Source disk` status restrictions:
2255
+ * - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
2256
+ * - The `source disk` status is "Available" and the disk has been previously attached.
2257
+ * - A disk undergoing a specification change cannot be used as the `source disk`.
2258
+ * - A disk undergoing expansion cannot be used as the `source disk`.
2259
+ * - Disk cloning is not supported for instance hibernation scenarios. If a disk is on a hibernated instance, it cannot be used as the `source disk`.
2258
2260
  *
2259
2261
  * @param request - CloneDisksRequest
2260
2262
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2334,29 +2336,29 @@ class Client extends openapi_core_1.default {
2334
2336
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CloneDisksResponse({}));
2335
2337
  }
2336
2338
  /**
2337
- * Cloud disk cloning allows you to quickly create a new cloud disk in the same availability zone containing the same data as the source disk. You can customize the new disk\\"s capacity, type, and encryption attributes. After attaching the disk to an instance, you can use it to rapidly replicate business data or scale your services horizontally.
2339
+ * Disk cloning allows you to quickly create a new disk with the same data as the source disk in the same zone. The new disk supports custom capacity, type, and encryption attributes. After the new disk is attached to an instance, you can quickly replicate business data or horizontally scale your services.
2338
2340
  *
2339
2341
  * @remarks
2340
- * > The cloud disk cloning feature is free. However, the resulting destination disk is billed based on block storage rules. Charges vary by disk type and can include capacity, provisioned performance, and burst performance. Billing for all items begins at creation—except for burst performance fees, which are charged only after a burst occurs—and applies regardless of whether the disk is attached to an instance.
2341
- * ### Usage
2342
- * - This is an asynchronous operation. After a successful call, call the DescribeTasks operation with the returned taskGroupId to query the task\\"s status.
2342
+ * > The disk cloning feature itself is free of charge, but the new disk generated by cloning is billed based on block storage billing rules. Billable items vary by disk type and include disk capacity fees, provisioned performance fees, and performance burst fees. Except for performance burst fees, which are billed after a burst occurs, all other fees start to accrue after the disk is created, regardless of whether the disk is attached to an instance.
2343
+ * ### How to use
2344
+ * - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to obtain the execution result.
2343
2345
  * ### Features
2344
- * - You can only clone ESSD cloud disks (cloud_essd, cloud_auto, cloud_essd_entry, and cloud_regional_disk_auto) to create a `destination disk`, which must also be an ESSD type.
2345
- * - A non-zone-redundant cloud disk can only be cloned to a non-zone-redundant disk. A zone-redundant cloud disk can only be cloned to another zone-redundant cloud disk.
2346
- * - Local disks and elastic ephemeral disks do not support cloning and cannot be used as either a source disk or a destination disk.
2347
- * - You can specify the type and performance level for the `destination disk`.
2348
- * - You can specify the capacity for the `destination disk`, but its capacity must be greater than or equal to that of the `source disk`.
2349
- * - You can configure provisioned performance and burst performance for the `destination disk`, provided that the destination disk type supports these features.
2350
- * - You can enable encryption and change the encryption key for the `destination disk`. If the `source disk` is encrypted, the destination disk must also be encrypted. However, you can use a different encryption key.
2351
- * - You can use a subscription cloud disk as the `source disk`. The disk can still be used as a `source disk` even after its subscription expires.
2352
- * - A `destination disk` created by cloning cannot be re-initialized.
2353
- * - While you cannot clone entire storage sets or dedicated storage clusters, you can use a disk from within them as a `source disk`. The resulting destination disk is a standalone disk and will not belong to the original storage set or cluster.
2354
- * - `source disk` status requirements
2355
- * - The `source disk` must be "In Use", and its attached instance must be "Running" or "Stopped".
2356
- * - The `source disk` must be "Available" and have been attached to an instance at least once.
2357
- * - A disk undergoing a configuration modification cannot be used as a `source disk`.
2358
- * - A disk that is being scaled up cannot be used as a `source disk`.
2359
- * - As cloud disk cloning is not supported for hibernated instances, a disk attached to a hibernated instance cannot be used as a `source disk`.
2346
+ * - Cloning supports only ESSD series disks (cloud_essd, cloud_auto, cloud_essd_entry, cloud_regional_disk_auto) as the source, and the `new disk` can only be an ESSD series disk type.
2347
+ * - Non-regional disks can only be cloned to non-regional disk types. Regional disks can only be cloned to regional disk types.
2348
+ * - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
2349
+ * - You can specify the `new disk` type and performance level (PL) during cloning.
2350
+ * - You can specify the `new disk` capacity during cloning, but the new disk capacity must be greater than or equal to the `source disk` capacity.
2351
+ * - You can configure provisioned performance and performance burst for the `new disk`, provided that the destination disk type supports provisioned performance and performance burst.
2352
+ * - You can specify encryption for the `new disk` and change the encryption key. If the `source disk` is encrypted, you cannot clone it into an unencrypted disk, but you can change the encryption key.
2353
+ * - You can use a subscription disk as the `source disk`. Even if the subscription disk has expired, it can still be used as the `source disk`.
2354
+ * - The `new disk` created by cloning does not support reinitialization.
2355
+ * - Cloning does not support storage sets or dedicated block storage clusters, but disks in them can be used as the `source disk`. The cloned disk will not be in the storage set or dedicated block storage cluster.
2356
+ * - `Source disk` status restrictions:
2357
+ * - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
2358
+ * - The `source disk` status is "Available" and the disk has been previously attached.
2359
+ * - A disk undergoing a specification change cannot be used as the `source disk`.
2360
+ * - A disk undergoing expansion cannot be used as the `source disk`.
2361
+ * - Disk cloning is not supported for instance hibernation scenarios. If a disk is on a hibernated instance, it cannot be used as the `source disk`.
2360
2362
  *
2361
2363
  * @param request - CloneDisksRequest
2362
2364
  * @returns CloneDisksResponse
@@ -2693,12 +2695,12 @@ class Client extends openapi_core_1.default {
2693
2695
  return await this.copySnapshotWithOptions(request, runtime);
2694
2696
  }
2695
2697
  /**
2696
- * This API is used to create an activation code, which is used to register non-Alibaba Cloud servers as Alibaba Cloud managed instances.
2698
+ * Creates an activation code that is used to register non-Alibaba Cloud servers as Alibaba Cloud managed instances.
2697
2699
  *
2698
2700
  * @remarks
2699
- * ## API Guide
2700
- * 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).
2701
- * 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.
2701
+ * ## Operation description
2702
+ * 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.
2703
+ * 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.
2702
2704
  * - Alibaba Cloud Linux 2/3 and later
2703
2705
  * - CentOS 6/7/8 and later
2704
2706
  * - Debian 8/9/10 and later
@@ -2707,9 +2709,9 @@ class Client extends openapi_core_1.default {
2707
2709
  * - OpenSUSE
2708
2710
  * - RedHat 5/6/7 and later
2709
2711
  * - SUSE Linux Enterprise Server 11/12/15 and later
2710
- * - Windows Server 2012/2016/2019 and later
2711
- * 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.
2712
- * > You can click **Register New Instance** on the **Managed Instances** tab of the **ECS Cloud Assistant** page to view activation code usage data.
2712
+ * - Window Server 2012/2016/2019 and later
2713
+ * 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.
2714
+ * > 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.
2713
2715
  *
2714
2716
  * @param request - CreateActivationRequest
2715
2717
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2777,12 +2779,12 @@ class Client extends openapi_core_1.default {
2777
2779
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateActivationResponse({}));
2778
2780
  }
2779
2781
  /**
2780
- * This API is used to create an activation code, which is used to register non-Alibaba Cloud servers as Alibaba Cloud managed instances.
2782
+ * Creates an activation code that is used to register non-Alibaba Cloud servers as Alibaba Cloud managed instances.
2781
2783
  *
2782
2784
  * @remarks
2783
- * ## API Guide
2784
- * 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).
2785
- * 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.
2785
+ * ## Operation description
2786
+ * 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.
2787
+ * 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.
2786
2788
  * - Alibaba Cloud Linux 2/3 and later
2787
2789
  * - CentOS 6/7/8 and later
2788
2790
  * - Debian 8/9/10 and later
@@ -2791,9 +2793,9 @@ class Client extends openapi_core_1.default {
2791
2793
  * - OpenSUSE
2792
2794
  * - RedHat 5/6/7 and later
2793
2795
  * - SUSE Linux Enterprise Server 11/12/15 and later
2794
- * - Windows Server 2012/2016/2019 and later
2795
- * 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.
2796
- * > You can click **Register New Instance** on the **Managed Instances** tab of the **ECS Cloud Assistant** page to view activation code usage data.
2796
+ * - Window Server 2012/2016/2019 and later
2797
+ * 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.
2798
+ * > 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.
2797
2799
  *
2798
2800
  * @param request - CreateActivationRequest
2799
2801
  * @returns CreateActivationResponse
@@ -2803,13 +2805,13 @@ class Client extends openapi_core_1.default {
2803
2805
  return await this.createActivationWithOptions(request, runtime);
2804
2806
  }
2805
2807
  /**
2806
- * Create an auto provisioning group.
2808
+ * Creates an auto provisioning group.
2807
2809
  *
2808
2810
  * @remarks
2809
- * - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create multiple ECS instances](https://help.aliyun.com/document_detail/200772.html).
2810
- * - Auto provisioning schedules and maintains compute resources through provisioning groups. Use auto provisioning groups to provide stable computing power and mitigate instability caused by the spot instance reclamation mechanism.
2811
- * - Auto provisioning is a free feature. You pay only for the instance resources created through the auto provisioning group. For more information, see [Spot instance billing](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
2812
- * - When you specify both a launch template (`LaunchTemplateId`) and launch configuration parameters (`LaunchConfiguration.*`), the system prioritizes the launch template.
2811
+ * - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create ECS instances in batches](https://help.aliyun.com/document_detail/200772.html).
2812
+ * - Auto provisioning uses provisioning groups to schedule and maintain compute resources. You can use an auto provisioning group to steadily provide computing power and mitigate the instability caused by the reclaim mechanism of spot instances.
2813
+ * - Auto provisioning is a free feature, but you are charged for the instance resources created by the auto provisioning group. For more information, see [Spot instance billing](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
2814
+ * - If you specify both a launch template (`LaunchTemplateId`) and launch configuration information (`LaunchConfiguration.*`), the launch template takes precedence.
2813
2815
  *
2814
2816
  * @param tmpReq - CreateAutoProvisioningGroupRequest
2815
2817
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2951,13 +2953,13 @@ class Client extends openapi_core_1.default {
2951
2953
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateAutoProvisioningGroupResponse({}));
2952
2954
  }
2953
2955
  /**
2954
- * Create an auto provisioning group.
2956
+ * Creates an auto provisioning group.
2955
2957
  *
2956
2958
  * @remarks
2957
- * - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create multiple ECS instances](https://help.aliyun.com/document_detail/200772.html).
2958
- * - Auto provisioning schedules and maintains compute resources through provisioning groups. Use auto provisioning groups to provide stable computing power and mitigate instability caused by the spot instance reclamation mechanism.
2959
- * - Auto provisioning is a free feature. You pay only for the instance resources created through the auto provisioning group. For more information, see [Spot instance billing](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
2960
- * - When you specify both a launch template (`LaunchTemplateId`) and launch configuration parameters (`LaunchConfiguration.*`), the system prioritizes the launch template.
2959
+ * - Auto provisioning is a solution that uses spot instances and pay-as-you-go instances to quickly deploy instance clusters. It supports one-click deployment of instance clusters across billing methods, zones, and instance families. For more information, see [Use the auto provisioning group API to create ECS instances in batches](https://help.aliyun.com/document_detail/200772.html).
2960
+ * - Auto provisioning uses provisioning groups to schedule and maintain compute resources. You can use an auto provisioning group to steadily provide computing power and mitigate the instability caused by the reclaim mechanism of spot instances.
2961
+ * - Auto provisioning is a free feature, but you are charged for the instance resources created by the auto provisioning group. For more information, see [Spot instance billing](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
2962
+ * - If you specify both a launch template (`LaunchTemplateId`) and launch configuration information (`LaunchConfiguration.*`), the launch template takes precedence.
2961
2963
  *
2962
2964
  * @param request - CreateAutoProvisioningGroupRequest
2963
2965
  * @returns CreateAutoProvisioningGroupResponse
@@ -3172,23 +3174,23 @@ class Client extends openapi_core_1.default {
3172
3174
  return await this.createCapacityReservationWithOptions(request, runtime);
3173
3175
  }
3174
3176
  /**
3175
- * Create a Cloud Assistant command of the Shell, PowerShell, or Bat script type.
3177
+ * Creates a Cloud Assistant command of the Shell, PowerShell, or Bat script type.
3176
3178
  *
3177
3179
  * @remarks
3178
- * ## API Guide
3179
- * - You can create commands of the following types:
3180
- * - Bat scripts (RunBatScript) for Windows instances.
3181
- * - PowerShell scripts (RunPowerShellScript) for Windows instances.
3182
- * - Shell scripts (RunShellScript) for Linux instances.
3183
- * - 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.
3184
- * - 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.
3185
- * - For scheduled execution:
3186
- * - The timeout setting applies to each individual execution record.
3187
- * - If a specific execution times out, the status of that execution record ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) changes to Failed.
3188
- * - Whether the previous execution timed out does not affect the next execution.
3189
- * - 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).
3190
- * - 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`.
3191
- * - 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.
3180
+ * ## Operation description
3181
+ * - You can create the following types of commands:
3182
+ * - Bat scripts for Windows instances (RunBatScript).
3183
+ * - PowerShell scripts for Windows instances (RunPowerShellScript).
3184
+ * - Shell scripts for Linux instances (RunShellScript).
3185
+ * - 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.
3186
+ * - 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.
3187
+ * - For a scheduled execution:
3188
+ * - The timeout period takes effect for each execution record.
3189
+ * - After a specific execution times out, the status ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) of that execution record changes to Failed.
3190
+ * - The timeout of a previous execution does not affect the next execution.
3191
+ * - 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).
3192
+ * - 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`.
3193
+ * - 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.
3192
3194
  *
3193
3195
  * @param request - CreateCommandRequest
3194
3196
  * @param runtime - runtime options for this request RuntimeOptions
@@ -3268,23 +3270,23 @@ class Client extends openapi_core_1.default {
3268
3270
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateCommandResponse({}));
3269
3271
  }
3270
3272
  /**
3271
- * Create a Cloud Assistant command of the Shell, PowerShell, or Bat script type.
3273
+ * Creates a Cloud Assistant command of the Shell, PowerShell, or Bat script type.
3272
3274
  *
3273
3275
  * @remarks
3274
- * ## API Guide
3275
- * - You can create commands of the following types:
3276
- * - Bat scripts (RunBatScript) for Windows instances.
3277
- * - PowerShell scripts (RunPowerShellScript) for Windows instances.
3278
- * - Shell scripts (RunShellScript) for Linux instances.
3279
- * - 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.
3280
- * - 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.
3281
- * - For scheduled execution:
3282
- * - The timeout setting applies to each individual execution record.
3283
- * - If a specific execution times out, the status of that execution record ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) changes to Failed.
3284
- * - Whether the previous execution timed out does not affect the next execution.
3285
- * - 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).
3286
- * - 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`.
3287
- * - 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.
3276
+ * ## Operation description
3277
+ * - You can create the following types of commands:
3278
+ * - Bat scripts for Windows instances (RunBatScript).
3279
+ * - PowerShell scripts for Windows instances (RunPowerShellScript).
3280
+ * - Shell scripts for Linux instances (RunShellScript).
3281
+ * - 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.
3282
+ * - 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.
3283
+ * - For a scheduled execution:
3284
+ * - The timeout period takes effect for each execution record.
3285
+ * - After a specific execution times out, the status ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) of that execution record changes to Failed.
3286
+ * - The timeout of a previous execution does not affect the next execution.
3287
+ * - 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).
3288
+ * - 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`.
3289
+ * - 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.
3288
3290
  *
3289
3291
  * @param request - CreateCommandRequest
3290
3292
  * @returns CreateCommandResponse
@@ -3557,14 +3559,14 @@ class Client extends openapi_core_1.default {
3557
3559
  * Creates a pay-as-you-go or subscription data disk.
3558
3560
  *
3559
3561
  * @remarks
3560
- * - 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).
3561
- * - 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.
3562
- * - Creating a disk requires real-name verification. Go to [Real-name verification](https://account.console.aliyun.com/#/auth/home) in account information.
3563
- * - 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).
3564
- * - Default settings when creating a disk:
3565
- * - 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.
3566
- * - 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).
3567
- * - The billing method is pay-as-you-go, that is, the default `Portable` attribute is `true`.
3562
+ * - 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).
3563
+ * - 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.
3564
+ * - To create a disk, complete [real-name registration](https://account.console.aliyun.com/#/auth/home).
3565
+ * - 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).
3566
+ * - Default settings when you create a disk:
3567
+ * - 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.
3568
+ * - 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.
3569
+ * - The billing method is pay-as-you-go, which means the `Portable` property defaults to `true`.
3568
3570
  *
3569
3571
  * @param request - CreateDiskRequest
3570
3572
  * @param runtime - runtime options for this request RuntimeOptions
@@ -3674,14 +3676,14 @@ class Client extends openapi_core_1.default {
3674
3676
  * Creates a pay-as-you-go or subscription data disk.
3675
3677
  *
3676
3678
  * @remarks
3677
- * - 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).
3678
- * - 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.
3679
- * - Creating a disk requires real-name verification. Go to [Real-name verification](https://account.console.aliyun.com/#/auth/home) in account information.
3680
- * - 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).
3681
- * - Default settings when creating a disk:
3682
- * - 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.
3683
- * - 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).
3684
- * - The billing method is pay-as-you-go, that is, the default `Portable` attribute is `true`.
3679
+ * - 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).
3680
+ * - 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.
3681
+ * - To create a disk, complete [real-name registration](https://account.console.aliyun.com/#/auth/home).
3682
+ * - 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).
3683
+ * - Default settings when you create a disk:
3684
+ * - 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.
3685
+ * - 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.
3686
+ * - The billing method is pay-as-you-go, which means the `Portable` property defaults to `true`.
3685
3687
  *
3686
3688
  * @param request - CreateDiskRequest
3687
3689
  * @returns CreateDiskResponse
@@ -3944,7 +3946,7 @@ class Client extends openapi_core_1.default {
3944
3946
  return await this.createHaVipWithOptions(request, runtime);
3945
3947
  }
3946
3948
  /**
3947
- * Creates a high performance computing (HPC) cluster.
3949
+ * Creates an HPC cluster by calling CreateHpcCluster.
3948
3950
  *
3949
3951
  * @param request - CreateHpcClusterRequest
3950
3952
  * @param runtime - runtime options for this request RuntimeOptions
@@ -3997,7 +3999,7 @@ class Client extends openapi_core_1.default {
3997
3999
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateHpcClusterResponse({}));
3998
4000
  }
3999
4001
  /**
4000
- * Creates a high performance computing (HPC) cluster.
4002
+ * Creates an HPC cluster by calling CreateHpcCluster.
4001
4003
  *
4002
4004
  * @param request - CreateHpcClusterRequest
4003
4005
  * @returns CreateHpcClusterResponse
@@ -4007,26 +4009,25 @@ class Client extends openapi_core_1.default {
4007
4009
  return await this.createHpcClusterWithOptions(request, runtime);
4008
4010
  }
4009
4011
  /**
4010
- * Create a custom image. You can then use the image to create ECS instances (`RunInstances`) or replace the system disk of an instance (`ReplaceSystemDisk`).
4012
+ * Creates a custom image. You can use the created custom image to create ECS instances (RunInstances) or replace the system disk of an instance (ReplaceSystemDisk).
4011
4013
  *
4012
4014
  * @remarks
4013
- * ### Usage notes
4014
- * - This operation is asynchronous. A successful request returns an image ID, but the image is not created immediately. You can call [DescribeImage](https://help.aliyun.com/document_detail/2679797.html) to query the image status. The image is ready for use when its status changes to `Available`. For more information, see [Overview of custom images](https://help.aliyun.com/document_detail/172789.html).
4015
- * - If the response to a query for ECS instance information contains `{"OperationLocks": {"LockReason" : "security"}}`, you cannot create a custom image from the instance.
4016
- * - We recommend configuring the image check parameter `DetectionStrategy` when you create an image. This helps the system optimize your image. For more information, see [Overview of image check](https://help.aliyun.com/document_detail/439819.html).
4017
- * This operation provides three methods to create a custom image. The request parameters are prioritized as follows: InstanceId > DiskDeviceMapping > SnapshotId. If your request includes two or more of these parameters, the operation creates the image based on the parameter with the highest priority.
4015
+ * ### Before you begin
4016
+ * - This is an asynchronous operation. After a request to create a custom image is sent, the image ID is returned. However, the image creation is not immediately complete. Call [DescribeImage](https://help.aliyun.com/document_detail/2679797.html) to query the image information. When the status in the response is `Available`, the image is created and ready for use. For more information, see [Custom image overview](https://help.aliyun.com/document_detail/172789.html).
4017
+ * - When you query ECS instance information, if the response contains {"OperationLocks": {"LockReason" : "security"}}, you cannot create a custom image.
4018
+ * - Configure the image detection parameter `DetectionStrategy` when creating an image to help the system optimize your image. For more information, see [Image detection overview](https://help.aliyun.com/document_detail/439819.html).
4019
+ * The following describes three methods to create a custom image by calling this operation. The priority of request parameters is: InstanceId > DiskDeviceMapping > SnapshotId. If your request contains two or more of these parameters, the image is created based on the parameter with the highest priority.
4018
4020
  * - **Create a custom image from an instance**: Specify the instance ID (`InstanceId`).
4019
- * - The instance must be in the `Running` or `Stopped` state.
4020
- * - A successful call creates a new snapshot for each cloud disk of the instance.
4021
- * >Notice:
4022
- * Data cached in memory on a running instance may not be written to disk. This can cause data inconsistencies between the custom image and the instance. We recommend stopping the instance by calling [StopInstances](https://help.aliyun.com/document_detail/155372.html) before creating an image.
4023
- *
4024
- * - **Create a custom image from a snapshot (snapshots created on or before July 15, 2013, cannot be used).**
4025
- * - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance\\"s system disk (`SnapshotId`).
4026
- * - **Create a custom image from a system disk snapshot and data disk snapshots**: Map the snapshots to disks by using the `DiskDeviceMapping` parameter.
4027
- * - You can specify only one system disk snapshot.
4028
- * - You can specify up to 16 data disk snapshots. If you do not specify `DiskDeviceMapping.N.SnapshotId`, the system creates an empty data disk with the default capacity.
4029
- * > When you release an instance, the system retains its system disk and converts it to a pay-as-you-go data disk. You cannot use snapshots of this disk to create custom images. If you need a custom image, create it before you release the instance.
4021
+ * - The instance must be in the Running (`Running`) or Stopped (`Stopped`) state.
4022
+ * - After the operation is called, a new snapshot is created for each disk of the instance.
4023
+ * >Notice: Because a running instance may have cached data that has not been written to disks, the data of the created custom image may be inconsistent with the instance data. Stop the instance ([StopInstances](https://help.aliyun.com/document_detail/155372.html)) before creating the image.
4024
+ * - **Create a custom image from a snapshot (the specified snapshot cannot be one created on or before July 15, 2013.)**
4025
+ * - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance system disk (`SnapshotId`).
4026
+ * - **Create a custom image from system disk and data disk snapshots**: Establish data associations among multiple disks (`DiskDeviceMapping`).
4027
+ * - Only one system disk snapshot can be specified.
4028
+ * - You can specify multiple data disk snapshots, up to a maximum of 16. If `DiskDeviceMapping.N.SnapshotId` is not specified, an empty data disk with the default capacity is created.
4029
+ *
4030
+ * > When an instance is released, the system disk is retained as a pay-as-you-go data disk. Snapshots created from this disk do not support creating custom images. Create a custom image before releasing the instance as needed.
4030
4031
  *
4031
4032
  * @param request - CreateImageRequest
4032
4033
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4115,26 +4116,25 @@ class Client extends openapi_core_1.default {
4115
4116
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateImageResponse({}));
4116
4117
  }
4117
4118
  /**
4118
- * Create a custom image. You can then use the image to create ECS instances (`RunInstances`) or replace the system disk of an instance (`ReplaceSystemDisk`).
4119
+ * Creates a custom image. You can use the created custom image to create ECS instances (RunInstances) or replace the system disk of an instance (ReplaceSystemDisk).
4119
4120
  *
4120
4121
  * @remarks
4121
- * ### Usage notes
4122
- * - This operation is asynchronous. A successful request returns an image ID, but the image is not created immediately. You can call [DescribeImage](https://help.aliyun.com/document_detail/2679797.html) to query the image status. The image is ready for use when its status changes to `Available`. For more information, see [Overview of custom images](https://help.aliyun.com/document_detail/172789.html).
4123
- * - If the response to a query for ECS instance information contains `{"OperationLocks": {"LockReason" : "security"}}`, you cannot create a custom image from the instance.
4124
- * - We recommend configuring the image check parameter `DetectionStrategy` when you create an image. This helps the system optimize your image. For more information, see [Overview of image check](https://help.aliyun.com/document_detail/439819.html).
4125
- * This operation provides three methods to create a custom image. The request parameters are prioritized as follows: InstanceId > DiskDeviceMapping > SnapshotId. If your request includes two or more of these parameters, the operation creates the image based on the parameter with the highest priority.
4122
+ * ### Before you begin
4123
+ * - This is an asynchronous operation. After a request to create a custom image is sent, the image ID is returned. However, the image creation is not immediately complete. Call [DescribeImage](https://help.aliyun.com/document_detail/2679797.html) to query the image information. When the status in the response is `Available`, the image is created and ready for use. For more information, see [Custom image overview](https://help.aliyun.com/document_detail/172789.html).
4124
+ * - When you query ECS instance information, if the response contains {"OperationLocks": {"LockReason" : "security"}}, you cannot create a custom image.
4125
+ * - Configure the image detection parameter `DetectionStrategy` when creating an image to help the system optimize your image. For more information, see [Image detection overview](https://help.aliyun.com/document_detail/439819.html).
4126
+ * The following describes three methods to create a custom image by calling this operation. The priority of request parameters is: InstanceId > DiskDeviceMapping > SnapshotId. If your request contains two or more of these parameters, the image is created based on the parameter with the highest priority.
4126
4127
  * - **Create a custom image from an instance**: Specify the instance ID (`InstanceId`).
4127
- * - The instance must be in the `Running` or `Stopped` state.
4128
- * - A successful call creates a new snapshot for each cloud disk of the instance.
4129
- * >Notice:
4130
- * Data cached in memory on a running instance may not be written to disk. This can cause data inconsistencies between the custom image and the instance. We recommend stopping the instance by calling [StopInstances](https://help.aliyun.com/document_detail/155372.html) before creating an image.
4131
- *
4132
- * - **Create a custom image from a snapshot (snapshots created on or before July 15, 2013, cannot be used).**
4133
- * - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance\\"s system disk (`SnapshotId`).
4134
- * - **Create a custom image from a system disk snapshot and data disk snapshots**: Map the snapshots to disks by using the `DiskDeviceMapping` parameter.
4135
- * - You can specify only one system disk snapshot.
4136
- * - You can specify up to 16 data disk snapshots. If you do not specify `DiskDeviceMapping.N.SnapshotId`, the system creates an empty data disk with the default capacity.
4137
- * > When you release an instance, the system retains its system disk and converts it to a pay-as-you-go data disk. You cannot use snapshots of this disk to create custom images. If you need a custom image, create it before you release the instance.
4128
+ * - The instance must be in the Running (`Running`) or Stopped (`Stopped`) state.
4129
+ * - After the operation is called, a new snapshot is created for each disk of the instance.
4130
+ * >Notice: Because a running instance may have cached data that has not been written to disks, the data of the created custom image may be inconsistent with the instance data. Stop the instance ([StopInstances](https://help.aliyun.com/document_detail/155372.html)) before creating the image.
4131
+ * - **Create a custom image from a snapshot (the specified snapshot cannot be one created on or before July 15, 2013.)**
4132
+ * - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance system disk (`SnapshotId`).
4133
+ * - **Create a custom image from system disk and data disk snapshots**: Establish data associations among multiple disks (`DiskDeviceMapping`).
4134
+ * - Only one system disk snapshot can be specified.
4135
+ * - You can specify multiple data disk snapshots, up to a maximum of 16. If `DiskDeviceMapping.N.SnapshotId` is not specified, an empty data disk with the default capacity is created.
4136
+ *
4137
+ * > When an instance is released, the system disk is retained as a pay-as-you-go data disk. Snapshots created from this disk do not support creating custom images. Create a custom image before releasing the instance as needed.
4138
4138
  *
4139
4139
  * @param request - CreateImageRequest
4140
4140
  * @returns CreateImageResponse
@@ -4144,13 +4144,13 @@ class Client extends openapi_core_1.default {
4144
4144
  return await this.createImageWithOptions(request, runtime);
4145
4145
  }
4146
4146
  /**
4147
- * Creates an image component. Image components store commonly used build template commands for image building.
4147
+ * Creates an image component. Image components are used to store commonly used build template commands for image building.
4148
4148
  *
4149
4149
  * @remarks
4150
4150
  * ## Operation description
4151
4151
  * Before you create an image component, take note of the following items:
4152
- * - You can create only custom image components.
4153
- * - 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.
4152
+ * - Only custom image components can be created.
4153
+ * - 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.
4154
4154
  * - 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).
4155
4155
  * For more information, see [Image Builder overview](https://help.aliyun.com/document_detail/197410.html).
4156
4156
  *
@@ -4226,13 +4226,13 @@ class Client extends openapi_core_1.default {
4226
4226
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateImageComponentResponse({}));
4227
4227
  }
4228
4228
  /**
4229
- * Creates an image component. Image components store commonly used build template commands for image building.
4229
+ * Creates an image component. Image components are used to store commonly used build template commands for image building.
4230
4230
  *
4231
4231
  * @remarks
4232
4232
  * ## Operation description
4233
4233
  * Before you create an image component, take note of the following items:
4234
- * - You can create only custom image components.
4235
- * - 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.
4234
+ * - Only custom image components can be created.
4235
+ * - 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.
4236
4236
  * - 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).
4237
4237
  * For more information, see [Image Builder overview](https://help.aliyun.com/document_detail/197410.html).
4238
4238
  *
@@ -4392,31 +4392,32 @@ class Client extends openapi_core_1.default {
4392
4392
  return await this.createImagePipelineWithOptions(request, runtime);
4393
4393
  }
4394
4394
  /**
4395
- * 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.
4395
+ * Creates a subscription or pay-as-you-go Elastic Compute Service (ECS) instance with customizable parameters.
4396
4396
  *
4397
4397
  * @remarks
4398
- * > This API is deprecated. We recommend that you use the [RunInstances](https://help.aliyun.com/document_detail/2679677.html) API instead.
4398
+ * > This operation is no longer maintained. Use [RunInstances](https://help.aliyun.com/document_detail/2679677.html) instead.
4399
4399
  * <props="china">
4400
- * **Before using this API, ensure you understand the billing methods and [Pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS.**
4400
+ * **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.**
4401
4401
  * <props="intl">
4402
- * **Before using this API, ensure you understand the billing methods and [Pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS.**
4403
- * 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.
4404
- * ### Usage notes
4402
+ * **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.**
4403
+ * 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.
4404
+ * ### Before you begin
4405
4405
  * <props="china">
4406
- * - 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).
4407
- * - 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).
4408
- * - 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).
4409
- * - Before creating a VPC-type instance, you must [create a VPC](https://help.aliyun.com/document_detail/65430.html) in the same region.
4410
- * ### Precautions
4411
- * - 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.
4412
- * - If the billing method for the instance is subscription (`PrePaid`), your available coupons are automatically used at checkout.
4413
- * - 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.
4414
- * - 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.
4415
- * > 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~~).
4406
+ * - 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).
4407
+ * - 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).
4408
+ *
4409
+ * - 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).
4410
+ * - 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).
4411
+ * ### Before you begin
4412
+ * - When you invoke this operation, the system does not send notifications (including text messages, emails, or internal messages) about instance creation.
4413
+ * - If the billable methods of the instance is subscription (`PrePaid`), active coupon in your account are used by default during payment.
4414
+ * - 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.
4415
+ * - 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.
4416
+ * > 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~~).
4416
4417
  * ### Recommendations
4417
- * - **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.
4418
- * - **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.
4419
- * - **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.
4418
+ * - **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.
4419
+ * - **Check active resources**: Invoke [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) to query active resources in a specific region or zone.
4420
+ * - **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.
4420
4421
  *
4421
4422
  * @param request - CreateInstanceRequest
4422
4423
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4625,31 +4626,32 @@ class Client extends openapi_core_1.default {
4625
4626
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateInstanceResponse({}));
4626
4627
  }
4627
4628
  /**
4628
- * 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.
4629
+ * Creates a subscription or pay-as-you-go Elastic Compute Service (ECS) instance with customizable parameters.
4629
4630
  *
4630
4631
  * @remarks
4631
- * > This API is deprecated. We recommend that you use the [RunInstances](https://help.aliyun.com/document_detail/2679677.html) API instead.
4632
+ * > This operation is no longer maintained. Use [RunInstances](https://help.aliyun.com/document_detail/2679677.html) instead.
4632
4633
  * <props="china">
4633
- * **Before using this API, ensure you understand the billing methods and [Pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS.**
4634
+ * **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.**
4634
4635
  * <props="intl">
4635
- * **Before using this API, ensure you understand the billing methods and [Pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS.**
4636
- * 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.
4637
- * ### Usage notes
4636
+ * **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.**
4637
+ * 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.
4638
+ * ### Before you begin
4638
4639
  * <props="china">
4639
- * - 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).
4640
- * - 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).
4641
- * - 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).
4642
- * - Before creating a VPC-type instance, you must [create a VPC](https://help.aliyun.com/document_detail/65430.html) in the same region.
4643
- * ### Precautions
4644
- * - 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.
4645
- * - If the billing method for the instance is subscription (`PrePaid`), your available coupons are automatically used at checkout.
4646
- * - 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.
4647
- * - 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.
4648
- * > 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~~).
4640
+ * - 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).
4641
+ * - 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).
4642
+ *
4643
+ * - 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).
4644
+ * - 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).
4645
+ * ### Before you begin
4646
+ * - When you invoke this operation, the system does not send notifications (including text messages, emails, or internal messages) about instance creation.
4647
+ * - If the billable methods of the instance is subscription (`PrePaid`), active coupon in your account are used by default during payment.
4648
+ * - 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.
4649
+ * - 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.
4650
+ * > 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~~).
4649
4651
  * ### Recommendations
4650
- * - **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.
4651
- * - **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.
4652
- * - **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.
4652
+ * - **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.
4653
+ * - **Check active resources**: Invoke [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) to query active resources in a specific region or zone.
4654
+ * - **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.
4653
4655
  *
4654
4656
  * @param request - CreateInstanceRequest
4655
4657
  * @returns CreateInstanceResponse
@@ -4724,15 +4726,15 @@ class Client extends openapi_core_1.default {
4724
4726
  return await this.createKeyPairWithOptions(request, runtime);
4725
4727
  }
4726
4728
  /**
4727
- * Create an ECS instance launch template, abbreviated as a template. An instance launch template eliminates the need to enter numerous configuration parameters each time you create an instance.
4729
+ * Creates an ECS instance launch template. A launch template eliminates the need to configure a large number of parameters every time you create an instance.
4728
4730
  *
4729
4731
  * @remarks
4730
- * After you invoke CreateLaunchTemplate to create a template, Alibaba Cloud automatically generates a default version of the template with version number 1. You can subsequently create multiple versions based on this template by calling `CreateLaunchTemplateVersion`. Version numbers start from 1 and increment sequentially. If you do not specify a template version when creating an instance ([RunInstances](https://help.aliyun.com/document_detail/63440.html)), the default version is used.
4731
- * A launch template version includes configurations required for instance creation, such as the Region, image ID, instance type, security group ID, and Internet bandwidth. If a particular configuration is not specified in the template version, you must provide it explicitly when creating the instance.
4732
- * When invoking this API, note the following:
4733
- * - Each account can create up to 30 launch templates per Region, and each template can have up to 30 versions.
4734
- * - Most parameters in a launch template are optional. Alibaba Cloud does not validate the existence or validity of parameter values when you create the template. Validation occurs only when you actually create an instance.
4735
- * - If a configuration is set in the launch template, you cannot omit it when creating an instance ([RunInstances](https://help.aliyun.com/document_detail/63440.html)). For example, if the template sets `HostName=LocalHost`, and you leave `HostName` empty in `RunInstances`, the instance hostname will still be `LocalHost`. To overwrite the `HostName=LocalHost` setting, specify a different value such as `HostName=MyHost` in `RunInstances`.
4732
+ * After you call CreateLaunchTemplate to create a template, a default version with version number 1 is automatically generated. You can then create multiple versions based on this template (`CreateLaunchTemplateVersion`), with version numbers incrementing sequentially from 1. If you do not specify a template version when creating instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)), the default version is used.
4733
+ * A launch template version contains the configurations for creating instances, such as the region, image ID, instance type, security group ID, and public bandwidth. If a specific configuration is not specified in the version, you must specify it when you create instances.
4734
+ * When you call this operation, take note of the following items:
4735
+ * - Each account can create up to 30 launch templates per region, and each template can have up to 30 versions.
4736
+ * - Most parameters in a launch template are optional. When you create a template, Alibaba Cloud does not verify the existence or validity of parameter values. The validity of parameter values is verified only when you create instances.
4737
+ * - If a configuration is specified in the launch template, it cannot be filtered out when you create instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)). For example, if the template specifies `HostName=LocalHost` and the `HostName` value is left empty in `RunInstances`, the hostname of the instance is still `LocalHost`. To override the `HostName=LocalHost` configuration, set `HostName=MyHost` or another value in `RunInstances`.
4736
4738
  *
4737
4739
  * @param request - CreateLaunchTemplateRequest
4738
4740
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4926,15 +4928,15 @@ class Client extends openapi_core_1.default {
4926
4928
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateLaunchTemplateResponse({}));
4927
4929
  }
4928
4930
  /**
4929
- * Create an ECS instance launch template, abbreviated as a template. An instance launch template eliminates the need to enter numerous configuration parameters each time you create an instance.
4931
+ * Creates an ECS instance launch template. A launch template eliminates the need to configure a large number of parameters every time you create an instance.
4930
4932
  *
4931
4933
  * @remarks
4932
- * After you invoke CreateLaunchTemplate to create a template, Alibaba Cloud automatically generates a default version of the template with version number 1. You can subsequently create multiple versions based on this template by calling `CreateLaunchTemplateVersion`. Version numbers start from 1 and increment sequentially. If you do not specify a template version when creating an instance ([RunInstances](https://help.aliyun.com/document_detail/63440.html)), the default version is used.
4933
- * A launch template version includes configurations required for instance creation, such as the Region, image ID, instance type, security group ID, and Internet bandwidth. If a particular configuration is not specified in the template version, you must provide it explicitly when creating the instance.
4934
- * When invoking this API, note the following:
4935
- * - Each account can create up to 30 launch templates per Region, and each template can have up to 30 versions.
4936
- * - Most parameters in a launch template are optional. Alibaba Cloud does not validate the existence or validity of parameter values when you create the template. Validation occurs only when you actually create an instance.
4937
- * - If a configuration is set in the launch template, you cannot omit it when creating an instance ([RunInstances](https://help.aliyun.com/document_detail/63440.html)). For example, if the template sets `HostName=LocalHost`, and you leave `HostName` empty in `RunInstances`, the instance hostname will still be `LocalHost`. To overwrite the `HostName=LocalHost` setting, specify a different value such as `HostName=MyHost` in `RunInstances`.
4934
+ * After you call CreateLaunchTemplate to create a template, a default version with version number 1 is automatically generated. You can then create multiple versions based on this template (`CreateLaunchTemplateVersion`), with version numbers incrementing sequentially from 1. If you do not specify a template version when creating instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)), the default version is used.
4935
+ * A launch template version contains the configurations for creating instances, such as the region, image ID, instance type, security group ID, and public bandwidth. If a specific configuration is not specified in the version, you must specify it when you create instances.
4936
+ * When you call this operation, take note of the following items:
4937
+ * - Each account can create up to 30 launch templates per region, and each template can have up to 30 versions.
4938
+ * - Most parameters in a launch template are optional. When you create a template, Alibaba Cloud does not verify the existence or validity of parameter values. The validity of parameter values is verified only when you create instances.
4939
+ * - If a configuration is specified in the launch template, it cannot be filtered out when you create instances ([RunInstances](https://help.aliyun.com/document_detail/63440.html)). For example, if the template specifies `HostName=LocalHost` and the `HostName` value is left empty in `RunInstances`, the hostname of the instance is still `LocalHost`. To override the `HostName=LocalHost` configuration, set `HostName=MyHost` or another value in `RunInstances`.
4938
4940
  *
4939
4941
  * @param request - CreateLaunchTemplateRequest
4940
4942
  * @returns CreateLaunchTemplateResponse
@@ -4944,11 +4946,11 @@ class Client extends openapi_core_1.default {
4944
4946
  return await this.createLaunchTemplateWithOptions(request, runtime);
4945
4947
  }
4946
4948
  /**
4947
- * Create a new version under the specified ECS instance launch template for subsequent creation of ECS instances, scaling groups, or auto provisioning groups.
4949
+ * Creates a new version in a specified ECS launch template for subsequent creation of ECS instances, elastic scaling groups, or auto provisioning groups.
4948
4950
  *
4949
4951
  * @remarks
4950
- * ## API Guide
4951
- * 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.
4952
+ * ## Operation description
4953
+ * To modify the parameters of a specific version, create a new template version. Each instance launch template supports a maximum of 30 versions.
4952
4954
  *
4953
4955
  * @param request - CreateLaunchTemplateVersionRequest
4954
4956
  * @param runtime - runtime options for this request RuntimeOptions
@@ -5139,11 +5141,11 @@ class Client extends openapi_core_1.default {
5139
5141
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.CreateLaunchTemplateVersionResponse({}));
5140
5142
  }
5141
5143
  /**
5142
- * Create a new version under the specified ECS instance launch template for subsequent creation of ECS instances, scaling groups, or auto provisioning groups.
5144
+ * Creates a new version in a specified ECS launch template for subsequent creation of ECS instances, elastic scaling groups, or auto provisioning groups.
5143
5145
  *
5144
5146
  * @remarks
5145
- * ## API Guide
5146
- * 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.
5147
+ * ## Operation description
5148
+ * To modify the parameters of a specific version, create a new template version. Each instance launch template supports a maximum of 30 versions.
5147
5149
  *
5148
5150
  * @param request - CreateLaunchTemplateVersionRequest
5149
5151
  * @returns CreateLaunchTemplateVersionResponse
@@ -6093,10 +6095,10 @@ class Client extends openapi_core_1.default {
6093
6095
  * Creates a security group.
6094
6096
  *
6095
6097
  * @remarks
6096
- * - 通过该接口创建的普通安全组组内连通策略默认是**组内互通**,您可以通过 [ModifySecurityGroupPolicy](https://help.aliyun.com/document_detail/2679846.html) 进行修改。
6097
- * - 通过该接口创建的企业安全组组内连通策略默认是**组内隔离**,并且不能修改。
6098
- * - 单个地域下,安全组的数量有限制,您最少可以创建 100 个安全组。详细信息,请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
6099
- * - 创建专有网络 VPC 类型的安全组时,您必须指定参数 VpcId
6098
+ * - 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).
6099
+ * - The default internal connectivity policy for an advanced security group created by this operation is **internal isolation**, and this policy cannot be modified.
6100
+ * - 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~~).
6101
+ * - To create a security group of the VPC type, you must specify the VpcId parameter.
6100
6102
  *
6101
6103
  * @param request - CreateSecurityGroupRequest
6102
6104
  * @param runtime - runtime options for this request RuntimeOptions
@@ -6164,10 +6166,10 @@ class Client extends openapi_core_1.default {
6164
6166
  * Creates a security group.
6165
6167
  *
6166
6168
  * @remarks
6167
- * - 通过该接口创建的普通安全组组内连通策略默认是**组内互通**,您可以通过 [ModifySecurityGroupPolicy](https://help.aliyun.com/document_detail/2679846.html) 进行修改。
6168
- * - 通过该接口创建的企业安全组组内连通策略默认是**组内隔离**,并且不能修改。
6169
- * - 单个地域下,安全组的数量有限制,您最少可以创建 100 个安全组。详细信息,请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
6170
- * - 创建专有网络 VPC 类型的安全组时,您必须指定参数 VpcId
6169
+ * - 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).
6170
+ * - The default internal connectivity policy for an advanced security group created by this operation is **internal isolation**, and this policy cannot be modified.
6171
+ * - 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~~).
6172
+ * - To create a security group of the VPC type, you must specify the VpcId parameter.
6171
6173
  *
6172
6174
  * @param request - CreateSecurityGroupRequest
6173
6175
  * @returns CreateSecurityGroupResponse
@@ -7618,7 +7620,7 @@ class Client extends openapi_core_1.default {
7618
7620
  return await this.deleteHaVipWithOptions(request, runtime);
7619
7621
  }
7620
7622
  /**
7621
- * Deletes a High Performance Computing (HPC) cluster.
7623
+ * Calls DeleteHpcCluster to delete an HPC cluster.
7622
7624
  *
7623
7625
  * @param request - DeleteHpcClusterRequest
7624
7626
  * @param runtime - runtime options for this request RuntimeOptions
@@ -7668,7 +7670,7 @@ class Client extends openapi_core_1.default {
7668
7670
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeleteHpcClusterResponse({}));
7669
7671
  }
7670
7672
  /**
7671
- * Deletes a High Performance Computing (HPC) cluster.
7673
+ * Calls DeleteHpcCluster to delete an HPC cluster.
7672
7674
  *
7673
7675
  * @param request - DeleteHpcClusterRequest
7674
7676
  * @returns DeleteHpcClusterResponse
@@ -7812,7 +7814,7 @@ class Client extends openapi_core_1.default {
7812
7814
  * Deletes an image template.
7813
7815
  *
7814
7816
  * @remarks
7815
- * 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.
7817
+ * 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.
7816
7818
  *
7817
7819
  * @param request - DeleteImagePipelineRequest
7818
7820
  * @param runtime - runtime options for this request RuntimeOptions
@@ -7862,7 +7864,7 @@ class Client extends openapi_core_1.default {
7862
7864
  * Deletes an image template.
7863
7865
  *
7864
7866
  * @remarks
7865
- * 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.
7867
+ * 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.
7866
7868
  *
7867
7869
  * @param request - DeleteImagePipelineRequest
7868
7870
  * @returns DeleteImagePipelineResponse
@@ -8618,10 +8620,10 @@ class Client extends openapi_core_1.default {
8618
8620
  return await this.deletePortRangeListWithOptions(request, runtime);
8619
8621
  }
8620
8622
  /**
8621
- * Deletes a specified prefix list and all entries in the prefix list.
8623
+ * Calls DeletePrefixList to delete a specified prefix list and all entries in the prefix list.
8622
8624
  *
8623
8625
  * @remarks
8624
- * 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.
8626
+ * 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.
8625
8627
  *
8626
8628
  * @param request - DeletePrefixListRequest
8627
8629
  * @param runtime - runtime options for this request RuntimeOptions
@@ -8668,10 +8670,10 @@ class Client extends openapi_core_1.default {
8668
8670
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DeletePrefixListResponse({}));
8669
8671
  }
8670
8672
  /**
8671
- * Deletes a specified prefix list and all entries in the prefix list.
8673
+ * Calls DeletePrefixList to delete a specified prefix list and all entries in the prefix list.
8672
8674
  *
8673
8675
  * @remarks
8674
- * 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.
8676
+ * 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.
8675
8677
  *
8676
8678
  * @param request - DeletePrefixListRequest
8677
8679
  * @returns DeletePrefixListResponse
@@ -9661,7 +9663,7 @@ class Client extends openapi_core_1.default {
9661
9663
  return await this.describeAutoProvisioningGroupHistoryWithOptions(request, runtime);
9662
9664
  }
9663
9665
  /**
9664
- * Queries information about Elastic Compute Service (ECS) instances in an auto provisioning group.
9666
+ * Queries information about instances in an auto provisioning group.
9665
9667
  *
9666
9668
  * @param request - DescribeAutoProvisioningGroupInstancesRequest
9667
9669
  * @param runtime - runtime options for this request RuntimeOptions
@@ -9711,7 +9713,7 @@ class Client extends openapi_core_1.default {
9711
9713
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeAutoProvisioningGroupInstancesResponse({}));
9712
9714
  }
9713
9715
  /**
9714
- * Queries information about Elastic Compute Service (ECS) instances in an auto provisioning group.
9716
+ * Queries information about instances in an auto provisioning group.
9715
9717
  *
9716
9718
  * @param request - DescribeAutoProvisioningGroupInstancesRequest
9717
9719
  * @returns DescribeAutoProvisioningGroupInstancesResponse
@@ -9859,7 +9861,7 @@ class Client extends openapi_core_1.default {
9859
9861
  return await this.describeAutoSnapshotPolicyAssociationsWithOptions(request, runtime);
9860
9862
  }
9861
9863
  /**
9862
- * Queries the details of automatic snapshot policies that are created in a specific region.
9864
+ * Queries the details of automatic snapshot policies that are created in a specified region.
9863
9865
  *
9864
9866
  * @param request - DescribeAutoSnapshotPolicyExRequest
9865
9867
  * @param runtime - runtime options for this request RuntimeOptions
@@ -9918,7 +9920,7 @@ class Client extends openapi_core_1.default {
9918
9920
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeAutoSnapshotPolicyExResponse({}));
9919
9921
  }
9920
9922
  /**
9921
- * Queries the details of automatic snapshot policies that are created in a specific region.
9923
+ * Queries the details of automatic snapshot policies that are created in a specified region.
9922
9924
  *
9923
9925
  * @param request - DescribeAutoSnapshotPolicyExRequest
9924
9926
  * @returns DescribeAutoSnapshotPolicyExResponse
@@ -9928,43 +9930,37 @@ class Client extends openapi_core_1.default {
9928
9930
  return await this.describeAutoSnapshotPolicyExWithOptions(request, runtime);
9929
9931
  }
9930
9932
  /**
9931
- * 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`.
9933
+ * 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).
9932
9934
  *
9933
9935
  * @remarks
9934
- * 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.
9935
- * - Value precedence: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
9936
+ * 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.
9937
+ * - Value order: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
9936
9938
  * - Examples:
9937
- * - If `DestinationResource` is set to `DataDisk`:
9938
- * - 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.
9939
- * - 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.
9940
- * - 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.
9941
- * - If `DestinationResource` is set to `InstanceType`, we recommend specifying the `IoOptimized` and `InstanceType` parameters.
9942
- * - 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`.
9943
- * - 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`.
9939
+ * - If DestinationResource is set to `DataDisk`:
9940
+ * - 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.
9941
+ * - 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`.
9942
+ * - 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.
9943
+ * - If DestinationResource is set to `InstanceType`, specify the IoOptimized and InstanceType parameters.
9944
+ * - 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`.
9945
+ * - 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`.
9944
9946
  * <details>
9945
- * <summary>
9946
- * Query for availability zones in the China (Hangzhou) region that have the `ecs.g5.large` instance type.
9947
- * </summary>
9947
+ * <summary>Query the zones in the China (Hangzhou) region where the ecs.g5.large instance type is available.</summary>
9948
9948
  * ```
9949
9949
  * "RegionId": "cn-hangzhou",
9950
- * "DestinationResource": "Zone",
9950
+ * "DestinationResource": "Zone"
9951
9951
  * "InstanceType": "ecs.g5.large"
9952
9952
  * ```
9953
9953
  * </details>
9954
9954
  * <details>
9955
- * <summary>
9956
- * Query the inventory of the `ecs.g5.large` instance type across all availability zones in the China (Hangzhou) region.
9957
- * </summary>
9955
+ * <summary>Query the inventory of the ecs.g5.large instance type across all zones in the China (Hangzhou) region.</summary>
9958
9956
  * ```
9959
9957
  * "RegionId": "cn-hangzhou",
9960
- * "DestinationResource": "InstanceType",
9958
+ * "DestinationResource": "InstanceType"
9961
9959
  * "InstanceType": "ecs.g5.large"
9962
9960
  * ```
9963
9961
  * </details>
9964
9962
  * <details>
9965
- * <summary>
9966
- * Query the inventory of `cloud_efficiency` data disks in availability zone b of the China (Hangzhou) region, independent of any ECS instance type.
9967
- * </summary>
9963
+ * <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>
9968
9964
  * ```
9969
9965
  * "RegionId": "cn-hangzhou",
9970
9966
  * "ZoneId": "cn-hangzhou-b",
@@ -9973,9 +9969,7 @@ class Client extends openapi_core_1.default {
9973
9969
  * ```
9974
9970
  * </details>
9975
9971
  * <details>
9976
- * <summary>
9977
- * Query the inventory of `cloud_essd` system disks for the `ecs.g7.large` instance type in availability zone b of the China (Hangzhou) region.
9978
- * </summary>
9972
+ * <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>
9979
9973
  * ```
9980
9974
  * "RegionId": "cn-hangzhou",
9981
9975
  * "ZoneId": "cn-hangzhou-b",
@@ -10070,43 +10064,37 @@ class Client extends openapi_core_1.default {
10070
10064
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeAvailableResourceResponse({}));
10071
10065
  }
10072
10066
  /**
10073
- * 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`.
10067
+ * 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).
10074
10068
  *
10075
10069
  * @remarks
10076
- * 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.
10077
- * - Value precedence: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
10070
+ * 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.
10071
+ * - Value order: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
10078
10072
  * - Examples:
10079
- * - If `DestinationResource` is set to `DataDisk`:
10080
- * - 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.
10081
- * - 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.
10082
- * - 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.
10083
- * - If `DestinationResource` is set to `InstanceType`, we recommend specifying the `IoOptimized` and `InstanceType` parameters.
10084
- * - 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`.
10085
- * - 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`.
10073
+ * - If DestinationResource is set to `DataDisk`:
10074
+ * - 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.
10075
+ * - 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`.
10076
+ * - 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.
10077
+ * - If DestinationResource is set to `InstanceType`, specify the IoOptimized and InstanceType parameters.
10078
+ * - 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`.
10079
+ * - 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`.
10086
10080
  * <details>
10087
- * <summary>
10088
- * Query for availability zones in the China (Hangzhou) region that have the `ecs.g5.large` instance type.
10089
- * </summary>
10081
+ * <summary>Query the zones in the China (Hangzhou) region where the ecs.g5.large instance type is available.</summary>
10090
10082
  * ```
10091
10083
  * "RegionId": "cn-hangzhou",
10092
- * "DestinationResource": "Zone",
10084
+ * "DestinationResource": "Zone"
10093
10085
  * "InstanceType": "ecs.g5.large"
10094
10086
  * ```
10095
10087
  * </details>
10096
10088
  * <details>
10097
- * <summary>
10098
- * Query the inventory of the `ecs.g5.large` instance type across all availability zones in the China (Hangzhou) region.
10099
- * </summary>
10089
+ * <summary>Query the inventory of the ecs.g5.large instance type across all zones in the China (Hangzhou) region.</summary>
10100
10090
  * ```
10101
10091
  * "RegionId": "cn-hangzhou",
10102
- * "DestinationResource": "InstanceType",
10092
+ * "DestinationResource": "InstanceType"
10103
10093
  * "InstanceType": "ecs.g5.large"
10104
10094
  * ```
10105
10095
  * </details>
10106
10096
  * <details>
10107
- * <summary>
10108
- * Query the inventory of `cloud_efficiency` data disks in availability zone b of the China (Hangzhou) region, independent of any ECS instance type.
10109
- * </summary>
10097
+ * <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>
10110
10098
  * ```
10111
10099
  * "RegionId": "cn-hangzhou",
10112
10100
  * "ZoneId": "cn-hangzhou-b",
@@ -10115,9 +10103,7 @@ class Client extends openapi_core_1.default {
10115
10103
  * ```
10116
10104
  * </details>
10117
10105
  * <details>
10118
- * <summary>
10119
- * Query the inventory of `cloud_essd` system disks for the `ecs.g7.large` instance type in availability zone b of the China (Hangzhou) region.
10120
- * </summary>
10106
+ * <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>
10121
10107
  * ```
10122
10108
  * "RegionId": "cn-hangzhou",
10123
10109
  * "ZoneId": "cn-hangzhou-b",
@@ -11604,14 +11590,14 @@ class Client extends openapi_core_1.default {
11604
11590
  return await this.describeDiskMonitorDataWithOptions(request, runtime);
11605
11591
  }
11606
11592
  /**
11607
- * Queries information about one or more created block storage devices, including disks, local disks, and elastic ephemeral disks.
11593
+ * Queries information about one or more created block storage devices, including cloud disks, local disks, and elastic ephemeral disks.
11608
11594
  *
11609
11595
  * @remarks
11610
- * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. The logical relationship among these parameters is AND.
11611
- * - 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.
11612
- * - 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.
11613
- * - 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.
11614
- * 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).
11596
+ * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. These parameters have a logical AND relationship.
11597
+ * - 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.
11598
+ * - 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.
11599
+ * - 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.
11600
+ * 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).
11615
11601
  *
11616
11602
  * @param request - DescribeDisksRequest
11617
11603
  * @param runtime - runtime options for this request RuntimeOptions
@@ -11739,14 +11725,14 @@ class Client extends openapi_core_1.default {
11739
11725
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeDisksResponse({}));
11740
11726
  }
11741
11727
  /**
11742
- * Queries information about one or more created block storage devices, including disks, local disks, and elastic ephemeral disks.
11728
+ * Queries information about one or more created block storage devices, including cloud disks, local disks, and elastic ephemeral disks.
11743
11729
  *
11744
11730
  * @remarks
11745
- * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. The logical relationship among these parameters is AND.
11746
- * - 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.
11747
- * - 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.
11748
- * - 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.
11749
- * 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).
11731
+ * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. These parameters have a logical AND relationship.
11732
+ * - 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.
11733
+ * - 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.
11734
+ * - 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.
11735
+ * 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).
11750
11736
  *
11751
11737
  * @param request - DescribeDisksRequest
11752
11738
  * @returns DescribeDisksResponse
@@ -12489,7 +12475,7 @@ class Client extends openapi_core_1.default {
12489
12475
  * Queries the details of one or more image components.
12490
12476
  *
12491
12477
  * @remarks
12492
- * 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.
12478
+ * 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.
12493
12479
  *
12494
12480
  * @param request - DescribeImageComponentsRequest
12495
12481
  * @param runtime - runtime options for this request RuntimeOptions
@@ -12569,7 +12555,7 @@ class Client extends openapi_core_1.default {
12569
12555
  * Queries the details of one or more image components.
12570
12556
  *
12571
12557
  * @remarks
12572
- * 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.
12558
+ * 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.
12573
12559
  *
12574
12560
  * @param request - DescribeImageComponentsRequest
12575
12561
  * @returns DescribeImageComponentsResponse
@@ -12923,13 +12909,13 @@ class Client extends openapi_core_1.default {
12923
12909
  return await this.describeImageSupportInstanceTypesWithOptions(request, runtime);
12924
12910
  }
12925
12911
  /**
12926
- * Specify parameters such as ImageId, image usage scenario, and Filter to query the list of image resources you can use.
12912
+ * Queries the list of available image resources based on specified parameters such as ImageId, image usage scenarios, and filter conditions.
12927
12913
  *
12928
12914
  * @remarks
12929
- * - The image resources you can query include your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images actively shared with you by other Alibaba Cloud users.
12930
- * - Paged query is supported. The query results include the total number of usable image resources and the image resources on the current page. The default number of entries per page is 10.
12931
- * - When invoking the API through the Alibaba Cloud command-line interface (CLI), the values of request parameters of different data types must comply with format requirements. For more information, see [CLI Parameter Format Description](https://help.aliyun.com/document_detail/110340.html).
12932
- * - When querying official Alibaba Cloud images or shared images (where ImageOwnerAlias is set to system or others), RAM authentication rules are ignored for this request. For more information, see [Authentication Rules](https://help.aliyun.com/document_detail/25497.html).
12915
+ * - Image resources that you can query include your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images that other Alibaba Cloud users have shared with you.
12916
+ * - Paging is supported. The query results include the total number of available image resources and the image resources on the current page. The default number of entries per page is 10.
12917
+ * - When you invoke an API operation by using Cloud Assistant CLI, request parameters of different data types must comply with format requirements. For more information, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
12918
+ * - When you query images provided by Alibaba Cloud or shared images (ImageOwnerAlias is set to system or others), the request can bypass RAM authentication rules. For more information, see [Authentication rules](https://help.aliyun.com/document_detail/25497.html).
12933
12919
  *
12934
12920
  * @param request - DescribeImagesRequest
12935
12921
  * @param runtime - runtime options for this request RuntimeOptions
@@ -13036,13 +13022,13 @@ class Client extends openapi_core_1.default {
13036
13022
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeImagesResponse({}));
13037
13023
  }
13038
13024
  /**
13039
- * Specify parameters such as ImageId, image usage scenario, and Filter to query the list of image resources you can use.
13025
+ * Queries the list of available image resources based on specified parameters such as ImageId, image usage scenarios, and filter conditions.
13040
13026
  *
13041
13027
  * @remarks
13042
- * - The image resources you can query include your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images actively shared with you by other Alibaba Cloud users.
13043
- * - Paged query is supported. The query results include the total number of usable image resources and the image resources on the current page. The default number of entries per page is 10.
13044
- * - When invoking the API through the Alibaba Cloud command-line interface (CLI), the values of request parameters of different data types must comply with format requirements. For more information, see [CLI Parameter Format Description](https://help.aliyun.com/document_detail/110340.html).
13045
- * - When querying official Alibaba Cloud images or shared images (where ImageOwnerAlias is set to system or others), RAM authentication rules are ignored for this request. For more information, see [Authentication Rules](https://help.aliyun.com/document_detail/25497.html).
13028
+ * - Image resources that you can query include your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images that other Alibaba Cloud users have shared with you.
13029
+ * - Paging is supported. The query results include the total number of available image resources and the image resources on the current page. The default number of entries per page is 10.
13030
+ * - When you invoke an API operation by using Cloud Assistant CLI, request parameters of different data types must comply with format requirements. For more information, see [CLI parameter format](https://help.aliyun.com/document_detail/110340.html).
13031
+ * - When you query images provided by Alibaba Cloud or shared images (ImageOwnerAlias is set to system or others), the request can bypass RAM authentication rules. For more information, see [Authentication rules](https://help.aliyun.com/document_detail/25497.html).
13046
13032
  *
13047
13033
  * @param request - DescribeImagesRequest
13048
13034
  * @returns DescribeImagesResponse
@@ -13122,7 +13108,7 @@ class Client extends openapi_core_1.default {
13122
13108
  return await this.describeInstanceAttachmentAttributesWithOptions(request, runtime);
13123
13109
  }
13124
13110
  /**
13125
- * This API is used to query the attribute information of a specified ECS instance.
13111
+ * Queries the attribute information of a specified ECS instance.
13126
13112
  *
13127
13113
  * @param request - DescribeInstanceAttributeRequest
13128
13114
  * @param runtime - runtime options for this request RuntimeOptions
@@ -13163,7 +13149,7 @@ class Client extends openapi_core_1.default {
13163
13149
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeInstanceAttributeResponse({}));
13164
13150
  }
13165
13151
  /**
13166
- * This API is used to query the attribute information of a specified ECS instance.
13152
+ * Queries the attribute information of a specified ECS instance.
13167
13153
  *
13168
13154
  * @param request - DescribeInstanceAttributeRequest
13169
13155
  * @returns DescribeInstanceAttributeResponse
@@ -13244,12 +13230,12 @@ class Client extends openapi_core_1.default {
13244
13230
  return await this.describeInstanceAutoRenewAttributeWithOptions(request, runtime);
13245
13231
  }
13246
13232
  /**
13247
- * 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.
13233
+ * 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.
13248
13234
  *
13249
13235
  * @remarks
13250
- * - You can query completed historical system events from up to the last 30 days. There is no time limit for querying incomplete system events.
13251
- * - 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.
13252
- * - 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.
13236
+ * - You can query completed historical system events from the last 30 days. There is no time limit for querying uncompleted system events.
13237
+ * - If neither EventCycleStatus nor InstanceEventCycleStatus is specified, the query results include only system events in the Avoided, Executed, Canceled, and Failed states by default.
13238
+ * - By specifying the InstanceEventCycleStatus parameter, you can also query system events in the Scheduled, Executing, and Inquiring states.
13253
13239
  *
13254
13240
  * @param request - DescribeInstanceHistoryEventsRequest
13255
13241
  * @param runtime - runtime options for this request RuntimeOptions
@@ -13344,12 +13330,12 @@ class Client extends openapi_core_1.default {
13344
13330
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeInstanceHistoryEventsResponse({}));
13345
13331
  }
13346
13332
  /**
13347
- * 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.
13333
+ * 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.
13348
13334
  *
13349
13335
  * @remarks
13350
- * - You can query completed historical system events from up to the last 30 days. There is no time limit for querying incomplete system events.
13351
- * - 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.
13352
- * - 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.
13336
+ * - You can query completed historical system events from the last 30 days. There is no time limit for querying uncompleted system events.
13337
+ * - If neither EventCycleStatus nor InstanceEventCycleStatus is specified, the query results include only system events in the Avoided, Executed, Canceled, and Failed states by default.
13338
+ * - By specifying the InstanceEventCycleStatus parameter, you can also query system events in the Scheduled, Executing, and Inquiring states.
13353
13339
  *
13354
13340
  * @param request - DescribeInstanceHistoryEventsRequest
13355
13341
  * @returns DescribeInstanceHistoryEventsResponse
@@ -14161,14 +14147,14 @@ class Client extends openapi_core_1.default {
14161
14147
  return await this.describeInstanceVncUrlWithOptions(request, runtime);
14162
14148
  }
14163
14149
  /**
14164
- * This operation queries a list of instances based on specified conditions and returns detailed information about the instances.
14150
+ * Queries a list of instances based on specified request conditions and returns the associated detailed information of the instances.
14165
14151
  *
14166
14152
  * @remarks
14153
+ * ### Before you begin
14154
+ * - 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).
14167
14155
  * ### Usage notes
14168
- * - 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).
14169
- * ### Recommendations
14170
- * - We recommend that you perform a dry run by setting the DryRun parameter to check parameter validity and authorization status.
14171
- * - 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.
14156
+ * - Send a dry run request by using the DryRun request parameter to check the validity of parameters and authorization.
14157
+ * - 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.
14172
14158
  *
14173
14159
  * @param request - DescribeInstancesRequest
14174
14160
  * @param runtime - runtime options for this request RuntimeOptions
@@ -14320,14 +14306,14 @@ class Client extends openapi_core_1.default {
14320
14306
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeInstancesResponse({}));
14321
14307
  }
14322
14308
  /**
14323
- * This operation queries a list of instances based on specified conditions and returns detailed information about the instances.
14309
+ * Queries a list of instances based on specified request conditions and returns the associated detailed information of the instances.
14324
14310
  *
14325
14311
  * @remarks
14312
+ * ### Before you begin
14313
+ * - 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).
14326
14314
  * ### Usage notes
14327
- * - 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).
14328
- * ### Recommendations
14329
- * - We recommend that you perform a dry run by setting the DryRun parameter to check parameter validity and authorization status.
14330
- * - 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.
14315
+ * - Send a dry run request by using the DryRun request parameter to check the validity of parameters and authorization.
14316
+ * - 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.
14331
14317
  *
14332
14318
  * @param request - DescribeInstancesRequest
14333
14319
  * @returns DescribeInstancesResponse
@@ -14431,22 +14417,22 @@ class Client extends openapi_core_1.default {
14431
14417
  return await this.describeInstancesFullStatusWithOptions(request, runtime);
14432
14418
  }
14433
14419
  /**
14434
- * $.parameters[11].schema.items.properties.Value.example
14420
+ * Queries the execution results of one or more Cloud Assistant commands, which are the actual execution results on ECS instances.
14435
14421
  *
14436
14422
  * @remarks
14437
- * ## API Guide
14438
- * - 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.
14439
- * - You can query execution information from the last four weeks, with a maximum retention limit of 100,000 records.
14440
- * - 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.
14441
- * - 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.
14423
+ * ## Operation description
14424
+ * - 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.
14425
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
14426
+ * - 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.
14427
+ * - 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.
14442
14428
  * - Differences between `DescribeInvocations` and `DescribeInvocationResults`:
14443
- * - When a single `RunCommand`/`InvokeCommand` invocation targets multiple instances:
14444
- * - `DescribeInvocations` provides the execution status on each instance and an aggregation status across all instances.
14445
- * - `DescribeInvocationResults` only provides individual execution statuses per instance, without aggregated multi-instance status.
14446
- * - When a single `RunCommand`/`InvokeCommand` invocation targets one instance:
14447
- * - There is little difference between `DescribeInvocations` and `DescribeInvocationResults`, and they can fully replace each other.
14448
- * - 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.
14449
- * - When you need to view the command content or parameters, only `DescribeInvocations` returns `CommandContent`.
14429
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
14430
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
14431
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status across instances.
14432
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
14433
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
14434
+ * - 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.
14435
+ * - When you want to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
14450
14436
  *
14451
14437
  * @param request - DescribeInvocationResultsRequest
14452
14438
  * @param runtime - runtime options for this request RuntimeOptions
@@ -14526,22 +14512,22 @@ class Client extends openapi_core_1.default {
14526
14512
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeInvocationResultsResponse({}));
14527
14513
  }
14528
14514
  /**
14529
- * $.parameters[11].schema.items.properties.Value.example
14515
+ * Queries the execution results of one or more Cloud Assistant commands, which are the actual execution results on ECS instances.
14530
14516
  *
14531
14517
  * @remarks
14532
- * ## API Guide
14533
- * - 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.
14534
- * - You can query execution information from the last four weeks, with a maximum retention limit of 100,000 records.
14535
- * - 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.
14536
- * - 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.
14518
+ * ## Operation description
14519
+ * - 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.
14520
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
14521
+ * - 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.
14522
+ * - 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.
14537
14523
  * - Differences between `DescribeInvocations` and `DescribeInvocationResults`:
14538
- * - When a single `RunCommand`/`InvokeCommand` invocation targets multiple instances:
14539
- * - `DescribeInvocations` provides the execution status on each instance and an aggregation status across all instances.
14540
- * - `DescribeInvocationResults` only provides individual execution statuses per instance, without aggregated multi-instance status.
14541
- * - When a single `RunCommand`/`InvokeCommand` invocation targets one instance:
14542
- * - There is little difference between `DescribeInvocations` and `DescribeInvocationResults`, and they can fully replace each other.
14543
- * - 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.
14544
- * - When you need to view the command content or parameters, only `DescribeInvocations` returns `CommandContent`.
14524
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
14525
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
14526
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status across instances.
14527
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
14528
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
14529
+ * - 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.
14530
+ * - When you want to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
14545
14531
  *
14546
14532
  * @param request - DescribeInvocationResultsRequest
14547
14533
  * @returns DescribeInvocationResultsResponse
@@ -14551,21 +14537,21 @@ class Client extends openapi_core_1.default {
14551
14537
  return await this.describeInvocationResultsWithOptions(request, runtime);
14552
14538
  }
14553
14539
  /**
14554
- * Invoke the DescribeInvocations API to query the execution list and status of Cloud Assistant commands.
14540
+ * Queries the execution list and status of Cloud Assistant commands.
14555
14541
  *
14556
14542
  * @remarks
14557
- * - 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.
14558
- * - You can query execution information from the past four weeks, with a maximum retention limit of 100,000 records.
14559
- * - 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.
14560
- * - 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.
14543
+ * - 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.
14544
+ * - You can query execution information from the last 30 days. A maximum of 10,000 execution records are retained.
14545
+ * - 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.
14546
+ * - 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.
14561
14547
  * - Differences between `DescribeInvocations` and `DescribeInvocationResults`:
14562
- * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
14563
- * - `DescribeInvocations` provides the execution status on each instance as well as the aggregated status across all instances.
14564
- * - `DescribeInvocationResults` only provides the individual execution status per instance, without the aggregated multi-instance status.
14565
- * - When a single `RunCommand`/`InvokeCommand` call specifies only one instance:
14566
- * - There is little difference between `DescribeInvocations` and `DescribeInvocationResults`, and they can be used interchangeably.
14567
- * - 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.
14568
- * - When you need to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
14548
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
14549
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
14550
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status.
14551
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
14552
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
14553
+ * - 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.
14554
+ * - To view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
14569
14555
  *
14570
14556
  * @param request - DescribeInvocationsRequest
14571
14557
  * @param runtime - runtime options for this request RuntimeOptions
@@ -14657,21 +14643,21 @@ class Client extends openapi_core_1.default {
14657
14643
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeInvocationsResponse({}));
14658
14644
  }
14659
14645
  /**
14660
- * Invoke the DescribeInvocations API to query the execution list and status of Cloud Assistant commands.
14646
+ * Queries the execution list and status of Cloud Assistant commands.
14661
14647
  *
14662
14648
  * @remarks
14663
- * - 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.
14664
- * - You can query execution information from the past four weeks, with a maximum retention limit of 100,000 records.
14665
- * - 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.
14666
- * - 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.
14649
+ * - 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.
14650
+ * - You can query execution information from the last 30 days. A maximum of 10,000 execution records are retained.
14651
+ * - 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.
14652
+ * - 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.
14667
14653
  * - Differences between `DescribeInvocations` and `DescribeInvocationResults`:
14668
- * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
14669
- * - `DescribeInvocations` provides the execution status on each instance as well as the aggregated status across all instances.
14670
- * - `DescribeInvocationResults` only provides the individual execution status per instance, without the aggregated multi-instance status.
14671
- * - When a single `RunCommand`/`InvokeCommand` call specifies only one instance:
14672
- * - There is little difference between `DescribeInvocations` and `DescribeInvocationResults`, and they can be used interchangeably.
14673
- * - 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.
14674
- * - When you need to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
14654
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
14655
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
14656
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status.
14657
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
14658
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
14659
+ * - 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.
14660
+ * - To view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
14675
14661
  *
14676
14662
  * @param request - DescribeInvocationsRequest
14677
14663
  * @returns DescribeInvocationsResponse
@@ -14750,7 +14736,7 @@ class Client extends openapi_core_1.default {
14750
14736
  return await this.describeKeyPairsWithOptions(request, runtime);
14751
14737
  }
14752
14738
  /**
14753
- * Query information about ECS instance launch template versions, such as the total number of launch templates, template name, and template version number.
14739
+ * Queries information about launch template versions of ECS instances, such as the total number of launch templates, template names, and template version numbers.
14754
14740
  *
14755
14741
  * @param request - DescribeLaunchTemplateVersionsRequest
14756
14742
  * @param runtime - runtime options for this request RuntimeOptions
@@ -14818,7 +14804,7 @@ class Client extends openapi_core_1.default {
14818
14804
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeLaunchTemplateVersionsResponse({}));
14819
14805
  }
14820
14806
  /**
14821
- * Query information about ECS instance launch template versions, such as the total number of launch templates, template name, and template version number.
14807
+ * Queries information about launch template versions of ECS instances, such as the total number of launch templates, template names, and template version numbers.
14822
14808
  *
14823
14809
  * @param request - DescribeLaunchTemplateVersionsRequest
14824
14810
  * @returns DescribeLaunchTemplateVersionsResponse
@@ -16045,17 +16031,18 @@ class Client extends openapi_core_1.default {
16045
16031
  return await this.describePrefixListsWithOptions(request, runtime);
16046
16032
  }
16047
16033
  /**
16048
- * 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.
16034
+ * 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.
16049
16035
  *
16050
16036
  * @remarks
16051
- * Parameter settings vary depending on the resource type you are querying:
16052
- * - 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.
16053
- * - 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`.
16054
- * - If you set `ResourceType` to `diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
16055
- * - If you set `ResourceType` to `ddh`, you must also specify `DedicatedHostType`.
16056
- * - If you set `ResourceType` to `ElasticityAssurance`, you must also specify `InstanceType`.
16057
- * - If you set `ResourceType` to `CapacityReservation`, you must also specify `InstanceType`.
16058
- * - If you set `ResourceType` to `bandwidth`, this operation returns only pay-by-traffic (`PayByTraffic`) prices.
16037
+ * The parameter settings vary based on the resource type:
16038
+ * - When `ResourceType=instance`, you must also specify `InstanceType`.
16039
+ * 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.
16040
+ * - 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`.
16041
+ * - When `ResourceType=diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
16042
+ * - When `ResourceType=ddh`, you must also specify `DedicatedHostType`.
16043
+ * - When `ResourceType=ElasticityAssurance`, you must also specify `InstanceType`.
16044
+ * - When `ResourceType=CapacityReservation`, you must also specify `InstanceType`.
16045
+ * - When `ResourceType=bandwidth`, only the pay-by-traffic (`PayByTraffic`) price is returned.
16059
16046
  *
16060
16047
  * @param request - DescribePriceRequest
16061
16048
  * @param runtime - runtime options for this request RuntimeOptions
@@ -16180,17 +16167,18 @@ class Client extends openapi_core_1.default {
16180
16167
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribePriceResponse({}));
16181
16168
  }
16182
16169
  /**
16183
- * 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.
16170
+ * 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.
16184
16171
  *
16185
16172
  * @remarks
16186
- * Parameter settings vary depending on the resource type you are querying:
16187
- * - 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.
16188
- * - 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`.
16189
- * - If you set `ResourceType` to `diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
16190
- * - If you set `ResourceType` to `ddh`, you must also specify `DedicatedHostType`.
16191
- * - If you set `ResourceType` to `ElasticityAssurance`, you must also specify `InstanceType`.
16192
- * - If you set `ResourceType` to `CapacityReservation`, you must also specify `InstanceType`.
16193
- * - If you set `ResourceType` to `bandwidth`, this operation returns only pay-by-traffic (`PayByTraffic`) prices.
16173
+ * The parameter settings vary based on the resource type:
16174
+ * - When `ResourceType=instance`, you must also specify `InstanceType`.
16175
+ * 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.
16176
+ * - 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`.
16177
+ * - When `ResourceType=diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
16178
+ * - When `ResourceType=ddh`, you must also specify `DedicatedHostType`.
16179
+ * - When `ResourceType=ElasticityAssurance`, you must also specify `InstanceType`.
16180
+ * - When `ResourceType=CapacityReservation`, you must also specify `InstanceType`.
16181
+ * - When `ResourceType=bandwidth`, only the pay-by-traffic (`PayByTraffic`) price is returned.
16194
16182
  *
16195
16183
  * @param request - DescribePriceRequest
16196
16184
  * @returns DescribePriceResponse
@@ -16200,7 +16188,7 @@ class Client extends openapi_core_1.default {
16200
16188
  return await this.describePriceWithOptions(request, runtime);
16201
16189
  }
16202
16190
  /**
16203
- * 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.
16191
+ * (Beta) Queries one or more alternative instance types based on a specified instance type. For instance types that have been or will be retired, DescribeRecommendInstanceType lists all instance types that can serve as replacements.
16204
16192
  *
16205
16193
  * @param request - DescribeRecommendInstanceTypeRequest
16206
16194
  * @param runtime - runtime options for this request RuntimeOptions
@@ -16286,7 +16274,7 @@ class Client extends openapi_core_1.default {
16286
16274
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeRecommendInstanceTypeResponse({}));
16287
16275
  }
16288
16276
  /**
16289
- * 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.
16277
+ * (Beta) Queries one or more alternative instance types based on a specified instance type. For instance types that have been or will be retired, DescribeRecommendInstanceType lists all instance types that can serve as replacements.
16290
16278
  *
16291
16279
  * @param request - DescribeRecommendInstanceTypeRequest
16292
16280
  * @returns DescribeRecommendInstanceTypeResponse
@@ -16691,42 +16679,42 @@ class Client extends openapi_core_1.default {
16691
16679
  return await this.describeResourceByTagsWithOptions(request, runtime);
16692
16680
  }
16693
16681
  /**
16694
- * 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.
16682
+ * 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.
16695
16683
  *
16696
16684
  * @remarks
16697
- * Examples of common scenarios in which this operation is used:
16698
- * ### [](#-1)Example 1: Query the instance types to which you can change the instance type of an instance.
16699
- * 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.
16685
+ * The following examples describe common change scenarios:
16686
+ * ### Example 1: Query instance types to which the current instance can be changed
16687
+ * 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.
16700
16688
  * ```
16701
16689
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
16702
- * &RegionId=cn-hangzhou
16690
+ * &RegionId=ap-southeast-1
16703
16691
  * &ResourceId=i-bp67acfmxazb4p****
16704
16692
  * &DestinationResource=InstanceType
16705
16693
  * &OperationType=Upgrade
16706
- * &<Common request parameters>
16694
+ * &Common request parameters
16707
16695
  * ```
16708
- * ### [](#-2)Example 2: Query the instance types to which you can change the instance type of an instance after a system disk category change.
16709
- * 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.
16696
+ * ### Example 2: Query instance types available after changing the disk type of the current instance
16697
+ * 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.
16710
16698
  * ```
16711
16699
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
16712
- * &RegionId=cn-hangzhou
16700
+ * &RegionId=ap-southeast-1
16713
16701
  * &ResourceId=i-bp67acfmxazb4p****
16714
16702
  * &DestinationResource=InstanceType
16715
16703
  * &OperationType=Upgrade
16716
16704
  * &Conditions.0=DiskCategory
16717
- * &<Common request parameters>
16705
+ * &Common request parameters
16718
16706
  * ```
16719
- * ### [](#-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.
16720
- * 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.
16721
- * > 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.
16707
+ * ### Example 3: Query the disk type required by the target instance type
16708
+ * 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.
16709
+ * > The target instance type must be obtained by using Example 2.
16722
16710
  * ```
16723
16711
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
16724
- * &RegionId=cn-hangzhou
16712
+ * &RegionId=ap-southeast-1
16725
16713
  * &ResourceId=i-bp67acfmxazb4p****
16726
16714
  * &DestinationResource=SystemDisk
16727
16715
  * &OperationType=Upgrade
16728
16716
  * &InstanceType=ecs.g7.large
16729
- * &<Common request parameters>
16717
+ * &Common request parameters
16730
16718
  * ```
16731
16719
  *
16732
16720
  * @param request - DescribeResourcesModificationRequest
@@ -16795,42 +16783,42 @@ class Client extends openapi_core_1.default {
16795
16783
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeResourcesModificationResponse({}));
16796
16784
  }
16797
16785
  /**
16798
- * 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.
16786
+ * 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.
16799
16787
  *
16800
16788
  * @remarks
16801
- * Examples of common scenarios in which this operation is used:
16802
- * ### [](#-1)Example 1: Query the instance types to which you can change the instance type of an instance.
16803
- * 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.
16789
+ * The following examples describe common change scenarios:
16790
+ * ### Example 1: Query instance types to which the current instance can be changed
16791
+ * 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.
16804
16792
  * ```
16805
16793
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
16806
- * &RegionId=cn-hangzhou
16794
+ * &RegionId=ap-southeast-1
16807
16795
  * &ResourceId=i-bp67acfmxazb4p****
16808
16796
  * &DestinationResource=InstanceType
16809
16797
  * &OperationType=Upgrade
16810
- * &<Common request parameters>
16798
+ * &Common request parameters
16811
16799
  * ```
16812
- * ### [](#-2)Example 2: Query the instance types to which you can change the instance type of an instance after a system disk category change.
16813
- * 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.
16800
+ * ### Example 2: Query instance types available after changing the disk type of the current instance
16801
+ * 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.
16814
16802
  * ```
16815
16803
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
16816
- * &RegionId=cn-hangzhou
16804
+ * &RegionId=ap-southeast-1
16817
16805
  * &ResourceId=i-bp67acfmxazb4p****
16818
16806
  * &DestinationResource=InstanceType
16819
16807
  * &OperationType=Upgrade
16820
16808
  * &Conditions.0=DiskCategory
16821
- * &<Common request parameters>
16809
+ * &Common request parameters
16822
16810
  * ```
16823
- * ### [](#-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.
16824
- * 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.
16825
- * > 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.
16811
+ * ### Example 3: Query the disk type required by the target instance type
16812
+ * 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.
16813
+ * > The target instance type must be obtained by using Example 2.
16826
16814
  * ```
16827
16815
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
16828
- * &RegionId=cn-hangzhou
16816
+ * &RegionId=ap-southeast-1
16829
16817
  * &ResourceId=i-bp67acfmxazb4p****
16830
16818
  * &DestinationResource=SystemDisk
16831
16819
  * &OperationType=Upgrade
16832
16820
  * &InstanceType=ecs.g7.large
16833
- * &<Common request parameters>
16821
+ * &Common request parameters
16834
16822
  * ```
16835
16823
  *
16836
16824
  * @param request - DescribeResourcesModificationRequest
@@ -17103,7 +17091,7 @@ class Client extends openapi_core_1.default {
17103
17091
  return await this.describeSavingsPlanPriceWithOptions(request, runtime);
17104
17092
  }
17105
17093
  /**
17106
- * Queries the details of a specified security group and the security group rules of the security group.
17094
+ * Queries the details of a specified security group, including the list of security group rules.
17107
17095
  *
17108
17096
  * @param request - DescribeSecurityGroupAttributeRequest
17109
17097
  * @param runtime - runtime options for this request RuntimeOptions
@@ -17162,7 +17150,7 @@ class Client extends openapi_core_1.default {
17162
17150
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSecurityGroupAttributeResponse({}));
17163
17151
  }
17164
17152
  /**
17165
- * Queries the details of a specified security group and the security group rules of the security group.
17153
+ * Queries the details of a specified security group, including the list of security group rules.
17166
17154
  *
17167
17155
  * @param request - DescribeSecurityGroupAttributeRequest
17168
17156
  * @returns DescribeSecurityGroupAttributeResponse
@@ -17232,14 +17220,14 @@ class Client extends openapi_core_1.default {
17232
17220
  return await this.describeSecurityGroupReferencesWithOptions(request, runtime);
17233
17221
  }
17234
17222
  /**
17235
- * 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.
17223
+ * 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.
17236
17224
  *
17237
17225
  * @remarks
17238
- * - **Paged queries**: We recommend that you use the `MaxResults` and `NextToken` parameters for queries.
17239
- * - When the response does not contain `NextToken`, the current page is the last page and no more pages are available.
17240
- * - 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.
17241
- * - 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.
17242
- * - 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).
17226
+ * - **Paging query**: Use `MaxResults` and `NextToken` for paging query.
17227
+ * - If `NextToken` is not returned, the current page is the last page.
17228
+ * - 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.
17229
+ * - 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.
17230
+ * - 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).
17243
17231
  *
17244
17232
  * @param request - DescribeSecurityGroupsRequest
17245
17233
  * @param runtime - runtime options for this request RuntimeOptions
@@ -17328,14 +17316,14 @@ class Client extends openapi_core_1.default {
17328
17316
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSecurityGroupsResponse({}));
17329
17317
  }
17330
17318
  /**
17331
- * 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.
17319
+ * 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.
17332
17320
  *
17333
17321
  * @remarks
17334
- * - **Paged queries**: We recommend that you use the `MaxResults` and `NextToken` parameters for queries.
17335
- * - When the response does not contain `NextToken`, the current page is the last page and no more pages are available.
17336
- * - 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.
17337
- * - 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.
17338
- * - 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).
17322
+ * - **Paging query**: Use `MaxResults` and `NextToken` for paging query.
17323
+ * - If `NextToken` is not returned, the current page is the last page.
17324
+ * - 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.
17325
+ * - 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.
17326
+ * - 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).
17339
17327
  *
17340
17328
  * @param request - DescribeSecurityGroupsRequest
17341
17329
  * @returns DescribeSecurityGroupsResponse
@@ -17345,13 +17333,13 @@ class Client extends openapi_core_1.default {
17345
17333
  return await this.describeSecurityGroupsWithOptions(request, runtime);
17346
17334
  }
17347
17335
  /**
17348
- * Queries the files sent by Cloud Assistant and their status.
17336
+ * Queries the list and status of files sent by Cloud Assistant by calling DescribeSendFileResults.
17349
17337
  *
17350
17338
  * @remarks
17351
- * ## [](#)Usage notes
17352
- * - 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.
17353
- * - You can call this operation to query the file sending records within the last six weeks.
17354
- * - 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.
17339
+ * ## Operation description:
17340
+ * - 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.
17341
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
17342
+ * - 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.
17355
17343
  *
17356
17344
  * @param request - DescribeSendFileResultsRequest
17357
17345
  * @param runtime - runtime options for this request RuntimeOptions
@@ -17425,13 +17413,13 @@ class Client extends openapi_core_1.default {
17425
17413
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSendFileResultsResponse({}));
17426
17414
  }
17427
17415
  /**
17428
- * Queries the files sent by Cloud Assistant and their status.
17416
+ * Queries the list and status of files sent by Cloud Assistant by calling DescribeSendFileResults.
17429
17417
  *
17430
17418
  * @remarks
17431
- * ## [](#)Usage notes
17432
- * - 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.
17433
- * - You can call this operation to query the file sending records within the last six weeks.
17434
- * - 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.
17419
+ * ## Operation description:
17420
+ * - 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.
17421
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
17422
+ * - 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.
17435
17423
  *
17436
17424
  * @param request - DescribeSendFileResultsRequest
17437
17425
  * @returns DescribeSendFileResultsResponse
@@ -17741,47 +17729,39 @@ class Client extends openapi_core_1.default {
17741
17729
  return await this.describeSnapshotPackageWithOptions(request, runtime);
17742
17730
  }
17743
17731
  /**
17744
- * Queries details about a cloud disk\\"s snapshots, including their status, the time remaining until completion, and the retention days for automatic snapshots.
17732
+ * Queries the snapshot list of a disk, including snapshot status, remaining time for a snapshot being created, and automatic snapshot retention days.
17745
17733
  *
17746
17734
  * @remarks
17747
- * 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.
17748
- * 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).
17735
+ * 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.
17736
+ * 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).
17749
17737
  * Request examples:
17750
17738
  * <details>
17751
- * <summary>
17752
- * Query the snapshots of all cloud disks attached to an ECS instance in the China (Hangzhou) region
17753
- * </summary>
17739
+ * <summary>Query the snapshot list of all disks attached to an ECS instance in the China (Hangzhou) region</summary>
17754
17740
  * ```
17755
- * RegionId: cn-hangzhou, // The ID of the region.
17756
- * InstanceId: i-bp1fh7by6d9mw7zr**** // The ID of the instance to query.
17741
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
17742
+ * InstanceId: i-bp1fh7by6d9mw7zr**** // Set the instance ID to query.
17757
17743
  * ```
17758
17744
  * </details>
17759
17745
  * <details>
17760
- * <summary>
17761
- * Query the snapshots of a cloud disk in the China (Hangzhou) region
17762
- * </summary>
17746
+ * <summary>Query the snapshot information of a specific disk in the China (Hangzhou) region</summary>
17763
17747
  * ```
17764
- * RegionId: cn-hangzhou, // The ID of the region.
17765
- * DiskId: d-bp10e7ej8z743dmu**** // The ID of the cloud disk to query.
17748
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
17749
+ * DiskId: d-bp10e7ej8z743dmu**** // Set the disk ID to query.
17766
17750
  * ```
17767
17751
  * </details>
17768
17752
  * <details>
17769
- * <summary>
17770
- * Query two snapshots in the China (Hangzhou) region by snapshot ID
17771
- * </summary>
17753
+ * <summary>Query the information of two snapshots in the China (Hangzhou) region by snapshot ID</summary>
17772
17754
  * ```
17773
- * RegionId: cn-hangzhou, // The ID of the region.
17774
- * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // The snapshot IDs to query.
17755
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
17756
+ * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // Set the array of snapshot IDs to query.
17775
17757
  * ```
17776
17758
  * </details>
17777
17759
  * <details>
17778
- * <summary>
17779
- * Query snapshots created after a specific time in the China (Hangzhou) region
17780
- * </summary>
17760
+ * <summary>Query the snapshot information created after a specific point in time in the China (Hangzhou) region</summary>
17781
17761
  * ```
17782
- * RegionId: cn-hangzhou, // The ID of the region.
17783
- * Filter.1.Key: CreationStartTime, // Filters by the creation start time.
17784
- * Filter.1.Value: 2024-11-27T00:00Z
17762
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
17763
+ * Filter.1.Key: CreationStartTime, // Set the filter key for the creation start time.
17764
+ * Filter.1.Value: 2024-11-27T00:00Z.
17785
17765
  * ```
17786
17766
  * </details>
17787
17767
  *
@@ -17884,47 +17864,39 @@ class Client extends openapi_core_1.default {
17884
17864
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSnapshotsResponse({}));
17885
17865
  }
17886
17866
  /**
17887
- * Queries details about a cloud disk\\"s snapshots, including their status, the time remaining until completion, and the retention days for automatic snapshots.
17867
+ * Queries the snapshot list of a disk, including snapshot status, remaining time for a snapshot being created, and automatic snapshot retention days.
17888
17868
  *
17889
17869
  * @remarks
17890
- * 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.
17891
- * 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).
17870
+ * 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.
17871
+ * 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).
17892
17872
  * Request examples:
17893
17873
  * <details>
17894
- * <summary>
17895
- * Query the snapshots of all cloud disks attached to an ECS instance in the China (Hangzhou) region
17896
- * </summary>
17874
+ * <summary>Query the snapshot list of all disks attached to an ECS instance in the China (Hangzhou) region</summary>
17897
17875
  * ```
17898
- * RegionId: cn-hangzhou, // The ID of the region.
17899
- * InstanceId: i-bp1fh7by6d9mw7zr**** // The ID of the instance to query.
17876
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
17877
+ * InstanceId: i-bp1fh7by6d9mw7zr**** // Set the instance ID to query.
17900
17878
  * ```
17901
17879
  * </details>
17902
17880
  * <details>
17903
- * <summary>
17904
- * Query the snapshots of a cloud disk in the China (Hangzhou) region
17905
- * </summary>
17881
+ * <summary>Query the snapshot information of a specific disk in the China (Hangzhou) region</summary>
17906
17882
  * ```
17907
- * RegionId: cn-hangzhou, // The ID of the region.
17908
- * DiskId: d-bp10e7ej8z743dmu**** // The ID of the cloud disk to query.
17883
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
17884
+ * DiskId: d-bp10e7ej8z743dmu**** // Set the disk ID to query.
17909
17885
  * ```
17910
17886
  * </details>
17911
17887
  * <details>
17912
- * <summary>
17913
- * Query two snapshots in the China (Hangzhou) region by snapshot ID
17914
- * </summary>
17888
+ * <summary>Query the information of two snapshots in the China (Hangzhou) region by snapshot ID</summary>
17915
17889
  * ```
17916
- * RegionId: cn-hangzhou, // The ID of the region.
17917
- * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // The snapshot IDs to query.
17890
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
17891
+ * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // Set the array of snapshot IDs to query.
17918
17892
  * ```
17919
17893
  * </details>
17920
17894
  * <details>
17921
- * <summary>
17922
- * Query snapshots created after a specific time in the China (Hangzhou) region
17923
- * </summary>
17895
+ * <summary>Query the snapshot information created after a specific point in time in the China (Hangzhou) region</summary>
17924
17896
  * ```
17925
- * RegionId: cn-hangzhou, // The ID of the region.
17926
- * Filter.1.Key: CreationStartTime, // Filters by the creation start time.
17927
- * Filter.1.Value: 2024-11-27T00:00Z
17897
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
17898
+ * Filter.1.Key: CreationStartTime, // Set the filter key for the creation start time.
17899
+ * Filter.1.Value: 2024-11-27T00:00Z.
17928
17900
  * ```
17929
17901
  * </details>
17930
17902
  *
@@ -18092,11 +18064,11 @@ class Client extends openapi_core_1.default {
18092
18064
  return await this.describeSpotAdviceWithOptions(request, runtime);
18093
18065
  }
18094
18066
  /**
18095
- * 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.
18067
+ * 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.
18096
18068
  *
18097
18069
  * @remarks
18098
- * - This operation is applicable only to I/O optimized spot instances.
18099
- * - 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.
18070
+ * - Only I/O optimized spot instances are supported.
18071
+ * - 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.
18100
18072
  *
18101
18073
  * @param request - DescribeSpotPriceHistoryRequest
18102
18074
  * @param runtime - runtime options for this request RuntimeOptions
@@ -18167,11 +18139,11 @@ class Client extends openapi_core_1.default {
18167
18139
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeSpotPriceHistoryResponse({}));
18168
18140
  }
18169
18141
  /**
18170
- * 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.
18142
+ * 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.
18171
18143
  *
18172
18144
  * @remarks
18173
- * - This operation is applicable only to I/O optimized spot instances.
18174
- * - 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.
18145
+ * - Only I/O optimized spot instances are supported.
18146
+ * - 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.
18175
18147
  *
18176
18148
  * @param request - DescribeSpotPriceHistoryRequest
18177
18149
  * @returns DescribeSpotPriceHistoryResponse
@@ -18603,10 +18575,10 @@ class Client extends openapi_core_1.default {
18603
18575
  return await this.describeTasksWithOptions(request, runtime);
18604
18576
  }
18605
18577
  /**
18606
- * Queries the session records of Elastic Compute Service (ECS) Session Manager.
18578
+ * Queries the session history of Session Manager.
18607
18579
  *
18608
18580
  * @remarks
18609
- * You can query the session records of Session Manager that were generated in the last four weeks.
18581
+ * You can query Session Manager session records created within the last 30 days. A maximum of 1,000 successful records are retained.
18610
18582
  *
18611
18583
  * @param request - DescribeTerminalSessionsRequest
18612
18584
  * @param runtime - runtime options for this request RuntimeOptions
@@ -18659,10 +18631,10 @@ class Client extends openapi_core_1.default {
18659
18631
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeTerminalSessionsResponse({}));
18660
18632
  }
18661
18633
  /**
18662
- * Queries the session records of Elastic Compute Service (ECS) Session Manager.
18634
+ * Queries the session history of Session Manager.
18663
18635
  *
18664
18636
  * @remarks
18665
- * You can query the session records of Session Manager that were generated in the last four weeks.
18637
+ * You can query Session Manager session records created within the last 30 days. A maximum of 1,000 successful records are retained.
18666
18638
  *
18667
18639
  * @param request - DescribeTerminalSessionsRequest
18668
18640
  * @returns DescribeTerminalSessionsResponse
@@ -19200,11 +19172,10 @@ class Client extends openapi_core_1.default {
19200
19172
  return await this.describeVscsWithOptions(request, runtime);
19201
19173
  }
19202
19174
  /**
19203
- * Queries Alibaba Cloud regions. You can specify parameters, such as InstanceChargeType and ResourceType, in the request.
19175
+ * Queries the list of active zones based on parameters such as region ID and billing method.
19204
19176
  *
19205
19177
  * @remarks
19206
- * ## [](#)Usage notes
19207
- * 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.
19178
+ * 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).
19208
19179
  *
19209
19180
  * @param request - DescribeZonesRequest
19210
19181
  * @param runtime - runtime options for this request RuntimeOptions
@@ -19257,11 +19228,10 @@ class Client extends openapi_core_1.default {
19257
19228
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.DescribeZonesResponse({}));
19258
19229
  }
19259
19230
  /**
19260
- * Queries Alibaba Cloud regions. You can specify parameters, such as InstanceChargeType and ResourceType, in the request.
19231
+ * Queries the list of active zones based on parameters such as region ID and billing method.
19261
19232
  *
19262
19233
  * @remarks
19263
- * ## [](#)Usage notes
19264
- * 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.
19234
+ * 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).
19265
19235
  *
19266
19236
  * @param request - DescribeZonesRequest
19267
19237
  * @returns DescribeZonesResponse
@@ -20262,7 +20232,7 @@ class Client extends openapi_core_1.default {
20262
20232
  return await this.exportSnapshotWithOptions(request, runtime);
20263
20233
  }
20264
20234
  /**
20265
- * Retrieves the system command line output of an instance. The data is returned in Base64 encoding.
20235
+ * Retrieves the system command-line output of an instance. The data is returned in Base64-encoded format.
20266
20236
  *
20267
20237
  * @remarks
20268
20238
  * - 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.
@@ -20317,7 +20287,7 @@ class Client extends openapi_core_1.default {
20317
20287
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetInstanceConsoleOutputResponse({}));
20318
20288
  }
20319
20289
  /**
20320
- * Retrieves the system command line output of an instance. The data is returned in Base64 encoding.
20290
+ * Retrieves the system command-line output of an instance. The data is returned in Base64-encoded format.
20321
20291
  *
20322
20292
  * @remarks
20323
20293
  * - 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.
@@ -20332,13 +20302,13 @@ class Client extends openapi_core_1.default {
20332
20302
  return await this.getInstanceConsoleOutputWithOptions(request, runtime);
20333
20303
  }
20334
20304
  /**
20335
- * Calls GetInstanceScreenshot to obtain the screenshot information of an instance.
20305
+ * Calls GetInstanceScreenshot to retrieve the screenshot information of an instance.
20336
20306
  *
20337
20307
  * @remarks
20338
- * 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:
20308
+ * 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:
20339
20309
  * - The instance must be in the Running state.
20340
- * - You cannot obtain screenshot information for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
20341
- * - 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.
20310
+ * - Screenshots cannot be retrieved for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
20311
+ * - 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.
20342
20312
  *
20343
20313
  * @param request - GetInstanceScreenshotRequest
20344
20314
  * @param runtime - runtime options for this request RuntimeOptions
@@ -20388,13 +20358,13 @@ class Client extends openapi_core_1.default {
20388
20358
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.GetInstanceScreenshotResponse({}));
20389
20359
  }
20390
20360
  /**
20391
- * Calls GetInstanceScreenshot to obtain the screenshot information of an instance.
20361
+ * Calls GetInstanceScreenshot to retrieve the screenshot information of an instance.
20392
20362
  *
20393
20363
  * @remarks
20394
- * 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:
20364
+ * 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:
20395
20365
  * - The instance must be in the Running state.
20396
- * - You cannot obtain screenshot information for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
20397
- * - 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.
20366
+ * - Screenshots cannot be retrieved for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
20367
+ * - 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.
20398
20368
  *
20399
20369
  * @param request - GetInstanceScreenshotRequest
20400
20370
  * @returns GetInstanceScreenshotResponse
@@ -23195,7 +23165,7 @@ class Client extends openapi_core_1.default {
23195
23165
  return await this.modifyHaVipAttributeWithOptions(request, runtime);
23196
23166
  }
23197
23167
  /**
23198
- * Modifies the description of an HPC cluster by calling ModifyHpcClusterAttribute.
23168
+ * Modifies the description of an HPC cluster.
23199
23169
  *
23200
23170
  * @param request - ModifyHpcClusterAttributeRequest
23201
23171
  * @param runtime - runtime options for this request RuntimeOptions
@@ -23251,7 +23221,7 @@ class Client extends openapi_core_1.default {
23251
23221
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.ModifyHpcClusterAttributeResponse({}));
23252
23222
  }
23253
23223
  /**
23254
- * Modifies the description of an HPC cluster by calling ModifyHpcClusterAttribute.
23224
+ * Modifies the description of an HPC cluster.
23255
23225
  *
23256
23226
  * @param request - ModifyHpcClusterAttributeRequest
23257
23227
  * @returns ModifyHpcClusterAttributeResponse
@@ -23578,10 +23548,10 @@ class Client extends openapi_core_1.default {
23578
23548
  return await this.modifyInstanceAttachmentAttributesWithOptions(request, runtime);
23579
23549
  }
23580
23550
  /**
23581
- * This API modifies attributes of an ECS instance, such as the password, instance name, hostname, security group, MTU, and user data.
23551
+ * Modifies some properties of an ECS instance, including the password, instance name, hostname, security group membership, MTU, and instance user data.
23582
23552
  *
23583
23553
  * @remarks
23584
- * 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).
23554
+ * 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).
23585
23555
  *
23586
23556
  * @param request - ModifyInstanceAttributeRequest
23587
23557
  * @param runtime - runtime options for this request RuntimeOptions
@@ -23667,10 +23637,10 @@ class Client extends openapi_core_1.default {
23667
23637
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.ModifyInstanceAttributeResponse({}));
23668
23638
  }
23669
23639
  /**
23670
- * This API modifies attributes of an ECS instance, such as the password, instance name, hostname, security group, MTU, and user data.
23640
+ * Modifies some properties of an ECS instance, including the password, instance name, hostname, security group membership, MTU, and instance user data.
23671
23641
  *
23672
23642
  * @remarks
23673
- * 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).
23643
+ * 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).
23674
23644
  *
23675
23645
  * @param request - ModifyInstanceAttributeRequest
23676
23646
  * @returns ModifyInstanceAttributeResponse
@@ -24302,15 +24272,14 @@ class Client extends openapi_core_1.default {
24302
24272
  * 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.
24303
24273
  *
24304
24274
  * @remarks
24305
- * - 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.
24306
- * - 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.
24307
- * - 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.
24308
- * > 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~~).
24275
+ * - 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.
24276
+ * - 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.
24277
+ * > 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~~).
24309
24278
  *
24310
24279
  * - Fees:
24311
24280
  *
24312
- * - 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.
24313
- * - After downgrading bandwidth, the price difference is refunded through the original payment method. Coupons that have already been used are not refunded.
24281
+ * - 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.
24282
+ * - After the bandwidth is downgraded, the price difference is refunded to the original payment method. Vouchers that have been used are not refundable.
24314
24283
  *
24315
24284
  * @param request - ModifyInstanceNetworkSpecRequest
24316
24285
  * @param runtime - runtime options for this request RuntimeOptions
@@ -24381,15 +24350,14 @@ class Client extends openapi_core_1.default {
24381
24350
  * 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.
24382
24351
  *
24383
24352
  * @remarks
24384
- * - 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.
24385
- * - 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.
24386
- * - 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.
24387
- * > 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~~).
24353
+ * - 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.
24354
+ * - 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.
24355
+ * > 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~~).
24388
24356
  *
24389
24357
  * - Fees:
24390
24358
  *
24391
- * - 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.
24392
- * - After downgrading bandwidth, the price difference is refunded through the original payment method. Coupons that have already been used are not refunded.
24359
+ * - 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.
24360
+ * - After the bandwidth is downgraded, the price difference is refunded to the original payment method. Vouchers that have been used are not refundable.
24393
24361
  *
24394
24362
  * @param request - ModifyInstanceNetworkSpecRequest
24395
24363
  * @returns ModifyInstanceNetworkSpecResponse
@@ -24403,18 +24371,18 @@ class Client extends openapi_core_1.default {
24403
24371
  *
24404
24372
  * @remarks
24405
24373
  * <props="china">.
24406
- * **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.**.
24374
+ * **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.**.
24407
24375
  * .
24408
24376
  * <props="intl">.
24409
- * **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.**.
24377
+ * **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.**.
24410
24378
  * .
24411
24379
  * 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.
24412
24380
  * **Before you begin**.
24413
24381
  * - Your account must not have overdue payments.
24414
- * - Each call can modify only one configuration. You can change only the instance type or adjust only the public bandwidth in a single request.
24382
+ * - 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.
24415
24383
  * - The instance status must be **Running** (`Running`) or **Stopped** (`Stopped`) before you can adjust the public bandwidth. The change takes effect immediately.
24416
- * - 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.
24417
- * > 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~~).
24384
+ * - 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.
24385
+ * > 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~~).
24418
24386
  *
24419
24387
  * @param request - ModifyInstanceSpecRequest
24420
24388
  * @param runtime - runtime options for this request RuntimeOptions
@@ -24492,18 +24460,18 @@ class Client extends openapi_core_1.default {
24492
24460
  *
24493
24461
  * @remarks
24494
24462
  * <props="china">.
24495
- * **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.**.
24463
+ * **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.**.
24496
24464
  * .
24497
24465
  * <props="intl">.
24498
- * **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.**.
24466
+ * **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.**.
24499
24467
  * .
24500
24468
  * 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.
24501
24469
  * **Before you begin**.
24502
24470
  * - Your account must not have overdue payments.
24503
- * - Each call can modify only one configuration. You can change only the instance type or adjust only the public bandwidth in a single request.
24471
+ * - 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.
24504
24472
  * - The instance status must be **Running** (`Running`) or **Stopped** (`Stopped`) before you can adjust the public bandwidth. The change takes effect immediately.
24505
- * - 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.
24506
- * > 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~~).
24473
+ * - 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.
24474
+ * > 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~~).
24507
24475
  *
24508
24476
  * @param request - ModifyInstanceSpecRequest
24509
24477
  * @returns ModifyInstanceSpecResponse
@@ -25121,7 +25089,7 @@ class Client extends openapi_core_1.default {
25121
25089
  * Updates an O&M window.
25122
25090
  *
25123
25091
  * @remarks
25124
- * 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.
25092
+ * 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.
25125
25093
  *
25126
25094
  * @param tmpReq - ModifyPlanMaintenanceWindowRequest
25127
25095
  * @param runtime - runtime options for this request RuntimeOptions
@@ -25182,7 +25150,7 @@ class Client extends openapi_core_1.default {
25182
25150
  * Updates an O&M window.
25183
25151
  *
25184
25152
  * @remarks
25185
- * 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.
25153
+ * 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.
25186
25154
  *
25187
25155
  * @param request - ModifyPlanMaintenanceWindowRequest
25188
25156
  * @returns ModifyPlanMaintenanceWindowResponse
@@ -25351,20 +25319,24 @@ class Client extends openapi_core_1.default {
25351
25319
  return await this.modifyPrefixListWithOptions(request, runtime);
25352
25320
  }
25353
25321
  /**
25354
- * 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.
25322
+ * 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.
25355
25323
  *
25356
25324
  * @remarks
25357
- * *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.**
25358
- * 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.
25359
- * **Considerations**
25360
- * - Before you change the instance type of an expired instance, you must renew the instance.
25361
- * - When you downgrade the instance type of a subscription ECS instance, take note of the following items:
25362
- * - The instance must be in the **Stopped** (`Stopped`) state.
25363
- * - The price difference is refunded to the payment account that you used. Redeemed vouchers are not refundable.
25364
- * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html).
25365
- * - When you upgrade the instance type of a subscription ECS instance, take note of the following items:
25366
- * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
25367
- * - 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).
25325
+ * <props="china">
25326
+ * **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.**
25327
+ * <props="intl">
25328
+ * **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.**
25329
+ * 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.
25330
+ * **Precautions**
25331
+ * - 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.
25332
+ * - Expired instances cannot be changed to a different instance type. Complete the renewal and try again.
25333
+ * - Downgrade the instance type:
25334
+ * - The instance must be in the **Stopped** (`Stopped`) state.
25335
+ * - 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.
25336
+ * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html) after the Upgrade/Downgrade.
25337
+ * - Upgrade the instance type:
25338
+ * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
25339
+ * - 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).
25368
25340
  *
25369
25341
  * @param request - ModifyPrepayInstanceSpecRequest
25370
25342
  * @param runtime - runtime options for this request RuntimeOptions
@@ -25441,20 +25413,24 @@ class Client extends openapi_core_1.default {
25441
25413
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.ModifyPrepayInstanceSpecResponse({}));
25442
25414
  }
25443
25415
  /**
25444
- * 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.
25416
+ * 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.
25445
25417
  *
25446
25418
  * @remarks
25447
- * *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.**
25448
- * 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.
25449
- * **Considerations**
25450
- * - Before you change the instance type of an expired instance, you must renew the instance.
25451
- * - When you downgrade the instance type of a subscription ECS instance, take note of the following items:
25452
- * - The instance must be in the **Stopped** (`Stopped`) state.
25453
- * - The price difference is refunded to the payment account that you used. Redeemed vouchers are not refundable.
25454
- * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html).
25455
- * - When you upgrade the instance type of a subscription ECS instance, take note of the following items:
25456
- * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
25457
- * - 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).
25419
+ * <props="china">
25420
+ * **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.**
25421
+ * <props="intl">
25422
+ * **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.**
25423
+ * 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.
25424
+ * **Precautions**
25425
+ * - 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.
25426
+ * - Expired instances cannot be changed to a different instance type. Complete the renewal and try again.
25427
+ * - Downgrade the instance type:
25428
+ * - The instance must be in the **Stopped** (`Stopped`) state.
25429
+ * - 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.
25430
+ * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html) after the Upgrade/Downgrade.
25431
+ * - Upgrade the instance type:
25432
+ * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
25433
+ * - 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).
25458
25434
  *
25459
25435
  * @param request - ModifyPrepayInstanceSpecRequest
25460
25436
  * @returns ModifyPrepayInstanceSpecResponse
@@ -25966,12 +25942,12 @@ class Client extends openapi_core_1.default {
25966
25942
  return await this.modifySecurityGroupAttributeWithOptions(request, runtime);
25967
25943
  }
25968
25944
  /**
25969
- * Modifies an egress security group rule.
25945
+ * Modifies an outbound security group rule.
25970
25946
  *
25971
25947
  * @remarks
25972
- * When modifying security group rules by specifying the security group rule ID, note the following usage limits:
25973
- * - 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.
25974
- * - 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.
25948
+ * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
25949
+ * - 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.
25950
+ * - 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.
25975
25951
  *
25976
25952
  * @param request - ModifySecurityGroupEgressRuleRequest
25977
25953
  * @param runtime - runtime options for this request RuntimeOptions
@@ -26072,12 +26048,12 @@ class Client extends openapi_core_1.default {
26072
26048
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.ModifySecurityGroupEgressRuleResponse({}));
26073
26049
  }
26074
26050
  /**
26075
- * Modifies an egress security group rule.
26051
+ * Modifies an outbound security group rule.
26076
26052
  *
26077
26053
  * @remarks
26078
- * When modifying security group rules by specifying the security group rule ID, note the following usage limits:
26079
- * - 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.
26080
- * - 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.
26054
+ * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
26055
+ * - 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.
26056
+ * - 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.
26081
26057
  *
26082
26058
  * @param request - ModifySecurityGroupEgressRuleRequest
26083
26059
  * @returns ModifySecurityGroupEgressRuleResponse
@@ -26164,7 +26140,7 @@ class Client extends openapi_core_1.default {
26164
26140
  * @remarks
26165
26141
  * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
26166
26142
  * - 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.
26167
- * - 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.
26143
+ * - 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.
26168
26144
  *
26169
26145
  * @param request - ModifySecurityGroupRuleRequest
26170
26146
  * @param runtime - runtime options for this request RuntimeOptions
@@ -26270,7 +26246,7 @@ class Client extends openapi_core_1.default {
26270
26246
  * @remarks
26271
26247
  * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
26272
26248
  * - 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.
26273
- * - 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.
26249
+ * - 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.
26274
26250
  *
26275
26251
  * @param request - ModifySecurityGroupRuleRequest
26276
26252
  * @returns ModifySecurityGroupRuleResponse
@@ -26596,6 +26572,66 @@ class Client extends openapi_core_1.default {
26596
26572
  let runtime = new $dara.RuntimeOptions({});
26597
26573
  return await this.modifyStorageSetAttributeWithOptions(request, runtime);
26598
26574
  }
26575
+ /**
26576
+ * 修改计划内运维事件属性
26577
+ *
26578
+ * @remarks
26579
+ * ## 接口说明
26580
+ * - 只能修改状态为Scheduled的计划内运维事件。
26581
+ * - 传入的NotBefore不早于当前时间。
26582
+ * - 传入的NotBefore不晚于事件产生时初始的计划执行时间。
26583
+ *
26584
+ * @param request - ModifySystemEventAttributeRequest
26585
+ * @param runtime - runtime options for this request RuntimeOptions
26586
+ * @returns ModifySystemEventAttributeResponse
26587
+ */
26588
+ async modifySystemEventAttributeWithOptions(request, runtime) {
26589
+ request.validate();
26590
+ let query = {};
26591
+ if (!$dara.isNull(request.eventId)) {
26592
+ query["EventId"] = request.eventId;
26593
+ }
26594
+ if (!$dara.isNull(request.instanceId)) {
26595
+ query["InstanceId"] = request.instanceId;
26596
+ }
26597
+ if (!$dara.isNull(request.notBefore)) {
26598
+ query["NotBefore"] = request.notBefore;
26599
+ }
26600
+ if (!$dara.isNull(request.regionId)) {
26601
+ query["RegionId"] = request.regionId;
26602
+ }
26603
+ let req = new openapi_core_2.$OpenApiUtil.OpenApiRequest({
26604
+ query: openapi_core_2.OpenApiUtil.query(query),
26605
+ });
26606
+ let params = new openapi_core_2.$OpenApiUtil.Params({
26607
+ action: "ModifySystemEventAttribute",
26608
+ version: "2014-05-26",
26609
+ protocol: "HTTPS",
26610
+ pathname: "/",
26611
+ method: "POST",
26612
+ authType: "AK",
26613
+ style: "RPC",
26614
+ reqBodyType: "formData",
26615
+ bodyType: "json",
26616
+ });
26617
+ return $dara.cast(await this.callApi(params, req, runtime), new $_model.ModifySystemEventAttributeResponse({}));
26618
+ }
26619
+ /**
26620
+ * 修改计划内运维事件属性
26621
+ *
26622
+ * @remarks
26623
+ * ## 接口说明
26624
+ * - 只能修改状态为Scheduled的计划内运维事件。
26625
+ * - 传入的NotBefore不早于当前时间。
26626
+ * - 传入的NotBefore不晚于事件产生时初始的计划执行时间。
26627
+ *
26628
+ * @param request - ModifySystemEventAttributeRequest
26629
+ * @returns ModifySystemEventAttributeResponse
26630
+ */
26631
+ async modifySystemEventAttribute(request) {
26632
+ let runtime = new $dara.RuntimeOptions({});
26633
+ return await this.modifySystemEventAttributeWithOptions(request, runtime);
26634
+ }
26599
26635
  /**
26600
26636
  * Modifies the default user-level attributes.
26601
26637
  *
@@ -28253,7 +28289,7 @@ class Client extends openapi_core_1.default {
28253
28289
  return await this.renewDedicatedHostsWithOptions(request, runtime);
28254
28290
  }
28255
28291
  /**
28256
- * Renews elasticity assurances that you purchased.
28292
+ * Renews one or more purchased elasticity assurance services.
28257
28293
  *
28258
28294
  * @param request - RenewElasticityAssurancesRequest
28259
28295
  * @param runtime - runtime options for this request RuntimeOptions
@@ -28315,7 +28351,7 @@ class Client extends openapi_core_1.default {
28315
28351
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.RenewElasticityAssurancesResponse({}));
28316
28352
  }
28317
28353
  /**
28318
- * Renews elasticity assurances that you purchased.
28354
+ * Renews one or more purchased elasticity assurance services.
28319
28355
  *
28320
28356
  * @param request - RenewElasticityAssurancesRequest
28321
28357
  * @returns RenewElasticityAssurancesResponse
@@ -28954,61 +28990,57 @@ class Client extends openapi_core_1.default {
28954
28990
  return await this.resizeDiskWithOptions(request, runtime);
28955
28991
  }
28956
28992
  /**
28957
- * Deletes inbound security group rules from a specific security group.
28993
+ * Deletes one or more inbound security group rules from a specified security group.
28958
28994
  *
28959
28995
  * @remarks
28960
- * > 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.
28961
- * You can use one of the following groups of parameters to specify the security group rules that you want to delete:
28962
- * - 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.
28963
- * - If a specified security group rule ID does not exist, the call to RevokeSecurityGroup fails.
28964
- * - Parameters that start with Permissions.
28965
- * - If no security group rule matches the specified parameters, the call to RevokeSecurityGroup is successful but no security group rules are deleted.
28966
- * - Define an inbound security group rule by configuring the following parameters together:
28967
- * - Source: You can specify one parameter from SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcetPrefixListId (prefix list ID), and SourceGroupId (source security group ID).
28968
- * - PortRange: specifies the destination port range.
28969
- * - IpProtocol: specifies the protocol.
28970
- * - Policy: specifies the action.
28971
- * > You cannot specify the IDs of security group rules and the parameters that start with Permissions in the same request.
28972
- * ### [](#)Sample requests
28973
- * - Delete a security group rule based on the rule ID:
28974
- * <!---->
28996
+ * >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.
28997
+ * You can use one of the following methods to pass parameters to delete rules:
28998
+ * - Specify security group rule IDs to delete rules (recommended).
28999
+ * - If a specified security group rule ID does not exist, the API invocation fails.
29000
+ * - Specify Permissions to delete rules.
29001
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
29002
+ * - The following parameters are required to identify an inbound rule:
29003
+ * - Source settings: Set one of SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
29004
+ * - Destination port range: PortRange.
29005
+ * - Protocol type: IpProtocol.
29006
+ * - Access policy: Policy.
29007
+ * > You cannot specify both security group rule IDs and Permissions at the same time.
29008
+ * ### Request examples
29009
+ * - Delete by specifying security group rule IDs.
28975
29010
  * ```
28976
- * "SecurityGroupId":"sg-bp67acfmxazb4p****", //Specify the ID of the security group.
28977
- * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] //Specify the ID of the security group rule.
29011
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
29012
+ * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
28978
29013
  * ```
28979
- * - Delete a security group rule based on an IPv4 CIDR block:
28980
- * <!---->
29014
+ * - Delete by specifying an IP address range.
28981
29015
  * ```
28982
29016
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
28983
29017
  * "Permissions":[
28984
29018
  * {
28985
- * "SourceCidrIp":"10.0.0.0/8", //Specify the source IPv4 CIDR block.
28986
- * "IpProtocol":"TCP", //Specify the protocol.
28987
- * "PortRange":"80/80", //Specify the destination port range.
28988
- * "Policy":"accept" //Specify the action.
29019
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IP address range.
29020
+ * "IpProtocol":"TCP", // Specify the protocol type.
29021
+ * "PortRange":"80/80", // Specify the destination port range.
29022
+ * "Policy":"accept" // Specify the access policy.
28989
29023
  * }
28990
29024
  * ]
28991
29025
  * ```
28992
- * - Delete a security group rule in which a security group is referenced:
28993
- * <!---->
29026
+ * - Delete by specifying another security group.
28994
29027
  * ```
28995
29028
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
28996
29029
  * "Permissions":[
28997
29030
  * {
28998
- * "SourceGroupId":"sg-bp67acfmxa123b****", //Specify the ID of the source security group.
29031
+ * "SourceGroupId":"sg-bp67acfmxa123b****", // Specify the source security group ID.
28999
29032
  * "IpProtocol":"TCP,"
29000
29033
  * "PortRange":"80/80",
29001
29034
  * "Policy":"accept"
29002
29035
  * ]
29003
29036
  * }
29004
29037
  * ```
29005
- * - Delete a security group rule in which a prefix list is referenced:
29006
- * <!---->
29038
+ * - Delete by specifying a prefix list.
29007
29039
  * ```
29008
29040
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
29009
29041
  * "Permissions":[
29010
29042
  * {
29011
- * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", //Specify the ID of the source prefix list.
29043
+ * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list ID.
29012
29044
  * "IpProtocol":"TCP",
29013
29045
  * "PortRange":"80/80",
29014
29046
  * "Policy":"accept"
@@ -29121,61 +29153,57 @@ class Client extends openapi_core_1.default {
29121
29153
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.RevokeSecurityGroupResponse({}));
29122
29154
  }
29123
29155
  /**
29124
- * Deletes inbound security group rules from a specific security group.
29156
+ * Deletes one or more inbound security group rules from a specified security group.
29125
29157
  *
29126
29158
  * @remarks
29127
- * > 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.
29128
- * You can use one of the following groups of parameters to specify the security group rules that you want to delete:
29129
- * - 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.
29130
- * - If a specified security group rule ID does not exist, the call to RevokeSecurityGroup fails.
29131
- * - Parameters that start with Permissions.
29132
- * - If no security group rule matches the specified parameters, the call to RevokeSecurityGroup is successful but no security group rules are deleted.
29133
- * - Define an inbound security group rule by configuring the following parameters together:
29134
- * - Source: You can specify one parameter from SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcetPrefixListId (prefix list ID), and SourceGroupId (source security group ID).
29135
- * - PortRange: specifies the destination port range.
29136
- * - IpProtocol: specifies the protocol.
29137
- * - Policy: specifies the action.
29138
- * > You cannot specify the IDs of security group rules and the parameters that start with Permissions in the same request.
29139
- * ### [](#)Sample requests
29140
- * - Delete a security group rule based on the rule ID:
29141
- * <!---->
29159
+ * >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.
29160
+ * You can use one of the following methods to pass parameters to delete rules:
29161
+ * - Specify security group rule IDs to delete rules (recommended).
29162
+ * - If a specified security group rule ID does not exist, the API invocation fails.
29163
+ * - Specify Permissions to delete rules.
29164
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
29165
+ * - The following parameters are required to identify an inbound rule:
29166
+ * - Source settings: Set one of SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
29167
+ * - Destination port range: PortRange.
29168
+ * - Protocol type: IpProtocol.
29169
+ * - Access policy: Policy.
29170
+ * > You cannot specify both security group rule IDs and Permissions at the same time.
29171
+ * ### Request examples
29172
+ * - Delete by specifying security group rule IDs.
29142
29173
  * ```
29143
- * "SecurityGroupId":"sg-bp67acfmxazb4p****", //Specify the ID of the security group.
29144
- * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] //Specify the ID of the security group rule.
29174
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
29175
+ * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
29145
29176
  * ```
29146
- * - Delete a security group rule based on an IPv4 CIDR block:
29147
- * <!---->
29177
+ * - Delete by specifying an IP address range.
29148
29178
  * ```
29149
29179
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
29150
29180
  * "Permissions":[
29151
29181
  * {
29152
- * "SourceCidrIp":"10.0.0.0/8", //Specify the source IPv4 CIDR block.
29153
- * "IpProtocol":"TCP", //Specify the protocol.
29154
- * "PortRange":"80/80", //Specify the destination port range.
29155
- * "Policy":"accept" //Specify the action.
29182
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IP address range.
29183
+ * "IpProtocol":"TCP", // Specify the protocol type.
29184
+ * "PortRange":"80/80", // Specify the destination port range.
29185
+ * "Policy":"accept" // Specify the access policy.
29156
29186
  * }
29157
29187
  * ]
29158
29188
  * ```
29159
- * - Delete a security group rule in which a security group is referenced:
29160
- * <!---->
29189
+ * - Delete by specifying another security group.
29161
29190
  * ```
29162
29191
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
29163
29192
  * "Permissions":[
29164
29193
  * {
29165
- * "SourceGroupId":"sg-bp67acfmxa123b****", //Specify the ID of the source security group.
29194
+ * "SourceGroupId":"sg-bp67acfmxa123b****", // Specify the source security group ID.
29166
29195
  * "IpProtocol":"TCP,"
29167
29196
  * "PortRange":"80/80",
29168
29197
  * "Policy":"accept"
29169
29198
  * ]
29170
29199
  * }
29171
29200
  * ```
29172
- * - Delete a security group rule in which a prefix list is referenced:
29173
- * <!---->
29201
+ * - Delete by specifying a prefix list.
29174
29202
  * ```
29175
29203
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
29176
29204
  * "Permissions":[
29177
29205
  * {
29178
- * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", //Specify the ID of the source prefix list.
29206
+ * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list ID.
29179
29207
  * "IpProtocol":"TCP",
29180
29208
  * "PortRange":"80/80",
29181
29209
  * "Policy":"accept"
@@ -29194,14 +29222,14 @@ class Client extends openapi_core_1.default {
29194
29222
  * Deletes one or more outbound security group rules from a specified security group.
29195
29223
  *
29196
29224
  * @remarks
29197
- * >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.
29225
+ * >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.
29198
29226
  * You can use one of the following methods to pass parameters to delete security group rules:
29199
29227
  * - Delete rules by specifying security group rule IDs (recommended).
29200
- * - If the specified security group rule ID does not exist, an error is returned.
29228
+ * - If a specified security group rule ID does not exist, a fault is returned.
29201
29229
  * - Delete rules by specifying the Permissions parameter.
29202
- * - If the matching security group rule does not exist, the invoke succeeds but no rule is deleted.
29230
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
29203
29231
  * - The following parameters are required to delete a security group rule:
29204
- * - Destination settings: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
29232
+ * - Destination: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
29205
29233
  * - Destination port range: PortRange.
29206
29234
  * - Protocol type: IpProtocol.
29207
29235
  * - Access policy: Policy.
@@ -29212,15 +29240,15 @@ class Client extends openapi_core_1.default {
29212
29240
  * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
29213
29241
  * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
29214
29242
  * ```
29215
- * - Delete by IP address CIDR block.
29243
+ * - Delete by IP CIDR block.
29216
29244
  * ```
29217
29245
  * "SecurityGroupId":"sg-bp67acfmxazb4ph***",
29218
29246
  * "Permissions":[
29219
29247
  * {
29220
29248
  * "IpProtocol":"TCP", // Specify the protocol type.
29221
- * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP address CIDR block.
29249
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP CIDR block.
29222
29250
  * "PortRange":"22/22", // Specify the destination port range.
29223
- * "Policy":"accept" // Specify the access policy.
29251
+ * "Policy":"accept" // Specify the authorization policy.
29224
29252
  * }
29225
29253
  * ]
29226
29254
  * ```
@@ -29248,7 +29276,7 @@ class Client extends openapi_core_1.default {
29248
29276
  * "Policy":"accept",
29249
29277
  * }
29250
29278
  * ]
29251
- * ```.
29279
+ * ```
29252
29280
  *
29253
29281
  * @param request - RevokeSecurityGroupEgressRequest
29254
29282
  * @param runtime - runtime options for this request RuntimeOptions
@@ -29361,14 +29389,14 @@ class Client extends openapi_core_1.default {
29361
29389
  * Deletes one or more outbound security group rules from a specified security group.
29362
29390
  *
29363
29391
  * @remarks
29364
- * >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.
29392
+ * >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.
29365
29393
  * You can use one of the following methods to pass parameters to delete security group rules:
29366
29394
  * - Delete rules by specifying security group rule IDs (recommended).
29367
- * - If the specified security group rule ID does not exist, an error is returned.
29395
+ * - If a specified security group rule ID does not exist, a fault is returned.
29368
29396
  * - Delete rules by specifying the Permissions parameter.
29369
- * - If the matching security group rule does not exist, the invoke succeeds but no rule is deleted.
29397
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
29370
29398
  * - The following parameters are required to delete a security group rule:
29371
- * - Destination settings: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
29399
+ * - Destination: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
29372
29400
  * - Destination port range: PortRange.
29373
29401
  * - Protocol type: IpProtocol.
29374
29402
  * - Access policy: Policy.
@@ -29379,15 +29407,15 @@ class Client extends openapi_core_1.default {
29379
29407
  * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
29380
29408
  * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
29381
29409
  * ```
29382
- * - Delete by IP address CIDR block.
29410
+ * - Delete by IP CIDR block.
29383
29411
  * ```
29384
29412
  * "SecurityGroupId":"sg-bp67acfmxazb4ph***",
29385
29413
  * "Permissions":[
29386
29414
  * {
29387
29415
  * "IpProtocol":"TCP", // Specify the protocol type.
29388
- * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP address CIDR block.
29416
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP CIDR block.
29389
29417
  * "PortRange":"22/22", // Specify the destination port range.
29390
- * "Policy":"accept" // Specify the access policy.
29418
+ * "Policy":"accept" // Specify the authorization policy.
29391
29419
  * }
29392
29420
  * ]
29393
29421
  * ```
@@ -29415,7 +29443,7 @@ class Client extends openapi_core_1.default {
29415
29443
  * "Policy":"accept",
29416
29444
  * }
29417
29445
  * ]
29418
- * ```.
29446
+ * ```
29419
29447
  *
29420
29448
  * @param request - RevokeSecurityGroupEgressRequest
29421
29449
  * @returns RevokeSecurityGroupEgressResponse
@@ -30437,22 +30465,22 @@ class Client extends openapi_core_1.default {
30437
30465
  return await this.startInstancesWithOptions(request, runtime);
30438
30466
  }
30439
30467
  /**
30440
- * 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.
30468
+ * 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.
30441
30469
  *
30442
30470
  * @remarks
30443
- * ## API Guide
30444
- * 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:
30445
- * - The specified ECS instance must be in the running state.
30446
- * - 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.
30447
- * - 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.
30448
- * - 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).
30449
- * - Linux operating system: 2.2.3.256
30450
- * - Windows operating system: 2.1.3.256
30451
- * - After successful invocation of this API, the WebSocketUrl remains valid for 10 minutes.
30452
- * - If no data transmission occurs within 3 minutes after the session is established, Cloud Assistant shuts down the connection.
30453
- * - 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.
30454
- * - The port forwarding feature currently supports TCP port forwarding only and does not support UDP.
30455
- * - To permanently close a session and invalidate the WebSocketUrl, invoke the EndTerminalSession API.
30471
+ * ## Operation description
30472
+ * 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:
30473
+ * - The specified ECS instance must be in the Running state.
30474
+ * - 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.
30475
+ * - If Cloud Assistant Agent is not installed on the ECS instance, invoke [InstallCloudAssistant](https://help.aliyun.com/document_detail/85916.html) to install it.
30476
+ * - 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).
30477
+ * - Linux operating system: 2.2.3.256
30478
+ * - Windows operating system: 2.1.3.256
30479
+ * - After this operation is invoked, the WebSocketUrl is valid for 10 minutes.
30480
+ * - After a session is established, Cloud Assistant closes the connection if no data is transmitted for 3 minutes.
30481
+ * - 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.
30482
+ * - The port forwarding feature supports only TCP port forwarding. UDP is not supported.
30483
+ * - To permanently shutdown a session and invalidate the WebSocketUrl, invoke the EndTerminalSession operation.
30456
30484
  *
30457
30485
  * @param tmpReq - StartTerminalSessionRequest
30458
30486
  * @param runtime - runtime options for this request RuntimeOptions
@@ -30528,22 +30556,22 @@ class Client extends openapi_core_1.default {
30528
30556
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.StartTerminalSessionResponse({}));
30529
30557
  }
30530
30558
  /**
30531
- * 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.
30559
+ * 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.
30532
30560
  *
30533
30561
  * @remarks
30534
- * ## API Guide
30535
- * 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:
30536
- * - The specified ECS instance must be in the running state.
30537
- * - 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.
30538
- * - 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.
30539
- * - 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).
30540
- * - Linux operating system: 2.2.3.256
30541
- * - Windows operating system: 2.1.3.256
30542
- * - After successful invocation of this API, the WebSocketUrl remains valid for 10 minutes.
30543
- * - If no data transmission occurs within 3 minutes after the session is established, Cloud Assistant shuts down the connection.
30544
- * - 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.
30545
- * - The port forwarding feature currently supports TCP port forwarding only and does not support UDP.
30546
- * - To permanently close a session and invalidate the WebSocketUrl, invoke the EndTerminalSession API.
30562
+ * ## Operation description
30563
+ * 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:
30564
+ * - The specified ECS instance must be in the Running state.
30565
+ * - 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.
30566
+ * - If Cloud Assistant Agent is not installed on the ECS instance, invoke [InstallCloudAssistant](https://help.aliyun.com/document_detail/85916.html) to install it.
30567
+ * - 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).
30568
+ * - Linux operating system: 2.2.3.256
30569
+ * - Windows operating system: 2.1.3.256
30570
+ * - After this operation is invoked, the WebSocketUrl is valid for 10 minutes.
30571
+ * - After a session is established, Cloud Assistant closes the connection if no data is transmitted for 3 minutes.
30572
+ * - 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.
30573
+ * - The port forwarding feature supports only TCP port forwarding. UDP is not supported.
30574
+ * - To permanently shutdown a session and invalidate the WebSocketUrl, invoke the EndTerminalSession operation.
30547
30575
  *
30548
30576
  * @param request - StartTerminalSessionRequest
30549
30577
  * @returns StartTerminalSessionResponse
@@ -30553,13 +30581,13 @@ class Client extends openapi_core_1.default {
30553
30581
  return await this.startTerminalSessionWithOptions(request, runtime);
30554
30582
  }
30555
30583
  /**
30556
- * Stops an Elastic Compute Service (ECS) instance. You can specify parameters to determine whether to forcefully stop the instance and the stop mode.
30584
+ * Stops an Elastic Compute Service (ECS) instance. You can specify different stop strategies, stop modes, and batch operation modes to stop the ECS instance.
30557
30585
  *
30558
30586
  * @remarks
30559
- * 该接口为异步接口,实例的停止不是立即完成的,成功调用后,实例会先进入停止中(Stoping)状态,你可以调用 [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) 查看实例状态,当返回的状态为`Stopped `时代表启动成功。
30560
- * ### 使用须知
30561
- * - 被安全锁定的实例不能通过调用该接口停止。更多信息,请参见[资源安全锁定对调用 API 的影响](https://help.aliyun.com/document_detail/25695.html)
30562
- * - 开启 VPC 内实例节省停机模式后,您可以通过设置`StoppedMode=KeepCharging`开启普通停机模式,ECS 实例停止后会继续计费,并为您保留 ECS 实例规格库存和公网 IP 地址。
30587
+ * 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.
30588
+ * ### Before you begin
30589
+ * - 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).
30590
+ * - 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.
30563
30591
  *
30564
30592
  * @param request - StopInstanceRequest
30565
30593
  * @param runtime - runtime options for this request RuntimeOptions
@@ -30615,13 +30643,13 @@ class Client extends openapi_core_1.default {
30615
30643
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.StopInstanceResponse({}));
30616
30644
  }
30617
30645
  /**
30618
- * Stops an Elastic Compute Service (ECS) instance. You can specify parameters to determine whether to forcefully stop the instance and the stop mode.
30646
+ * Stops an Elastic Compute Service (ECS) instance. You can specify different stop strategies, stop modes, and batch operation modes to stop the ECS instance.
30619
30647
  *
30620
30648
  * @remarks
30621
- * 该接口为异步接口,实例的停止不是立即完成的,成功调用后,实例会先进入停止中(Stoping)状态,你可以调用 [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) 查看实例状态,当返回的状态为`Stopped `时代表启动成功。
30622
- * ### 使用须知
30623
- * - 被安全锁定的实例不能通过调用该接口停止。更多信息,请参见[资源安全锁定对调用 API 的影响](https://help.aliyun.com/document_detail/25695.html)
30624
- * - 开启 VPC 内实例节省停机模式后,您可以通过设置`StoppedMode=KeepCharging`开启普通停机模式,ECS 实例停止后会继续计费,并为您保留 ECS 实例规格库存和公网 IP 地址。
30649
+ * 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.
30650
+ * ### Before you begin
30651
+ * - 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).
30652
+ * - 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.
30625
30653
  *
30626
30654
  * @param request - StopInstanceRequest
30627
30655
  * @returns StopInstanceResponse
@@ -30631,13 +30659,13 @@ class Client extends openapi_core_1.default {
30631
30659
  return await this.stopInstanceWithOptions(request, runtime);
30632
30660
  }
30633
30661
  /**
30634
- * Stops Elastic Compute Service (ECS) instances. You can specify parameters to determine whether to forcefully stop the instances and the stop mode.
30662
+ * Stops one or more ECS instances. You can specify the stop method, stop mode, and batch operation mode.
30635
30663
  *
30636
30664
  * @remarks
30637
- * 该接口为异步接口,实例的停止不是立即完成的,成功调用后,实例会先进入停止中(Stoping)状态,你可以调用 [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) 查看实例状态,当返回的状态为`Stopped `时代表停止成功。
30638
- * ### 使用须知
30639
- * - 停止实例后实例不可用,请确认停止实例不会对您的业务造成影响。您可以调用 [StartInstance](https://help.aliyun.com/document_detail/2679679.html) [StartInstances](https://help.aliyun.com/document_detail/2679680.html) 接口启动实例。
30640
- * - 被安全锁定的实例不能通过调用该接口停止。更多信息,请参见[资源安全锁定对调用 API 的影响](https://help.aliyun.com/document_detail/25695.html)
30665
+ * 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.
30666
+ * ### Before you begin
30667
+ * - 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.
30668
+ * - 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).
30641
30669
  *
30642
30670
  * @param request - StopInstancesRequest
30643
30671
  * @param runtime - runtime options for this request RuntimeOptions
@@ -30693,13 +30721,13 @@ class Client extends openapi_core_1.default {
30693
30721
  return $dara.cast(await this.callApi(params, req, runtime), new $_model.StopInstancesResponse({}));
30694
30722
  }
30695
30723
  /**
30696
- * Stops Elastic Compute Service (ECS) instances. You can specify parameters to determine whether to forcefully stop the instances and the stop mode.
30724
+ * Stops one or more ECS instances. You can specify the stop method, stop mode, and batch operation mode.
30697
30725
  *
30698
30726
  * @remarks
30699
- * 该接口为异步接口,实例的停止不是立即完成的,成功调用后,实例会先进入停止中(Stoping)状态,你可以调用 [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) 查看实例状态,当返回的状态为`Stopped `时代表停止成功。
30700
- * ### 使用须知
30701
- * - 停止实例后实例不可用,请确认停止实例不会对您的业务造成影响。您可以调用 [StartInstance](https://help.aliyun.com/document_detail/2679679.html) [StartInstances](https://help.aliyun.com/document_detail/2679680.html) 接口启动实例。
30702
- * - 被安全锁定的实例不能通过调用该接口停止。更多信息,请参见[资源安全锁定对调用 API 的影响](https://help.aliyun.com/document_detail/25695.html)
30727
+ * 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.
30728
+ * ### Before you begin
30729
+ * - 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.
30730
+ * - 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).
30703
30731
  *
30704
30732
  * @param request - StopInstancesRequest
30705
30733
  * @returns StopInstancesResponse
@@ -30984,8 +31012,8 @@ class Client extends openapi_core_1.default {
30984
31012
  * @remarks
30985
31013
  * ## Operation description
30986
31014
  * When you invoke this operation, take note of the following items:
30987
- * - The Elastic Network Interface (ENI) must be in the **Active** (Available) or **InUse** state.
30988
- * - 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.
31015
+ * - The Elastic Network Interface (ENI) must be in the **Active** or **InUse** state.
31016
+ * - 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.
30989
31017
  *
30990
31018
  * @param request - UnassignIpv6AddressesRequest
30991
31019
  * @param runtime - runtime options for this request RuntimeOptions
@@ -31043,8 +31071,8 @@ class Client extends openapi_core_1.default {
31043
31071
  * @remarks
31044
31072
  * ## Operation description
31045
31073
  * When you invoke this operation, take note of the following items:
31046
- * - The Elastic Network Interface (ENI) must be in the **Active** (Available) or **InUse** state.
31047
- * - 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.
31074
+ * - The Elastic Network Interface (ENI) must be in the **Active** or **InUse** state.
31075
+ * - 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.
31048
31076
  *
31049
31077
  * @param request - UnassignIpv6AddressesRequest
31050
31078
  * @returns UnassignIpv6AddressesResponse