@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/src/client.ts CHANGED
@@ -105,7 +105,7 @@ export default class Client extends OpenApi {
105
105
  }
106
106
 
107
107
  /**
108
- * 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.
108
+ * 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.
109
109
  *
110
110
  * @param request - AcceptInquiredSystemEventRequest
111
111
  * @param runtime - runtime options for this request RuntimeOptions
@@ -164,7 +164,7 @@ export default class Client extends OpenApi {
164
164
  }
165
165
 
166
166
  /**
167
- * 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.
167
+ * 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.
168
168
  *
169
169
  * @param request - AcceptInquiredSystemEventRequest
170
170
  * @returns AcceptInquiredSystemEventResponse
@@ -806,9 +806,9 @@ export default class Client extends OpenApi {
806
806
  * 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:
807
807
  * - 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).
808
808
  * - The ENI must be in the Active (Available) or InUse state.
809
- * - When you operate on a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
810
- * - 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.
811
- * - If the ENI is in the Active (Available) state, up to 10 IPv6 addresses can be allocated.
809
+ * - 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.
810
+ * - 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.
811
+ * - If the ENI is in the Active (Available) state, you can allocate up to 10 IPv6 addresses to it.
812
812
  * - 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).
813
813
  * - After you successfully invoke this operation, you can obtain the allocated IPv6 address information from the response.
814
814
  *
@@ -892,9 +892,9 @@ export default class Client extends OpenApi {
892
892
  * 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:
893
893
  * - 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).
894
894
  * - The ENI must be in the Active (Available) or InUse state.
895
- * - When you operate on a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
896
- * - 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.
897
- * - If the ENI is in the Active (Available) state, up to 10 IPv6 addresses can be allocated.
895
+ * - 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.
896
+ * - 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.
897
+ * - If the ENI is in the Active (Available) state, you can allocate up to 10 IPv6 addresses to it.
898
898
  * - 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).
899
899
  * - After you successfully invoke this operation, you can obtain the allocated IPv6 address information from the response.
900
900
  *
@@ -907,14 +907,14 @@ export default class Client extends OpenApi {
907
907
  }
908
908
 
909
909
  /**
910
- * 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.
910
+ * 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.
911
911
  *
912
912
  * @remarks
913
- * ## [](#)Usage notes
914
- * - The ENI to which you want to assign IP prefixes must be in the Available (Available) or InUse (InUse) state.
915
- * - 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.
916
- * - 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).
917
- * - After the operation is called, you can obtain the assigned secondary private IP addresses from the response.
913
+ * ## Operation description
914
+ * - Only ENIs in the Available or InUse state are supported.
915
+ * - When you operate a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
916
+ * - 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).
917
+ * - After you call this operation, you can obtain the allocated secondary private IP address information from the response.
918
918
  *
919
919
  * @param request - AssignPrivateIpAddressesRequest
920
920
  * @param runtime - runtime options for this request RuntimeOptions
@@ -989,14 +989,14 @@ export default class Client extends OpenApi {
989
989
  }
990
990
 
991
991
  /**
992
- * 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.
992
+ * 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.
993
993
  *
994
994
  * @remarks
995
- * ## [](#)Usage notes
996
- * - The ENI to which you want to assign IP prefixes must be in the Available (Available) or InUse (InUse) state.
997
- * - 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.
998
- * - 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).
999
- * - After the operation is called, you can obtain the assigned secondary private IP addresses from the response.
995
+ * ## Operation description
996
+ * - Only ENIs in the Available or InUse state are supported.
997
+ * - When you operate a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
998
+ * - 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).
999
+ * - After you call this operation, you can obtain the allocated secondary private IP address information from the response.
1000
1000
  *
1001
1001
  * @param request - AssignPrivateIpAddressesRequest
1002
1002
  * @returns AssignPrivateIpAddressesResponse
@@ -1503,21 +1503,22 @@ export default class Client extends OpenApi {
1503
1503
  }
1504
1504
 
1505
1505
  /**
1506
- * 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.
1506
+ * 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.
1507
1507
  *
1508
1508
  * @remarks
1509
- * Take note of the following items:
1510
- * - 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.
1511
- * - 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.
1512
- * > 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.
1513
- * - You can attach multiple ENIs to one instance. For more information, see [ENI overview](https://help.aliyun.com/document_detail/58496.html).
1514
- * - 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.
1515
- * - 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.
1516
- * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/en-US/20230223/vqky/AttachNetworkInterface.png)
1517
- * * If the ENI is in the Attaching state, the ENI attachment request is sent and the ENI is being attached to the specified instance.
1518
- * * If the ENI is in the InUse state, the ENI is attached to the specified instance.
1519
- * * If the ENI is in the Available state, the ENI failed to be attached.
1520
- * **For examples on how to call this operation, see** [Attach an ENI](https://help.aliyun.com/document_detail/471550.html).
1509
+ * When you call this operation, take note of the following items:
1510
+ * - 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).
1511
+ * - 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).
1512
+ * > 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.
1513
+ * - 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).
1514
+ *
1515
+ * - The vSwitch to which the network interface controller (NIC) belongs must be in the same zone and VPC as the instance.
1516
+ * - 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:
1517
+ * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221124/esgu/AttachNetworkInterface.jpg)
1518
+ * - Attaching indicates that the request to attach the ENI was sent successfully and the ENI is being attached to the ECS instance.
1519
+ * - InUse indicates that the ENI has been attached to the ECS instance.
1520
+ * - Available indicates that the ENI failed to be attached to the ECS instance.
1521
+ * **For details, see** [Attach a network interface controller (NIC)](https://help.aliyun.com/document_detail/471550.html).
1521
1522
  *
1522
1523
  * @param request - AttachNetworkInterfaceRequest
1523
1524
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1588,21 +1589,22 @@ export default class Client extends OpenApi {
1588
1589
  }
1589
1590
 
1590
1591
  /**
1591
- * 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.
1592
+ * 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.
1592
1593
  *
1593
1594
  * @remarks
1594
- * Take note of the following items:
1595
- * - 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.
1596
- * - 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.
1597
- * > 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.
1598
- * - You can attach multiple ENIs to one instance. For more information, see [ENI overview](https://help.aliyun.com/document_detail/58496.html).
1599
- * - 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.
1600
- * - 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.
1601
- * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/en-US/20230223/vqky/AttachNetworkInterface.png)
1602
- * * If the ENI is in the Attaching state, the ENI attachment request is sent and the ENI is being attached to the specified instance.
1603
- * * If the ENI is in the InUse state, the ENI is attached to the specified instance.
1604
- * * If the ENI is in the Available state, the ENI failed to be attached.
1605
- * **For examples on how to call this operation, see** [Attach an ENI](https://help.aliyun.com/document_detail/471550.html).
1595
+ * When you call this operation, take note of the following items:
1596
+ * - 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).
1597
+ * - 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).
1598
+ * > 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.
1599
+ * - 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).
1600
+ *
1601
+ * - The vSwitch to which the network interface controller (NIC) belongs must be in the same zone and VPC as the instance.
1602
+ * - 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:
1603
+ * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221124/esgu/AttachNetworkInterface.jpg)
1604
+ * - Attaching indicates that the request to attach the ENI was sent successfully and the ENI is being attached to the ECS instance.
1605
+ * - InUse indicates that the ENI has been attached to the ECS instance.
1606
+ * - Available indicates that the ENI failed to be attached to the ECS instance.
1607
+ * **For details, see** [Attach a network interface controller (NIC)](https://help.aliyun.com/document_detail/471550.html).
1606
1608
  *
1607
1609
  * @param request - AttachNetworkInterfaceRequest
1608
1610
  * @returns AttachNetworkInterfaceResponse
@@ -1613,54 +1615,54 @@ export default class Client extends OpenApi {
1613
1615
  }
1614
1616
 
1615
1617
  /**
1616
- * 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.
1618
+ * 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.
1617
1619
  *
1618
1620
  * @remarks
1619
- * ### 使用须知
1620
- * - **数量限制:** 单张弹性网卡关联的所有安全组的规则(包括入方向规则与出方向规则)数量之和不能超过 1000。具体限制请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
1621
- * - **优先级设置:** 安全组入方向规则优先级(Priority)可选范围为 1\\~100。数字越小,代表优先级越高,优先级相同的安全组规则,优先以拒绝访问(drop)的规则为准。
1622
- * ### 注意事项
1623
- * 如果指定的安全组规则已存在,此次调用成功,但不会增加规则。
1624
- * ### 规则确定方式
1625
- * 确定一条安全组入方向规则必要的一组相关参数:
1626
- * - 源端设置:选择 SourceCidrIpIPv4 地址)、Ipv6SourceCidrIpIPv6 地址)、SourcetPrefixListId(前缀列表 ID)、SourceGroupId(源端安全组)中的一项。
1627
- * - 目的端口范围:PortRange
1628
- * - 协议类型:IpProtocol
1629
- * - 权限策略:Policy
1630
- * > 企业安全组不支持授权其他安全组访问,普通安全组支持授权的安全组数量最多为 20 个。
1631
- * ### 请求示例
1632
- * 假设要在杭州地域下指定安全组中增加几条不同源端的入方向规则:
1633
- * - 增加指定 IP 地址段的访问权限。
1634
- * ```
1635
- * "RegionId":"cn-hangzhou", //设置地域
1636
- * "SecurityGroupId":"sg-bp67acfmxazb4p****", //设置安全组
1637
- * "Permissions":[
1638
- * {
1639
- * "SourceCidrIp":"10.0.0.0/8", //设置源端 IPv4 地址
1640
- * "PortRange":"22/22", //设置端口范围
1641
- * "IpProtocol":"TCP", //设置协议类型
1642
- * "Policy":"Accept" //设置访问策略
1643
- * }
1644
- * ]
1645
- * ```
1646
- * - 增加一条其他安全组和一条前缀列表的访问权限。
1647
- * ```
1648
- * "RegionId":"cn-hangzhou",
1649
- * "SecurityGroupId":"sg-bp67acfmxazb4p****",
1650
- * "Permissions":[
1651
- * {
1652
- * "SourceGroupId":"sg-bp17vs63txqxbd****", //设置源端安全组
1653
- * "PortRange":"22/22",
1654
- * "IpProtocol":"TCP",
1655
- * "Policy":"Drop"
1656
- * },{
1657
- * "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置源端前缀列表
1658
- * "PortRange":"22/22",
1659
- * "IpProtocol":"TCP",
1660
- * "Policy":"Drop"
1661
- * }
1662
- * ]
1663
- * ```
1621
+ * ### Before you begin
1622
+ * - **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~~).
1623
+ * - **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.
1624
+ * ### Notes
1625
+ * If the specified security group rule already exists, the call succeeds but no rule is added.
1626
+ * ### How to determine a rule
1627
+ * The following parameters are required to determine an inbound security group rule:
1628
+ * - Source settings: Specify one of the following: SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
1629
+ * - Destination port range: PortRange.
1630
+ * - Protocol type: IpProtocol.
1631
+ * - Access policy: Policy.
1632
+ * > Advanced security groups do not support authorization for access from other security groups. Basic security groups support a maximum of 20 authorized security groups.
1633
+ * ### Request examples
1634
+ * The following examples show how to add inbound rules with different sources to a security group in the China (Hangzhou) region:
1635
+ * - Add access permissions for a specified IP address range.
1636
+ * ```
1637
+ * "RegionId":"cn-hangzhou", // Specify the region.
1638
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group.
1639
+ * "Permissions":[
1640
+ * {
1641
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IPv4 address.
1642
+ * "PortRange":"22/22", // Specify the port range.
1643
+ * "IpProtocol":"TCP", // Specify the protocol type.
1644
+ * "Policy":"Accept" // Specify the access policy.
1645
+ * }
1646
+ * ]
1647
+ * ```
1648
+ * - Add access permissions for another security group and a prefix list.
1649
+ * ```
1650
+ * "RegionId":"cn-hangzhou",
1651
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****",
1652
+ * "Permissions":[
1653
+ * {
1654
+ * "SourceGroupId":"sg-bp17vs63txqxbd****", // Specify the source security group.
1655
+ * "PortRange":"22/22",
1656
+ * "IpProtocol":"TCP",
1657
+ * "Policy":"Drop"
1658
+ * },{
1659
+ * "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list.
1660
+ * "PortRange":"22/22",
1661
+ * "IpProtocol":"TCP",
1662
+ * "Policy":"Drop"
1663
+ * }
1664
+ * ]
1665
+ * ```
1664
1666
  *
1665
1667
  * @param request - AuthorizeSecurityGroupRequest
1666
1668
  * @param runtime - runtime options for this request RuntimeOptions
@@ -1795,54 +1797,54 @@ export default class Client extends OpenApi {
1795
1797
  }
1796
1798
 
1797
1799
  /**
1798
- * 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.
1800
+ * 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.
1799
1801
  *
1800
1802
  * @remarks
1801
- * ### 使用须知
1802
- * - **数量限制:** 单张弹性网卡关联的所有安全组的规则(包括入方向规则与出方向规则)数量之和不能超过 1000。具体限制请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
1803
- * - **优先级设置:** 安全组入方向规则优先级(Priority)可选范围为 1\\~100。数字越小,代表优先级越高,优先级相同的安全组规则,优先以拒绝访问(drop)的规则为准。
1804
- * ### 注意事项
1805
- * 如果指定的安全组规则已存在,此次调用成功,但不会增加规则。
1806
- * ### 规则确定方式
1807
- * 确定一条安全组入方向规则必要的一组相关参数:
1808
- * - 源端设置:选择 SourceCidrIpIPv4 地址)、Ipv6SourceCidrIpIPv6 地址)、SourcetPrefixListId(前缀列表 ID)、SourceGroupId(源端安全组)中的一项。
1809
- * - 目的端口范围:PortRange
1810
- * - 协议类型:IpProtocol
1811
- * - 权限策略:Policy
1812
- * > 企业安全组不支持授权其他安全组访问,普通安全组支持授权的安全组数量最多为 20 个。
1813
- * ### 请求示例
1814
- * 假设要在杭州地域下指定安全组中增加几条不同源端的入方向规则:
1815
- * - 增加指定 IP 地址段的访问权限。
1816
- * ```
1817
- * "RegionId":"cn-hangzhou", //设置地域
1818
- * "SecurityGroupId":"sg-bp67acfmxazb4p****", //设置安全组
1819
- * "Permissions":[
1820
- * {
1821
- * "SourceCidrIp":"10.0.0.0/8", //设置源端 IPv4 地址
1822
- * "PortRange":"22/22", //设置端口范围
1823
- * "IpProtocol":"TCP", //设置协议类型
1824
- * "Policy":"Accept" //设置访问策略
1825
- * }
1826
- * ]
1827
- * ```
1828
- * - 增加一条其他安全组和一条前缀列表的访问权限。
1829
- * ```
1830
- * "RegionId":"cn-hangzhou",
1831
- * "SecurityGroupId":"sg-bp67acfmxazb4p****",
1832
- * "Permissions":[
1833
- * {
1834
- * "SourceGroupId":"sg-bp17vs63txqxbd****", //设置源端安全组
1835
- * "PortRange":"22/22",
1836
- * "IpProtocol":"TCP",
1837
- * "Policy":"Drop"
1838
- * },{
1839
- * "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置源端前缀列表
1840
- * "PortRange":"22/22",
1841
- * "IpProtocol":"TCP",
1842
- * "Policy":"Drop"
1843
- * }
1844
- * ]
1845
- * ```
1803
+ * ### Before you begin
1804
+ * - **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~~).
1805
+ * - **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.
1806
+ * ### Notes
1807
+ * If the specified security group rule already exists, the call succeeds but no rule is added.
1808
+ * ### How to determine a rule
1809
+ * The following parameters are required to determine an inbound security group rule:
1810
+ * - Source settings: Specify one of the following: SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
1811
+ * - Destination port range: PortRange.
1812
+ * - Protocol type: IpProtocol.
1813
+ * - Access policy: Policy.
1814
+ * > Advanced security groups do not support authorization for access from other security groups. Basic security groups support a maximum of 20 authorized security groups.
1815
+ * ### Request examples
1816
+ * The following examples show how to add inbound rules with different sources to a security group in the China (Hangzhou) region:
1817
+ * - Add access permissions for a specified IP address range.
1818
+ * ```
1819
+ * "RegionId":"cn-hangzhou", // Specify the region.
1820
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group.
1821
+ * "Permissions":[
1822
+ * {
1823
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IPv4 address.
1824
+ * "PortRange":"22/22", // Specify the port range.
1825
+ * "IpProtocol":"TCP", // Specify the protocol type.
1826
+ * "Policy":"Accept" // Specify the access policy.
1827
+ * }
1828
+ * ]
1829
+ * ```
1830
+ * - Add access permissions for another security group and a prefix list.
1831
+ * ```
1832
+ * "RegionId":"cn-hangzhou",
1833
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****",
1834
+ * "Permissions":[
1835
+ * {
1836
+ * "SourceGroupId":"sg-bp17vs63txqxbd****", // Specify the source security group.
1837
+ * "PortRange":"22/22",
1838
+ * "IpProtocol":"TCP",
1839
+ * "Policy":"Drop"
1840
+ * },{
1841
+ * "SourcePrefixListId":"pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list.
1842
+ * "PortRange":"22/22",
1843
+ * "IpProtocol":"TCP",
1844
+ * "Policy":"Drop"
1845
+ * }
1846
+ * ]
1847
+ * ```
1846
1848
  *
1847
1849
  * @param request - AuthorizeSecurityGroupRequest
1848
1850
  * @returns AuthorizeSecurityGroupResponse
@@ -1853,54 +1855,54 @@ export default class Client extends OpenApi {
1853
1855
  }
1854
1856
 
1855
1857
  /**
1856
- * 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.
1858
+ * 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.
1857
1859
  *
1858
1860
  * @remarks
1859
- * ### 使用须知
1860
- * - **数量限制:** 单张弹性网卡关联的所有安全组的规则(包括入方向规则与出方向规则)数量之和不能超过 1000。具体限制请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
1861
- * - **优先级设置:** 安全组出方向规则优先级(Priority)可选范围为 1\\~100。数字越小,代表优先级越高,优先级相同的安全组规则,优先以拒绝访问(drop)的规则为准。
1862
- * ### 注意事项
1863
- * 如果指定的安全组规则已存在,此次调用成功,但不会增加规则。
1864
- * ### 规则确定方式
1865
- * 确定一条安全组出方向规则必要的一组相关参数:
1866
- * - 目的端设置:选择 DestCidrIpIPv4 地址)、Ipv6DestCidrIpIPv6 地址)、DestPrefixListId(前缀列表 ID)、DestGroupId(目的端安全组)中的一项。
1867
- * - 目的端口范围:PortRange
1868
- * - 协议类型:IpProtocol
1869
- * - 权限策略:Policy
1870
- * > 企业安全组不支持授权其他安全组访问,普通安全组支持授权的安全组数量最多为 20 个。
1871
- * ### 请求示例
1872
- * 假设要在杭州地域下指定安全组中增加几条不同目的端的出方向规则:
1873
- * - 增加指定 IP 地址段的访问权限。
1874
- * ```
1875
- * "RegionId":"cn-hangzhou", //设置地域
1876
- * "SecurityGroupId":"sg-bp17vs63txqxbds9***", //设置安全组
1877
- * "Permissions":[
1878
- * {
1879
- * "DestCidrIp":"10.0.0.0/8", //设置目的端 IPv4 地址
1880
- * "PortRange":"-1/-1", //设置端口范围
1881
- * "IpProtocol":"ICMP", //设置协议类型
1882
- * "Policy":"Accept" //设置访问策略
1883
- * }
1884
- * ]
1885
- * ```
1886
- * - 增加一条其他安全组和一条前缀列表的访问权限。
1887
- * ```
1888
- * "RegionId":"cn-hangzhou",
1889
- * "SecurityGroupId":"sg-bp17vs63txqxbds9***",
1890
- * "Permissions":[
1891
- * {
1892
- * "DestGroupId":"sg-bp67acfmxazb4pi***", //设置目的端安全组
1893
- * "PortRange":"22/22",
1894
- * "IpProtocol":"TCP",
1895
- * "Policy":"Drop"
1896
- * },{
1897
- * "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置目的端前缀列表
1898
- * "PortRange":"22/22",
1899
- * "IpProtocol":"TCP",
1900
- * "Policy":"Drop"
1901
- * }
1902
- * ]
1903
- * ```
1861
+ * ### Before you begin
1862
+ * - **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~~).
1863
+ * - **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.
1864
+ * ### Notes
1865
+ * If the specified security group rule already exists, the call succeeds but no rule is added.
1866
+ * ### How to determine a rule
1867
+ * The following parameters are required to determine an outbound rule:
1868
+ * - Destination settings: Specify one of the following: DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
1869
+ * - Destination port range: PortRange.
1870
+ * - Protocol type: IpProtocol.
1871
+ * - Access policy: Policy.
1872
+ * > Advanced security groups do not support authorization of other security groups for access. Custom security groups support a maximum of 20 authorized security groups.
1873
+ * ### Request examples
1874
+ * The following examples show how to add outbound rules with different destinations to a security group in the China (Hangzhou) region:
1875
+ * - Add access permissions for a specified IP address range.
1876
+ * ```
1877
+ * "RegionId":"ap-southeast-1", // Specify the region.
1878
+ * "SecurityGroupId":"sg-bp17vs63txqxbds9***", // Specify the security group.
1879
+ * "Permissions":[
1880
+ * {
1881
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IPv4 address.
1882
+ * "PortRange":"-1/-1", // Specify the port range.
1883
+ * "IpProtocol":"ICMP", // Specify the protocol type.
1884
+ * "Policy":"Accept" // Specify the access policy.
1885
+ * }
1886
+ * ]
1887
+ * ```
1888
+ * - Add access permissions for another security group and a prefix list.
1889
+ * ```
1890
+ * "RegionId":"ap-southeast-1",
1891
+ * "SecurityGroupId":"sg-bp17vs63txqxbds9***",
1892
+ * "Permissions":[
1893
+ * {
1894
+ * "DestGroupId":"sg-bp67acfmxazb4pi***", // Specify the destination security group.
1895
+ * "PortRange":"22/22",
1896
+ * "IpProtocol":"TCP",
1897
+ * "Policy":"Drop"
1898
+ * },{
1899
+ * "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", // Specify the destination prefix list.
1900
+ * "PortRange":"22/22",
1901
+ * "IpProtocol":"TCP",
1902
+ * "Policy":"Drop"
1903
+ * }
1904
+ * ]
1905
+ * ```
1904
1906
  *
1905
1907
  * @param request - AuthorizeSecurityGroupEgressRequest
1906
1908
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2035,54 +2037,54 @@ export default class Client extends OpenApi {
2035
2037
  }
2036
2038
 
2037
2039
  /**
2038
- * 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.
2040
+ * 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.
2039
2041
  *
2040
2042
  * @remarks
2041
- * ### 使用须知
2042
- * - **数量限制:** 单张弹性网卡关联的所有安全组的规则(包括入方向规则与出方向规则)数量之和不能超过 1000。具体限制请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
2043
- * - **优先级设置:** 安全组出方向规则优先级(Priority)可选范围为 1\\~100。数字越小,代表优先级越高,优先级相同的安全组规则,优先以拒绝访问(drop)的规则为准。
2044
- * ### 注意事项
2045
- * 如果指定的安全组规则已存在,此次调用成功,但不会增加规则。
2046
- * ### 规则确定方式
2047
- * 确定一条安全组出方向规则必要的一组相关参数:
2048
- * - 目的端设置:选择 DestCidrIpIPv4 地址)、Ipv6DestCidrIpIPv6 地址)、DestPrefixListId(前缀列表 ID)、DestGroupId(目的端安全组)中的一项。
2049
- * - 目的端口范围:PortRange
2050
- * - 协议类型:IpProtocol
2051
- * - 权限策略:Policy
2052
- * > 企业安全组不支持授权其他安全组访问,普通安全组支持授权的安全组数量最多为 20 个。
2053
- * ### 请求示例
2054
- * 假设要在杭州地域下指定安全组中增加几条不同目的端的出方向规则:
2055
- * - 增加指定 IP 地址段的访问权限。
2056
- * ```
2057
- * "RegionId":"cn-hangzhou", //设置地域
2058
- * "SecurityGroupId":"sg-bp17vs63txqxbds9***", //设置安全组
2059
- * "Permissions":[
2060
- * {
2061
- * "DestCidrIp":"10.0.0.0/8", //设置目的端 IPv4 地址
2062
- * "PortRange":"-1/-1", //设置端口范围
2063
- * "IpProtocol":"ICMP", //设置协议类型
2064
- * "Policy":"Accept" //设置访问策略
2065
- * }
2066
- * ]
2067
- * ```
2068
- * - 增加一条其他安全组和一条前缀列表的访问权限。
2069
- * ```
2070
- * "RegionId":"cn-hangzhou",
2071
- * "SecurityGroupId":"sg-bp17vs63txqxbds9***",
2072
- * "Permissions":[
2073
- * {
2074
- * "DestGroupId":"sg-bp67acfmxazb4pi***", //设置目的端安全组
2075
- * "PortRange":"22/22",
2076
- * "IpProtocol":"TCP",
2077
- * "Policy":"Drop"
2078
- * },{
2079
- * "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", //设置目的端前缀列表
2080
- * "PortRange":"22/22",
2081
- * "IpProtocol":"TCP",
2082
- * "Policy":"Drop"
2083
- * }
2084
- * ]
2085
- * ```
2043
+ * ### Before you begin
2044
+ * - **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~~).
2045
+ * - **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.
2046
+ * ### Notes
2047
+ * If the specified security group rule already exists, the call succeeds but no rule is added.
2048
+ * ### How to determine a rule
2049
+ * The following parameters are required to determine an outbound rule:
2050
+ * - Destination settings: Specify one of the following: DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
2051
+ * - Destination port range: PortRange.
2052
+ * - Protocol type: IpProtocol.
2053
+ * - Access policy: Policy.
2054
+ * > Advanced security groups do not support authorization of other security groups for access. Custom security groups support a maximum of 20 authorized security groups.
2055
+ * ### Request examples
2056
+ * The following examples show how to add outbound rules with different destinations to a security group in the China (Hangzhou) region:
2057
+ * - Add access permissions for a specified IP address range.
2058
+ * ```
2059
+ * "RegionId":"ap-southeast-1", // Specify the region.
2060
+ * "SecurityGroupId":"sg-bp17vs63txqxbds9***", // Specify the security group.
2061
+ * "Permissions":[
2062
+ * {
2063
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IPv4 address.
2064
+ * "PortRange":"-1/-1", // Specify the port range.
2065
+ * "IpProtocol":"ICMP", // Specify the protocol type.
2066
+ * "Policy":"Accept" // Specify the access policy.
2067
+ * }
2068
+ * ]
2069
+ * ```
2070
+ * - Add access permissions for another security group and a prefix list.
2071
+ * ```
2072
+ * "RegionId":"ap-southeast-1",
2073
+ * "SecurityGroupId":"sg-bp17vs63txqxbds9***",
2074
+ * "Permissions":[
2075
+ * {
2076
+ * "DestGroupId":"sg-bp67acfmxazb4pi***", // Specify the destination security group.
2077
+ * "PortRange":"22/22",
2078
+ * "IpProtocol":"TCP",
2079
+ * "Policy":"Drop"
2080
+ * },{
2081
+ * "DestPrefixListId":"pl-x1j1k5ykzqlixdcy****", // Specify the destination prefix list.
2082
+ * "PortRange":"22/22",
2083
+ * "IpProtocol":"TCP",
2084
+ * "Policy":"Drop"
2085
+ * }
2086
+ * ]
2087
+ * ```
2086
2088
  *
2087
2089
  * @param request - AuthorizeSecurityGroupEgressRequest
2088
2090
  * @returns AuthorizeSecurityGroupEgressResponse
@@ -2227,10 +2229,10 @@ export default class Client extends OpenApi {
2227
2229
  }
2228
2230
 
2229
2231
  /**
2230
- * Cancels an image building task.
2232
+ * Cancels an image build task.
2231
2233
  *
2232
2234
  * @remarks
2233
- * Before you call the CancelImagePipelineExecution operation, make sure that the image building task to be canceled is in the BUILDING, PREPARING, or REPAIRING state.
2235
+ * Before you call this operation, make sure that the image build task you want to cancel is in the PREPARING, REPAIRING, or BUILDING state.
2234
2236
  *
2235
2237
  * @param request - CancelImagePipelineExecutionRequest
2236
2238
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2289,10 +2291,10 @@ export default class Client extends OpenApi {
2289
2291
  }
2290
2292
 
2291
2293
  /**
2292
- * Cancels an image building task.
2294
+ * Cancels an image build task.
2293
2295
  *
2294
2296
  * @remarks
2295
- * Before you call the CancelImagePipelineExecution operation, make sure that the image building task to be canceled is in the BUILDING, PREPARING, or REPAIRING state.
2297
+ * Before you call this operation, make sure that the image build task you want to cancel is in the PREPARING, REPAIRING, or BUILDING state.
2296
2298
  *
2297
2299
  * @param request - CancelImagePipelineExecutionRequest
2298
2300
  * @returns CancelImagePipelineExecutionResponse
@@ -2502,29 +2504,29 @@ export default class Client extends OpenApi {
2502
2504
  }
2503
2505
 
2504
2506
  /**
2505
- * 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.
2507
+ * 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.
2506
2508
  *
2507
2509
  * @remarks
2508
- * > 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.
2509
- * ### Usage
2510
- * - This is an asynchronous operation. After a successful call, call the DescribeTasks operation with the returned taskGroupId to query the task\\"s status.
2510
+ * > 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.
2511
+ * ### How to use
2512
+ * - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to obtain the execution result.
2511
2513
  * ### Features
2512
- * - 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.
2513
- * - 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.
2514
- * - Local disks and elastic ephemeral disks do not support cloning and cannot be used as either a source disk or a destination disk.
2515
- * - You can specify the type and performance level for the `destination disk`.
2516
- * - You can specify the capacity for the `destination disk`, but its capacity must be greater than or equal to that of the `source disk`.
2517
- * - You can configure provisioned performance and burst performance for the `destination disk`, provided that the destination disk type supports these features.
2518
- * - 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.
2519
- * - 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.
2520
- * - A `destination disk` created by cloning cannot be re-initialized.
2521
- * - 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.
2522
- * - `source disk` status requirements
2523
- * - The `source disk` must be "In Use", and its attached instance must be "Running" or "Stopped".
2524
- * - The `source disk` must be "Available" and have been attached to an instance at least once.
2525
- * - A disk undergoing a configuration modification cannot be used as a `source disk`.
2526
- * - A disk that is being scaled up cannot be used as a `source disk`.
2527
- * - As cloud disk cloning is not supported for hibernated instances, a disk attached to a hibernated instance cannot be used as a `source disk`.
2514
+ * - 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.
2515
+ * - Non-regional disks can only be cloned to non-regional disk types. Regional disks can only be cloned to regional disk types.
2516
+ * - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
2517
+ * - You can specify the `new disk` type and performance level (PL) during cloning.
2518
+ * - 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.
2519
+ * - You can configure provisioned performance and performance burst for the `new disk`, provided that the destination disk type supports provisioned performance and performance burst.
2520
+ * - 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.
2521
+ * - 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`.
2522
+ * - The `new disk` created by cloning does not support reinitialization.
2523
+ * - 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.
2524
+ * - `Source disk` status restrictions:
2525
+ * - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
2526
+ * - The `source disk` status is "Available" and the disk has been previously attached.
2527
+ * - A disk undergoing a specification change cannot be used as the `source disk`.
2528
+ * - A disk undergoing expansion cannot be used as the `source disk`.
2529
+ * - 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`.
2528
2530
  *
2529
2531
  * @param request - CloneDisksRequest
2530
2532
  * @param runtime - runtime options for this request RuntimeOptions
@@ -2623,29 +2625,29 @@ export default class Client extends OpenApi {
2623
2625
  }
2624
2626
 
2625
2627
  /**
2626
- * 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.
2628
+ * 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.
2627
2629
  *
2628
2630
  * @remarks
2629
- * > 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.
2630
- * ### Usage
2631
- * - This is an asynchronous operation. After a successful call, call the DescribeTasks operation with the returned taskGroupId to query the task\\"s status.
2631
+ * > 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.
2632
+ * ### How to use
2633
+ * - This is an asynchronous operation. After a successful call, use the taskGroupId and call the DescribeTasks operation to obtain the execution result.
2632
2634
  * ### Features
2633
- * - 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.
2634
- * - 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.
2635
- * - Local disks and elastic ephemeral disks do not support cloning and cannot be used as either a source disk or a destination disk.
2636
- * - You can specify the type and performance level for the `destination disk`.
2637
- * - You can specify the capacity for the `destination disk`, but its capacity must be greater than or equal to that of the `source disk`.
2638
- * - You can configure provisioned performance and burst performance for the `destination disk`, provided that the destination disk type supports these features.
2639
- * - 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.
2640
- * - 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.
2641
- * - A `destination disk` created by cloning cannot be re-initialized.
2642
- * - 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.
2643
- * - `source disk` status requirements
2644
- * - The `source disk` must be "In Use", and its attached instance must be "Running" or "Stopped".
2645
- * - The `source disk` must be "Available" and have been attached to an instance at least once.
2646
- * - A disk undergoing a configuration modification cannot be used as a `source disk`.
2647
- * - A disk that is being scaled up cannot be used as a `source disk`.
2648
- * - As cloud disk cloning is not supported for hibernated instances, a disk attached to a hibernated instance cannot be used as a `source disk`.
2635
+ * - 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.
2636
+ * - Non-regional disks can only be cloned to non-regional disk types. Regional disks can only be cloned to regional disk types.
2637
+ * - Local disks and elastic ephemeral disks cannot be cloned or used as clone sources.
2638
+ * - You can specify the `new disk` type and performance level (PL) during cloning.
2639
+ * - 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.
2640
+ * - You can configure provisioned performance and performance burst for the `new disk`, provided that the destination disk type supports provisioned performance and performance burst.
2641
+ * - 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.
2642
+ * - 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`.
2643
+ * - The `new disk` created by cloning does not support reinitialization.
2644
+ * - 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.
2645
+ * - `Source disk` status restrictions:
2646
+ * - The `source disk` status is "In Use" and the corresponding instance status is "Running" or "Stopped".
2647
+ * - The `source disk` status is "Available" and the disk has been previously attached.
2648
+ * - A disk undergoing a specification change cannot be used as the `source disk`.
2649
+ * - A disk undergoing expansion cannot be used as the `source disk`.
2650
+ * - 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`.
2649
2651
  *
2650
2652
  * @param request - CloneDisksRequest
2651
2653
  * @returns CloneDisksResponse
@@ -3033,12 +3035,12 @@ export default class Client extends OpenApi {
3033
3035
  }
3034
3036
 
3035
3037
  /**
3036
- * This API is used to create an activation code, which is used to register non-Alibaba Cloud servers as Alibaba Cloud managed instances.
3038
+ * Creates an activation code that is used to register non-Alibaba Cloud servers as Alibaba Cloud managed instances.
3037
3039
  *
3038
3040
  * @remarks
3039
- * ## API Guide
3040
- * 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).
3041
- * 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.
3041
+ * ## Operation description
3042
+ * 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.
3043
+ * 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.
3042
3044
  * - Alibaba Cloud Linux 2/3 and later
3043
3045
  * - CentOS 6/7/8 and later
3044
3046
  * - Debian 8/9/10 and later
@@ -3047,9 +3049,9 @@ export default class Client extends OpenApi {
3047
3049
  * - OpenSUSE
3048
3050
  * - RedHat 5/6/7 and later
3049
3051
  * - SUSE Linux Enterprise Server 11/12/15 and later
3050
- * - Windows Server 2012/2016/2019 and later
3051
- * 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.
3052
- * > You can click **Register New Instance** on the **Managed Instances** tab of the **ECS Cloud Assistant** page to view activation code usage data.
3052
+ * - Window Server 2012/2016/2019 and later
3053
+ * 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.
3054
+ * > 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.
3053
3055
  *
3054
3056
  * @param request - CreateActivationRequest
3055
3057
  * @param runtime - runtime options for this request RuntimeOptions
@@ -3132,12 +3134,12 @@ export default class Client extends OpenApi {
3132
3134
  }
3133
3135
 
3134
3136
  /**
3135
- * This API is used to create an activation code, which is used to register non-Alibaba Cloud servers as Alibaba Cloud managed instances.
3137
+ * Creates an activation code that is used to register non-Alibaba Cloud servers as Alibaba Cloud managed instances.
3136
3138
  *
3137
3139
  * @remarks
3138
- * ## API Guide
3139
- * 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).
3140
- * 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.
3140
+ * ## Operation description
3141
+ * 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.
3142
+ * 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.
3141
3143
  * - Alibaba Cloud Linux 2/3 and later
3142
3144
  * - CentOS 6/7/8 and later
3143
3145
  * - Debian 8/9/10 and later
@@ -3146,9 +3148,9 @@ export default class Client extends OpenApi {
3146
3148
  * - OpenSUSE
3147
3149
  * - RedHat 5/6/7 and later
3148
3150
  * - SUSE Linux Enterprise Server 11/12/15 and later
3149
- * - Windows Server 2012/2016/2019 and later
3150
- * 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.
3151
- * > You can click **Register New Instance** on the **Managed Instances** tab of the **ECS Cloud Assistant** page to view activation code usage data.
3151
+ * - Window Server 2012/2016/2019 and later
3152
+ * 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.
3153
+ * > 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.
3152
3154
  *
3153
3155
  * @param request - CreateActivationRequest
3154
3156
  * @returns CreateActivationResponse
@@ -3159,13 +3161,13 @@ export default class Client extends OpenApi {
3159
3161
  }
3160
3162
 
3161
3163
  /**
3162
- * Create an auto provisioning group.
3164
+ * Creates an auto provisioning group.
3163
3165
  *
3164
3166
  * @remarks
3165
- * - 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).
3166
- * - 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.
3167
- * - 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).
3168
- * - When you specify both a launch template (`LaunchTemplateId`) and launch configuration parameters (`LaunchConfiguration.*`), the system prioritizes the launch template.
3167
+ * - 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).
3168
+ * - 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.
3169
+ * - 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).
3170
+ * - If you specify both a launch template (`LaunchTemplateId`) and launch configuration information (`LaunchConfiguration.*`), the launch template takes precedence.
3169
3171
  *
3170
3172
  * @param tmpReq - CreateAutoProvisioningGroupRequest
3171
3173
  * @param runtime - runtime options for this request RuntimeOptions
@@ -3346,13 +3348,13 @@ export default class Client extends OpenApi {
3346
3348
  }
3347
3349
 
3348
3350
  /**
3349
- * Create an auto provisioning group.
3351
+ * Creates an auto provisioning group.
3350
3352
  *
3351
3353
  * @remarks
3352
- * - 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).
3353
- * - 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.
3354
- * - 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).
3355
- * - When you specify both a launch template (`LaunchTemplateId`) and launch configuration parameters (`LaunchConfiguration.*`), the system prioritizes the launch template.
3354
+ * - 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).
3355
+ * - 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.
3356
+ * - 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).
3357
+ * - If you specify both a launch template (`LaunchTemplateId`) and launch configuration information (`LaunchConfiguration.*`), the launch template takes precedence.
3356
3358
  *
3357
3359
  * @param request - CreateAutoProvisioningGroupRequest
3358
3360
  * @returns CreateAutoProvisioningGroupResponse
@@ -3605,23 +3607,23 @@ export default class Client extends OpenApi {
3605
3607
  }
3606
3608
 
3607
3609
  /**
3608
- * Create a Cloud Assistant command of the Shell, PowerShell, or Bat script type.
3610
+ * Creates a Cloud Assistant command of the Shell, PowerShell, or Bat script type.
3609
3611
  *
3610
3612
  * @remarks
3611
- * ## API Guide
3612
- * - You can create commands of the following types:
3613
- * - Bat scripts (RunBatScript) for Windows instances.
3614
- * - PowerShell scripts (RunPowerShellScript) for Windows instances.
3615
- * - Shell scripts (RunShellScript) for Linux instances.
3616
- * - 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.
3617
- * - 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.
3618
- * - For scheduled execution:
3619
- * - The timeout setting applies to each individual execution record.
3620
- * - If a specific execution times out, the status of that execution record ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) changes to Failed.
3621
- * - Whether the previous execution timed out does not affect the next execution.
3622
- * - 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).
3623
- * - 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`.
3624
- * - 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.
3613
+ * ## Operation description
3614
+ * - You can create the following types of commands:
3615
+ * - Bat scripts for Windows instances (RunBatScript).
3616
+ * - PowerShell scripts for Windows instances (RunPowerShellScript).
3617
+ * - Shell scripts for Linux instances (RunShellScript).
3618
+ * - 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.
3619
+ * - 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.
3620
+ * - For a scheduled execution:
3621
+ * - The timeout period takes effect for each execution record.
3622
+ * - After a specific execution times out, the status ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) of that execution record changes to Failed.
3623
+ * - The timeout of a previous execution does not affect the next execution.
3624
+ * - 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).
3625
+ * - 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`.
3626
+ * - 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.
3625
3627
  *
3626
3628
  * @param request - CreateCommandRequest
3627
3629
  * @param runtime - runtime options for this request RuntimeOptions
@@ -3720,23 +3722,23 @@ export default class Client extends OpenApi {
3720
3722
  }
3721
3723
 
3722
3724
  /**
3723
- * Create a Cloud Assistant command of the Shell, PowerShell, or Bat script type.
3725
+ * Creates a Cloud Assistant command of the Shell, PowerShell, or Bat script type.
3724
3726
  *
3725
3727
  * @remarks
3726
- * ## API Guide
3727
- * - You can create commands of the following types:
3728
- * - Bat scripts (RunBatScript) for Windows instances.
3729
- * - PowerShell scripts (RunPowerShellScript) for Windows instances.
3730
- * - Shell scripts (RunShellScript) for Linux instances.
3731
- * - 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.
3732
- * - 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.
3733
- * - For scheduled execution:
3734
- * - The timeout setting applies to each individual execution record.
3735
- * - If a specific execution times out, the status of that execution record ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) changes to Failed.
3736
- * - Whether the previous execution timed out does not affect the next execution.
3737
- * - 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).
3738
- * - 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`.
3739
- * - 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.
3728
+ * ## Operation description
3729
+ * - You can create the following types of commands:
3730
+ * - Bat scripts for Windows instances (RunBatScript).
3731
+ * - PowerShell scripts for Windows instances (RunPowerShellScript).
3732
+ * - Shell scripts for Linux instances (RunShellScript).
3733
+ * - 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.
3734
+ * - 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.
3735
+ * - For a scheduled execution:
3736
+ * - The timeout period takes effect for each execution record.
3737
+ * - After a specific execution times out, the status ([InvokeRecordStatus](https://help.aliyun.com/document_detail/64845.html)) of that execution record changes to Failed.
3738
+ * - The timeout of a previous execution does not affect the next execution.
3739
+ * - 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).
3740
+ * - 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`.
3741
+ * - 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.
3740
3742
  *
3741
3743
  * @param request - CreateCommandRequest
3742
3744
  * @returns CreateCommandResponse
@@ -4056,14 +4058,14 @@ export default class Client extends OpenApi {
4056
4058
  * Creates a pay-as-you-go or subscription data disk.
4057
4059
  *
4058
4060
  * @remarks
4059
- * - 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).
4060
- * - 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.
4061
- * - Creating a disk requires real-name verification. Go to [Real-name verification](https://account.console.aliyun.com/#/auth/home) in account information.
4062
- * - 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).
4063
- * - Default settings when creating a disk:
4064
- * - 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.
4065
- * - 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).
4066
- * - The billing method is pay-as-you-go, that is, the default `Portable` attribute is `true`.
4061
+ * - 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).
4062
+ * - 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.
4063
+ * - To create a disk, complete [real-name registration](https://account.console.aliyun.com/#/auth/home).
4064
+ * - 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).
4065
+ * - Default settings when you create a disk:
4066
+ * - 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.
4067
+ * - 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.
4068
+ * - The billing method is pay-as-you-go, which means the `Portable` property defaults to `true`.
4067
4069
  *
4068
4070
  * @param request - CreateDiskRequest
4069
4071
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4201,14 +4203,14 @@ export default class Client extends OpenApi {
4201
4203
  * Creates a pay-as-you-go or subscription data disk.
4202
4204
  *
4203
4205
  * @remarks
4204
- * - 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).
4205
- * - 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.
4206
- * - Creating a disk requires real-name verification. Go to [Real-name verification](https://account.console.aliyun.com/#/auth/home) in account information.
4207
- * - 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).
4208
- * - Default settings when creating a disk:
4209
- * - 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.
4210
- * - 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).
4211
- * - The billing method is pay-as-you-go, that is, the default `Portable` attribute is `true`.
4206
+ * - 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).
4207
+ * - 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.
4208
+ * - To create a disk, complete [real-name registration](https://account.console.aliyun.com/#/auth/home).
4209
+ * - 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).
4210
+ * - Default settings when you create a disk:
4211
+ * - 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.
4212
+ * - 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.
4213
+ * - The billing method is pay-as-you-go, which means the `Portable` property defaults to `true`.
4212
4214
  *
4213
4215
  * @param request - CreateDiskRequest
4214
4216
  * @returns CreateDiskResponse
@@ -4519,7 +4521,7 @@ export default class Client extends OpenApi {
4519
4521
  }
4520
4522
 
4521
4523
  /**
4522
- * Creates a high performance computing (HPC) cluster.
4524
+ * Creates an HPC cluster by calling CreateHpcCluster.
4523
4525
  *
4524
4526
  * @param request - CreateHpcClusterRequest
4525
4527
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4582,7 +4584,7 @@ export default class Client extends OpenApi {
4582
4584
  }
4583
4585
 
4584
4586
  /**
4585
- * Creates a high performance computing (HPC) cluster.
4587
+ * Creates an HPC cluster by calling CreateHpcCluster.
4586
4588
  *
4587
4589
  * @param request - CreateHpcClusterRequest
4588
4590
  * @returns CreateHpcClusterResponse
@@ -4593,26 +4595,25 @@ export default class Client extends OpenApi {
4593
4595
  }
4594
4596
 
4595
4597
  /**
4596
- * Create a custom image. You can then use the image to create ECS instances (`RunInstances`) or replace the system disk of an instance (`ReplaceSystemDisk`).
4598
+ * 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).
4597
4599
  *
4598
4600
  * @remarks
4599
- * ### Usage notes
4600
- * - 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).
4601
- * - If the response to a query for ECS instance information contains `{"OperationLocks": {"LockReason" : "security"}}`, you cannot create a custom image from the instance.
4602
- * - 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).
4603
- * 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.
4601
+ * ### Before you begin
4602
+ * - 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).
4603
+ * - When you query ECS instance information, if the response contains {"OperationLocks": {"LockReason" : "security"}}, you cannot create a custom image.
4604
+ * - 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).
4605
+ * 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.
4604
4606
  * - **Create a custom image from an instance**: Specify the instance ID (`InstanceId`).
4605
- * - The instance must be in the `Running` or `Stopped` state.
4606
- * - A successful call creates a new snapshot for each cloud disk of the instance.
4607
- * >Notice:
4608
- * 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.
4609
- *
4610
- * - **Create a custom image from a snapshot (snapshots created on or before July 15, 2013, cannot be used).**
4611
- * - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance\\"s system disk (`SnapshotId`).
4612
- * - **Create a custom image from a system disk snapshot and data disk snapshots**: Map the snapshots to disks by using the `DiskDeviceMapping` parameter.
4613
- * - You can specify only one system disk snapshot.
4614
- * - 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.
4615
- * > 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.
4607
+ * - The instance must be in the Running (`Running`) or Stopped (`Stopped`) state.
4608
+ * - After the operation is called, a new snapshot is created for each disk of the instance.
4609
+ * >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.
4610
+ * - **Create a custom image from a snapshot (the specified snapshot cannot be one created on or before July 15, 2013.)**
4611
+ * - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance system disk (`SnapshotId`).
4612
+ * - **Create a custom image from system disk and data disk snapshots**: Establish data associations among multiple disks (`DiskDeviceMapping`).
4613
+ * - Only one system disk snapshot can be specified.
4614
+ * - 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.
4615
+ *
4616
+ * > 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.
4616
4617
  *
4617
4618
  * @param request - CreateImageRequest
4618
4619
  * @param runtime - runtime options for this request RuntimeOptions
@@ -4723,26 +4724,25 @@ export default class Client extends OpenApi {
4723
4724
  }
4724
4725
 
4725
4726
  /**
4726
- * Create a custom image. You can then use the image to create ECS instances (`RunInstances`) or replace the system disk of an instance (`ReplaceSystemDisk`).
4727
+ * 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).
4727
4728
  *
4728
4729
  * @remarks
4729
- * ### Usage notes
4730
- * - 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).
4731
- * - If the response to a query for ECS instance information contains `{"OperationLocks": {"LockReason" : "security"}}`, you cannot create a custom image from the instance.
4732
- * - 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).
4733
- * 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.
4730
+ * ### Before you begin
4731
+ * - 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).
4732
+ * - When you query ECS instance information, if the response contains {"OperationLocks": {"LockReason" : "security"}}, you cannot create a custom image.
4733
+ * - 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).
4734
+ * 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.
4734
4735
  * - **Create a custom image from an instance**: Specify the instance ID (`InstanceId`).
4735
- * - The instance must be in the `Running` or `Stopped` state.
4736
- * - A successful call creates a new snapshot for each cloud disk of the instance.
4737
- * >Notice:
4738
- * 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.
4739
- *
4740
- * - **Create a custom image from a snapshot (snapshots created on or before July 15, 2013, cannot be used).**
4741
- * - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance\\"s system disk (`SnapshotId`).
4742
- * - **Create a custom image from a system disk snapshot and data disk snapshots**: Map the snapshots to disks by using the `DiskDeviceMapping` parameter.
4743
- * - You can specify only one system disk snapshot.
4744
- * - 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.
4745
- * > 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.
4736
+ * - The instance must be in the Running (`Running`) or Stopped (`Stopped`) state.
4737
+ * - After the operation is called, a new snapshot is created for each disk of the instance.
4738
+ * >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.
4739
+ * - **Create a custom image from a snapshot (the specified snapshot cannot be one created on or before July 15, 2013.)**
4740
+ * - **Create a custom image from a system disk snapshot**: Specify only the snapshot ID of the instance system disk (`SnapshotId`).
4741
+ * - **Create a custom image from system disk and data disk snapshots**: Establish data associations among multiple disks (`DiskDeviceMapping`).
4742
+ * - Only one system disk snapshot can be specified.
4743
+ * - 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.
4744
+ *
4745
+ * > 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.
4746
4746
  *
4747
4747
  * @param request - CreateImageRequest
4748
4748
  * @returns CreateImageResponse
@@ -4753,13 +4753,13 @@ export default class Client extends OpenApi {
4753
4753
  }
4754
4754
 
4755
4755
  /**
4756
- * Creates an image component. Image components store commonly used build template commands for image building.
4756
+ * Creates an image component. Image components are used to store commonly used build template commands for image building.
4757
4757
  *
4758
4758
  * @remarks
4759
4759
  * ## Operation description
4760
4760
  * Before you create an image component, take note of the following items:
4761
- * - You can create only custom image components.
4762
- * - 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.
4761
+ * - Only custom image components can be created.
4762
+ * - 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.
4763
4763
  * - 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).
4764
4764
  * For more information, see [Image Builder overview](https://help.aliyun.com/document_detail/197410.html).
4765
4765
  *
@@ -4852,13 +4852,13 @@ export default class Client extends OpenApi {
4852
4852
  }
4853
4853
 
4854
4854
  /**
4855
- * Creates an image component. Image components store commonly used build template commands for image building.
4855
+ * Creates an image component. Image components are used to store commonly used build template commands for image building.
4856
4856
  *
4857
4857
  * @remarks
4858
4858
  * ## Operation description
4859
4859
  * Before you create an image component, take note of the following items:
4860
- * - You can create only custom image components.
4861
- * - 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.
4860
+ * - Only custom image components can be created.
4861
+ * - 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.
4862
4862
  * - 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).
4863
4863
  * For more information, see [Image Builder overview](https://help.aliyun.com/document_detail/197410.html).
4864
4864
  *
@@ -5051,31 +5051,32 @@ export default class Client extends OpenApi {
5051
5051
  }
5052
5052
 
5053
5053
  /**
5054
- * 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.
5054
+ * Creates a subscription or pay-as-you-go Elastic Compute Service (ECS) instance with customizable parameters.
5055
5055
  *
5056
5056
  * @remarks
5057
- * > This API is deprecated. We recommend that you use the [RunInstances](https://help.aliyun.com/document_detail/2679677.html) API instead.
5057
+ * > This operation is no longer maintained. Use [RunInstances](https://help.aliyun.com/document_detail/2679677.html) instead.
5058
5058
  * <props="china">
5059
- * **Before using this API, ensure you understand the billing methods and [Pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS.**
5059
+ * **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.**
5060
5060
  * <props="intl">
5061
- * **Before using this API, ensure you understand the billing methods and [Pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS.**
5062
- * 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.
5063
- * ### Usage notes
5061
+ * **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.**
5062
+ * 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.
5063
+ * ### Before you begin
5064
5064
  * <props="china">
5065
- * - 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).
5066
- * - 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).
5067
- * - 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).
5068
- * - Before creating a VPC-type instance, you must [create a VPC](https://help.aliyun.com/document_detail/65430.html) in the same region.
5069
- * ### Precautions
5070
- * - 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.
5071
- * - If the billing method for the instance is subscription (`PrePaid`), your available coupons are automatically used at checkout.
5072
- * - 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.
5073
- * - 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.
5074
- * > 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~~).
5065
+ * - 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).
5066
+ * - 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).
5067
+ *
5068
+ * - 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).
5069
+ * - 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).
5070
+ * ### Before you begin
5071
+ * - When you invoke this operation, the system does not send notifications (including text messages, emails, or internal messages) about instance creation.
5072
+ * - If the billable methods of the instance is subscription (`PrePaid`), active coupon in your account are used by default during payment.
5073
+ * - 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.
5074
+ * - 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.
5075
+ * > 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~~).
5075
5076
  * ### Recommendations
5076
- * - **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.
5077
- * - **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.
5078
- * - **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.
5077
+ * - **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.
5078
+ * - **Check active resources**: Invoke [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) to query active resources in a specific region or zone.
5079
+ * - **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.
5079
5080
  *
5080
5081
  * @param request - CreateInstanceRequest
5081
5082
  * @param runtime - runtime options for this request RuntimeOptions
@@ -5346,31 +5347,32 @@ export default class Client extends OpenApi {
5346
5347
  }
5347
5348
 
5348
5349
  /**
5349
- * 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.
5350
+ * Creates a subscription or pay-as-you-go Elastic Compute Service (ECS) instance with customizable parameters.
5350
5351
  *
5351
5352
  * @remarks
5352
- * > This API is deprecated. We recommend that you use the [RunInstances](https://help.aliyun.com/document_detail/2679677.html) API instead.
5353
+ * > This operation is no longer maintained. Use [RunInstances](https://help.aliyun.com/document_detail/2679677.html) instead.
5353
5354
  * <props="china">
5354
- * **Before using this API, ensure you understand the billing methods and [Pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS.**
5355
+ * **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.**
5355
5356
  * <props="intl">
5356
- * **Before using this API, ensure you understand the billing methods and [Pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS.**
5357
- * 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.
5358
- * ### Usage notes
5357
+ * **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.**
5358
+ * 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.
5359
+ * ### Before you begin
5359
5360
  * <props="china">
5360
- * - 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).
5361
- * - 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).
5362
- * - 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).
5363
- * - Before creating a VPC-type instance, you must [create a VPC](https://help.aliyun.com/document_detail/65430.html) in the same region.
5364
- * ### Precautions
5365
- * - 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.
5366
- * - If the billing method for the instance is subscription (`PrePaid`), your available coupons are automatically used at checkout.
5367
- * - 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.
5368
- * - 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.
5369
- * > 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~~).
5361
+ * - 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).
5362
+ * - 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).
5363
+ *
5364
+ * - 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).
5365
+ * - 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).
5366
+ * ### Before you begin
5367
+ * - When you invoke this operation, the system does not send notifications (including text messages, emails, or internal messages) about instance creation.
5368
+ * - If the billable methods of the instance is subscription (`PrePaid`), active coupon in your account are used by default during payment.
5369
+ * - 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.
5370
+ * - 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.
5371
+ * > 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~~).
5370
5372
  * ### Recommendations
5371
- * - **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.
5372
- * - **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.
5373
- * - **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.
5373
+ * - **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.
5374
+ * - **Check active resources**: Invoke [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) to query active resources in a specific region or zone.
5375
+ * - **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.
5374
5376
  *
5375
5377
  * @param request - CreateInstanceRequest
5376
5378
  * @returns CreateInstanceResponse
@@ -5455,15 +5457,15 @@ export default class Client extends OpenApi {
5455
5457
  }
5456
5458
 
5457
5459
  /**
5458
- * 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.
5460
+ * 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.
5459
5461
  *
5460
5462
  * @remarks
5461
- * 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.
5462
- * 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.
5463
- * When invoking this API, note the following:
5464
- * - Each account can create up to 30 launch templates per Region, and each template can have up to 30 versions.
5465
- * - 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.
5466
- * - 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`.
5463
+ * 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.
5464
+ * 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.
5465
+ * When you call this operation, take note of the following items:
5466
+ * - Each account can create up to 30 launch templates per region, and each template can have up to 30 versions.
5467
+ * - 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.
5468
+ * - 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`.
5467
5469
  *
5468
5470
  * @param request - CreateLaunchTemplateRequest
5469
5471
  * @param runtime - runtime options for this request RuntimeOptions
@@ -5714,15 +5716,15 @@ export default class Client extends OpenApi {
5714
5716
  }
5715
5717
 
5716
5718
  /**
5717
- * 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.
5719
+ * 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.
5718
5720
  *
5719
5721
  * @remarks
5720
- * 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.
5721
- * 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.
5722
- * When invoking this API, note the following:
5723
- * - Each account can create up to 30 launch templates per Region, and each template can have up to 30 versions.
5724
- * - 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.
5725
- * - 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`.
5722
+ * 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.
5723
+ * 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.
5724
+ * When you call this operation, take note of the following items:
5725
+ * - Each account can create up to 30 launch templates per region, and each template can have up to 30 versions.
5726
+ * - 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.
5727
+ * - 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`.
5726
5728
  *
5727
5729
  * @param request - CreateLaunchTemplateRequest
5728
5730
  * @returns CreateLaunchTemplateResponse
@@ -5733,11 +5735,11 @@ export default class Client extends OpenApi {
5733
5735
  }
5734
5736
 
5735
5737
  /**
5736
- * Create a new version under the specified ECS instance launch template for subsequent creation of ECS instances, scaling groups, or auto provisioning groups.
5738
+ * Creates a new version in a specified ECS launch template for subsequent creation of ECS instances, elastic scaling groups, or auto provisioning groups.
5737
5739
  *
5738
5740
  * @remarks
5739
- * ## API Guide
5740
- * 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.
5741
+ * ## Operation description
5742
+ * To modify the parameters of a specific version, create a new template version. Each instance launch template supports a maximum of 30 versions.
5741
5743
  *
5742
5744
  * @param request - CreateLaunchTemplateVersionRequest
5743
5745
  * @param runtime - runtime options for this request RuntimeOptions
@@ -5984,11 +5986,11 @@ export default class Client extends OpenApi {
5984
5986
  }
5985
5987
 
5986
5988
  /**
5987
- * Create a new version under the specified ECS instance launch template for subsequent creation of ECS instances, scaling groups, or auto provisioning groups.
5989
+ * Creates a new version in a specified ECS launch template for subsequent creation of ECS instances, elastic scaling groups, or auto provisioning groups.
5988
5990
  *
5989
5991
  * @remarks
5990
- * ## API Guide
5991
- * 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.
5992
+ * ## Operation description
5993
+ * To modify the parameters of a specific version, create a new template version. Each instance launch template supports a maximum of 30 versions.
5992
5994
  *
5993
5995
  * @param request - CreateLaunchTemplateVersionRequest
5994
5996
  * @returns CreateLaunchTemplateVersionResponse
@@ -7116,10 +7118,10 @@ export default class Client extends OpenApi {
7116
7118
  * Creates a security group.
7117
7119
  *
7118
7120
  * @remarks
7119
- * - 通过该接口创建的普通安全组组内连通策略默认是**组内互通**,您可以通过 [ModifySecurityGroupPolicy](https://help.aliyun.com/document_detail/2679846.html) 进行修改。
7120
- * - 通过该接口创建的企业安全组组内连通策略默认是**组内隔离**,并且不能修改。
7121
- * - 单个地域下,安全组的数量有限制,您最少可以创建 100 个安全组。详细信息,请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
7122
- * - 创建专有网络 VPC 类型的安全组时,您必须指定参数 VpcId
7121
+ * - 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).
7122
+ * - The default internal connectivity policy for an advanced security group created by this operation is **internal isolation**, and this policy cannot be modified.
7123
+ * - 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~~).
7124
+ * - To create a security group of the VPC type, you must specify the VpcId parameter.
7123
7125
  *
7124
7126
  * @param request - CreateSecurityGroupRequest
7125
7127
  * @param runtime - runtime options for this request RuntimeOptions
@@ -7201,10 +7203,10 @@ export default class Client extends OpenApi {
7201
7203
  * Creates a security group.
7202
7204
  *
7203
7205
  * @remarks
7204
- * - 通过该接口创建的普通安全组组内连通策略默认是**组内互通**,您可以通过 [ModifySecurityGroupPolicy](https://help.aliyun.com/document_detail/2679846.html) 进行修改。
7205
- * - 通过该接口创建的企业安全组组内连通策略默认是**组内隔离**,并且不能修改。
7206
- * - 单个地域下,安全组的数量有限制,您最少可以创建 100 个安全组。详细信息,请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
7207
- * - 创建专有网络 VPC 类型的安全组时,您必须指定参数 VpcId
7206
+ * - 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).
7207
+ * - The default internal connectivity policy for an advanced security group created by this operation is **internal isolation**, and this policy cannot be modified.
7208
+ * - 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~~).
7209
+ * - To create a security group of the VPC type, you must specify the VpcId parameter.
7208
7210
  *
7209
7211
  * @param request - CreateSecurityGroupRequest
7210
7212
  * @returns CreateSecurityGroupResponse
@@ -8873,7 +8875,7 @@ export default class Client extends OpenApi {
8873
8875
  }
8874
8876
 
8875
8877
  /**
8876
- * Deletes a High Performance Computing (HPC) cluster.
8878
+ * Calls DeleteHpcCluster to delete an HPC cluster.
8877
8879
  *
8878
8880
  * @param request - DeleteHpcClusterRequest
8879
8881
  * @param runtime - runtime options for this request RuntimeOptions
@@ -8932,7 +8934,7 @@ export default class Client extends OpenApi {
8932
8934
  }
8933
8935
 
8934
8936
  /**
8935
- * Deletes a High Performance Computing (HPC) cluster.
8937
+ * Calls DeleteHpcCluster to delete an HPC cluster.
8936
8938
  *
8937
8939
  * @param request - DeleteHpcClusterRequest
8938
8940
  * @returns DeleteHpcClusterResponse
@@ -9096,7 +9098,7 @@ export default class Client extends OpenApi {
9096
9098
  * Deletes an image template.
9097
9099
  *
9098
9100
  * @remarks
9099
- * 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.
9101
+ * 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.
9100
9102
  *
9101
9103
  * @param request - DeleteImagePipelineRequest
9102
9104
  * @param runtime - runtime options for this request RuntimeOptions
@@ -9154,7 +9156,7 @@ export default class Client extends OpenApi {
9154
9156
  * Deletes an image template.
9155
9157
  *
9156
9158
  * @remarks
9157
- * 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.
9159
+ * 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.
9158
9160
  *
9159
9161
  * @param request - DeleteImagePipelineRequest
9160
9162
  * @returns DeleteImagePipelineResponse
@@ -10010,10 +10012,10 @@ export default class Client extends OpenApi {
10010
10012
  }
10011
10013
 
10012
10014
  /**
10013
- * Deletes a specified prefix list and all entries in the prefix list.
10015
+ * Calls DeletePrefixList to delete a specified prefix list and all entries in the prefix list.
10014
10016
  *
10015
10017
  * @remarks
10016
- * 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.
10018
+ * 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.
10017
10019
  *
10018
10020
  * @param request - DeletePrefixListRequest
10019
10021
  * @param runtime - runtime options for this request RuntimeOptions
@@ -10068,10 +10070,10 @@ export default class Client extends OpenApi {
10068
10070
  }
10069
10071
 
10070
10072
  /**
10071
- * Deletes a specified prefix list and all entries in the prefix list.
10073
+ * Calls DeletePrefixList to delete a specified prefix list and all entries in the prefix list.
10072
10074
  *
10073
10075
  * @remarks
10074
- * 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.
10076
+ * 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.
10075
10077
  *
10076
10078
  * @param request - DeletePrefixListRequest
10077
10079
  * @returns DeletePrefixListResponse
@@ -11208,7 +11210,7 @@ export default class Client extends OpenApi {
11208
11210
  }
11209
11211
 
11210
11212
  /**
11211
- * Queries information about Elastic Compute Service (ECS) instances in an auto provisioning group.
11213
+ * Queries information about instances in an auto provisioning group.
11212
11214
  *
11213
11215
  * @param request - DescribeAutoProvisioningGroupInstancesRequest
11214
11216
  * @param runtime - runtime options for this request RuntimeOptions
@@ -11267,7 +11269,7 @@ export default class Client extends OpenApi {
11267
11269
  }
11268
11270
 
11269
11271
  /**
11270
- * Queries information about Elastic Compute Service (ECS) instances in an auto provisioning group.
11272
+ * Queries information about instances in an auto provisioning group.
11271
11273
  *
11272
11274
  * @param request - DescribeAutoProvisioningGroupInstancesRequest
11273
11275
  * @returns DescribeAutoProvisioningGroupInstancesResponse
@@ -11442,7 +11444,7 @@ export default class Client extends OpenApi {
11442
11444
  }
11443
11445
 
11444
11446
  /**
11445
- * Queries the details of automatic snapshot policies that are created in a specific region.
11447
+ * Queries the details of automatic snapshot policies that are created in a specified region.
11446
11448
  *
11447
11449
  * @param request - DescribeAutoSnapshotPolicyExRequest
11448
11450
  * @param runtime - runtime options for this request RuntimeOptions
@@ -11513,7 +11515,7 @@ export default class Client extends OpenApi {
11513
11515
  }
11514
11516
 
11515
11517
  /**
11516
- * Queries the details of automatic snapshot policies that are created in a specific region.
11518
+ * Queries the details of automatic snapshot policies that are created in a specified region.
11517
11519
  *
11518
11520
  * @param request - DescribeAutoSnapshotPolicyExRequest
11519
11521
  * @returns DescribeAutoSnapshotPolicyExResponse
@@ -11524,43 +11526,37 @@ export default class Client extends OpenApi {
11524
11526
  }
11525
11527
 
11526
11528
  /**
11527
- * 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`.
11529
+ * 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).
11528
11530
  *
11529
11531
  * @remarks
11530
- * 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.
11531
- * - Value precedence: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
11532
+ * 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.
11533
+ * - Value order: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
11532
11534
  * - Examples:
11533
- * - If `DestinationResource` is set to `DataDisk`:
11534
- * - 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.
11535
- * - 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.
11536
- * - 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.
11537
- * - If `DestinationResource` is set to `InstanceType`, we recommend specifying the `IoOptimized` and `InstanceType` parameters.
11538
- * - 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`.
11539
- * - 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`.
11535
+ * - If DestinationResource is set to `DataDisk`:
11536
+ * - 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.
11537
+ * - 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`.
11538
+ * - 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.
11539
+ * - If DestinationResource is set to `InstanceType`, specify the IoOptimized and InstanceType parameters.
11540
+ * - 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`.
11541
+ * - 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`.
11540
11542
  * <details>
11541
- * <summary>
11542
- * Query for availability zones in the China (Hangzhou) region that have the `ecs.g5.large` instance type.
11543
- * </summary>
11543
+ * <summary>Query the zones in the China (Hangzhou) region where the ecs.g5.large instance type is available.</summary>
11544
11544
  * ```
11545
11545
  * "RegionId": "cn-hangzhou",
11546
- * "DestinationResource": "Zone",
11546
+ * "DestinationResource": "Zone"
11547
11547
  * "InstanceType": "ecs.g5.large"
11548
11548
  * ```
11549
11549
  * </details>
11550
11550
  * <details>
11551
- * <summary>
11552
- * Query the inventory of the `ecs.g5.large` instance type across all availability zones in the China (Hangzhou) region.
11553
- * </summary>
11551
+ * <summary>Query the inventory of the ecs.g5.large instance type across all zones in the China (Hangzhou) region.</summary>
11554
11552
  * ```
11555
11553
  * "RegionId": "cn-hangzhou",
11556
- * "DestinationResource": "InstanceType",
11554
+ * "DestinationResource": "InstanceType"
11557
11555
  * "InstanceType": "ecs.g5.large"
11558
11556
  * ```
11559
11557
  * </details>
11560
11558
  * <details>
11561
- * <summary>
11562
- * Query the inventory of `cloud_efficiency` data disks in availability zone b of the China (Hangzhou) region, independent of any ECS instance type.
11563
- * </summary>
11559
+ * <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>
11564
11560
  * ```
11565
11561
  * "RegionId": "cn-hangzhou",
11566
11562
  * "ZoneId": "cn-hangzhou-b",
@@ -11569,9 +11565,7 @@ export default class Client extends OpenApi {
11569
11565
  * ```
11570
11566
  * </details>
11571
11567
  * <details>
11572
- * <summary>
11573
- * Query the inventory of `cloud_essd` system disks for the `ecs.g7.large` instance type in availability zone b of the China (Hangzhou) region.
11574
- * </summary>
11568
+ * <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>
11575
11569
  * ```
11576
11570
  * "RegionId": "cn-hangzhou",
11577
11571
  * "ZoneId": "cn-hangzhou-b",
@@ -11687,43 +11681,37 @@ export default class Client extends OpenApi {
11687
11681
  }
11688
11682
 
11689
11683
  /**
11690
- * 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`.
11684
+ * 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).
11691
11685
  *
11692
11686
  * @remarks
11693
- * 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.
11694
- * - Value precedence: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
11687
+ * 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.
11688
+ * - Value order: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
11695
11689
  * - Examples:
11696
- * - If `DestinationResource` is set to `DataDisk`:
11697
- * - 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.
11698
- * - 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.
11699
- * - 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.
11700
- * - If `DestinationResource` is set to `InstanceType`, we recommend specifying the `IoOptimized` and `InstanceType` parameters.
11701
- * - 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`.
11702
- * - 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`.
11690
+ * - If DestinationResource is set to `DataDisk`:
11691
+ * - 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.
11692
+ * - 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`.
11693
+ * - 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.
11694
+ * - If DestinationResource is set to `InstanceType`, specify the IoOptimized and InstanceType parameters.
11695
+ * - 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`.
11696
+ * - 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`.
11703
11697
  * <details>
11704
- * <summary>
11705
- * Query for availability zones in the China (Hangzhou) region that have the `ecs.g5.large` instance type.
11706
- * </summary>
11698
+ * <summary>Query the zones in the China (Hangzhou) region where the ecs.g5.large instance type is available.</summary>
11707
11699
  * ```
11708
11700
  * "RegionId": "cn-hangzhou",
11709
- * "DestinationResource": "Zone",
11701
+ * "DestinationResource": "Zone"
11710
11702
  * "InstanceType": "ecs.g5.large"
11711
11703
  * ```
11712
11704
  * </details>
11713
11705
  * <details>
11714
- * <summary>
11715
- * Query the inventory of the `ecs.g5.large` instance type across all availability zones in the China (Hangzhou) region.
11716
- * </summary>
11706
+ * <summary>Query the inventory of the ecs.g5.large instance type across all zones in the China (Hangzhou) region.</summary>
11717
11707
  * ```
11718
11708
  * "RegionId": "cn-hangzhou",
11719
- * "DestinationResource": "InstanceType",
11709
+ * "DestinationResource": "InstanceType"
11720
11710
  * "InstanceType": "ecs.g5.large"
11721
11711
  * ```
11722
11712
  * </details>
11723
11713
  * <details>
11724
- * <summary>
11725
- * Query the inventory of `cloud_efficiency` data disks in availability zone b of the China (Hangzhou) region, independent of any ECS instance type.
11726
- * </summary>
11714
+ * <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>
11727
11715
  * ```
11728
11716
  * "RegionId": "cn-hangzhou",
11729
11717
  * "ZoneId": "cn-hangzhou-b",
@@ -11732,9 +11720,7 @@ export default class Client extends OpenApi {
11732
11720
  * ```
11733
11721
  * </details>
11734
11722
  * <details>
11735
- * <summary>
11736
- * Query the inventory of `cloud_essd` system disks for the `ecs.g7.large` instance type in availability zone b of the China (Hangzhou) region.
11737
- * </summary>
11723
+ * <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>
11738
11724
  * ```
11739
11725
  * "RegionId": "cn-hangzhou",
11740
11726
  * "ZoneId": "cn-hangzhou-b",
@@ -13459,14 +13445,14 @@ export default class Client extends OpenApi {
13459
13445
  }
13460
13446
 
13461
13447
  /**
13462
- * Queries information about one or more created block storage devices, including disks, local disks, and elastic ephemeral disks.
13448
+ * Queries information about one or more created block storage devices, including cloud disks, local disks, and elastic ephemeral disks.
13463
13449
  *
13464
13450
  * @remarks
13465
- * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. The logical relationship among these parameters is AND.
13466
- * - 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.
13467
- * - 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.
13468
- * - 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.
13469
- * 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).
13451
+ * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. These parameters have a logical AND relationship.
13452
+ * - 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.
13453
+ * - 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.
13454
+ * - 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.
13455
+ * 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).
13470
13456
  *
13471
13457
  * @param request - DescribeDisksRequest
13472
13458
  * @param runtime - runtime options for this request RuntimeOptions
@@ -13629,14 +13615,14 @@ export default class Client extends OpenApi {
13629
13615
  }
13630
13616
 
13631
13617
  /**
13632
- * Queries information about one or more created block storage devices, including disks, local disks, and elastic ephemeral disks.
13618
+ * Queries information about one or more created block storage devices, including cloud disks, local disks, and elastic ephemeral disks.
13633
13619
  *
13634
13620
  * @remarks
13635
- * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. The logical relationship among these parameters is AND.
13636
- * - 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.
13637
- * - 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.
13638
- * - 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.
13639
- * 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).
13621
+ * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. These parameters have a logical AND relationship.
13622
+ * - 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.
13623
+ * - 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.
13624
+ * - 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.
13625
+ * 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).
13640
13626
  *
13641
13627
  * @param request - DescribeDisksRequest
13642
13628
  * @returns DescribeDisksResponse
@@ -14508,7 +14494,7 @@ export default class Client extends OpenApi {
14508
14494
  * Queries the details of one or more image components.
14509
14495
  *
14510
14496
  * @remarks
14511
- * 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.
14497
+ * 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.
14512
14498
  *
14513
14499
  * @param request - DescribeImageComponentsRequest
14514
14500
  * @param runtime - runtime options for this request RuntimeOptions
@@ -14606,7 +14592,7 @@ export default class Client extends OpenApi {
14606
14592
  * Queries the details of one or more image components.
14607
14593
  *
14608
14594
  * @remarks
14609
- * 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.
14595
+ * 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.
14610
14596
  *
14611
14597
  * @param request - DescribeImageComponentsRequest
14612
14598
  * @returns DescribeImageComponentsResponse
@@ -15017,13 +15003,13 @@ export default class Client extends OpenApi {
15017
15003
  }
15018
15004
 
15019
15005
  /**
15020
- * Specify parameters such as ImageId, image usage scenario, and Filter to query the list of image resources you can use.
15006
+ * Queries the list of available image resources based on specified parameters such as ImageId, image usage scenarios, and filter conditions.
15021
15007
  *
15022
15008
  * @remarks
15023
- * - 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.
15024
- * - 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.
15025
- * - 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).
15026
- * - 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).
15009
+ * - 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.
15010
+ * - 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.
15011
+ * - 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).
15012
+ * - 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).
15027
15013
  *
15028
15014
  * @param request - DescribeImagesRequest
15029
15015
  * @param runtime - runtime options for this request RuntimeOptions
@@ -15158,13 +15144,13 @@ export default class Client extends OpenApi {
15158
15144
  }
15159
15145
 
15160
15146
  /**
15161
- * Specify parameters such as ImageId, image usage scenario, and Filter to query the list of image resources you can use.
15147
+ * Queries the list of available image resources based on specified parameters such as ImageId, image usage scenarios, and filter conditions.
15162
15148
  *
15163
15149
  * @remarks
15164
- * - 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.
15165
- * - 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.
15166
- * - 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).
15167
- * - 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).
15150
+ * - 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.
15151
+ * - 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.
15152
+ * - 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).
15153
+ * - 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).
15168
15154
  *
15169
15155
  * @param request - DescribeImagesRequest
15170
15156
  * @returns DescribeImagesResponse
@@ -15255,7 +15241,7 @@ export default class Client extends OpenApi {
15255
15241
  }
15256
15242
 
15257
15243
  /**
15258
- * This API is used to query the attribute information of a specified ECS instance.
15244
+ * Queries the attribute information of a specified ECS instance.
15259
15245
  *
15260
15246
  * @param request - DescribeInstanceAttributeRequest
15261
15247
  * @param runtime - runtime options for this request RuntimeOptions
@@ -15302,7 +15288,7 @@ export default class Client extends OpenApi {
15302
15288
  }
15303
15289
 
15304
15290
  /**
15305
- * This API is used to query the attribute information of a specified ECS instance.
15291
+ * Queries the attribute information of a specified ECS instance.
15306
15292
  *
15307
15293
  * @param request - DescribeInstanceAttributeRequest
15308
15294
  * @returns DescribeInstanceAttributeResponse
@@ -15395,12 +15381,12 @@ export default class Client extends OpenApi {
15395
15381
  }
15396
15382
 
15397
15383
  /**
15398
- * 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.
15384
+ * 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.
15399
15385
  *
15400
15386
  * @remarks
15401
- * - You can query completed historical system events from up to the last 30 days. There is no time limit for querying incomplete system events.
15402
- * - 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.
15403
- * - 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.
15387
+ * - You can query completed historical system events from the last 30 days. There is no time limit for querying uncompleted system events.
15388
+ * - If neither EventCycleStatus nor InstanceEventCycleStatus is specified, the query results include only system events in the Avoided, Executed, Canceled, and Failed states by default.
15389
+ * - By specifying the InstanceEventCycleStatus parameter, you can also query system events in the Scheduled, Executing, and Inquiring states.
15404
15390
  *
15405
15391
  * @param request - DescribeInstanceHistoryEventsRequest
15406
15392
  * @param runtime - runtime options for this request RuntimeOptions
@@ -15519,12 +15505,12 @@ export default class Client extends OpenApi {
15519
15505
  }
15520
15506
 
15521
15507
  /**
15522
- * 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.
15508
+ * 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.
15523
15509
  *
15524
15510
  * @remarks
15525
- * - You can query completed historical system events from up to the last 30 days. There is no time limit for querying incomplete system events.
15526
- * - 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.
15527
- * - 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.
15511
+ * - You can query completed historical system events from the last 30 days. There is no time limit for querying uncompleted system events.
15512
+ * - If neither EventCycleStatus nor InstanceEventCycleStatus is specified, the query results include only system events in the Avoided, Executed, Canceled, and Failed states by default.
15513
+ * - By specifying the InstanceEventCycleStatus parameter, you can also query system events in the Scheduled, Executing, and Inquiring states.
15528
15514
  *
15529
15515
  * @param request - DescribeInstanceHistoryEventsRequest
15530
15516
  * @returns DescribeInstanceHistoryEventsResponse
@@ -16469,14 +16455,14 @@ export default class Client extends OpenApi {
16469
16455
  }
16470
16456
 
16471
16457
  /**
16472
- * This operation queries a list of instances based on specified conditions and returns detailed information about the instances.
16458
+ * Queries a list of instances based on specified request conditions and returns the associated detailed information of the instances.
16473
16459
  *
16474
16460
  * @remarks
16461
+ * ### Before you begin
16462
+ * - 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).
16475
16463
  * ### Usage notes
16476
- * - 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).
16477
- * ### Recommendations
16478
- * - We recommend that you perform a dry run by setting the DryRun parameter to check parameter validity and authorization status.
16479
- * - 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.
16464
+ * - Send a dry run request by using the DryRun request parameter to check the validity of parameters and authorization.
16465
+ * - 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.
16480
16466
  *
16481
16467
  * @param request - DescribeInstancesRequest
16482
16468
  * @param runtime - runtime options for this request RuntimeOptions
@@ -16671,14 +16657,14 @@ export default class Client extends OpenApi {
16671
16657
  }
16672
16658
 
16673
16659
  /**
16674
- * This operation queries a list of instances based on specified conditions and returns detailed information about the instances.
16660
+ * Queries a list of instances based on specified request conditions and returns the associated detailed information of the instances.
16675
16661
  *
16676
16662
  * @remarks
16663
+ * ### Before you begin
16664
+ * - 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).
16677
16665
  * ### Usage notes
16678
- * - 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).
16679
- * ### Recommendations
16680
- * - We recommend that you perform a dry run by setting the DryRun parameter to check parameter validity and authorization status.
16681
- * - 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.
16666
+ * - Send a dry run request by using the DryRun request parameter to check the validity of parameters and authorization.
16667
+ * - 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.
16682
16668
  *
16683
16669
  * @param request - DescribeInstancesRequest
16684
16670
  * @returns DescribeInstancesResponse
@@ -16801,22 +16787,22 @@ export default class Client extends OpenApi {
16801
16787
  }
16802
16788
 
16803
16789
  /**
16804
- * $.parameters[11].schema.items.properties.Value.example
16790
+ * Queries the execution results of one or more Cloud Assistant commands, which are the actual execution results on ECS instances.
16805
16791
  *
16806
16792
  * @remarks
16807
- * ## API Guide
16808
- * - 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.
16809
- * - You can query execution information from the last four weeks, with a maximum retention limit of 100,000 records.
16810
- * - 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.
16811
- * - 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.
16793
+ * ## Operation description
16794
+ * - 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.
16795
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
16796
+ * - 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.
16797
+ * - 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.
16812
16798
  * - Differences between `DescribeInvocations` and `DescribeInvocationResults`:
16813
- * - When a single `RunCommand`/`InvokeCommand` invocation targets multiple instances:
16814
- * - `DescribeInvocations` provides the execution status on each instance and an aggregation status across all instances.
16815
- * - `DescribeInvocationResults` only provides individual execution statuses per instance, without aggregated multi-instance status.
16816
- * - When a single `RunCommand`/`InvokeCommand` invocation targets one instance:
16817
- * - There is little difference between `DescribeInvocations` and `DescribeInvocationResults`, and they can fully replace each other.
16818
- * - 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.
16819
- * - When you need to view the command content or parameters, only `DescribeInvocations` returns `CommandContent`.
16799
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
16800
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
16801
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status across instances.
16802
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
16803
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
16804
+ * - 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.
16805
+ * - When you want to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
16820
16806
  *
16821
16807
  * @param request - DescribeInvocationResultsRequest
16822
16808
  * @param runtime - runtime options for this request RuntimeOptions
@@ -16915,22 +16901,22 @@ export default class Client extends OpenApi {
16915
16901
  }
16916
16902
 
16917
16903
  /**
16918
- * $.parameters[11].schema.items.properties.Value.example
16904
+ * Queries the execution results of one or more Cloud Assistant commands, which are the actual execution results on ECS instances.
16919
16905
  *
16920
16906
  * @remarks
16921
- * ## API Guide
16922
- * - 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.
16923
- * - You can query execution information from the last four weeks, with a maximum retention limit of 100,000 records.
16924
- * - 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.
16925
- * - 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.
16907
+ * ## Operation description
16908
+ * - 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.
16909
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
16910
+ * - 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.
16911
+ * - 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.
16926
16912
  * - Differences between `DescribeInvocations` and `DescribeInvocationResults`:
16927
- * - When a single `RunCommand`/`InvokeCommand` invocation targets multiple instances:
16928
- * - `DescribeInvocations` provides the execution status on each instance and an aggregation status across all instances.
16929
- * - `DescribeInvocationResults` only provides individual execution statuses per instance, without aggregated multi-instance status.
16930
- * - When a single `RunCommand`/`InvokeCommand` invocation targets one instance:
16931
- * - There is little difference between `DescribeInvocations` and `DescribeInvocationResults`, and they can fully replace each other.
16932
- * - 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.
16933
- * - When you need to view the command content or parameters, only `DescribeInvocations` returns `CommandContent`.
16913
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
16914
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
16915
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status across instances.
16916
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
16917
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
16918
+ * - 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.
16919
+ * - When you want to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
16934
16920
  *
16935
16921
  * @param request - DescribeInvocationResultsRequest
16936
16922
  * @returns DescribeInvocationResultsResponse
@@ -16941,21 +16927,21 @@ export default class Client extends OpenApi {
16941
16927
  }
16942
16928
 
16943
16929
  /**
16944
- * Invoke the DescribeInvocations API to query the execution list and status of Cloud Assistant commands.
16930
+ * Queries the execution list and status of Cloud Assistant commands.
16945
16931
  *
16946
16932
  * @remarks
16947
- * - 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.
16948
- * - You can query execution information from the past four weeks, with a maximum retention limit of 100,000 records.
16949
- * - 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.
16950
- * - 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.
16933
+ * - 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.
16934
+ * - You can query execution information from the last 30 days. A maximum of 10,000 execution records are retained.
16935
+ * - 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.
16936
+ * - 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.
16951
16937
  * - Differences between `DescribeInvocations` and `DescribeInvocationResults`:
16952
- * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
16953
- * - `DescribeInvocations` provides the execution status on each instance as well as the aggregated status across all instances.
16954
- * - `DescribeInvocationResults` only provides the individual execution status per instance, without the aggregated multi-instance status.
16955
- * - When a single `RunCommand`/`InvokeCommand` call specifies only one instance:
16956
- * - There is little difference between `DescribeInvocations` and `DescribeInvocationResults`, and they can be used interchangeably.
16957
- * - 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.
16958
- * - When you need to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
16938
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
16939
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
16940
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status.
16941
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
16942
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
16943
+ * - 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.
16944
+ * - To view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
16959
16945
  *
16960
16946
  * @param request - DescribeInvocationsRequest
16961
16947
  * @param runtime - runtime options for this request RuntimeOptions
@@ -17070,21 +17056,21 @@ export default class Client extends OpenApi {
17070
17056
  }
17071
17057
 
17072
17058
  /**
17073
- * Invoke the DescribeInvocations API to query the execution list and status of Cloud Assistant commands.
17059
+ * Queries the execution list and status of Cloud Assistant commands.
17074
17060
  *
17075
17061
  * @remarks
17076
- * - 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.
17077
- * - You can query execution information from the past four weeks, with a maximum retention limit of 100,000 records.
17078
- * - 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.
17079
- * - 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.
17062
+ * - 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.
17063
+ * - You can query execution information from the last 30 days. A maximum of 10,000 execution records are retained.
17064
+ * - 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.
17065
+ * - 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.
17080
17066
  * - Differences between `DescribeInvocations` and `DescribeInvocationResults`:
17081
- * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
17082
- * - `DescribeInvocations` provides the execution status on each instance as well as the aggregated status across all instances.
17083
- * - `DescribeInvocationResults` only provides the individual execution status per instance, without the aggregated multi-instance status.
17084
- * - When a single `RunCommand`/`InvokeCommand` call specifies only one instance:
17085
- * - There is little difference between `DescribeInvocations` and `DescribeInvocationResults`, and they can be used interchangeably.
17086
- * - 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.
17087
- * - When you need to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
17067
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
17068
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
17069
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status.
17070
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
17071
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
17072
+ * - 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.
17073
+ * - To view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
17088
17074
  *
17089
17075
  * @param request - DescribeInvocationsRequest
17090
17076
  * @returns DescribeInvocationsResponse
@@ -17177,7 +17163,7 @@ export default class Client extends OpenApi {
17177
17163
  }
17178
17164
 
17179
17165
  /**
17180
- * Query information about ECS instance launch template versions, such as the total number of launch templates, template name, and template version number.
17166
+ * Queries information about launch template versions of ECS instances, such as the total number of launch templates, template names, and template version numbers.
17181
17167
  *
17182
17168
  * @param request - DescribeLaunchTemplateVersionsRequest
17183
17169
  * @param runtime - runtime options for this request RuntimeOptions
@@ -17260,7 +17246,7 @@ export default class Client extends OpenApi {
17260
17246
  }
17261
17247
 
17262
17248
  /**
17263
- * Query information about ECS instance launch template versions, such as the total number of launch templates, template name, and template version number.
17249
+ * Queries information about launch template versions of ECS instances, such as the total number of launch templates, template names, and template version numbers.
17264
17250
  *
17265
17251
  * @param request - DescribeLaunchTemplateVersionsRequest
17266
17252
  * @returns DescribeLaunchTemplateVersionsResponse
@@ -18705,17 +18691,18 @@ export default class Client extends OpenApi {
18705
18691
  }
18706
18692
 
18707
18693
  /**
18708
- * 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.
18694
+ * 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.
18709
18695
  *
18710
18696
  * @remarks
18711
- * Parameter settings vary depending on the resource type you are querying:
18712
- * - 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.
18713
- * - 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`.
18714
- * - If you set `ResourceType` to `diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
18715
- * - If you set `ResourceType` to `ddh`, you must also specify `DedicatedHostType`.
18716
- * - If you set `ResourceType` to `ElasticityAssurance`, you must also specify `InstanceType`.
18717
- * - If you set `ResourceType` to `CapacityReservation`, you must also specify `InstanceType`.
18718
- * - If you set `ResourceType` to `bandwidth`, this operation returns only pay-by-traffic (`PayByTraffic`) prices.
18697
+ * The parameter settings vary based on the resource type:
18698
+ * - When `ResourceType=instance`, you must also specify `InstanceType`.
18699
+ * 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.
18700
+ * - 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`.
18701
+ * - When `ResourceType=diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
18702
+ * - When `ResourceType=ddh`, you must also specify `DedicatedHostType`.
18703
+ * - When `ResourceType=ElasticityAssurance`, you must also specify `InstanceType`.
18704
+ * - When `ResourceType=CapacityReservation`, you must also specify `InstanceType`.
18705
+ * - When `ResourceType=bandwidth`, only the pay-by-traffic (`PayByTraffic`) price is returned.
18719
18706
  *
18720
18707
  * @param request - DescribePriceRequest
18721
18708
  * @param runtime - runtime options for this request RuntimeOptions
@@ -18874,17 +18861,18 @@ export default class Client extends OpenApi {
18874
18861
  }
18875
18862
 
18876
18863
  /**
18877
- * 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.
18864
+ * 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.
18878
18865
  *
18879
18866
  * @remarks
18880
- * Parameter settings vary depending on the resource type you are querying:
18881
- * - 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.
18882
- * - 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`.
18883
- * - If you set `ResourceType` to `diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
18884
- * - If you set `ResourceType` to `ddh`, you must also specify `DedicatedHostType`.
18885
- * - If you set `ResourceType` to `ElasticityAssurance`, you must also specify `InstanceType`.
18886
- * - If you set `ResourceType` to `CapacityReservation`, you must also specify `InstanceType`.
18887
- * - If you set `ResourceType` to `bandwidth`, this operation returns only pay-by-traffic (`PayByTraffic`) prices.
18867
+ * The parameter settings vary based on the resource type:
18868
+ * - When `ResourceType=instance`, you must also specify `InstanceType`.
18869
+ * 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.
18870
+ * - 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`.
18871
+ * - When `ResourceType=diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
18872
+ * - When `ResourceType=ddh`, you must also specify `DedicatedHostType`.
18873
+ * - When `ResourceType=ElasticityAssurance`, you must also specify `InstanceType`.
18874
+ * - When `ResourceType=CapacityReservation`, you must also specify `InstanceType`.
18875
+ * - When `ResourceType=bandwidth`, only the pay-by-traffic (`PayByTraffic`) price is returned.
18888
18876
  *
18889
18877
  * @param request - DescribePriceRequest
18890
18878
  * @returns DescribePriceResponse
@@ -18895,7 +18883,7 @@ export default class Client extends OpenApi {
18895
18883
  }
18896
18884
 
18897
18885
  /**
18898
- * 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.
18886
+ * (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.
18899
18887
  *
18900
18888
  * @param request - DescribeRecommendInstanceTypeRequest
18901
18889
  * @param runtime - runtime options for this request RuntimeOptions
@@ -19002,7 +18990,7 @@ export default class Client extends OpenApi {
19002
18990
  }
19003
18991
 
19004
18992
  /**
19005
- * 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.
18993
+ * (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.
19006
18994
  *
19007
18995
  * @param request - DescribeRecommendInstanceTypeRequest
19008
18996
  * @returns DescribeRecommendInstanceTypeResponse
@@ -19468,42 +19456,42 @@ export default class Client extends OpenApi {
19468
19456
  }
19469
19457
 
19470
19458
  /**
19471
- * 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.
19459
+ * 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.
19472
19460
  *
19473
19461
  * @remarks
19474
- * Examples of common scenarios in which this operation is used:
19475
- * ### [](#-1)Example 1: Query the instance types to which you can change the instance type of an instance.
19476
- * 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.
19462
+ * The following examples describe common change scenarios:
19463
+ * ### Example 1: Query instance types to which the current instance can be changed
19464
+ * 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.
19477
19465
  * ```
19478
19466
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
19479
- * &RegionId=cn-hangzhou
19467
+ * &RegionId=ap-southeast-1
19480
19468
  * &ResourceId=i-bp67acfmxazb4p****
19481
19469
  * &DestinationResource=InstanceType
19482
19470
  * &OperationType=Upgrade
19483
- * &<Common request parameters>
19471
+ * &Common request parameters
19484
19472
  * ```
19485
- * ### [](#-2)Example 2: Query the instance types to which you can change the instance type of an instance after a system disk category change.
19486
- * 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.
19473
+ * ### Example 2: Query instance types available after changing the disk type of the current instance
19474
+ * 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.
19487
19475
  * ```
19488
19476
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
19489
- * &RegionId=cn-hangzhou
19477
+ * &RegionId=ap-southeast-1
19490
19478
  * &ResourceId=i-bp67acfmxazb4p****
19491
19479
  * &DestinationResource=InstanceType
19492
19480
  * &OperationType=Upgrade
19493
19481
  * &Conditions.0=DiskCategory
19494
- * &<Common request parameters>
19482
+ * &Common request parameters
19495
19483
  * ```
19496
- * ### [](#-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.
19497
- * 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.
19498
- * > 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.
19484
+ * ### Example 3: Query the disk type required by the target instance type
19485
+ * 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.
19486
+ * > The target instance type must be obtained by using Example 2.
19499
19487
  * ```
19500
19488
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
19501
- * &RegionId=cn-hangzhou
19489
+ * &RegionId=ap-southeast-1
19502
19490
  * &ResourceId=i-bp67acfmxazb4p****
19503
19491
  * &DestinationResource=SystemDisk
19504
19492
  * &OperationType=Upgrade
19505
19493
  * &InstanceType=ecs.g7.large
19506
- * &<Common request parameters>
19494
+ * &Common request parameters
19507
19495
  * ```
19508
19496
  *
19509
19497
  * @param request - DescribeResourcesModificationRequest
@@ -19587,42 +19575,42 @@ export default class Client extends OpenApi {
19587
19575
  }
19588
19576
 
19589
19577
  /**
19590
- * 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.
19578
+ * 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.
19591
19579
  *
19592
19580
  * @remarks
19593
- * Examples of common scenarios in which this operation is used:
19594
- * ### [](#-1)Example 1: Query the instance types to which you can change the instance type of an instance.
19595
- * 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.
19581
+ * The following examples describe common change scenarios:
19582
+ * ### Example 1: Query instance types to which the current instance can be changed
19583
+ * 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.
19596
19584
  * ```
19597
19585
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
19598
- * &RegionId=cn-hangzhou
19586
+ * &RegionId=ap-southeast-1
19599
19587
  * &ResourceId=i-bp67acfmxazb4p****
19600
19588
  * &DestinationResource=InstanceType
19601
19589
  * &OperationType=Upgrade
19602
- * &<Common request parameters>
19590
+ * &Common request parameters
19603
19591
  * ```
19604
- * ### [](#-2)Example 2: Query the instance types to which you can change the instance type of an instance after a system disk category change.
19605
- * 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.
19592
+ * ### Example 2: Query instance types available after changing the disk type of the current instance
19593
+ * 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.
19606
19594
  * ```
19607
19595
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
19608
- * &RegionId=cn-hangzhou
19596
+ * &RegionId=ap-southeast-1
19609
19597
  * &ResourceId=i-bp67acfmxazb4p****
19610
19598
  * &DestinationResource=InstanceType
19611
19599
  * &OperationType=Upgrade
19612
19600
  * &Conditions.0=DiskCategory
19613
- * &<Common request parameters>
19601
+ * &Common request parameters
19614
19602
  * ```
19615
- * ### [](#-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.
19616
- * 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.
19617
- * > 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.
19603
+ * ### Example 3: Query the disk type required by the target instance type
19604
+ * 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.
19605
+ * > The target instance type must be obtained by using Example 2.
19618
19606
  * ```
19619
19607
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
19620
- * &RegionId=cn-hangzhou
19608
+ * &RegionId=ap-southeast-1
19621
19609
  * &ResourceId=i-bp67acfmxazb4p****
19622
19610
  * &DestinationResource=SystemDisk
19623
19611
  * &OperationType=Upgrade
19624
19612
  * &InstanceType=ecs.g7.large
19625
- * &<Common request parameters>
19613
+ * &Common request parameters
19626
19614
  * ```
19627
19615
  *
19628
19616
  * @param request - DescribeResourcesModificationRequest
@@ -19940,7 +19928,7 @@ export default class Client extends OpenApi {
19940
19928
  }
19941
19929
 
19942
19930
  /**
19943
- * Queries the details of a specified security group and the security group rules of the security group.
19931
+ * Queries the details of a specified security group, including the list of security group rules.
19944
19932
  *
19945
19933
  * @param request - DescribeSecurityGroupAttributeRequest
19946
19934
  * @param runtime - runtime options for this request RuntimeOptions
@@ -20011,7 +19999,7 @@ export default class Client extends OpenApi {
20011
19999
  }
20012
20000
 
20013
20001
  /**
20014
- * Queries the details of a specified security group and the security group rules of the security group.
20002
+ * Queries the details of a specified security group, including the list of security group rules.
20015
20003
  *
20016
20004
  * @param request - DescribeSecurityGroupAttributeRequest
20017
20005
  * @returns DescribeSecurityGroupAttributeResponse
@@ -20090,14 +20078,14 @@ export default class Client extends OpenApi {
20090
20078
  }
20091
20079
 
20092
20080
  /**
20093
- * 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.
20081
+ * 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.
20094
20082
  *
20095
20083
  * @remarks
20096
- * - **Paged queries**: We recommend that you use the `MaxResults` and `NextToken` parameters for queries.
20097
- * - When the response does not contain `NextToken`, the current page is the last page and no more pages are available.
20098
- * - 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.
20099
- * - 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.
20100
- * - 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).
20084
+ * - **Paging query**: Use `MaxResults` and `NextToken` for paging query.
20085
+ * - If `NextToken` is not returned, the current page is the last page.
20086
+ * - 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.
20087
+ * - 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.
20088
+ * - 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).
20101
20089
  *
20102
20090
  * @param request - DescribeSecurityGroupsRequest
20103
20091
  * @param runtime - runtime options for this request RuntimeOptions
@@ -20208,14 +20196,14 @@ export default class Client extends OpenApi {
20208
20196
  }
20209
20197
 
20210
20198
  /**
20211
- * 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.
20199
+ * 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.
20212
20200
  *
20213
20201
  * @remarks
20214
- * - **Paged queries**: We recommend that you use the `MaxResults` and `NextToken` parameters for queries.
20215
- * - When the response does not contain `NextToken`, the current page is the last page and no more pages are available.
20216
- * - 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.
20217
- * - 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.
20218
- * - 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).
20202
+ * - **Paging query**: Use `MaxResults` and `NextToken` for paging query.
20203
+ * - If `NextToken` is not returned, the current page is the last page.
20204
+ * - 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.
20205
+ * - 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.
20206
+ * - 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).
20219
20207
  *
20220
20208
  * @param request - DescribeSecurityGroupsRequest
20221
20209
  * @returns DescribeSecurityGroupsResponse
@@ -20226,13 +20214,13 @@ export default class Client extends OpenApi {
20226
20214
  }
20227
20215
 
20228
20216
  /**
20229
- * Queries the files sent by Cloud Assistant and their status.
20217
+ * Queries the list and status of files sent by Cloud Assistant by calling DescribeSendFileResults.
20230
20218
  *
20231
20219
  * @remarks
20232
- * ## [](#)Usage notes
20233
- * - 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.
20234
- * - You can call this operation to query the file sending records within the last six weeks.
20235
- * - 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.
20220
+ * ## Operation description:
20221
+ * - 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.
20222
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
20223
+ * - 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.
20236
20224
  *
20237
20225
  * @param request - DescribeSendFileResultsRequest
20238
20226
  * @param runtime - runtime options for this request RuntimeOptions
@@ -20323,13 +20311,13 @@ export default class Client extends OpenApi {
20323
20311
  }
20324
20312
 
20325
20313
  /**
20326
- * Queries the files sent by Cloud Assistant and their status.
20314
+ * Queries the list and status of files sent by Cloud Assistant by calling DescribeSendFileResults.
20327
20315
  *
20328
20316
  * @remarks
20329
- * ## [](#)Usage notes
20330
- * - 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.
20331
- * - You can call this operation to query the file sending records within the last six weeks.
20332
- * - 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.
20317
+ * ## Operation description:
20318
+ * - 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.
20319
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
20320
+ * - 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.
20333
20321
  *
20334
20322
  * @param request - DescribeSendFileResultsRequest
20335
20323
  * @returns DescribeSendFileResultsResponse
@@ -20690,47 +20678,39 @@ export default class Client extends OpenApi {
20690
20678
  }
20691
20679
 
20692
20680
  /**
20693
- * Queries details about a cloud disk\\"s snapshots, including their status, the time remaining until completion, and the retention days for automatic snapshots.
20681
+ * Queries the snapshot list of a disk, including snapshot status, remaining time for a snapshot being created, and automatic snapshot retention days.
20694
20682
  *
20695
20683
  * @remarks
20696
- * 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.
20697
- * 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).
20684
+ * 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.
20685
+ * 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).
20698
20686
  * Request examples:
20699
20687
  * <details>
20700
- * <summary>
20701
- * Query the snapshots of all cloud disks attached to an ECS instance in the China (Hangzhou) region
20702
- * </summary>
20688
+ * <summary>Query the snapshot list of all disks attached to an ECS instance in the China (Hangzhou) region</summary>
20703
20689
  * ```
20704
- * RegionId: cn-hangzhou, // The ID of the region.
20705
- * InstanceId: i-bp1fh7by6d9mw7zr**** // The ID of the instance to query.
20690
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20691
+ * InstanceId: i-bp1fh7by6d9mw7zr**** // Set the instance ID to query.
20706
20692
  * ```
20707
20693
  * </details>
20708
20694
  * <details>
20709
- * <summary>
20710
- * Query the snapshots of a cloud disk in the China (Hangzhou) region
20711
- * </summary>
20695
+ * <summary>Query the snapshot information of a specific disk in the China (Hangzhou) region</summary>
20712
20696
  * ```
20713
- * RegionId: cn-hangzhou, // The ID of the region.
20714
- * DiskId: d-bp10e7ej8z743dmu**** // The ID of the cloud disk to query.
20697
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20698
+ * DiskId: d-bp10e7ej8z743dmu**** // Set the disk ID to query.
20715
20699
  * ```
20716
20700
  * </details>
20717
20701
  * <details>
20718
- * <summary>
20719
- * Query two snapshots in the China (Hangzhou) region by snapshot ID
20720
- * </summary>
20702
+ * <summary>Query the information of two snapshots in the China (Hangzhou) region by snapshot ID</summary>
20721
20703
  * ```
20722
- * RegionId: cn-hangzhou, // The ID of the region.
20723
- * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // The snapshot IDs to query.
20704
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20705
+ * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // Set the array of snapshot IDs to query.
20724
20706
  * ```
20725
20707
  * </details>
20726
20708
  * <details>
20727
- * <summary>
20728
- * Query snapshots created after a specific time in the China (Hangzhou) region
20729
- * </summary>
20709
+ * <summary>Query the snapshot information created after a specific point in time in the China (Hangzhou) region</summary>
20730
20710
  * ```
20731
- * RegionId: cn-hangzhou, // The ID of the region.
20732
- * Filter.1.Key: CreationStartTime, // Filters by the creation start time.
20733
- * Filter.1.Value: 2024-11-27T00:00Z
20711
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20712
+ * Filter.1.Key: CreationStartTime, // Set the filter key for the creation start time.
20713
+ * Filter.1.Value: 2024-11-27T00:00Z.
20734
20714
  * ```
20735
20715
  * </details>
20736
20716
  *
@@ -20859,47 +20839,39 @@ export default class Client extends OpenApi {
20859
20839
  }
20860
20840
 
20861
20841
  /**
20862
- * Queries details about a cloud disk\\"s snapshots, including their status, the time remaining until completion, and the retention days for automatic snapshots.
20842
+ * Queries the snapshot list of a disk, including snapshot status, remaining time for a snapshot being created, and automatic snapshot retention days.
20863
20843
  *
20864
20844
  * @remarks
20865
- * 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.
20866
- * 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).
20845
+ * 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.
20846
+ * 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).
20867
20847
  * Request examples:
20868
20848
  * <details>
20869
- * <summary>
20870
- * Query the snapshots of all cloud disks attached to an ECS instance in the China (Hangzhou) region
20871
- * </summary>
20849
+ * <summary>Query the snapshot list of all disks attached to an ECS instance in the China (Hangzhou) region</summary>
20872
20850
  * ```
20873
- * RegionId: cn-hangzhou, // The ID of the region.
20874
- * InstanceId: i-bp1fh7by6d9mw7zr**** // The ID of the instance to query.
20851
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20852
+ * InstanceId: i-bp1fh7by6d9mw7zr**** // Set the instance ID to query.
20875
20853
  * ```
20876
20854
  * </details>
20877
20855
  * <details>
20878
- * <summary>
20879
- * Query the snapshots of a cloud disk in the China (Hangzhou) region
20880
- * </summary>
20856
+ * <summary>Query the snapshot information of a specific disk in the China (Hangzhou) region</summary>
20881
20857
  * ```
20882
- * RegionId: cn-hangzhou, // The ID of the region.
20883
- * DiskId: d-bp10e7ej8z743dmu**** // The ID of the cloud disk to query.
20858
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20859
+ * DiskId: d-bp10e7ej8z743dmu**** // Set the disk ID to query.
20884
20860
  * ```
20885
20861
  * </details>
20886
20862
  * <details>
20887
- * <summary>
20888
- * Query two snapshots in the China (Hangzhou) region by snapshot ID
20889
- * </summary>
20863
+ * <summary>Query the information of two snapshots in the China (Hangzhou) region by snapshot ID</summary>
20890
20864
  * ```
20891
- * RegionId: cn-hangzhou, // The ID of the region.
20892
- * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // The snapshot IDs to query.
20865
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20866
+ * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // Set the array of snapshot IDs to query.
20893
20867
  * ```
20894
20868
  * </details>
20895
20869
  * <details>
20896
- * <summary>
20897
- * Query snapshots created after a specific time in the China (Hangzhou) region
20898
- * </summary>
20870
+ * <summary>Query the snapshot information created after a specific point in time in the China (Hangzhou) region</summary>
20899
20871
  * ```
20900
- * RegionId: cn-hangzhou, // The ID of the region.
20901
- * Filter.1.Key: CreationStartTime, // Filters by the creation start time.
20902
- * Filter.1.Value: 2024-11-27T00:00Z
20872
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20873
+ * Filter.1.Key: CreationStartTime, // Set the filter key for the creation start time.
20874
+ * Filter.1.Value: 2024-11-27T00:00Z.
20903
20875
  * ```
20904
20876
  * </details>
20905
20877
  *
@@ -21092,11 +21064,11 @@ export default class Client extends OpenApi {
21092
21064
  }
21093
21065
 
21094
21066
  /**
21095
- * 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.
21067
+ * 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.
21096
21068
  *
21097
21069
  * @remarks
21098
- * - This operation is applicable only to I/O optimized spot instances.
21099
- * - 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.
21070
+ * - Only I/O optimized spot instances are supported.
21071
+ * - 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.
21100
21072
  *
21101
21073
  * @param request - DescribeSpotPriceHistoryRequest
21102
21074
  * @param runtime - runtime options for this request RuntimeOptions
@@ -21183,11 +21155,11 @@ export default class Client extends OpenApi {
21183
21155
  }
21184
21156
 
21185
21157
  /**
21186
- * 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.
21158
+ * 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.
21187
21159
  *
21188
21160
  * @remarks
21189
- * - This operation is applicable only to I/O optimized spot instances.
21190
- * - 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.
21161
+ * - Only I/O optimized spot instances are supported.
21162
+ * - 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.
21191
21163
  *
21192
21164
  * @param request - DescribeSpotPriceHistoryRequest
21193
21165
  * @returns DescribeSpotPriceHistoryResponse
@@ -21697,10 +21669,10 @@ export default class Client extends OpenApi {
21697
21669
  }
21698
21670
 
21699
21671
  /**
21700
- * Queries the session records of Elastic Compute Service (ECS) Session Manager.
21672
+ * Queries the session history of Session Manager.
21701
21673
  *
21702
21674
  * @remarks
21703
- * You can query the session records of Session Manager that were generated in the last four weeks.
21675
+ * You can query Session Manager session records created within the last 30 days. A maximum of 1,000 successful records are retained.
21704
21676
  *
21705
21677
  * @param request - DescribeTerminalSessionsRequest
21706
21678
  * @param runtime - runtime options for this request RuntimeOptions
@@ -21763,10 +21735,10 @@ export default class Client extends OpenApi {
21763
21735
  }
21764
21736
 
21765
21737
  /**
21766
- * Queries the session records of Elastic Compute Service (ECS) Session Manager.
21738
+ * Queries the session history of Session Manager.
21767
21739
  *
21768
21740
  * @remarks
21769
- * You can query the session records of Session Manager that were generated in the last four weeks.
21741
+ * You can query Session Manager session records created within the last 30 days. A maximum of 1,000 successful records are retained.
21770
21742
  *
21771
21743
  * @param request - DescribeTerminalSessionsRequest
21772
21744
  * @returns DescribeTerminalSessionsResponse
@@ -22387,11 +22359,10 @@ export default class Client extends OpenApi {
22387
22359
  }
22388
22360
 
22389
22361
  /**
22390
- * Queries Alibaba Cloud regions. You can specify parameters, such as InstanceChargeType and ResourceType, in the request.
22362
+ * Queries the list of active zones based on parameters such as region ID and billing method.
22391
22363
  *
22392
22364
  * @remarks
22393
- * ## [](#)Usage notes
22394
- * 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.
22365
+ * 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).
22395
22366
  *
22396
22367
  * @param request - DescribeZonesRequest
22397
22368
  * @param runtime - runtime options for this request RuntimeOptions
@@ -22454,11 +22425,10 @@ export default class Client extends OpenApi {
22454
22425
  }
22455
22426
 
22456
22427
  /**
22457
- * Queries Alibaba Cloud regions. You can specify parameters, such as InstanceChargeType and ResourceType, in the request.
22428
+ * Queries the list of active zones based on parameters such as region ID and billing method.
22458
22429
  *
22459
22430
  * @remarks
22460
- * ## [](#)Usage notes
22461
- * 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.
22431
+ * 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).
22462
22432
  *
22463
22433
  * @param request - DescribeZonesRequest
22464
22434
  * @returns DescribeZonesResponse
@@ -23583,7 +23553,7 @@ export default class Client extends OpenApi {
23583
23553
  }
23584
23554
 
23585
23555
  /**
23586
- * Retrieves the system command line output of an instance. The data is returned in Base64 encoding.
23556
+ * Retrieves the system command-line output of an instance. The data is returned in Base64-encoded format.
23587
23557
  *
23588
23558
  * @remarks
23589
23559
  * - 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.
@@ -23647,7 +23617,7 @@ export default class Client extends OpenApi {
23647
23617
  }
23648
23618
 
23649
23619
  /**
23650
- * Retrieves the system command line output of an instance. The data is returned in Base64 encoding.
23620
+ * Retrieves the system command-line output of an instance. The data is returned in Base64-encoded format.
23651
23621
  *
23652
23622
  * @remarks
23653
23623
  * - 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.
@@ -23663,13 +23633,13 @@ export default class Client extends OpenApi {
23663
23633
  }
23664
23634
 
23665
23635
  /**
23666
- * Calls GetInstanceScreenshot to obtain the screenshot information of an instance.
23636
+ * Calls GetInstanceScreenshot to retrieve the screenshot information of an instance.
23667
23637
  *
23668
23638
  * @remarks
23669
- * 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:
23639
+ * 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:
23670
23640
  * - The instance must be in the Running state.
23671
- * - You cannot obtain screenshot information for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
23672
- * - 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.
23641
+ * - Screenshots cannot be retrieved for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
23642
+ * - 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.
23673
23643
  *
23674
23644
  * @param request - GetInstanceScreenshotRequest
23675
23645
  * @param runtime - runtime options for this request RuntimeOptions
@@ -23728,13 +23698,13 @@ export default class Client extends OpenApi {
23728
23698
  }
23729
23699
 
23730
23700
  /**
23731
- * Calls GetInstanceScreenshot to obtain the screenshot information of an instance.
23701
+ * Calls GetInstanceScreenshot to retrieve the screenshot information of an instance.
23732
23702
  *
23733
23703
  * @remarks
23734
- * 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:
23704
+ * 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:
23735
23705
  * - The instance must be in the Running state.
23736
- * - You cannot obtain screenshot information for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
23737
- * - 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.
23706
+ * - Screenshots cannot be retrieved for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
23707
+ * - 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.
23738
23708
  *
23739
23709
  * @param request - GetInstanceScreenshotRequest
23740
23710
  * @returns GetInstanceScreenshotResponse
@@ -26957,7 +26927,7 @@ export default class Client extends OpenApi {
26957
26927
  }
26958
26928
 
26959
26929
  /**
26960
- * Modifies the description of an HPC cluster by calling ModifyHpcClusterAttribute.
26930
+ * Modifies the description of an HPC cluster.
26961
26931
  *
26962
26932
  * @param request - ModifyHpcClusterAttributeRequest
26963
26933
  * @param runtime - runtime options for this request RuntimeOptions
@@ -27024,7 +26994,7 @@ export default class Client extends OpenApi {
27024
26994
  }
27025
26995
 
27026
26996
  /**
27027
- * Modifies the description of an HPC cluster by calling ModifyHpcClusterAttribute.
26997
+ * Modifies the description of an HPC cluster.
27028
26998
  *
27029
26999
  * @param request - ModifyHpcClusterAttributeRequest
27030
27000
  * @returns ModifyHpcClusterAttributeResponse
@@ -27400,10 +27370,10 @@ export default class Client extends OpenApi {
27400
27370
  }
27401
27371
 
27402
27372
  /**
27403
- * This API modifies attributes of an ECS instance, such as the password, instance name, hostname, security group, MTU, and user data.
27373
+ * Modifies some properties of an ECS instance, including the password, instance name, hostname, security group membership, MTU, and instance user data.
27404
27374
  *
27405
27375
  * @remarks
27406
- * 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).
27376
+ * 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).
27407
27377
  *
27408
27378
  * @param request - ModifyInstanceAttributeRequest
27409
27379
  * @param runtime - runtime options for this request RuntimeOptions
@@ -27510,10 +27480,10 @@ export default class Client extends OpenApi {
27510
27480
  }
27511
27481
 
27512
27482
  /**
27513
- * This API modifies attributes of an ECS instance, such as the password, instance name, hostname, security group, MTU, and user data.
27483
+ * Modifies some properties of an ECS instance, including the password, instance name, hostname, security group membership, MTU, and instance user data.
27514
27484
  *
27515
27485
  * @remarks
27516
- * 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).
27486
+ * 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).
27517
27487
  *
27518
27488
  * @param request - ModifyInstanceAttributeRequest
27519
27489
  * @returns ModifyInstanceAttributeResponse
@@ -28241,15 +28211,14 @@ export default class Client extends OpenApi {
28241
28211
  * 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.
28242
28212
  *
28243
28213
  * @remarks
28244
- * - 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.
28245
- * - 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.
28246
- * - 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.
28247
- * > 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~~).
28214
+ * - 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.
28215
+ * - 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.
28216
+ * > 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~~).
28248
28217
  *
28249
28218
  * - Fees:
28250
28219
  *
28251
- * - 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.
28252
- * - After downgrading bandwidth, the price difference is refunded through the original payment method. Coupons that have already been used are not refunded.
28220
+ * - 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.
28221
+ * - After the bandwidth is downgraded, the price difference is refunded to the original payment method. Vouchers that have been used are not refundable.
28253
28222
  *
28254
28223
  * @param request - ModifyInstanceNetworkSpecRequest
28255
28224
  * @param runtime - runtime options for this request RuntimeOptions
@@ -28335,15 +28304,14 @@ export default class Client extends OpenApi {
28335
28304
  * 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.
28336
28305
  *
28337
28306
  * @remarks
28338
- * - 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.
28339
- * - 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.
28340
- * - 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.
28341
- * > 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~~).
28307
+ * - 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.
28308
+ * - 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.
28309
+ * > 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~~).
28342
28310
  *
28343
28311
  * - Fees:
28344
28312
  *
28345
- * - 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.
28346
- * - After downgrading bandwidth, the price difference is refunded through the original payment method. Coupons that have already been used are not refunded.
28313
+ * - 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.
28314
+ * - After the bandwidth is downgraded, the price difference is refunded to the original payment method. Vouchers that have been used are not refundable.
28347
28315
  *
28348
28316
  * @param request - ModifyInstanceNetworkSpecRequest
28349
28317
  * @returns ModifyInstanceNetworkSpecResponse
@@ -28358,18 +28326,18 @@ export default class Client extends OpenApi {
28358
28326
  *
28359
28327
  * @remarks
28360
28328
  * <props="china">.
28361
- * **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.**.
28329
+ * **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.**.
28362
28330
  * .
28363
28331
  * <props="intl">.
28364
- * **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.**.
28332
+ * **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.**.
28365
28333
  * .
28366
28334
  * 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.
28367
28335
  * **Before you begin**.
28368
28336
  * - Your account must not have overdue payments.
28369
- * - Each call can modify only one configuration. You can change only the instance type or adjust only the public bandwidth in a single request.
28337
+ * - 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.
28370
28338
  * - The instance status must be **Running** (`Running`) or **Stopped** (`Stopped`) before you can adjust the public bandwidth. The change takes effect immediately.
28371
- * - 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.
28372
- * > 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~~).
28339
+ * - 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.
28340
+ * > 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~~).
28373
28341
  *
28374
28342
  * @param request - ModifyInstanceSpecRequest
28375
28343
  * @param runtime - runtime options for this request RuntimeOptions
@@ -28464,18 +28432,18 @@ export default class Client extends OpenApi {
28464
28432
  *
28465
28433
  * @remarks
28466
28434
  * <props="china">.
28467
- * **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.**.
28435
+ * **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.**.
28468
28436
  * .
28469
28437
  * <props="intl">.
28470
- * **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.**.
28438
+ * **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.**.
28471
28439
  * .
28472
28440
  * 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.
28473
28441
  * **Before you begin**.
28474
28442
  * - Your account must not have overdue payments.
28475
- * - Each call can modify only one configuration. You can change only the instance type or adjust only the public bandwidth in a single request.
28443
+ * - 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.
28476
28444
  * - The instance status must be **Running** (`Running`) or **Stopped** (`Stopped`) before you can adjust the public bandwidth. The change takes effect immediately.
28477
- * - 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.
28478
- * > 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~~).
28445
+ * - 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.
28446
+ * > 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~~).
28479
28447
  *
28480
28448
  * @param request - ModifyInstanceSpecRequest
28481
28449
  * @returns ModifyInstanceSpecResponse
@@ -29190,7 +29158,7 @@ export default class Client extends OpenApi {
29190
29158
  * Updates an O&M window.
29191
29159
  *
29192
29160
  * @remarks
29193
- * 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.
29161
+ * 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.
29194
29162
  *
29195
29163
  * @param tmpReq - ModifyPlanMaintenanceWindowRequest
29196
29164
  * @param runtime - runtime options for this request RuntimeOptions
@@ -29262,7 +29230,7 @@ export default class Client extends OpenApi {
29262
29230
  * Updates an O&M window.
29263
29231
  *
29264
29232
  * @remarks
29265
- * 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.
29233
+ * 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.
29266
29234
  *
29267
29235
  * @param request - ModifyPlanMaintenanceWindowRequest
29268
29236
  * @returns ModifyPlanMaintenanceWindowResponse
@@ -29459,20 +29427,24 @@ export default class Client extends OpenApi {
29459
29427
  }
29460
29428
 
29461
29429
  /**
29462
- * 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.
29430
+ * 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.
29463
29431
  *
29464
29432
  * @remarks
29465
- * *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.**
29466
- * 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.
29467
- * **Considerations**
29468
- * - Before you change the instance type of an expired instance, you must renew the instance.
29469
- * - When you downgrade the instance type of a subscription ECS instance, take note of the following items:
29470
- * - The instance must be in the **Stopped** (`Stopped`) state.
29471
- * - The price difference is refunded to the payment account that you used. Redeemed vouchers are not refundable.
29472
- * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html).
29473
- * - When you upgrade the instance type of a subscription ECS instance, take note of the following items:
29474
- * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
29475
- * - 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).
29433
+ * <props="china">
29434
+ * **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.**
29435
+ * <props="intl">
29436
+ * **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.**
29437
+ * 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.
29438
+ * **Precautions**
29439
+ * - 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.
29440
+ * - Expired instances cannot be changed to a different instance type. Complete the renewal and try again.
29441
+ * - Downgrade the instance type:
29442
+ * - The instance must be in the **Stopped** (`Stopped`) state.
29443
+ * - 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.
29444
+ * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html) after the Upgrade/Downgrade.
29445
+ * - Upgrade the instance type:
29446
+ * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
29447
+ * - 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).
29476
29448
  *
29477
29449
  * @param request - ModifyPrepayInstanceSpecRequest
29478
29450
  * @param runtime - runtime options for this request RuntimeOptions
@@ -29567,20 +29539,24 @@ export default class Client extends OpenApi {
29567
29539
  }
29568
29540
 
29569
29541
  /**
29570
- * 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.
29542
+ * 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.
29571
29543
  *
29572
29544
  * @remarks
29573
- * *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.**
29574
- * 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.
29575
- * **Considerations**
29576
- * - Before you change the instance type of an expired instance, you must renew the instance.
29577
- * - When you downgrade the instance type of a subscription ECS instance, take note of the following items:
29578
- * - The instance must be in the **Stopped** (`Stopped`) state.
29579
- * - The price difference is refunded to the payment account that you used. Redeemed vouchers are not refundable.
29580
- * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html).
29581
- * - When you upgrade the instance type of a subscription ECS instance, take note of the following items:
29582
- * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
29583
- * - 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).
29545
+ * <props="china">
29546
+ * **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.**
29547
+ * <props="intl">
29548
+ * **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.**
29549
+ * 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.
29550
+ * **Precautions**
29551
+ * - 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.
29552
+ * - Expired instances cannot be changed to a different instance type. Complete the renewal and try again.
29553
+ * - Downgrade the instance type:
29554
+ * - The instance must be in the **Stopped** (`Stopped`) state.
29555
+ * - 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.
29556
+ * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html) after the Upgrade/Downgrade.
29557
+ * - Upgrade the instance type:
29558
+ * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
29559
+ * - 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).
29584
29560
  *
29585
29561
  * @param request - ModifyPrepayInstanceSpecRequest
29586
29562
  * @returns ModifyPrepayInstanceSpecResponse
@@ -30159,12 +30135,12 @@ export default class Client extends OpenApi {
30159
30135
  }
30160
30136
 
30161
30137
  /**
30162
- * Modifies an egress security group rule.
30138
+ * Modifies an outbound security group rule.
30163
30139
  *
30164
30140
  * @remarks
30165
- * When modifying security group rules by specifying the security group rule ID, note the following usage limits:
30166
- * - 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.
30167
- * - 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.
30141
+ * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
30142
+ * - 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.
30143
+ * - 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.
30168
30144
  *
30169
30145
  * @param request - ModifySecurityGroupEgressRuleRequest
30170
30146
  * @param runtime - runtime options for this request RuntimeOptions
@@ -30291,12 +30267,12 @@ export default class Client extends OpenApi {
30291
30267
  }
30292
30268
 
30293
30269
  /**
30294
- * Modifies an egress security group rule.
30270
+ * Modifies an outbound security group rule.
30295
30271
  *
30296
30272
  * @remarks
30297
- * When modifying security group rules by specifying the security group rule ID, note the following usage limits:
30298
- * - 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.
30299
- * - 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.
30273
+ * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
30274
+ * - 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.
30275
+ * - 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.
30300
30276
  *
30301
30277
  * @param request - ModifySecurityGroupEgressRuleRequest
30302
30278
  * @returns ModifySecurityGroupEgressRuleResponse
@@ -30394,7 +30370,7 @@ export default class Client extends OpenApi {
30394
30370
  * @remarks
30395
30371
  * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
30396
30372
  * - 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.
30397
- * - 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.
30373
+ * - 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.
30398
30374
  *
30399
30375
  * @param request - ModifySecurityGroupRuleRequest
30400
30376
  * @param runtime - runtime options for this request RuntimeOptions
@@ -30526,7 +30502,7 @@ export default class Client extends OpenApi {
30526
30502
  * @remarks
30527
30503
  * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
30528
30504
  * - 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.
30529
- * - 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.
30505
+ * - 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.
30530
30506
  *
30531
30507
  * @param request - ModifySecurityGroupRuleRequest
30532
30508
  * @returns ModifySecurityGroupRuleResponse
@@ -30904,6 +30880,72 @@ export default class Client extends OpenApi {
30904
30880
  return await this.modifyStorageSetAttributeWithOptions(request, runtime);
30905
30881
  }
30906
30882
 
30883
+ /**
30884
+ * 修改计划内运维事件属性
30885
+ *
30886
+ * @remarks
30887
+ * ## 接口说明
30888
+ * - 只能修改状态为Scheduled的计划内运维事件。
30889
+ * - 传入的NotBefore不早于当前时间。
30890
+ * - 传入的NotBefore不晚于事件产生时初始的计划执行时间。
30891
+ *
30892
+ * @param request - ModifySystemEventAttributeRequest
30893
+ * @param runtime - runtime options for this request RuntimeOptions
30894
+ * @returns ModifySystemEventAttributeResponse
30895
+ */
30896
+ async modifySystemEventAttributeWithOptions(request: $_model.ModifySystemEventAttributeRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ModifySystemEventAttributeResponse> {
30897
+ request.validate();
30898
+ let query = { };
30899
+ if (!$dara.isNull(request.eventId)) {
30900
+ query["EventId"] = request.eventId;
30901
+ }
30902
+
30903
+ if (!$dara.isNull(request.instanceId)) {
30904
+ query["InstanceId"] = request.instanceId;
30905
+ }
30906
+
30907
+ if (!$dara.isNull(request.notBefore)) {
30908
+ query["NotBefore"] = request.notBefore;
30909
+ }
30910
+
30911
+ if (!$dara.isNull(request.regionId)) {
30912
+ query["RegionId"] = request.regionId;
30913
+ }
30914
+
30915
+ let req = new $OpenApiUtil.OpenApiRequest({
30916
+ query: OpenApiUtil.query(query),
30917
+ });
30918
+ let params = new $OpenApiUtil.Params({
30919
+ action: "ModifySystemEventAttribute",
30920
+ version: "2014-05-26",
30921
+ protocol: "HTTPS",
30922
+ pathname: "/",
30923
+ method: "POST",
30924
+ authType: "AK",
30925
+ style: "RPC",
30926
+ reqBodyType: "formData",
30927
+ bodyType: "json",
30928
+ });
30929
+ return $dara.cast<$_model.ModifySystemEventAttributeResponse>(await this.callApi(params, req, runtime), new $_model.ModifySystemEventAttributeResponse({}));
30930
+ }
30931
+
30932
+ /**
30933
+ * 修改计划内运维事件属性
30934
+ *
30935
+ * @remarks
30936
+ * ## 接口说明
30937
+ * - 只能修改状态为Scheduled的计划内运维事件。
30938
+ * - 传入的NotBefore不早于当前时间。
30939
+ * - 传入的NotBefore不晚于事件产生时初始的计划执行时间。
30940
+ *
30941
+ * @param request - ModifySystemEventAttributeRequest
30942
+ * @returns ModifySystemEventAttributeResponse
30943
+ */
30944
+ async modifySystemEventAttribute(request: $_model.ModifySystemEventAttributeRequest): Promise<$_model.ModifySystemEventAttributeResponse> {
30945
+ let runtime = new $dara.RuntimeOptions({ });
30946
+ return await this.modifySystemEventAttributeWithOptions(request, runtime);
30947
+ }
30948
+
30907
30949
  /**
30908
30950
  * Modifies the default user-level attributes.
30909
30951
  *
@@ -32806,7 +32848,7 @@ export default class Client extends OpenApi {
32806
32848
  }
32807
32849
 
32808
32850
  /**
32809
- * Renews elasticity assurances that you purchased.
32851
+ * Renews one or more purchased elasticity assurance services.
32810
32852
  *
32811
32853
  * @param request - RenewElasticityAssurancesRequest
32812
32854
  * @param runtime - runtime options for this request RuntimeOptions
@@ -32881,7 +32923,7 @@ export default class Client extends OpenApi {
32881
32923
  }
32882
32924
 
32883
32925
  /**
32884
- * Renews elasticity assurances that you purchased.
32926
+ * Renews one or more purchased elasticity assurance services.
32885
32927
  *
32886
32928
  * @param request - RenewElasticityAssurancesRequest
32887
32929
  * @returns RenewElasticityAssurancesResponse
@@ -33616,61 +33658,57 @@ export default class Client extends OpenApi {
33616
33658
  }
33617
33659
 
33618
33660
  /**
33619
- * Deletes inbound security group rules from a specific security group.
33661
+ * Deletes one or more inbound security group rules from a specified security group.
33620
33662
  *
33621
33663
  * @remarks
33622
- * > 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.
33623
- * You can use one of the following groups of parameters to specify the security group rules that you want to delete:
33624
- * - 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.
33625
- * - If a specified security group rule ID does not exist, the call to RevokeSecurityGroup fails.
33626
- * - Parameters that start with Permissions.
33627
- * - If no security group rule matches the specified parameters, the call to RevokeSecurityGroup is successful but no security group rules are deleted.
33628
- * - Define an inbound security group rule by configuring the following parameters together:
33629
- * - Source: You can specify one parameter from SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcetPrefixListId (prefix list ID), and SourceGroupId (source security group ID).
33630
- * - PortRange: specifies the destination port range.
33631
- * - IpProtocol: specifies the protocol.
33632
- * - Policy: specifies the action.
33633
- * > You cannot specify the IDs of security group rules and the parameters that start with Permissions in the same request.
33634
- * ### [](#)Sample requests
33635
- * - Delete a security group rule based on the rule ID:
33636
- * <!---->
33664
+ * >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.
33665
+ * You can use one of the following methods to pass parameters to delete rules:
33666
+ * - Specify security group rule IDs to delete rules (recommended).
33667
+ * - If a specified security group rule ID does not exist, the API invocation fails.
33668
+ * - Specify Permissions to delete rules.
33669
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
33670
+ * - The following parameters are required to identify an inbound rule:
33671
+ * - Source settings: Set one of SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
33672
+ * - Destination port range: PortRange.
33673
+ * - Protocol type: IpProtocol.
33674
+ * - Access policy: Policy.
33675
+ * > You cannot specify both security group rule IDs and Permissions at the same time.
33676
+ * ### Request examples
33677
+ * - Delete by specifying security group rule IDs.
33637
33678
  * ```
33638
- * "SecurityGroupId":"sg-bp67acfmxazb4p****", //Specify the ID of the security group.
33639
- * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] //Specify the ID of the security group rule.
33679
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
33680
+ * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
33640
33681
  * ```
33641
- * - Delete a security group rule based on an IPv4 CIDR block:
33642
- * <!---->
33682
+ * - Delete by specifying an IP address range.
33643
33683
  * ```
33644
33684
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
33645
33685
  * "Permissions":[
33646
33686
  * {
33647
- * "SourceCidrIp":"10.0.0.0/8", //Specify the source IPv4 CIDR block.
33648
- * "IpProtocol":"TCP", //Specify the protocol.
33649
- * "PortRange":"80/80", //Specify the destination port range.
33650
- * "Policy":"accept" //Specify the action.
33687
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IP address range.
33688
+ * "IpProtocol":"TCP", // Specify the protocol type.
33689
+ * "PortRange":"80/80", // Specify the destination port range.
33690
+ * "Policy":"accept" // Specify the access policy.
33651
33691
  * }
33652
33692
  * ]
33653
33693
  * ```
33654
- * - Delete a security group rule in which a security group is referenced:
33655
- * <!---->
33694
+ * - Delete by specifying another security group.
33656
33695
  * ```
33657
33696
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
33658
33697
  * "Permissions":[
33659
33698
  * {
33660
- * "SourceGroupId":"sg-bp67acfmxa123b****", //Specify the ID of the source security group.
33699
+ * "SourceGroupId":"sg-bp67acfmxa123b****", // Specify the source security group ID.
33661
33700
  * "IpProtocol":"TCP,"
33662
33701
  * "PortRange":"80/80",
33663
33702
  * "Policy":"accept"
33664
33703
  * ]
33665
33704
  * }
33666
33705
  * ```
33667
- * - Delete a security group rule in which a prefix list is referenced:
33668
- * <!---->
33706
+ * - Delete by specifying a prefix list.
33669
33707
  * ```
33670
33708
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
33671
33709
  * "Permissions":[
33672
33710
  * {
33673
- * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", //Specify the ID of the source prefix list.
33711
+ * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list ID.
33674
33712
  * "IpProtocol":"TCP",
33675
33713
  * "PortRange":"80/80",
33676
33714
  * "Policy":"accept"
@@ -33811,61 +33849,57 @@ export default class Client extends OpenApi {
33811
33849
  }
33812
33850
 
33813
33851
  /**
33814
- * Deletes inbound security group rules from a specific security group.
33852
+ * Deletes one or more inbound security group rules from a specified security group.
33815
33853
  *
33816
33854
  * @remarks
33817
- * > 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.
33818
- * You can use one of the following groups of parameters to specify the security group rules that you want to delete:
33819
- * - 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.
33820
- * - If a specified security group rule ID does not exist, the call to RevokeSecurityGroup fails.
33821
- * - Parameters that start with Permissions.
33822
- * - If no security group rule matches the specified parameters, the call to RevokeSecurityGroup is successful but no security group rules are deleted.
33823
- * - Define an inbound security group rule by configuring the following parameters together:
33824
- * - Source: You can specify one parameter from SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcetPrefixListId (prefix list ID), and SourceGroupId (source security group ID).
33825
- * - PortRange: specifies the destination port range.
33826
- * - IpProtocol: specifies the protocol.
33827
- * - Policy: specifies the action.
33828
- * > You cannot specify the IDs of security group rules and the parameters that start with Permissions in the same request.
33829
- * ### [](#)Sample requests
33830
- * - Delete a security group rule based on the rule ID:
33831
- * <!---->
33855
+ * >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.
33856
+ * You can use one of the following methods to pass parameters to delete rules:
33857
+ * - Specify security group rule IDs to delete rules (recommended).
33858
+ * - If a specified security group rule ID does not exist, the API invocation fails.
33859
+ * - Specify Permissions to delete rules.
33860
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
33861
+ * - The following parameters are required to identify an inbound rule:
33862
+ * - Source settings: Set one of SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
33863
+ * - Destination port range: PortRange.
33864
+ * - Protocol type: IpProtocol.
33865
+ * - Access policy: Policy.
33866
+ * > You cannot specify both security group rule IDs and Permissions at the same time.
33867
+ * ### Request examples
33868
+ * - Delete by specifying security group rule IDs.
33832
33869
  * ```
33833
- * "SecurityGroupId":"sg-bp67acfmxazb4p****", //Specify the ID of the security group.
33834
- * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] //Specify the ID of the security group rule.
33870
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
33871
+ * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
33835
33872
  * ```
33836
- * - Delete a security group rule based on an IPv4 CIDR block:
33837
- * <!---->
33873
+ * - Delete by specifying an IP address range.
33838
33874
  * ```
33839
33875
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
33840
33876
  * "Permissions":[
33841
33877
  * {
33842
- * "SourceCidrIp":"10.0.0.0/8", //Specify the source IPv4 CIDR block.
33843
- * "IpProtocol":"TCP", //Specify the protocol.
33844
- * "PortRange":"80/80", //Specify the destination port range.
33845
- * "Policy":"accept" //Specify the action.
33878
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IP address range.
33879
+ * "IpProtocol":"TCP", // Specify the protocol type.
33880
+ * "PortRange":"80/80", // Specify the destination port range.
33881
+ * "Policy":"accept" // Specify the access policy.
33846
33882
  * }
33847
33883
  * ]
33848
33884
  * ```
33849
- * - Delete a security group rule in which a security group is referenced:
33850
- * <!---->
33885
+ * - Delete by specifying another security group.
33851
33886
  * ```
33852
33887
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
33853
33888
  * "Permissions":[
33854
33889
  * {
33855
- * "SourceGroupId":"sg-bp67acfmxa123b****", //Specify the ID of the source security group.
33890
+ * "SourceGroupId":"sg-bp67acfmxa123b****", // Specify the source security group ID.
33856
33891
  * "IpProtocol":"TCP,"
33857
33892
  * "PortRange":"80/80",
33858
33893
  * "Policy":"accept"
33859
33894
  * ]
33860
33895
  * }
33861
33896
  * ```
33862
- * - Delete a security group rule in which a prefix list is referenced:
33863
- * <!---->
33897
+ * - Delete by specifying a prefix list.
33864
33898
  * ```
33865
33899
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
33866
33900
  * "Permissions":[
33867
33901
  * {
33868
- * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", //Specify the ID of the source prefix list.
33902
+ * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list ID.
33869
33903
  * "IpProtocol":"TCP",
33870
33904
  * "PortRange":"80/80",
33871
33905
  * "Policy":"accept"
@@ -33885,14 +33919,14 @@ export default class Client extends OpenApi {
33885
33919
  * Deletes one or more outbound security group rules from a specified security group.
33886
33920
  *
33887
33921
  * @remarks
33888
- * >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.
33922
+ * >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.
33889
33923
  * You can use one of the following methods to pass parameters to delete security group rules:
33890
33924
  * - Delete rules by specifying security group rule IDs (recommended).
33891
- * - If the specified security group rule ID does not exist, an error is returned.
33925
+ * - If a specified security group rule ID does not exist, a fault is returned.
33892
33926
  * - Delete rules by specifying the Permissions parameter.
33893
- * - If the matching security group rule does not exist, the invoke succeeds but no rule is deleted.
33927
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
33894
33928
  * - The following parameters are required to delete a security group rule:
33895
- * - Destination settings: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
33929
+ * - Destination: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
33896
33930
  * - Destination port range: PortRange.
33897
33931
  * - Protocol type: IpProtocol.
33898
33932
  * - Access policy: Policy.
@@ -33903,15 +33937,15 @@ export default class Client extends OpenApi {
33903
33937
  * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
33904
33938
  * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
33905
33939
  * ```
33906
- * - Delete by IP address CIDR block.
33940
+ * - Delete by IP CIDR block.
33907
33941
  * ```
33908
33942
  * "SecurityGroupId":"sg-bp67acfmxazb4ph***",
33909
33943
  * "Permissions":[
33910
33944
  * {
33911
33945
  * "IpProtocol":"TCP", // Specify the protocol type.
33912
- * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP address CIDR block.
33946
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP CIDR block.
33913
33947
  * "PortRange":"22/22", // Specify the destination port range.
33914
- * "Policy":"accept" // Specify the access policy.
33948
+ * "Policy":"accept" // Specify the authorization policy.
33915
33949
  * }
33916
33950
  * ]
33917
33951
  * ```
@@ -33939,7 +33973,7 @@ export default class Client extends OpenApi {
33939
33973
  * "Policy":"accept",
33940
33974
  * }
33941
33975
  * ]
33942
- * ```.
33976
+ * ```
33943
33977
  *
33944
33978
  * @param request - RevokeSecurityGroupEgressRequest
33945
33979
  * @param runtime - runtime options for this request RuntimeOptions
@@ -34081,14 +34115,14 @@ export default class Client extends OpenApi {
34081
34115
  * Deletes one or more outbound security group rules from a specified security group.
34082
34116
  *
34083
34117
  * @remarks
34084
- * >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.
34118
+ * >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.
34085
34119
  * You can use one of the following methods to pass parameters to delete security group rules:
34086
34120
  * - Delete rules by specifying security group rule IDs (recommended).
34087
- * - If the specified security group rule ID does not exist, an error is returned.
34121
+ * - If a specified security group rule ID does not exist, a fault is returned.
34088
34122
  * - Delete rules by specifying the Permissions parameter.
34089
- * - If the matching security group rule does not exist, the invoke succeeds but no rule is deleted.
34123
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
34090
34124
  * - The following parameters are required to delete a security group rule:
34091
- * - Destination settings: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
34125
+ * - Destination: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
34092
34126
  * - Destination port range: PortRange.
34093
34127
  * - Protocol type: IpProtocol.
34094
34128
  * - Access policy: Policy.
@@ -34099,15 +34133,15 @@ export default class Client extends OpenApi {
34099
34133
  * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
34100
34134
  * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
34101
34135
  * ```
34102
- * - Delete by IP address CIDR block.
34136
+ * - Delete by IP CIDR block.
34103
34137
  * ```
34104
34138
  * "SecurityGroupId":"sg-bp67acfmxazb4ph***",
34105
34139
  * "Permissions":[
34106
34140
  * {
34107
34141
  * "IpProtocol":"TCP", // Specify the protocol type.
34108
- * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP address CIDR block.
34142
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP CIDR block.
34109
34143
  * "PortRange":"22/22", // Specify the destination port range.
34110
- * "Policy":"accept" // Specify the access policy.
34144
+ * "Policy":"accept" // Specify the authorization policy.
34111
34145
  * }
34112
34146
  * ]
34113
34147
  * ```
@@ -34135,7 +34169,7 @@ export default class Client extends OpenApi {
34135
34169
  * "Policy":"accept",
34136
34170
  * }
34137
34171
  * ]
34138
- * ```.
34172
+ * ```
34139
34173
  *
34140
34174
  * @param request - RevokeSecurityGroupEgressRequest
34141
34175
  * @returns RevokeSecurityGroupEgressResponse
@@ -35326,22 +35360,22 @@ export default class Client extends OpenApi {
35326
35360
  }
35327
35361
 
35328
35362
  /**
35329
- * 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.
35363
+ * 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.
35330
35364
  *
35331
35365
  * @remarks
35332
- * ## API Guide
35333
- * 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:
35334
- * - The specified ECS instance must be in the running state.
35335
- * - 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.
35336
- * - 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.
35337
- * - 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).
35338
- * - Linux operating system: 2.2.3.256
35339
- * - Windows operating system: 2.1.3.256
35340
- * - After successful invocation of this API, the WebSocketUrl remains valid for 10 minutes.
35341
- * - If no data transmission occurs within 3 minutes after the session is established, Cloud Assistant shuts down the connection.
35342
- * - 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.
35343
- * - The port forwarding feature currently supports TCP port forwarding only and does not support UDP.
35344
- * - To permanently close a session and invalidate the WebSocketUrl, invoke the EndTerminalSession API.
35366
+ * ## Operation description
35367
+ * 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:
35368
+ * - The specified ECS instance must be in the Running state.
35369
+ * - 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.
35370
+ * - If Cloud Assistant Agent is not installed on the ECS instance, invoke [InstallCloudAssistant](https://help.aliyun.com/document_detail/85916.html) to install it.
35371
+ * - 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).
35372
+ * - Linux operating system: 2.2.3.256
35373
+ * - Windows operating system: 2.1.3.256
35374
+ * - After this operation is invoked, the WebSocketUrl is valid for 10 minutes.
35375
+ * - After a session is established, Cloud Assistant closes the connection if no data is transmitted for 3 minutes.
35376
+ * - 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.
35377
+ * - The port forwarding feature supports only TCP port forwarding. UDP is not supported.
35378
+ * - To permanently shutdown a session and invalidate the WebSocketUrl, invoke the EndTerminalSession operation.
35345
35379
  *
35346
35380
  * @param tmpReq - StartTerminalSessionRequest
35347
35381
  * @param runtime - runtime options for this request RuntimeOptions
@@ -35434,22 +35468,22 @@ export default class Client extends OpenApi {
35434
35468
  }
35435
35469
 
35436
35470
  /**
35437
- * 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.
35471
+ * 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.
35438
35472
  *
35439
35473
  * @remarks
35440
- * ## API Guide
35441
- * 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:
35442
- * - The specified ECS instance must be in the running state.
35443
- * - 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.
35444
- * - 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.
35445
- * - 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).
35446
- * - Linux operating system: 2.2.3.256
35447
- * - Windows operating system: 2.1.3.256
35448
- * - After successful invocation of this API, the WebSocketUrl remains valid for 10 minutes.
35449
- * - If no data transmission occurs within 3 minutes after the session is established, Cloud Assistant shuts down the connection.
35450
- * - 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.
35451
- * - The port forwarding feature currently supports TCP port forwarding only and does not support UDP.
35452
- * - To permanently close a session and invalidate the WebSocketUrl, invoke the EndTerminalSession API.
35474
+ * ## Operation description
35475
+ * 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:
35476
+ * - The specified ECS instance must be in the Running state.
35477
+ * - 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.
35478
+ * - If Cloud Assistant Agent is not installed on the ECS instance, invoke [InstallCloudAssistant](https://help.aliyun.com/document_detail/85916.html) to install it.
35479
+ * - 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).
35480
+ * - Linux operating system: 2.2.3.256
35481
+ * - Windows operating system: 2.1.3.256
35482
+ * - After this operation is invoked, the WebSocketUrl is valid for 10 minutes.
35483
+ * - After a session is established, Cloud Assistant closes the connection if no data is transmitted for 3 minutes.
35484
+ * - 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.
35485
+ * - The port forwarding feature supports only TCP port forwarding. UDP is not supported.
35486
+ * - To permanently shutdown a session and invalidate the WebSocketUrl, invoke the EndTerminalSession operation.
35453
35487
  *
35454
35488
  * @param request - StartTerminalSessionRequest
35455
35489
  * @returns StartTerminalSessionResponse
@@ -35460,13 +35494,13 @@ export default class Client extends OpenApi {
35460
35494
  }
35461
35495
 
35462
35496
  /**
35463
- * Stops an Elastic Compute Service (ECS) instance. You can specify parameters to determine whether to forcefully stop the instance and the stop mode.
35497
+ * Stops an Elastic Compute Service (ECS) instance. You can specify different stop strategies, stop modes, and batch operation modes to stop the ECS instance.
35464
35498
  *
35465
35499
  * @remarks
35466
- * 该接口为异步接口,实例的停止不是立即完成的,成功调用后,实例会先进入停止中(Stoping)状态,你可以调用 [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) 查看实例状态,当返回的状态为`Stopped `时代表启动成功。
35467
- * ### 使用须知
35468
- * - 被安全锁定的实例不能通过调用该接口停止。更多信息,请参见[资源安全锁定对调用 API 的影响](https://help.aliyun.com/document_detail/25695.html)
35469
- * - 开启 VPC 内实例节省停机模式后,您可以通过设置`StoppedMode=KeepCharging`开启普通停机模式,ECS 实例停止后会继续计费,并为您保留 ECS 实例规格库存和公网 IP 地址。
35500
+ * 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.
35501
+ * ### Before you begin
35502
+ * - 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).
35503
+ * - 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.
35470
35504
  *
35471
35505
  * @param request - StopInstanceRequest
35472
35506
  * @param runtime - runtime options for this request RuntimeOptions
@@ -35533,13 +35567,13 @@ export default class Client extends OpenApi {
35533
35567
  }
35534
35568
 
35535
35569
  /**
35536
- * Stops an Elastic Compute Service (ECS) instance. You can specify parameters to determine whether to forcefully stop the instance and the stop mode.
35570
+ * Stops an Elastic Compute Service (ECS) instance. You can specify different stop strategies, stop modes, and batch operation modes to stop the ECS instance.
35537
35571
  *
35538
35572
  * @remarks
35539
- * 该接口为异步接口,实例的停止不是立即完成的,成功调用后,实例会先进入停止中(Stoping)状态,你可以调用 [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) 查看实例状态,当返回的状态为`Stopped `时代表启动成功。
35540
- * ### 使用须知
35541
- * - 被安全锁定的实例不能通过调用该接口停止。更多信息,请参见[资源安全锁定对调用 API 的影响](https://help.aliyun.com/document_detail/25695.html)
35542
- * - 开启 VPC 内实例节省停机模式后,您可以通过设置`StoppedMode=KeepCharging`开启普通停机模式,ECS 实例停止后会继续计费,并为您保留 ECS 实例规格库存和公网 IP 地址。
35573
+ * 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.
35574
+ * ### Before you begin
35575
+ * - 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).
35576
+ * - 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.
35543
35577
  *
35544
35578
  * @param request - StopInstanceRequest
35545
35579
  * @returns StopInstanceResponse
@@ -35550,13 +35584,13 @@ export default class Client extends OpenApi {
35550
35584
  }
35551
35585
 
35552
35586
  /**
35553
- * Stops Elastic Compute Service (ECS) instances. You can specify parameters to determine whether to forcefully stop the instances and the stop mode.
35587
+ * Stops one or more ECS instances. You can specify the stop method, stop mode, and batch operation mode.
35554
35588
  *
35555
35589
  * @remarks
35556
- * 该接口为异步接口,实例的停止不是立即完成的,成功调用后,实例会先进入停止中(Stoping)状态,你可以调用 [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) 查看实例状态,当返回的状态为`Stopped `时代表停止成功。
35557
- * ### 使用须知
35558
- * - 停止实例后实例不可用,请确认停止实例不会对您的业务造成影响。您可以调用 [StartInstance](https://help.aliyun.com/document_detail/2679679.html) [StartInstances](https://help.aliyun.com/document_detail/2679680.html) 接口启动实例。
35559
- * - 被安全锁定的实例不能通过调用该接口停止。更多信息,请参见[资源安全锁定对调用 API 的影响](https://help.aliyun.com/document_detail/25695.html)
35590
+ * 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.
35591
+ * ### Before you begin
35592
+ * - 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.
35593
+ * - 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).
35560
35594
  *
35561
35595
  * @param request - StopInstancesRequest
35562
35596
  * @param runtime - runtime options for this request RuntimeOptions
@@ -35623,13 +35657,13 @@ export default class Client extends OpenApi {
35623
35657
  }
35624
35658
 
35625
35659
  /**
35626
- * Stops Elastic Compute Service (ECS) instances. You can specify parameters to determine whether to forcefully stop the instances and the stop mode.
35660
+ * Stops one or more ECS instances. You can specify the stop method, stop mode, and batch operation mode.
35627
35661
  *
35628
35662
  * @remarks
35629
- * 该接口为异步接口,实例的停止不是立即完成的,成功调用后,实例会先进入停止中(Stoping)状态,你可以调用 [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) 查看实例状态,当返回的状态为`Stopped `时代表停止成功。
35630
- * ### 使用须知
35631
- * - 停止实例后实例不可用,请确认停止实例不会对您的业务造成影响。您可以调用 [StartInstance](https://help.aliyun.com/document_detail/2679679.html) [StartInstances](https://help.aliyun.com/document_detail/2679680.html) 接口启动实例。
35632
- * - 被安全锁定的实例不能通过调用该接口停止。更多信息,请参见[资源安全锁定对调用 API 的影响](https://help.aliyun.com/document_detail/25695.html)
35663
+ * 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.
35664
+ * ### Before you begin
35665
+ * - 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.
35666
+ * - 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).
35633
35667
  *
35634
35668
  * @param request - StopInstancesRequest
35635
35669
  * @returns StopInstancesResponse
@@ -35955,8 +35989,8 @@ export default class Client extends OpenApi {
35955
35989
  * @remarks
35956
35990
  * ## Operation description
35957
35991
  * When you invoke this operation, take note of the following items:
35958
- * - The Elastic Network Interface (ENI) must be in the **Active** (Available) or **InUse** state.
35959
- * - 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.
35992
+ * - The Elastic Network Interface (ENI) must be in the **Active** or **InUse** state.
35993
+ * - 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.
35960
35994
  *
35961
35995
  * @param request - UnassignIpv6AddressesRequest
35962
35996
  * @param runtime - runtime options for this request RuntimeOptions
@@ -36024,8 +36058,8 @@ export default class Client extends OpenApi {
36024
36058
  * @remarks
36025
36059
  * ## Operation description
36026
36060
  * When you invoke this operation, take note of the following items:
36027
- * - The Elastic Network Interface (ENI) must be in the **Active** (Available) or **InUse** state.
36028
- * - 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.
36061
+ * - The Elastic Network Interface (ENI) must be in the **Active** or **InUse** state.
36062
+ * - 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.
36029
36063
  *
36030
36064
  * @param request - UnassignIpv6AddressesRequest
36031
36065
  * @returns UnassignIpv6AddressesResponse