@alicloud/ecs20140526 7.8.6 → 7.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (249) hide show
  1. package/dist/client.d.ts +843 -846
  2. package/dist/client.js +872 -842
  3. package/dist/client.js.map +1 -1
  4. package/dist/models/AcceptInquiredSystemEventRequest.d.ts +3 -3
  5. package/dist/models/AssignIpv6addressesRequest.d.ts +7 -7
  6. package/dist/models/AssignIpv6addressesResponseBody.d.ts +1 -1
  7. package/dist/models/AssignPrivateIpAddressesRequest.d.ts +13 -16
  8. package/dist/models/AssignPrivateIpAddressesRequest.js.map +1 -1
  9. package/dist/models/AssignPrivateIpAddressesResponseBody.d.ts +2 -2
  10. package/dist/models/AttachNetworkInterfaceRequest.d.ts +6 -7
  11. package/dist/models/AttachNetworkInterfaceRequest.js.map +1 -1
  12. package/dist/models/AuthorizeSecurityGroupEgressRequest.d.ts +73 -100
  13. package/dist/models/AuthorizeSecurityGroupEgressRequest.js.map +1 -1
  14. package/dist/models/AuthorizeSecurityGroupRequest.d.ts +70 -91
  15. package/dist/models/AuthorizeSecurityGroupRequest.js.map +1 -1
  16. package/dist/models/AuthorizeSecurityGroupResponseBody.d.ts +1 -1
  17. package/dist/models/CancelImagePipelineExecutionRequest.d.ts +2 -2
  18. package/dist/models/CreateActivationRequest.d.ts +17 -16
  19. package/dist/models/CreateActivationRequest.js.map +1 -1
  20. package/dist/models/CreateActivationResponseBody.d.ts +3 -3
  21. package/dist/models/CreateCommandRequest.d.ts +52 -73
  22. package/dist/models/CreateCommandRequest.js.map +1 -1
  23. package/dist/models/CreateCommandResponseBody.d.ts +2 -2
  24. package/dist/models/CreateDiskRequest.d.ts +57 -59
  25. package/dist/models/CreateDiskRequest.js.map +1 -1
  26. package/dist/models/CreateDiskResponseBody.d.ts +3 -3
  27. package/dist/models/CreateHpcClusterRequest.d.ts +5 -5
  28. package/dist/models/CreateHpcClusterResponseBody.d.ts +2 -2
  29. package/dist/models/CreateImageComponentRequest.d.ts +7 -7
  30. package/dist/models/CreateImageComponentResponseBody.d.ts +1 -1
  31. package/dist/models/CreateInstanceRequest.d.ts +184 -274
  32. package/dist/models/CreateInstanceRequest.js.map +1 -1
  33. package/dist/models/CreateInstanceResponseBody.d.ts +2 -2
  34. package/dist/models/CreateLaunchTemplateVersionRequest.d.ts +215 -244
  35. package/dist/models/CreateLaunchTemplateVersionRequest.js.map +1 -1
  36. package/dist/models/CreateLaunchTemplateVersionResponseBody.d.ts +2 -2
  37. package/dist/models/CreateSecurityGroupRequest.d.ts +13 -16
  38. package/dist/models/CreateSecurityGroupRequest.js.map +1 -1
  39. package/dist/models/CreateSecurityGroupResponseBody.d.ts +1 -1
  40. package/dist/models/DeleteHpcClusterRequest.d.ts +2 -2
  41. package/dist/models/DeleteImagePipelineRequest.d.ts +1 -1
  42. package/dist/models/DescribeAutoProvisioningGroupInstancesRequest.d.ts +5 -5
  43. package/dist/models/DescribeAutoProvisioningGroupInstancesResponseBody.d.ts +1 -1
  44. package/dist/models/DescribeAutoSnapshotPolicyExRequest.d.ts +11 -11
  45. package/dist/models/DescribeAutoSnapshotPolicyExResponseBody.d.ts +3 -3
  46. package/dist/models/DescribeAvailableResourceRequest.d.ts +50 -84
  47. package/dist/models/DescribeAvailableResourceRequest.js.map +1 -1
  48. package/dist/models/DescribeAvailableResourceResponseBody.d.ts +0 -4
  49. package/dist/models/DescribeAvailableResourceResponseBody.js.map +1 -1
  50. package/dist/models/DescribeDisksRequest.d.ts +40 -40
  51. package/dist/models/DescribeDisksResponseBody.d.ts +3 -3
  52. package/dist/models/DescribeImageComponentsRequest.d.ts +3 -3
  53. package/dist/models/DescribeImageComponentsResponseBody.d.ts +1 -1
  54. package/dist/models/DescribeInstanceAttributeRequest.d.ts +1 -1
  55. package/dist/models/DescribeInstanceAttributeResponseBody.d.ts +64 -96
  56. package/dist/models/DescribeInstanceAttributeResponseBody.js.map +1 -1
  57. package/dist/models/DescribeInstanceHistoryEventsRequest.d.ts +50 -85
  58. package/dist/models/DescribeInstanceHistoryEventsRequest.js.map +1 -1
  59. package/dist/models/DescribeInstanceHistoryEventsResponseBody.d.ts +16 -18
  60. package/dist/models/DescribeInstanceHistoryEventsResponseBody.js +2 -0
  61. package/dist/models/DescribeInstanceHistoryEventsResponseBody.js.map +1 -1
  62. package/dist/models/DescribeInstanceTopologyResponseBody.d.ts +14 -0
  63. package/dist/models/DescribeInstanceTopologyResponseBody.js +28 -1
  64. package/dist/models/DescribeInstanceTopologyResponseBody.js.map +1 -1
  65. package/dist/models/DescribeInstancesRequest.d.ts +54 -68
  66. package/dist/models/DescribeInstancesRequest.js.map +1 -1
  67. package/dist/models/DescribeInstancesResponseBody.d.ts +5 -5
  68. package/dist/models/DescribeInvocationResultsRequest.d.ts +52 -69
  69. package/dist/models/DescribeInvocationResultsRequest.js.map +1 -1
  70. package/dist/models/DescribeInvocationResultsResponseBody.d.ts +6 -52
  71. package/dist/models/DescribeInvocationResultsResponseBody.js.map +1 -1
  72. package/dist/models/DescribeInvocationsRequest.d.ts +49 -76
  73. package/dist/models/DescribeInvocationsRequest.js.map +1 -1
  74. package/dist/models/DescribeInvocationsResponseBody.d.ts +5 -5
  75. package/dist/models/DescribeLaunchTemplateVersionsRequest.d.ts +14 -14
  76. package/dist/models/DescribeLaunchTemplateVersionsResponseBody.d.ts +3 -3
  77. package/dist/models/DescribeNetworkInterfacePermissionsRequest.d.ts +4 -4
  78. package/dist/models/DescribePriceRequest.d.ts +158 -242
  79. package/dist/models/DescribePriceRequest.js.map +1 -1
  80. package/dist/models/DescribePriceResponseBody.d.ts +15 -15
  81. package/dist/models/DescribeRecommendInstanceTypeRequest.d.ts +45 -57
  82. package/dist/models/DescribeRecommendInstanceTypeRequest.js.map +1 -1
  83. package/dist/models/DescribeResourcesModificationRequest.d.ts +26 -37
  84. package/dist/models/DescribeResourcesModificationRequest.js.map +1 -1
  85. package/dist/models/DescribeSecurityGroupAttributeRequest.d.ts +17 -28
  86. package/dist/models/DescribeSecurityGroupAttributeRequest.js.map +1 -1
  87. package/dist/models/DescribeSecurityGroupAttributeResponseBody.d.ts +10 -9
  88. package/dist/models/DescribeSecurityGroupAttributeResponseBody.js.map +1 -1
  89. package/dist/models/DescribeSecurityGroupsRequest.d.ts +20 -20
  90. package/dist/models/DescribeSecurityGroupsResponseBody.d.ts +4 -4
  91. package/dist/models/DescribeSendFileResultsRequest.d.ts +21 -25
  92. package/dist/models/DescribeSendFileResultsRequest.js.map +1 -1
  93. package/dist/models/DescribeSendFileResultsResponseBody.d.ts +3 -3
  94. package/dist/models/DescribeSnapshotsRequest.d.ts +44 -59
  95. package/dist/models/DescribeSnapshotsRequest.js.map +1 -1
  96. package/dist/models/DescribeSnapshotsResponseBody.d.ts +4 -8
  97. package/dist/models/DescribeSnapshotsResponseBody.js.map +1 -1
  98. package/dist/models/DescribeSpotPriceHistoryRequest.d.ts +22 -28
  99. package/dist/models/DescribeSpotPriceHistoryRequest.js.map +1 -1
  100. package/dist/models/DescribeSpotPriceHistoryResponseBody.d.ts +7 -3
  101. package/dist/models/DescribeSpotPriceHistoryResponseBody.js.map +1 -1
  102. package/dist/models/DescribeTerminalSessionsRequest.d.ts +3 -3
  103. package/dist/models/DescribeTerminalSessionsResponseBody.d.ts +1 -1
  104. package/dist/models/DescribeZonesRequest.d.ts +18 -28
  105. package/dist/models/DescribeZonesRequest.js.map +1 -1
  106. package/dist/models/DescribeZonesResponseBody.d.ts +1 -1
  107. package/dist/models/GetInstanceConsoleOutputRequest.d.ts +1 -1
  108. package/dist/models/GetInstanceConsoleOutputResponseBody.d.ts +2 -2
  109. package/dist/models/ModifyHpcClusterAttributeRequest.d.ts +1 -1
  110. package/dist/models/ModifyInstanceAttributeRequest.d.ts +78 -106
  111. package/dist/models/ModifyInstanceAttributeRequest.js.map +1 -1
  112. package/dist/models/ModifyInstanceNetworkSpecRequest.d.ts +14 -14
  113. package/dist/models/ModifyInstanceNetworkSpecResponseBody.d.ts +1 -1
  114. package/dist/models/ModifyInstanceSpecRequest.d.ts +16 -16
  115. package/dist/models/ModifyPlanMaintenanceWindowRequest.d.ts +4 -4
  116. package/dist/models/ModifyPrepayInstanceSpecRequest.d.ts +28 -46
  117. package/dist/models/ModifyPrepayInstanceSpecRequest.js.map +1 -1
  118. package/dist/models/ModifyPrepayInstanceSpecResponseBody.d.ts +2 -2
  119. package/dist/models/ModifySecurityGroupEgressRuleRequest.d.ts +47 -46
  120. package/dist/models/ModifySecurityGroupEgressRuleRequest.js.map +1 -1
  121. package/dist/models/ModifySecurityGroupRuleRequest.d.ts +27 -24
  122. package/dist/models/ModifySecurityGroupRuleRequest.js.map +1 -1
  123. package/dist/models/ModifySystemEventAttributeRequest.d.ts +45 -0
  124. package/dist/models/ModifySystemEventAttributeRequest.js +64 -0
  125. package/dist/models/ModifySystemEventAttributeRequest.js.map +1 -0
  126. package/dist/models/ModifySystemEventAttributeResponse.d.ts +19 -0
  127. package/dist/models/ModifySystemEventAttributeResponse.js +69 -0
  128. package/dist/models/ModifySystemEventAttributeResponse.js.map +1 -0
  129. package/dist/models/ModifySystemEventAttributeResponseBody.d.ts +18 -0
  130. package/dist/models/ModifySystemEventAttributeResponseBody.js +58 -0
  131. package/dist/models/ModifySystemEventAttributeResponseBody.js.map +1 -0
  132. package/dist/models/RenewElasticityAssurancesRequest.d.ts +28 -24
  133. package/dist/models/RenewElasticityAssurancesRequest.js.map +1 -1
  134. package/dist/models/RenewElasticityAssurancesResponseBody.d.ts +1 -1
  135. package/dist/models/RevokeSecurityGroupEgressRequest.d.ts +35 -37
  136. package/dist/models/RevokeSecurityGroupEgressRequest.js.map +1 -1
  137. package/dist/models/RevokeSecurityGroupRequest.d.ts +71 -89
  138. package/dist/models/RevokeSecurityGroupRequest.js.map +1 -1
  139. package/dist/models/StartTerminalSessionRequest.d.ts +24 -32
  140. package/dist/models/StartTerminalSessionRequest.js.map +1 -1
  141. package/dist/models/StartTerminalSessionResponseBody.d.ts +2 -2
  142. package/dist/models/StartTerminalSessionShrinkRequest.d.ts +16 -18
  143. package/dist/models/StartTerminalSessionShrinkRequest.js.map +1 -1
  144. package/dist/models/StopInstanceRequest.d.ts +20 -27
  145. package/dist/models/StopInstanceRequest.js.map +1 -1
  146. package/dist/models/StopInstancesRequest.d.ts +24 -35
  147. package/dist/models/StopInstancesRequest.js.map +1 -1
  148. package/dist/models/UnassignIpv6addressesRequest.d.ts +3 -3
  149. package/dist/models/model.d.ts +4 -0
  150. package/dist/models/model.js +45 -37
  151. package/dist/models/model.js.map +1 -1
  152. package/package.json +1 -1
  153. package/src/client.ts +878 -842
  154. package/src/models/AcceptInquiredSystemEventRequest.ts +3 -3
  155. package/src/models/AssignIpv6addressesRequest.ts +7 -7
  156. package/src/models/AssignIpv6addressesResponseBody.ts +1 -1
  157. package/src/models/AssignPrivateIpAddressesRequest.ts +13 -16
  158. package/src/models/AssignPrivateIpAddressesResponseBody.ts +2 -2
  159. package/src/models/AttachNetworkInterfaceRequest.ts +6 -7
  160. package/src/models/AuthorizeSecurityGroupEgressRequest.ts +79 -106
  161. package/src/models/AuthorizeSecurityGroupRequest.ts +70 -91
  162. package/src/models/AuthorizeSecurityGroupResponseBody.ts +1 -1
  163. package/src/models/CancelImagePipelineExecutionRequest.ts +2 -2
  164. package/src/models/CreateActivationRequest.ts +17 -16
  165. package/src/models/CreateActivationResponseBody.ts +3 -3
  166. package/src/models/CreateCommandRequest.ts +52 -73
  167. package/src/models/CreateCommandResponseBody.ts +2 -2
  168. package/src/models/CreateDiskRequest.ts +57 -59
  169. package/src/models/CreateDiskResponseBody.ts +3 -3
  170. package/src/models/CreateHpcClusterRequest.ts +5 -5
  171. package/src/models/CreateHpcClusterResponseBody.ts +2 -2
  172. package/src/models/CreateImageComponentRequest.ts +7 -7
  173. package/src/models/CreateImageComponentResponseBody.ts +1 -1
  174. package/src/models/CreateInstanceRequest.ts +185 -275
  175. package/src/models/CreateInstanceResponseBody.ts +2 -2
  176. package/src/models/CreateLaunchTemplateVersionRequest.ts +215 -244
  177. package/src/models/CreateLaunchTemplateVersionResponseBody.ts +2 -2
  178. package/src/models/CreateSecurityGroupRequest.ts +13 -16
  179. package/src/models/CreateSecurityGroupResponseBody.ts +1 -1
  180. package/src/models/DeleteHpcClusterRequest.ts +2 -2
  181. package/src/models/DeleteImagePipelineRequest.ts +1 -1
  182. package/src/models/DescribeAutoProvisioningGroupInstancesRequest.ts +5 -5
  183. package/src/models/DescribeAutoProvisioningGroupInstancesResponseBody.ts +1 -1
  184. package/src/models/DescribeAutoSnapshotPolicyExRequest.ts +11 -11
  185. package/src/models/DescribeAutoSnapshotPolicyExResponseBody.ts +3 -3
  186. package/src/models/DescribeAvailableResourceRequest.ts +62 -96
  187. package/src/models/DescribeAvailableResourceResponseBody.ts +0 -4
  188. package/src/models/DescribeDisksRequest.ts +40 -40
  189. package/src/models/DescribeDisksResponseBody.ts +3 -3
  190. package/src/models/DescribeImageComponentsRequest.ts +3 -3
  191. package/src/models/DescribeImageComponentsResponseBody.ts +1 -1
  192. package/src/models/DescribeInstanceAttributeRequest.ts +1 -1
  193. package/src/models/DescribeInstanceAttributeResponseBody.ts +66 -98
  194. package/src/models/DescribeInstanceHistoryEventsRequest.ts +50 -85
  195. package/src/models/DescribeInstanceHistoryEventsResponseBody.ts +18 -18
  196. package/src/models/DescribeInstanceTopologyResponseBody.ts +32 -0
  197. package/src/models/DescribeInstancesRequest.ts +57 -71
  198. package/src/models/DescribeInstancesResponseBody.ts +5 -5
  199. package/src/models/DescribeInvocationResultsRequest.ts +52 -69
  200. package/src/models/DescribeInvocationResultsResponseBody.ts +6 -52
  201. package/src/models/DescribeInvocationsRequest.ts +50 -77
  202. package/src/models/DescribeInvocationsResponseBody.ts +5 -5
  203. package/src/models/DescribeLaunchTemplateVersionsRequest.ts +14 -14
  204. package/src/models/DescribeLaunchTemplateVersionsResponseBody.ts +3 -3
  205. package/src/models/DescribeNetworkInterfacePermissionsRequest.ts +4 -4
  206. package/src/models/DescribePriceRequest.ts +160 -244
  207. package/src/models/DescribePriceResponseBody.ts +15 -15
  208. package/src/models/DescribeRecommendInstanceTypeRequest.ts +45 -57
  209. package/src/models/DescribeResourcesModificationRequest.ts +30 -41
  210. package/src/models/DescribeSecurityGroupAttributeRequest.ts +18 -29
  211. package/src/models/DescribeSecurityGroupAttributeResponseBody.ts +11 -10
  212. package/src/models/DescribeSecurityGroupsRequest.ts +21 -21
  213. package/src/models/DescribeSecurityGroupsResponseBody.ts +4 -4
  214. package/src/models/DescribeSendFileResultsRequest.ts +21 -25
  215. package/src/models/DescribeSendFileResultsResponseBody.ts +3 -3
  216. package/src/models/DescribeSnapshotsRequest.ts +48 -63
  217. package/src/models/DescribeSnapshotsResponseBody.ts +4 -8
  218. package/src/models/DescribeSpotPriceHistoryRequest.ts +22 -28
  219. package/src/models/DescribeSpotPriceHistoryResponseBody.ts +7 -3
  220. package/src/models/DescribeTerminalSessionsRequest.ts +3 -3
  221. package/src/models/DescribeTerminalSessionsResponseBody.ts +1 -1
  222. package/src/models/DescribeZonesRequest.ts +20 -30
  223. package/src/models/DescribeZonesResponseBody.ts +1 -1
  224. package/src/models/GetInstanceConsoleOutputRequest.ts +1 -1
  225. package/src/models/GetInstanceConsoleOutputResponseBody.ts +2 -2
  226. package/src/models/ModifyHpcClusterAttributeRequest.ts +1 -1
  227. package/src/models/ModifyInstanceAttributeRequest.ts +80 -108
  228. package/src/models/ModifyInstanceNetworkSpecRequest.ts +14 -14
  229. package/src/models/ModifyInstanceNetworkSpecResponseBody.ts +1 -1
  230. package/src/models/ModifyInstanceSpecRequest.ts +16 -16
  231. package/src/models/ModifyPlanMaintenanceWindowRequest.ts +4 -4
  232. package/src/models/ModifyPrepayInstanceSpecRequest.ts +28 -46
  233. package/src/models/ModifyPrepayInstanceSpecResponseBody.ts +2 -2
  234. package/src/models/ModifySecurityGroupEgressRuleRequest.ts +47 -46
  235. package/src/models/ModifySecurityGroupRuleRequest.ts +27 -24
  236. package/src/models/ModifySystemEventAttributeRequest.ts +64 -0
  237. package/src/models/ModifySystemEventAttributeResponse.ts +40 -0
  238. package/src/models/ModifySystemEventAttributeResponseBody.ts +31 -0
  239. package/src/models/RenewElasticityAssurancesRequest.ts +28 -24
  240. package/src/models/RenewElasticityAssurancesResponseBody.ts +1 -1
  241. package/src/models/RevokeSecurityGroupEgressRequest.ts +35 -37
  242. package/src/models/RevokeSecurityGroupRequest.ts +75 -93
  243. package/src/models/StartTerminalSessionRequest.ts +24 -32
  244. package/src/models/StartTerminalSessionResponseBody.ts +2 -2
  245. package/src/models/StartTerminalSessionShrinkRequest.ts +16 -18
  246. package/src/models/StopInstanceRequest.ts +21 -28
  247. package/src/models/StopInstancesRequest.ts +25 -36
  248. package/src/models/UnassignIpv6addressesRequest.ts +3 -3
  249. package/src/models/model.ts +4 -0
package/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
@@ -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
@@ -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
@@ -4753,13 +4755,13 @@ export default class Client extends OpenApi {
4753
4755
  }
4754
4756
 
4755
4757
  /**
4756
- * Creates an image component. Image components store commonly used build template commands for image building.
4758
+ * Creates an image component. Image components are used to store commonly used build template commands for image building.
4757
4759
  *
4758
4760
  * @remarks
4759
4761
  * ## Operation description
4760
4762
  * 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.
4763
+ * - Only custom image components can be created.
4764
+ * - 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
4765
  * - 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
4766
  * For more information, see [Image Builder overview](https://help.aliyun.com/document_detail/197410.html).
4765
4767
  *
@@ -4852,13 +4854,13 @@ export default class Client extends OpenApi {
4852
4854
  }
4853
4855
 
4854
4856
  /**
4855
- * Creates an image component. Image components store commonly used build template commands for image building.
4857
+ * Creates an image component. Image components are used to store commonly used build template commands for image building.
4856
4858
  *
4857
4859
  * @remarks
4858
4860
  * ## Operation description
4859
4861
  * 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.
4862
+ * - Only custom image components can be created.
4863
+ * - 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
4864
  * - 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
4865
  * For more information, see [Image Builder overview](https://help.aliyun.com/document_detail/197410.html).
4864
4866
  *
@@ -5051,31 +5053,32 @@ export default class Client extends OpenApi {
5051
5053
  }
5052
5054
 
5053
5055
  /**
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.
5056
+ * Creates a subscription or pay-as-you-go Elastic Compute Service (ECS) instance with customizable parameters.
5055
5057
  *
5056
5058
  * @remarks
5057
- * > This API is deprecated. We recommend that you use the [RunInstances](https://help.aliyun.com/document_detail/2679677.html) API instead.
5059
+ * > This operation is no longer maintained. Use [RunInstances](https://help.aliyun.com/document_detail/2679677.html) instead.
5058
5060
  * <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.**
5061
+ * **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
5062
  * <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
5063
+ * **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.**
5064
+ * 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.
5065
+ * ### Before you begin
5064
5066
  * <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~~).
5067
+ * - 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).
5068
+ * - 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).
5069
+ *
5070
+ * - 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).
5071
+ * - 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).
5072
+ * ### Before you begin
5073
+ * - When you invoke this operation, the system does not send notifications (including text messages, emails, or internal messages) about instance creation.
5074
+ * - If the billable methods of the instance is subscription (`PrePaid`), active coupon in your account are used by default during payment.
5075
+ * - 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.
5076
+ * - 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.
5077
+ * > 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
5078
  * ### 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.
5079
+ * - **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.
5080
+ * - **Check active resources**: Invoke [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) to query active resources in a specific region or zone.
5081
+ * - **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
5082
  *
5080
5083
  * @param request - CreateInstanceRequest
5081
5084
  * @param runtime - runtime options for this request RuntimeOptions
@@ -5346,31 +5349,32 @@ export default class Client extends OpenApi {
5346
5349
  }
5347
5350
 
5348
5351
  /**
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.
5352
+ * Creates a subscription or pay-as-you-go Elastic Compute Service (ECS) instance with customizable parameters.
5350
5353
  *
5351
5354
  * @remarks
5352
- * > This API is deprecated. We recommend that you use the [RunInstances](https://help.aliyun.com/document_detail/2679677.html) API instead.
5355
+ * > This operation is no longer maintained. Use [RunInstances](https://help.aliyun.com/document_detail/2679677.html) instead.
5353
5356
  * <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.**
5357
+ * **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
5358
  * <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
5359
+ * **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.**
5360
+ * 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.
5361
+ * ### Before you begin
5359
5362
  * <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~~).
5363
+ * - 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).
5364
+ * - 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).
5365
+ *
5366
+ * - 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).
5367
+ * - 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).
5368
+ * ### Before you begin
5369
+ * - When you invoke this operation, the system does not send notifications (including text messages, emails, or internal messages) about instance creation.
5370
+ * - If the billable methods of the instance is subscription (`PrePaid`), active coupon in your account are used by default during payment.
5371
+ * - 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.
5372
+ * - 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.
5373
+ * > 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
5374
  * ### 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.
5375
+ * - **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.
5376
+ * - **Check active resources**: Invoke [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) to query active resources in a specific region or zone.
5377
+ * - **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
5378
  *
5375
5379
  * @param request - CreateInstanceRequest
5376
5380
  * @returns CreateInstanceResponse
@@ -5733,11 +5737,11 @@ export default class Client extends OpenApi {
5733
5737
  }
5734
5738
 
5735
5739
  /**
5736
- * Create a new version under the specified ECS instance launch template for subsequent creation of ECS instances, scaling groups, or auto provisioning groups.
5740
+ * Creates a new version in a specified ECS launch template for subsequent creation of ECS instances, elastic scaling groups, or auto provisioning groups.
5737
5741
  *
5738
5742
  * @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.
5743
+ * ## Operation description
5744
+ * To modify the parameters of a specific version, create a new template version. Each instance launch template supports a maximum of 30 versions.
5741
5745
  *
5742
5746
  * @param request - CreateLaunchTemplateVersionRequest
5743
5747
  * @param runtime - runtime options for this request RuntimeOptions
@@ -5984,11 +5988,11 @@ export default class Client extends OpenApi {
5984
5988
  }
5985
5989
 
5986
5990
  /**
5987
- * Create a new version under the specified ECS instance launch template for subsequent creation of ECS instances, scaling groups, or auto provisioning groups.
5991
+ * Creates a new version in a specified ECS launch template for subsequent creation of ECS instances, elastic scaling groups, or auto provisioning groups.
5988
5992
  *
5989
5993
  * @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.
5994
+ * ## Operation description
5995
+ * To modify the parameters of a specific version, create a new template version. Each instance launch template supports a maximum of 30 versions.
5992
5996
  *
5993
5997
  * @param request - CreateLaunchTemplateVersionRequest
5994
5998
  * @returns CreateLaunchTemplateVersionResponse
@@ -7116,10 +7120,10 @@ export default class Client extends OpenApi {
7116
7120
  * Creates a security group.
7117
7121
  *
7118
7122
  * @remarks
7119
- * - 通过该接口创建的普通安全组组内连通策略默认是**组内互通**,您可以通过 [ModifySecurityGroupPolicy](https://help.aliyun.com/document_detail/2679846.html) 进行修改。
7120
- * - 通过该接口创建的企业安全组组内连通策略默认是**组内隔离**,并且不能修改。
7121
- * - 单个地域下,安全组的数量有限制,您最少可以创建 100 个安全组。详细信息,请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
7122
- * - 创建专有网络 VPC 类型的安全组时,您必须指定参数 VpcId
7123
+ * - 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).
7124
+ * - The default internal connectivity policy for an advanced security group created by this operation is **internal isolation**, and this policy cannot be modified.
7125
+ * - 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~~).
7126
+ * - To create a security group of the VPC type, you must specify the VpcId parameter.
7123
7127
  *
7124
7128
  * @param request - CreateSecurityGroupRequest
7125
7129
  * @param runtime - runtime options for this request RuntimeOptions
@@ -7201,10 +7205,10 @@ export default class Client extends OpenApi {
7201
7205
  * Creates a security group.
7202
7206
  *
7203
7207
  * @remarks
7204
- * - 通过该接口创建的普通安全组组内连通策略默认是**组内互通**,您可以通过 [ModifySecurityGroupPolicy](https://help.aliyun.com/document_detail/2679846.html) 进行修改。
7205
- * - 通过该接口创建的企业安全组组内连通策略默认是**组内隔离**,并且不能修改。
7206
- * - 单个地域下,安全组的数量有限制,您最少可以创建 100 个安全组。详细信息,请参见[安全组使用限制](~~25412#SecurityGroupQuota1~~)
7207
- * - 创建专有网络 VPC 类型的安全组时,您必须指定参数 VpcId
7208
+ * - 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).
7209
+ * - The default internal connectivity policy for an advanced security group created by this operation is **internal isolation**, and this policy cannot be modified.
7210
+ * - 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~~).
7211
+ * - To create a security group of the VPC type, you must specify the VpcId parameter.
7208
7212
  *
7209
7213
  * @param request - CreateSecurityGroupRequest
7210
7214
  * @returns CreateSecurityGroupResponse
@@ -8873,7 +8877,7 @@ export default class Client extends OpenApi {
8873
8877
  }
8874
8878
 
8875
8879
  /**
8876
- * Deletes a High Performance Computing (HPC) cluster.
8880
+ * Calls DeleteHpcCluster to delete an HPC cluster.
8877
8881
  *
8878
8882
  * @param request - DeleteHpcClusterRequest
8879
8883
  * @param runtime - runtime options for this request RuntimeOptions
@@ -8932,7 +8936,7 @@ export default class Client extends OpenApi {
8932
8936
  }
8933
8937
 
8934
8938
  /**
8935
- * Deletes a High Performance Computing (HPC) cluster.
8939
+ * Calls DeleteHpcCluster to delete an HPC cluster.
8936
8940
  *
8937
8941
  * @param request - DeleteHpcClusterRequest
8938
8942
  * @returns DeleteHpcClusterResponse
@@ -9096,7 +9100,7 @@ export default class Client extends OpenApi {
9096
9100
  * Deletes an image template.
9097
9101
  *
9098
9102
  * @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.
9103
+ * 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
9104
  *
9101
9105
  * @param request - DeleteImagePipelineRequest
9102
9106
  * @param runtime - runtime options for this request RuntimeOptions
@@ -9154,7 +9158,7 @@ export default class Client extends OpenApi {
9154
9158
  * Deletes an image template.
9155
9159
  *
9156
9160
  * @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.
9161
+ * 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
9162
  *
9159
9163
  * @param request - DeleteImagePipelineRequest
9160
9164
  * @returns DeleteImagePipelineResponse
@@ -10010,10 +10014,10 @@ export default class Client extends OpenApi {
10010
10014
  }
10011
10015
 
10012
10016
  /**
10013
- * Deletes a specified prefix list and all entries in the prefix list.
10017
+ * Calls DeletePrefixList to delete a specified prefix list and all entries in the prefix list.
10014
10018
  *
10015
10019
  * @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.
10020
+ * 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
10021
  *
10018
10022
  * @param request - DeletePrefixListRequest
10019
10023
  * @param runtime - runtime options for this request RuntimeOptions
@@ -10068,10 +10072,10 @@ export default class Client extends OpenApi {
10068
10072
  }
10069
10073
 
10070
10074
  /**
10071
- * Deletes a specified prefix list and all entries in the prefix list.
10075
+ * Calls DeletePrefixList to delete a specified prefix list and all entries in the prefix list.
10072
10076
  *
10073
10077
  * @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.
10078
+ * 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
10079
  *
10076
10080
  * @param request - DeletePrefixListRequest
10077
10081
  * @returns DeletePrefixListResponse
@@ -11208,7 +11212,7 @@ export default class Client extends OpenApi {
11208
11212
  }
11209
11213
 
11210
11214
  /**
11211
- * Queries information about Elastic Compute Service (ECS) instances in an auto provisioning group.
11215
+ * Queries information about instances in an auto provisioning group.
11212
11216
  *
11213
11217
  * @param request - DescribeAutoProvisioningGroupInstancesRequest
11214
11218
  * @param runtime - runtime options for this request RuntimeOptions
@@ -11267,7 +11271,7 @@ export default class Client extends OpenApi {
11267
11271
  }
11268
11272
 
11269
11273
  /**
11270
- * Queries information about Elastic Compute Service (ECS) instances in an auto provisioning group.
11274
+ * Queries information about instances in an auto provisioning group.
11271
11275
  *
11272
11276
  * @param request - DescribeAutoProvisioningGroupInstancesRequest
11273
11277
  * @returns DescribeAutoProvisioningGroupInstancesResponse
@@ -11442,7 +11446,7 @@ export default class Client extends OpenApi {
11442
11446
  }
11443
11447
 
11444
11448
  /**
11445
- * Queries the details of automatic snapshot policies that are created in a specific region.
11449
+ * Queries the details of automatic snapshot policies that are created in a specified region.
11446
11450
  *
11447
11451
  * @param request - DescribeAutoSnapshotPolicyExRequest
11448
11452
  * @param runtime - runtime options for this request RuntimeOptions
@@ -11513,7 +11517,7 @@ export default class Client extends OpenApi {
11513
11517
  }
11514
11518
 
11515
11519
  /**
11516
- * Queries the details of automatic snapshot policies that are created in a specific region.
11520
+ * Queries the details of automatic snapshot policies that are created in a specified region.
11517
11521
  *
11518
11522
  * @param request - DescribeAutoSnapshotPolicyExRequest
11519
11523
  * @returns DescribeAutoSnapshotPolicyExResponse
@@ -11524,43 +11528,37 @@ export default class Client extends OpenApi {
11524
11528
  }
11525
11529
 
11526
11530
  /**
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`.
11531
+ * 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
11532
  *
11529
11533
  * @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`
11534
+ * 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.
11535
+ * - Value order: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
11532
11536
  * - 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`.
11537
+ * - If DestinationResource is set to `DataDisk`:
11538
+ * - 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.
11539
+ * - 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`.
11540
+ * - 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.
11541
+ * - If DestinationResource is set to `InstanceType`, specify the IoOptimized and InstanceType parameters.
11542
+ * - 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`.
11543
+ * - 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
11544
  * <details>
11541
- * <summary>
11542
- * Query for availability zones in the China (Hangzhou) region that have the `ecs.g5.large` instance type.
11543
- * </summary>
11545
+ * <summary>Query the zones in the China (Hangzhou) region where the ecs.g5.large instance type is available.</summary>
11544
11546
  * ```
11545
11547
  * "RegionId": "cn-hangzhou",
11546
- * "DestinationResource": "Zone",
11548
+ * "DestinationResource": "Zone"
11547
11549
  * "InstanceType": "ecs.g5.large"
11548
11550
  * ```
11549
11551
  * </details>
11550
11552
  * <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>
11553
+ * <summary>Query the inventory of the ecs.g5.large instance type across all zones in the China (Hangzhou) region.</summary>
11554
11554
  * ```
11555
11555
  * "RegionId": "cn-hangzhou",
11556
- * "DestinationResource": "InstanceType",
11556
+ * "DestinationResource": "InstanceType"
11557
11557
  * "InstanceType": "ecs.g5.large"
11558
11558
  * ```
11559
11559
  * </details>
11560
11560
  * <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>
11561
+ * <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
11562
  * ```
11565
11563
  * "RegionId": "cn-hangzhou",
11566
11564
  * "ZoneId": "cn-hangzhou-b",
@@ -11569,9 +11567,7 @@ export default class Client extends OpenApi {
11569
11567
  * ```
11570
11568
  * </details>
11571
11569
  * <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>
11570
+ * <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
11571
  * ```
11576
11572
  * "RegionId": "cn-hangzhou",
11577
11573
  * "ZoneId": "cn-hangzhou-b",
@@ -11687,43 +11683,37 @@ export default class Client extends OpenApi {
11687
11683
  }
11688
11684
 
11689
11685
  /**
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`.
11686
+ * 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
11687
  *
11692
11688
  * @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`
11689
+ * 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.
11690
+ * - Value order: `Zone > IoOptimized > InstanceType = Network = ddh > SystemDisk > DataDisk`
11695
11691
  * - 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`.
11692
+ * - If DestinationResource is set to `DataDisk`:
11693
+ * - 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.
11694
+ * - 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`.
11695
+ * - 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.
11696
+ * - If DestinationResource is set to `InstanceType`, specify the IoOptimized and InstanceType parameters.
11697
+ * - 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`.
11698
+ * - 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
11699
  * <details>
11704
- * <summary>
11705
- * Query for availability zones in the China (Hangzhou) region that have the `ecs.g5.large` instance type.
11706
- * </summary>
11700
+ * <summary>Query the zones in the China (Hangzhou) region where the ecs.g5.large instance type is available.</summary>
11707
11701
  * ```
11708
11702
  * "RegionId": "cn-hangzhou",
11709
- * "DestinationResource": "Zone",
11703
+ * "DestinationResource": "Zone"
11710
11704
  * "InstanceType": "ecs.g5.large"
11711
11705
  * ```
11712
11706
  * </details>
11713
11707
  * <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>
11708
+ * <summary>Query the inventory of the ecs.g5.large instance type across all zones in the China (Hangzhou) region.</summary>
11717
11709
  * ```
11718
11710
  * "RegionId": "cn-hangzhou",
11719
- * "DestinationResource": "InstanceType",
11711
+ * "DestinationResource": "InstanceType"
11720
11712
  * "InstanceType": "ecs.g5.large"
11721
11713
  * ```
11722
11714
  * </details>
11723
11715
  * <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>
11716
+ * <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
11717
  * ```
11728
11718
  * "RegionId": "cn-hangzhou",
11729
11719
  * "ZoneId": "cn-hangzhou-b",
@@ -11732,9 +11722,7 @@ export default class Client extends OpenApi {
11732
11722
  * ```
11733
11723
  * </details>
11734
11724
  * <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>
11725
+ * <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
11726
  * ```
11739
11727
  * "RegionId": "cn-hangzhou",
11740
11728
  * "ZoneId": "cn-hangzhou-b",
@@ -13459,14 +13447,14 @@ export default class Client extends OpenApi {
13459
13447
  }
13460
13448
 
13461
13449
  /**
13462
- * Queries information about one or more created block storage devices, including disks, local disks, and elastic ephemeral disks.
13450
+ * Queries information about one or more created block storage devices, including cloud disks, local disks, and elastic ephemeral disks.
13463
13451
  *
13464
13452
  * @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).
13453
+ * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. These parameters have a logical AND relationship.
13454
+ * - 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.
13455
+ * - 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.
13456
+ * - 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.
13457
+ * 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
13458
  *
13471
13459
  * @param request - DescribeDisksRequest
13472
13460
  * @param runtime - runtime options for this request RuntimeOptions
@@ -13629,14 +13617,14 @@ export default class Client extends OpenApi {
13629
13617
  }
13630
13618
 
13631
13619
  /**
13632
- * Queries information about one or more created block storage devices, including disks, local disks, and elastic ephemeral disks.
13620
+ * Queries information about one or more created block storage devices, including cloud disks, local disks, and elastic ephemeral disks.
13633
13621
  *
13634
13622
  * @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).
13623
+ * - The request parameters RegionId, ZoneId, DiskIds, and InstanceId are filters. These parameters have a logical AND relationship.
13624
+ * - 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.
13625
+ * - 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.
13626
+ * - 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.
13627
+ * 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
13628
  *
13641
13629
  * @param request - DescribeDisksRequest
13642
13630
  * @returns DescribeDisksResponse
@@ -14508,7 +14496,7 @@ export default class Client extends OpenApi {
14508
14496
  * Queries the details of one or more image components.
14509
14497
  *
14510
14498
  * @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.
14499
+ * 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
14500
  *
14513
14501
  * @param request - DescribeImageComponentsRequest
14514
14502
  * @param runtime - runtime options for this request RuntimeOptions
@@ -14606,7 +14594,7 @@ export default class Client extends OpenApi {
14606
14594
  * Queries the details of one or more image components.
14607
14595
  *
14608
14596
  * @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.
14597
+ * 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
14598
  *
14611
14599
  * @param request - DescribeImageComponentsRequest
14612
14600
  * @returns DescribeImageComponentsResponse
@@ -15255,7 +15243,7 @@ export default class Client extends OpenApi {
15255
15243
  }
15256
15244
 
15257
15245
  /**
15258
- * This API is used to query the attribute information of a specified ECS instance.
15246
+ * Queries the attribute information of a specified ECS instance.
15259
15247
  *
15260
15248
  * @param request - DescribeInstanceAttributeRequest
15261
15249
  * @param runtime - runtime options for this request RuntimeOptions
@@ -15302,7 +15290,7 @@ export default class Client extends OpenApi {
15302
15290
  }
15303
15291
 
15304
15292
  /**
15305
- * This API is used to query the attribute information of a specified ECS instance.
15293
+ * Queries the attribute information of a specified ECS instance.
15306
15294
  *
15307
15295
  * @param request - DescribeInstanceAttributeRequest
15308
15296
  * @returns DescribeInstanceAttributeResponse
@@ -15395,12 +15383,12 @@ export default class Client extends OpenApi {
15395
15383
  }
15396
15384
 
15397
15385
  /**
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.
15386
+ * 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
15387
  *
15400
15388
  * @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.
15389
+ * - You can query completed historical system events from the last 30 days. There is no time limit for querying uncompleted system events.
15390
+ * - If neither EventCycleStatus nor InstanceEventCycleStatus is specified, the query results include only system events in the Avoided, Executed, Canceled, and Failed states by default.
15391
+ * - By specifying the InstanceEventCycleStatus parameter, you can also query system events in the Scheduled, Executing, and Inquiring states.
15404
15392
  *
15405
15393
  * @param request - DescribeInstanceHistoryEventsRequest
15406
15394
  * @param runtime - runtime options for this request RuntimeOptions
@@ -15519,12 +15507,12 @@ export default class Client extends OpenApi {
15519
15507
  }
15520
15508
 
15521
15509
  /**
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.
15510
+ * 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
15511
  *
15524
15512
  * @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.
15513
+ * - You can query completed historical system events from the last 30 days. There is no time limit for querying uncompleted system events.
15514
+ * - If neither EventCycleStatus nor InstanceEventCycleStatus is specified, the query results include only system events in the Avoided, Executed, Canceled, and Failed states by default.
15515
+ * - By specifying the InstanceEventCycleStatus parameter, you can also query system events in the Scheduled, Executing, and Inquiring states.
15528
15516
  *
15529
15517
  * @param request - DescribeInstanceHistoryEventsRequest
15530
15518
  * @returns DescribeInstanceHistoryEventsResponse
@@ -16469,14 +16457,14 @@ export default class Client extends OpenApi {
16469
16457
  }
16470
16458
 
16471
16459
  /**
16472
- * This operation queries a list of instances based on specified conditions and returns detailed information about the instances.
16460
+ * Queries a list of instances based on specified request conditions and returns the associated detailed information of the instances.
16473
16461
  *
16474
16462
  * @remarks
16463
+ * ### Before you begin
16464
+ * - 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
16465
  * ### 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.
16466
+ * - Send a dry run request by using the DryRun request parameter to check the validity of parameters and authorization.
16467
+ * - 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
16468
  *
16481
16469
  * @param request - DescribeInstancesRequest
16482
16470
  * @param runtime - runtime options for this request RuntimeOptions
@@ -16671,14 +16659,14 @@ export default class Client extends OpenApi {
16671
16659
  }
16672
16660
 
16673
16661
  /**
16674
- * This operation queries a list of instances based on specified conditions and returns detailed information about the instances.
16662
+ * Queries a list of instances based on specified request conditions and returns the associated detailed information of the instances.
16675
16663
  *
16676
16664
  * @remarks
16665
+ * ### Before you begin
16666
+ * - 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
16667
  * ### 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.
16668
+ * - Send a dry run request by using the DryRun request parameter to check the validity of parameters and authorization.
16669
+ * - 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
16670
  *
16683
16671
  * @param request - DescribeInstancesRequest
16684
16672
  * @returns DescribeInstancesResponse
@@ -16801,22 +16789,22 @@ export default class Client extends OpenApi {
16801
16789
  }
16802
16790
 
16803
16791
  /**
16804
- * $.parameters[11].schema.items.properties.Value.example
16792
+ * Queries the execution results of one or more Cloud Assistant commands, which are the actual execution results on ECS instances.
16805
16793
  *
16806
16794
  * @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.
16795
+ * ## Operation description
16796
+ * - 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.
16797
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
16798
+ * - 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.
16799
+ * - 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
16800
  * - 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`.
16801
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
16802
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
16803
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status across instances.
16804
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
16805
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
16806
+ * - 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.
16807
+ * - When you want to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
16820
16808
  *
16821
16809
  * @param request - DescribeInvocationResultsRequest
16822
16810
  * @param runtime - runtime options for this request RuntimeOptions
@@ -16915,22 +16903,22 @@ export default class Client extends OpenApi {
16915
16903
  }
16916
16904
 
16917
16905
  /**
16918
- * $.parameters[11].schema.items.properties.Value.example
16906
+ * Queries the execution results of one or more Cloud Assistant commands, which are the actual execution results on ECS instances.
16919
16907
  *
16920
16908
  * @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.
16909
+ * ## Operation description
16910
+ * - 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.
16911
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
16912
+ * - 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.
16913
+ * - 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
16914
  * - 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`.
16915
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
16916
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
16917
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status across instances.
16918
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
16919
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
16920
+ * - 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.
16921
+ * - When you want to view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
16934
16922
  *
16935
16923
  * @param request - DescribeInvocationResultsRequest
16936
16924
  * @returns DescribeInvocationResultsResponse
@@ -16941,21 +16929,21 @@ export default class Client extends OpenApi {
16941
16929
  }
16942
16930
 
16943
16931
  /**
16944
- * Invoke the DescribeInvocations API to query the execution list and status of Cloud Assistant commands.
16932
+ * Queries the execution list and status of Cloud Assistant commands.
16945
16933
  *
16946
16934
  * @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.
16935
+ * - 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.
16936
+ * - You can query execution information from the last 30 days. A maximum of 10,000 execution records are retained.
16937
+ * - 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.
16938
+ * - 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
16939
  * - 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`.
16940
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
16941
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
16942
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status.
16943
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
16944
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
16945
+ * - 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.
16946
+ * - To view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
16959
16947
  *
16960
16948
  * @param request - DescribeInvocationsRequest
16961
16949
  * @param runtime - runtime options for this request RuntimeOptions
@@ -17070,21 +17058,21 @@ export default class Client extends OpenApi {
17070
17058
  }
17071
17059
 
17072
17060
  /**
17073
- * Invoke the DescribeInvocations API to query the execution list and status of Cloud Assistant commands.
17061
+ * Queries the execution list and status of Cloud Assistant commands.
17074
17062
  *
17075
17063
  * @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.
17064
+ * - 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.
17065
+ * - You can query execution information from the last 30 days. A maximum of 10,000 execution records are retained.
17066
+ * - 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.
17067
+ * - 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
17068
  * - 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`.
17069
+ * - When a single `RunCommand`/`InvokeCommand` call specifies multiple instances:
17070
+ * - `DescribeInvocations` returns the execution status on each instance and the aggregated status across all instances.
17071
+ * - `DescribeInvocationResults` returns only the individual execution status on each instance, without the aggregated status.
17072
+ * - When a single `RunCommand`/`InvokeCommand` call specifies one instance:
17073
+ * - `DescribeInvocations` and `DescribeInvocationResults` are largely interchangeable.
17074
+ * - 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.
17075
+ * - To view the command content and parameters, only `DescribeInvocations` returns `CommandContent`.
17088
17076
  *
17089
17077
  * @param request - DescribeInvocationsRequest
17090
17078
  * @returns DescribeInvocationsResponse
@@ -17177,7 +17165,7 @@ export default class Client extends OpenApi {
17177
17165
  }
17178
17166
 
17179
17167
  /**
17180
- * Query information about ECS instance launch template versions, such as the total number of launch templates, template name, and template version number.
17168
+ * Queries information about launch template versions of ECS instances, such as the total number of launch templates, template names, and template version numbers.
17181
17169
  *
17182
17170
  * @param request - DescribeLaunchTemplateVersionsRequest
17183
17171
  * @param runtime - runtime options for this request RuntimeOptions
@@ -17260,7 +17248,7 @@ export default class Client extends OpenApi {
17260
17248
  }
17261
17249
 
17262
17250
  /**
17263
- * Query information about ECS instance launch template versions, such as the total number of launch templates, template name, and template version number.
17251
+ * Queries information about launch template versions of ECS instances, such as the total number of launch templates, template names, and template version numbers.
17264
17252
  *
17265
17253
  * @param request - DescribeLaunchTemplateVersionsRequest
17266
17254
  * @returns DescribeLaunchTemplateVersionsResponse
@@ -18705,17 +18693,18 @@ export default class Client extends OpenApi {
18705
18693
  }
18706
18694
 
18707
18695
  /**
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.
18696
+ * 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
18697
  *
18710
18698
  * @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.
18699
+ * The parameter settings vary based on the resource type:
18700
+ * - When `ResourceType=instance`, you must also specify `InstanceType`.
18701
+ * 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.
18702
+ * - 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`.
18703
+ * - When `ResourceType=diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
18704
+ * - When `ResourceType=ddh`, you must also specify `DedicatedHostType`.
18705
+ * - When `ResourceType=ElasticityAssurance`, you must also specify `InstanceType`.
18706
+ * - When `ResourceType=CapacityReservation`, you must also specify `InstanceType`.
18707
+ * - When `ResourceType=bandwidth`, only the pay-by-traffic (`PayByTraffic`) price is returned.
18719
18708
  *
18720
18709
  * @param request - DescribePriceRequest
18721
18710
  * @param runtime - runtime options for this request RuntimeOptions
@@ -18874,17 +18863,18 @@ export default class Client extends OpenApi {
18874
18863
  }
18875
18864
 
18876
18865
  /**
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.
18866
+ * 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
18867
  *
18879
18868
  * @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.
18869
+ * The parameter settings vary based on the resource type:
18870
+ * - When `ResourceType=instance`, you must also specify `InstanceType`.
18871
+ * 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.
18872
+ * - 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`.
18873
+ * - When `ResourceType=diskperformance`, you must also specify `DataDisk.1.Category` and `DataDisk.1.ProvisionedIops`.
18874
+ * - When `ResourceType=ddh`, you must also specify `DedicatedHostType`.
18875
+ * - When `ResourceType=ElasticityAssurance`, you must also specify `InstanceType`.
18876
+ * - When `ResourceType=CapacityReservation`, you must also specify `InstanceType`.
18877
+ * - When `ResourceType=bandwidth`, only the pay-by-traffic (`PayByTraffic`) price is returned.
18888
18878
  *
18889
18879
  * @param request - DescribePriceRequest
18890
18880
  * @returns DescribePriceResponse
@@ -18895,7 +18885,7 @@ export default class Client extends OpenApi {
18895
18885
  }
18896
18886
 
18897
18887
  /**
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.
18888
+ * (Beta)调用 DescribeRecommendInstanceType 根据一个指定的实例规格,查找一个或多个备选的实例规格。针对已经或者即将停售的实例规格,DescribeRecommendInstanceType会罗列出作为替补的所有实例规格。
18899
18889
  *
18900
18890
  * @param request - DescribeRecommendInstanceTypeRequest
18901
18891
  * @param runtime - runtime options for this request RuntimeOptions
@@ -19002,7 +18992,7 @@ export default class Client extends OpenApi {
19002
18992
  }
19003
18993
 
19004
18994
  /**
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.
18995
+ * (Beta)调用 DescribeRecommendInstanceType 根据一个指定的实例规格,查找一个或多个备选的实例规格。针对已经或者即将停售的实例规格,DescribeRecommendInstanceType会罗列出作为替补的所有实例规格。
19006
18996
  *
19007
18997
  * @param request - DescribeRecommendInstanceTypeRequest
19008
18998
  * @returns DescribeRecommendInstanceTypeResponse
@@ -19468,42 +19458,42 @@ export default class Client extends OpenApi {
19468
19458
  }
19469
19459
 
19470
19460
  /**
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.
19461
+ * 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
19462
  *
19473
19463
  * @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.
19464
+ * The following examples describe common change scenarios:
19465
+ * ### Example 1: Query instance types to which the current instance can be changed
19466
+ * 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
19467
  * ```
19478
19468
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
19479
- * &RegionId=cn-hangzhou
19469
+ * &RegionId=ap-southeast-1
19480
19470
  * &ResourceId=i-bp67acfmxazb4p****
19481
19471
  * &DestinationResource=InstanceType
19482
19472
  * &OperationType=Upgrade
19483
- * &<Common request parameters>
19473
+ * &Common request parameters
19484
19474
  * ```
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.
19475
+ * ### Example 2: Query instance types available after changing the disk type of the current instance
19476
+ * 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
19477
  * ```
19488
19478
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
19489
- * &RegionId=cn-hangzhou
19479
+ * &RegionId=ap-southeast-1
19490
19480
  * &ResourceId=i-bp67acfmxazb4p****
19491
19481
  * &DestinationResource=InstanceType
19492
19482
  * &OperationType=Upgrade
19493
19483
  * &Conditions.0=DiskCategory
19494
- * &<Common request parameters>
19484
+ * &Common request parameters
19495
19485
  * ```
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.
19486
+ * ### Example 3: Query the disk type required by the target instance type
19487
+ * 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.
19488
+ * > The target instance type must be obtained by using Example 2.
19499
19489
  * ```
19500
19490
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
19501
- * &RegionId=cn-hangzhou
19491
+ * &RegionId=ap-southeast-1
19502
19492
  * &ResourceId=i-bp67acfmxazb4p****
19503
19493
  * &DestinationResource=SystemDisk
19504
19494
  * &OperationType=Upgrade
19505
19495
  * &InstanceType=ecs.g7.large
19506
- * &<Common request parameters>
19496
+ * &Common request parameters
19507
19497
  * ```
19508
19498
  *
19509
19499
  * @param request - DescribeResourcesModificationRequest
@@ -19587,42 +19577,42 @@ export default class Client extends OpenApi {
19587
19577
  }
19588
19578
 
19589
19579
  /**
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.
19580
+ * 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
19581
  *
19592
19582
  * @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.
19583
+ * The following examples describe common change scenarios:
19584
+ * ### Example 1: Query instance types to which the current instance can be changed
19585
+ * 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
19586
  * ```
19597
19587
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
19598
- * &RegionId=cn-hangzhou
19588
+ * &RegionId=ap-southeast-1
19599
19589
  * &ResourceId=i-bp67acfmxazb4p****
19600
19590
  * &DestinationResource=InstanceType
19601
19591
  * &OperationType=Upgrade
19602
- * &<Common request parameters>
19592
+ * &Common request parameters
19603
19593
  * ```
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.
19594
+ * ### Example 2: Query instance types available after changing the disk type of the current instance
19595
+ * 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
19596
  * ```
19607
19597
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
19608
- * &RegionId=cn-hangzhou
19598
+ * &RegionId=ap-southeast-1
19609
19599
  * &ResourceId=i-bp67acfmxazb4p****
19610
19600
  * &DestinationResource=InstanceType
19611
19601
  * &OperationType=Upgrade
19612
19602
  * &Conditions.0=DiskCategory
19613
- * &<Common request parameters>
19603
+ * &Common request parameters
19614
19604
  * ```
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.
19605
+ * ### Example 3: Query the disk type required by the target instance type
19606
+ * 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.
19607
+ * > The target instance type must be obtained by using Example 2.
19618
19608
  * ```
19619
19609
  * http(s)://ecs.aliyuncs.com/?Action=DescribeResourcesModification
19620
- * &RegionId=cn-hangzhou
19610
+ * &RegionId=ap-southeast-1
19621
19611
  * &ResourceId=i-bp67acfmxazb4p****
19622
19612
  * &DestinationResource=SystemDisk
19623
19613
  * &OperationType=Upgrade
19624
19614
  * &InstanceType=ecs.g7.large
19625
- * &<Common request parameters>
19615
+ * &Common request parameters
19626
19616
  * ```
19627
19617
  *
19628
19618
  * @param request - DescribeResourcesModificationRequest
@@ -19940,7 +19930,7 @@ export default class Client extends OpenApi {
19940
19930
  }
19941
19931
 
19942
19932
  /**
19943
- * Queries the details of a specified security group and the security group rules of the security group.
19933
+ * Queries the details of a specified security group, including the list of security group rules.
19944
19934
  *
19945
19935
  * @param request - DescribeSecurityGroupAttributeRequest
19946
19936
  * @param runtime - runtime options for this request RuntimeOptions
@@ -20011,7 +20001,7 @@ export default class Client extends OpenApi {
20011
20001
  }
20012
20002
 
20013
20003
  /**
20014
- * Queries the details of a specified security group and the security group rules of the security group.
20004
+ * Queries the details of a specified security group, including the list of security group rules.
20015
20005
  *
20016
20006
  * @param request - DescribeSecurityGroupAttributeRequest
20017
20007
  * @returns DescribeSecurityGroupAttributeResponse
@@ -20090,14 +20080,14 @@ export default class Client extends OpenApi {
20090
20080
  }
20091
20081
 
20092
20082
  /**
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.
20083
+ * 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
20084
  *
20095
20085
  * @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).
20086
+ * - **Paging query**: Use `MaxResults` and `NextToken` for paging query.
20087
+ * - If `NextToken` is not returned, the current page is the last page.
20088
+ * - 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.
20089
+ * - 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.
20090
+ * - 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
20091
  *
20102
20092
  * @param request - DescribeSecurityGroupsRequest
20103
20093
  * @param runtime - runtime options for this request RuntimeOptions
@@ -20208,14 +20198,14 @@ export default class Client extends OpenApi {
20208
20198
  }
20209
20199
 
20210
20200
  /**
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.
20201
+ * 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
20202
  *
20213
20203
  * @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).
20204
+ * - **Paging query**: Use `MaxResults` and `NextToken` for paging query.
20205
+ * - If `NextToken` is not returned, the current page is the last page.
20206
+ * - 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.
20207
+ * - 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.
20208
+ * - 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
20209
  *
20220
20210
  * @param request - DescribeSecurityGroupsRequest
20221
20211
  * @returns DescribeSecurityGroupsResponse
@@ -20226,13 +20216,13 @@ export default class Client extends OpenApi {
20226
20216
  }
20227
20217
 
20228
20218
  /**
20229
- * Queries the files sent by Cloud Assistant and their status.
20219
+ * Queries the list and status of files sent by Cloud Assistant by calling DescribeSendFileResults.
20230
20220
  *
20231
20221
  * @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.
20222
+ * ## Operation description:
20223
+ * - 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.
20224
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
20225
+ * - 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
20226
  *
20237
20227
  * @param request - DescribeSendFileResultsRequest
20238
20228
  * @param runtime - runtime options for this request RuntimeOptions
@@ -20323,13 +20313,13 @@ export default class Client extends OpenApi {
20323
20313
  }
20324
20314
 
20325
20315
  /**
20326
- * Queries the files sent by Cloud Assistant and their status.
20316
+ * Queries the list and status of files sent by Cloud Assistant by calling DescribeSendFileResults.
20327
20317
  *
20328
20318
  * @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.
20319
+ * ## Operation description:
20320
+ * - 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.
20321
+ * - You can query execution information from the last 30 days. A maximum of 10,000 entries of execution information can be retained.
20322
+ * - 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
20323
  *
20334
20324
  * @param request - DescribeSendFileResultsRequest
20335
20325
  * @returns DescribeSendFileResultsResponse
@@ -20690,47 +20680,39 @@ export default class Client extends OpenApi {
20690
20680
  }
20691
20681
 
20692
20682
  /**
20693
- * Queries details about a cloud disk\\"s snapshots, including their status, the time remaining until completion, and the retention days for automatic snapshots.
20683
+ * Queries the snapshot list of a disk, including snapshot status, remaining time for a snapshot being created, and automatic snapshot retention days.
20694
20684
  *
20695
20685
  * @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).
20686
+ * 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.
20687
+ * 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
20688
  * Request examples:
20699
20689
  * <details>
20700
- * <summary>
20701
- * Query the snapshots of all cloud disks attached to an ECS instance in the China (Hangzhou) region
20702
- * </summary>
20690
+ * <summary>Query the snapshot list of all disks attached to an ECS instance in the China (Hangzhou) region</summary>
20703
20691
  * ```
20704
- * RegionId: cn-hangzhou, // The ID of the region.
20705
- * InstanceId: i-bp1fh7by6d9mw7zr**** // The ID of the instance to query.
20692
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20693
+ * InstanceId: i-bp1fh7by6d9mw7zr**** // Set the instance ID to query.
20706
20694
  * ```
20707
20695
  * </details>
20708
20696
  * <details>
20709
- * <summary>
20710
- * Query the snapshots of a cloud disk in the China (Hangzhou) region
20711
- * </summary>
20697
+ * <summary>Query the snapshot information of a specific disk in the China (Hangzhou) region</summary>
20712
20698
  * ```
20713
- * RegionId: cn-hangzhou, // The ID of the region.
20714
- * DiskId: d-bp10e7ej8z743dmu**** // The ID of the cloud disk to query.
20699
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20700
+ * DiskId: d-bp10e7ej8z743dmu**** // Set the disk ID to query.
20715
20701
  * ```
20716
20702
  * </details>
20717
20703
  * <details>
20718
- * <summary>
20719
- * Query two snapshots in the China (Hangzhou) region by snapshot ID
20720
- * </summary>
20704
+ * <summary>Query the information of two snapshots in the China (Hangzhou) region by snapshot ID</summary>
20721
20705
  * ```
20722
- * RegionId: cn-hangzhou, // The ID of the region.
20723
- * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // The snapshot IDs to query.
20706
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20707
+ * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // Set the array of snapshot IDs to query.
20724
20708
  * ```
20725
20709
  * </details>
20726
20710
  * <details>
20727
- * <summary>
20728
- * Query snapshots created after a specific time in the China (Hangzhou) region
20729
- * </summary>
20711
+ * <summary>Query the snapshot information created after a specific point in time in the China (Hangzhou) region</summary>
20730
20712
  * ```
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
20713
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20714
+ * Filter.1.Key: CreationStartTime, // Set the filter key for the creation start time.
20715
+ * Filter.1.Value: 2024-11-27T00:00Z.
20734
20716
  * ```
20735
20717
  * </details>
20736
20718
  *
@@ -20859,47 +20841,39 @@ export default class Client extends OpenApi {
20859
20841
  }
20860
20842
 
20861
20843
  /**
20862
- * Queries details about a cloud disk\\"s snapshots, including their status, the time remaining until completion, and the retention days for automatic snapshots.
20844
+ * Queries the snapshot list of a disk, including snapshot status, remaining time for a snapshot being created, and automatic snapshot retention days.
20863
20845
  *
20864
20846
  * @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).
20847
+ * 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.
20848
+ * 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
20849
  * Request examples:
20868
20850
  * <details>
20869
- * <summary>
20870
- * Query the snapshots of all cloud disks attached to an ECS instance in the China (Hangzhou) region
20871
- * </summary>
20851
+ * <summary>Query the snapshot list of all disks attached to an ECS instance in the China (Hangzhou) region</summary>
20872
20852
  * ```
20873
- * RegionId: cn-hangzhou, // The ID of the region.
20874
- * InstanceId: i-bp1fh7by6d9mw7zr**** // The ID of the instance to query.
20853
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20854
+ * InstanceId: i-bp1fh7by6d9mw7zr**** // Set the instance ID to query.
20875
20855
  * ```
20876
20856
  * </details>
20877
20857
  * <details>
20878
- * <summary>
20879
- * Query the snapshots of a cloud disk in the China (Hangzhou) region
20880
- * </summary>
20858
+ * <summary>Query the snapshot information of a specific disk in the China (Hangzhou) region</summary>
20881
20859
  * ```
20882
- * RegionId: cn-hangzhou, // The ID of the region.
20883
- * DiskId: d-bp10e7ej8z743dmu**** // The ID of the cloud disk to query.
20860
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20861
+ * DiskId: d-bp10e7ej8z743dmu**** // Set the disk ID to query.
20884
20862
  * ```
20885
20863
  * </details>
20886
20864
  * <details>
20887
- * <summary>
20888
- * Query two snapshots in the China (Hangzhou) region by snapshot ID
20889
- * </summary>
20865
+ * <summary>Query the information of two snapshots in the China (Hangzhou) region by snapshot ID</summary>
20890
20866
  * ```
20891
- * RegionId: cn-hangzhou, // The ID of the region.
20892
- * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // The snapshot IDs to query.
20867
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20868
+ * SnapshotIds: ["d-bp10e7ej8z743dmu****", "s-bp19vd1lorzgzt2s****"] // Set the array of snapshot IDs to query.
20893
20869
  * ```
20894
20870
  * </details>
20895
20871
  * <details>
20896
- * <summary>
20897
- * Query snapshots created after a specific time in the China (Hangzhou) region
20898
- * </summary>
20872
+ * <summary>Query the snapshot information created after a specific point in time in the China (Hangzhou) region</summary>
20899
20873
  * ```
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
20874
+ * RegionId: cn-hangzhou, // Set the region to China (Hangzhou).
20875
+ * Filter.1.Key: CreationStartTime, // Set the filter key for the creation start time.
20876
+ * Filter.1.Value: 2024-11-27T00:00Z.
20903
20877
  * ```
20904
20878
  * </details>
20905
20879
  *
@@ -21092,11 +21066,11 @@ export default class Client extends OpenApi {
21092
21066
  }
21093
21067
 
21094
21068
  /**
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.
21069
+ * 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
21070
  *
21097
21071
  * @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.
21072
+ * - Only I/O optimized spot instances are supported.
21073
+ * - 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
21074
  *
21101
21075
  * @param request - DescribeSpotPriceHistoryRequest
21102
21076
  * @param runtime - runtime options for this request RuntimeOptions
@@ -21183,11 +21157,11 @@ export default class Client extends OpenApi {
21183
21157
  }
21184
21158
 
21185
21159
  /**
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.
21160
+ * 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
21161
  *
21188
21162
  * @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.
21163
+ * - Only I/O optimized spot instances are supported.
21164
+ * - 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
21165
  *
21192
21166
  * @param request - DescribeSpotPriceHistoryRequest
21193
21167
  * @returns DescribeSpotPriceHistoryResponse
@@ -21697,10 +21671,10 @@ export default class Client extends OpenApi {
21697
21671
  }
21698
21672
 
21699
21673
  /**
21700
- * Queries the session records of Elastic Compute Service (ECS) Session Manager.
21674
+ * Queries the session history of Session Manager.
21701
21675
  *
21702
21676
  * @remarks
21703
- * You can query the session records of Session Manager that were generated in the last four weeks.
21677
+ * You can query Session Manager session records created within the last 30 days. A maximum of 1,000 successful records are retained.
21704
21678
  *
21705
21679
  * @param request - DescribeTerminalSessionsRequest
21706
21680
  * @param runtime - runtime options for this request RuntimeOptions
@@ -21763,10 +21737,10 @@ export default class Client extends OpenApi {
21763
21737
  }
21764
21738
 
21765
21739
  /**
21766
- * Queries the session records of Elastic Compute Service (ECS) Session Manager.
21740
+ * Queries the session history of Session Manager.
21767
21741
  *
21768
21742
  * @remarks
21769
- * You can query the session records of Session Manager that were generated in the last four weeks.
21743
+ * You can query Session Manager session records created within the last 30 days. A maximum of 1,000 successful records are retained.
21770
21744
  *
21771
21745
  * @param request - DescribeTerminalSessionsRequest
21772
21746
  * @returns DescribeTerminalSessionsResponse
@@ -22387,11 +22361,10 @@ export default class Client extends OpenApi {
22387
22361
  }
22388
22362
 
22389
22363
  /**
22390
- * Queries Alibaba Cloud regions. You can specify parameters, such as InstanceChargeType and ResourceType, in the request.
22364
+ * Queries the list of active zones based on parameters such as region ID and billing method.
22391
22365
  *
22392
22366
  * @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.
22367
+ * 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
22368
  *
22396
22369
  * @param request - DescribeZonesRequest
22397
22370
  * @param runtime - runtime options for this request RuntimeOptions
@@ -22454,11 +22427,10 @@ export default class Client extends OpenApi {
22454
22427
  }
22455
22428
 
22456
22429
  /**
22457
- * Queries Alibaba Cloud regions. You can specify parameters, such as InstanceChargeType and ResourceType, in the request.
22430
+ * Queries the list of active zones based on parameters such as region ID and billing method.
22458
22431
  *
22459
22432
  * @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.
22433
+ * 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
22434
  *
22463
22435
  * @param request - DescribeZonesRequest
22464
22436
  * @returns DescribeZonesResponse
@@ -23583,7 +23555,7 @@ export default class Client extends OpenApi {
23583
23555
  }
23584
23556
 
23585
23557
  /**
23586
- * Retrieves the system command line output of an instance. The data is returned in Base64 encoding.
23558
+ * Retrieves the system command-line output of an instance. The data is returned in Base64-encoded format.
23587
23559
  *
23588
23560
  * @remarks
23589
23561
  * - 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 +23619,7 @@ export default class Client extends OpenApi {
23647
23619
  }
23648
23620
 
23649
23621
  /**
23650
- * Retrieves the system command line output of an instance. The data is returned in Base64 encoding.
23622
+ * Retrieves the system command-line output of an instance. The data is returned in Base64-encoded format.
23651
23623
  *
23652
23624
  * @remarks
23653
23625
  * - 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 +23635,13 @@ export default class Client extends OpenApi {
23663
23635
  }
23664
23636
 
23665
23637
  /**
23666
- * Calls GetInstanceScreenshot to obtain the screenshot information of an instance.
23638
+ * Calls GetInstanceScreenshot to retrieve the screenshot information of an instance.
23667
23639
  *
23668
23640
  * @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:
23641
+ * 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
23642
  * - 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.
23643
+ * - Screenshots cannot be retrieved for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
23644
+ * - 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
23645
  *
23674
23646
  * @param request - GetInstanceScreenshotRequest
23675
23647
  * @param runtime - runtime options for this request RuntimeOptions
@@ -23728,13 +23700,13 @@ export default class Client extends OpenApi {
23728
23700
  }
23729
23701
 
23730
23702
  /**
23731
- * Calls GetInstanceScreenshot to obtain the screenshot information of an instance.
23703
+ * Calls GetInstanceScreenshot to retrieve the screenshot information of an instance.
23732
23704
  *
23733
23705
  * @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:
23706
+ * 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
23707
  * - 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.
23708
+ * - Screenshots cannot be retrieved for [retired instance types](https://help.aliyun.com/document_detail/55263.html).
23709
+ * - 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
23710
  *
23739
23711
  * @param request - GetInstanceScreenshotRequest
23740
23712
  * @returns GetInstanceScreenshotResponse
@@ -26957,7 +26929,7 @@ export default class Client extends OpenApi {
26957
26929
  }
26958
26930
 
26959
26931
  /**
26960
- * Modifies the description of an HPC cluster by calling ModifyHpcClusterAttribute.
26932
+ * Modifies the description of an HPC cluster.
26961
26933
  *
26962
26934
  * @param request - ModifyHpcClusterAttributeRequest
26963
26935
  * @param runtime - runtime options for this request RuntimeOptions
@@ -27024,7 +26996,7 @@ export default class Client extends OpenApi {
27024
26996
  }
27025
26997
 
27026
26998
  /**
27027
- * Modifies the description of an HPC cluster by calling ModifyHpcClusterAttribute.
26999
+ * Modifies the description of an HPC cluster.
27028
27000
  *
27029
27001
  * @param request - ModifyHpcClusterAttributeRequest
27030
27002
  * @returns ModifyHpcClusterAttributeResponse
@@ -27400,10 +27372,10 @@ export default class Client extends OpenApi {
27400
27372
  }
27401
27373
 
27402
27374
  /**
27403
- * This API modifies attributes of an ECS instance, such as the password, instance name, hostname, security group, MTU, and user data.
27375
+ * Modifies some properties of an ECS instance, including the password, instance name, hostname, security group membership, MTU, and instance user data.
27404
27376
  *
27405
27377
  * @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).
27378
+ * 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
27379
  *
27408
27380
  * @param request - ModifyInstanceAttributeRequest
27409
27381
  * @param runtime - runtime options for this request RuntimeOptions
@@ -27510,10 +27482,10 @@ export default class Client extends OpenApi {
27510
27482
  }
27511
27483
 
27512
27484
  /**
27513
- * This API modifies attributes of an ECS instance, such as the password, instance name, hostname, security group, MTU, and user data.
27485
+ * Modifies some properties of an ECS instance, including the password, instance name, hostname, security group membership, MTU, and instance user data.
27514
27486
  *
27515
27487
  * @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).
27488
+ * 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
27489
  *
27518
27490
  * @param request - ModifyInstanceAttributeRequest
27519
27491
  * @returns ModifyInstanceAttributeResponse
@@ -28241,15 +28213,14 @@ export default class Client extends OpenApi {
28241
28213
  * 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
28214
  *
28243
28215
  * @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~~).
28216
+ * - 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.
28217
+ * - 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.
28218
+ * > 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
28219
  *
28249
28220
  * - Fees:
28250
28221
  *
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.
28222
+ * - 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.
28223
+ * - After the bandwidth is downgraded, the price difference is refunded to the original payment method. Vouchers that have been used are not refundable.
28253
28224
  *
28254
28225
  * @param request - ModifyInstanceNetworkSpecRequest
28255
28226
  * @param runtime - runtime options for this request RuntimeOptions
@@ -28335,15 +28306,14 @@ export default class Client extends OpenApi {
28335
28306
  * 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
28307
  *
28337
28308
  * @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~~).
28309
+ * - 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.
28310
+ * - 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.
28311
+ * > 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
28312
  *
28343
28313
  * - Fees:
28344
28314
  *
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.
28315
+ * - 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.
28316
+ * - After the bandwidth is downgraded, the price difference is refunded to the original payment method. Vouchers that have been used are not refundable.
28347
28317
  *
28348
28318
  * @param request - ModifyInstanceNetworkSpecRequest
28349
28319
  * @returns ModifyInstanceNetworkSpecResponse
@@ -28358,18 +28328,18 @@ export default class Client extends OpenApi {
28358
28328
  *
28359
28329
  * @remarks
28360
28330
  * <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.**.
28331
+ * **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
28332
  * .
28363
28333
  * <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.**.
28334
+ * **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
28335
  * .
28366
28336
  * 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
28337
  * **Before you begin**.
28368
28338
  * - 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.
28339
+ * - 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
28340
  * - 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~~).
28341
+ * - 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.
28342
+ * > 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
28343
  *
28374
28344
  * @param request - ModifyInstanceSpecRequest
28375
28345
  * @param runtime - runtime options for this request RuntimeOptions
@@ -28464,18 +28434,18 @@ export default class Client extends OpenApi {
28464
28434
  *
28465
28435
  * @remarks
28466
28436
  * <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.**.
28437
+ * **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
28438
  * .
28469
28439
  * <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.**.
28440
+ * **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
28441
  * .
28472
28442
  * 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
28443
  * **Before you begin**.
28474
28444
  * - 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.
28445
+ * - 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
28446
  * - 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~~).
28447
+ * - 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.
28448
+ * > 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
28449
  *
28480
28450
  * @param request - ModifyInstanceSpecRequest
28481
28451
  * @returns ModifyInstanceSpecResponse
@@ -29190,7 +29160,7 @@ export default class Client extends OpenApi {
29190
29160
  * Updates an O&M window.
29191
29161
  *
29192
29162
  * @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.
29163
+ * 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
29164
  *
29195
29165
  * @param tmpReq - ModifyPlanMaintenanceWindowRequest
29196
29166
  * @param runtime - runtime options for this request RuntimeOptions
@@ -29262,7 +29232,7 @@ export default class Client extends OpenApi {
29262
29232
  * Updates an O&M window.
29263
29233
  *
29264
29234
  * @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.
29235
+ * 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
29236
  *
29267
29237
  * @param request - ModifyPlanMaintenanceWindowRequest
29268
29238
  * @returns ModifyPlanMaintenanceWindowResponse
@@ -29459,20 +29429,24 @@ export default class Client extends OpenApi {
29459
29429
  }
29460
29430
 
29461
29431
  /**
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.
29432
+ * 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
29433
  *
29464
29434
  * @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).
29435
+ * <props="china">
29436
+ * **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.**
29437
+ * <props="intl">
29438
+ * **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.**
29439
+ * 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.
29440
+ * **Precautions**
29441
+ * - 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.
29442
+ * - Expired instances cannot be changed to a different instance type. Complete the renewal and try again.
29443
+ * - Downgrade the instance type:
29444
+ * - The instance must be in the **Stopped** (`Stopped`) state.
29445
+ * - 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.
29446
+ * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html) after the Upgrade/Downgrade.
29447
+ * - Upgrade the instance type:
29448
+ * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
29449
+ * - 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
29450
  *
29477
29451
  * @param request - ModifyPrepayInstanceSpecRequest
29478
29452
  * @param runtime - runtime options for this request RuntimeOptions
@@ -29567,20 +29541,24 @@ export default class Client extends OpenApi {
29567
29541
  }
29568
29542
 
29569
29543
  /**
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.
29544
+ * 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
29545
  *
29572
29546
  * @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).
29547
+ * <props="china">
29548
+ * **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.**
29549
+ * <props="intl">
29550
+ * **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.**
29551
+ * 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.
29552
+ * **Precautions**
29553
+ * - 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.
29554
+ * - Expired instances cannot be changed to a different instance type. Complete the renewal and try again.
29555
+ * - Downgrade the instance type:
29556
+ * - The instance must be in the **Stopped** (`Stopped`) state.
29557
+ * - 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.
29558
+ * - The new instance type takes effect only after you [start the instance](https://help.aliyun.com/document_detail/25441.html) after the Upgrade/Downgrade.
29559
+ * - Upgrade the instance type:
29560
+ * - The instance must be in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
29561
+ * - 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
29562
  *
29585
29563
  * @param request - ModifyPrepayInstanceSpecRequest
29586
29564
  * @returns ModifyPrepayInstanceSpecResponse
@@ -30159,12 +30137,12 @@ export default class Client extends OpenApi {
30159
30137
  }
30160
30138
 
30161
30139
  /**
30162
- * Modifies an egress security group rule.
30140
+ * Modifies an outbound security group rule.
30163
30141
  *
30164
30142
  * @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.
30143
+ * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
30144
+ * - 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.
30145
+ * - 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
30146
  *
30169
30147
  * @param request - ModifySecurityGroupEgressRuleRequest
30170
30148
  * @param runtime - runtime options for this request RuntimeOptions
@@ -30291,12 +30269,12 @@ export default class Client extends OpenApi {
30291
30269
  }
30292
30270
 
30293
30271
  /**
30294
- * Modifies an egress security group rule.
30272
+ * Modifies an outbound security group rule.
30295
30273
  *
30296
30274
  * @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.
30275
+ * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
30276
+ * - 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.
30277
+ * - 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
30278
  *
30301
30279
  * @param request - ModifySecurityGroupEgressRuleRequest
30302
30280
  * @returns ModifySecurityGroupEgressRuleResponse
@@ -30394,7 +30372,7 @@ export default class Client extends OpenApi {
30394
30372
  * @remarks
30395
30373
  * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
30396
30374
  * - 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.
30375
+ * - 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
30376
  *
30399
30377
  * @param request - ModifySecurityGroupRuleRequest
30400
30378
  * @param runtime - runtime options for this request RuntimeOptions
@@ -30526,7 +30504,7 @@ export default class Client extends OpenApi {
30526
30504
  * @remarks
30527
30505
  * When you modify a security group rule by specifying the security group rule ID, take note of the following limits:
30528
30506
  * - 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.
30507
+ * - 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
30508
  *
30531
30509
  * @param request - ModifySecurityGroupRuleRequest
30532
30510
  * @returns ModifySecurityGroupRuleResponse
@@ -30904,6 +30882,72 @@ export default class Client extends OpenApi {
30904
30882
  return await this.modifyStorageSetAttributeWithOptions(request, runtime);
30905
30883
  }
30906
30884
 
30885
+ /**
30886
+ * 修改计划内运维事件属性
30887
+ *
30888
+ * @remarks
30889
+ * ## 接口说明
30890
+ * - 只能修改状态为Scheduled的计划内运维事件。
30891
+ * - 传入的NotBefore不早于当前时间。
30892
+ * - 传入的NotBefore不晚于事件产生时初始的计划执行时间。
30893
+ *
30894
+ * @param request - ModifySystemEventAttributeRequest
30895
+ * @param runtime - runtime options for this request RuntimeOptions
30896
+ * @returns ModifySystemEventAttributeResponse
30897
+ */
30898
+ async modifySystemEventAttributeWithOptions(request: $_model.ModifySystemEventAttributeRequest, runtime: $dara.RuntimeOptions): Promise<$_model.ModifySystemEventAttributeResponse> {
30899
+ request.validate();
30900
+ let query = { };
30901
+ if (!$dara.isNull(request.eventId)) {
30902
+ query["EventId"] = request.eventId;
30903
+ }
30904
+
30905
+ if (!$dara.isNull(request.instanceId)) {
30906
+ query["InstanceId"] = request.instanceId;
30907
+ }
30908
+
30909
+ if (!$dara.isNull(request.notBefore)) {
30910
+ query["NotBefore"] = request.notBefore;
30911
+ }
30912
+
30913
+ if (!$dara.isNull(request.regionId)) {
30914
+ query["RegionId"] = request.regionId;
30915
+ }
30916
+
30917
+ let req = new $OpenApiUtil.OpenApiRequest({
30918
+ query: OpenApiUtil.query(query),
30919
+ });
30920
+ let params = new $OpenApiUtil.Params({
30921
+ action: "ModifySystemEventAttribute",
30922
+ version: "2014-05-26",
30923
+ protocol: "HTTPS",
30924
+ pathname: "/",
30925
+ method: "POST",
30926
+ authType: "AK",
30927
+ style: "RPC",
30928
+ reqBodyType: "formData",
30929
+ bodyType: "json",
30930
+ });
30931
+ return $dara.cast<$_model.ModifySystemEventAttributeResponse>(await this.callApi(params, req, runtime), new $_model.ModifySystemEventAttributeResponse({}));
30932
+ }
30933
+
30934
+ /**
30935
+ * 修改计划内运维事件属性
30936
+ *
30937
+ * @remarks
30938
+ * ## 接口说明
30939
+ * - 只能修改状态为Scheduled的计划内运维事件。
30940
+ * - 传入的NotBefore不早于当前时间。
30941
+ * - 传入的NotBefore不晚于事件产生时初始的计划执行时间。
30942
+ *
30943
+ * @param request - ModifySystemEventAttributeRequest
30944
+ * @returns ModifySystemEventAttributeResponse
30945
+ */
30946
+ async modifySystemEventAttribute(request: $_model.ModifySystemEventAttributeRequest): Promise<$_model.ModifySystemEventAttributeResponse> {
30947
+ let runtime = new $dara.RuntimeOptions({ });
30948
+ return await this.modifySystemEventAttributeWithOptions(request, runtime);
30949
+ }
30950
+
30907
30951
  /**
30908
30952
  * Modifies the default user-level attributes.
30909
30953
  *
@@ -32806,7 +32850,7 @@ export default class Client extends OpenApi {
32806
32850
  }
32807
32851
 
32808
32852
  /**
32809
- * Renews elasticity assurances that you purchased.
32853
+ * Renews one or more purchased elasticity assurance services.
32810
32854
  *
32811
32855
  * @param request - RenewElasticityAssurancesRequest
32812
32856
  * @param runtime - runtime options for this request RuntimeOptions
@@ -32881,7 +32925,7 @@ export default class Client extends OpenApi {
32881
32925
  }
32882
32926
 
32883
32927
  /**
32884
- * Renews elasticity assurances that you purchased.
32928
+ * Renews one or more purchased elasticity assurance services.
32885
32929
  *
32886
32930
  * @param request - RenewElasticityAssurancesRequest
32887
32931
  * @returns RenewElasticityAssurancesResponse
@@ -33616,61 +33660,57 @@ export default class Client extends OpenApi {
33616
33660
  }
33617
33661
 
33618
33662
  /**
33619
- * Deletes inbound security group rules from a specific security group.
33663
+ * Deletes one or more inbound security group rules from a specified security group.
33620
33664
  *
33621
33665
  * @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
- * <!---->
33666
+ * >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.
33667
+ * You can use one of the following methods to pass parameters to delete rules:
33668
+ * - Specify security group rule IDs to delete rules (recommended).
33669
+ * - If a specified security group rule ID does not exist, the API invocation fails.
33670
+ * - Specify Permissions to delete rules.
33671
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
33672
+ * - The following parameters are required to identify an inbound rule:
33673
+ * - Source settings: Set one of SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
33674
+ * - Destination port range: PortRange.
33675
+ * - Protocol type: IpProtocol.
33676
+ * - Access policy: Policy.
33677
+ * > You cannot specify both security group rule IDs and Permissions at the same time.
33678
+ * ### Request examples
33679
+ * - Delete by specifying security group rule IDs.
33637
33680
  * ```
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.
33681
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
33682
+ * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
33640
33683
  * ```
33641
- * - Delete a security group rule based on an IPv4 CIDR block:
33642
- * <!---->
33684
+ * - Delete by specifying an IP address range.
33643
33685
  * ```
33644
33686
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
33645
33687
  * "Permissions":[
33646
33688
  * {
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.
33689
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IP address range.
33690
+ * "IpProtocol":"TCP", // Specify the protocol type.
33691
+ * "PortRange":"80/80", // Specify the destination port range.
33692
+ * "Policy":"accept" // Specify the access policy.
33651
33693
  * }
33652
33694
  * ]
33653
33695
  * ```
33654
- * - Delete a security group rule in which a security group is referenced:
33655
- * <!---->
33696
+ * - Delete by specifying another security group.
33656
33697
  * ```
33657
33698
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
33658
33699
  * "Permissions":[
33659
33700
  * {
33660
- * "SourceGroupId":"sg-bp67acfmxa123b****", //Specify the ID of the source security group.
33701
+ * "SourceGroupId":"sg-bp67acfmxa123b****", // Specify the source security group ID.
33661
33702
  * "IpProtocol":"TCP,"
33662
33703
  * "PortRange":"80/80",
33663
33704
  * "Policy":"accept"
33664
33705
  * ]
33665
33706
  * }
33666
33707
  * ```
33667
- * - Delete a security group rule in which a prefix list is referenced:
33668
- * <!---->
33708
+ * - Delete by specifying a prefix list.
33669
33709
  * ```
33670
33710
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
33671
33711
  * "Permissions":[
33672
33712
  * {
33673
- * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", //Specify the ID of the source prefix list.
33713
+ * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list ID.
33674
33714
  * "IpProtocol":"TCP",
33675
33715
  * "PortRange":"80/80",
33676
33716
  * "Policy":"accept"
@@ -33811,61 +33851,57 @@ export default class Client extends OpenApi {
33811
33851
  }
33812
33852
 
33813
33853
  /**
33814
- * Deletes inbound security group rules from a specific security group.
33854
+ * Deletes one or more inbound security group rules from a specified security group.
33815
33855
  *
33816
33856
  * @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
- * <!---->
33857
+ * >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.
33858
+ * You can use one of the following methods to pass parameters to delete rules:
33859
+ * - Specify security group rule IDs to delete rules (recommended).
33860
+ * - If a specified security group rule ID does not exist, the API invocation fails.
33861
+ * - Specify Permissions to delete rules.
33862
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
33863
+ * - The following parameters are required to identify an inbound rule:
33864
+ * - Source settings: Set one of SourceCidrIp (IPv4 address), Ipv6SourceCidrIp (IPv6 address), SourcePrefixListId (prefix list ID), or SourceGroupId (source security group).
33865
+ * - Destination port range: PortRange.
33866
+ * - Protocol type: IpProtocol.
33867
+ * - Access policy: Policy.
33868
+ * > You cannot specify both security group rule IDs and Permissions at the same time.
33869
+ * ### Request examples
33870
+ * - Delete by specifying security group rule IDs.
33832
33871
  * ```
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.
33872
+ * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
33873
+ * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
33835
33874
  * ```
33836
- * - Delete a security group rule based on an IPv4 CIDR block:
33837
- * <!---->
33875
+ * - Delete by specifying an IP address range.
33838
33876
  * ```
33839
33877
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
33840
33878
  * "Permissions":[
33841
33879
  * {
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.
33880
+ * "SourceCidrIp":"10.0.0.0/8", // Specify the source IP address range.
33881
+ * "IpProtocol":"TCP", // Specify the protocol type.
33882
+ * "PortRange":"80/80", // Specify the destination port range.
33883
+ * "Policy":"accept" // Specify the access policy.
33846
33884
  * }
33847
33885
  * ]
33848
33886
  * ```
33849
- * - Delete a security group rule in which a security group is referenced:
33850
- * <!---->
33887
+ * - Delete by specifying another security group.
33851
33888
  * ```
33852
33889
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
33853
33890
  * "Permissions":[
33854
33891
  * {
33855
- * "SourceGroupId":"sg-bp67acfmxa123b****", //Specify the ID of the source security group.
33892
+ * "SourceGroupId":"sg-bp67acfmxa123b****", // Specify the source security group ID.
33856
33893
  * "IpProtocol":"TCP,"
33857
33894
  * "PortRange":"80/80",
33858
33895
  * "Policy":"accept"
33859
33896
  * ]
33860
33897
  * }
33861
33898
  * ```
33862
- * - Delete a security group rule in which a prefix list is referenced:
33863
- * <!---->
33899
+ * - Delete by specifying a prefix list.
33864
33900
  * ```
33865
33901
  * "SecurityGroupId":"sg-bp67acfmxazb4p****",
33866
33902
  * "Permissions":[
33867
33903
  * {
33868
- * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", //Specify the ID of the source prefix list.
33904
+ * "SourcePrefixListId":pl-x1j1k5ykzqlixdcy****", // Specify the source prefix list ID.
33869
33905
  * "IpProtocol":"TCP",
33870
33906
  * "PortRange":"80/80",
33871
33907
  * "Policy":"accept"
@@ -33885,14 +33921,14 @@ export default class Client extends OpenApi {
33885
33921
  * Deletes one or more outbound security group rules from a specified security group.
33886
33922
  *
33887
33923
  * @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.
33924
+ * >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
33925
  * You can use one of the following methods to pass parameters to delete security group rules:
33890
33926
  * - Delete rules by specifying security group rule IDs (recommended).
33891
- * - If the specified security group rule ID does not exist, an error is returned.
33927
+ * - If a specified security group rule ID does not exist, a fault is returned.
33892
33928
  * - 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.
33929
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
33894
33930
  * - 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).
33931
+ * - Destination: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
33896
33932
  * - Destination port range: PortRange.
33897
33933
  * - Protocol type: IpProtocol.
33898
33934
  * - Access policy: Policy.
@@ -33903,15 +33939,15 @@ export default class Client extends OpenApi {
33903
33939
  * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
33904
33940
  * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
33905
33941
  * ```
33906
- * - Delete by IP address CIDR block.
33942
+ * - Delete by IP CIDR block.
33907
33943
  * ```
33908
33944
  * "SecurityGroupId":"sg-bp67acfmxazb4ph***",
33909
33945
  * "Permissions":[
33910
33946
  * {
33911
33947
  * "IpProtocol":"TCP", // Specify the protocol type.
33912
- * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP address CIDR block.
33948
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP CIDR block.
33913
33949
  * "PortRange":"22/22", // Specify the destination port range.
33914
- * "Policy":"accept" // Specify the access policy.
33950
+ * "Policy":"accept" // Specify the authorization policy.
33915
33951
  * }
33916
33952
  * ]
33917
33953
  * ```
@@ -33939,7 +33975,7 @@ export default class Client extends OpenApi {
33939
33975
  * "Policy":"accept",
33940
33976
  * }
33941
33977
  * ]
33942
- * ```.
33978
+ * ```
33943
33979
  *
33944
33980
  * @param request - RevokeSecurityGroupEgressRequest
33945
33981
  * @param runtime - runtime options for this request RuntimeOptions
@@ -34081,14 +34117,14 @@ export default class Client extends OpenApi {
34081
34117
  * Deletes one or more outbound security group rules from a specified security group.
34082
34118
  *
34083
34119
  * @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.
34120
+ * >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
34121
  * You can use one of the following methods to pass parameters to delete security group rules:
34086
34122
  * - Delete rules by specifying security group rule IDs (recommended).
34087
- * - If the specified security group rule ID does not exist, an error is returned.
34123
+ * - If a specified security group rule ID does not exist, a fault is returned.
34088
34124
  * - 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.
34125
+ * - If no matching security group rule exists, the invocation succeeds but no rule is deleted.
34090
34126
  * - 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).
34127
+ * - Destination: Specify one of DestCidrIp (IPv4 address), Ipv6DestCidrIp (IPv6 address), DestPrefixListId (prefix list ID), or DestGroupId (destination security group).
34092
34128
  * - Destination port range: PortRange.
34093
34129
  * - Protocol type: IpProtocol.
34094
34130
  * - Access policy: Policy.
@@ -34099,15 +34135,15 @@ export default class Client extends OpenApi {
34099
34135
  * "SecurityGroupId":"sg-bp67acfmxazb4p****", // Specify the security group ID.
34100
34136
  * "SecurityGroupRuleId":["sgr-bpdfmk****","sgr-bpdfmg****"] // Specify the security group rule IDs.
34101
34137
  * ```
34102
- * - Delete by IP address CIDR block.
34138
+ * - Delete by IP CIDR block.
34103
34139
  * ```
34104
34140
  * "SecurityGroupId":"sg-bp67acfmxazb4ph***",
34105
34141
  * "Permissions":[
34106
34142
  * {
34107
34143
  * "IpProtocol":"TCP", // Specify the protocol type.
34108
- * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP address CIDR block.
34144
+ * "DestCidrIp":"10.0.0.0/8", // Specify the destination IP CIDR block.
34109
34145
  * "PortRange":"22/22", // Specify the destination port range.
34110
- * "Policy":"accept" // Specify the access policy.
34146
+ * "Policy":"accept" // Specify the authorization policy.
34111
34147
  * }
34112
34148
  * ]
34113
34149
  * ```
@@ -34135,7 +34171,7 @@ export default class Client extends OpenApi {
34135
34171
  * "Policy":"accept",
34136
34172
  * }
34137
34173
  * ]
34138
- * ```.
34174
+ * ```
34139
34175
  *
34140
34176
  * @param request - RevokeSecurityGroupEgressRequest
34141
34177
  * @returns RevokeSecurityGroupEgressResponse
@@ -35326,22 +35362,22 @@ export default class Client extends OpenApi {
35326
35362
  }
35327
35363
 
35328
35364
  /**
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.
35365
+ * 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
35366
  *
35331
35367
  * @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.
35368
+ * ## Operation description
35369
+ * 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:
35370
+ * - The specified ECS instance must be in the Running state.
35371
+ * - 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.
35372
+ * - If Cloud Assistant Agent is not installed on the ECS instance, invoke [InstallCloudAssistant](https://help.aliyun.com/document_detail/85916.html) to install it.
35373
+ * - 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).
35374
+ * - Linux operating system: 2.2.3.256
35375
+ * - Windows operating system: 2.1.3.256
35376
+ * - After this operation is invoked, the WebSocketUrl is valid for 10 minutes.
35377
+ * - After a session is established, Cloud Assistant closes the connection if no data is transmitted for 3 minutes.
35378
+ * - 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.
35379
+ * - The port forwarding feature supports only TCP port forwarding. UDP is not supported.
35380
+ * - To permanently shutdown a session and invalidate the WebSocketUrl, invoke the EndTerminalSession operation.
35345
35381
  *
35346
35382
  * @param tmpReq - StartTerminalSessionRequest
35347
35383
  * @param runtime - runtime options for this request RuntimeOptions
@@ -35434,22 +35470,22 @@ export default class Client extends OpenApi {
35434
35470
  }
35435
35471
 
35436
35472
  /**
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.
35473
+ * 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
35474
  *
35439
35475
  * @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.
35476
+ * ## Operation description
35477
+ * 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:
35478
+ * - The specified ECS instance must be in the Running state.
35479
+ * - 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.
35480
+ * - If Cloud Assistant Agent is not installed on the ECS instance, invoke [InstallCloudAssistant](https://help.aliyun.com/document_detail/85916.html) to install it.
35481
+ * - 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).
35482
+ * - Linux operating system: 2.2.3.256
35483
+ * - Windows operating system: 2.1.3.256
35484
+ * - After this operation is invoked, the WebSocketUrl is valid for 10 minutes.
35485
+ * - After a session is established, Cloud Assistant closes the connection if no data is transmitted for 3 minutes.
35486
+ * - 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.
35487
+ * - The port forwarding feature supports only TCP port forwarding. UDP is not supported.
35488
+ * - To permanently shutdown a session and invalidate the WebSocketUrl, invoke the EndTerminalSession operation.
35453
35489
  *
35454
35490
  * @param request - StartTerminalSessionRequest
35455
35491
  * @returns StartTerminalSessionResponse
@@ -35460,13 +35496,13 @@ export default class Client extends OpenApi {
35460
35496
  }
35461
35497
 
35462
35498
  /**
35463
- * Stops an Elastic Compute Service (ECS) instance. You can specify parameters to determine whether to forcefully stop the instance and the stop mode.
35499
+ * 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
35500
  *
35465
35501
  * @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 地址。
35502
+ * 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.
35503
+ * ### Before you begin
35504
+ * - 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).
35505
+ * - 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
35506
  *
35471
35507
  * @param request - StopInstanceRequest
35472
35508
  * @param runtime - runtime options for this request RuntimeOptions
@@ -35533,13 +35569,13 @@ export default class Client extends OpenApi {
35533
35569
  }
35534
35570
 
35535
35571
  /**
35536
- * Stops an Elastic Compute Service (ECS) instance. You can specify parameters to determine whether to forcefully stop the instance and the stop mode.
35572
+ * 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
35573
  *
35538
35574
  * @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 地址。
35575
+ * 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.
35576
+ * ### Before you begin
35577
+ * - 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).
35578
+ * - 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
35579
  *
35544
35580
  * @param request - StopInstanceRequest
35545
35581
  * @returns StopInstanceResponse
@@ -35550,13 +35586,13 @@ export default class Client extends OpenApi {
35550
35586
  }
35551
35587
 
35552
35588
  /**
35553
- * Stops Elastic Compute Service (ECS) instances. You can specify parameters to determine whether to forcefully stop the instances and the stop mode.
35589
+ * Stops one or more ECS instances. You can specify the stop method, stop mode, and batch operation mode.
35554
35590
  *
35555
35591
  * @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)
35592
+ * 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.
35593
+ * ### Before you begin
35594
+ * - 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.
35595
+ * - 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
35596
  *
35561
35597
  * @param request - StopInstancesRequest
35562
35598
  * @param runtime - runtime options for this request RuntimeOptions
@@ -35623,13 +35659,13 @@ export default class Client extends OpenApi {
35623
35659
  }
35624
35660
 
35625
35661
  /**
35626
- * Stops Elastic Compute Service (ECS) instances. You can specify parameters to determine whether to forcefully stop the instances and the stop mode.
35662
+ * Stops one or more ECS instances. You can specify the stop method, stop mode, and batch operation mode.
35627
35663
  *
35628
35664
  * @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)
35665
+ * 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.
35666
+ * ### Before you begin
35667
+ * - 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.
35668
+ * - 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
35669
  *
35634
35670
  * @param request - StopInstancesRequest
35635
35671
  * @returns StopInstancesResponse
@@ -35955,8 +35991,8 @@ export default class Client extends OpenApi {
35955
35991
  * @remarks
35956
35992
  * ## Operation description
35957
35993
  * 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.
35994
+ * - The Elastic Network Interface (ENI) must be in the **Active** or **InUse** state.
35995
+ * - 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
35996
  *
35961
35997
  * @param request - UnassignIpv6AddressesRequest
35962
35998
  * @param runtime - runtime options for this request RuntimeOptions
@@ -36024,8 +36060,8 @@ export default class Client extends OpenApi {
36024
36060
  * @remarks
36025
36061
  * ## Operation description
36026
36062
  * 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.
36063
+ * - The Elastic Network Interface (ENI) must be in the **Active** or **InUse** state.
36064
+ * - 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
36065
  *
36030
36066
  * @param request - UnassignIpv6AddressesRequest
36031
36067
  * @returns UnassignIpv6AddressesResponse