@alicloud/ecs20140526 3.0.2 → 3.0.4

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.
package/dist/client.d.ts CHANGED
@@ -396,6 +396,7 @@ export declare class ApplyAutoSnapshotPolicyResponse extends $tea.Model {
396
396
  });
397
397
  }
398
398
  export declare class AssignIpv6AddressesRequest extends $tea.Model {
399
+ clientToken?: string;
399
400
  ipv6Address?: string[];
400
401
  ipv6AddressCount?: number;
401
402
  ipv6Prefix?: string[];
@@ -2708,6 +2709,7 @@ export declare class CreateLaunchTemplateVersionRequest extends $tea.Model {
2708
2709
  });
2709
2710
  }
2710
2711
  export declare class CreateLaunchTemplateVersionResponseBody extends $tea.Model {
2712
+ launchTemplateId?: string;
2711
2713
  launchTemplateVersionNumber?: number;
2712
2714
  requestId?: string;
2713
2715
  static names(): {
@@ -4533,6 +4535,7 @@ export declare class DeleteLaunchTemplateRequest extends $tea.Model {
4533
4535
  });
4534
4536
  }
4535
4537
  export declare class DeleteLaunchTemplateResponseBody extends $tea.Model {
4538
+ launchTemplateId?: string;
4536
4539
  requestId?: string;
4537
4540
  static names(): {
4538
4541
  [key: string]: string;
@@ -4580,6 +4583,7 @@ export declare class DeleteLaunchTemplateVersionRequest extends $tea.Model {
4580
4583
  });
4581
4584
  }
4582
4585
  export declare class DeleteLaunchTemplateVersionResponseBody extends $tea.Model {
4586
+ launchTemplateVersions?: DeleteLaunchTemplateVersionResponseBodyLaunchTemplateVersions;
4583
4587
  requestId?: string;
4584
4588
  static names(): {
4585
4589
  [key: string]: string;
@@ -7764,6 +7768,7 @@ export declare class DescribeInstanceAttributeResponseBody extends $tea.Model {
7764
7768
  dedicatedHostAttribute?: DescribeInstanceAttributeResponseBodyDedicatedHostAttribute;
7765
7769
  description?: string;
7766
7770
  eipAddress?: DescribeInstanceAttributeResponseBodyEipAddress;
7771
+ enableJumboFrame?: boolean;
7767
7772
  expiredTime?: string;
7768
7773
  hostName?: string;
7769
7774
  imageId?: string;
@@ -13897,6 +13902,7 @@ export declare class ModifyInstanceAttributeRequest extends $tea.Model {
13897
13902
  creditSpecification?: string;
13898
13903
  deletionProtection?: boolean;
13899
13904
  description?: string;
13905
+ enableJumboFrame?: boolean;
13900
13906
  hostName?: string;
13901
13907
  instanceId?: string;
13902
13908
  instanceName?: string;
@@ -14469,6 +14475,7 @@ export declare class ModifyLaunchTemplateDefaultVersionRequest extends $tea.Mode
14469
14475
  });
14470
14476
  }
14471
14477
  export declare class ModifyLaunchTemplateDefaultVersionResponseBody extends $tea.Model {
14478
+ launchTemplateId?: string;
14472
14479
  requestId?: string;
14473
14480
  static names(): {
14474
14481
  [key: string]: string;
@@ -17024,6 +17031,7 @@ export declare class RunInstancesRequest extends $tea.Model {
17024
17031
  httpTokens?: string;
17025
17032
  imageFamily?: string;
17026
17033
  imageId?: string;
17034
+ imageOptions?: RunInstancesRequestImageOptions;
17027
17035
  instanceChargeType?: string;
17028
17036
  instanceName?: string;
17029
17037
  instanceType?: string;
@@ -17041,6 +17049,7 @@ export declare class RunInstancesRequest extends $tea.Model {
17041
17049
  minAmount?: number;
17042
17050
  networkInterface?: RunInstancesRequestNetworkInterface[];
17043
17051
  networkInterfaceQueueNumber?: number;
17052
+ networkOptions?: RunInstancesRequestNetworkOptions;
17044
17053
  ownerAccount?: string;
17045
17054
  ownerId?: number;
17046
17055
  password?: string;
@@ -17268,7 +17277,6 @@ export declare class StartInstanceRequest extends $tea.Model {
17268
17277
  ownerId?: number;
17269
17278
  resourceOwnerAccount?: string;
17270
17279
  resourceOwnerId?: number;
17271
- sourceRegionId?: string;
17272
17280
  static names(): {
17273
17281
  [key: string]: string;
17274
17282
  };
@@ -18275,6 +18283,7 @@ export declare class CreateAutoProvisioningGroupRequestLaunchConfigurationTag ex
18275
18283
  }
18276
18284
  export declare class CreateAutoProvisioningGroupRequestLaunchConfiguration extends $tea.Model {
18277
18285
  arn?: CreateAutoProvisioningGroupRequestLaunchConfigurationArn[];
18286
+ autoReleaseTime?: string;
18278
18287
  creditSpecification?: string;
18279
18288
  dataDisk?: CreateAutoProvisioningGroupRequestLaunchConfigurationDataDisk[];
18280
18289
  deploymentSetId?: string;
@@ -19144,6 +19153,31 @@ export declare class DeleteActivationResponseBodyActivation extends $tea.Model {
19144
19153
  [key: string]: any;
19145
19154
  });
19146
19155
  }
19156
+ export declare class DeleteLaunchTemplateVersionResponseBodyLaunchTemplateVersionsLaunchTemplateVersion extends $tea.Model {
19157
+ launchTemplateId?: string;
19158
+ launchTemplateVersionNumber?: number;
19159
+ static names(): {
19160
+ [key: string]: string;
19161
+ };
19162
+ static types(): {
19163
+ [key: string]: any;
19164
+ };
19165
+ constructor(map?: {
19166
+ [key: string]: any;
19167
+ });
19168
+ }
19169
+ export declare class DeleteLaunchTemplateVersionResponseBodyLaunchTemplateVersions extends $tea.Model {
19170
+ launchTemplateVersion?: DeleteLaunchTemplateVersionResponseBodyLaunchTemplateVersionsLaunchTemplateVersion[];
19171
+ static names(): {
19172
+ [key: string]: string;
19173
+ };
19174
+ static types(): {
19175
+ [key: string]: any;
19176
+ };
19177
+ constructor(map?: {
19178
+ [key: string]: any;
19179
+ });
19180
+ }
19147
19181
  export declare class DeleteRouteEntryRequestNextHopList extends $tea.Model {
19148
19182
  nextHopId?: string;
19149
19183
  nextHopType?: string;
@@ -20521,6 +20555,7 @@ export declare class DescribeDedicatedHostsResponseBodyDedicatedHostsDedicatedHo
20521
20555
  }
20522
20556
  export declare class DescribeDedicatedHostsResponseBodyDedicatedHostsDedicatedHostInstancesInstance extends $tea.Model {
20523
20557
  instanceId?: string;
20558
+ instanceOwnerId?: number;
20524
20559
  instanceType?: string;
20525
20560
  socketId?: string;
20526
20561
  static names(): {
@@ -20644,7 +20679,7 @@ export declare class DescribeDedicatedHostsResponseBodyDedicatedHostsDedicatedHo
20644
20679
  });
20645
20680
  }
20646
20681
  export declare class DescribeDedicatedHostsResponseBodyDedicatedHostsDedicatedHost extends $tea.Model {
20647
- schedulerOptions: DescribeDedicatedHostsResponseBodyDedicatedHostsDedicatedHostSchedulerOptions;
20682
+ schedulerOptions?: DescribeDedicatedHostsResponseBodyDedicatedHostsDedicatedHostSchedulerOptions;
20648
20683
  actionOnMaintenance?: string;
20649
20684
  autoPlacement?: string;
20650
20685
  autoReleaseTime?: string;
@@ -20656,6 +20691,7 @@ export declare class DescribeDedicatedHostsResponseBodyDedicatedHostsDedicatedHo
20656
20691
  dedicatedHostClusterId?: string;
20657
20692
  dedicatedHostId?: string;
20658
20693
  dedicatedHostName?: string;
20694
+ dedicatedHostOwnerId?: number;
20659
20695
  dedicatedHostType?: string;
20660
20696
  description?: string;
20661
20697
  expiredTime?: string;
@@ -22653,6 +22689,8 @@ export declare class DescribeInstanceHistoryEventsResponseBodyInstanceSystemEven
22653
22689
  });
22654
22690
  }
22655
22691
  export declare class DescribeInstanceHistoryEventsResponseBodyInstanceSystemEventSetInstanceSystemEventTypeExtendedAttribute extends $tea.Model {
22692
+ canAccept?: string;
22693
+ code?: string;
22656
22694
  device?: string;
22657
22695
  diskId?: string;
22658
22696
  hostId?: string;
@@ -22660,6 +22698,9 @@ export declare class DescribeInstanceHistoryEventsResponseBodyInstanceSystemEven
22660
22698
  inactiveDisks?: DescribeInstanceHistoryEventsResponseBodyInstanceSystemEventSetInstanceSystemEventTypeExtendedAttributeInactiveDisks;
22661
22699
  migrationOptions?: DescribeInstanceHistoryEventsResponseBodyInstanceSystemEventSetInstanceSystemEventTypeExtendedAttributeMigrationOptions;
22662
22700
  onlineRepairPolicy?: string;
22701
+ punishDomain?: string;
22702
+ punishType?: string;
22703
+ punishUrl?: string;
22663
22704
  rack?: string;
22664
22705
  static names(): {
22665
22706
  [key: string]: string;
@@ -24155,7 +24196,7 @@ export declare class DescribeLaunchTemplateVersionsResponseBodyLaunchTemplateVer
24155
24196
  });
24156
24197
  }
24157
24198
  export declare class DescribeLaunchTemplateVersionsResponseBodyLaunchTemplateVersionSetsLaunchTemplateVersionSetLaunchTemplateData extends $tea.Model {
24158
- systemDisk: DescribeLaunchTemplateVersionsResponseBodyLaunchTemplateVersionSetsLaunchTemplateVersionSetLaunchTemplateDataSystemDisk;
24199
+ systemDisk?: DescribeLaunchTemplateVersionsResponseBodyLaunchTemplateVersionSetsLaunchTemplateVersionSetLaunchTemplateDataSystemDisk;
24159
24200
  autoReleaseTime?: string;
24160
24201
  dataDisks?: DescribeLaunchTemplateVersionsResponseBodyLaunchTemplateVersionSetsLaunchTemplateVersionSetLaunchTemplateDataDataDisks;
24161
24202
  deploymentSetId?: string;
@@ -28206,6 +28247,18 @@ export declare class RunInstancesRequestDataDisk extends $tea.Model {
28206
28247
  [key: string]: any;
28207
28248
  });
28208
28249
  }
28250
+ export declare class RunInstancesRequestImageOptions extends $tea.Model {
28251
+ loginAsNonRoot?: boolean;
28252
+ static names(): {
28253
+ [key: string]: string;
28254
+ };
28255
+ static types(): {
28256
+ [key: string]: any;
28257
+ };
28258
+ constructor(map?: {
28259
+ [key: string]: any;
28260
+ });
28261
+ }
28209
28262
  export declare class RunInstancesRequestNetworkInterface extends $tea.Model {
28210
28263
  description?: string;
28211
28264
  instanceType?: string;
@@ -28230,6 +28283,18 @@ export declare class RunInstancesRequestNetworkInterface extends $tea.Model {
28230
28283
  [key: string]: any;
28231
28284
  });
28232
28285
  }
28286
+ export declare class RunInstancesRequestNetworkOptions extends $tea.Model {
28287
+ enableJumboFrame?: boolean;
28288
+ static names(): {
28289
+ [key: string]: string;
28290
+ };
28291
+ static types(): {
28292
+ [key: string]: any;
28293
+ };
28294
+ constructor(map?: {
28295
+ [key: string]: any;
28296
+ });
28297
+ }
28233
28298
  export declare class RunInstancesRequestTag extends $tea.Model {
28234
28299
  key?: string;
28235
28300
  value?: string;
@@ -28534,10 +28599,9 @@ export default class Client extends OpenApi {
28534
28599
  */
28535
28600
  assignIpv6Addresses(request: AssignIpv6AddressesRequest): Promise<AssignIpv6AddressesResponse>;
28536
28601
  /**
28537
- * ## Description
28538
- * * The ENI to which you want to assign secondary private IP addresses must be in the Available (Available) or InUse (InUse) state.
28539
- * * When you assign secondary private IP addresses to a primary ENI, the instance to which the ENI is attached must be in the Running (Running) or Stopped (Stopped) state.
28540
- * * When an ENI is in the Available (Available) state, you can assign up to 50 secondary private IP addresses to it. When an ENI is attached to an instance, the number of secondary private IP addresses that can be assigned to the ENI is subject to the instance type. For more information, see [Instance families](~~25378~~).
28602
+ * * The ENI to which you want to assign secondary private IP addresses must be in the Available or InUse state.
28603
+ * * When you assign secondary private IP addresses to a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
28604
+ * * When an ENI is in the Available state, you can assign up to 50 secondary private IP addresses to it. When an ENI is attached to an instance, the number of secondary private IP addresses that can be assigned to the ENI is subject to the instance type. For more information, see [Instance families](~~25378~~).
28541
28605
  * * After you call this operation for an ENI, you can obtain the secondary private IP addresses that are assigned to the ENI from the response.
28542
28606
  *
28543
28607
  * @param request AssignPrivateIpAddressesRequest
@@ -28546,10 +28610,9 @@ export default class Client extends OpenApi {
28546
28610
  */
28547
28611
  assignPrivateIpAddressesWithOptions(request: AssignPrivateIpAddressesRequest, runtime: $Util.RuntimeOptions): Promise<AssignPrivateIpAddressesResponse>;
28548
28612
  /**
28549
- * ## Description
28550
- * * The ENI to which you want to assign secondary private IP addresses must be in the Available (Available) or InUse (InUse) state.
28551
- * * When you assign secondary private IP addresses to a primary ENI, the instance to which the ENI is attached must be in the Running (Running) or Stopped (Stopped) state.
28552
- * * When an ENI is in the Available (Available) state, you can assign up to 50 secondary private IP addresses to it. When an ENI is attached to an instance, the number of secondary private IP addresses that can be assigned to the ENI is subject to the instance type. For more information, see [Instance families](~~25378~~).
28613
+ * * The ENI to which you want to assign secondary private IP addresses must be in the Available or InUse state.
28614
+ * * When you assign secondary private IP addresses to a primary ENI, the instance to which the ENI is attached must be in the Running or Stopped state.
28615
+ * * When an ENI is in the Available state, you can assign up to 50 secondary private IP addresses to it. When an ENI is attached to an instance, the number of secondary private IP addresses that can be assigned to the ENI is subject to the instance type. For more information, see [Instance families](~~25378~~).
28553
28616
  * * After you call this operation for an ENI, you can obtain the secondary private IP addresses that are assigned to the ENI from the response.
28554
28617
  *
28555
28618
  * @param request AssignPrivateIpAddressesRequest
@@ -28681,7 +28744,8 @@ export default class Client extends OpenApi {
28681
28744
  * * You can attach multiple ENIs to a single instance. For more information, see [ENI overview](~~58496~~).
28682
28745
  * * 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.
28683
28746
  * * This operation is an asynchronous operation. After this operation is called to attach an ENI, you can check the status or events of the ENI to determine whether the ENI is attached. The following figure shows the transitions between the states of the ENI.
28684
- * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221124/esgu/AttachNetworkInterface.jpg) If the ENI is in the Attaching state, the ENI attachment request is sent and the ENI is being attached to the specified instance. If the ENI is in the InUse state, the ENI is attached to the specified instance. If the ENI is in the Available state, the ENI fails to be attached.
28747
+ * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/en-US/20230223/vqky/AttachNetworkInterface.png)
28748
+ * If the ENI is in the Attaching state, the ENI attachment request is sent and the ENI is being attached to the specified instance. If the ENI is in the InUse state, the ENI is attached to the specified instance. If the ENI is in the Available state, the ENI fails to be attached.
28685
28749
  * **For information about examples on how to call this operation, see** [Attach an ENI](~~471550~~).
28686
28750
  *
28687
28751
  * @param request AttachNetworkInterfaceRequest
@@ -28697,7 +28761,8 @@ export default class Client extends OpenApi {
28697
28761
  * * You can attach multiple ENIs to a single instance. For more information, see [ENI overview](~~58496~~).
28698
28762
  * * 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.
28699
28763
  * * This operation is an asynchronous operation. After this operation is called to attach an ENI, you can check the status or events of the ENI to determine whether the ENI is attached. The following figure shows the transitions between the states of the ENI.
28700
- * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/zh-CN/20221124/esgu/AttachNetworkInterface.jpg) If the ENI is in the Attaching state, the ENI attachment request is sent and the ENI is being attached to the specified instance. If the ENI is in the InUse state, the ENI is attached to the specified instance. If the ENI is in the Available state, the ENI fails to be attached.
28764
+ * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/en-US/20230223/vqky/AttachNetworkInterface.png)
28765
+ * If the ENI is in the Attaching state, the ENI attachment request is sent and the ENI is being attached to the specified instance. If the ENI is in the InUse state, the ENI is attached to the specified instance. If the ENI is in the Available state, the ENI fails to be attached.
28701
28766
  * **For information about examples on how to call this operation, see** [Attach an ENI](~~471550~~).
28702
28767
  *
28703
28768
  * @param request AttachNetworkInterfaceRequest
@@ -28705,56 +28770,47 @@ export default class Client extends OpenApi {
28705
28770
  */
28706
28771
  attachNetworkInterface(request: AttachNetworkInterfaceRequest): Promise<AttachNetworkInterfaceResponse>;
28707
28772
  /**
28708
- * In the security group-related API documents, inbound traffic refers to the traffic sent by the source and received by the destination.
28773
+ * ## Description
28709
28774
  * When you call this operation, take note of the following items:
28710
- * - The total number of outbound and inbound rules in each security group cannot exceed 200. For more information, see the "Security group limits" section in [Limits](~~25412#SecurityGroupQuota1~~).
28711
- * - The valid value of Priority ranges from 1 to 100. A smaller value indicates a higher priority.
28712
- * - When multiple security group rules have the same priority, drop rules take precedence.
28713
- * - The source can be a CIDR block specified by SourceCidrIp, Ipv6SourceCidrIp, or SourcePrefixListId or can be Elastic Compute Service (ECS) instances in a security group specified by SourceGroupId.
28714
- * - For advanced security groups, security groups cannot be used as authorization objects.
28715
- * - For each basic security group, a maximum of 20 security groups can be used as authorization objects.
28716
- * - If the specified security group rule already exists, the call to AuthorizeSecurityGroup is successful but no security group rule is created.
28717
- * - The `Permissions.N` prefix is added to some parameters to generate new parameters. Original parameters and corresponding parameters prefixed with Permissions.N cannot be specified together. We recommend that you use parameters prefixed with `Permissions.N`.
28718
- * - You can determine a security group rule by specifying one of the following groups of parameters. You cannot determine a security group rule by specifying only one parameter.
28719
- * - Parameters used to specify an inbound security group rule that controls access from a specific CIDR block: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, and SourceCidrIp. For a security group of the Virtual Private Cloud (VPC) type, you must set the NicType parameter to intranet. For a security group of the classic network type, you can set the NicType parameter to either internet or intranet. Sample request:
28720
- * ```
28721
- * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
28722
- * &SecurityGroupId=sg-bp67acfmxazb4p****
28723
- * &Permissions.1.SourceCidrIp=10.0.0.0/8
28724
- * &Permissions.1.IpProtocol=TCP
28725
- * &Permissions.1.PortRange=22/22
28726
- * &Permissions.1.NicType=intranet
28727
- * &Permissions.1.Policy=Accept
28728
- * &<Common request parameters>
28729
- *
28730
- * ```
28731
- * - Parameters used to specify an inbound security group rule that controls access from a security group: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, SourceGroupOwnerAccount, and SourceGroupId. In this case, you must set the NicType parameter to intranet. For mutual access between security groups in the classic network, you can allow or deny another security group within the same region access to your security group. The security group that is allowed access to your security group can belong to your own Alibaba Cloud account or another Alibaba Cloud account specified by the SourceGroupOwnerAccount parameter. For mutual access between security groups in VPCs, you can allow or deny another security group within the same VPC access to your security group. Sample request:
28732
- * ```
28733
- * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
28734
- * &SecurityGroupId=sg-bp67acfmxazb4p****
28735
- * &Permissions.1.SourceGroupId=sg-1651FBB**
28736
- * &Permissions.1.SourceGroupOwnerAccount=test@aliyun.com
28737
- * &Permissions.1.IpProtocol=TCP
28738
- * &Permissions.1.PortRange=22/22
28739
- * &Permissions.1.NicType=intranet
28740
- * &Permissions.1.Policy=Drop
28741
- * &<Common request parameters>
28742
- *
28743
- * ```
28744
- * - Parameters used to specify an inbound security group rule that controls access from a prefix list: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, and SourcePrefixListId. In this case, prefix lists support only security groups in VPCs. NicType must be set to intranet. Sample request:
28745
- * ```
28746
- * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
28747
- * &SecurityGroupId=sg-bp67acfmxazb4p****
28748
- * &Permissions.1.SourcePrefixListId=pl-x1j1k5ykzqlixdcy****
28749
- * &Permissions.1.SourceGroupOwnerAccount=test@aliyun.com
28750
- * &Permissions.1.IpProtocol=TCP
28751
- * &Permissions.1.PortRange=22/22
28752
- * &Permissions.1.NicType=intranet
28753
- * &Permissions.1.Policy=Drop
28754
- * &<Common request parameters>
28755
- *
28756
- * ```
28757
- * - For information about examples on security group rule settings, see [Security groups for different use cases](~~25475~~) and [Security group quintuple rules](~~97439~~).
28775
+ * * The total number of inbound and outbound security group rules in each security group cannot exceed 200. For more information, see the "Security group limits" section in [Limits](~~25412#SecurityGroupQuota1~~).
28776
+ * * The valid value of Priority ranges from 1 to 100. A smaller value indicates a higher priority.
28777
+ * * When multiple security group rules have the same priority, drop rules take precedence.
28778
+ * * The source can be a CIDR block specified by SourceCidrIp, Ipv6SourceCidrIp, or SourcePrefixListId or can be Elastic Compute Service (ECS) instances in a security group specified by SourceGroupId.
28779
+ * * For advanced security groups, security groups cannot be used as authorization objects.
28780
+ * * For each basic security group, a maximum of 20 security groups can be used as authorization objects.
28781
+ * * If the specified security group rule exists in the security group, the call is successful but no security group rule is created.
28782
+ * * The `Permissions.N` prefix is added to some parameters to generate new parameters. Original parameters and corresponding parameters prefixed with Permissions.N cannot be specified together. We recommend that you use parameters prefixed with `Permissions.N`.
28783
+ * * You can determine a security group rule by specifying one of the following groups of parameters. You cannot determine a security group rule by specifying only one parameter.
28784
+ * * Parameters used to specify a security group rule that controls access from a specified CIDR block: IpProtocol, PortRange, SourcePortRange, NicType, Policy, and SourceCidrIp. For a security group of the Virtual Private Cloud (VPC) type, you must set the NicType parameter to intranet. For a security group of the classic network type, you can set the NicType parameter to either internet or intranet. Sample request:
28785
+ * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
28786
+ * &SecurityGroupId=sg-bp67acfmxazb4p****
28787
+ * &Permissions.1.SourceCidrIp=10.0.0.0/8
28788
+ * &Permissions.1.IpProtocol=TCP
28789
+ * &Permissions.1.PortRange=22/22
28790
+ * &Permissions.1.NicType=intranet
28791
+ * &Permissions.1.Policy=Accept
28792
+ * &<Common request parameters>
28793
+ * * Parameters used to specify a security group rule that controls access from a security group: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, SourceGroupOwnerAccount, and SourceGroupId. In this case, you must set the NicType parameter to intranet. To allow mutual access between security groups in the classic network, you can allow or deny another security group within the same region access to your security group. The security group that is allowed access to your security group can belong to your own Alibaba Cloud account or another Alibaba Cloud account specified by the SourceGroupOwnerAccount parameter. To allow mutual access between security groups in VPCs, you can allow or deny another security group within the same VPC access to your security group. Sample request:
28794
+ * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
28795
+ * &SecurityGroupId=sg-bp67acfmxazb4p****
28796
+ * &Permissions.1.SourceGroupId=sg-1651FBB**
28797
+ * &Permissions.1.SourceGroupOwnerAccount=test@aliyun.com
28798
+ * &Permissions.1.IpProtocol=TCP
28799
+ * &Permissions.1.PortRange=22/22
28800
+ * &Permissions.1.NicType=intranet
28801
+ * &Permissions.1.Policy=Drop
28802
+ * &<Common request parameters>
28803
+ * * Parameters used to specify a security group rule that controls access from a prefix list: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, and DestPrefixListId. In this case, prefix lists support only security groups in VPCs. NicType must be set to intranet. Sample request:
28804
+ * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
28805
+ * &SecurityGroupId=sg-bp67acfmxazb4p****
28806
+ * &Permissions.1.SourcePrefixListId=pl-x1j1k5ykzqlixdcy****
28807
+ * &Permissions.1.SourceGroupOwnerAccount=test@aliyun.com
28808
+ * &Permissions.1.IpProtocol=TCP
28809
+ * &Permissions.1.PortRange=22/22
28810
+ * &Permissions.1.NicType=intranet
28811
+ * &Permissions.1.Policy=Drop
28812
+ * &<Common request parameters>
28813
+ * * For information about examples on security group rule settings, see [Security groups for different use cases](~~25475~~) and [Security group quintuple rules](~~97439~~).
28758
28814
  *
28759
28815
  * @param request AuthorizeSecurityGroupRequest
28760
28816
  * @param runtime runtime options for this request RuntimeOptions
@@ -28762,74 +28818,66 @@ export default class Client extends OpenApi {
28762
28818
  */
28763
28819
  authorizeSecurityGroupWithOptions(request: AuthorizeSecurityGroupRequest, runtime: $Util.RuntimeOptions): Promise<AuthorizeSecurityGroupResponse>;
28764
28820
  /**
28765
- * In the security group-related API documents, inbound traffic refers to the traffic sent by the source and received by the destination.
28821
+ * ## Description
28766
28822
  * When you call this operation, take note of the following items:
28767
- * - The total number of outbound and inbound rules in each security group cannot exceed 200. For more information, see the "Security group limits" section in [Limits](~~25412#SecurityGroupQuota1~~).
28768
- * - The valid value of Priority ranges from 1 to 100. A smaller value indicates a higher priority.
28769
- * - When multiple security group rules have the same priority, drop rules take precedence.
28770
- * - The source can be a CIDR block specified by SourceCidrIp, Ipv6SourceCidrIp, or SourcePrefixListId or can be Elastic Compute Service (ECS) instances in a security group specified by SourceGroupId.
28771
- * - For advanced security groups, security groups cannot be used as authorization objects.
28772
- * - For each basic security group, a maximum of 20 security groups can be used as authorization objects.
28773
- * - If the specified security group rule already exists, the call to AuthorizeSecurityGroup is successful but no security group rule is created.
28774
- * - The `Permissions.N` prefix is added to some parameters to generate new parameters. Original parameters and corresponding parameters prefixed with Permissions.N cannot be specified together. We recommend that you use parameters prefixed with `Permissions.N`.
28775
- * - You can determine a security group rule by specifying one of the following groups of parameters. You cannot determine a security group rule by specifying only one parameter.
28776
- * - Parameters used to specify an inbound security group rule that controls access from a specific CIDR block: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, and SourceCidrIp. For a security group of the Virtual Private Cloud (VPC) type, you must set the NicType parameter to intranet. For a security group of the classic network type, you can set the NicType parameter to either internet or intranet. Sample request:
28777
- * ```
28778
- * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
28779
- * &SecurityGroupId=sg-bp67acfmxazb4p****
28780
- * &Permissions.1.SourceCidrIp=10.0.0.0/8
28781
- * &Permissions.1.IpProtocol=TCP
28782
- * &Permissions.1.PortRange=22/22
28783
- * &Permissions.1.NicType=intranet
28784
- * &Permissions.1.Policy=Accept
28785
- * &<Common request parameters>
28786
- *
28787
- * ```
28788
- * - Parameters used to specify an inbound security group rule that controls access from a security group: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, SourceGroupOwnerAccount, and SourceGroupId. In this case, you must set the NicType parameter to intranet. For mutual access between security groups in the classic network, you can allow or deny another security group within the same region access to your security group. The security group that is allowed access to your security group can belong to your own Alibaba Cloud account or another Alibaba Cloud account specified by the SourceGroupOwnerAccount parameter. For mutual access between security groups in VPCs, you can allow or deny another security group within the same VPC access to your security group. Sample request:
28789
- * ```
28790
- * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
28791
- * &SecurityGroupId=sg-bp67acfmxazb4p****
28792
- * &Permissions.1.SourceGroupId=sg-1651FBB**
28793
- * &Permissions.1.SourceGroupOwnerAccount=test@aliyun.com
28794
- * &Permissions.1.IpProtocol=TCP
28795
- * &Permissions.1.PortRange=22/22
28796
- * &Permissions.1.NicType=intranet
28797
- * &Permissions.1.Policy=Drop
28798
- * &<Common request parameters>
28799
- *
28800
- * ```
28801
- * - Parameters used to specify an inbound security group rule that controls access from a prefix list: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, and SourcePrefixListId. In this case, prefix lists support only security groups in VPCs. NicType must be set to intranet. Sample request:
28802
- * ```
28803
- * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
28804
- * &SecurityGroupId=sg-bp67acfmxazb4p****
28805
- * &Permissions.1.SourcePrefixListId=pl-x1j1k5ykzqlixdcy****
28806
- * &Permissions.1.SourceGroupOwnerAccount=test@aliyun.com
28807
- * &Permissions.1.IpProtocol=TCP
28808
- * &Permissions.1.PortRange=22/22
28809
- * &Permissions.1.NicType=intranet
28810
- * &Permissions.1.Policy=Drop
28811
- * &<Common request parameters>
28812
- *
28813
- * ```
28814
- * - For information about examples on security group rule settings, see [Security groups for different use cases](~~25475~~) and [Security group quintuple rules](~~97439~~).
28823
+ * * The total number of inbound and outbound security group rules in each security group cannot exceed 200. For more information, see the "Security group limits" section in [Limits](~~25412#SecurityGroupQuota1~~).
28824
+ * * The valid value of Priority ranges from 1 to 100. A smaller value indicates a higher priority.
28825
+ * * When multiple security group rules have the same priority, drop rules take precedence.
28826
+ * * The source can be a CIDR block specified by SourceCidrIp, Ipv6SourceCidrIp, or SourcePrefixListId or can be Elastic Compute Service (ECS) instances in a security group specified by SourceGroupId.
28827
+ * * For advanced security groups, security groups cannot be used as authorization objects.
28828
+ * * For each basic security group, a maximum of 20 security groups can be used as authorization objects.
28829
+ * * If the specified security group rule exists in the security group, the call is successful but no security group rule is created.
28830
+ * * The `Permissions.N` prefix is added to some parameters to generate new parameters. Original parameters and corresponding parameters prefixed with Permissions.N cannot be specified together. We recommend that you use parameters prefixed with `Permissions.N`.
28831
+ * * You can determine a security group rule by specifying one of the following groups of parameters. You cannot determine a security group rule by specifying only one parameter.
28832
+ * * Parameters used to specify a security group rule that controls access from a specified CIDR block: IpProtocol, PortRange, SourcePortRange, NicType, Policy, and SourceCidrIp. For a security group of the Virtual Private Cloud (VPC) type, you must set the NicType parameter to intranet. For a security group of the classic network type, you can set the NicType parameter to either internet or intranet. Sample request:
28833
+ * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
28834
+ * &SecurityGroupId=sg-bp67acfmxazb4p****
28835
+ * &Permissions.1.SourceCidrIp=10.0.0.0/8
28836
+ * &Permissions.1.IpProtocol=TCP
28837
+ * &Permissions.1.PortRange=22/22
28838
+ * &Permissions.1.NicType=intranet
28839
+ * &Permissions.1.Policy=Accept
28840
+ * &<Common request parameters>
28841
+ * * Parameters used to specify a security group rule that controls access from a security group: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, SourceGroupOwnerAccount, and SourceGroupId. In this case, you must set the NicType parameter to intranet. To allow mutual access between security groups in the classic network, you can allow or deny another security group within the same region access to your security group. The security group that is allowed access to your security group can belong to your own Alibaba Cloud account or another Alibaba Cloud account specified by the SourceGroupOwnerAccount parameter. To allow mutual access between security groups in VPCs, you can allow or deny another security group within the same VPC access to your security group. Sample request:
28842
+ * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
28843
+ * &SecurityGroupId=sg-bp67acfmxazb4p****
28844
+ * &Permissions.1.SourceGroupId=sg-1651FBB**
28845
+ * &Permissions.1.SourceGroupOwnerAccount=test@aliyun.com
28846
+ * &Permissions.1.IpProtocol=TCP
28847
+ * &Permissions.1.PortRange=22/22
28848
+ * &Permissions.1.NicType=intranet
28849
+ * &Permissions.1.Policy=Drop
28850
+ * &<Common request parameters>
28851
+ * * Parameters used to specify a security group rule that controls access from a prefix list: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, and DestPrefixListId. In this case, prefix lists support only security groups in VPCs. NicType must be set to intranet. Sample request:
28852
+ * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroup
28853
+ * &SecurityGroupId=sg-bp67acfmxazb4p****
28854
+ * &Permissions.1.SourcePrefixListId=pl-x1j1k5ykzqlixdcy****
28855
+ * &Permissions.1.SourceGroupOwnerAccount=test@aliyun.com
28856
+ * &Permissions.1.IpProtocol=TCP
28857
+ * &Permissions.1.PortRange=22/22
28858
+ * &Permissions.1.NicType=intranet
28859
+ * &Permissions.1.Policy=Drop
28860
+ * &<Common request parameters>
28861
+ * * For information about examples on security group rule settings, see [Security groups for different use cases](~~25475~~) and [Security group quintuple rules](~~97439~~).
28815
28862
  *
28816
28863
  * @param request AuthorizeSecurityGroupRequest
28817
28864
  * @return AuthorizeSecurityGroupResponse
28818
28865
  */
28819
28866
  authorizeSecurityGroup(request: AuthorizeSecurityGroupRequest): Promise<AuthorizeSecurityGroupResponse>;
28820
28867
  /**
28868
+ * ## Description
28821
28869
  * When you call this operation, take note of the following items:
28822
- * * The total number of outbound and inbound rules in each security group cannot exceed 200. For more information, see the "Security group limits" section in [Limits](~~25412#SecurityGroupQuota1~~).
28870
+ * * The total number of inbound and outbound security group rules in each security group cannot exceed 200. For more information, see the "Security group limits" section in [](~~25412#SecurityGroupQuota1~~).
28823
28871
  * * You can set Policy to accept or drop for each security group rule to allow or deny access.
28824
- * * The valid values of Priority range from 1 to 100. A smaller value indicates a higher priority.
28872
+ * * The valid value of Priority ranges from 1 to 100. A smaller value indicates a higher priority.
28825
28873
  * * When several security group rules have the same priority, drop rules take precedence.
28826
- * * In each rule, the destination can be a CIDR block specified by DestCidrIp, Ipv6DestCidrIp, or DestPrefixListId or can be Elastic Compute Service (ECS) instances in a security group specified by DestGroupId.
28827
- * * Security groups cannot be referenced as authorization objects (destinations or sources) in rules of advanced security groups.
28828
- * * Up to 20 security groups can be referenced as authorization objects in rules of each basic security group.
28829
- * * If the specified security group rule exists in the security group, the call to AuthorizeSecurityGroupEgress is successful but no security group rule is created.
28830
- * * Parameters and their `Permissions.N`-prefixed counterparts cannot be specified at the same time. We recommend that you use the `Permissions.N`-prefixed parameters.
28874
+ * * The destination can be a CIDR block specified by DestCidrIp, Ipv6DestCidrIp, or DestPrefixListId or can be Elastic Compute Service (ECS) instances in a security group specified by DestGroupId.
28875
+ * * For advanced security groups, security groups cannot be used as authorization objects.
28876
+ * * For each basic security group, a maximum of 20 security groups can be used as authorization objects.
28877
+ * * If the specified security group rule exists in the security group, the call is successful but no security group rule is created.
28878
+ * * The `Permissions.N` prefix is added to some parameters to generate new parameters. Original parameters and corresponding parameters prefixed with Permissions.N cannot be specified together. We recommend that you use parameters prefixed with `Permissions.N`.
28831
28879
  * * You can determine a security group rule by specifying one of the following groups of parameters. You cannot determine a security group rule by specifying only one parameter.
28832
- * * Parameters used to specify an outbound security group rule that controls access to a CIDR block: SecurityGroupId, Permissions.N.IpProtocol, Permissions.N.PortRange, Permissions.N.SourcePortRange, Permissions.N.NicType, Permissions.N.Policy, and Permissions.N.DestCidrIp. Permissions.N.SourcePortRange is an optional parameter. Sample request:
28880
+ * * Parameters used to specify a security group rule that controls access to a specified CIDR block: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, and DestCidrIp. Sample request:
28833
28881
  * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress
28834
28882
  * &SecurityGroupId=sg-bp67acfmxazb4ph***
28835
28883
  * &Permissions.1.IpProtocol=ICMP
@@ -28838,7 +28886,7 @@ export default class Client extends OpenApi {
28838
28886
  * &Permissions.1.NicType=intranet
28839
28887
  * &Permissions.1.Policy=Accept
28840
28888
  * &<Common request parameters>
28841
- * * Parameters used to specify an outbound security group rule that controls access to a security group: SecurityGroupId, Permissions.N.IpProtocol, Permissions.N.PortRange, Permissions.N.SourcePortRange, Permissions.N.NicType, Permissions.N.Policy, Permissions.N.DestGroupOwnerAccount, and Permissions.N.DestGroupId. Permissions.N.SourcePortRange is an optional parameter. Sample request:
28889
+ * * Parameters used to specify a security group rule that controls access to a security group: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, DestGroupOwnerAccount, and DestGroupId. Sample request:
28842
28890
  * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress
28843
28891
  * &SecurityGroupId=sg-bp67acfmxazb4ph***
28844
28892
  * &Permissions.1.DestGroupId=sg-bp67acfmxazb4pi***
@@ -28848,7 +28896,7 @@ export default class Client extends OpenApi {
28848
28896
  * &Permissions.1.NicType=intranet
28849
28897
  * &Permissions.1.Policy=Drop
28850
28898
  * &<Common request parameters>
28851
- * * Parameters used to specify an outbound security group rule that controls access to a prefix list: SecurityGroupId, Permissions.N.IpProtocol, Permissions.N.PortRange, Permissions.N.SourcePortRange, Permissions.N.NicType, Permissions.N.Policy, and Permissions.N.DestPrefixListId. Permissions.N.SourcePortRange is an optional parameter. In this case, prefix lists support only security groups in virtual private clouds (VPCs). Permissions.N.NicType must be set to intranet. Sample request:
28899
+ * * Parameters used to specify a security group rule that controls access to a prefix list: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, and DestPrefixListId. In this case, prefix lists support only security groups in virtual private clouds (VPCs). NicType must be set to intranet. Sample request:
28852
28900
  * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress
28853
28901
  * &SecurityGroupId=sg-bp67acfmxazb4ph***
28854
28902
  * &Permissions.1.DestPrefixListId=pl-x1j1k5ykzqlixdcy****
@@ -28865,18 +28913,19 @@ export default class Client extends OpenApi {
28865
28913
  */
28866
28914
  authorizeSecurityGroupEgressWithOptions(request: AuthorizeSecurityGroupEgressRequest, runtime: $Util.RuntimeOptions): Promise<AuthorizeSecurityGroupEgressResponse>;
28867
28915
  /**
28916
+ * ## Description
28868
28917
  * When you call this operation, take note of the following items:
28869
- * * The total number of outbound and inbound rules in each security group cannot exceed 200. For more information, see the "Security group limits" section in [Limits](~~25412#SecurityGroupQuota1~~).
28918
+ * * The total number of inbound and outbound security group rules in each security group cannot exceed 200. For more information, see the "Security group limits" section in [](~~25412#SecurityGroupQuota1~~).
28870
28919
  * * You can set Policy to accept or drop for each security group rule to allow or deny access.
28871
- * * The valid values of Priority range from 1 to 100. A smaller value indicates a higher priority.
28920
+ * * The valid value of Priority ranges from 1 to 100. A smaller value indicates a higher priority.
28872
28921
  * * When several security group rules have the same priority, drop rules take precedence.
28873
- * * In each rule, the destination can be a CIDR block specified by DestCidrIp, Ipv6DestCidrIp, or DestPrefixListId or can be Elastic Compute Service (ECS) instances in a security group specified by DestGroupId.
28874
- * * Security groups cannot be referenced as authorization objects (destinations or sources) in rules of advanced security groups.
28875
- * * Up to 20 security groups can be referenced as authorization objects in rules of each basic security group.
28876
- * * If the specified security group rule exists in the security group, the call to AuthorizeSecurityGroupEgress is successful but no security group rule is created.
28877
- * * Parameters and their `Permissions.N`-prefixed counterparts cannot be specified at the same time. We recommend that you use the `Permissions.N`-prefixed parameters.
28922
+ * * The destination can be a CIDR block specified by DestCidrIp, Ipv6DestCidrIp, or DestPrefixListId or can be Elastic Compute Service (ECS) instances in a security group specified by DestGroupId.
28923
+ * * For advanced security groups, security groups cannot be used as authorization objects.
28924
+ * * For each basic security group, a maximum of 20 security groups can be used as authorization objects.
28925
+ * * If the specified security group rule exists in the security group, the call is successful but no security group rule is created.
28926
+ * * The `Permissions.N` prefix is added to some parameters to generate new parameters. Original parameters and corresponding parameters prefixed with Permissions.N cannot be specified together. We recommend that you use parameters prefixed with `Permissions.N`.
28878
28927
  * * You can determine a security group rule by specifying one of the following groups of parameters. You cannot determine a security group rule by specifying only one parameter.
28879
- * * Parameters used to specify an outbound security group rule that controls access to a CIDR block: SecurityGroupId, Permissions.N.IpProtocol, Permissions.N.PortRange, Permissions.N.SourcePortRange, Permissions.N.NicType, Permissions.N.Policy, and Permissions.N.DestCidrIp. Permissions.N.SourcePortRange is an optional parameter. Sample request:
28928
+ * * Parameters used to specify a security group rule that controls access to a specified CIDR block: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, and DestCidrIp. Sample request:
28880
28929
  * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress
28881
28930
  * &SecurityGroupId=sg-bp67acfmxazb4ph***
28882
28931
  * &Permissions.1.IpProtocol=ICMP
@@ -28885,7 +28934,7 @@ export default class Client extends OpenApi {
28885
28934
  * &Permissions.1.NicType=intranet
28886
28935
  * &Permissions.1.Policy=Accept
28887
28936
  * &<Common request parameters>
28888
- * * Parameters used to specify an outbound security group rule that controls access to a security group: SecurityGroupId, Permissions.N.IpProtocol, Permissions.N.PortRange, Permissions.N.SourcePortRange, Permissions.N.NicType, Permissions.N.Policy, Permissions.N.DestGroupOwnerAccount, and Permissions.N.DestGroupId. Permissions.N.SourcePortRange is an optional parameter. Sample request:
28937
+ * * Parameters used to specify a security group rule that controls access to a security group: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, DestGroupOwnerAccount, and DestGroupId. Sample request:
28889
28938
  * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress
28890
28939
  * &SecurityGroupId=sg-bp67acfmxazb4ph***
28891
28940
  * &Permissions.1.DestGroupId=sg-bp67acfmxazb4pi***
@@ -28895,7 +28944,7 @@ export default class Client extends OpenApi {
28895
28944
  * &Permissions.1.NicType=intranet
28896
28945
  * &Permissions.1.Policy=Drop
28897
28946
  * &<Common request parameters>
28898
- * * Parameters used to specify an outbound security group rule that controls access to a prefix list: SecurityGroupId, Permissions.N.IpProtocol, Permissions.N.PortRange, Permissions.N.SourcePortRange, Permissions.N.NicType, Permissions.N.Policy, and Permissions.N.DestPrefixListId. Permissions.N.SourcePortRange is an optional parameter. In this case, prefix lists support only security groups in virtual private clouds (VPCs). Permissions.N.NicType must be set to intranet. Sample request:
28947
+ * * Parameters used to specify a security group rule that controls access to a prefix list: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, and DestPrefixListId. In this case, prefix lists support only security groups in virtual private clouds (VPCs). NicType must be set to intranet. Sample request:
28899
28948
  * http(s)://ecs.aliyuncs.com/?Action=AuthorizeSecurityGroupEgress
28900
28949
  * &SecurityGroupId=sg-bp67acfmxazb4ph***
28901
28950
  * &Permissions.1.DestPrefixListId=pl-x1j1k5ykzqlixdcy****
@@ -28914,7 +28963,7 @@ export default class Client extends OpenApi {
28914
28963
  cancelAutoSnapshotPolicy(request: CancelAutoSnapshotPolicyRequest): Promise<CancelAutoSnapshotPolicyResponse>;
28915
28964
  /**
28916
28965
  * When you call this operation, take note of the following items:
28917
- * * After you cancel the image copy task, the image copy created in the destination region is deleted, and the source image remains unchanged.
28966
+ * * After you cancel an image copy task, the image copy created in the destination region is deleted, and the copied image remains unchanged.
28918
28967
  * * If the image copy task is complete, the CancelCopyImage operation fails and an error is returned.
28919
28968
  *
28920
28969
  * @param request CancelCopyImageRequest
@@ -28924,7 +28973,7 @@ export default class Client extends OpenApi {
28924
28973
  cancelCopyImageWithOptions(request: CancelCopyImageRequest, runtime: $Util.RuntimeOptions): Promise<CancelCopyImageResponse>;
28925
28974
  /**
28926
28975
  * When you call this operation, take note of the following items:
28927
- * * After you cancel the image copy task, the image copy created in the destination region is deleted, and the source image remains unchanged.
28976
+ * * After you cancel an image copy task, the image copy created in the destination region is deleted, and the copied image remains unchanged.
28928
28977
  * * If the image copy task is complete, the CancelCopyImage operation fails and an error is returned.
28929
28978
  *
28930
28979
  * @param request CancelCopyImageRequest
@@ -28983,7 +29032,7 @@ export default class Client extends OpenApi {
28983
29032
  /**
28984
29033
  * After a public IP address is converted into an EIP, the EIP is billed separately. Make sure that you understand the billing methods of EIPs. For more information, see [Billing overview](~~122035~~).
28985
29034
  * Before you call this operation, make sure that the following requirements are met:
28986
- * * The instance is in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
29035
+ * * The instance is in the `Stopped` or `Running` state.
28987
29036
  * * No EIPs are associated with the instance.
28988
29037
  * * The instance has no configuration change tasks that have not taken effect.
28989
29038
  * * The public bandwidth of the instance is not 0 Mbit/s.
@@ -28998,7 +29047,7 @@ export default class Client extends OpenApi {
28998
29047
  /**
28999
29048
  * After a public IP address is converted into an EIP, the EIP is billed separately. Make sure that you understand the billing methods of EIPs. For more information, see [Billing overview](~~122035~~).
29000
29049
  * Before you call this operation, make sure that the following requirements are met:
29001
- * * The instance is in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
29050
+ * * The instance is in the `Stopped` or `Running` state.
29002
29051
  * * No EIPs are associated with the instance.
29003
29052
  * * The instance has no configuration change tasks that have not taken effect.
29004
29053
  * * The public bandwidth of the instance is not 0 Mbit/s.
@@ -29010,13 +29059,13 @@ export default class Client extends OpenApi {
29010
29059
  */
29011
29060
  convertNatPublicIpToEip(request: ConvertNatPublicIpToEipRequest): Promise<ConvertNatPublicIpToEipResponse>;
29012
29061
  /**
29013
- * After you copy a custom image to the destination region, you can use the image copy to create Elastic Compute Service (ECS) instances by calling the RunInstances operation or replace the system disks of instances by calling the ReplaceSystemDisk operation in the destination region.
29014
- * When you call this operation, take note of the following items:
29015
- * * Only custom images that are in the `Available` state can be copied.
29016
- * * You can only copy images within your own Alibaba Cloud account. Images cannot be copied from one account to another.
29017
- * * When an image is being copied, you cannot delete the image copy by calling the [DeleteImage](~~25537~~) operation, but you can cancel the running copy task by calling the [CancelCopyImage](~~25539~~) operation.
29018
- * * A single region can have only one image copy task running at a time. Other image copy tasks queue up for the current task to complete before they run in sequence.
29019
- * * You can set the `ResourceGroupId` parameter to specify the resource group to which the image copy belongs. If you do not set the `ResourceGroupId` parameter, the image copy belongs to the default resource group.
29062
+ * After you copy a custom image (source image) to the destination region, you can use the image copy to create ECS instances by calling the RunInstances operation or replace the system disks of ECS instances by calling the ReplaceSystemDisk operation in the destination region.
29063
+ * Before you call the CopyImage operation, take note of the following items:
29064
+ * * You can copy only custom images that are in the `Available` state.
29065
+ * * Custom images that you want to copy must belong to your Alibaba Cloud account or be shared with you by others, and cannot be copied across accounts.
29066
+ * * When an image is being copied, the copied image cannot be deleted by calling the [DeleteImage](~~25537~~) operation. However, you can cancel the running copying task by calling the [CancelCopyImage](~~25539~~) operation.
29067
+ * * A region can have only one image copying task running at a time. Other image copying tasks queue up for the current task to complete before the tasks run in sequence.
29068
+ * * You can configure the `ResourceGroupId` parameter to specify the resource group to which to assign the image copy. If you do not configure the `ResourceGroupId` parameter, the image copy is assigned to the default resource group.
29020
29069
  *
29021
29070
  * @param request CopyImageRequest
29022
29071
  * @param runtime runtime options for this request RuntimeOptions
@@ -29024,22 +29073,21 @@ export default class Client extends OpenApi {
29024
29073
  */
29025
29074
  copyImageWithOptions(request: CopyImageRequest, runtime: $Util.RuntimeOptions): Promise<CopyImageResponse>;
29026
29075
  /**
29027
- * After you copy a custom image to the destination region, you can use the image copy to create Elastic Compute Service (ECS) instances by calling the RunInstances operation or replace the system disks of instances by calling the ReplaceSystemDisk operation in the destination region.
29028
- * When you call this operation, take note of the following items:
29029
- * * Only custom images that are in the `Available` state can be copied.
29030
- * * You can only copy images within your own Alibaba Cloud account. Images cannot be copied from one account to another.
29031
- * * When an image is being copied, you cannot delete the image copy by calling the [DeleteImage](~~25537~~) operation, but you can cancel the running copy task by calling the [CancelCopyImage](~~25539~~) operation.
29032
- * * A single region can have only one image copy task running at a time. Other image copy tasks queue up for the current task to complete before they run in sequence.
29033
- * * You can set the `ResourceGroupId` parameter to specify the resource group to which the image copy belongs. If you do not set the `ResourceGroupId` parameter, the image copy belongs to the default resource group.
29076
+ * After you copy a custom image (source image) to the destination region, you can use the image copy to create ECS instances by calling the RunInstances operation or replace the system disks of ECS instances by calling the ReplaceSystemDisk operation in the destination region.
29077
+ * Before you call the CopyImage operation, take note of the following items:
29078
+ * * You can copy only custom images that are in the `Available` state.
29079
+ * * Custom images that you want to copy must belong to your Alibaba Cloud account or be shared with you by others, and cannot be copied across accounts.
29080
+ * * When an image is being copied, the copied image cannot be deleted by calling the [DeleteImage](~~25537~~) operation. However, you can cancel the running copying task by calling the [CancelCopyImage](~~25539~~) operation.
29081
+ * * A region can have only one image copying task running at a time. Other image copying tasks queue up for the current task to complete before the tasks run in sequence.
29082
+ * * You can configure the `ResourceGroupId` parameter to specify the resource group to which to assign the image copy. If you do not configure the `ResourceGroupId` parameter, the image copy is assigned to the default resource group.
29034
29083
  *
29035
29084
  * @param request CopyImageRequest
29036
29085
  * @return CopyImageResponse
29037
29086
  */
29038
29087
  copyImage(request: CopyImageRequest): Promise<CopyImageResponse>;
29039
29088
  /**
29040
- * ## Description
29041
29089
  * When you call this operation, take note of the following items:
29042
- * * New snapshots, which are the copies of source snapshots, cannot be used to roll back the disks for which the source snapshots were created.
29090
+ * * New snapshots (copies) cannot be used to roll back disks from which the source snapshots (originals) were created.
29043
29091
  * * Encrypted snapshots cannot be copied.
29044
29092
  * * Local snapshots cannot be copied.
29045
29093
  *
@@ -29049,9 +29097,8 @@ export default class Client extends OpenApi {
29049
29097
  */
29050
29098
  copySnapshotWithOptions(request: CopySnapshotRequest, runtime: $Util.RuntimeOptions): Promise<CopySnapshotResponse>;
29051
29099
  /**
29052
- * ## Description
29053
29100
  * When you call this operation, take note of the following items:
29054
- * * New snapshots, which are the copies of source snapshots, cannot be used to roll back the disks for which the source snapshots were created.
29101
+ * * New snapshots (copies) cannot be used to roll back disks from which the source snapshots (originals) were created.
29055
29102
  * * Encrypted snapshots cannot be copied.
29056
29103
  * * Local snapshots cannot be copied.
29057
29104
  *
@@ -29143,9 +29190,9 @@ export default class Client extends OpenApi {
29143
29190
  */
29144
29191
  createAutoSnapshotPolicy(request: CreateAutoSnapshotPolicyRequest): Promise<CreateAutoSnapshotPolicyResponse>;
29145
29192
  /**
29146
- * When you create a capacity reservation, you can specify attributes such as a zone and an instance type. The system uses a private pool to reserve resources that match the specified attributes. For more information, see [Overview of Immediate Capacity Reservation](~~193633~~).
29193
+ * When you create a capacity reservation, you can specify attributes such as a zone and an instance type. Then, the system uses a private pool to reserve resources that match the specified attributes. For more information, see [Overview of Immediate Capacity Reservation](~~193633~~).
29147
29194
  * * Currently, only immediate capacity reservations are supported. Immediate capacity reservations take effect as soon as they are purchased. After you purchase an immediate capacity reservation, the specified instance type is billed on a pay-as-you-go basis regardless of whether the capacity reservation is actually used to create pay-as-you-go instances. Billing stops until you manually release the capacity reservation or until the capacity reservation expires and is automatically released.
29148
- * * You can call the [CreateInstance](~~25499~~) or [RunInstances](~~63440~~) operation to specify private pool attributes when you create instances. You can also call the [ModifyInstanceAttachmentAttributes](~~190006~~) operation to modify the attributes of a private pool. When an instance matches a private pool associated with a capacity reservation, you are charged based on the configurations of the instance such as the instance type, disks, and public bandwidth.
29195
+ * * You can call the [CreateInstance](~~25499~~) or [RunInstances](~~63440~~) operation to specify private pool attributes when you create instances. You can also call the [ModifyInstanceAttachmentAttributes](~~190006~~) operation to modify the attributes of a private pool. When an instance matches a private pool associated with a capacity reservation, you are charged based on the configurations of the instance, such as the instance type, disks, and public bandwidth.
29149
29196
  * * Before a capacity reservation is used to create pay-as-you-go instances, you are charged only for the specified instance type.
29150
29197
  * * Savings plans or regional reserved instances can be applied to offset the hourly bills of the unused capacity of immediate capacity reservations and the hourly bills of the instances that are matched to immediate capacity reservations. Zonal reserved instances cannot be applied to offset these bills. We recommend that you purchase reserved instances or savings plans before you purchase immediate capacity reservations. This way, you can have guaranteed access to resources for free within the coverage of the reserved instances or savings plans.
29151
29198
  * > The CreateCapacityReservation operation can be called to create only immediate capacity reservations. You can use the ECS console to create immediate or scheduled capacity reservations. For more information, see [Overview](~~193626#section-oil-qh5-xvx~~).
@@ -29156,9 +29203,9 @@ export default class Client extends OpenApi {
29156
29203
  */
29157
29204
  createCapacityReservationWithOptions(request: CreateCapacityReservationRequest, runtime: $Util.RuntimeOptions): Promise<CreateCapacityReservationResponse>;
29158
29205
  /**
29159
- * When you create a capacity reservation, you can specify attributes such as a zone and an instance type. The system uses a private pool to reserve resources that match the specified attributes. For more information, see [Overview of Immediate Capacity Reservation](~~193633~~).
29206
+ * When you create a capacity reservation, you can specify attributes such as a zone and an instance type. Then, the system uses a private pool to reserve resources that match the specified attributes. For more information, see [Overview of Immediate Capacity Reservation](~~193633~~).
29160
29207
  * * Currently, only immediate capacity reservations are supported. Immediate capacity reservations take effect as soon as they are purchased. After you purchase an immediate capacity reservation, the specified instance type is billed on a pay-as-you-go basis regardless of whether the capacity reservation is actually used to create pay-as-you-go instances. Billing stops until you manually release the capacity reservation or until the capacity reservation expires and is automatically released.
29161
- * * You can call the [CreateInstance](~~25499~~) or [RunInstances](~~63440~~) operation to specify private pool attributes when you create instances. You can also call the [ModifyInstanceAttachmentAttributes](~~190006~~) operation to modify the attributes of a private pool. When an instance matches a private pool associated with a capacity reservation, you are charged based on the configurations of the instance such as the instance type, disks, and public bandwidth.
29208
+ * * You can call the [CreateInstance](~~25499~~) or [RunInstances](~~63440~~) operation to specify private pool attributes when you create instances. You can also call the [ModifyInstanceAttachmentAttributes](~~190006~~) operation to modify the attributes of a private pool. When an instance matches a private pool associated with a capacity reservation, you are charged based on the configurations of the instance, such as the instance type, disks, and public bandwidth.
29162
29209
  * * Before a capacity reservation is used to create pay-as-you-go instances, you are charged only for the specified instance type.
29163
29210
  * * Savings plans or regional reserved instances can be applied to offset the hourly bills of the unused capacity of immediate capacity reservations and the hourly bills of the instances that are matched to immediate capacity reservations. Zonal reserved instances cannot be applied to offset these bills. We recommend that you purchase reserved instances or savings plans before you purchase immediate capacity reservations. This way, you can have guaranteed access to resources for free within the coverage of the reserved instances or savings plans.
29164
29211
  * > The CreateCapacityReservation operation can be called to create only immediate capacity reservations. You can use the ECS console to create immediate or scheduled capacity reservations. For more information, see [Overview](~~193626#section-oil-qh5-xvx~~).
@@ -29316,19 +29363,18 @@ export default class Client extends OpenApi {
29316
29363
  createHpcClusterWithOptions(request: CreateHpcClusterRequest, runtime: $Util.RuntimeOptions): Promise<CreateHpcClusterResponse>;
29317
29364
  createHpcCluster(request: CreateHpcClusterRequest): Promise<CreateHpcClusterResponse>;
29318
29365
  /**
29319
- * ## Description
29320
- * When you call this operation, take note of the following points:
29321
- * * The created custom image can be used only when it is in the Available (Available) state.
29322
- * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}` when you query the information of the instance, the instance is locked for security reasons and all operations are prohibited on it.
29323
- * You can call the CreateImage operation to create a custom image by using one of the following methods. The following request parameters are sorted by priority: `InstanceId` > `DiskDeviceMapping` > `SnapshotId`. If your request contains two or more parameters, the custom image is created based on the parameter that has a higher priority by default.
29324
- * * **Method 1**: Create a custom image from an instance. You need to only specify the instance ID (`InstanceId`). The instance must be in the Running (`Running`) or Stopped (`Stopped`) state. After the CreateImage operation is called, a snapshot is created for each disk of the instance. When you create a custom image from a running instance, some cache data may not be written to the disks. As a result, the data of the created custom image may be slightly inconsistent with that of the instance. We recommend that you create custom images from instances after you stop the instances ([StopInstances](~~155372~~)).
29325
- * * **Method 2**: Create a custom image from the system disk snapshot of an instance. You need to only specify the ID of the system disk snapshot (`SnapshotId`). The specified snapshot cannot be created on or before July 15, 2013.
29326
- * * **Method 3**: Create a custom image from multiple disk snapshots. You must specify the data mapping between the disks and the snapshots (`DiskDeviceMapping`).
29366
+ * When you call this operation, take note of the following items:
29367
+ * * You can use the created custom image only if the image is in the Available (Available) state.
29368
+ * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}`, the instance is locked to ensure security. No operations are allowed on the instance.
29369
+ * You can call the CreateImage operation to create a custom image by using one of the following methods. The following request parameters are sorted by priority: `InstanceId` > `DiskDeviceMapping` > `SnapshotId`. If your request contains two or more of these parameters, the custom image is created based on the parameter that has a higher priority.
29370
+ * * **Method 1**: Create a custom image from an instance. You need to only specify the ID of the instance by using the `InstanceId` parameter. The instance must be in the Running (`Running`) or Stopped (`Stopped`) state. After you call the CreateImage operation, a snapshot is created for each disk of the instance. When you create a custom image from a running instance, specific cache data may not be written to the disks. In this case, the data of the custom image may be slightly different from the data of the instance. We recommend that you create custom images from instances after you stop the instances by calling the [StopInstances](~~155372~~) operation.
29371
+ * * **Method 2**: Create a custom image from the system disk snapshot of an instance. You need to only specify the ID of the system disk snapshot by using the `SnapshotId` parameter. The specified system disk snapshot must be created after July 15, 2013.
29372
+ * * **Method 3**: Create a custom image from multiple disk snapshots. You must specify the data mapping between the disks and the snapshots by calling the `DiskDeviceMapping` operation.
29327
29373
  * When you use Method 3 to create a custom image, take note of the following items:
29328
29374
  * * You can specify only one system disk snapshot. The device name of the system disk must be /dev/xvda.
29329
29375
  * * You can specify multiple data disk snapshots. The device names of the data disks are unique and in alphabetical order from /dev/xvdb to /dev/xvdz.
29330
- * * `SnapshotId` may not be specified. In this case, an empty data disk with a specified size is created.
29331
- * * The specified snapshot cannot be created on or before July 15, 2013.
29376
+ * * You can leave the `SnapshotId` parameter empty. In this case, an empty data disk that has a specified size is created.
29377
+ * * The specified disk snapshot must be created after July 15, 2013.
29332
29378
  *
29333
29379
  * @param request CreateImageRequest
29334
29380
  * @param runtime runtime options for this request RuntimeOptions
@@ -29336,19 +29382,18 @@ export default class Client extends OpenApi {
29336
29382
  */
29337
29383
  createImageWithOptions(request: CreateImageRequest, runtime: $Util.RuntimeOptions): Promise<CreateImageResponse>;
29338
29384
  /**
29339
- * ## Description
29340
- * When you call this operation, take note of the following points:
29341
- * * The created custom image can be used only when it is in the Available (Available) state.
29342
- * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}` when you query the information of the instance, the instance is locked for security reasons and all operations are prohibited on it.
29343
- * You can call the CreateImage operation to create a custom image by using one of the following methods. The following request parameters are sorted by priority: `InstanceId` > `DiskDeviceMapping` > `SnapshotId`. If your request contains two or more parameters, the custom image is created based on the parameter that has a higher priority by default.
29344
- * * **Method 1**: Create a custom image from an instance. You need to only specify the instance ID (`InstanceId`). The instance must be in the Running (`Running`) or Stopped (`Stopped`) state. After the CreateImage operation is called, a snapshot is created for each disk of the instance. When you create a custom image from a running instance, some cache data may not be written to the disks. As a result, the data of the created custom image may be slightly inconsistent with that of the instance. We recommend that you create custom images from instances after you stop the instances ([StopInstances](~~155372~~)).
29345
- * * **Method 2**: Create a custom image from the system disk snapshot of an instance. You need to only specify the ID of the system disk snapshot (`SnapshotId`). The specified snapshot cannot be created on or before July 15, 2013.
29346
- * * **Method 3**: Create a custom image from multiple disk snapshots. You must specify the data mapping between the disks and the snapshots (`DiskDeviceMapping`).
29385
+ * When you call this operation, take note of the following items:
29386
+ * * You can use the created custom image only if the image is in the Available (Available) state.
29387
+ * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}`, the instance is locked to ensure security. No operations are allowed on the instance.
29388
+ * You can call the CreateImage operation to create a custom image by using one of the following methods. The following request parameters are sorted by priority: `InstanceId` > `DiskDeviceMapping` > `SnapshotId`. If your request contains two or more of these parameters, the custom image is created based on the parameter that has a higher priority.
29389
+ * * **Method 1**: Create a custom image from an instance. You need to only specify the ID of the instance by using the `InstanceId` parameter. The instance must be in the Running (`Running`) or Stopped (`Stopped`) state. After you call the CreateImage operation, a snapshot is created for each disk of the instance. When you create a custom image from a running instance, specific cache data may not be written to the disks. In this case, the data of the custom image may be slightly different from the data of the instance. We recommend that you create custom images from instances after you stop the instances by calling the [StopInstances](~~155372~~) operation.
29390
+ * * **Method 2**: Create a custom image from the system disk snapshot of an instance. You need to only specify the ID of the system disk snapshot by using the `SnapshotId` parameter. The specified system disk snapshot must be created after July 15, 2013.
29391
+ * * **Method 3**: Create a custom image from multiple disk snapshots. You must specify the data mapping between the disks and the snapshots by calling the `DiskDeviceMapping` operation.
29347
29392
  * When you use Method 3 to create a custom image, take note of the following items:
29348
29393
  * * You can specify only one system disk snapshot. The device name of the system disk must be /dev/xvda.
29349
29394
  * * You can specify multiple data disk snapshots. The device names of the data disks are unique and in alphabetical order from /dev/xvdb to /dev/xvdz.
29350
- * * `SnapshotId` may not be specified. In this case, an empty data disk with a specified size is created.
29351
- * * The specified snapshot cannot be created on or before July 15, 2013.
29395
+ * * You can leave the `SnapshotId` parameter empty. In this case, an empty data disk that has a specified size is created.
29396
+ * * The specified disk snapshot must be created after July 15, 2013.
29352
29397
  *
29353
29398
  * @param request CreateImageRequest
29354
29399
  * @return CreateImageResponse
@@ -29380,16 +29425,15 @@ export default class Client extends OpenApi {
29380
29425
  */
29381
29426
  createImageComponent(request: CreateImageComponentRequest): Promise<CreateImageComponentResponse>;
29382
29427
  /**
29383
- * ## Description
29384
- * You can use image templates to customize image content and create images across regions and accounts. When you call this operation, take note of the following items:
29428
+ * You can use image templates to specify custom image content and create images across regions and accounts. When you create an image template, take note of the following items:
29385
29429
  * * You can create only custom image templates.
29386
- * * You can configure only public, custom, or shared Linux images or image families as the source images to create custom image templates.
29387
- * * When you use an image template to create an image, you must create an intermediate Elastic Compute Service (ECS) instance to help create the image. The intermediate instance is billed on a pay-as-you-go basis. For more information, see [Pay-as-you-go](~~40653~~).
29430
+ * * You can specify only public, custom, or shared Linux images or image families as source images when you create image templates.
29431
+ * * When you use an image template to create an image, you must create an intermediate instance. You are charged for the intermediate instance based on the pay-as-you-go billing method. For more information, see [Pay-as-you-go](~~40653~~).
29388
29432
  * For the `BuildContent` parameter that specifies the content of image templates, take note of the following items:
29389
- * * If the `BuildContent` value contains `FROM` commands, the values of `BaseImageType` that specifies the type of the source image and `BaseImage` that specifies the source image are overridden by the `FROM` commands.
29390
- * * If the `BuildContent` value does not contain `FROM` commands, the system adds the `FROM` command that consists of the `BaseImageType` and `BaseImage` values to the first line of the template content in the format of `<BaseImageType>:<BaseImage>`.
29391
- * * You can use Dockerfile to edit the content of image templates and then pass the edited content into the `BuildContent` parameter. The content cannot be greater than 16 KB in size, and can contain up to 127 commands. For information about the commands that are supported, see [Commands supported by Image Builder](~~200206~~).
29392
- * You can use image components to create image templates in the ECS console, but cannot call API operations to use image components to create image templates. For more information, see [Overview](~~197410~~).
29433
+ * * If the value of the `BuildContent` parameter contains `FROM` commands, the `FROM` commands override the values of the `BaseImageType` parameter that specifies the type of the source image and the `BaseImage` parameter that specifies the source image.
29434
+ * * If the value of the `BuildContent` parameter does not contain `FROM` commands, the system creates a `FROM` command that consists of the values of the `BaseImageType` and `BaseImage` parameters in the `<BaseImageType>:<BaseImage>` format and adds the command to the first line of the image template content.
29435
+ * * You can use Dockerfile to modify the content of image templates and pass the modified content to the `BuildContent` parameter. The content cannot exceed 16 KB in size and can contain up to 127 commands. For information about the commands that are supported by image templates, see [Description of commands supported by Image Builder](~~200206~~).
29436
+ * You can use image components to create image templates in the Elastic Compute Service (ECS) console. You cannot call API operations to use image components to create image templates. For more information, see [Overview of creating an image](~~197410~~).
29393
29437
  *
29394
29438
  * @param request CreateImagePipelineRequest
29395
29439
  * @param runtime runtime options for this request RuntimeOptions
@@ -29397,16 +29441,15 @@ export default class Client extends OpenApi {
29397
29441
  */
29398
29442
  createImagePipelineWithOptions(request: CreateImagePipelineRequest, runtime: $Util.RuntimeOptions): Promise<CreateImagePipelineResponse>;
29399
29443
  /**
29400
- * ## Description
29401
- * You can use image templates to customize image content and create images across regions and accounts. When you call this operation, take note of the following items:
29444
+ * You can use image templates to specify custom image content and create images across regions and accounts. When you create an image template, take note of the following items:
29402
29445
  * * You can create only custom image templates.
29403
- * * You can configure only public, custom, or shared Linux images or image families as the source images to create custom image templates.
29404
- * * When you use an image template to create an image, you must create an intermediate Elastic Compute Service (ECS) instance to help create the image. The intermediate instance is billed on a pay-as-you-go basis. For more information, see [Pay-as-you-go](~~40653~~).
29446
+ * * You can specify only public, custom, or shared Linux images or image families as source images when you create image templates.
29447
+ * * When you use an image template to create an image, you must create an intermediate instance. You are charged for the intermediate instance based on the pay-as-you-go billing method. For more information, see [Pay-as-you-go](~~40653~~).
29405
29448
  * For the `BuildContent` parameter that specifies the content of image templates, take note of the following items:
29406
- * * If the `BuildContent` value contains `FROM` commands, the values of `BaseImageType` that specifies the type of the source image and `BaseImage` that specifies the source image are overridden by the `FROM` commands.
29407
- * * If the `BuildContent` value does not contain `FROM` commands, the system adds the `FROM` command that consists of the `BaseImageType` and `BaseImage` values to the first line of the template content in the format of `<BaseImageType>:<BaseImage>`.
29408
- * * You can use Dockerfile to edit the content of image templates and then pass the edited content into the `BuildContent` parameter. The content cannot be greater than 16 KB in size, and can contain up to 127 commands. For information about the commands that are supported, see [Commands supported by Image Builder](~~200206~~).
29409
- * You can use image components to create image templates in the ECS console, but cannot call API operations to use image components to create image templates. For more information, see [Overview](~~197410~~).
29449
+ * * If the value of the `BuildContent` parameter contains `FROM` commands, the `FROM` commands override the values of the `BaseImageType` parameter that specifies the type of the source image and the `BaseImage` parameter that specifies the source image.
29450
+ * * If the value of the `BuildContent` parameter does not contain `FROM` commands, the system creates a `FROM` command that consists of the values of the `BaseImageType` and `BaseImage` parameters in the `<BaseImageType>:<BaseImage>` format and adds the command to the first line of the image template content.
29451
+ * * You can use Dockerfile to modify the content of image templates and pass the modified content to the `BuildContent` parameter. The content cannot exceed 16 KB in size and can contain up to 127 commands. For information about the commands that are supported by image templates, see [Description of commands supported by Image Builder](~~200206~~).
29452
+ * You can use image components to create image templates in the Elastic Compute Service (ECS) console. You cannot call API operations to use image components to create image templates. For more information, see [Overview of creating an image](~~197410~~).
29410
29453
  *
29411
29454
  * @param request CreateImagePipelineRequest
29412
29455
  * @return CreateImagePipelineResponse
@@ -29517,12 +29560,13 @@ export default class Client extends OpenApi {
29517
29560
  */
29518
29561
  createKeyPair(request: CreateKeyPairRequest): Promise<CreateKeyPairResponse>;
29519
29562
  /**
29563
+ * ## Description
29520
29564
  * Launch templates contain preset configurations used to create instances, such as the region, image ID, instance type, security group ID, and public bandwidth settings. If a specific parameter is not included in a launch template, you must manually specify the parameter when you use the launch template to create an instance.
29521
29565
  * After you create a launch template (`CreateLaunchTemplate`), its version number is set to 1 by default. You can create multiple versions (`CreateLaunchTemplateVersion`) for the launch template. Version numbers start from 1 and increment by one. If you do not specify a template version number when you use a launch template to create instances ([RunInstances](~~63440~~)), the default version is used.
29522
29566
  * When you call this operation, take note of the following items:
29523
- * * You can create up to 30 launch templates in each region. Each launch template can have up to 30 versions.
29524
- * * Most parameters in launch templates are optional. When you create a launch template, ECS does not verify the existence or validity of specified parameter values. The validity of the parameter values are verified only when you use the launch template to create instances.
29525
- * * If you set a specific parameter in a launch template, you cannot filter out this parameter when you use the launch template to create instances ([RunInstances](~~63440~~)). For example, if you set the `HostName` parameter to LocalHost in a launch template and do not specify the `HostName` parameter when you call the `RunInstances` operation to create instances from the launch template, the instance hostname is still `LocalHost`. If you want to overwrite the `LocalHost` value of HostName provided by the launch template, you can set `HostName` to MyHost or another value when you call the `RunInstances` operation.
29567
+ * * You can create up to 30 launch templates in each region. Each launch template can have up to 30 versions.
29568
+ * * Most parameters in launch templates are optional. When you create a launch template, ECS does not verify the existence or validity of specified parameter values. The validity of the parameter values are verified only when you use the launch template to create instances.
29569
+ * * If you set a specific parameter in a launch template, you cannot filter out this parameter when you use the launch template to create instances ([RunInstances](~~63440~~)). For example, if you set the `HostName` parameter to LocalHost in a launch template and do not set the `HostName` parameter when you call the `RunInstances` operation to create instances from the launch template, the created instance still has a hostname of `LocalHost`. If you want to overwrite the `LocalHost` value of HostName provided by the launch template, you can set `HostName` to MyHost or another value when you call the `RunInstances` operation.
29526
29570
  *
29527
29571
  * @param request CreateLaunchTemplateRequest
29528
29572
  * @param runtime runtime options for this request RuntimeOptions
@@ -29530,18 +29574,20 @@ export default class Client extends OpenApi {
29530
29574
  */
29531
29575
  createLaunchTemplateWithOptions(request: CreateLaunchTemplateRequest, runtime: $Util.RuntimeOptions): Promise<CreateLaunchTemplateResponse>;
29532
29576
  /**
29577
+ * ## Description
29533
29578
  * Launch templates contain preset configurations used to create instances, such as the region, image ID, instance type, security group ID, and public bandwidth settings. If a specific parameter is not included in a launch template, you must manually specify the parameter when you use the launch template to create an instance.
29534
29579
  * After you create a launch template (`CreateLaunchTemplate`), its version number is set to 1 by default. You can create multiple versions (`CreateLaunchTemplateVersion`) for the launch template. Version numbers start from 1 and increment by one. If you do not specify a template version number when you use a launch template to create instances ([RunInstances](~~63440~~)), the default version is used.
29535
29580
  * When you call this operation, take note of the following items:
29536
- * * You can create up to 30 launch templates in each region. Each launch template can have up to 30 versions.
29537
- * * Most parameters in launch templates are optional. When you create a launch template, ECS does not verify the existence or validity of specified parameter values. The validity of the parameter values are verified only when you use the launch template to create instances.
29538
- * * If you set a specific parameter in a launch template, you cannot filter out this parameter when you use the launch template to create instances ([RunInstances](~~63440~~)). For example, if you set the `HostName` parameter to LocalHost in a launch template and do not specify the `HostName` parameter when you call the `RunInstances` operation to create instances from the launch template, the instance hostname is still `LocalHost`. If you want to overwrite the `LocalHost` value of HostName provided by the launch template, you can set `HostName` to MyHost or another value when you call the `RunInstances` operation.
29581
+ * * You can create up to 30 launch templates in each region. Each launch template can have up to 30 versions.
29582
+ * * Most parameters in launch templates are optional. When you create a launch template, ECS does not verify the existence or validity of specified parameter values. The validity of the parameter values are verified only when you use the launch template to create instances.
29583
+ * * If you set a specific parameter in a launch template, you cannot filter out this parameter when you use the launch template to create instances ([RunInstances](~~63440~~)). For example, if you set the `HostName` parameter to LocalHost in a launch template and do not set the `HostName` parameter when you call the `RunInstances` operation to create instances from the launch template, the created instance still has a hostname of `LocalHost`. If you want to overwrite the `LocalHost` value of HostName provided by the launch template, you can set `HostName` to MyHost or another value when you call the `RunInstances` operation.
29539
29584
  *
29540
29585
  * @param request CreateLaunchTemplateRequest
29541
29586
  * @return CreateLaunchTemplateResponse
29542
29587
  */
29543
29588
  createLaunchTemplate(request: CreateLaunchTemplateRequest): Promise<CreateLaunchTemplateResponse>;
29544
29589
  /**
29590
+ * ## Description
29545
29591
  * If you want to modify the parameters of a launch template version, you can create another version with different parameter settings for the launch template. A maximum of 30 versions can be created for each launch template.
29546
29592
  *
29547
29593
  * @param request CreateLaunchTemplateVersionRequest
@@ -29550,6 +29596,7 @@ export default class Client extends OpenApi {
29550
29596
  */
29551
29597
  createLaunchTemplateVersionWithOptions(request: CreateLaunchTemplateVersionRequest, runtime: $Util.RuntimeOptions): Promise<CreateLaunchTemplateVersionResponse>;
29552
29598
  /**
29599
+ * ## Description
29553
29600
  * If you want to modify the parameters of a launch template version, you can create another version with different parameter settings for the launch template. A maximum of 30 versions can be created for each launch template.
29554
29601
  *
29555
29602
  * @param request CreateLaunchTemplateVersionRequest
@@ -29679,8 +29726,8 @@ export default class Client extends OpenApi {
29679
29726
  */
29680
29727
  createRouterInterface(request: CreateRouterInterfaceRequest): Promise<CreateRouterInterfaceResponse>;
29681
29728
  /**
29682
- * When you call this operation, take note of the following points:
29683
- * * You can create up to 100 security groups within a single Alibaba Cloud region.
29729
+ * When you call this operation, take note of the following items:
29730
+ * * You can create up to 100 security groups in each Alibaba Cloud region.
29684
29731
  * * To create a security group of the Virtual Private Cloud (VPC) type, you must specify the VpcId parameter.
29685
29732
  *
29686
29733
  * @param request CreateSecurityGroupRequest
@@ -29689,8 +29736,8 @@ export default class Client extends OpenApi {
29689
29736
  */
29690
29737
  createSecurityGroupWithOptions(request: CreateSecurityGroupRequest, runtime: $Util.RuntimeOptions): Promise<CreateSecurityGroupResponse>;
29691
29738
  /**
29692
- * When you call this operation, take note of the following points:
29693
- * * You can create up to 100 security groups within a single Alibaba Cloud region.
29739
+ * When you call this operation, take note of the following items:
29740
+ * * You can create up to 100 security groups in each Alibaba Cloud region.
29694
29741
  * * To create a security group of the Virtual Private Cloud (VPC) type, you must specify the VpcId parameter.
29695
29742
  *
29696
29743
  * @param request CreateSecurityGroupRequest
@@ -29698,10 +29745,10 @@ export default class Client extends OpenApi {
29698
29745
  */
29699
29746
  createSecurityGroup(request: CreateSecurityGroupRequest): Promise<CreateSecurityGroupResponse>;
29700
29747
  /**
29701
- * You can use the ECS console, call the [](~~63962~~)operation, or use CloudMonitor to view the scheduled simulated system events.
29702
- * The following section describes the lifecycle of a simulated system event:
29748
+ * You can use the ECS console, call [ECS API](~~63962~~) operations, or use CloudMonitor to view the scheduled simulated system events.
29749
+ * A simulated system event can transition between the following lifecycle states:
29703
29750
  * * Scheduled: The state of the simulated system event is automatically changed to Scheduled after it is scheduled.
29704
- * * Executed: The state of the simulated system event is automatically changed to Executed at the scheduled time specified by the NotBefore parameter if no manual intervention is involved.
29751
+ * * Executed: The state of the simulated system event is automatically changed to Executed at the time specified by the NotBefore parameter if no manual intervention is involved.
29705
29752
  * * Canceled: The state of the simulated system event is changed to Canceled if you cancel the event by calling the [CancelSimulatedSystemEvents](~~88808~~) operation.
29706
29753
  * * Avoided: The state of the simulated system event generated from maintenance-triggered instance restart can be changed to Avoided if you restart the instance before the scheduled time of the simulated system event. The maintenance-triggered instance restart is indicated by the SystemMaintenance.Reboot value. For more information, see [RebootInstance](~~25502~~).
29707
29754
  *
@@ -29711,10 +29758,10 @@ export default class Client extends OpenApi {
29711
29758
  */
29712
29759
  createSimulatedSystemEventsWithOptions(request: CreateSimulatedSystemEventsRequest, runtime: $Util.RuntimeOptions): Promise<CreateSimulatedSystemEventsResponse>;
29713
29760
  /**
29714
- * You can use the ECS console, call the [](~~63962~~)operation, or use CloudMonitor to view the scheduled simulated system events.
29715
- * The following section describes the lifecycle of a simulated system event:
29761
+ * You can use the ECS console, call [ECS API](~~63962~~) operations, or use CloudMonitor to view the scheduled simulated system events.
29762
+ * A simulated system event can transition between the following lifecycle states:
29716
29763
  * * Scheduled: The state of the simulated system event is automatically changed to Scheduled after it is scheduled.
29717
- * * Executed: The state of the simulated system event is automatically changed to Executed at the scheduled time specified by the NotBefore parameter if no manual intervention is involved.
29764
+ * * Executed: The state of the simulated system event is automatically changed to Executed at the time specified by the NotBefore parameter if no manual intervention is involved.
29718
29765
  * * Canceled: The state of the simulated system event is changed to Canceled if you cancel the event by calling the [CancelSimulatedSystemEvents](~~88808~~) operation.
29719
29766
  * * Avoided: The state of the simulated system event generated from maintenance-triggered instance restart can be changed to Avoided if you restart the instance before the scheduled time of the simulated system event. The maintenance-triggered instance restart is indicated by the SystemMaintenance.Reboot value. For more information, see [RebootInstance](~~25502~~).
29720
29767
  *
@@ -29723,23 +29770,21 @@ export default class Client extends OpenApi {
29723
29770
  */
29724
29771
  createSimulatedSystemEvents(request: CreateSimulatedSystemEventsRequest): Promise<CreateSimulatedSystemEventsResponse>;
29725
29772
  /**
29726
- * ## Description
29727
29773
  * The local snapshot feature is replaced by the instant access feature.
29728
- * * If you have used the local snapshot feature before December 14, 2020, you can use the `Category` or `InstantAccess` parameter as expected and must take note of the following items:
29774
+ * * If you used the local snapshot feature before December 14, 2020, you can use the `Category` or `InstantAccess` parameter as expected and must take note of the following items:
29729
29775
  * * The `Category` and `InstantAccess` parameters cannot be specified at the same time.
29730
- * * If neither of the `Category` and `InstantAccess` parameters is specified, normal snapshots are created.
29731
- * * If you have not used the local snapshot feature before December 14, 2020, you can use the `InstantAccess` parameter and cannot use the `Category` parameter.
29732
- * For more information, see [Snapshot service upgrade and addition of a new billable item on December 14, 2020](https://help.aliyun.com/noticelist/articleid/1060755542.html).
29733
- * In the following scenarios, you cannot create snapshots for a disk:
29776
+ * * If you do not specify the `Category` or `InstantAccess` parameter, regular snapshots are created.
29777
+ * * If you did not use the local snapshot feature before December 14, 2020, you can use the `InstantAccess` parameter but cannot use the `Category` parameter.
29778
+ * You cannot create snapshots for a disk in the following scenarios:
29734
29779
  * * The number of manual snapshots of the disk has reached 256.
29735
29780
  * * A snapshot is being created for the disk.
29736
- * * The Elastic Compute Service (ECS) instance to which the disk is attached has never been started.
29781
+ * * The instance to which the disk is attached has never been started.
29737
29782
  * * The ECS instance to which the disk is attached is not in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
29738
- * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}` when you query the information of the instance, the instance is locked for security reasons and all operations are prohibited on it.
29783
+ * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}`, the instance is locked for security reasons. No operations are allowed on the instance.
29739
29784
  * When you create a snapshot, take note of the following items:
29740
29785
  * * If a snapshot is being created, you cannot use this snapshot to create a custom image by calling the [CreateImage](~~25535~~) operation.
29741
- * * When a snapshot is being created for a disk that is attached to an ECS instance, do not change the instance state.
29742
- * * You can create snapshots for a disk that is in the **Expired** (`Expired`) state. If the release time scheduled for a disk arrives when a snapshot is being created for the disk, the snapshot is in the **Creating** (`Creating`) state and is deleted when the disk is released.
29786
+ * * When a snapshot is being created for a disk that is attached to an instance, do not change the instance state.
29787
+ * * You can create snapshots for a disk that is in the **Expired** (`Expired`) state. If the release time that is scheduled for a disk arrives when a snapshot is being created for the disk, the snapshot is in the **Creating** (`Creating`) state and is deleted when the disk is released.
29743
29788
  *
29744
29789
  * @param request CreateSnapshotRequest
29745
29790
  * @param runtime runtime options for this request RuntimeOptions
@@ -29747,32 +29792,29 @@ export default class Client extends OpenApi {
29747
29792
  */
29748
29793
  createSnapshotWithOptions(request: CreateSnapshotRequest, runtime: $Util.RuntimeOptions): Promise<CreateSnapshotResponse>;
29749
29794
  /**
29750
- * ## Description
29751
29795
  * The local snapshot feature is replaced by the instant access feature.
29752
- * * If you have used the local snapshot feature before December 14, 2020, you can use the `Category` or `InstantAccess` parameter as expected and must take note of the following items:
29796
+ * * If you used the local snapshot feature before December 14, 2020, you can use the `Category` or `InstantAccess` parameter as expected and must take note of the following items:
29753
29797
  * * The `Category` and `InstantAccess` parameters cannot be specified at the same time.
29754
- * * If neither of the `Category` and `InstantAccess` parameters is specified, normal snapshots are created.
29755
- * * If you have not used the local snapshot feature before December 14, 2020, you can use the `InstantAccess` parameter and cannot use the `Category` parameter.
29756
- * For more information, see [Snapshot service upgrade and addition of a new billable item on December 14, 2020](https://help.aliyun.com/noticelist/articleid/1060755542.html).
29757
- * In the following scenarios, you cannot create snapshots for a disk:
29798
+ * * If you do not specify the `Category` or `InstantAccess` parameter, regular snapshots are created.
29799
+ * * If you did not use the local snapshot feature before December 14, 2020, you can use the `InstantAccess` parameter but cannot use the `Category` parameter.
29800
+ * You cannot create snapshots for a disk in the following scenarios:
29758
29801
  * * The number of manual snapshots of the disk has reached 256.
29759
29802
  * * A snapshot is being created for the disk.
29760
- * * The Elastic Compute Service (ECS) instance to which the disk is attached has never been started.
29803
+ * * The instance to which the disk is attached has never been started.
29761
29804
  * * The ECS instance to which the disk is attached is not in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
29762
- * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}` when you query the information of the instance, the instance is locked for security reasons and all operations are prohibited on it.
29805
+ * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}`, the instance is locked for security reasons. No operations are allowed on the instance.
29763
29806
  * When you create a snapshot, take note of the following items:
29764
29807
  * * If a snapshot is being created, you cannot use this snapshot to create a custom image by calling the [CreateImage](~~25535~~) operation.
29765
- * * When a snapshot is being created for a disk that is attached to an ECS instance, do not change the instance state.
29766
- * * You can create snapshots for a disk that is in the **Expired** (`Expired`) state. If the release time scheduled for a disk arrives when a snapshot is being created for the disk, the snapshot is in the **Creating** (`Creating`) state and is deleted when the disk is released.
29808
+ * * When a snapshot is being created for a disk that is attached to an instance, do not change the instance state.
29809
+ * * You can create snapshots for a disk that is in the **Expired** (`Expired`) state. If the release time that is scheduled for a disk arrives when a snapshot is being created for the disk, the snapshot is in the **Creating** (`Creating`) state and is deleted when the disk is released.
29767
29810
  *
29768
29811
  * @param request CreateSnapshotRequest
29769
29812
  * @return CreateSnapshotResponse
29770
29813
  */
29771
29814
  createSnapshot(request: CreateSnapshotRequest): Promise<CreateSnapshotResponse>;
29772
29815
  /**
29773
- * ## Description
29774
- * You can specify `InstanceId` to create a snapshot-consistent group for the specified disks in an instance. You can also specify `DiskId.N` to create a snapshot-consistent group for multiple disks that are attached to multiple instances within the same zone.
29775
- * > You cannot specify both `DiskId.N` and `ExcludeDiskId.N`. If `InstanceId` is set, you can use `DiskId.N` to specify only disks attached to the instance specified by InstanceId. You cannot use DiskId.N to specify disks attached to multiple instances.
29816
+ * You can specify `InstanceId` to create a snapshot-consistent group for the specified disks of the instance. You can also specify `DiskId.N` to create a snapshot-consistent group for multiple disks that are attached to multiple instances within the same zone.
29817
+ * > You cannot specify both `DiskId.N` and `ExcludeDiskId.N`. If `InstanceId` is specified, `DiskId.N` is only used to specify the disks that are attached to the instance specified by InstanceId.
29776
29818
  * When you call this operation, take note of the following items:
29777
29819
  * * The disk for which you want to create a snapshot must be in the **In Use** (`In_use`) or **Unattached** (`Available`) state.
29778
29820
  * * If the disk is in the **In Use** (`In_use`) state, the instance to which the disk is attached must be in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
@@ -29780,7 +29822,7 @@ export default class Client extends OpenApi {
29780
29822
  * * The snapshot-consistent group feature can be used to create snapshots only for enhanced SSDs (ESSDs).
29781
29823
  * * A single snapshot-consistent group can contain snapshots of up to 16 disks including the system disk and data disks and cannot exceed 32 TiB in size.
29782
29824
  * * Snapshots that you created by using the snapshot-consistent group feature are retained until they are deleted. We recommend that you delete unnecessary snapshots on a regular basis to prevent them from incurring excessive fees.
29783
- * * Snapshot-consistent groups cannot be created for disks that have the multi-attach feature enabled. If disks that have the multi-attach feature enabled are attached to an instance, you must set the `ExcludeDiskId.N` parameter to exclude these disks.
29825
+ * * Snapshot-consistent groups cannot be created for disks that have the multi-attach feature enabled. If disks that have the multi-attach feature enabled are attached to the instance for which you want to create a snapshot-consistent group, you must set the `ExcludeDiskId.N` parameter to exclude these disks.
29784
29826
  * For information about the snapshot-consistent group feature and its billing, see [Create a snapshot-consistent group](~~199625~~).
29785
29827
  *
29786
29828
  * @param request CreateSnapshotGroupRequest
@@ -29789,9 +29831,8 @@ export default class Client extends OpenApi {
29789
29831
  */
29790
29832
  createSnapshotGroupWithOptions(request: CreateSnapshotGroupRequest, runtime: $Util.RuntimeOptions): Promise<CreateSnapshotGroupResponse>;
29791
29833
  /**
29792
- * ## Description
29793
- * You can specify `InstanceId` to create a snapshot-consistent group for the specified disks in an instance. You can also specify `DiskId.N` to create a snapshot-consistent group for multiple disks that are attached to multiple instances within the same zone.
29794
- * > You cannot specify both `DiskId.N` and `ExcludeDiskId.N`. If `InstanceId` is set, you can use `DiskId.N` to specify only disks attached to the instance specified by InstanceId. You cannot use DiskId.N to specify disks attached to multiple instances.
29834
+ * You can specify `InstanceId` to create a snapshot-consistent group for the specified disks of the instance. You can also specify `DiskId.N` to create a snapshot-consistent group for multiple disks that are attached to multiple instances within the same zone.
29835
+ * > You cannot specify both `DiskId.N` and `ExcludeDiskId.N`. If `InstanceId` is specified, `DiskId.N` is only used to specify the disks that are attached to the instance specified by InstanceId.
29795
29836
  * When you call this operation, take note of the following items:
29796
29837
  * * The disk for which you want to create a snapshot must be in the **In Use** (`In_use`) or **Unattached** (`Available`) state.
29797
29838
  * * If the disk is in the **In Use** (`In_use`) state, the instance to which the disk is attached must be in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
@@ -29799,7 +29840,7 @@ export default class Client extends OpenApi {
29799
29840
  * * The snapshot-consistent group feature can be used to create snapshots only for enhanced SSDs (ESSDs).
29800
29841
  * * A single snapshot-consistent group can contain snapshots of up to 16 disks including the system disk and data disks and cannot exceed 32 TiB in size.
29801
29842
  * * Snapshots that you created by using the snapshot-consistent group feature are retained until they are deleted. We recommend that you delete unnecessary snapshots on a regular basis to prevent them from incurring excessive fees.
29802
- * * Snapshot-consistent groups cannot be created for disks that have the multi-attach feature enabled. If disks that have the multi-attach feature enabled are attached to an instance, you must set the `ExcludeDiskId.N` parameter to exclude these disks.
29843
+ * * Snapshot-consistent groups cannot be created for disks that have the multi-attach feature enabled. If disks that have the multi-attach feature enabled are attached to the instance for which you want to create a snapshot-consistent group, you must set the `ExcludeDiskId.N` parameter to exclude these disks.
29803
29844
  * For information about the snapshot-consistent group feature and its billing, see [Create a snapshot-consistent group](~~199625~~).
29804
29845
  *
29805
29846
  * @param request CreateSnapshotGroupRequest
@@ -29807,7 +29848,6 @@ export default class Client extends OpenApi {
29807
29848
  */
29808
29849
  createSnapshotGroup(request: CreateSnapshotGroupRequest): Promise<CreateSnapshotGroupResponse>;
29809
29850
  /**
29810
- * ## Description
29811
29851
  * A storage set can distribute disks or Shared Block Storage devices to different locations. You can specify the number of partitions in a storage set. A larger number of partitions indicate more discrete distribution of disks or Shared Block Storage devices.
29812
29852
  * When you call this operation, take note of the following items:
29813
29853
  * * A limitation exists on the number of storage sets that you can create in a region. You can call the [DescribeAccountAttributes](~~73772~~) operation to query the allowed number of storage sets in a region.
@@ -29819,7 +29859,6 @@ export default class Client extends OpenApi {
29819
29859
  */
29820
29860
  createStorageSetWithOptions(request: CreateStorageSetRequest, runtime: $Util.RuntimeOptions): Promise<CreateStorageSetResponse>;
29821
29861
  /**
29822
- * ## Description
29823
29862
  * A storage set can distribute disks or Shared Block Storage devices to different locations. You can specify the number of partitions in a storage set. A larger number of partitions indicate more discrete distribution of disks or Shared Block Storage devices.
29824
29863
  * When you call this operation, take note of the following items:
29825
29864
  * * A limitation exists on the number of storage sets that you can create in a region. You can call the [DescribeAccountAttributes](~~73772~~) operation to query the allowed number of storage sets in a region.
@@ -30086,14 +30125,14 @@ export default class Client extends OpenApi {
30086
30125
  */
30087
30126
  deleteInstance(request: DeleteInstanceRequest): Promise<DeleteInstanceResponse>;
30088
30127
  /**
30089
- * * After an instance is released, all the physical resources used by the instance are recycled. Relevant data is erased and cannot be restored.
30128
+ * * After an instance is released, all the physical resources used by the instance are recycled. Relevant data is erased and cannot be recovered.
30090
30129
  * * Disks attached to the instance:
30091
30130
  * * The disks for which `DeleteWithInstance` is set to false are retained as pay-as-you-go disks.
30092
30131
  * * The disks for which `DeleteWithInstance` is set to true are released along with the instance.
30093
30132
  * * For disks for which `DeleteAutoSnapshot` is set to false, the automatic snapshots of the disks are retained.
30094
30133
  * * For disks for which `DeleteAutoSnapshot` is set to true, the automatic snapshots of the disks are released.
30095
30134
  * * Manual snapshots of the disks are retained.
30096
- * * If `OperationLocks` in the DeleteInstances response contains `"LockReason" : "security"` for an instance, the instance is locked for security reasons. Even if the `DeleteWithInstance` parameter is set to `false` for the data disks that are attached to the instance, the parameter is ignored and the data disks are released along with the instance. For more information, see [API behavior when an instance is locked for security reasons](~~25695~~).
30135
+ * * If `OperationLocks` in the DescribeInstances response contains `"LockReason" : "security"` for an instance, the instance is locked for security reasons. Even if the `DeleteWithInstance` parameter is set to `false` for the data disks that are attached to the instance, this parameter is ignored and the data disks are released along with the instance. For more information, see [API behavior when an instance is locked for security reasons](~~25695~~).
30097
30136
  *
30098
30137
  * @param request DeleteInstancesRequest
30099
30138
  * @param runtime runtime options for this request RuntimeOptions
@@ -30101,14 +30140,14 @@ export default class Client extends OpenApi {
30101
30140
  */
30102
30141
  deleteInstancesWithOptions(request: DeleteInstancesRequest, runtime: $Util.RuntimeOptions): Promise<DeleteInstancesResponse>;
30103
30142
  /**
30104
- * * After an instance is released, all the physical resources used by the instance are recycled. Relevant data is erased and cannot be restored.
30143
+ * * After an instance is released, all the physical resources used by the instance are recycled. Relevant data is erased and cannot be recovered.
30105
30144
  * * Disks attached to the instance:
30106
30145
  * * The disks for which `DeleteWithInstance` is set to false are retained as pay-as-you-go disks.
30107
30146
  * * The disks for which `DeleteWithInstance` is set to true are released along with the instance.
30108
30147
  * * For disks for which `DeleteAutoSnapshot` is set to false, the automatic snapshots of the disks are retained.
30109
30148
  * * For disks for which `DeleteAutoSnapshot` is set to true, the automatic snapshots of the disks are released.
30110
30149
  * * Manual snapshots of the disks are retained.
30111
- * * If `OperationLocks` in the DeleteInstances response contains `"LockReason" : "security"` for an instance, the instance is locked for security reasons. Even if the `DeleteWithInstance` parameter is set to `false` for the data disks that are attached to the instance, the parameter is ignored and the data disks are released along with the instance. For more information, see [API behavior when an instance is locked for security reasons](~~25695~~).
30150
+ * * If `OperationLocks` in the DescribeInstances response contains `"LockReason" : "security"` for an instance, the instance is locked for security reasons. Even if the `DeleteWithInstance` parameter is set to `false` for the data disks that are attached to the instance, this parameter is ignored and the data disks are released along with the instance. For more information, see [API behavior when an instance is locked for security reasons](~~25695~~).
30112
30151
  *
30113
30152
  * @param request DeleteInstancesRequest
30114
30153
  * @return DeleteInstancesResponse
@@ -30157,8 +30196,15 @@ export default class Client extends OpenApi {
30157
30196
  * * The ENI must be in the Available state.
30158
30197
  * * If the ENI is bound to an ECS instance, you must unbind the ENI from the ECS instance ([DetachNetworkInterface](~~58514~~)) before you can delete the ENI.
30159
30198
  * * After an ENI is deleted:
30160
- * * The primary private IP address of the ENI is automatically released.
30199
+ * * All the private IP addresses (including primary and secondary private IP addresses) of the ENI are automatically released.
30161
30200
  * * The ENI is automatically removed from its security groups.
30201
+ * * This operation is an asynchronous operation. After this operation is called to delete an ENI, you can check the state or events of the ENI to determine whether the ENI is deleted. The following figure shows the transitions between the states of the ENI.
30202
+ *
30203
+ * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/en-US/20230223/krcd/DeleteNetworkInterface.png)
30204
+ * * If the ENI is in the Deleting state, the ENI deletion request is sent and the ENI is being deleted.
30205
+ * * If the ENI is not found, the ENI is deleted.
30206
+ * * If the ENI is stuck in the Deleting state, the ENI fails to be deleted and you can re-initiate the request to delete the ENI.
30207
+ * For information about examples on how to call this operation, see [Delete an ENI](~~471553~~).
30162
30208
  *
30163
30209
  * @param request DeleteNetworkInterfaceRequest
30164
30210
  * @param runtime runtime options for this request RuntimeOptions
@@ -30170,8 +30216,15 @@ export default class Client extends OpenApi {
30170
30216
  * * The ENI must be in the Available state.
30171
30217
  * * If the ENI is bound to an ECS instance, you must unbind the ENI from the ECS instance ([DetachNetworkInterface](~~58514~~)) before you can delete the ENI.
30172
30218
  * * After an ENI is deleted:
30173
- * * The primary private IP address of the ENI is automatically released.
30219
+ * * All the private IP addresses (including primary and secondary private IP addresses) of the ENI are automatically released.
30174
30220
  * * The ENI is automatically removed from its security groups.
30221
+ * * This operation is an asynchronous operation. After this operation is called to delete an ENI, you can check the state or events of the ENI to determine whether the ENI is deleted. The following figure shows the transitions between the states of the ENI.
30222
+ *
30223
+ * ![](https://static-aliyun-doc.oss-cn-hangzhou.aliyuncs.com/file-manage-files/en-US/20230223/krcd/DeleteNetworkInterface.png)
30224
+ * * If the ENI is in the Deleting state, the ENI deletion request is sent and the ENI is being deleted.
30225
+ * * If the ENI is not found, the ENI is deleted.
30226
+ * * If the ENI is stuck in the Deleting state, the ENI fails to be deleted and you can re-initiate the request to delete the ENI.
30227
+ * For information about examples on how to call this operation, see [Delete an ENI](~~471553~~).
30175
30228
  *
30176
30229
  * @param request DeleteNetworkInterfaceRequest
30177
30230
  * @return DeleteNetworkInterfaceResponse
@@ -30270,11 +30323,10 @@ export default class Client extends OpenApi {
30270
30323
  */
30271
30324
  deleteSecurityGroup(request: DeleteSecurityGroupRequest): Promise<DeleteSecurityGroupResponse>;
30272
30325
  /**
30273
- * ## Description
30274
30326
  * When you call this operation, take note of the following items:
30275
- * * If the specified snapshot ID does not exist, the request is ignored.
30276
- * * A snapshot that has been used to create custom images cannot be deleted. The snapshot can be deleted only after the created custom images are deleted ([DeleteImage](~~25537~~)).
30277
- * * A snapshot that has been used to create disks cannot be deleted. If you do want to delete the snapshot, set the `Force` parameter to true to force delete the snapshot. The disks created from the snapshot cannot be re-initialized after the snapshot is force deleted.
30327
+ * * If the specified snapshot does not exist, the request is ignored.
30328
+ * * If the specified snapshot has been used to create custom images, the snapshot cannot be deleted. You must call the [DeleteImage](~~25537~~) operation to delete the custom images before you can delete the snapshot.
30329
+ * * If the specified snapshot has been used to create disks and the `Force` parameter is not specified or is set to `false`, the snapshot cannot be deleted directly. If you want to delete the snapshot, set the `Force` parameter to true to forcefully delete the snapshot. The disks created from the snapshot cannot be re-initialized after the snapshot is forcefully deleted.
30278
30330
  *
30279
30331
  * @param request DeleteSnapshotRequest
30280
30332
  * @param runtime runtime options for this request RuntimeOptions
@@ -30282,11 +30334,10 @@ export default class Client extends OpenApi {
30282
30334
  */
30283
30335
  deleteSnapshotWithOptions(request: DeleteSnapshotRequest, runtime: $Util.RuntimeOptions): Promise<DeleteSnapshotResponse>;
30284
30336
  /**
30285
- * ## Description
30286
30337
  * When you call this operation, take note of the following items:
30287
- * * If the specified snapshot ID does not exist, the request is ignored.
30288
- * * A snapshot that has been used to create custom images cannot be deleted. The snapshot can be deleted only after the created custom images are deleted ([DeleteImage](~~25537~~)).
30289
- * * A snapshot that has been used to create disks cannot be deleted. If you do want to delete the snapshot, set the `Force` parameter to true to force delete the snapshot. The disks created from the snapshot cannot be re-initialized after the snapshot is force deleted.
30338
+ * * If the specified snapshot does not exist, the request is ignored.
30339
+ * * If the specified snapshot has been used to create custom images, the snapshot cannot be deleted. You must call the [DeleteImage](~~25537~~) operation to delete the custom images before you can delete the snapshot.
30340
+ * * If the specified snapshot has been used to create disks and the `Force` parameter is not specified or is set to `false`, the snapshot cannot be deleted directly. If you want to delete the snapshot, set the `Force` parameter to true to forcefully delete the snapshot. The disks created from the snapshot cannot be re-initialized after the snapshot is forcefully deleted.
30290
30341
  *
30291
30342
  * @param request DeleteSnapshotRequest
30292
30343
  * @return DeleteSnapshotResponse
@@ -30562,7 +30613,20 @@ export default class Client extends OpenApi {
30562
30613
  * @return DescribeDemandsResponse
30563
30614
  */
30564
30615
  describeDemands(request: DescribeDemandsRequest): Promise<DescribeDemandsResponse>;
30616
+ /**
30617
+ * For more information about instance families, see [Instance families](~~25378~~).
30618
+ *
30619
+ * @param request DescribeDeploymentSetSupportedInstanceTypeFamilyRequest
30620
+ * @param runtime runtime options for this request RuntimeOptions
30621
+ * @return DescribeDeploymentSetSupportedInstanceTypeFamilyResponse
30622
+ */
30565
30623
  describeDeploymentSetSupportedInstanceTypeFamilyWithOptions(request: DescribeDeploymentSetSupportedInstanceTypeFamilyRequest, runtime: $Util.RuntimeOptions): Promise<DescribeDeploymentSetSupportedInstanceTypeFamilyResponse>;
30624
+ /**
30625
+ * For more information about instance families, see [Instance families](~~25378~~).
30626
+ *
30627
+ * @param request DescribeDeploymentSetSupportedInstanceTypeFamilyRequest
30628
+ * @return DescribeDeploymentSetSupportedInstanceTypeFamilyResponse
30629
+ */
30566
30630
  describeDeploymentSetSupportedInstanceTypeFamily(request: DescribeDeploymentSetSupportedInstanceTypeFamilyRequest): Promise<DescribeDeploymentSetSupportedInstanceTypeFamilyResponse>;
30567
30631
  describeDeploymentSetsWithOptions(request: DescribeDeploymentSetsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeDeploymentSetsResponse>;
30568
30632
  describeDeploymentSets(request: DescribeDeploymentSetsRequest): Promise<DescribeDeploymentSetsResponse>;
@@ -30628,22 +30692,7 @@ export default class Client extends OpenApi {
30628
30692
  * @return DescribeDisksResponse
30629
30693
  */
30630
30694
  describeDisks(request: DescribeDisksRequest): Promise<DescribeDisksResponse>;
30631
- /**
30632
- * * The full status information of an EBS device includes the lifecycle status provided by the `Status` parameter, health status provided by the `HealthStatus` parameter, and event type provided by the `EventType` parameter of the EBS device. You can filter the results based on these parameters.
30633
- * * The release time, scheduled execution time, and actual execution time of each EBS device event are identical. If you specify a period of time by using the `EventTime.Start` and `EventTime.End` parameters, all events that occurred within this period are queried. You can query events that occurred within the last seven days.
30634
- *
30635
- * @param request DescribeDisksFullStatusRequest
30636
- * @param runtime runtime options for this request RuntimeOptions
30637
- * @return DescribeDisksFullStatusResponse
30638
- */
30639
30695
  describeDisksFullStatusWithOptions(request: DescribeDisksFullStatusRequest, runtime: $Util.RuntimeOptions): Promise<DescribeDisksFullStatusResponse>;
30640
- /**
30641
- * * The full status information of an EBS device includes the lifecycle status provided by the `Status` parameter, health status provided by the `HealthStatus` parameter, and event type provided by the `EventType` parameter of the EBS device. You can filter the results based on these parameters.
30642
- * * The release time, scheduled execution time, and actual execution time of each EBS device event are identical. If you specify a period of time by using the `EventTime.Start` and `EventTime.End` parameters, all events that occurred within this period are queried. You can query events that occurred within the last seven days.
30643
- *
30644
- * @param request DescribeDisksFullStatusRequest
30645
- * @return DescribeDisksFullStatusResponse
30646
- */
30647
30696
  describeDisksFullStatus(request: DescribeDisksFullStatusRequest): Promise<DescribeDisksFullStatusResponse>;
30648
30697
  /**
30649
30698
  * @deprecated
@@ -30676,7 +30725,7 @@ export default class Client extends OpenApi {
30676
30725
  */
30677
30726
  describeEipMonitorData(request: DescribeEipMonitorDataRequest): Promise<DescribeEipMonitorDataResponse>;
30678
30727
  /**
30679
- * When an elasticity assurance expires, data about the association between instances and the private pool generated by the elasticity assurance becomes invalid. If you call this operation to query the expired elasticity assurance, no value is returned.
30728
+ * When an elasticity assurance expires, data about the association between instances and the private pool generated by the elasticity assurance becomes invalid. When you call this operation to query the expired elasticity assurance, no value is returned.
30680
30729
  *
30681
30730
  * @param request DescribeElasticityAssuranceInstancesRequest
30682
30731
  * @param runtime runtime options for this request RuntimeOptions
@@ -30684,7 +30733,7 @@ export default class Client extends OpenApi {
30684
30733
  */
30685
30734
  describeElasticityAssuranceInstancesWithOptions(request: DescribeElasticityAssuranceInstancesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeElasticityAssuranceInstancesResponse>;
30686
30735
  /**
30687
- * When an elasticity assurance expires, data about the association between instances and the private pool generated by the elasticity assurance becomes invalid. If you call this operation to query the expired elasticity assurance, no value is returned.
30736
+ * When an elasticity assurance expires, data about the association between instances and the private pool generated by the elasticity assurance becomes invalid. When you call this operation to query the expired elasticity assurance, no value is returned.
30688
30737
  *
30689
30738
  * @param request DescribeElasticityAssuranceInstancesRequest
30690
30739
  * @return DescribeElasticityAssuranceInstancesResponse
@@ -30692,7 +30741,26 @@ export default class Client extends OpenApi {
30692
30741
  describeElasticityAssuranceInstances(request: DescribeElasticityAssuranceInstancesRequest): Promise<DescribeElasticityAssuranceInstancesResponse>;
30693
30742
  describeElasticityAssurancesWithOptions(request: DescribeElasticityAssurancesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeElasticityAssurancesResponse>;
30694
30743
  describeElasticityAssurances(request: DescribeElasticityAssurancesRequest): Promise<DescribeElasticityAssurancesResponse>;
30744
+ /**
30745
+ * ## Description
30746
+ * The monitored data includes traffic sent and received over the internal network, the number of packets sent and received by the secondary ENI, and the number of dropped packets sent and received by the secondary ENI. Specific information may be missing from the returned monitored data. This is because the system cannot obtain the relevant information. For example, if the instance to which the secondary ENI is bound is in the Stopped state, or if the secondary ENI is not bound to an instance and is in the Available state, the monitored data of the secondary ENI cannot be obtained. When you call this operation, take note of the following items:
30747
+ * * Up to 400 monitored data entries can be returned at a time. If the value calculated by using the (EndTime - StartTime)/Period formula is greater than 400, an error is returned.
30748
+ * * Only the monitored data within the last 30 days can be queried. If the value of the StartTime parameter is earlier than 30 days from the time when you call this operation, an error is returned.
30749
+ *
30750
+ * @param request DescribeEniMonitorDataRequest
30751
+ * @param runtime runtime options for this request RuntimeOptions
30752
+ * @return DescribeEniMonitorDataResponse
30753
+ */
30695
30754
  describeEniMonitorDataWithOptions(request: DescribeEniMonitorDataRequest, runtime: $Util.RuntimeOptions): Promise<DescribeEniMonitorDataResponse>;
30755
+ /**
30756
+ * ## Description
30757
+ * The monitored data includes traffic sent and received over the internal network, the number of packets sent and received by the secondary ENI, and the number of dropped packets sent and received by the secondary ENI. Specific information may be missing from the returned monitored data. This is because the system cannot obtain the relevant information. For example, if the instance to which the secondary ENI is bound is in the Stopped state, or if the secondary ENI is not bound to an instance and is in the Available state, the monitored data of the secondary ENI cannot be obtained. When you call this operation, take note of the following items:
30758
+ * * Up to 400 monitored data entries can be returned at a time. If the value calculated by using the (EndTime - StartTime)/Period formula is greater than 400, an error is returned.
30759
+ * * Only the monitored data within the last 30 days can be queried. If the value of the StartTime parameter is earlier than 30 days from the time when you call this operation, an error is returned.
30760
+ *
30761
+ * @param request DescribeEniMonitorDataRequest
30762
+ * @return DescribeEniMonitorDataResponse
30763
+ */
30696
30764
  describeEniMonitorData(request: DescribeEniMonitorDataRequest): Promise<DescribeEniMonitorDataResponse>;
30697
30765
  /**
30698
30766
  * @deprecated
@@ -30779,29 +30847,17 @@ export default class Client extends OpenApi {
30779
30847
  * @return DescribeImagePipelineExecutionsResponse
30780
30848
  */
30781
30849
  describeImagePipelineExecutions(request: DescribeImagePipelineExecutionsRequest): Promise<DescribeImagePipelineExecutionsResponse>;
30782
- /**
30783
- * You can use `NextToken` to configure the query token. Set the value to the `NextToken` value that is returned in the last call to the `DescribeImagePipelines` operation. Then, use `MaxResults` to specify the maximum number of entries to return on each page.
30784
- *
30785
- * @param request DescribeImagePipelinesRequest
30786
- * @param runtime runtime options for this request RuntimeOptions
30787
- * @return DescribeImagePipelinesResponse
30788
- */
30789
30850
  describeImagePipelinesWithOptions(request: DescribeImagePipelinesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeImagePipelinesResponse>;
30790
- /**
30791
- * You can use `NextToken` to configure the query token. Set the value to the `NextToken` value that is returned in the last call to the `DescribeImagePipelines` operation. Then, use `MaxResults` to specify the maximum number of entries to return on each page.
30792
- *
30793
- * @param request DescribeImagePipelinesRequest
30794
- * @return DescribeImagePipelinesResponse
30795
- */
30796
30851
  describeImagePipelines(request: DescribeImagePipelinesRequest): Promise<DescribeImagePipelinesResponse>;
30797
30852
  describeImageSharePermissionWithOptions(request: DescribeImageSharePermissionRequest, runtime: $Util.RuntimeOptions): Promise<DescribeImageSharePermissionResponse>;
30798
30853
  describeImageSharePermission(request: DescribeImageSharePermissionRequest): Promise<DescribeImageSharePermissionResponse>;
30799
30854
  describeImageSupportInstanceTypesWithOptions(request: DescribeImageSupportInstanceTypesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeImageSupportInstanceTypesResponse>;
30800
30855
  describeImageSupportInstanceTypes(request: DescribeImageSupportInstanceTypesRequest): Promise<DescribeImageSupportInstanceTypesResponse>;
30801
30856
  /**
30802
- * * You can query your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images from other Alibaba Cloud accounts.
30803
- * * This operation supports paged query. The response contains the total number of available images and the images on the returned page. By default, ten entries are displayed on each page.
30804
- * * When you call an API operation by using Alibaba Cloud CLI, you must specify request parameter values of different data types in the required formats. For more information, see [Parameter format overview](~~110340~~).
30857
+ * ## Description
30858
+ * * You can query public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, custom images in your repository, and shared images from other Alibaba Cloud accounts.
30859
+ * * This is a paginated query. The response contains the total number of available images and the images on the returned page. By default, 10 entries are displayed on each page.
30860
+ * * When you call an API operation by using Alibaba Cloud CLI, you must specify request parameter values of different data types in required formats. For more information, see [Parameter format overview](~~110340~~).
30805
30861
  *
30806
30862
  * @param request DescribeImagesRequest
30807
30863
  * @param runtime runtime options for this request RuntimeOptions
@@ -30809,9 +30865,10 @@ export default class Client extends OpenApi {
30809
30865
  */
30810
30866
  describeImagesWithOptions(request: DescribeImagesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeImagesResponse>;
30811
30867
  /**
30812
- * * You can query your custom images, public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, and shared images from other Alibaba Cloud accounts.
30813
- * * This operation supports paged query. The response contains the total number of available images and the images on the returned page. By default, ten entries are displayed on each page.
30814
- * * When you call an API operation by using Alibaba Cloud CLI, you must specify request parameter values of different data types in the required formats. For more information, see [Parameter format overview](~~110340~~).
30868
+ * ## Description
30869
+ * * You can query public images provided by Alibaba Cloud, Alibaba Cloud Marketplace images, custom images in your repository, and shared images from other Alibaba Cloud accounts.
30870
+ * * This is a paginated query. The response contains the total number of available images and the images on the returned page. By default, 10 entries are displayed on each page.
30871
+ * * When you call an API operation by using Alibaba Cloud CLI, you must specify request parameter values of different data types in required formats. For more information, see [Parameter format overview](~~110340~~).
30815
30872
  *
30816
30873
  * @param request DescribeImagesRequest
30817
30874
  * @return DescribeImagesResponse
@@ -30834,20 +30891,7 @@ export default class Client extends OpenApi {
30834
30891
  * @return DescribeInstanceAttachmentAttributesResponse
30835
30892
  */
30836
30893
  describeInstanceAttachmentAttributes(request: DescribeInstanceAttachmentAttributesRequest): Promise<DescribeInstanceAttachmentAttributesResponse>;
30837
- /**
30838
- * @deprecated
30839
- *
30840
- * @param request DescribeInstanceAttributeRequest
30841
- * @param runtime runtime options for this request RuntimeOptions
30842
- * @return DescribeInstanceAttributeResponse
30843
- */
30844
30894
  describeInstanceAttributeWithOptions(request: DescribeInstanceAttributeRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstanceAttributeResponse>;
30845
- /**
30846
- * @deprecated
30847
- *
30848
- * @param request DescribeInstanceAttributeRequest
30849
- * @return DescribeInstanceAttributeResponse
30850
- */
30851
30895
  describeInstanceAttribute(request: DescribeInstanceAttributeRequest): Promise<DescribeInstanceAttributeResponse>;
30852
30896
  /**
30853
30897
  * * Before you configure auto-renewal or manual renewal for subscription instances, you can query the auto-renewal status of the instances.
@@ -30867,6 +30911,7 @@ export default class Client extends OpenApi {
30867
30911
  */
30868
30912
  describeInstanceAutoRenewAttribute(request: DescribeInstanceAutoRenewAttributeRequest): Promise<DescribeInstanceAutoRenewAttributeResponse>;
30869
30913
  /**
30914
+ * ## Description
30870
30915
  * * You can query system events that were finished within the last 30 days. The time range for querying unfinished system events is unlimited.
30871
30916
  * * You can also specify the InstanceEventCycleStatus.N parameter to query the system events that are in the Scheduled, Executing, or Inquiring state.
30872
30917
  *
@@ -30876,6 +30921,7 @@ export default class Client extends OpenApi {
30876
30921
  */
30877
30922
  describeInstanceHistoryEventsWithOptions(request: DescribeInstanceHistoryEventsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstanceHistoryEventsResponse>;
30878
30923
  /**
30924
+ * ## Description
30879
30925
  * * You can query system events that were finished within the last 30 days. The time range for querying unfinished system events is unlimited.
30880
30926
  * * You can also specify the InstanceEventCycleStatus.N parameter to query the system events that are in the Scheduled, Executing, or Inquiring state.
30881
30927
  *
@@ -30886,7 +30932,7 @@ export default class Client extends OpenApi {
30886
30932
  /**
30887
30933
  * This operation is used to query the specified maintenance policy of an instance, which contains the following maintenance attributes:
30888
30934
  * * Maintenance window: the time period that you specify for maintenance.
30889
- * * Maintenance action: the action that you specify in response to instance shutdown.
30935
+ * * Maintenance action: the policy that you specify in response to instance shutdown.
30890
30936
  *
30891
30937
  * @param request DescribeInstanceMaintenanceAttributesRequest
30892
30938
  * @param runtime runtime options for this request RuntimeOptions
@@ -30896,7 +30942,7 @@ export default class Client extends OpenApi {
30896
30942
  /**
30897
30943
  * This operation is used to query the specified maintenance policy of an instance, which contains the following maintenance attributes:
30898
30944
  * * Maintenance window: the time period that you specify for maintenance.
30899
- * * Maintenance action: the action that you specify in response to instance shutdown.
30945
+ * * Maintenance action: the policy that you specify in response to instance shutdown.
30900
30946
  *
30901
30947
  * @param request DescribeInstanceMaintenanceAttributesRequest
30902
30948
  * @return DescribeInstanceMaintenanceAttributesResponse
@@ -30959,22 +31005,7 @@ export default class Client extends OpenApi {
30959
31005
  * @return DescribeInstanceRamRoleResponse
30960
31006
  */
30961
31007
  describeInstanceRamRole(request: DescribeInstanceRamRoleRequest): Promise<DescribeInstanceRamRoleResponse>;
30962
- /**
30963
- * * For information about the lifecycle states of an ECS instance, see [Instance states](~~25687~~).
30964
- * * You can also call this operation to query the list of ECS instances.
30965
- *
30966
- * @param request DescribeInstanceStatusRequest
30967
- * @param runtime runtime options for this request RuntimeOptions
30968
- * @return DescribeInstanceStatusResponse
30969
- */
30970
31008
  describeInstanceStatusWithOptions(request: DescribeInstanceStatusRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstanceStatusResponse>;
30971
- /**
30972
- * * For information about the lifecycle states of an ECS instance, see [Instance states](~~25687~~).
30973
- * * You can also call this operation to query the list of ECS instances.
30974
- *
30975
- * @param request DescribeInstanceStatusRequest
30976
- * @return DescribeInstanceStatusResponse
30977
- */
30978
31009
  describeInstanceStatus(request: DescribeInstanceStatusRequest): Promise<DescribeInstanceStatusResponse>;
30979
31010
  /**
30980
31011
  * > The DescribeInstanceTopology operation is in invitational preview and is not commercially available.
@@ -30993,30 +31024,7 @@ export default class Client extends OpenApi {
30993
31024
  describeInstanceTopology(request: DescribeInstanceTopologyRequest): Promise<DescribeInstanceTopologyResponse>;
30994
31025
  describeInstanceTypeFamiliesWithOptions(request: DescribeInstanceTypeFamiliesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstanceTypeFamiliesResponse>;
30995
31026
  describeInstanceTypeFamilies(request: DescribeInstanceTypeFamiliesRequest): Promise<DescribeInstanceTypeFamiliesResponse>;
30996
- /**
30997
- * ## Description
30998
- * Before you call this operation, take note of the following items:
30999
- * * The MaxResults parameter specifies the maximum number of entries to return on each page. The maximum value of this parameter is changed from 1600 to 100. If you called this operation in 2022, you can continue to use 1600 as the maximum value of MaxResults until November 15, 2023. As of November 15, 2023, only 100 can be used as the maximum value of MaxResults. If you do not specify the NextToken parameter when you call the DescribeInstanceTypes operation, only the first page of results that contains up to 100 entries is returned. If you want to retrieve more results, specify the NextToken parameter to perform paged queries, or specify filter conditions to filter results. For information about the best practices for using DescribeInstanceTypes, see [Compare the specifications of instance types](https://help.aliyun.com/practice_detail/461278) .
31000
- * * We recommend that you specify the MaxResults and NextToken parameters to perform paged queries. The first time you call the DescribeInstanceTypes operation, specify MaxResults to limit the maximum number of entries to return in the call. If the number of entries to return exceeds the specified value of MaxResults, the response includes a NextToken value. You can set NextToken to the return value and specify MaxResults in your next request to DescribeInstanceTypes to retrieve the next page of results.
31001
- * * The DescribeInstanceTypes operation is used to query only the specifications and performance information of instance types. To query instance types that are available in a specific region, call the [DescribeAvailableResource](~~66186~~) operation.
31002
- * * To use special instance types such as instance types that are unavailable for purchase, [submit a ticket](https://selfservice.console.aliyun.com/ticket/createIndex.htm).
31003
- *
31004
- * @param request DescribeInstanceTypesRequest
31005
- * @param runtime runtime options for this request RuntimeOptions
31006
- * @return DescribeInstanceTypesResponse
31007
- */
31008
31027
  describeInstanceTypesWithOptions(request: DescribeInstanceTypesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstanceTypesResponse>;
31009
- /**
31010
- * ## Description
31011
- * Before you call this operation, take note of the following items:
31012
- * * The MaxResults parameter specifies the maximum number of entries to return on each page. The maximum value of this parameter is changed from 1600 to 100. If you called this operation in 2022, you can continue to use 1600 as the maximum value of MaxResults until November 15, 2023. As of November 15, 2023, only 100 can be used as the maximum value of MaxResults. If you do not specify the NextToken parameter when you call the DescribeInstanceTypes operation, only the first page of results that contains up to 100 entries is returned. If you want to retrieve more results, specify the NextToken parameter to perform paged queries, or specify filter conditions to filter results. For information about the best practices for using DescribeInstanceTypes, see [Compare the specifications of instance types](https://help.aliyun.com/practice_detail/461278) .
31013
- * * We recommend that you specify the MaxResults and NextToken parameters to perform paged queries. The first time you call the DescribeInstanceTypes operation, specify MaxResults to limit the maximum number of entries to return in the call. If the number of entries to return exceeds the specified value of MaxResults, the response includes a NextToken value. You can set NextToken to the return value and specify MaxResults in your next request to DescribeInstanceTypes to retrieve the next page of results.
31014
- * * The DescribeInstanceTypes operation is used to query only the specifications and performance information of instance types. To query instance types that are available in a specific region, call the [DescribeAvailableResource](~~66186~~) operation.
31015
- * * To use special instance types such as instance types that are unavailable for purchase, [submit a ticket](https://selfservice.console.aliyun.com/ticket/createIndex.htm).
31016
- *
31017
- * @param request DescribeInstanceTypesRequest
31018
- * @return DescribeInstanceTypesResponse
31019
- */
31020
31028
  describeInstanceTypes(request: DescribeInstanceTypesRequest): Promise<DescribeInstanceTypesResponse>;
31021
31029
  /**
31022
31030
  * @deprecated
@@ -31033,7 +31041,50 @@ export default class Client extends OpenApi {
31033
31041
  * @return DescribeInstanceVncPasswdResponse
31034
31042
  */
31035
31043
  describeInstanceVncPasswd(request: DescribeInstanceVncPasswdRequest): Promise<DescribeInstanceVncPasswdResponse>;
31044
+ /**
31045
+ * When you call this operation, take note of the following items:
31046
+ * * The URL returned is valid only for 15 seconds. If a connection is not established within 15 seconds after a successful query, the URL expires and you must query it again.
31047
+ * * The **KeepAlive** time of a connection to a VNC management terminal is 60 seconds. If you do not interact with the VNC management terminal within 60 seconds, the VNC management terminal is automatically disconnected.
31048
+ * * When the VNC management terminal is disconnected, you can only reconnect to the VNC management terminal up to 30 times a minute.
31049
+ * * You need to add `vncUrl`, `instanceId`, `isWindows`, and `password` parameters at the end of the URL `https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?`. Separate each parameter with an ampersand (`&`).`` Where,
31050
+ * * `vncUrl:` the `VncUrl` value returned after a successful query.
31051
+ * * `instanceId:` the ID of your instance.
31052
+ * * `isWindows:` specifies whether the operating system of the instance is Windows. Set the parameter to `true` if the operating system is Windows. Set the parameter to `false` if the operating system is not Windows.
31053
+ * * `password:` Optional. A six-character password used to connect to the VNC management terminal. It can contain digits and letters. You do not need to enter your password again when the connection is being established if you set this parameter.
31054
+ * Example:
31055
+ * ```
31056
+ * ```
31057
+ * <https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?vncUrl=ws%3A%2F%\\\\*\\\\*\\\\*\\\\*&instanceId=i-wz9hhwq5a6tm\\\\*\\\\*\\\\*\\\\*&isWindows=true> \\`\\`\\`
31058
+ * or:
31059
+ * ```
31060
+ * <https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?vncUrl=ws%3A%2F%\\\\*\\\\*\\\\*\\\\*&instanceId=i-wz9hhwq5a6tm\\\\*\\\\*\\\\*\\\\*&isWindows=true&password=\\\\*\\\\*\\\\*\\\\>\\* \\`\\`\\`
31061
+ *
31062
+ * @param request DescribeInstanceVncUrlRequest
31063
+ * @param runtime runtime options for this request RuntimeOptions
31064
+ * @return DescribeInstanceVncUrlResponse
31065
+ */
31036
31066
  describeInstanceVncUrlWithOptions(request: DescribeInstanceVncUrlRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstanceVncUrlResponse>;
31067
+ /**
31068
+ * When you call this operation, take note of the following items:
31069
+ * * The URL returned is valid only for 15 seconds. If a connection is not established within 15 seconds after a successful query, the URL expires and you must query it again.
31070
+ * * The **KeepAlive** time of a connection to a VNC management terminal is 60 seconds. If you do not interact with the VNC management terminal within 60 seconds, the VNC management terminal is automatically disconnected.
31071
+ * * When the VNC management terminal is disconnected, you can only reconnect to the VNC management terminal up to 30 times a minute.
31072
+ * * You need to add `vncUrl`, `instanceId`, `isWindows`, and `password` parameters at the end of the URL `https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?`. Separate each parameter with an ampersand (`&`).`` Where,
31073
+ * * `vncUrl:` the `VncUrl` value returned after a successful query.
31074
+ * * `instanceId:` the ID of your instance.
31075
+ * * `isWindows:` specifies whether the operating system of the instance is Windows. Set the parameter to `true` if the operating system is Windows. Set the parameter to `false` if the operating system is not Windows.
31076
+ * * `password:` Optional. A six-character password used to connect to the VNC management terminal. It can contain digits and letters. You do not need to enter your password again when the connection is being established if you set this parameter.
31077
+ * Example:
31078
+ * ```
31079
+ * ```
31080
+ * <https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?vncUrl=ws%3A%2F%\\\\*\\\\*\\\\*\\\\*&instanceId=i-wz9hhwq5a6tm\\\\*\\\\*\\\\*\\\\*&isWindows=true> \\`\\`\\`
31081
+ * or:
31082
+ * ```
31083
+ * <https://g.alicdn.com/aliyun/ecs-console-vnc2/0.0.8/index.html?vncUrl=ws%3A%2F%\\\\*\\\\*\\\\*\\\\*&instanceId=i-wz9hhwq5a6tm\\\\*\\\\*\\\\*\\\\*&isWindows=true&password=\\\\*\\\\*\\\\*\\\\>\\* \\`\\`\\`
31084
+ *
31085
+ * @param request DescribeInstanceVncUrlRequest
31086
+ * @return DescribeInstanceVncUrlResponse
31087
+ */
31037
31088
  describeInstanceVncUrl(request: DescribeInstanceVncUrlRequest): Promise<DescribeInstanceVncUrlResponse>;
31038
31089
  /**
31039
31090
  * * You can specify multiple request parameters to be queried. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions. However, if InstanceIds is set to an empty JSON array, it is regarded as a valid filter condition and an empty result is returned.
@@ -31062,26 +31113,24 @@ export default class Client extends OpenApi {
31062
31113
  * @return DescribeInstancesResponse
31063
31114
  */
31064
31115
  describeInstances(request: DescribeInstancesRequest): Promise<DescribeInstancesResponse>;
31065
- describeInstancesFullStatusWithOptions(request: DescribeInstancesFullStatusRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstancesFullStatusResponse>;
31066
- describeInstancesFullStatus(request: DescribeInstancesFullStatusRequest): Promise<DescribeInstancesFullStatusResponse>;
31067
31116
  /**
31068
- * ## Description
31069
- * * After you run a command, the command may not succeed or return the expected results. You can call this operation to query the actual execution results.
31070
- * * You can query the information about command executions within the last four weeks. A maximum of 100,000 pieces of execution information can be retained.
31117
+ * The response includes instance states and instance system events in the Scheduled state.
31118
+ * If a period is specified, events are queried based on the specified period.
31071
31119
  *
31072
- * @param request DescribeInvocationResultsRequest
31120
+ * @param request DescribeInstancesFullStatusRequest
31073
31121
  * @param runtime runtime options for this request RuntimeOptions
31074
- * @return DescribeInvocationResultsResponse
31122
+ * @return DescribeInstancesFullStatusResponse
31075
31123
  */
31076
- describeInvocationResultsWithOptions(request: DescribeInvocationResultsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInvocationResultsResponse>;
31124
+ describeInstancesFullStatusWithOptions(request: DescribeInstancesFullStatusRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInstancesFullStatusResponse>;
31077
31125
  /**
31078
- * ## Description
31079
- * * After you run a command, the command may not succeed or return the expected results. You can call this operation to query the actual execution results.
31080
- * * You can query the information about command executions within the last four weeks. A maximum of 100,000 pieces of execution information can be retained.
31126
+ * The response includes instance states and instance system events in the Scheduled state.
31127
+ * If a period is specified, events are queried based on the specified period.
31081
31128
  *
31082
- * @param request DescribeInvocationResultsRequest
31083
- * @return DescribeInvocationResultsResponse
31129
+ * @param request DescribeInstancesFullStatusRequest
31130
+ * @return DescribeInstancesFullStatusResponse
31084
31131
  */
31132
+ describeInstancesFullStatus(request: DescribeInstancesFullStatusRequest): Promise<DescribeInstancesFullStatusResponse>;
31133
+ describeInvocationResultsWithOptions(request: DescribeInvocationResultsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeInvocationResultsResponse>;
31085
31134
  describeInvocationResults(request: DescribeInvocationResultsRequest): Promise<DescribeInvocationResultsResponse>;
31086
31135
  /**
31087
31136
  * * After you run a command, the command may not succeed or return the expected results. You can call this operation to query the execution results.
@@ -31142,29 +31191,14 @@ export default class Client extends OpenApi {
31142
31191
  describeNetworkInterfaceAttribute(request: DescribeNetworkInterfaceAttributeRequest): Promise<DescribeNetworkInterfaceAttributeResponse>;
31143
31192
  describeNetworkInterfacePermissionsWithOptions(request: DescribeNetworkInterfacePermissionsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeNetworkInterfacePermissionsResponse>;
31144
31193
  describeNetworkInterfacePermissions(request: DescribeNetworkInterfacePermissionsRequest): Promise<DescribeNetworkInterfacePermissionsResponse>;
31194
+ describeNetworkInterfacesWithOptions(request: DescribeNetworkInterfacesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeNetworkInterfacesResponse>;
31195
+ describeNetworkInterfaces(request: DescribeNetworkInterfacesRequest): Promise<DescribeNetworkInterfacesResponse>;
31145
31196
  /**
31146
- * The `DescribeNetworkInterfaces` operation supports multiple pagination mechanisms. We recommend that you set `MaxResults` to specify the maximum number of entries to return in each request. The returned value of `NextToken` is a pagination token, which can be used in the next request to retrieve a new page of results. When you perform the next request, 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.
31147
- * > If you specify `MaxResults` or `NextToken`, the system returns results based on the preceding pagination mechanism. Otherwise, the system paginates the results based on the `PageNumber` and `PageSize` parameters.
31197
+ * @deprecated
31148
31198
  *
31149
- * @param request DescribeNetworkInterfacesRequest
31199
+ * @param request DescribeNewProjectEipMonitorDataRequest
31150
31200
  * @param runtime runtime options for this request RuntimeOptions
31151
- * @return DescribeNetworkInterfacesResponse
31152
- */
31153
- describeNetworkInterfacesWithOptions(request: DescribeNetworkInterfacesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeNetworkInterfacesResponse>;
31154
- /**
31155
- * The `DescribeNetworkInterfaces` operation supports multiple pagination mechanisms. We recommend that you set `MaxResults` to specify the maximum number of entries to return in each request. The returned value of `NextToken` is a pagination token, which can be used in the next request to retrieve a new page of results. When you perform the next request, 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.
31156
- * > If you specify `MaxResults` or `NextToken`, the system returns results based on the preceding pagination mechanism. Otherwise, the system paginates the results based on the `PageNumber` and `PageSize` parameters.
31157
- *
31158
- * @param request DescribeNetworkInterfacesRequest
31159
- * @return DescribeNetworkInterfacesResponse
31160
- */
31161
- describeNetworkInterfaces(request: DescribeNetworkInterfacesRequest): Promise<DescribeNetworkInterfacesResponse>;
31162
- /**
31163
- * @deprecated
31164
- *
31165
- * @param request DescribeNewProjectEipMonitorDataRequest
31166
- * @param runtime runtime options for this request RuntimeOptions
31167
- * @return DescribeNewProjectEipMonitorDataResponse
31201
+ * @return DescribeNewProjectEipMonitorDataResponse
31168
31202
  */
31169
31203
  describeNewProjectEipMonitorDataWithOptions(request: DescribeNewProjectEipMonitorDataRequest, runtime: $Util.RuntimeOptions): Promise<DescribeNewProjectEipMonitorDataResponse>;
31170
31204
  /**
@@ -31193,22 +31227,7 @@ export default class Client extends OpenApi {
31193
31227
  describePrefixListAssociations(request: DescribePrefixListAssociationsRequest): Promise<DescribePrefixListAssociationsResponse>;
31194
31228
  describePrefixListAttributesWithOptions(request: DescribePrefixListAttributesRequest, runtime: $Util.RuntimeOptions): Promise<DescribePrefixListAttributesResponse>;
31195
31229
  describePrefixListAttributes(request: DescribePrefixListAttributesRequest): Promise<DescribePrefixListAttributesResponse>;
31196
- /**
31197
- * ## Description
31198
- * You can specify the `AddressFamily`, `PrefixListId.N`, and `PrefixListName` request parameters to be queried. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions.
31199
- *
31200
- * @param request DescribePrefixListsRequest
31201
- * @param runtime runtime options for this request RuntimeOptions
31202
- * @return DescribePrefixListsResponse
31203
- */
31204
31230
  describePrefixListsWithOptions(request: DescribePrefixListsRequest, runtime: $Util.RuntimeOptions): Promise<DescribePrefixListsResponse>;
31205
- /**
31206
- * ## Description
31207
- * You can specify the `AddressFamily`, `PrefixListId.N`, and `PrefixListName` request parameters to be queried. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions.
31208
- *
31209
- * @param request DescribePrefixListsRequest
31210
- * @return DescribePrefixListsResponse
31211
- */
31212
31231
  describePrefixLists(request: DescribePrefixListsRequest): Promise<DescribePrefixListsResponse>;
31213
31232
  describePriceWithOptions(request: DescribePriceRequest, runtime: $Util.RuntimeOptions): Promise<DescribePriceResponse>;
31214
31233
  describePrice(request: DescribePriceRequest): Promise<DescribePriceResponse>;
@@ -31229,28 +31248,7 @@ export default class Client extends OpenApi {
31229
31248
  * @return DescribeRegionsResponse
31230
31249
  */
31231
31250
  describeRegions(request: DescribeRegionsRequest): Promise<DescribeRegionsResponse>;
31232
- /**
31233
- * ## Description
31234
- * * You can call this operation to query the price for renewing a subscription instance for a specific period of time or to a synchronized expiration date.
31235
- * * Take note of the following items:
31236
- * * If you set only the required parameters, the price for renewing a specified instance for one month is queried by default.
31237
- * * The renewal period-related parameter pair (`Period` and `PeriodUnit`) and the synchronized expiration date-related parameter (`ExpectedRenewDay`) are mutually exclusive. You cannot set these parameters together to query the prices for renewing a specified instance for a period of time and to a synchronized expiration date at the same time.
31238
- *
31239
- * @param request DescribeRenewalPriceRequest
31240
- * @param runtime runtime options for this request RuntimeOptions
31241
- * @return DescribeRenewalPriceResponse
31242
- */
31243
31251
  describeRenewalPriceWithOptions(request: DescribeRenewalPriceRequest, runtime: $Util.RuntimeOptions): Promise<DescribeRenewalPriceResponse>;
31244
- /**
31245
- * ## Description
31246
- * * You can call this operation to query the price for renewing a subscription instance for a specific period of time or to a synchronized expiration date.
31247
- * * Take note of the following items:
31248
- * * If you set only the required parameters, the price for renewing a specified instance for one month is queried by default.
31249
- * * The renewal period-related parameter pair (`Period` and `PeriodUnit`) and the synchronized expiration date-related parameter (`ExpectedRenewDay`) are mutually exclusive. You cannot set these parameters together to query the prices for renewing a specified instance for a period of time and to a synchronized expiration date at the same time.
31250
- *
31251
- * @param request DescribeRenewalPriceRequest
31252
- * @return DescribeRenewalPriceResponse
31253
- */
31254
31252
  describeRenewalPrice(request: DescribeRenewalPriceRequest): Promise<DescribeRenewalPriceResponse>;
31255
31253
  describeReservedInstanceAutoRenewAttributeWithOptions(request: DescribeReservedInstanceAutoRenewAttributeRequest, runtime: $Util.RuntimeOptions): Promise<DescribeReservedInstanceAutoRenewAttributeResponse>;
31256
31254
  describeReservedInstanceAutoRenewAttribute(request: DescribeReservedInstanceAutoRenewAttributeRequest): Promise<DescribeReservedInstanceAutoRenewAttributeResponse>;
@@ -31315,9 +31313,9 @@ export default class Client extends OpenApi {
31315
31313
  describeSecurityGroupReferences(request: DescribeSecurityGroupReferencesRequest): Promise<DescribeSecurityGroupReferencesResponse>;
31316
31314
  /**
31317
31315
  * Before you call this operation, take note of the following items:
31318
- * * The basic information of security groups includes their IDs and descriptions. In the response, security groups are displayed in descending order of their IDs.
31319
- * * We recommend that you use the NextToken and MaxResults parameters for a paged query. During a paged query, when you call the DescribeSecurityGroups 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, which can be used in the next call to retrieve a new page of results. When you call the DescribeSecurityGroups 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. If the return value of NextToken is empty, the current page of results is the last page and no more results are to be returned.
31320
- * * When you use Alibaba Cloud CLI to call an API operation, you must specify request parameter values of different data types in required formats. For more information, see [Parameter format overview](~~110340~~).
31316
+ * * The basic information of security groups includes the IDs and descriptions. The response returns security groups in descending order based on their IDs.
31317
+ * * We recommend that you use the NextToken and MaxResults parameters for a paged query. We recommend that you use the MaxResults parameter to specify the maximum number of entries to return in each request. The returned value of NextToken is a pagination token, which can be used in the next request to retrieve a new page of results. When you perform the next request, set the NextToken parameter to the NextToken value that is returned in the previous call and use the MaxResults parameter to specify the maximum number of entries to return in this request. If the returned value of the NextToken parameter is empty, the current page of results is the last page and no more results are to be returned.
31318
+ * * When you use Alibaba Cloud CLI to call an API operation, you must specify request parameter values of different data types in the required formats. For more information, see [Parameter format overview](~~110340~~).
31321
31319
  *
31322
31320
  * @param request DescribeSecurityGroupsRequest
31323
31321
  * @param runtime runtime options for this request RuntimeOptions
@@ -31326,9 +31324,9 @@ export default class Client extends OpenApi {
31326
31324
  describeSecurityGroupsWithOptions(request: DescribeSecurityGroupsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeSecurityGroupsResponse>;
31327
31325
  /**
31328
31326
  * Before you call this operation, take note of the following items:
31329
- * * The basic information of security groups includes their IDs and descriptions. In the response, security groups are displayed in descending order of their IDs.
31330
- * * We recommend that you use the NextToken and MaxResults parameters for a paged query. During a paged query, when you call the DescribeSecurityGroups 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, which can be used in the next call to retrieve a new page of results. When you call the DescribeSecurityGroups 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. If the return value of NextToken is empty, the current page of results is the last page and no more results are to be returned.
31331
- * * When you use Alibaba Cloud CLI to call an API operation, you must specify request parameter values of different data types in required formats. For more information, see [Parameter format overview](~~110340~~).
31327
+ * * The basic information of security groups includes the IDs and descriptions. The response returns security groups in descending order based on their IDs.
31328
+ * * We recommend that you use the NextToken and MaxResults parameters for a paged query. We recommend that you use the MaxResults parameter to specify the maximum number of entries to return in each request. The returned value of NextToken is a pagination token, which can be used in the next request to retrieve a new page of results. When you perform the next request, set the NextToken parameter to the NextToken value that is returned in the previous call and use the MaxResults parameter to specify the maximum number of entries to return in this request. If the returned value of the NextToken parameter is empty, the current page of results is the last page and no more results are to be returned.
31329
+ * * When you use Alibaba Cloud CLI to call an API operation, you must specify request parameter values of different data types in the required formats. For more information, see [Parameter format overview](~~110340~~).
31332
31330
  *
31333
31331
  * @param request DescribeSecurityGroupsRequest
31334
31332
  * @return DescribeSecurityGroupsResponse
@@ -31354,7 +31352,6 @@ export default class Client extends OpenApi {
31354
31352
  */
31355
31353
  describeSendFileResults(request: DescribeSendFileResultsRequest): Promise<DescribeSendFileResultsResponse>;
31356
31354
  /**
31357
- * ## Description
31358
31355
  * You can specify multiple request parameters such as `InstanceId`, `SnapshotGroupId.N`, and `Status.N` to be queried. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions.
31359
31356
  *
31360
31357
  * @param request DescribeSnapshotGroupsRequest
@@ -31363,31 +31360,13 @@ export default class Client extends OpenApi {
31363
31360
  */
31364
31361
  describeSnapshotGroupsWithOptions(request: DescribeSnapshotGroupsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeSnapshotGroupsResponse>;
31365
31362
  /**
31366
- * ## Description
31367
31363
  * You can specify multiple request parameters such as `InstanceId`, `SnapshotGroupId.N`, and `Status.N` to be queried. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions.
31368
31364
  *
31369
31365
  * @param request DescribeSnapshotGroupsRequest
31370
31366
  * @return DescribeSnapshotGroupsResponse
31371
31367
  */
31372
31368
  describeSnapshotGroups(request: DescribeSnapshotGroupsRequest): Promise<DescribeSnapshotGroupsResponse>;
31373
- /**
31374
- * When you call this operation, take note of the following items:
31375
- * * You can specify multiple request parameters such as `RegionId`, `DiskIds`, and `InstanceId` to be queried. Specified parameters have logical AND relations.
31376
- * * Only the specified parameters are used as filter conditions. If the `DiskIds` and `SnapshotLinkIds` parameters are set to empty JSON arrays, they are regarded as valid filter conditions and an empty result is returned.
31377
- *
31378
- * @param request DescribeSnapshotLinksRequest
31379
- * @param runtime runtime options for this request RuntimeOptions
31380
- * @return DescribeSnapshotLinksResponse
31381
- */
31382
31369
  describeSnapshotLinksWithOptions(request: DescribeSnapshotLinksRequest, runtime: $Util.RuntimeOptions): Promise<DescribeSnapshotLinksResponse>;
31383
- /**
31384
- * When you call this operation, take note of the following items:
31385
- * * You can specify multiple request parameters such as `RegionId`, `DiskIds`, and `InstanceId` to be queried. Specified parameters have logical AND relations.
31386
- * * Only the specified parameters are used as filter conditions. If the `DiskIds` and `SnapshotLinkIds` parameters are set to empty JSON arrays, they are regarded as valid filter conditions and an empty result is returned.
31387
- *
31388
- * @param request DescribeSnapshotLinksRequest
31389
- * @return DescribeSnapshotLinksResponse
31390
- */
31391
31370
  describeSnapshotLinks(request: DescribeSnapshotLinksRequest): Promise<DescribeSnapshotLinksResponse>;
31392
31371
  /**
31393
31372
  * When you call this operation, take note of the following items:
@@ -31411,6 +31390,7 @@ export default class Client extends OpenApi {
31411
31390
  describeSnapshotPackageWithOptions(request: DescribeSnapshotPackageRequest, runtime: $Util.RuntimeOptions): Promise<DescribeSnapshotPackageResponse>;
31412
31391
  describeSnapshotPackage(request: DescribeSnapshotPackageRequest): Promise<DescribeSnapshotPackageResponse>;
31413
31392
  /**
31393
+ * ## Description
31414
31394
  * You can specify multiple request parameters such as `InstanceId`, `DiskId`, and `SnapshotIds` to be queried. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions.
31415
31395
  * When you use Alibaba Cloud CLI to call an API operation, you must specify request parameter values of different data types in required formats. For more information, see [Parameter format overview](~~110340~~).
31416
31396
  *
@@ -31420,6 +31400,7 @@ export default class Client extends OpenApi {
31420
31400
  */
31421
31401
  describeSnapshotsWithOptions(request: DescribeSnapshotsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeSnapshotsResponse>;
31422
31402
  /**
31403
+ * ## Description
31423
31404
  * You can specify multiple request parameters such as `InstanceId`, `DiskId`, and `SnapshotIds` to be queried. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions.
31424
31405
  * When you use Alibaba Cloud CLI to call an API operation, you must specify request parameter values of different data types in required formats. For more information, see [Parameter format overview](~~110340~~).
31425
31406
  *
@@ -31443,15 +31424,15 @@ export default class Client extends OpenApi {
31443
31424
  */
31444
31425
  describeSnapshotsUsage(request: DescribeSnapshotsUsageRequest): Promise<DescribeSnapshotsUsageResponse>;
31445
31426
  /**
31446
- * * You can call this operation to query information that is generated for preemptible instances in the last 30 days and select suitable instance types based on the query results. The information that you can query by calling this operation includes:
31447
- * * Average release rate of preemptible instances
31448
- * * Percentage of the average preemptible instance price relative to the pay-as-you-go instance price
31449
- * * Average preemptible instance price that is calculated based on the preceding percentage
31450
- * * This operation is applicable only to I/O optimized preemptible instances that are located in virtual private clouds (VPCs).
31451
- * * You can use one of the following methods to query information that is generated for preemptible instances in the last 30 days:
31452
- * * Set the `Cores` and `Memory` parameters or the `MinCores` and `MinMemory` parameters to query information about instance types that have the specified number of vCPUs and memory size.
31453
- * * Set the `InstanceTypes.N` parameter to query information of the specified instance types.
31454
- * * Set the `Cores` and `Memory` parameters or the `MinCores` and `MinMemory` parameters, and set the `InstanceTypeFamily` or `InstanceFamilyLevel` parameter to query information of the instance types that have the specified number of vCPUs and memory size within the specified instance family or at the specified instance family level.
31427
+ * * You can call this operation to query information that is generated for preemptible instances in the last 30 days and select suitable instance types based on the returned results. The information that you can query by calling this operation includes:
31428
+ * * Average release rate of preemptible instances.
31429
+ * * The discount rate of the average preemptible instance price relative to the pay-as-you-go instance price.
31430
+ * * Average preemptible instance price that is calculated based on the preceding percentage.
31431
+ * * This operation is applicable only to I/O optimized preemptible instances that are located in virtual private clouds (VPCs).
31432
+ * * You can use one of the following methods to specify instance types:
31433
+ * * Set the `Cores` and `Memory` parameters or the `MinCores` and `MinMemory` parameters to query information of instance types that have the specified number of vCPUs and memory size.
31434
+ * * Set the `InstanceTypes.N parameter` to query information of the specified instance types.
31435
+ * * Set the `Cores` and `Memory` parameters or the `MinCores` and `MinMemory` parameters, and set the `InstanceTypeFamily` or `InstanceFamilyLevel` parameter to query information of the instance types that have the specified number of vCPUs and memory size within the specified instance family or at the specified instance family level.
31455
31436
  *
31456
31437
  * @param request DescribeSpotAdviceRequest
31457
31438
  * @param runtime runtime options for this request RuntimeOptions
@@ -31459,15 +31440,15 @@ export default class Client extends OpenApi {
31459
31440
  */
31460
31441
  describeSpotAdviceWithOptions(request: DescribeSpotAdviceRequest, runtime: $Util.RuntimeOptions): Promise<DescribeSpotAdviceResponse>;
31461
31442
  /**
31462
- * * You can call this operation to query information that is generated for preemptible instances in the last 30 days and select suitable instance types based on the query results. The information that you can query by calling this operation includes:
31463
- * * Average release rate of preemptible instances
31464
- * * Percentage of the average preemptible instance price relative to the pay-as-you-go instance price
31465
- * * Average preemptible instance price that is calculated based on the preceding percentage
31466
- * * This operation is applicable only to I/O optimized preemptible instances that are located in virtual private clouds (VPCs).
31467
- * * You can use one of the following methods to query information that is generated for preemptible instances in the last 30 days:
31468
- * * Set the `Cores` and `Memory` parameters or the `MinCores` and `MinMemory` parameters to query information about instance types that have the specified number of vCPUs and memory size.
31469
- * * Set the `InstanceTypes.N` parameter to query information of the specified instance types.
31470
- * * Set the `Cores` and `Memory` parameters or the `MinCores` and `MinMemory` parameters, and set the `InstanceTypeFamily` or `InstanceFamilyLevel` parameter to query information of the instance types that have the specified number of vCPUs and memory size within the specified instance family or at the specified instance family level.
31443
+ * * You can call this operation to query information that is generated for preemptible instances in the last 30 days and select suitable instance types based on the returned results. The information that you can query by calling this operation includes:
31444
+ * * Average release rate of preemptible instances.
31445
+ * * The discount rate of the average preemptible instance price relative to the pay-as-you-go instance price.
31446
+ * * Average preemptible instance price that is calculated based on the preceding percentage.
31447
+ * * This operation is applicable only to I/O optimized preemptible instances that are located in virtual private clouds (VPCs).
31448
+ * * You can use one of the following methods to specify instance types:
31449
+ * * Set the `Cores` and `Memory` parameters or the `MinCores` and `MinMemory` parameters to query information of instance types that have the specified number of vCPUs and memory size.
31450
+ * * Set the `InstanceTypes.N parameter` to query information of the specified instance types.
31451
+ * * Set the `Cores` and `Memory` parameters or the `MinCores` and `MinMemory` parameters, and set the `InstanceTypeFamily` or `InstanceFamilyLevel` parameter to query information of the instance types that have the specified number of vCPUs and memory size within the specified instance family or at the specified instance family level.
31471
31452
  *
31472
31453
  * @param request DescribeSpotAdviceRequest
31473
31454
  * @return DescribeSpotAdviceResponse
@@ -31481,20 +31462,7 @@ export default class Client extends OpenApi {
31481
31462
  describeStorageSetDetails(request: DescribeStorageSetDetailsRequest): Promise<DescribeStorageSetDetailsResponse>;
31482
31463
  describeStorageSetsWithOptions(request: DescribeStorageSetsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeStorageSetsResponse>;
31483
31464
  describeStorageSets(request: DescribeStorageSetsRequest): Promise<DescribeStorageSetsResponse>;
31484
- /**
31485
- * If a tag key is specified and no tag values are specified, all tags that contain the tag key are returned. If a tag key-value pair is specified, only tags that exactly match the key-value pair are returned.
31486
- *
31487
- * @param request DescribeTagsRequest
31488
- * @param runtime runtime options for this request RuntimeOptions
31489
- * @return DescribeTagsResponse
31490
- */
31491
31465
  describeTagsWithOptions(request: DescribeTagsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeTagsResponse>;
31492
- /**
31493
- * If a tag key is specified and no tag values are specified, all tags that contain the tag key are returned. If a tag key-value pair is specified, only tags that exactly match the key-value pair are returned.
31494
- *
31495
- * @param request DescribeTagsRequest
31496
- * @return DescribeTagsResponse
31497
- */
31498
31466
  describeTags(request: DescribeTagsRequest): Promise<DescribeTagsResponse>;
31499
31467
  describeTaskAttributeWithOptions(request: DescribeTaskAttributeRequest, runtime: $Util.RuntimeOptions): Promise<DescribeTaskAttributeResponse>;
31500
31468
  describeTaskAttribute(request: DescribeTaskAttributeRequest): Promise<DescribeTaskAttributeResponse>;
@@ -31609,53 +31577,53 @@ export default class Client extends OpenApi {
31609
31577
  * @return DescribeVpcsResponse
31610
31578
  */
31611
31579
  describeVpcs(request: DescribeVpcsRequest): Promise<DescribeVpcsResponse>;
31612
- describeZonesWithOptions(request: DescribeZonesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeZonesResponse>;
31613
- describeZones(request: DescribeZonesRequest): Promise<DescribeZonesResponse>;
31614
- detachClassicLinkVpcWithOptions(request: DetachClassicLinkVpcRequest, runtime: $Util.RuntimeOptions): Promise<DetachClassicLinkVpcResponse>;
31615
- detachClassicLinkVpc(request: DetachClassicLinkVpcRequest): Promise<DetachClassicLinkVpcResponse>;
31616
- detachDiskWithOptions(request: DetachDiskRequest, runtime: $Util.RuntimeOptions): Promise<DetachDiskResponse>;
31617
- detachDisk(request: DetachDiskRequest): Promise<DetachDiskResponse>;
31618
- detachInstanceRamRoleWithOptions(request: DetachInstanceRamRoleRequest, runtime: $Util.RuntimeOptions): Promise<DetachInstanceRamRoleResponse>;
31619
- detachInstanceRamRole(request: DetachInstanceRamRoleRequest): Promise<DetachInstanceRamRoleResponse>;
31620
31580
  /**
31621
- * When you call this operation, take note of the following items:
31622
- * * After you detach an SSH key pair from an instance, you must call the [RebootInstance](~~25502~~) operation to restart the instance for the detach operation to take effect.
31623
- * * The username and password authentication method is automatically selected for an instance after you unbind an SSH key pair from the instance.
31581
+ * 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](~~66186~~) operation.
31624
31582
  *
31625
- * @param request DetachKeyPairRequest
31583
+ * @param request DescribeZonesRequest
31626
31584
  * @param runtime runtime options for this request RuntimeOptions
31627
- * @return DetachKeyPairResponse
31585
+ * @return DescribeZonesResponse
31628
31586
  */
31629
- detachKeyPairWithOptions(request: DetachKeyPairRequest, runtime: $Util.RuntimeOptions): Promise<DetachKeyPairResponse>;
31587
+ describeZonesWithOptions(request: DescribeZonesRequest, runtime: $Util.RuntimeOptions): Promise<DescribeZonesResponse>;
31630
31588
  /**
31631
- * When you call this operation, take note of the following items:
31632
- * * After you detach an SSH key pair from an instance, you must call the [RebootInstance](~~25502~~) operation to restart the instance for the detach operation to take effect.
31633
- * * The username and password authentication method is automatically selected for an instance after you unbind an SSH key pair from the instance.
31589
+ * 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](~~66186~~) operation.
31634
31590
  *
31635
- * @param request DetachKeyPairRequest
31636
- * @return DetachKeyPairResponse
31591
+ * @param request DescribeZonesRequest
31592
+ * @return DescribeZonesResponse
31637
31593
  */
31638
- detachKeyPair(request: DetachKeyPairRequest): Promise<DetachKeyPairResponse>;
31594
+ describeZones(request: DescribeZonesRequest): Promise<DescribeZonesResponse>;
31595
+ detachClassicLinkVpcWithOptions(request: DetachClassicLinkVpcRequest, runtime: $Util.RuntimeOptions): Promise<DetachClassicLinkVpcResponse>;
31596
+ detachClassicLinkVpc(request: DetachClassicLinkVpcRequest): Promise<DetachClassicLinkVpcResponse>;
31639
31597
  /**
31640
31598
  * When you call this operation, take note of the following items:
31641
- * * The primary ENIs of ECS instances cannot be unbound.
31642
- * * The ENI must be in the Detaching (Detaching) or InUse (InUse) state.
31643
- * * The instance must be in the Running (Running) or Stopped (Stopped) state.
31599
+ * * The disk you want to detach must be in the `In_Use` state.
31600
+ * * The instance from which you want to detach a data disk must be in the `Running` or `Stopped`state.********
31601
+ * * The instance from which you want to detach the system disk must be in the `Stopped` state.****
31602
+ * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}`, the instance is locked for security reasons. No operations are allowed on the instance.``
31603
+ * * DetachDisk is an asynchronous operation. It takes about one minute for a disk to be detached from an instance after the operation is called.
31644
31604
  *
31645
- * @param request DetachNetworkInterfaceRequest
31605
+ * @param request DetachDiskRequest
31646
31606
  * @param runtime runtime options for this request RuntimeOptions
31647
- * @return DetachNetworkInterfaceResponse
31607
+ * @return DetachDiskResponse
31648
31608
  */
31649
- detachNetworkInterfaceWithOptions(request: DetachNetworkInterfaceRequest, runtime: $Util.RuntimeOptions): Promise<DetachNetworkInterfaceResponse>;
31609
+ detachDiskWithOptions(request: DetachDiskRequest, runtime: $Util.RuntimeOptions): Promise<DetachDiskResponse>;
31650
31610
  /**
31651
31611
  * When you call this operation, take note of the following items:
31652
- * * The primary ENIs of ECS instances cannot be unbound.
31653
- * * The ENI must be in the Detaching (Detaching) or InUse (InUse) state.
31654
- * * The instance must be in the Running (Running) or Stopped (Stopped) state.
31612
+ * * The disk you want to detach must be in the `In_Use` state.
31613
+ * * The instance from which you want to detach a data disk must be in the `Running` or `Stopped`state.********
31614
+ * * The instance from which you want to detach the system disk must be in the `Stopped` state.****
31615
+ * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}`, the instance is locked for security reasons. No operations are allowed on the instance.``
31616
+ * * DetachDisk is an asynchronous operation. It takes about one minute for a disk to be detached from an instance after the operation is called.
31655
31617
  *
31656
- * @param request DetachNetworkInterfaceRequest
31657
- * @return DetachNetworkInterfaceResponse
31618
+ * @param request DetachDiskRequest
31619
+ * @return DetachDiskResponse
31658
31620
  */
31621
+ detachDisk(request: DetachDiskRequest): Promise<DetachDiskResponse>;
31622
+ detachInstanceRamRoleWithOptions(request: DetachInstanceRamRoleRequest, runtime: $Util.RuntimeOptions): Promise<DetachInstanceRamRoleResponse>;
31623
+ detachInstanceRamRole(request: DetachInstanceRamRoleRequest): Promise<DetachInstanceRamRoleResponse>;
31624
+ detachKeyPairWithOptions(request: DetachKeyPairRequest, runtime: $Util.RuntimeOptions): Promise<DetachKeyPairResponse>;
31625
+ detachKeyPair(request: DetachKeyPairRequest): Promise<DetachKeyPairResponse>;
31626
+ detachNetworkInterfaceWithOptions(request: DetachNetworkInterfaceRequest, runtime: $Util.RuntimeOptions): Promise<DetachNetworkInterfaceResponse>;
31659
31627
  detachNetworkInterface(request: DetachNetworkInterfaceRequest): Promise<DetachNetworkInterfaceResponse>;
31660
31628
  disableActivationWithOptions(request: DisableActivationRequest, runtime: $Util.RuntimeOptions): Promise<DisableActivationResponse>;
31661
31629
  disableActivation(request: DisableActivationRequest): Promise<DisableActivationResponse>;
@@ -31719,7 +31687,98 @@ export default class Client extends OpenApi {
31719
31687
  * @return EnablePhysicalConnectionResponse
31720
31688
  */
31721
31689
  enablePhysicalConnection(request: EnablePhysicalConnectionRequest): Promise<EnablePhysicalConnectionResponse>;
31690
+ /**
31691
+ * Before you export a custom image, complete the following operations:
31692
+ * * Understand the prerequisites and precautions. For more information, see [Export images](~~58181~~).
31693
+ * * Use Resource Access Management (RAM) to create a RAM role for ECS and grant ECS the permissions to write data to OSS. Perform the following steps:
31694
+ * 1. Create a role named `AliyunECSImageExportDefaultRole` and configure the following trust policy for the role:
31695
+ * {
31696
+ * "Statement": [
31697
+ * {
31698
+ * "Action": "sts:AssumeRole",
31699
+ * "Effect": "Allow",
31700
+ * "Principal": {
31701
+ * "Service": [
31702
+ * "ecs.aliyuncs.com"
31703
+ * ]
31704
+ * }
31705
+ * }
31706
+ * ],
31707
+ * "Version": "1"
31708
+ * }
31709
+ * 2. Attach the `AliyunECSImageExportRolePolicy` system policy to the `AliyunECSImageExportDefaultRole` role. This policy is the default policy that grants ECS the permissions to export images. For more information, go to the [Cloud Resource Access Authorization](https://ram.console.aliyun.com/?spm=5176.2020520101.0.0.64c64df5dfpmdY#/role/authorize?request=%7B%22Requests%22:%20%7B%22request1%22:%20%7B%22RoleName%22:%20%22AliyunECSImageImportDefaultRole%22,%20%22TemplateId%22:%20%22ECSImportRole%22%7D,%20%22request2%22:%20%7B%22RoleName%22:%20%22AliyunECSImageExportDefaultRole%22,%20%22TemplateId%22:%20%22ECSExportRole%22%7D%7D,%20%22ReturnUrl%22:%20%22https:%2F%2Fecs.console.aliyun.com%2F%22,%20%22Service%22:%20%22ECS%22%7D) page. You can also create a custom policy that contains the following content and attach the policy to the role:
31710
+ * {
31711
+ * "Version": "1",
31712
+ * "Statement": [
31713
+ * {
31714
+ * "Action": [
31715
+ * "oss:GetObject",
31716
+ * "oss:PutObject",
31717
+ * "oss:DeleteObject",
31718
+ * "oss:GetBucketLocation",
31719
+ * "oss:GetBucketInfo",
31720
+ * "oss:AbortMultipartUpload",
31721
+ * "oss:ListMultipartUploads",
31722
+ * "oss:ListParts"
31723
+ * ],
31724
+ * "Resource": "*",
31725
+ * "Effect": "Allow"
31726
+ * }
31727
+ * ]
31728
+ * }
31729
+ * After you export a custom image, the following situation occurs:
31730
+ * The custom image is stored in the specified OSS bucket. You can download the custom image. For more information, see [Download objects](~~31912~~).
31731
+ *
31732
+ * @param request ExportImageRequest
31733
+ * @param runtime runtime options for this request RuntimeOptions
31734
+ * @return ExportImageResponse
31735
+ */
31722
31736
  exportImageWithOptions(request: ExportImageRequest, runtime: $Util.RuntimeOptions): Promise<ExportImageResponse>;
31737
+ /**
31738
+ * Before you export a custom image, complete the following operations:
31739
+ * * Understand the prerequisites and precautions. For more information, see [Export images](~~58181~~).
31740
+ * * Use Resource Access Management (RAM) to create a RAM role for ECS and grant ECS the permissions to write data to OSS. Perform the following steps:
31741
+ * 1. Create a role named `AliyunECSImageExportDefaultRole` and configure the following trust policy for the role:
31742
+ * {
31743
+ * "Statement": [
31744
+ * {
31745
+ * "Action": "sts:AssumeRole",
31746
+ * "Effect": "Allow",
31747
+ * "Principal": {
31748
+ * "Service": [
31749
+ * "ecs.aliyuncs.com"
31750
+ * ]
31751
+ * }
31752
+ * }
31753
+ * ],
31754
+ * "Version": "1"
31755
+ * }
31756
+ * 2. Attach the `AliyunECSImageExportRolePolicy` system policy to the `AliyunECSImageExportDefaultRole` role. This policy is the default policy that grants ECS the permissions to export images. For more information, go to the [Cloud Resource Access Authorization](https://ram.console.aliyun.com/?spm=5176.2020520101.0.0.64c64df5dfpmdY#/role/authorize?request=%7B%22Requests%22:%20%7B%22request1%22:%20%7B%22RoleName%22:%20%22AliyunECSImageImportDefaultRole%22,%20%22TemplateId%22:%20%22ECSImportRole%22%7D,%20%22request2%22:%20%7B%22RoleName%22:%20%22AliyunECSImageExportDefaultRole%22,%20%22TemplateId%22:%20%22ECSExportRole%22%7D%7D,%20%22ReturnUrl%22:%20%22https:%2F%2Fecs.console.aliyun.com%2F%22,%20%22Service%22:%20%22ECS%22%7D) page. You can also create a custom policy that contains the following content and attach the policy to the role:
31757
+ * {
31758
+ * "Version": "1",
31759
+ * "Statement": [
31760
+ * {
31761
+ * "Action": [
31762
+ * "oss:GetObject",
31763
+ * "oss:PutObject",
31764
+ * "oss:DeleteObject",
31765
+ * "oss:GetBucketLocation",
31766
+ * "oss:GetBucketInfo",
31767
+ * "oss:AbortMultipartUpload",
31768
+ * "oss:ListMultipartUploads",
31769
+ * "oss:ListParts"
31770
+ * ],
31771
+ * "Resource": "*",
31772
+ * "Effect": "Allow"
31773
+ * }
31774
+ * ]
31775
+ * }
31776
+ * After you export a custom image, the following situation occurs:
31777
+ * The custom image is stored in the specified OSS bucket. You can download the custom image. For more information, see [Download objects](~~31912~~).
31778
+ *
31779
+ * @param request ExportImageRequest
31780
+ * @return ExportImageResponse
31781
+ */
31723
31782
  exportImage(request: ExportImageRequest): Promise<ExportImageResponse>;
31724
31783
  /**
31725
31784
  * @deprecated
@@ -31736,71 +31795,124 @@ export default class Client extends OpenApi {
31736
31795
  * @return ExportSnapshotResponse
31737
31796
  */
31738
31797
  exportSnapshot(request: ExportSnapshotRequest): Promise<ExportSnapshotResponse>;
31739
- /**
31740
- * * ECS is a virtualized cloud-based service and cannot be connected to display devices. However, Alibaba Cloud caches system command outputs for the last start, restart, or shutdown of ECS instances. You can call the GetInstanceConsoleOutput operation to obtain the command outputs.
31741
- * * The command outputs of instances that use the retired instance types cannot be obtained. For more information, see [Retired instance types](~~55263~~).
31742
- * * The command outputs of Windows instances cannot be obtained.
31743
- *
31744
- * @param request GetInstanceConsoleOutputRequest
31745
- * @param runtime runtime options for this request RuntimeOptions
31746
- * @return GetInstanceConsoleOutputResponse
31747
- */
31748
31798
  getInstanceConsoleOutputWithOptions(request: GetInstanceConsoleOutputRequest, runtime: $Util.RuntimeOptions): Promise<GetInstanceConsoleOutputResponse>;
31749
- /**
31750
- * * ECS is a virtualized cloud-based service and cannot be connected to display devices. However, Alibaba Cloud caches system command outputs for the last start, restart, or shutdown of ECS instances. You can call the GetInstanceConsoleOutput operation to obtain the command outputs.
31751
- * * The command outputs of instances that use the retired instance types cannot be obtained. For more information, see [Retired instance types](~~55263~~).
31752
- * * The command outputs of Windows instances cannot be obtained.
31753
- *
31754
- * @param request GetInstanceConsoleOutputRequest
31755
- * @return GetInstanceConsoleOutputResponse
31756
- */
31757
31799
  getInstanceConsoleOutput(request: GetInstanceConsoleOutputRequest): Promise<GetInstanceConsoleOutputResponse>;
31758
31800
  getInstanceScreenshotWithOptions(request: GetInstanceScreenshotRequest, runtime: $Util.RuntimeOptions): Promise<GetInstanceScreenshotResponse>;
31759
31801
  getInstanceScreenshot(request: GetInstanceScreenshotRequest): Promise<GetInstanceScreenshotResponse>;
31760
- importImageWithOptions(request: ImportImageRequest, runtime: $Util.RuntimeOptions): Promise<ImportImageResponse>;
31761
- importImage(request: ImportImageRequest): Promise<ImportImageResponse>;
31762
31802
  /**
31763
31803
  * When you call this operation, take note of the following items:
31764
- * * A maximum of 500 key pairs can be created in each region.
31765
- * * The key pair that you wan to import must support one of the following encryption methods:
31766
- * * rsa
31767
- * * dsa
31768
- * * ssh-rsa
31769
- * * ssh-dss
31770
- * * ecdsa
31771
- * * ssh-rsa-cert-v00@openssh.com
31772
- * * ssh-dss-cert-v00@openssh.com
31773
- * * ssh-rsa-cert-v01@openssh.com
31774
- * * ssh-dss-cert-v01@openssh.com
31775
- * * ecdsa-sha2-nistp256-cert-v01@openssh.com
31776
- * * ecdsa-sha2-nistp384-cert-v01@openssh.com
31777
- * * ecdsa-sha2-nistp521-cert-v01@openssh.com
31778
- *
31779
- * @param request ImportKeyPairRequest
31804
+ * * Before you can import an image, you must upload the image to an Object Storage Service (OSS) bucket. For more information, see [Upload objects](~~31886~~).
31805
+ * * In some scenarios, you may want to create a custom image from an existing server and create an ECS instance from the image. The source server can be a physical server, a virtual machine, or a cloud host. However, you must make sure that the virtio driver is installed on the source server, otherwise the ECS instance created from the resulting image may be unable to start. For more information, see [Install the virtio driver](~~62423~~).
31806
+ * * If this is the first time you import images to ECS, you must use Resource Access Management (RAM) to grant ECS the permissions to access your OSS buckets. Otherwise, the `NoSetRoletoECSServiceAcount` error code is returned when you call the ImportImage operation. The [Cloud Resource Access Authorization](https://ram.console.aliyun.com/?spm=5176.2020520101image.0.0.2ffa4df57kSoHX#/role/authorize?request=%7B%22Requests%22%3A%20%7B%22request1%22%3A%20%7B%22RoleName%22%3A%20%22AliyunECSImageImportDefaultRole%22%2C%20%22TemplateId%22%3A%20%22ECSImportRole%22%7D%2C%20%22request2%22%3A%20%7B%22RoleName%22%3A%20%22AliyunECSImageExportDefaultRole%22%2C%20%22TemplateId%22%3A%20%22ECSExportRole%22%7D%7D%2C%20%22ReturnUrl%22%3A%20%22https%3A//ecs.console.aliyun.com/%22%2C%20%22Service%22%3A%20%22ECS%22%7D) page of the RAM console provides a convenient push-button authorization function for this operation. You can also perform the authorization by using a RAM role and RAM policies. The following examples show the policies and permissions required for some steps in the authorization procedure. For more information, see [Control access to resources by using RAM users](~~25481~~).
31807
+ * 1. Create a role named `AliyunECSImageImportDefaultRole`. You must use this exact name. Otherwise, the image cannot be imported. Configure the following trust policy for the role:
31808
+ * {
31809
+ * "Statement": [
31810
+ * {
31811
+ * "Action": "sts:AssumeRole",
31812
+ * "Effect": "Allow",
31813
+ * "Principal": {
31814
+ * "Service": [
31815
+ * "ecs.aliyuncs.com"
31816
+ * ]
31817
+ * }
31818
+ * }
31819
+ * ],
31820
+ * "Version": "1"
31821
+ * }
31822
+ * 2. Attach the `AliyunECSImageImportRolePolicy` system policy to the role. You can also create a custom policy that contains the following content and attach the policy to the role:
31823
+ * ```
31824
+ * {
31825
+ * "Version": "1",
31826
+ * "Statement": [
31827
+ * {
31828
+ * "Action": [
31829
+ * "oss:GetObject",
31830
+ * "oss:GetBucketLocation",
31831
+ * "oss:GetBucketInfo"
31832
+ * ],
31833
+ * "Resource": "*",
31834
+ * "Effect": "Allow"
31835
+ * }
31836
+ * ]
31837
+ * }
31838
+ * ```
31839
+ * * You cannot delete an image that is being imported. However, you can call the [CancelTask](~~25624~~) operation to cancel the image import task.
31840
+ * * Make sure that the image is imported to the same region where the OSS bucket resides.
31841
+ * * The valid values of N in the `DiskDeviceMapping.N` parameter range from 1 to 17. When N is set to 1, the disk is a system disk. When N is set to a value from 2 to 17, the disk is a data disk.
31842
+ * * When you set the `Architecture` parameter to `arm64` or when you set the `Platform` parameter to `CentOS Stream`, `Anolis`, `AlmaLinux`, `UOS`, `Kylin`, or `Rocky Linux`, take note of the following items:
31843
+ * * If you need to set the password or modify the key pair for the imported image, make sure that the image meets the following requirements:
31844
+ * * The kernel of the operating system supports the `CONFIG_FW_CFG_SYSFS` feature. By default, this feature is supported by Linux community kernel 4.6 and later and CentOS kernel 3.10.0-826.el7 and later. You can run the `grep -nr CONFIG_FW_CFG_SYSFS /boot/config-$(uname -r)` command on the source server of the image. If the command output contains `CONFIG_FW_CFG_SYSFS=y`, the operating system kernel in this image supports the `CONFIG_FW_CFG_SYSFS` feature.
31845
+ * * The operating system is installed with the latest version of Alibaba Cloud cloud-init. The version of cloud-init 19.1 must be 19.1.3 or later. The version of cloud-init 0.7.6a in some early versions of operating systems must be 0.7.6a15 or later. For more information, see [Install cloud-init](~~57803~~).
31846
+ * * The operating system supports the SHA-512 encryption algorithm.
31847
+ * * If you want use the imported image to resize disks and file systems, make sure that the image meets the following requirements:
31848
+ * * The kernel version of the operating system is later than 3.6.
31849
+ * * The image supports the growpart command. The `cloud-utils-growpart` package is required to use this command. The methods for installing this package vary based on the operating systems. For more information, see [Resize partitions and file systems of Linux system disks](~~111738~~).
31850
+ * * The image must support the resize2fs command. The`e2fsprogs` package is required to use this command. By default, the package is installed on the operating system. If the package is not installed, install it.
31851
+ * * The operating system is installed with the latest version of Alibaba Cloud cloud-init. The version of cloud-init 19.1 must be 19.1.3 or later. The version of cloud-init 0.7.6a in some early versions of operating systems must be 0.7.6a15 or later. For more information, see [Install cloud-init](~~57803~~).
31852
+ * * If the image that you want to import uses the ARM64 architecture, you must set the real-time clock (RTC) to use the Coordinated Universal Time (UTC) time standard. For more information, see [Linux time and time zones](https://icms.alibaba-inc.com/content/ecs/image?l=1\\&m=4656\\&n=3385033).
31853
+ *
31854
+ * @param request ImportImageRequest
31780
31855
  * @param runtime runtime options for this request RuntimeOptions
31781
- * @return ImportKeyPairResponse
31856
+ * @return ImportImageResponse
31782
31857
  */
31783
- importKeyPairWithOptions(request: ImportKeyPairRequest, runtime: $Util.RuntimeOptions): Promise<ImportKeyPairResponse>;
31858
+ importImageWithOptions(request: ImportImageRequest, runtime: $Util.RuntimeOptions): Promise<ImportImageResponse>;
31784
31859
  /**
31785
31860
  * When you call this operation, take note of the following items:
31786
- * * A maximum of 500 key pairs can be created in each region.
31787
- * * The key pair that you wan to import must support one of the following encryption methods:
31788
- * * rsa
31789
- * * dsa
31790
- * * ssh-rsa
31791
- * * ssh-dss
31792
- * * ecdsa
31793
- * * ssh-rsa-cert-v00@openssh.com
31794
- * * ssh-dss-cert-v00@openssh.com
31795
- * * ssh-rsa-cert-v01@openssh.com
31796
- * * ssh-dss-cert-v01@openssh.com
31797
- * * ecdsa-sha2-nistp256-cert-v01@openssh.com
31798
- * * ecdsa-sha2-nistp384-cert-v01@openssh.com
31799
- * * ecdsa-sha2-nistp521-cert-v01@openssh.com
31800
- *
31801
- * @param request ImportKeyPairRequest
31802
- * @return ImportKeyPairResponse
31861
+ * * Before you can import an image, you must upload the image to an Object Storage Service (OSS) bucket. For more information, see [Upload objects](~~31886~~).
31862
+ * * In some scenarios, you may want to create a custom image from an existing server and create an ECS instance from the image. The source server can be a physical server, a virtual machine, or a cloud host. However, you must make sure that the virtio driver is installed on the source server, otherwise the ECS instance created from the resulting image may be unable to start. For more information, see [Install the virtio driver](~~62423~~).
31863
+ * * If this is the first time you import images to ECS, you must use Resource Access Management (RAM) to grant ECS the permissions to access your OSS buckets. Otherwise, the `NoSetRoletoECSServiceAcount` error code is returned when you call the ImportImage operation. The [Cloud Resource Access Authorization](https://ram.console.aliyun.com/?spm=5176.2020520101image.0.0.2ffa4df57kSoHX#/role/authorize?request=%7B%22Requests%22%3A%20%7B%22request1%22%3A%20%7B%22RoleName%22%3A%20%22AliyunECSImageImportDefaultRole%22%2C%20%22TemplateId%22%3A%20%22ECSImportRole%22%7D%2C%20%22request2%22%3A%20%7B%22RoleName%22%3A%20%22AliyunECSImageExportDefaultRole%22%2C%20%22TemplateId%22%3A%20%22ECSExportRole%22%7D%7D%2C%20%22ReturnUrl%22%3A%20%22https%3A//ecs.console.aliyun.com/%22%2C%20%22Service%22%3A%20%22ECS%22%7D) page of the RAM console provides a convenient push-button authorization function for this operation. You can also perform the authorization by using a RAM role and RAM policies. The following examples show the policies and permissions required for some steps in the authorization procedure. For more information, see [Control access to resources by using RAM users](~~25481~~).
31864
+ * 1. Create a role named `AliyunECSImageImportDefaultRole`. You must use this exact name. Otherwise, the image cannot be imported. Configure the following trust policy for the role:
31865
+ * {
31866
+ * "Statement": [
31867
+ * {
31868
+ * "Action": "sts:AssumeRole",
31869
+ * "Effect": "Allow",
31870
+ * "Principal": {
31871
+ * "Service": [
31872
+ * "ecs.aliyuncs.com"
31873
+ * ]
31874
+ * }
31875
+ * }
31876
+ * ],
31877
+ * "Version": "1"
31878
+ * }
31879
+ * 2. Attach the `AliyunECSImageImportRolePolicy` system policy to the role. You can also create a custom policy that contains the following content and attach the policy to the role:
31880
+ * ```
31881
+ * {
31882
+ * "Version": "1",
31883
+ * "Statement": [
31884
+ * {
31885
+ * "Action": [
31886
+ * "oss:GetObject",
31887
+ * "oss:GetBucketLocation",
31888
+ * "oss:GetBucketInfo"
31889
+ * ],
31890
+ * "Resource": "*",
31891
+ * "Effect": "Allow"
31892
+ * }
31893
+ * ]
31894
+ * }
31895
+ * ```
31896
+ * * You cannot delete an image that is being imported. However, you can call the [CancelTask](~~25624~~) operation to cancel the image import task.
31897
+ * * Make sure that the image is imported to the same region where the OSS bucket resides.
31898
+ * * The valid values of N in the `DiskDeviceMapping.N` parameter range from 1 to 17. When N is set to 1, the disk is a system disk. When N is set to a value from 2 to 17, the disk is a data disk.
31899
+ * * When you set the `Architecture` parameter to `arm64` or when you set the `Platform` parameter to `CentOS Stream`, `Anolis`, `AlmaLinux`, `UOS`, `Kylin`, or `Rocky Linux`, take note of the following items:
31900
+ * * If you need to set the password or modify the key pair for the imported image, make sure that the image meets the following requirements:
31901
+ * * The kernel of the operating system supports the `CONFIG_FW_CFG_SYSFS` feature. By default, this feature is supported by Linux community kernel 4.6 and later and CentOS kernel 3.10.0-826.el7 and later. You can run the `grep -nr CONFIG_FW_CFG_SYSFS /boot/config-$(uname -r)` command on the source server of the image. If the command output contains `CONFIG_FW_CFG_SYSFS=y`, the operating system kernel in this image supports the `CONFIG_FW_CFG_SYSFS` feature.
31902
+ * * The operating system is installed with the latest version of Alibaba Cloud cloud-init. The version of cloud-init 19.1 must be 19.1.3 or later. The version of cloud-init 0.7.6a in some early versions of operating systems must be 0.7.6a15 or later. For more information, see [Install cloud-init](~~57803~~).
31903
+ * * The operating system supports the SHA-512 encryption algorithm.
31904
+ * * If you want use the imported image to resize disks and file systems, make sure that the image meets the following requirements:
31905
+ * * The kernel version of the operating system is later than 3.6.
31906
+ * * The image supports the growpart command. The `cloud-utils-growpart` package is required to use this command. The methods for installing this package vary based on the operating systems. For more information, see [Resize partitions and file systems of Linux system disks](~~111738~~).
31907
+ * * The image must support the resize2fs command. The`e2fsprogs` package is required to use this command. By default, the package is installed on the operating system. If the package is not installed, install it.
31908
+ * * The operating system is installed with the latest version of Alibaba Cloud cloud-init. The version of cloud-init 19.1 must be 19.1.3 or later. The version of cloud-init 0.7.6a in some early versions of operating systems must be 0.7.6a15 or later. For more information, see [Install cloud-init](~~57803~~).
31909
+ * * If the image that you want to import uses the ARM64 architecture, you must set the real-time clock (RTC) to use the Coordinated Universal Time (UTC) time standard. For more information, see [Linux time and time zones](https://icms.alibaba-inc.com/content/ecs/image?l=1\\&m=4656\\&n=3385033).
31910
+ *
31911
+ * @param request ImportImageRequest
31912
+ * @return ImportImageResponse
31803
31913
  */
31914
+ importImage(request: ImportImageRequest): Promise<ImportImageResponse>;
31915
+ importKeyPairWithOptions(request: ImportKeyPairRequest, runtime: $Util.RuntimeOptions): Promise<ImportKeyPairResponse>;
31804
31916
  importKeyPair(request: ImportKeyPairRequest): Promise<ImportKeyPairResponse>;
31805
31917
  /**
31806
31918
  * @deprecated
@@ -31817,109 +31929,55 @@ export default class Client extends OpenApi {
31817
31929
  * @return ImportSnapshotResponse
31818
31930
  */
31819
31931
  importSnapshot(request: ImportSnapshotRequest): Promise<ImportSnapshotResponse>;
31820
- installCloudAssistantWithOptions(request: InstallCloudAssistantRequest, runtime: $Util.RuntimeOptions): Promise<InstallCloudAssistantResponse>;
31821
- installCloudAssistant(request: InstallCloudAssistantRequest): Promise<InstallCloudAssistantResponse>;
31822
31932
  /**
31823
- * * The ECS instances on which to run the Cloud Assistant command must meet the following requirements. If you specify multiple ECS instances and one of the instances does not meet the requirements for running the command, the call fails. Specify instances that meet the requirements and call the InvokeCommand operation again.
31824
- * * The network type is Virtual Private Cloud (VPC). For more information, see [What is a VPC?](~~34217~~)
31825
- * * The instances are in the Running (`Running`) state.
31826
- * * The Cloud Assistant client is installed on the instances. For more information, see [Install the Cloud Assistant client](~~64921~~).
31827
- * * Before you run PowerShell commands, make sure that the instances have the PowerShell module configured.
31828
- * * If `Timed` is set to false, the command is run only once.
31829
- * * If `Timed` is set to true, the command is run on a schedule.
31830
- * * The schedule is specified by the `Frequency` parameter. The results of each execution of a command do not affect the next execution of the command.
31831
- * * If you want to specify a schedule by using a cron expression, you can set a time zone based on your requirements. If you do not set a time zone, the schedule is based on the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For more information, see [Configure the NTP service and time zone for Linux instances](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
31832
- * To ensure that scheduled tasks can run as expected, make sure that the version of the Cloud Assistant client is not earlier than the following ones. A scheduled task can run a command at a specified interval, only once at a specified time, or at designated times based on a cron expression with a specified year or time zone. If the ClientNeedUpgrade error code is returned, you must upgrade the Cloud Assistant client to the latest version. For more information, see [Update or disable updates for the Cloud Assistant client](~~134383~~).
31833
- * - Linux: 2.2.3.282
31834
- * - Windows: 2.1.3.282
31835
- * * Command executions may fail due to instance status exceptions, network exceptions, or exceptions on the Cloud Assistant client. If an execution fails, no execution information is generated.
31836
- * * If you enable the custom parameter feature by setting EnableParameter to true when you create a command, you must specify custom parameters (`Parameters`) when you run the command.
31933
+ * After you call the InstallCloudAssistant operation and then the [RebootInstance](~~25502~~) operation, the Cloud Assistant client is installed and takes effect.
31837
31934
  *
31838
- * @param tmpReq InvokeCommandRequest
31935
+ * @param request InstallCloudAssistantRequest
31839
31936
  * @param runtime runtime options for this request RuntimeOptions
31840
- * @return InvokeCommandResponse
31937
+ * @return InstallCloudAssistantResponse
31841
31938
  */
31842
- invokeCommandWithOptions(tmpReq: InvokeCommandRequest, runtime: $Util.RuntimeOptions): Promise<InvokeCommandResponse>;
31939
+ installCloudAssistantWithOptions(request: InstallCloudAssistantRequest, runtime: $Util.RuntimeOptions): Promise<InstallCloudAssistantResponse>;
31843
31940
  /**
31844
- * * The ECS instances on which to run the Cloud Assistant command must meet the following requirements. If you specify multiple ECS instances and one of the instances does not meet the requirements for running the command, the call fails. Specify instances that meet the requirements and call the InvokeCommand operation again.
31845
- * * The network type is Virtual Private Cloud (VPC). For more information, see [What is a VPC?](~~34217~~)
31846
- * * The instances are in the Running (`Running`) state.
31847
- * * The Cloud Assistant client is installed on the instances. For more information, see [Install the Cloud Assistant client](~~64921~~).
31848
- * * Before you run PowerShell commands, make sure that the instances have the PowerShell module configured.
31849
- * * If `Timed` is set to false, the command is run only once.
31850
- * * If `Timed` is set to true, the command is run on a schedule.
31851
- * * The schedule is specified by the `Frequency` parameter. The results of each execution of a command do not affect the next execution of the command.
31852
- * * If you want to specify a schedule by using a cron expression, you can set a time zone based on your requirements. If you do not set a time zone, the schedule is based on the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For more information, see [Configure the NTP service and time zone for Linux instances](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
31853
- * To ensure that scheduled tasks can run as expected, make sure that the version of the Cloud Assistant client is not earlier than the following ones. A scheduled task can run a command at a specified interval, only once at a specified time, or at designated times based on a cron expression with a specified year or time zone. If the ClientNeedUpgrade error code is returned, you must upgrade the Cloud Assistant client to the latest version. For more information, see [Update or disable updates for the Cloud Assistant client](~~134383~~).
31854
- * - Linux: 2.2.3.282
31855
- * - Windows: 2.1.3.282
31856
- * * Command executions may fail due to instance status exceptions, network exceptions, or exceptions on the Cloud Assistant client. If an execution fails, no execution information is generated.
31857
- * * If you enable the custom parameter feature by setting EnableParameter to true when you create a command, you must specify custom parameters (`Parameters`) when you run the command.
31941
+ * After you call the InstallCloudAssistant operation and then the [RebootInstance](~~25502~~) operation, the Cloud Assistant client is installed and takes effect.
31858
31942
  *
31859
- * @param request InvokeCommandRequest
31860
- * @return InvokeCommandResponse
31943
+ * @param request InstallCloudAssistantRequest
31944
+ * @return InstallCloudAssistantResponse
31861
31945
  */
31946
+ installCloudAssistant(request: InstallCloudAssistantRequest): Promise<InstallCloudAssistantResponse>;
31947
+ invokeCommandWithOptions(tmpReq: InvokeCommandRequest, runtime: $Util.RuntimeOptions): Promise<InvokeCommandResponse>;
31862
31948
  invokeCommand(request: InvokeCommandRequest): Promise<InvokeCommandResponse>;
31863
- /**
31864
- * ## Description
31865
- * A resource is a cloud service entity that you create in Alibaba Cloud, such as an ECS instance, elastic network interface (ENI), or image. A resource group is a collection of infrastructure for projects, environments, or stacks. In a resource group, you can manage resources and monitor and run tasks in a centralized manner without switching between Alibaba Cloud services.
31866
- *
31867
- * @param request JoinResourceGroupRequest
31868
- * @param runtime runtime options for this request RuntimeOptions
31869
- * @return JoinResourceGroupResponse
31870
- */
31871
31949
  joinResourceGroupWithOptions(request: JoinResourceGroupRequest, runtime: $Util.RuntimeOptions): Promise<JoinResourceGroupResponse>;
31872
- /**
31873
- * ## Description
31874
- * A resource is a cloud service entity that you create in Alibaba Cloud, such as an ECS instance, elastic network interface (ENI), or image. A resource group is a collection of infrastructure for projects, environments, or stacks. In a resource group, you can manage resources and monitor and run tasks in a centralized manner without switching between Alibaba Cloud services.
31875
- *
31876
- * @param request JoinResourceGroupRequest
31877
- * @return JoinResourceGroupResponse
31878
- */
31879
31950
  joinResourceGroup(request: JoinResourceGroupRequest): Promise<JoinResourceGroupResponse>;
31880
31951
  joinSecurityGroupWithOptions(request: JoinSecurityGroupRequest, runtime: $Util.RuntimeOptions): Promise<JoinSecurityGroupResponse>;
31881
31952
  joinSecurityGroup(request: JoinSecurityGroupRequest): Promise<JoinSecurityGroupResponse>;
31882
- leaveSecurityGroupWithOptions(request: LeaveSecurityGroupRequest, runtime: $Util.RuntimeOptions): Promise<LeaveSecurityGroupResponse>;
31883
- leaveSecurityGroup(request: LeaveSecurityGroupRequest): Promise<LeaveSecurityGroupResponse>;
31884
31953
  /**
31885
- * Before you call this operation to query the states of Cloud Assistant plug-ins on ECS instances, make sure that the versions of the Cloud Assistant client installed on the instances are not earlier than the following ones:
31886
- * - 2.2.3.344 for Linux instances
31887
- * - 2.1.3.344 for Windows instances
31954
+ * > This operation is not recommended. We recommend that you call the [ModifyInstanceAttribute](~~25503~~) operation to add instances to or remove instances from a security group, and call the [ModifyNetworkInterfaceAttribute](~~58513~~) operation to add ENIs to or remove ENIs from a security group.
31955
+ * When you call this operation, take note of the following items:
31956
+ * * Before you remove an instance from a security group, the instance must be in the **Stopped** (Stopped) or **Running** (Running) state.
31957
+ * * An instance must belong to at least one security group. Therefore, if the instance to be removed belongs to only a single security group, the LeaveSecurityGroup request fails.
31958
+ * * An instance and an ENI cannot be removed from a security group at the same time. The `InstanceId` and `NetworkInterfaceId` parameters cannot be specified at the same time.
31888
31959
  *
31889
- * @param request ListPluginStatusRequest
31960
+ * @param request LeaveSecurityGroupRequest
31890
31961
  * @param runtime runtime options for this request RuntimeOptions
31891
- * @return ListPluginStatusResponse
31962
+ * @return LeaveSecurityGroupResponse
31892
31963
  */
31893
- listPluginStatusWithOptions(request: ListPluginStatusRequest, runtime: $Util.RuntimeOptions): Promise<ListPluginStatusResponse>;
31964
+ leaveSecurityGroupWithOptions(request: LeaveSecurityGroupRequest, runtime: $Util.RuntimeOptions): Promise<LeaveSecurityGroupResponse>;
31894
31965
  /**
31895
- * Before you call this operation to query the states of Cloud Assistant plug-ins on ECS instances, make sure that the versions of the Cloud Assistant client installed on the instances are not earlier than the following ones:
31896
- * - 2.2.3.344 for Linux instances
31897
- * - 2.1.3.344 for Windows instances
31966
+ * > This operation is not recommended. We recommend that you call the [ModifyInstanceAttribute](~~25503~~) operation to add instances to or remove instances from a security group, and call the [ModifyNetworkInterfaceAttribute](~~58513~~) operation to add ENIs to or remove ENIs from a security group.
31967
+ * When you call this operation, take note of the following items:
31968
+ * * Before you remove an instance from a security group, the instance must be in the **Stopped** (Stopped) or **Running** (Running) state.
31969
+ * * An instance must belong to at least one security group. Therefore, if the instance to be removed belongs to only a single security group, the LeaveSecurityGroup request fails.
31970
+ * * An instance and an ENI cannot be removed from a security group at the same time. The `InstanceId` and `NetworkInterfaceId` parameters cannot be specified at the same time.
31898
31971
  *
31899
- * @param request ListPluginStatusRequest
31900
- * @return ListPluginStatusResponse
31972
+ * @param request LeaveSecurityGroupRequest
31973
+ * @return LeaveSecurityGroupResponse
31901
31974
  */
31975
+ leaveSecurityGroup(request: LeaveSecurityGroupRequest): Promise<LeaveSecurityGroupResponse>;
31976
+ listPluginStatusWithOptions(request: ListPluginStatusRequest, runtime: $Util.RuntimeOptions): Promise<ListPluginStatusResponse>;
31902
31977
  listPluginStatus(request: ListPluginStatusRequest): Promise<ListPluginStatusResponse>;
31903
31978
  listTagResourcesWithOptions(request: ListTagResourcesRequest, runtime: $Util.RuntimeOptions): Promise<ListTagResourcesResponse>;
31904
31979
  listTagResources(request: ListTagResourcesRequest): Promise<ListTagResourcesResponse>;
31905
- /**
31906
- * Before you call this operation, take note of the following items:
31907
- * * If you modify the capacity or capacity-related settings of an auto provisioning group, the group executes a scheduling task once after the group is modified.
31908
- * * You cannot modify an auto provisioning group when the group is being deleted.
31909
- *
31910
- * @param request ModifyAutoProvisioningGroupRequest
31911
- * @param runtime runtime options for this request RuntimeOptions
31912
- * @return ModifyAutoProvisioningGroupResponse
31913
- */
31914
31980
  modifyAutoProvisioningGroupWithOptions(request: ModifyAutoProvisioningGroupRequest, runtime: $Util.RuntimeOptions): Promise<ModifyAutoProvisioningGroupResponse>;
31915
- /**
31916
- * Before you call this operation, take note of the following items:
31917
- * * If you modify the capacity or capacity-related settings of an auto provisioning group, the group executes a scheduling task once after the group is modified.
31918
- * * You cannot modify an auto provisioning group when the group is being deleted.
31919
- *
31920
- * @param request ModifyAutoProvisioningGroupRequest
31921
- * @return ModifyAutoProvisioningGroupResponse
31922
- */
31923
31981
  modifyAutoProvisioningGroup(request: ModifyAutoProvisioningGroupRequest): Promise<ModifyAutoProvisioningGroupResponse>;
31924
31982
  /**
31925
31983
  * @deprecated
@@ -31957,90 +32015,88 @@ export default class Client extends OpenApi {
31957
32015
  modifyCapacityReservation(request: ModifyCapacityReservationRequest): Promise<ModifyCapacityReservationResponse>;
31958
32016
  modifyCommandWithOptions(request: ModifyCommandRequest, runtime: $Util.RuntimeOptions): Promise<ModifyCommandResponse>;
31959
32017
  modifyCommand(request: ModifyCommandRequest): Promise<ModifyCommandResponse>;
31960
- /**
31961
- * ## Description
31962
- * * All the Elastic Compute Service (ECS) instances that are hosted on a dedicated host must be in the Stopped (`Stopped`) state before you can modify the CPU overcommit ratio of the dedicated host.
31963
- * * Modifications to the CPU overcommit ratio of a dedicated host do not affect the operation of the dedicated host. After the CPU overcommit ratio is modified, the number of allocated vCPUs on the dedicated host cannot exceed the new total number of vCPUs. Otherwise, ECS instances that use the excess vCPUs cannot start.
31964
- *
31965
- * @param request ModifyDedicatedHostAttributeRequest
31966
- * @param runtime runtime options for this request RuntimeOptions
31967
- * @return ModifyDedicatedHostAttributeResponse
31968
- */
31969
32018
  modifyDedicatedHostAttributeWithOptions(request: ModifyDedicatedHostAttributeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDedicatedHostAttributeResponse>;
31970
- /**
31971
- * ## Description
31972
- * * All the Elastic Compute Service (ECS) instances that are hosted on a dedicated host must be in the Stopped (`Stopped`) state before you can modify the CPU overcommit ratio of the dedicated host.
31973
- * * Modifications to the CPU overcommit ratio of a dedicated host do not affect the operation of the dedicated host. After the CPU overcommit ratio is modified, the number of allocated vCPUs on the dedicated host cannot exceed the new total number of vCPUs. Otherwise, ECS instances that use the excess vCPUs cannot start.
31974
- *
31975
- * @param request ModifyDedicatedHostAttributeRequest
31976
- * @return ModifyDedicatedHostAttributeResponse
31977
- */
31978
32019
  modifyDedicatedHostAttribute(request: ModifyDedicatedHostAttributeRequest): Promise<ModifyDedicatedHostAttributeResponse>;
31979
32020
  modifyDedicatedHostAutoReleaseTimeWithOptions(request: ModifyDedicatedHostAutoReleaseTimeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDedicatedHostAutoReleaseTimeResponse>;
31980
32021
  modifyDedicatedHostAutoReleaseTime(request: ModifyDedicatedHostAutoReleaseTimeRequest): Promise<ModifyDedicatedHostAutoReleaseTimeResponse>;
31981
- /**
31982
- * ## Description
31983
- * * If you enable auto-renewal for your subscription dedicated host, the dedicated host is automatically renewed nine days before expiration. The renewal fees are automatically paid at 08:00:00 (UTC+8). If the fees are not paid, they are paid at the same point in time the next day. Automatic payment stops after the fees are paid or after the dedicated host expires and is locked. Make sure that you have sufficient balance within your account.
31984
- * * Subscription dedicated hosts can be automatically renewed along with the subscription Elastic Compute Service (ECS) instances hosted on the dedicated hosts. For more information, see the description of the AutoRenewWithEcs parameter.
31985
- *
31986
- * @param request ModifyDedicatedHostAutoRenewAttributeRequest
31987
- * @param runtime runtime options for this request RuntimeOptions
31988
- * @return ModifyDedicatedHostAutoRenewAttributeResponse
31989
- */
31990
32022
  modifyDedicatedHostAutoRenewAttributeWithOptions(request: ModifyDedicatedHostAutoRenewAttributeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDedicatedHostAutoRenewAttributeResponse>;
31991
- /**
31992
- * ## Description
31993
- * * If you enable auto-renewal for your subscription dedicated host, the dedicated host is automatically renewed nine days before expiration. The renewal fees are automatically paid at 08:00:00 (UTC+8). If the fees are not paid, they are paid at the same point in time the next day. Automatic payment stops after the fees are paid or after the dedicated host expires and is locked. Make sure that you have sufficient balance within your account.
31994
- * * Subscription dedicated hosts can be automatically renewed along with the subscription Elastic Compute Service (ECS) instances hosted on the dedicated hosts. For more information, see the description of the AutoRenewWithEcs parameter.
31995
- *
31996
- * @param request ModifyDedicatedHostAutoRenewAttributeRequest
31997
- * @return ModifyDedicatedHostAutoRenewAttributeResponse
31998
- */
31999
32023
  modifyDedicatedHostAutoRenewAttribute(request: ModifyDedicatedHostAutoRenewAttributeRequest): Promise<ModifyDedicatedHostAutoRenewAttributeResponse>;
32000
32024
  modifyDedicatedHostClusterAttributeWithOptions(request: ModifyDedicatedHostClusterAttributeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDedicatedHostClusterAttributeResponse>;
32001
32025
  modifyDedicatedHostClusterAttribute(request: ModifyDedicatedHostClusterAttributeRequest): Promise<ModifyDedicatedHostClusterAttributeResponse>;
32002
32026
  modifyDedicatedHostsChargeTypeWithOptions(request: ModifyDedicatedHostsChargeTypeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDedicatedHostsChargeTypeResponse>;
32003
32027
  modifyDedicatedHostsChargeType(request: ModifyDedicatedHostsChargeTypeRequest): Promise<ModifyDedicatedHostsChargeTypeResponse>;
32028
+ /**
32029
+ * You can call this operation to modify the demand information about instance types. Alibaba Cloud provides the requested resources based on your demand. You can file demands only for I/O optimized instance types and instances of the virtual private cloud (VPC) type. Parameters except `DemandName` and `DemandDescription` can be modified only for demands that are in the Rejected state.
32030
+ * > This operation is in internal preview and has not been officially released. We recommend that you do not use this operation.
32031
+ *
32032
+ * @param request ModifyDemandRequest
32033
+ * @param runtime runtime options for this request RuntimeOptions
32034
+ * @return ModifyDemandResponse
32035
+ */
32004
32036
  modifyDemandWithOptions(request: ModifyDemandRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDemandResponse>;
32037
+ /**
32038
+ * You can call this operation to modify the demand information about instance types. Alibaba Cloud provides the requested resources based on your demand. You can file demands only for I/O optimized instance types and instances of the virtual private cloud (VPC) type. Parameters except `DemandName` and `DemandDescription` can be modified only for demands that are in the Rejected state.
32039
+ * > This operation is in internal preview and has not been officially released. We recommend that you do not use this operation.
32040
+ *
32041
+ * @param request ModifyDemandRequest
32042
+ * @return ModifyDemandResponse
32043
+ */
32005
32044
  modifyDemand(request: ModifyDemandRequest): Promise<ModifyDemandResponse>;
32006
32045
  modifyDeploymentSetAttributeWithOptions(request: ModifyDeploymentSetAttributeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDeploymentSetAttributeResponse>;
32007
32046
  modifyDeploymentSetAttribute(request: ModifyDeploymentSetAttributeRequest): Promise<ModifyDeploymentSetAttributeResponse>;
32008
32047
  modifyDiagnosticMetricSetWithOptions(request: ModifyDiagnosticMetricSetRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDiagnosticMetricSetResponse>;
32009
32048
  modifyDiagnosticMetricSet(request: ModifyDiagnosticMetricSetRequest): Promise<ModifyDiagnosticMetricSetResponse>;
32049
+ /**
32050
+ * * When you call this operation to modify the attributes of a disk, if you set the DeleteWithInstance parameter to false and the instance to which the disk is attached is locked for security reasons, the DeleteWithInstance parameter of the disk is ignored and the disk is released together with the instance. If `"LockReason" : "security"` is included in the response when you query the information about an instance, the instance is locked for security reasons.
32051
+ * * You can use the `DiskIds.N` parameter to specify multiple disks. This way, you can modify the attributes of the disks at the same time, including names, descriptions, and whether to release the disks together with the associated instances.
32052
+ *
32053
+ * @param request ModifyDiskAttributeRequest
32054
+ * @param runtime runtime options for this request RuntimeOptions
32055
+ * @return ModifyDiskAttributeResponse
32056
+ */
32010
32057
  modifyDiskAttributeWithOptions(request: ModifyDiskAttributeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDiskAttributeResponse>;
32058
+ /**
32059
+ * * When you call this operation to modify the attributes of a disk, if you set the DeleteWithInstance parameter to false and the instance to which the disk is attached is locked for security reasons, the DeleteWithInstance parameter of the disk is ignored and the disk is released together with the instance. If `"LockReason" : "security"` is included in the response when you query the information about an instance, the instance is locked for security reasons.
32060
+ * * You can use the `DiskIds.N` parameter to specify multiple disks. This way, you can modify the attributes of the disks at the same time, including names, descriptions, and whether to release the disks together with the associated instances.
32061
+ *
32062
+ * @param request ModifyDiskAttributeRequest
32063
+ * @return ModifyDiskAttributeResponse
32064
+ */
32011
32065
  modifyDiskAttribute(request: ModifyDiskAttributeRequest): Promise<ModifyDiskAttributeResponse>;
32066
+ modifyDiskChargeTypeWithOptions(request: ModifyDiskChargeTypeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDiskChargeTypeResponse>;
32067
+ modifyDiskChargeType(request: ModifyDiskChargeTypeRequest): Promise<ModifyDiskChargeTypeResponse>;
32012
32068
  /**
32013
32069
  * ## Description
32014
- * After you change the billing method, automatic payment is enabled by default. Make sure that you have sufficient balance in your account. Otherwise, your order becomes invalid and must be canceled. If your account balance is insufficient, you can set the AutoPay parameter to false to generate an unpaid order. Then, you can log on to the [ECS console](https://ecs.console.aliyun.com/) to pay for the order.
32015
32070
  * When you call this operation, take note of the following items:
32016
- * * You can change the billing method from subscription to pay-as-you-go for subscription disks that are attached to a subscription instance.
32017
- * * You can change the billing method from pay-as-you-go to subscription for pay-as-you-go data disks that are attached to a subscription or pay-as-you-go instance.
32018
- * * The instance cannot be in the Stopped state due to overdue payments.
32019
- * * You can change the billing method for each disk three times at most. A maximum of three refunds can be made for price differences for a single instance.
32020
- * * The price difference is refunded to the payment account you used. Coupons that have been redeemed are not refundable.
32021
- * * You cannot change the billing method of a disk again within five minutes after the billing method is changed.
32022
- *
32023
- * @param request ModifyDiskChargeTypeRequest
32071
+ * * To modify the performance level of an ESSD, take note of the following items:
32072
+ * * For a subscription ESSD, you can only upgrade its performance level.
32073
+ * * For a pay-as-you-go ESSD, You can upgrade or downgrade its performance level. However, you cannot downgrade the performance level to PL0.
32074
+ * * The ESSD must be in the **In Use** (In_Use) or **Unattached** (Available) state.
32075
+ * * If the ESSD is attached to an ECS instance, the instance must be in the **Running** (Running) or **Stopped** (Stopped) state. The instance cannot be in the Expired state or stopped due to an overdue payment.
32076
+ * * If you cannot upgrade the performance level of the ESSD due to its capacity, resize the ESSD by calling the [ResizeDisk](~~25522~~) operation and then try again. For more information, see [Enhanced SSDs](~~122389~~).
32077
+ * * For more information about the limits on changing the category of a disk, see the "Limits" section of the [Change the category of a disk](~~161980~~) topic.
32078
+ * The new disk category or performance level takes effect immediately after this operation is executed. Alibaba Cloud calculates the bill based on the new disk category and performance level.
32079
+ *
32080
+ * @param request ModifyDiskSpecRequest
32024
32081
  * @param runtime runtime options for this request RuntimeOptions
32025
- * @return ModifyDiskChargeTypeResponse
32082
+ * @return ModifyDiskSpecResponse
32026
32083
  */
32027
- modifyDiskChargeTypeWithOptions(request: ModifyDiskChargeTypeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDiskChargeTypeResponse>;
32084
+ modifyDiskSpecWithOptions(request: ModifyDiskSpecRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDiskSpecResponse>;
32028
32085
  /**
32029
32086
  * ## Description
32030
- * After you change the billing method, automatic payment is enabled by default. Make sure that you have sufficient balance in your account. Otherwise, your order becomes invalid and must be canceled. If your account balance is insufficient, you can set the AutoPay parameter to false to generate an unpaid order. Then, you can log on to the [ECS console](https://ecs.console.aliyun.com/) to pay for the order.
32031
32087
  * When you call this operation, take note of the following items:
32032
- * * You can change the billing method from subscription to pay-as-you-go for subscription disks that are attached to a subscription instance.
32033
- * * You can change the billing method from pay-as-you-go to subscription for pay-as-you-go data disks that are attached to a subscription or pay-as-you-go instance.
32034
- * * The instance cannot be in the Stopped state due to overdue payments.
32035
- * * You can change the billing method for each disk three times at most. A maximum of three refunds can be made for price differences for a single instance.
32036
- * * The price difference is refunded to the payment account you used. Coupons that have been redeemed are not refundable.
32037
- * * You cannot change the billing method of a disk again within five minutes after the billing method is changed.
32038
- *
32039
- * @param request ModifyDiskChargeTypeRequest
32040
- * @return ModifyDiskChargeTypeResponse
32088
+ * * To modify the performance level of an ESSD, take note of the following items:
32089
+ * * For a subscription ESSD, you can only upgrade its performance level.
32090
+ * * For a pay-as-you-go ESSD, You can upgrade or downgrade its performance level. However, you cannot downgrade the performance level to PL0.
32091
+ * * The ESSD must be in the **In Use** (In_Use) or **Unattached** (Available) state.
32092
+ * * If the ESSD is attached to an ECS instance, the instance must be in the **Running** (Running) or **Stopped** (Stopped) state. The instance cannot be in the Expired state or stopped due to an overdue payment.
32093
+ * * If you cannot upgrade the performance level of the ESSD due to its capacity, resize the ESSD by calling the [ResizeDisk](~~25522~~) operation and then try again. For more information, see [Enhanced SSDs](~~122389~~).
32094
+ * * For more information about the limits on changing the category of a disk, see the "Limits" section of the [Change the category of a disk](~~161980~~) topic.
32095
+ * The new disk category or performance level takes effect immediately after this operation is executed. Alibaba Cloud calculates the bill based on the new disk category and performance level.
32096
+ *
32097
+ * @param request ModifyDiskSpecRequest
32098
+ * @return ModifyDiskSpecResponse
32041
32099
  */
32042
- modifyDiskChargeType(request: ModifyDiskChargeTypeRequest): Promise<ModifyDiskChargeTypeResponse>;
32043
- modifyDiskSpecWithOptions(request: ModifyDiskSpecRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDiskSpecResponse>;
32044
32100
  modifyDiskSpec(request: ModifyDiskSpecRequest): Promise<ModifyDiskSpecResponse>;
32045
32101
  /**
32046
32102
  * @deprecated
@@ -32108,7 +32164,40 @@ export default class Client extends OpenApi {
32108
32164
  * @return ModifyImageShareGroupPermissionResponse
32109
32165
  */
32110
32166
  modifyImageShareGroupPermission(request: ModifyImageShareGroupPermissionRequest): Promise<ModifyImageShareGroupPermissionResponse>;
32167
+ /**
32168
+ * When you call this operation, take note of the following items:
32169
+ * * You can share only your custom images with other Alibaba Cloud accounts.
32170
+ * * You can share a custom image with up to 10 Alibaba Cloud accounts in a request. You can specify up to 10 Alibaba Cloud account IDs by using the AddAccount.N parameter or the RemoveAccount.N parameter. If you specify more than 10 account IDs, the parameter value does not take effect.
32171
+ * * You can share a custom image with up to 50 Alibaba Cloud accounts in total.
32172
+ * * After you create an instance from a shared custom image by calling the [RunInstances](~~63440~~) operation, you cannot call the [ReInitDisk](~~25519~~) operation to reinitialize the system disk of the instance if the image owner unshares the image or calls the [DeleteImage](~~25537~~) operation to delete the image.
32173
+ * To publish or unpublish a community image, take note of the following items:
32174
+ * * Alibaba Cloud provides only the platform where the community images can be published and managed. The owner of a community image is responsible for the quality and updates of the image. Make sure that you read and agree to the Community Image Agreement. Otherwise, you cannot publish community images. For more information, see [Publish a community image](~~208370~~)
32175
+ * * You cannot publish encrypted images as community images.
32176
+ * * All community images are publicly available. All Alibaba Cloud accounts that reside in the same region as a community image can access the image.
32177
+ * * You cannot share, export, or copy community images.
32178
+ * * After a community image is unpublished, the image is no longer available to Alibaba Cloud accounts. If you share a custom image with specific Alibaba cloud accounts and then publish the image as a community image, the image is still shared with the accounts.
32179
+ *
32180
+ * @param request ModifyImageSharePermissionRequest
32181
+ * @param runtime runtime options for this request RuntimeOptions
32182
+ * @return ModifyImageSharePermissionResponse
32183
+ */
32111
32184
  modifyImageSharePermissionWithOptions(request: ModifyImageSharePermissionRequest, runtime: $Util.RuntimeOptions): Promise<ModifyImageSharePermissionResponse>;
32185
+ /**
32186
+ * When you call this operation, take note of the following items:
32187
+ * * You can share only your custom images with other Alibaba Cloud accounts.
32188
+ * * You can share a custom image with up to 10 Alibaba Cloud accounts in a request. You can specify up to 10 Alibaba Cloud account IDs by using the AddAccount.N parameter or the RemoveAccount.N parameter. If you specify more than 10 account IDs, the parameter value does not take effect.
32189
+ * * You can share a custom image with up to 50 Alibaba Cloud accounts in total.
32190
+ * * After you create an instance from a shared custom image by calling the [RunInstances](~~63440~~) operation, you cannot call the [ReInitDisk](~~25519~~) operation to reinitialize the system disk of the instance if the image owner unshares the image or calls the [DeleteImage](~~25537~~) operation to delete the image.
32191
+ * To publish or unpublish a community image, take note of the following items:
32192
+ * * Alibaba Cloud provides only the platform where the community images can be published and managed. The owner of a community image is responsible for the quality and updates of the image. Make sure that you read and agree to the Community Image Agreement. Otherwise, you cannot publish community images. For more information, see [Publish a community image](~~208370~~)
32193
+ * * You cannot publish encrypted images as community images.
32194
+ * * All community images are publicly available. All Alibaba Cloud accounts that reside in the same region as a community image can access the image.
32195
+ * * You cannot share, export, or copy community images.
32196
+ * * After a community image is unpublished, the image is no longer available to Alibaba Cloud accounts. If you share a custom image with specific Alibaba cloud accounts and then publish the image as a community image, the image is still shared with the accounts.
32197
+ *
32198
+ * @param request ModifyImageSharePermissionRequest
32199
+ * @return ModifyImageSharePermissionResponse
32200
+ */
32112
32201
  modifyImageSharePermission(request: ModifyImageSharePermissionRequest): Promise<ModifyImageSharePermissionResponse>;
32113
32202
  modifyInstanceAttachmentAttributesWithOptions(request: ModifyInstanceAttachmentAttributesRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceAttachmentAttributesResponse>;
32114
32203
  modifyInstanceAttachmentAttributes(request: ModifyInstanceAttachmentAttributesRequest): Promise<ModifyInstanceAttachmentAttributesResponse>;
@@ -32116,42 +32205,28 @@ export default class Client extends OpenApi {
32116
32205
  modifyInstanceAttribute(request: ModifyInstanceAttributeRequest): Promise<ModifyInstanceAttributeResponse>;
32117
32206
  modifyInstanceAutoReleaseTimeWithOptions(request: ModifyInstanceAutoReleaseTimeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceAutoReleaseTimeResponse>;
32118
32207
  modifyInstanceAutoReleaseTime(request: ModifyInstanceAutoReleaseTimeRequest): Promise<ModifyInstanceAutoReleaseTimeResponse>;
32119
- modifyInstanceAutoRenewAttributeWithOptions(request: ModifyInstanceAutoRenewAttributeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceAutoRenewAttributeResponse>;
32120
- modifyInstanceAutoRenewAttribute(request: ModifyInstanceAutoRenewAttributeRequest): Promise<ModifyInstanceAutoRenewAttributeResponse>;
32121
32208
  /**
32122
- * Before you call this operation, make sure that you understand the billing methods and pricing schedule of ECS. For more information, see the [Elastic Compute Service](https://www.alibabacloud.com/product/ecs#pricing) product page.
32123
- * When you call this operation, take note of the following items:
32124
- * * The instances must be in the **Running** (`Running`) or **Stopped** (`Stopped`) state, and you have no overdue payments for them.
32125
- * * After you change the billing method, automatic payment is enabled by default. Make sure that you have sufficient balance in your account. Otherwise, your order becomes invalid and is canceled. If your account balance is insufficient, you can set the `AutoPay` parameter to `false` to generate an unpaid order. Then, you can log on to the [ECS console](https://ecs.console.aliyun.com/) to pay for the order.
32126
- * * **Change the billing method from subscription to pay-as-you-go**:
32127
- * * Your ECS usage determines whether the billing method of an instance can be changed from subscription to pay-as-you-go.
32128
- * * After you change the billing method of an instance from subscription to pay-as-you-go, the new billing method remains in effect for the remaining lifecycle of the instance. The price difference is refunded to the payment account that you used. Vouchers that have been redeemed are not refundable.
32129
- * * **Refund rule**: You have a quota for the total refund amount each month, and unused balance of this quota is not carried forward into the next month. After you use up the refund quota of the current month, you can change the billing method only when the next month arrives. The refund amount incurred when you change the billing method is calculated based on the following formula: **Number of vCPUs × (Number of remaining days × 24 ± Number of remaining or elapsed hours)**.
32130
- * * **Change the billing method from pay-as-you-go to subscription**:
32131
- * * You can change the billing method of all data disks attached to an instance from pay-as-you-go to subscription.
32132
- * * This operation cannot be called for a pay-as-you-go instance that has an automatic release time set.
32133
- *
32134
- * @param request ModifyInstanceChargeTypeRequest
32209
+ * Before you call this operation, make sure that you understand the billing methods and pricing schedule of Elastic Compute Service (ECS). For more information, see the [Elastic Compute Service](https://www.aliyun.com/price/product#/ecs/detail) product page.
32210
+ * * The payment for auto-renewal is first deducted automatically at 08:00:00 (UTC+8) nine days before the instance expires.
32211
+ * * If the subscription period of a new instance is one week, the renewal payment is automatically deducted on the day the instance is created.
32212
+ * * If the first deduction attempt fails, Alibaba Cloud attempts to deduct the payment each day until the payment is deducted or until the instance is locked after the nine-day period ends. Make sure that your account balance or credit balance is sufficient.
32213
+ *
32214
+ * @param request ModifyInstanceAutoRenewAttributeRequest
32135
32215
  * @param runtime runtime options for this request RuntimeOptions
32136
- * @return ModifyInstanceChargeTypeResponse
32216
+ * @return ModifyInstanceAutoRenewAttributeResponse
32137
32217
  */
32138
- modifyInstanceChargeTypeWithOptions(request: ModifyInstanceChargeTypeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceChargeTypeResponse>;
32218
+ modifyInstanceAutoRenewAttributeWithOptions(request: ModifyInstanceAutoRenewAttributeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceAutoRenewAttributeResponse>;
32139
32219
  /**
32140
- * Before you call this operation, make sure that you understand the billing methods and pricing schedule of ECS. For more information, see the [Elastic Compute Service](https://www.alibabacloud.com/product/ecs#pricing) product page.
32141
- * When you call this operation, take note of the following items:
32142
- * * The instances must be in the **Running** (`Running`) or **Stopped** (`Stopped`) state, and you have no overdue payments for them.
32143
- * * After you change the billing method, automatic payment is enabled by default. Make sure that you have sufficient balance in your account. Otherwise, your order becomes invalid and is canceled. If your account balance is insufficient, you can set the `AutoPay` parameter to `false` to generate an unpaid order. Then, you can log on to the [ECS console](https://ecs.console.aliyun.com/) to pay for the order.
32144
- * * **Change the billing method from subscription to pay-as-you-go**:
32145
- * * Your ECS usage determines whether the billing method of an instance can be changed from subscription to pay-as-you-go.
32146
- * * After you change the billing method of an instance from subscription to pay-as-you-go, the new billing method remains in effect for the remaining lifecycle of the instance. The price difference is refunded to the payment account that you used. Vouchers that have been redeemed are not refundable.
32147
- * * **Refund rule**: You have a quota for the total refund amount each month, and unused balance of this quota is not carried forward into the next month. After you use up the refund quota of the current month, you can change the billing method only when the next month arrives. The refund amount incurred when you change the billing method is calculated based on the following formula: **Number of vCPUs × (Number of remaining days × 24 ± Number of remaining or elapsed hours)**.
32148
- * * **Change the billing method from pay-as-you-go to subscription**:
32149
- * * You can change the billing method of all data disks attached to an instance from pay-as-you-go to subscription.
32150
- * * This operation cannot be called for a pay-as-you-go instance that has an automatic release time set.
32151
- *
32152
- * @param request ModifyInstanceChargeTypeRequest
32153
- * @return ModifyInstanceChargeTypeResponse
32220
+ * Before you call this operation, make sure that you understand the billing methods and pricing schedule of Elastic Compute Service (ECS). For more information, see the [Elastic Compute Service](https://www.aliyun.com/price/product#/ecs/detail) product page.
32221
+ * * The payment for auto-renewal is first deducted automatically at 08:00:00 (UTC+8) nine days before the instance expires.
32222
+ * * If the subscription period of a new instance is one week, the renewal payment is automatically deducted on the day the instance is created.
32223
+ * * If the first deduction attempt fails, Alibaba Cloud attempts to deduct the payment each day until the payment is deducted or until the instance is locked after the nine-day period ends. Make sure that your account balance or credit balance is sufficient.
32224
+ *
32225
+ * @param request ModifyInstanceAutoRenewAttributeRequest
32226
+ * @return ModifyInstanceAutoRenewAttributeResponse
32154
32227
  */
32228
+ modifyInstanceAutoRenewAttribute(request: ModifyInstanceAutoRenewAttributeRequest): Promise<ModifyInstanceAutoRenewAttributeResponse>;
32229
+ modifyInstanceChargeTypeWithOptions(request: ModifyInstanceChargeTypeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceChargeTypeResponse>;
32155
32230
  modifyInstanceChargeType(request: ModifyInstanceChargeTypeRequest): Promise<ModifyInstanceChargeTypeResponse>;
32156
32231
  /**
32157
32232
  * When you call this operation for an ECS instance, take note of the following items:
@@ -32184,13 +32259,126 @@ export default class Client extends OpenApi {
32184
32259
  modifyInstanceMaintenanceAttributes(request: ModifyInstanceMaintenanceAttributesRequest): Promise<ModifyInstanceMaintenanceAttributesResponse>;
32185
32260
  modifyInstanceMetadataOptionsWithOptions(request: ModifyInstanceMetadataOptionsRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceMetadataOptionsResponse>;
32186
32261
  modifyInstanceMetadataOptions(request: ModifyInstanceMetadataOptionsRequest): Promise<ModifyInstanceMetadataOptionsResponse>;
32262
+ /**
32263
+ * When you call this operation, take note of the following items:
32264
+ * * As of November 27, 2020, the maximum bandwidth value available for you to create ECS instances or to change ECS instance configurations is subject to throttling policies for your account. To increase the maximum bandwidth value, submit a ticket. The following throttling policies apply:
32265
+ * * Within a single region, the sum of actual peak bandwidths of all ECS instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s.
32266
+ * * Within a single region, the sum of actual peak bandwidths of all ECS instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
32267
+ * * If you upgrade the outbound public bandwidth (InternetMaxBandwidthOut) of a subscription (PrePaid) instance from 0 Mbit/s when you modify the bandwidth configurations of the instance, a public IP address is automatically assigned to the instance.
32268
+ * * If you upgrade the outbound public bandwidth (InternetMaxBandwidthOut) of a pay-as-you-go (PostPaid) instance from 0 Mbit/s when you modify the bandwidth configurations of the instance, no public IP address is automatically assigned to the instance. You must call the [AllocatePublicIpAddress](~~25544~~) operation to assign a public IP address to the instance.
32269
+ * * An instance in the classic network must be in the Stopped state before you can upgrade the outbound public bandwidth (InternetMaxBandwidthOut) of the instance from 0 Mbit/s.
32270
+ * * After the bandwidth is upgraded, AutoPay is set to true by default and the payment is automatically made. Maintain a sufficient account balance. Otherwise, your order becomes invalid and must be canceled. If your account balance is insufficient, you can set AutoPay to false. When you call the ModifyInstanceNetworkSpec operation, an unpaid order is generated. Then, you can log on to the ECS console to pay for the order.
32271
+ * * The price difference is refunded to the payment account that you used. Vouchers or coupons that have been redeemed cannot be returned.
32272
+ *
32273
+ * @param request ModifyInstanceNetworkSpecRequest
32274
+ * @param runtime runtime options for this request RuntimeOptions
32275
+ * @return ModifyInstanceNetworkSpecResponse
32276
+ */
32187
32277
  modifyInstanceNetworkSpecWithOptions(request: ModifyInstanceNetworkSpecRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceNetworkSpecResponse>;
32278
+ /**
32279
+ * When you call this operation, take note of the following items:
32280
+ * * As of November 27, 2020, the maximum bandwidth value available for you to create ECS instances or to change ECS instance configurations is subject to throttling policies for your account. To increase the maximum bandwidth value, submit a ticket. The following throttling policies apply:
32281
+ * * Within a single region, the sum of actual peak bandwidths of all ECS instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s.
32282
+ * * Within a single region, the sum of actual peak bandwidths of all ECS instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
32283
+ * * If you upgrade the outbound public bandwidth (InternetMaxBandwidthOut) of a subscription (PrePaid) instance from 0 Mbit/s when you modify the bandwidth configurations of the instance, a public IP address is automatically assigned to the instance.
32284
+ * * If you upgrade the outbound public bandwidth (InternetMaxBandwidthOut) of a pay-as-you-go (PostPaid) instance from 0 Mbit/s when you modify the bandwidth configurations of the instance, no public IP address is automatically assigned to the instance. You must call the [AllocatePublicIpAddress](~~25544~~) operation to assign a public IP address to the instance.
32285
+ * * An instance in the classic network must be in the Stopped state before you can upgrade the outbound public bandwidth (InternetMaxBandwidthOut) of the instance from 0 Mbit/s.
32286
+ * * After the bandwidth is upgraded, AutoPay is set to true by default and the payment is automatically made. Maintain a sufficient account balance. Otherwise, your order becomes invalid and must be canceled. If your account balance is insufficient, you can set AutoPay to false. When you call the ModifyInstanceNetworkSpec operation, an unpaid order is generated. Then, you can log on to the ECS console to pay for the order.
32287
+ * * The price difference is refunded to the payment account that you used. Vouchers or coupons that have been redeemed cannot be returned.
32288
+ *
32289
+ * @param request ModifyInstanceNetworkSpecRequest
32290
+ * @return ModifyInstanceNetworkSpecResponse
32291
+ */
32188
32292
  modifyInstanceNetworkSpec(request: ModifyInstanceNetworkSpecRequest): Promise<ModifyInstanceNetworkSpecResponse>;
32189
32293
  modifyInstanceSpecWithOptions(request: ModifyInstanceSpecRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceSpecResponse>;
32190
32294
  modifyInstanceSpec(request: ModifyInstanceSpecRequest): Promise<ModifyInstanceSpecResponse>;
32295
+ /**
32296
+ * * The password must be six characters in length and can contain only uppercase letters, lowercase letters, and digits.
32297
+ * * After you modify the VNC password of an instance, take note of the following items:
32298
+ * * If the instance is I/O optimized, the new password takes effect immediately.
32299
+ * * If the instance is non-I/O optimized, you must [restart the instance](~~25440~~) by using the ECS console or by calling the [RebootInstance](~~25502~~) operation for the new password to take effect.
32300
+ *
32301
+ * @param request ModifyInstanceVncPasswdRequest
32302
+ * @param runtime runtime options for this request RuntimeOptions
32303
+ * @return ModifyInstanceVncPasswdResponse
32304
+ */
32191
32305
  modifyInstanceVncPasswdWithOptions(request: ModifyInstanceVncPasswdRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceVncPasswdResponse>;
32306
+ /**
32307
+ * * The password must be six characters in length and can contain only uppercase letters, lowercase letters, and digits.
32308
+ * * After you modify the VNC password of an instance, take note of the following items:
32309
+ * * If the instance is I/O optimized, the new password takes effect immediately.
32310
+ * * If the instance is non-I/O optimized, you must [restart the instance](~~25440~~) by using the ECS console or by calling the [RebootInstance](~~25502~~) operation for the new password to take effect.
32311
+ *
32312
+ * @param request ModifyInstanceVncPasswdRequest
32313
+ * @return ModifyInstanceVncPasswdResponse
32314
+ */
32192
32315
  modifyInstanceVncPasswd(request: ModifyInstanceVncPasswdRequest): Promise<ModifyInstanceVncPasswdResponse>;
32316
+ /**
32317
+ * The instance must be in the **Stopped** state.``
32318
+ * * When you call this operation to modify the private IP address or vSwitch of an instance, take note of the following items:
32319
+ * * If the instance is newly created, you must restart the instance before you can call this operation.
32320
+ * * After you modify the private IP address or vSwitch of an instance, you must restart the instance before you can call this operation again.
32321
+ * * When you call this operation to modify the VPC of an instance, take note of the following items:
32322
+ * * **Instance:**
32323
+ * * The instance cannot be associated with Server Load Balancer (SLB) instances.
32324
+ * * The instance cannot be in the Locked, To Be Released, Expired, Expired and Being Recycled, or Overdue and Being Recycled state. For more information, see [ECS instance lifecycle](~~25380~~).
32325
+ * * The instance cannot be in-use or used in conjunction with other cloud services. For example, the instance cannot be in the process of being migrated or having its VPC changed, or the databases deployed on the instance cannot be managed by Data Transmission Service (DTS).
32326
+ * * **Network:**
32327
+ * * The cut-through mode or multi-elastic IP address (EIP) to elastic network interface (ENI) mode must be disabled.
32328
+ * * The instance cannot be associated with a high-availability virtual IP address (HAVIP).
32329
+ * * The vSwitch of the instance cannot be associated with a custom route table.
32330
+ * * The instance cannot have Global Accelerator (GA) activated.
32331
+ * * The instance cannot have secondary ENIs bound.
32332
+ * * The instance cannot have IPv6 addresses assigned.
32333
+ * * The primary ENI of the instance cannot be associated with multiple IP addresses.
32334
+ * * The vSwitch specified by the VSwitchId parameter must belong to the new VPC.
32335
+ * * The new and original vSwitches must reside within the same zone.
32336
+ * * If the private IP address of the primary ENI is specified, the private IP address must be available and within the CIDR block of the vSwitch. If the private IP address is not specified, the system randomly assigns one. The available IP addresses in the CIDR block of the new vSwitch must be sufficient.
32337
+ * * If advanced features are enabled in the new VPC, take note of the instance families that do not support advanced VPC features. For more information, see [Instance families that do not support advanced VPC features](~~163466~~).
32338
+ * * The Alibaba Cloud account that owns the new VPC cannot share the VPC with other accounts.
32339
+ * * **Security group (SecurityGroupId.N):**
32340
+ * * All security groups must be of the same type.
32341
+ * * The valid values of N depend on the maximum number of security groups to which an instance can belong. For more information, see [Limits](~~25412~~).
32342
+ * * The specified security groups must belong to the new VPC.
32343
+ * * You can switch the instance to a security group of a different type. If you want to switch an instance to a security group of a different type, you must understand the differences between the rule configurations of the two security group types to avoid impacts on the instance network. For more information, see [Overview](~~25387~~).
32344
+ *
32345
+ * @param request ModifyInstanceVpcAttributeRequest
32346
+ * @param runtime runtime options for this request RuntimeOptions
32347
+ * @return ModifyInstanceVpcAttributeResponse
32348
+ */
32193
32349
  modifyInstanceVpcAttributeWithOptions(request: ModifyInstanceVpcAttributeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyInstanceVpcAttributeResponse>;
32350
+ /**
32351
+ * The instance must be in the **Stopped** state.``
32352
+ * * When you call this operation to modify the private IP address or vSwitch of an instance, take note of the following items:
32353
+ * * If the instance is newly created, you must restart the instance before you can call this operation.
32354
+ * * After you modify the private IP address or vSwitch of an instance, you must restart the instance before you can call this operation again.
32355
+ * * When you call this operation to modify the VPC of an instance, take note of the following items:
32356
+ * * **Instance:**
32357
+ * * The instance cannot be associated with Server Load Balancer (SLB) instances.
32358
+ * * The instance cannot be in the Locked, To Be Released, Expired, Expired and Being Recycled, or Overdue and Being Recycled state. For more information, see [ECS instance lifecycle](~~25380~~).
32359
+ * * The instance cannot be in-use or used in conjunction with other cloud services. For example, the instance cannot be in the process of being migrated or having its VPC changed, or the databases deployed on the instance cannot be managed by Data Transmission Service (DTS).
32360
+ * * **Network:**
32361
+ * * The cut-through mode or multi-elastic IP address (EIP) to elastic network interface (ENI) mode must be disabled.
32362
+ * * The instance cannot be associated with a high-availability virtual IP address (HAVIP).
32363
+ * * The vSwitch of the instance cannot be associated with a custom route table.
32364
+ * * The instance cannot have Global Accelerator (GA) activated.
32365
+ * * The instance cannot have secondary ENIs bound.
32366
+ * * The instance cannot have IPv6 addresses assigned.
32367
+ * * The primary ENI of the instance cannot be associated with multiple IP addresses.
32368
+ * * The vSwitch specified by the VSwitchId parameter must belong to the new VPC.
32369
+ * * The new and original vSwitches must reside within the same zone.
32370
+ * * If the private IP address of the primary ENI is specified, the private IP address must be available and within the CIDR block of the vSwitch. If the private IP address is not specified, the system randomly assigns one. The available IP addresses in the CIDR block of the new vSwitch must be sufficient.
32371
+ * * If advanced features are enabled in the new VPC, take note of the instance families that do not support advanced VPC features. For more information, see [Instance families that do not support advanced VPC features](~~163466~~).
32372
+ * * The Alibaba Cloud account that owns the new VPC cannot share the VPC with other accounts.
32373
+ * * **Security group (SecurityGroupId.N):**
32374
+ * * All security groups must be of the same type.
32375
+ * * The valid values of N depend on the maximum number of security groups to which an instance can belong. For more information, see [Limits](~~25412~~).
32376
+ * * The specified security groups must belong to the new VPC.
32377
+ * * You can switch the instance to a security group of a different type. If you want to switch an instance to a security group of a different type, you must understand the differences between the rule configurations of the two security group types to avoid impacts on the instance network. For more information, see [Overview](~~25387~~).
32378
+ *
32379
+ * @param request ModifyInstanceVpcAttributeRequest
32380
+ * @return ModifyInstanceVpcAttributeResponse
32381
+ */
32194
32382
  modifyInstanceVpcAttribute(request: ModifyInstanceVpcAttributeRequest): Promise<ModifyInstanceVpcAttributeResponse>;
32195
32383
  modifyLaunchTemplateDefaultVersionWithOptions(request: ModifyLaunchTemplateDefaultVersionRequest, runtime: $Util.RuntimeOptions): Promise<ModifyLaunchTemplateDefaultVersionResponse>;
32196
32384
  modifyLaunchTemplateDefaultVersion(request: ModifyLaunchTemplateDefaultVersionRequest): Promise<ModifyLaunchTemplateDefaultVersionResponse>;
@@ -32213,32 +32401,7 @@ export default class Client extends OpenApi {
32213
32401
  * @return ModifyPhysicalConnectionAttributeResponse
32214
32402
  */
32215
32403
  modifyPhysicalConnectionAttribute(request: ModifyPhysicalConnectionAttributeRequest): Promise<ModifyPhysicalConnectionAttributeResponse>;
32216
- /**
32217
- * ## Description
32218
- * * The specified CIDR block must be valid. For example, 10.0.0.0/8 is a valid CIDR block while 10.0.0.1/8 is not. For more information, see the [What is CIDR?](https://www.alibabacloud.com/help/doc-detail/40637.htm#section-jua-0tj-q5m) section in Network FAQ.
32219
- * * When you add or delete an entry, you cannot specify duplicate CIDR blocks. Examples:
32220
- * * For IPv4 CIDR blocks, you cannot specify the 10.0.0.0/8 CIDR block in two entries. You cannot specify the 10.0.0.1/32 CIDR block in one entry and the 10.0.0.1 CIDR block in another entry. These two CIDR blocks are the same.
32221
- * * For IPv6 CIDR blocks, you cannot specify the 2001:fd01:0:0:0:0:0:0/32 CIDR block in one entry and the 2001:fd01::/32 CIDR block in another entry. These two CIDR blocks are the same.
32222
- * * The CIDR block in an entry to be added cannot the same as that in an entry to be deleted. For example, when you add an entry in which the 10.0.0.0/8 CIDR block is specified, the entry to be deleted cannot have the 10.0.0.0/8 CIDR block specified.
32223
- * * If you want to modify the description of an entry, you must specify the CIDR block (`AddEntry.N.Cidr`) and new description (`AddEntry.N.Description`) in the entry.
32224
- *
32225
- * @param request ModifyPrefixListRequest
32226
- * @param runtime runtime options for this request RuntimeOptions
32227
- * @return ModifyPrefixListResponse
32228
- */
32229
32404
  modifyPrefixListWithOptions(request: ModifyPrefixListRequest, runtime: $Util.RuntimeOptions): Promise<ModifyPrefixListResponse>;
32230
- /**
32231
- * ## Description
32232
- * * The specified CIDR block must be valid. For example, 10.0.0.0/8 is a valid CIDR block while 10.0.0.1/8 is not. For more information, see the [What is CIDR?](https://www.alibabacloud.com/help/doc-detail/40637.htm#section-jua-0tj-q5m) section in Network FAQ.
32233
- * * When you add or delete an entry, you cannot specify duplicate CIDR blocks. Examples:
32234
- * * For IPv4 CIDR blocks, you cannot specify the 10.0.0.0/8 CIDR block in two entries. You cannot specify the 10.0.0.1/32 CIDR block in one entry and the 10.0.0.1 CIDR block in another entry. These two CIDR blocks are the same.
32235
- * * For IPv6 CIDR blocks, you cannot specify the 2001:fd01:0:0:0:0:0:0/32 CIDR block in one entry and the 2001:fd01::/32 CIDR block in another entry. These two CIDR blocks are the same.
32236
- * * The CIDR block in an entry to be added cannot the same as that in an entry to be deleted. For example, when you add an entry in which the 10.0.0.0/8 CIDR block is specified, the entry to be deleted cannot have the 10.0.0.0/8 CIDR block specified.
32237
- * * If you want to modify the description of an entry, you must specify the CIDR block (`AddEntry.N.Cidr`) and new description (`AddEntry.N.Description`) in the entry.
32238
- *
32239
- * @param request ModifyPrefixListRequest
32240
- * @return ModifyPrefixListResponse
32241
- */
32242
32405
  modifyPrefixList(request: ModifyPrefixListRequest): Promise<ModifyPrefixListResponse>;
32243
32406
  modifyPrepayInstanceSpecWithOptions(request: ModifyPrepayInstanceSpecRequest, runtime: $Util.RuntimeOptions): Promise<ModifyPrepayInstanceSpecResponse>;
32244
32407
  modifyPrepayInstanceSpec(request: ModifyPrepayInstanceSpecRequest): Promise<ModifyPrepayInstanceSpecResponse>;
@@ -32246,30 +32409,7 @@ export default class Client extends OpenApi {
32246
32409
  modifyReservedInstanceAttribute(request: ModifyReservedInstanceAttributeRequest): Promise<ModifyReservedInstanceAttributeResponse>;
32247
32410
  modifyReservedInstanceAutoRenewAttributeWithOptions(request: ModifyReservedInstanceAutoRenewAttributeRequest, runtime: $Util.RuntimeOptions): Promise<ModifyReservedInstanceAutoRenewAttributeResponse>;
32248
32411
  modifyReservedInstanceAutoRenewAttribute(request: ModifyReservedInstanceAutoRenewAttributeRequest): Promise<ModifyReservedInstanceAutoRenewAttributeResponse>;
32249
- /**
32250
- * ## Description
32251
- * When you call this operation, take note of the following items:
32252
- * * For information about limits on reserved instances, see the "Limits" section in [Overview](~~100370~~).
32253
- * * If you call this operation to split a reserved instance, make sure that you fully understand the limits on splitting a reserved instance. For more information, see [Split a reserved instance](~~100375~~).
32254
- * * If you call this operation to merge reserved instances, make sure that you fully understand the limits on merging reserved instances. For more information, see [Merge reserved instances](~~132229~~).
32255
- * * If you call this operation to modify a reserved instance, make sure that you fully understand the limits on and methods of modifying a reserved instance. For more information, see [Modify a reserved instance](~~132230~~).
32256
- *
32257
- * @param request ModifyReservedInstancesRequest
32258
- * @param runtime runtime options for this request RuntimeOptions
32259
- * @return ModifyReservedInstancesResponse
32260
- */
32261
32412
  modifyReservedInstancesWithOptions(request: ModifyReservedInstancesRequest, runtime: $Util.RuntimeOptions): Promise<ModifyReservedInstancesResponse>;
32262
- /**
32263
- * ## Description
32264
- * When you call this operation, take note of the following items:
32265
- * * For information about limits on reserved instances, see the "Limits" section in [Overview](~~100370~~).
32266
- * * If you call this operation to split a reserved instance, make sure that you fully understand the limits on splitting a reserved instance. For more information, see [Split a reserved instance](~~100375~~).
32267
- * * If you call this operation to merge reserved instances, make sure that you fully understand the limits on merging reserved instances. For more information, see [Merge reserved instances](~~132229~~).
32268
- * * If you call this operation to modify a reserved instance, make sure that you fully understand the limits on and methods of modifying a reserved instance. For more information, see [Modify a reserved instance](~~132230~~).
32269
- *
32270
- * @param request ModifyReservedInstancesRequest
32271
- * @return ModifyReservedInstancesResponse
32272
- */
32273
32413
  modifyReservedInstances(request: ModifyReservedInstancesRequest): Promise<ModifyReservedInstancesResponse>;
32274
32414
  /**
32275
32415
  * @deprecated
@@ -32392,26 +32532,34 @@ export default class Client extends OpenApi {
32392
32532
  * @return ModifyVpcAttributeResponse
32393
32533
  */
32394
32534
  modifyVpcAttribute(request: ModifyVpcAttributeRequest): Promise<ModifyVpcAttributeResponse>;
32535
+ purchaseReservedInstancesOfferingWithOptions(request: PurchaseReservedInstancesOfferingRequest, runtime: $Util.RuntimeOptions): Promise<PurchaseReservedInstancesOfferingResponse>;
32536
+ purchaseReservedInstancesOffering(request: PurchaseReservedInstancesOfferingRequest): Promise<PurchaseReservedInstancesOfferingResponse>;
32537
+ purchaseStorageCapacityUnitWithOptions(request: PurchaseStorageCapacityUnitRequest, runtime: $Util.RuntimeOptions): Promise<PurchaseStorageCapacityUnitResponse>;
32538
+ purchaseStorageCapacityUnit(request: PurchaseStorageCapacityUnitRequest): Promise<PurchaseStorageCapacityUnitResponse>;
32395
32539
  /**
32396
- * * Before you call this operation, make sure that you understand how reserved instances are billed. For more information, see [Reserved instances](~~100371~~).
32397
- * * Before you purchase a reserved instance, you can call the [DescribeAvailableResource](~~66186~~) operation to query available instance resources.
32540
+ * When you call this operation, take note of the following points:
32541
+ * * The instance must be in the **Expired** (`Stopped`) or **Overdue and Being Recycled** (`Stopped`) state.
32542
+ * * To continue using instances in these states, you must reactivate the instances within 15 days of settling any overdue payments. If you do not reactivate the instance within the aforementioned time, data on the instance can no longer be recovered. This operation may fail on pay-as-you-go instance of the Virtual Private Cloud (VPC) type. To solve this problem, try again several minutes later or [submit a ticket](https://selfservice.console.aliyun.com/ticket/createIndex.htm).
32543
+ * * After you settle all overdue payments, make sure that the total of your balance, vouchers, and coupons within your Alibaba Cloud account is 100 RMB or more. Otherwise, you may not be able to reactivate the instance. For more information, see [Reboot an instance](~~34374~~).
32544
+ * * After the operation is called, the instance enters the `Starting` state.
32545
+ * * You cannot call this operation on ECS instances that are locked for security reasons. An instance is locked for security reasons if `OperationLocks` in the response returned when you query information of the instance contains `"LockReason": "security"`. For more information, see [API behavior when an instance is locked for security reasons](~~25695~~).
32398
32546
  *
32399
- * @param request PurchaseReservedInstancesOfferingRequest
32547
+ * @param request ReActivateInstancesRequest
32400
32548
  * @param runtime runtime options for this request RuntimeOptions
32401
- * @return PurchaseReservedInstancesOfferingResponse
32549
+ * @return ReActivateInstancesResponse
32402
32550
  */
32403
- purchaseReservedInstancesOfferingWithOptions(request: PurchaseReservedInstancesOfferingRequest, runtime: $Util.RuntimeOptions): Promise<PurchaseReservedInstancesOfferingResponse>;
32551
+ reActivateInstancesWithOptions(request: ReActivateInstancesRequest, runtime: $Util.RuntimeOptions): Promise<ReActivateInstancesResponse>;
32404
32552
  /**
32405
- * * Before you call this operation, make sure that you understand how reserved instances are billed. For more information, see [Reserved instances](~~100371~~).
32406
- * * Before you purchase a reserved instance, you can call the [DescribeAvailableResource](~~66186~~) operation to query available instance resources.
32553
+ * When you call this operation, take note of the following points:
32554
+ * * The instance must be in the **Expired** (`Stopped`) or **Overdue and Being Recycled** (`Stopped`) state.
32555
+ * * To continue using instances in these states, you must reactivate the instances within 15 days of settling any overdue payments. If you do not reactivate the instance within the aforementioned time, data on the instance can no longer be recovered. This operation may fail on pay-as-you-go instance of the Virtual Private Cloud (VPC) type. To solve this problem, try again several minutes later or [submit a ticket](https://selfservice.console.aliyun.com/ticket/createIndex.htm).
32556
+ * * After you settle all overdue payments, make sure that the total of your balance, vouchers, and coupons within your Alibaba Cloud account is 100 RMB or more. Otherwise, you may not be able to reactivate the instance. For more information, see [Reboot an instance](~~34374~~).
32557
+ * * After the operation is called, the instance enters the `Starting` state.
32558
+ * * You cannot call this operation on ECS instances that are locked for security reasons. An instance is locked for security reasons if `OperationLocks` in the response returned when you query information of the instance contains `"LockReason": "security"`. For more information, see [API behavior when an instance is locked for security reasons](~~25695~~).
32407
32559
  *
32408
- * @param request PurchaseReservedInstancesOfferingRequest
32409
- * @return PurchaseReservedInstancesOfferingResponse
32560
+ * @param request ReActivateInstancesRequest
32561
+ * @return ReActivateInstancesResponse
32410
32562
  */
32411
- purchaseReservedInstancesOffering(request: PurchaseReservedInstancesOfferingRequest): Promise<PurchaseReservedInstancesOfferingResponse>;
32412
- purchaseStorageCapacityUnitWithOptions(request: PurchaseStorageCapacityUnitRequest, runtime: $Util.RuntimeOptions): Promise<PurchaseStorageCapacityUnitResponse>;
32413
- purchaseStorageCapacityUnit(request: PurchaseStorageCapacityUnitRequest): Promise<PurchaseStorageCapacityUnitResponse>;
32414
- reActivateInstancesWithOptions(request: ReActivateInstancesRequest, runtime: $Util.RuntimeOptions): Promise<ReActivateInstancesResponse>;
32415
32563
  reActivateInstances(request: ReActivateInstancesRequest): Promise<ReActivateInstancesResponse>;
32416
32564
  reInitDiskWithOptions(request: ReInitDiskRequest, runtime: $Util.RuntimeOptions): Promise<ReInitDiskResponse>;
32417
32565
  reInitDisk(request: ReInitDiskRequest): Promise<ReInitDiskResponse>;
@@ -32437,11 +32585,10 @@ export default class Client extends OpenApi {
32437
32585
  */
32438
32586
  rebootInstance(request: RebootInstanceRequest): Promise<RebootInstanceResponse>;
32439
32587
  /**
32440
- * ## Description
32441
- * * The ECS instances to be restarted must be in the **Running** (`Running`) state.
32442
- * * Batch operations are supported. You can use the `BatchOptimization` parameter to specify the batch operation mode.
32443
- * * Instances can be forcibly restarted. A forced restart (`ForceStop`) is equivalent to powering off traditional servers to restart them. This operation can cause data loss if data in the instance is not written to Elastic Block Storage devices.
32444
- * * If the response contains`{"OperationLocks": {"LockReason" : "security"}}` when you query information of an instance, the instance is locked for security reasons and all operations are prohibited on the instance.
32588
+ * * The ECS instances to which you want to restart are in the **Running** (`Running`) state.
32589
+ * * You can restart multiple instances at a time and use the `BatchOptimization` parameter to specify the batch operation mode.
32590
+ * * Instances can be forcefully restarted. A force restart (`ForceStop`) is equivalent to powering off traditional servers to restart them. This operation may lead to data loss if data in the instance operating system is not written to block storage devices.
32591
+ * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}` when you query the information of the instance, the instance is locked for security reasons and all operations are prohibited on it.
32445
32592
  *
32446
32593
  * @param request RebootInstancesRequest
32447
32594
  * @param runtime runtime options for this request RuntimeOptions
@@ -32449,11 +32596,10 @@ export default class Client extends OpenApi {
32449
32596
  */
32450
32597
  rebootInstancesWithOptions(request: RebootInstancesRequest, runtime: $Util.RuntimeOptions): Promise<RebootInstancesResponse>;
32451
32598
  /**
32452
- * ## Description
32453
- * * The ECS instances to be restarted must be in the **Running** (`Running`) state.
32454
- * * Batch operations are supported. You can use the `BatchOptimization` parameter to specify the batch operation mode.
32455
- * * Instances can be forcibly restarted. A forced restart (`ForceStop`) is equivalent to powering off traditional servers to restart them. This operation can cause data loss if data in the instance is not written to Elastic Block Storage devices.
32456
- * * If the response contains`{"OperationLocks": {"LockReason" : "security"}}` when you query information of an instance, the instance is locked for security reasons and all operations are prohibited on the instance.
32599
+ * * The ECS instances to which you want to restart are in the **Running** (`Running`) state.
32600
+ * * You can restart multiple instances at a time and use the `BatchOptimization` parameter to specify the batch operation mode.
32601
+ * * Instances can be forcefully restarted. A force restart (`ForceStop`) is equivalent to powering off traditional servers to restart them. This operation may lead to data loss if data in the instance operating system is not written to block storage devices.
32602
+ * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}` when you query the information of the instance, the instance is locked for security reasons and all operations are prohibited on it.
32457
32603
  *
32458
32604
  * @param request RebootInstancesRequest
32459
32605
  * @return RebootInstancesResponse
@@ -32480,20 +32626,7 @@ export default class Client extends OpenApi {
32480
32626
  redeployInstance(request: RedeployInstanceRequest): Promise<RedeployInstanceResponse>;
32481
32627
  releaseCapacityReservationWithOptions(request: ReleaseCapacityReservationRequest, runtime: $Util.RuntimeOptions): Promise<ReleaseCapacityReservationResponse>;
32482
32628
  releaseCapacityReservation(request: ReleaseCapacityReservationRequest): Promise<ReleaseCapacityReservationResponse>;
32483
- /**
32484
- * Before you release a pay-as-you-go dedicated host, make sure that no Elastic Compute Service (ECS) instances are deployed on the dedicated host.
32485
- *
32486
- * @param request ReleaseDedicatedHostRequest
32487
- * @param runtime runtime options for this request RuntimeOptions
32488
- * @return ReleaseDedicatedHostResponse
32489
- */
32490
32629
  releaseDedicatedHostWithOptions(request: ReleaseDedicatedHostRequest, runtime: $Util.RuntimeOptions): Promise<ReleaseDedicatedHostResponse>;
32491
- /**
32492
- * Before you release a pay-as-you-go dedicated host, make sure that no Elastic Compute Service (ECS) instances are deployed on the dedicated host.
32493
- *
32494
- * @param request ReleaseDedicatedHostRequest
32495
- * @return ReleaseDedicatedHostResponse
32496
- */
32497
32630
  releaseDedicatedHost(request: ReleaseDedicatedHostRequest): Promise<ReleaseDedicatedHostResponse>;
32498
32631
  /**
32499
32632
  * @deprecated
@@ -32531,50 +32664,30 @@ export default class Client extends OpenApi {
32531
32664
  removeTags(request: RemoveTagsRequest): Promise<RemoveTagsResponse>;
32532
32665
  renewDedicatedHostsWithOptions(request: RenewDedicatedHostsRequest, runtime: $Util.RuntimeOptions): Promise<RenewDedicatedHostsResponse>;
32533
32666
  renewDedicatedHosts(request: RenewDedicatedHostsRequest): Promise<RenewDedicatedHostsResponse>;
32534
- renewInstanceWithOptions(request: RenewInstanceRequest, runtime: $Util.RuntimeOptions): Promise<RenewInstanceResponse>;
32535
- renewInstance(request: RenewInstanceRequest): Promise<RenewInstanceResponse>;
32536
- renewReservedInstancesWithOptions(request: RenewReservedInstancesRequest, runtime: $Util.RuntimeOptions): Promise<RenewReservedInstancesResponse>;
32537
- renewReservedInstances(request: RenewReservedInstancesRequest): Promise<RenewReservedInstancesResponse>;
32538
32667
  /**
32539
- * When you call this operation, take note of the following items:
32540
- * * You must specify `ImageId` or `DiskId`. If both `ImageId` and `DiskId` are specified, only `DiskId` takes effect.
32541
- * > You can configure the `DiskId` parameter to replace the operating system of an instance. This feature is in invitational preview. To use this feature, [submit a ticket](https://selfservice.console.aliyun.com/ticket/createIndex).
32542
- * * The category of the system disk cannot be changed.
32543
- * * The billing method of the system disk cannot be changed.
32544
- * * The instance must be in the Stopped (`Stopped`) state.
32545
- * **
32546
- * **Note**This item is applicable only to instances that reside in virtual private clouds (VPCs). If the instance is a pay-as-you-go instance and economical mode is enabled for the instance, you must set the stop mode to standard mode when you stop the instance. This ensures that the required resources are available for the instance to start after the system disk is replaced. For more information, see [StopInstance](~~25501~~).
32547
- * * The instance must not be locked for security reasons. If the value of `OperationLocks` in the DescribeInstances response contains `"LockReason": "security"` for an instance, the instance is locked for security reasons. For more information, see [API behavior when an instance is locked for security reasons](~~25695~~).
32548
- * * You cannot have unpaid orders for the instance.
32549
- * * You can configure the `SystemDisk.Size` parameter to specify the capacity of the new system disk.
32550
- * After you call this operation, you can use one of the following methods to check whether the system disk is replaced:
32551
- * * Call the [DescribeDisks](~~25514~~) operation to query the state of the new system disk. If the new system disk is in the In_use state, the system disk is replaced.
32552
- * * Call the [DescribeInstances](~~25506~~) operation to query the state of the instance whose system disk is replaced. If the `OperationLocks` response parameter is empty, the system disk is replaced.
32553
- *
32554
- * @param request ReplaceSystemDiskRequest
32668
+ * * Before you call this operation, make sure that you are familiar with the billing methods and pricing schedule of ECS. For more information, see the [Elastic Compute Service](https://www.alibabacloud.com/product/ecs#pricing) product page.
32669
+ * * You can call this operation to renew a subscription ECS instance for a period of time or to a synchronized expiration date.
32670
+ * * You cannot renew a subscription instance for a specific period of time and to a synchronized expiration date at the same time by calling this operation. The parameter pair (`Period` and `PeriodUnit`) that is related to the renewal period and the `ExpectedRenewDay` parameter are mutually exclusive.
32671
+ * * Your account must have sufficient credits.
32672
+ *
32673
+ * @param request RenewInstanceRequest
32555
32674
  * @param runtime runtime options for this request RuntimeOptions
32556
- * @return ReplaceSystemDiskResponse
32675
+ * @return RenewInstanceResponse
32557
32676
  */
32558
- replaceSystemDiskWithOptions(request: ReplaceSystemDiskRequest, runtime: $Util.RuntimeOptions): Promise<ReplaceSystemDiskResponse>;
32677
+ renewInstanceWithOptions(request: RenewInstanceRequest, runtime: $Util.RuntimeOptions): Promise<RenewInstanceResponse>;
32559
32678
  /**
32560
- * When you call this operation, take note of the following items:
32561
- * * You must specify `ImageId` or `DiskId`. If both `ImageId` and `DiskId` are specified, only `DiskId` takes effect.
32562
- * > You can configure the `DiskId` parameter to replace the operating system of an instance. This feature is in invitational preview. To use this feature, [submit a ticket](https://selfservice.console.aliyun.com/ticket/createIndex).
32563
- * * The category of the system disk cannot be changed.
32564
- * * The billing method of the system disk cannot be changed.
32565
- * * The instance must be in the Stopped (`Stopped`) state.
32566
- * **
32567
- * **Note**This item is applicable only to instances that reside in virtual private clouds (VPCs). If the instance is a pay-as-you-go instance and economical mode is enabled for the instance, you must set the stop mode to standard mode when you stop the instance. This ensures that the required resources are available for the instance to start after the system disk is replaced. For more information, see [StopInstance](~~25501~~).
32568
- * * The instance must not be locked for security reasons. If the value of `OperationLocks` in the DescribeInstances response contains `"LockReason": "security"` for an instance, the instance is locked for security reasons. For more information, see [API behavior when an instance is locked for security reasons](~~25695~~).
32569
- * * You cannot have unpaid orders for the instance.
32570
- * * You can configure the `SystemDisk.Size` parameter to specify the capacity of the new system disk.
32571
- * After you call this operation, you can use one of the following methods to check whether the system disk is replaced:
32572
- * * Call the [DescribeDisks](~~25514~~) operation to query the state of the new system disk. If the new system disk is in the In_use state, the system disk is replaced.
32573
- * * Call the [DescribeInstances](~~25506~~) operation to query the state of the instance whose system disk is replaced. If the `OperationLocks` response parameter is empty, the system disk is replaced.
32574
- *
32575
- * @param request ReplaceSystemDiskRequest
32576
- * @return ReplaceSystemDiskResponse
32679
+ * * Before you call this operation, make sure that you are familiar with the billing methods and pricing schedule of ECS. For more information, see the [Elastic Compute Service](https://www.alibabacloud.com/product/ecs#pricing) product page.
32680
+ * * You can call this operation to renew a subscription ECS instance for a period of time or to a synchronized expiration date.
32681
+ * * You cannot renew a subscription instance for a specific period of time and to a synchronized expiration date at the same time by calling this operation. The parameter pair (`Period` and `PeriodUnit`) that is related to the renewal period and the `ExpectedRenewDay` parameter are mutually exclusive.
32682
+ * * Your account must have sufficient credits.
32683
+ *
32684
+ * @param request RenewInstanceRequest
32685
+ * @return RenewInstanceResponse
32577
32686
  */
32687
+ renewInstance(request: RenewInstanceRequest): Promise<RenewInstanceResponse>;
32688
+ renewReservedInstancesWithOptions(request: RenewReservedInstancesRequest, runtime: $Util.RuntimeOptions): Promise<RenewReservedInstancesResponse>;
32689
+ renewReservedInstances(request: RenewReservedInstancesRequest): Promise<RenewReservedInstancesResponse>;
32690
+ replaceSystemDiskWithOptions(request: ReplaceSystemDiskRequest, runtime: $Util.RuntimeOptions): Promise<ReplaceSystemDiskResponse>;
32578
32691
  replaceSystemDisk(request: ReplaceSystemDiskRequest): Promise<ReplaceSystemDiskResponse>;
32579
32692
  reportInstancesStatusWithOptions(request: ReportInstancesStatusRequest, runtime: $Util.RuntimeOptions): Promise<ReportInstancesStatusResponse>;
32580
32693
  reportInstancesStatus(request: ReportInstancesStatusRequest): Promise<ReportInstancesStatusResponse>;
@@ -32586,24 +32699,119 @@ export default class Client extends OpenApi {
32586
32699
  resizeDisk(request: ResizeDiskRequest): Promise<ResizeDiskResponse>;
32587
32700
  revokeSecurityGroupWithOptions(request: RevokeSecurityGroupRequest, runtime: $Util.RuntimeOptions): Promise<RevokeSecurityGroupResponse>;
32588
32701
  revokeSecurityGroup(request: RevokeSecurityGroupRequest): Promise<RevokeSecurityGroupResponse>;
32702
+ /**
32703
+ * ## Description
32704
+ * In the security group-related API documents, outbound traffic refers to the traffic sent by the source and received by the destination.
32705
+ * When you call this operation, take note of the following items:
32706
+ * * The `Permissions.N` prefix is added to some parameters to generate new parameters. Original parameters and corresponding parameters prefixed with Permissions.N cannot be specified together. We recommend that you use parameters prefixed with `Permissions.N`.
32707
+ * * If the specified outbound security group rule does not exist, the call to RevokeSecurityGroupEgress is successful but no security group rule is deleted.
32708
+ * * You can determine a security group rule by specifying one of the following groups of parameters. You cannot determine a security group rule by specifying only one parameter.
32709
+ * * Parameters used to delete an outbound security group rule that controls access to a specified CIDR block: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, DestCidrIp, and SourceCidrIp (optional).
32710
+ * ```
32711
+ * http(s)://ecs.aliyuncs.com/?Action=RevokeSecurityGroupEgress
32712
+ * &SecurityGroupId=sg-bp67acfmxazb4ph***
32713
+ * &Permissions.1.IpProtocol=TCP
32714
+ * &Permissions.1.DestCidrIp=10.0.0.0/8
32715
+ * &Permissions.1.PortRange=-22/22
32716
+ * &Permissions.1.NicType=intranet
32717
+ * &Permissions.1.Policy=accept
32718
+ * &<Common request parameters>
32719
+ *
32720
+ * ```
32721
+ * * Parameters used to delete an outbound security group rule that controls access to another security group: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, SourceCidrIp (optional), and DestGroupId.
32722
+ * ```
32723
+ * http(s)://ecs.aliyuncs.com/?Action=RevokeSecurityGroupEgress
32724
+ * &SecurityGroupId=sg-bp67acfmxazb4ph***
32725
+ * &Permissions.1.DestGroupId=sg-bp67acfmxa123b****
32726
+ * &Permissions.1.IpProtocol=TCP
32727
+ * &Permissions.1.PortRange=22/22
32728
+ * &Permissions.1.NicType=intranet
32729
+ * &Permissions.1.Policy=accept
32730
+ * &<Common request parameters>
32731
+ *
32732
+ * ```
32733
+ * * Parameters used to delete an outbound security group rule that controls access to a prefix list: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, SourceCidrIp (optional), and DestPrefixListId.
32734
+ * ```
32735
+ * http(s)://ecs.aliyuncs.com/?Action=RevokeSecurityGroupEgress
32736
+ * &SecurityGroupId=sg-bp67acfmxazb4ph***
32737
+ * &Permissions.1.IpProtocol=TCP
32738
+ * &Permissions.1.DestPrefixListId=pl-x1j1k5ykzqlixdcy****
32739
+ * &Permissions.1.PortRange=-22/22
32740
+ * &Permissions.1.NicType=intranet
32741
+ * &Permissions.1.Policy=accept
32742
+ * &<Common request parameters>
32743
+ *
32744
+ * ```
32745
+ *
32746
+ * @param request RevokeSecurityGroupEgressRequest
32747
+ * @param runtime runtime options for this request RuntimeOptions
32748
+ * @return RevokeSecurityGroupEgressResponse
32749
+ */
32589
32750
  revokeSecurityGroupEgressWithOptions(request: RevokeSecurityGroupEgressRequest, runtime: $Util.RuntimeOptions): Promise<RevokeSecurityGroupEgressResponse>;
32751
+ /**
32752
+ * ## Description
32753
+ * In the security group-related API documents, outbound traffic refers to the traffic sent by the source and received by the destination.
32754
+ * When you call this operation, take note of the following items:
32755
+ * * The `Permissions.N` prefix is added to some parameters to generate new parameters. Original parameters and corresponding parameters prefixed with Permissions.N cannot be specified together. We recommend that you use parameters prefixed with `Permissions.N`.
32756
+ * * If the specified outbound security group rule does not exist, the call to RevokeSecurityGroupEgress is successful but no security group rule is deleted.
32757
+ * * You can determine a security group rule by specifying one of the following groups of parameters. You cannot determine a security group rule by specifying only one parameter.
32758
+ * * Parameters used to delete an outbound security group rule that controls access to a specified CIDR block: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, DestCidrIp, and SourceCidrIp (optional).
32759
+ * ```
32760
+ * http(s)://ecs.aliyuncs.com/?Action=RevokeSecurityGroupEgress
32761
+ * &SecurityGroupId=sg-bp67acfmxazb4ph***
32762
+ * &Permissions.1.IpProtocol=TCP
32763
+ * &Permissions.1.DestCidrIp=10.0.0.0/8
32764
+ * &Permissions.1.PortRange=-22/22
32765
+ * &Permissions.1.NicType=intranet
32766
+ * &Permissions.1.Policy=accept
32767
+ * &<Common request parameters>
32768
+ *
32769
+ * ```
32770
+ * * Parameters used to delete an outbound security group rule that controls access to another security group: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, SourceCidrIp (optional), and DestGroupId.
32771
+ * ```
32772
+ * http(s)://ecs.aliyuncs.com/?Action=RevokeSecurityGroupEgress
32773
+ * &SecurityGroupId=sg-bp67acfmxazb4ph***
32774
+ * &Permissions.1.DestGroupId=sg-bp67acfmxa123b****
32775
+ * &Permissions.1.IpProtocol=TCP
32776
+ * &Permissions.1.PortRange=22/22
32777
+ * &Permissions.1.NicType=intranet
32778
+ * &Permissions.1.Policy=accept
32779
+ * &<Common request parameters>
32780
+ *
32781
+ * ```
32782
+ * * Parameters used to delete an outbound security group rule that controls access to a prefix list: IpProtocol, PortRange, SourcePortRange (optional), NicType, Policy, SourceCidrIp (optional), and DestPrefixListId.
32783
+ * ```
32784
+ * http(s)://ecs.aliyuncs.com/?Action=RevokeSecurityGroupEgress
32785
+ * &SecurityGroupId=sg-bp67acfmxazb4ph***
32786
+ * &Permissions.1.IpProtocol=TCP
32787
+ * &Permissions.1.DestPrefixListId=pl-x1j1k5ykzqlixdcy****
32788
+ * &Permissions.1.PortRange=-22/22
32789
+ * &Permissions.1.NicType=intranet
32790
+ * &Permissions.1.Policy=accept
32791
+ * &<Common request parameters>
32792
+ *
32793
+ * ```
32794
+ *
32795
+ * @param request RevokeSecurityGroupEgressRequest
32796
+ * @return RevokeSecurityGroupEgressResponse
32797
+ */
32590
32798
  revokeSecurityGroupEgress(request: RevokeSecurityGroupEgressRequest): Promise<RevokeSecurityGroupEgressResponse>;
32591
32799
  /**
32592
- * Unlike the [CreateCommand](~~64844~~) and [InvokeCommand](~~64841~~) operation, RunCommand can be used to create and run a command within a single request.
32593
- * When you call this operation, take note of the following item:
32800
+ * Compared with the [CreateCommand](~~64844~~) and [InvokeCommand](~~64841~~) operations, you can call the RunCommand operation once to create and run a command.
32801
+ * When you call this operation, take note of the following items:
32594
32802
  * * The instances on which you want to run a command must reside in a virtual private cloud (VPC).
32595
32803
  * * The instances must be in the `Running` state.
32596
32804
  * * The Cloud Assistant client must be installed on the instances. For more information, see [InstallCloudAssistant](~~85916~~).
32597
32805
  * * Before you run a PowerShell command on a Windows instance, make sure that the PowerShell module is installed on the instance.
32598
- * * If you want to specify a schedule by using a cron expression, you can set a time zone based on your requirements. If you do not set a time zone, the schedule is based on the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For information about time zones, see [Configure the NTP service for ECS instances that run CentOS 6](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
32599
- * * You can specify the `TimeOut` parameter to set the timeout period for executions of the command on instances. If an execution times out, the Cloud Assistant client forcefully terminates the command process.
32600
- * * When the one-time execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
32601
- * * For a scheduled task, the timeout period takes effect on each execution of the command. The timeout of one execution does not affect the subsequent executions of the command. When a scheduled execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
32602
- * To ensure that scheduled tasks can run as expected, make sure that the version of the Cloud Assistant client is not earlier than the following ones. A scheduled task can run a command at a specified interval, only once at a specified time, or at designated times based on a cron expression with a specified year or time zone. If the `ClientNeedUpgrade` error code is returned, you must upgrade the Cloud Assistant client to the latest version. For more information, see [Update or disable updates for the Cloud Assistant client](~~134383~~).
32806
+ * * If you want to specify a schedule by using a cron expression, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For information about time zones, see [Configure the NTP service for ECS instances that run CentOS 6](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
32807
+ * * You can specify the `TimeOut` parameter to specify a timeout period for executions of the command on instances. If an execution times out, the Cloud Assistant client forcibly terminates the command process.
32808
+ * * If the one-time execution of a command times out, the execution state of the command changes to Failed. You can call the [InvokeRecordStatus](~~64845~~) operation to query the command execution state.
32809
+ * * For a scheduled task, the timeout period takes effect on each execution of the command. When a command execution times out, the subsequent executions of the command are not affected. If a scheduled execution of a command times out, the execution state of the command changes to Failed. You can call the [InvokeRecordStatus](~~64845~~) operation to query the command execution state.
32810
+ * To ensure that scheduled tasks can run as expected, make sure that the version of the Cloud Assistant client is not earlier than the following versions. A scheduled task can run a command at a specific interval, only once at a specific time, or at specific times based on a cron expression that includes a specific year or time zone. If the `ClientNeedUpgrade` error code is returned, you must update the Cloud Assistant client to the latest version. For more information, see [Upgrade or disable upgrades for the Cloud Assistant client](~~134383~~).
32603
32811
  * - Linux: 2.2.3.282
32604
32812
  * - Windows: 2.1.3.282
32605
32813
  * * Command executions may fail due to instance status exceptions, network exceptions, or exceptions on the Cloud Assistant client. If an execution fails, no execution information is generated.
32606
- * * When `EnableParameter` is set to true, the custom parameter feature is enabled. When you set the `CommandContent` parameter, you can define custom parameters in the `{{parameter}}` format. Then, when the command is run, the key-value pairs of the custom parameters are passed in.
32814
+ * * If you set the `EnableParameter` parameter to true, the custom parameter feature is enabled. If you specify the `CommandContent` parameter, you can specify custom parameters in the `{{parameter}}` format. After the command is run, the key-value pairs of the custom parameters are passed in.
32607
32815
  * * You can retain up to 500 to 10,000 Cloud Assistant commands in each region based on your ECS usage. You can call the [DescribeAccountAttribute](~~73772~~) operation to query quotas.
32608
32816
  *
32609
32817
  * @param tmpReq RunCommandRequest
@@ -32612,108 +32820,30 @@ export default class Client extends OpenApi {
32612
32820
  */
32613
32821
  runCommandWithOptions(tmpReq: RunCommandRequest, runtime: $Util.RuntimeOptions): Promise<RunCommandResponse>;
32614
32822
  /**
32615
- * Unlike the [CreateCommand](~~64844~~) and [InvokeCommand](~~64841~~) operation, RunCommand can be used to create and run a command within a single request.
32616
- * When you call this operation, take note of the following item:
32823
+ * Compared with the [CreateCommand](~~64844~~) and [InvokeCommand](~~64841~~) operations, you can call the RunCommand operation once to create and run a command.
32824
+ * When you call this operation, take note of the following items:
32617
32825
  * * The instances on which you want to run a command must reside in a virtual private cloud (VPC).
32618
32826
  * * The instances must be in the `Running` state.
32619
32827
  * * The Cloud Assistant client must be installed on the instances. For more information, see [InstallCloudAssistant](~~85916~~).
32620
32828
  * * Before you run a PowerShell command on a Windows instance, make sure that the PowerShell module is installed on the instance.
32621
- * * If you want to specify a schedule by using a cron expression, you can set a time zone based on your requirements. If you do not set a time zone, the schedule is based on the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For information about time zones, see [Configure the NTP service for ECS instances that run CentOS 6](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
32622
- * * You can specify the `TimeOut` parameter to set the timeout period for executions of the command on instances. If an execution times out, the Cloud Assistant client forcefully terminates the command process.
32623
- * * When the one-time execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
32624
- * * For a scheduled task, the timeout period takes effect on each execution of the command. The timeout of one execution does not affect the subsequent executions of the command. When a scheduled execution of a command times out, the execution state ([InvokeRecordStatus](~~64845~~)) of the command becomes Failed.
32625
- * To ensure that scheduled tasks can run as expected, make sure that the version of the Cloud Assistant client is not earlier than the following ones. A scheduled task can run a command at a specified interval, only once at a specified time, or at designated times based on a cron expression with a specified year or time zone. If the `ClientNeedUpgrade` error code is returned, you must upgrade the Cloud Assistant client to the latest version. For more information, see [Update or disable updates for the Cloud Assistant client](~~134383~~).
32829
+ * * If you want to specify a schedule by using a cron expression, you can specify a time zone based on your business requirements. If you do not specify a time zone, the schedule is determined by the system time of the instance. Make sure that the time or time zone of the instance meets your business requirements. For information about time zones, see [Configure the NTP service for ECS instances that run CentOS 6](~~92803~~) or [Configure the NTP service for Windows instances](~~51890~~).
32830
+ * * You can specify the `TimeOut` parameter to specify a timeout period for executions of the command on instances. If an execution times out, the Cloud Assistant client forcibly terminates the command process.
32831
+ * * If the one-time execution of a command times out, the execution state of the command changes to Failed. You can call the [InvokeRecordStatus](~~64845~~) operation to query the command execution state.
32832
+ * * For a scheduled task, the timeout period takes effect on each execution of the command. When a command execution times out, the subsequent executions of the command are not affected. If a scheduled execution of a command times out, the execution state of the command changes to Failed. You can call the [InvokeRecordStatus](~~64845~~) operation to query the command execution state.
32833
+ * To ensure that scheduled tasks can run as expected, make sure that the version of the Cloud Assistant client is not earlier than the following versions. A scheduled task can run a command at a specific interval, only once at a specific time, or at specific times based on a cron expression that includes a specific year or time zone. If the `ClientNeedUpgrade` error code is returned, you must update the Cloud Assistant client to the latest version. For more information, see [Upgrade or disable upgrades for the Cloud Assistant client](~~134383~~).
32626
32834
  * - Linux: 2.2.3.282
32627
32835
  * - Windows: 2.1.3.282
32628
32836
  * * Command executions may fail due to instance status exceptions, network exceptions, or exceptions on the Cloud Assistant client. If an execution fails, no execution information is generated.
32629
- * * When `EnableParameter` is set to true, the custom parameter feature is enabled. When you set the `CommandContent` parameter, you can define custom parameters in the `{{parameter}}` format. Then, when the command is run, the key-value pairs of the custom parameters are passed in.
32837
+ * * If you set the `EnableParameter` parameter to true, the custom parameter feature is enabled. If you specify the `CommandContent` parameter, you can specify custom parameters in the `{{parameter}}` format. After the command is run, the key-value pairs of the custom parameters are passed in.
32630
32838
  * * You can retain up to 500 to 10,000 Cloud Assistant commands in each region based on your ECS usage. You can call the [DescribeAccountAttribute](~~73772~~) operation to query quotas.
32631
32839
  *
32632
32840
  * @param request RunCommandRequest
32633
32841
  * @return RunCommandResponse
32634
32842
  */
32635
32843
  runCommand(request: RunCommandRequest): Promise<RunCommandResponse>;
32636
- /**
32637
- * * **Preparations**:
32638
- * * The real-name verification is complete. For more information, see [Real-name verification](~~48263~~).
32639
- * * Cost estimation: Learn about the billing methods of ECS resources. For more information, see [Billing overview](~~25398~~).
32640
- * * Instance type selection: Call the [DescribeInstanceTypes](~~25620~~) operation to query the performance data of instance types, or see [Best practices for instance type selection](~~58291~~) to learn about how to select instance types.
32641
- * * Query for available resources: Call the [DescribeAvailableResource](~~66186~~) operation to query available resources in a specific region or zone.
32642
- * * Network planning: Make sure that you have security groups available for use. For more information, see [CreateSecurityGroup](~~25553~~). Before you create an instance of the Virtual Private Cloud (VPC) type, create a VPC in the region where you want to create the instance. For more information, see [Create a VPC](~~65430~~).
32643
- * * **Precautions**:
32644
- * * You can create a maximum of 100 instances at a time.
32645
- * * You can use the `AutoReleaseTime` parameter to set the time when you want the instances to be automatically released.
32646
- * * After instances are created, you can call the [DescribeInstances](~~25506~~) operation to check their states.
32647
- * * By default, instances automatically start after they are created. Instances are ready for use when they are in the Running (`Running`) state.
32648
- * * As of November 27, 2020, the maximum bandwidth value available for you to create ECS instances or to change ECS instance configurations is subject to the throttling policy for your account. To increase the maximum bandwidth value, submit a ticket. The throttling policy imposes the following constraints: Within a single region, the total maximum bandwidth value of all instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s and that of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
32649
- * * Different from the [CreateInstance](~~25499~~) operation, the `RunInstances` operation allows the system to assign public IP addresses to the new instances if you set the `InternetMaxBandwidthOut` parameter to a value greater than 0.
32650
- * * When you call the RunInstances operation to create an instance, you can use one of the following methods to bind a primary elastic network interface (ENI) to the instance. Note that you can use only one of the methods to configure the primary ENI in each call. Otherwise, the call fails and an error message is returned. Specify parameters such as `SecurityGroupId`, `VSwitchId`, `PrivateIpAddress`, `NetworkInterfaceQueueNumber`, and `Ipv6AddressCount` to configure the primary ENI. Specify parameters that start with `NetworkInterface.N.` to configure the primary and secondary ENIs. If `NetworkInterface.N.InstanceType` is set to `Primary`, the primary ENI is bound to the instance. If `NetworkInterface.N.InstanceType` is set to `Secondary` or left empty, a secondary ENI is bound to the instance.
32651
- * * After you call this operation, an error is returned if a parameter is invalid or if available resources are insufficient. For more information, see the "Error codes" section of this topic.
32652
- * > If the `QuotaExceed.ElasticQuota` error is returned when you call this operation, you have reached the maximum number of instances of the specified instance type that can be created within the specified region or the maximum number of vCPUs for all instance types in a zone. You can go to the [ECS console](https://ecs.console.aliyun.com/?spm=a2c8b.12215451.favorites.decs.5e3a336aMGTtzy#/privileges/quota) or [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to request a quota increase.
32653
- * * **Best practices**:
32654
- * * We recommend that you use auto provisioning groups in the following scenarios: Resources are insufficient to create more than 100 instances at a time, you want to quickly create instances regardless of resource configurations such as instance types or zones, or you want to create instances to consume a specific total number of vCPUs regardless of the number of the instances. You can call the [CreateAutoProvisioningGroup](~~122738~~) operation to create an auto provisioning group to deploy an instance cluster across different billing methods, instance families, and zones. For more information, see [Use auto provisioning group-related API operations to create multiple ECS instances at the same time](~~200772~~).
32655
- * * You can call the `RunInstances` operation to batch create instances. To better manage and search for these instances, we recommend that you specify tags for the instances by using the `Tag.N.Key` and `Tag.N.Value` parameters. You can also append incremental suffixes (`UniqueSuffix`) to the hostname (`HostName`) and to the instance name (`InstanceName`).
32656
- * * A launch template contains parameters required to create an instance so that you do not have to specify these parameters every time you create instances. You can call the [CreateLaunchTemplate](~~74686~~) operation to create a launch template. Then, in your request to call the `RunInstances` operation, you can specify the `LaunchTemplateId` and `LaunchTemplateVersion` parameters to use the launch template.
32657
- * * When you create an instance in the [ECS console](https://ecs.console.aliyun.com/), you can view the best practices for calling the `RunInstances` operation. In the Preview step, click View Open API in the Configurations Selected section. In the dialog box that appears, the left-side **API Workflow** section shows the operations and request parameters that are related to the `RunInstances` operation. The right-side section shows SDK examples for the **Java** and **Python** programming languages.
32658
- *
32659
- * @param request RunInstancesRequest
32660
- * @param runtime runtime options for this request RuntimeOptions
32661
- * @return RunInstancesResponse
32662
- */
32663
32844
  runInstancesWithOptions(request: RunInstancesRequest, runtime: $Util.RuntimeOptions): Promise<RunInstancesResponse>;
32664
- /**
32665
- * * **Preparations**:
32666
- * * The real-name verification is complete. For more information, see [Real-name verification](~~48263~~).
32667
- * * Cost estimation: Learn about the billing methods of ECS resources. For more information, see [Billing overview](~~25398~~).
32668
- * * Instance type selection: Call the [DescribeInstanceTypes](~~25620~~) operation to query the performance data of instance types, or see [Best practices for instance type selection](~~58291~~) to learn about how to select instance types.
32669
- * * Query for available resources: Call the [DescribeAvailableResource](~~66186~~) operation to query available resources in a specific region or zone.
32670
- * * Network planning: Make sure that you have security groups available for use. For more information, see [CreateSecurityGroup](~~25553~~). Before you create an instance of the Virtual Private Cloud (VPC) type, create a VPC in the region where you want to create the instance. For more information, see [Create a VPC](~~65430~~).
32671
- * * **Precautions**:
32672
- * * You can create a maximum of 100 instances at a time.
32673
- * * You can use the `AutoReleaseTime` parameter to set the time when you want the instances to be automatically released.
32674
- * * After instances are created, you can call the [DescribeInstances](~~25506~~) operation to check their states.
32675
- * * By default, instances automatically start after they are created. Instances are ready for use when they are in the Running (`Running`) state.
32676
- * * As of November 27, 2020, the maximum bandwidth value available for you to create ECS instances or to change ECS instance configurations is subject to the throttling policy for your account. To increase the maximum bandwidth value, submit a ticket. The throttling policy imposes the following constraints: Within a single region, the total maximum bandwidth value of all instances that use the pay-by-traffic billing method for network usage cannot exceed 5 Gbit/s and that of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
32677
- * * Different from the [CreateInstance](~~25499~~) operation, the `RunInstances` operation allows the system to assign public IP addresses to the new instances if you set the `InternetMaxBandwidthOut` parameter to a value greater than 0.
32678
- * * When you call the RunInstances operation to create an instance, you can use one of the following methods to bind a primary elastic network interface (ENI) to the instance. Note that you can use only one of the methods to configure the primary ENI in each call. Otherwise, the call fails and an error message is returned. Specify parameters such as `SecurityGroupId`, `VSwitchId`, `PrivateIpAddress`, `NetworkInterfaceQueueNumber`, and `Ipv6AddressCount` to configure the primary ENI. Specify parameters that start with `NetworkInterface.N.` to configure the primary and secondary ENIs. If `NetworkInterface.N.InstanceType` is set to `Primary`, the primary ENI is bound to the instance. If `NetworkInterface.N.InstanceType` is set to `Secondary` or left empty, a secondary ENI is bound to the instance.
32679
- * * After you call this operation, an error is returned if a parameter is invalid or if available resources are insufficient. For more information, see the "Error codes" section of this topic.
32680
- * > If the `QuotaExceed.ElasticQuota` error is returned when you call this operation, you have reached the maximum number of instances of the specified instance type that can be created within the specified region or the maximum number of vCPUs for all instance types in a zone. You can go to the [ECS console](https://ecs.console.aliyun.com/?spm=a2c8b.12215451.favorites.decs.5e3a336aMGTtzy#/privileges/quota) or [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to request a quota increase.
32681
- * * **Best practices**:
32682
- * * We recommend that you use auto provisioning groups in the following scenarios: Resources are insufficient to create more than 100 instances at a time, you want to quickly create instances regardless of resource configurations such as instance types or zones, or you want to create instances to consume a specific total number of vCPUs regardless of the number of the instances. You can call the [CreateAutoProvisioningGroup](~~122738~~) operation to create an auto provisioning group to deploy an instance cluster across different billing methods, instance families, and zones. For more information, see [Use auto provisioning group-related API operations to create multiple ECS instances at the same time](~~200772~~).
32683
- * * You can call the `RunInstances` operation to batch create instances. To better manage and search for these instances, we recommend that you specify tags for the instances by using the `Tag.N.Key` and `Tag.N.Value` parameters. You can also append incremental suffixes (`UniqueSuffix`) to the hostname (`HostName`) and to the instance name (`InstanceName`).
32684
- * * A launch template contains parameters required to create an instance so that you do not have to specify these parameters every time you create instances. You can call the [CreateLaunchTemplate](~~74686~~) operation to create a launch template. Then, in your request to call the `RunInstances` operation, you can specify the `LaunchTemplateId` and `LaunchTemplateVersion` parameters to use the launch template.
32685
- * * When you create an instance in the [ECS console](https://ecs.console.aliyun.com/), you can view the best practices for calling the `RunInstances` operation. In the Preview step, click View Open API in the Configurations Selected section. In the dialog box that appears, the left-side **API Workflow** section shows the operations and request parameters that are related to the `RunInstances` operation. The right-side section shows SDK examples for the **Java** and **Python** programming languages.
32686
- *
32687
- * @param request RunInstancesRequest
32688
- * @return RunInstancesResponse
32689
- */
32690
32845
  runInstances(request: RunInstancesRequest): Promise<RunInstancesResponse>;
32691
- /**
32692
- * * The instances to which to send a file must be in the Running (`Running`) state.
32693
- * * The Cloud Assistant client must be installed on the instances. For information about how to install the Cloud Assistant client, see [InstallCloudAssistant](~~85916~~).
32694
- * * Only the Cloud Assistant client versions that are later than the following ones support file sending. If the `ClientNeedUpgrade` error code is returned, you must upgrade the Cloud Assistant client to the latest version. For more information, see [Update or disable updates for the Cloud Assistant client](~~134383~~).
32695
- * * For Linux instances, the version of the Cloud Assistant client must be later than 1.0.2.569.
32696
- * * For Windows instances, the version of the Cloud Assistant client must be later than 1.0.0.149.
32697
- * * The file to be sent must not exceed 32 KB in size after it is encoded in Base64.
32698
- * * The file may fail to be sent due to exceptions on the instances, network, or the Cloud Assistance client. Call the [DescribeSendFileResults](~~~~) operation to troubleshoot the issues.
32699
- *
32700
- * @param request SendFileRequest
32701
- * @param runtime runtime options for this request RuntimeOptions
32702
- * @return SendFileResponse
32703
- */
32704
32846
  sendFileWithOptions(request: SendFileRequest, runtime: $Util.RuntimeOptions): Promise<SendFileResponse>;
32705
- /**
32706
- * * The instances to which to send a file must be in the Running (`Running`) state.
32707
- * * The Cloud Assistant client must be installed on the instances. For information about how to install the Cloud Assistant client, see [InstallCloudAssistant](~~85916~~).
32708
- * * Only the Cloud Assistant client versions that are later than the following ones support file sending. If the `ClientNeedUpgrade` error code is returned, you must upgrade the Cloud Assistant client to the latest version. For more information, see [Update or disable updates for the Cloud Assistant client](~~134383~~).
32709
- * * For Linux instances, the version of the Cloud Assistant client must be later than 1.0.2.569.
32710
- * * For Windows instances, the version of the Cloud Assistant client must be later than 1.0.0.149.
32711
- * * The file to be sent must not exceed 32 KB in size after it is encoded in Base64.
32712
- * * The file may fail to be sent due to exceptions on the instances, network, or the Cloud Assistance client. Call the [DescribeSendFileResults](~~~~) operation to troubleshoot the issues.
32713
- *
32714
- * @param request SendFileRequest
32715
- * @return SendFileResponse
32716
- */
32717
32847
  sendFile(request: SendFileRequest): Promise<SendFileResponse>;
32718
32848
  /**
32719
32849
  * @deprecated
@@ -32744,20 +32874,7 @@ export default class Client extends OpenApi {
32744
32874
  stopInstances(request: StopInstancesRequest): Promise<StopInstancesResponse>;
32745
32875
  stopInvocationWithOptions(request: StopInvocationRequest, runtime: $Util.RuntimeOptions): Promise<StopInvocationResponse>;
32746
32876
  stopInvocation(request: StopInvocationRequest): Promise<StopInvocationResponse>;
32747
- /**
32748
- * Before you add tags to a resource, Alibaba Cloud checks the number of existing tags of the resource. If the maximum number of tags is reached, an error message is returned. For more information, see the "Tag limits" section in [Limits](~~25412~~).
32749
- *
32750
- * @param request TagResourcesRequest
32751
- * @param runtime runtime options for this request RuntimeOptions
32752
- * @return TagResourcesResponse
32753
- */
32754
32877
  tagResourcesWithOptions(request: TagResourcesRequest, runtime: $Util.RuntimeOptions): Promise<TagResourcesResponse>;
32755
- /**
32756
- * Before you add tags to a resource, Alibaba Cloud checks the number of existing tags of the resource. If the maximum number of tags is reached, an error message is returned. For more information, see the "Tag limits" section in [Limits](~~25412~~).
32757
- *
32758
- * @param request TagResourcesRequest
32759
- * @return TagResourcesResponse
32760
- */
32761
32878
  tagResources(request: TagResourcesRequest): Promise<TagResourcesResponse>;
32762
32879
  /**
32763
32880
  * @deprecated
@@ -32789,9 +32906,41 @@ export default class Client extends OpenApi {
32789
32906
  * @return TerminateVirtualBorderRouterResponse
32790
32907
  */
32791
32908
  terminateVirtualBorderRouter(request: TerminateVirtualBorderRouterRequest): Promise<TerminateVirtualBorderRouterResponse>;
32909
+ /**
32910
+ * When you call this operation, take note of the following items:
32911
+ * * The ENI must be in the **Available** (Available) or **InUse** (InUse) state.
32912
+ * * If the ENI is 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.
32913
+ *
32914
+ * @param request UnassignIpv6AddressesRequest
32915
+ * @param runtime runtime options for this request RuntimeOptions
32916
+ * @return UnassignIpv6AddressesResponse
32917
+ */
32792
32918
  unassignIpv6AddressesWithOptions(request: UnassignIpv6AddressesRequest, runtime: $Util.RuntimeOptions): Promise<UnassignIpv6AddressesResponse>;
32919
+ /**
32920
+ * When you call this operation, take note of the following items:
32921
+ * * The ENI must be in the **Available** (Available) or **InUse** (InUse) state.
32922
+ * * If the ENI is 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.
32923
+ *
32924
+ * @param request UnassignIpv6AddressesRequest
32925
+ * @return UnassignIpv6AddressesResponse
32926
+ */
32793
32927
  unassignIpv6Addresses(request: UnassignIpv6AddressesRequest): Promise<UnassignIpv6AddressesResponse>;
32928
+ /**
32929
+ * * The ENI from which to unassign secondary private IP addresses must be in the **Available** (Available) or **InUse** (InUse) state.
32930
+ * * If the ENI is 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.
32931
+ *
32932
+ * @param request UnassignPrivateIpAddressesRequest
32933
+ * @param runtime runtime options for this request RuntimeOptions
32934
+ * @return UnassignPrivateIpAddressesResponse
32935
+ */
32794
32936
  unassignPrivateIpAddressesWithOptions(request: UnassignPrivateIpAddressesRequest, runtime: $Util.RuntimeOptions): Promise<UnassignPrivateIpAddressesResponse>;
32937
+ /**
32938
+ * * The ENI from which to unassign secondary private IP addresses must be in the **Available** (Available) or **InUse** (InUse) state.
32939
+ * * If the ENI is 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.
32940
+ *
32941
+ * @param request UnassignPrivateIpAddressesRequest
32942
+ * @return UnassignPrivateIpAddressesResponse
32943
+ */
32795
32944
  unassignPrivateIpAddresses(request: UnassignPrivateIpAddressesRequest): Promise<UnassignPrivateIpAddressesResponse>;
32796
32945
  /**
32797
32946
  * @deprecated