@alicloud/ecs20140526 7.0.0 → 7.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/client.d.ts CHANGED
@@ -881,6 +881,10 @@ export declare class CreateAutoProvisioningGroupRequestLaunchConfigurationArn ex
881
881
  });
882
882
  }
883
883
  export declare class CreateAutoProvisioningGroupRequestLaunchConfigurationDataDisk extends $dara.Model {
884
+ /**
885
+ * @example
886
+ * sp-bp67acfmxazb4p****
887
+ */
884
888
  autoSnapshotPolicyId?: string;
885
889
  /**
886
890
  * @remarks
@@ -1064,6 +1068,10 @@ export declare class CreateAutoProvisioningGroupRequestLaunchConfigurationDataDi
1064
1068
  });
1065
1069
  }
1066
1070
  export declare class CreateAutoProvisioningGroupRequestLaunchConfigurationSystemDisk extends $dara.Model {
1071
+ /**
1072
+ * @example
1073
+ * sp-bp67acfmxazb4p****
1074
+ */
1067
1075
  autoSnapshotPolicyId?: string;
1068
1076
  /**
1069
1077
  * @remarks
@@ -1172,6 +1180,10 @@ export declare class CreateAutoProvisioningGroupRequestLaunchConfigurationTag ex
1172
1180
  });
1173
1181
  }
1174
1182
  export declare class CreateAutoProvisioningGroupRequestLaunchConfigurationImageOptions extends $dara.Model {
1183
+ /**
1184
+ * @example
1185
+ * false
1186
+ */
1175
1187
  loginAsNonRoot?: boolean;
1176
1188
  static names(): {
1177
1189
  [key: string]: string;
@@ -1561,7 +1573,15 @@ export declare class CreateAutoProvisioningGroupRequestLaunchConfiguration exten
1561
1573
  * Month
1562
1574
  */
1563
1575
  periodUnit?: string;
1576
+ /**
1577
+ * @example
1578
+ * 1
1579
+ */
1564
1580
  spotDuration?: number;
1581
+ /**
1582
+ * @example
1583
+ * Terminate
1584
+ */
1565
1585
  spotInterruptionBehavior?: string;
1566
1586
  static names(): {
1567
1587
  [key: string]: string;
@@ -1639,7 +1659,7 @@ export declare class CreateAutoProvisioningGroupRequestLaunchTemplateConfig exte
1639
1659
  imageId?: string;
1640
1660
  /**
1641
1661
  * @remarks
1642
- * The instance family level of the instance type in extended configuration N. This parameter is used to filter instance types. Valid values of Nextended configuration N Valid values:
1662
+ * The instance family level of the instance type in extended configuration N. This parameter is used to filter instance types. Valid values of Nextended configuration N, Valid values:
1643
1663
  *
1644
1664
  * * EntryLevel: entry level (shared instance types). Instance types of this level are the most cost-effective but may not ensure stable computing performance. Instance types of this level are suitable for scenarios in which the CPU utilization is low. For more information, see [Shared instance families](https://help.aliyun.com/document_detail/108489.html).
1645
1665
  * * EnterpriseLevel: enterprise level. Instance types of this level provide stable performance and dedicated resources and are suitable for business scenarios that require high stability. For more information, see [Overview of instance families](https://help.aliyun.com/document_detail/25378.html).
@@ -1893,6 +1913,10 @@ export declare class CreateAutoProvisioningGroupShrinkRequestLaunchConfiguration
1893
1913
  });
1894
1914
  }
1895
1915
  export declare class CreateAutoProvisioningGroupShrinkRequestLaunchConfigurationDataDisk extends $dara.Model {
1916
+ /**
1917
+ * @example
1918
+ * sp-bp67acfmxazb4p****
1919
+ */
1896
1920
  autoSnapshotPolicyId?: string;
1897
1921
  /**
1898
1922
  * @remarks
@@ -2076,6 +2100,10 @@ export declare class CreateAutoProvisioningGroupShrinkRequestLaunchConfiguration
2076
2100
  });
2077
2101
  }
2078
2102
  export declare class CreateAutoProvisioningGroupShrinkRequestLaunchConfigurationSystemDisk extends $dara.Model {
2103
+ /**
2104
+ * @example
2105
+ * sp-bp67acfmxazb4p****
2106
+ */
2079
2107
  autoSnapshotPolicyId?: string;
2080
2108
  /**
2081
2109
  * @remarks
@@ -2184,6 +2212,10 @@ export declare class CreateAutoProvisioningGroupShrinkRequestLaunchConfiguration
2184
2212
  });
2185
2213
  }
2186
2214
  export declare class CreateAutoProvisioningGroupShrinkRequestLaunchConfigurationImageOptions extends $dara.Model {
2215
+ /**
2216
+ * @example
2217
+ * false
2218
+ */
2187
2219
  loginAsNonRoot?: boolean;
2188
2220
  static names(): {
2189
2221
  [key: string]: string;
@@ -2573,7 +2605,15 @@ export declare class CreateAutoProvisioningGroupShrinkRequestLaunchConfiguration
2573
2605
  * Month
2574
2606
  */
2575
2607
  periodUnit?: string;
2608
+ /**
2609
+ * @example
2610
+ * 1
2611
+ */
2576
2612
  spotDuration?: number;
2613
+ /**
2614
+ * @example
2615
+ * Terminate
2616
+ */
2577
2617
  spotInterruptionBehavior?: string;
2578
2618
  static names(): {
2579
2619
  [key: string]: string;
@@ -2651,7 +2691,7 @@ export declare class CreateAutoProvisioningGroupShrinkRequestLaunchTemplateConfi
2651
2691
  imageId?: string;
2652
2692
  /**
2653
2693
  * @remarks
2654
- * The instance family level of the instance type in extended configuration N. This parameter is used to filter instance types. Valid values of Nextended configuration N Valid values:
2694
+ * The instance family level of the instance type in extended configuration N. This parameter is used to filter instance types. Valid values of Nextended configuration N, Valid values:
2655
2695
  *
2656
2696
  * * EntryLevel: entry level (shared instance types). Instance types of this level are the most cost-effective but may not ensure stable computing performance. Instance types of this level are suitable for scenarios in which the CPU utilization is low. For more information, see [Shared instance families](https://help.aliyun.com/document_detail/108489.html).
2657
2697
  * * EnterpriseLevel: enterprise level. Instance types of this level provide stable performance and dedicated resources and are suitable for business scenarios that require high stability. For more information, see [Overview of instance families](https://help.aliyun.com/document_detail/25378.html).
@@ -5741,6 +5781,20 @@ export declare class CreatePrefixListRequestEntry extends $dara.Model {
5741
5781
  [key: string]: any;
5742
5782
  });
5743
5783
  }
5784
+ export declare class CreatePrefixListRequestTag extends $dara.Model {
5785
+ key?: string;
5786
+ value?: string;
5787
+ static names(): {
5788
+ [key: string]: string;
5789
+ };
5790
+ static types(): {
5791
+ [key: string]: any;
5792
+ };
5793
+ validate(): void;
5794
+ constructor(map?: {
5795
+ [key: string]: any;
5796
+ });
5797
+ }
5744
5798
  export declare class CreateRouteEntryRequestNextHopList extends $dara.Model {
5745
5799
  nextHopId?: string;
5746
5800
  nextHopType?: string;
@@ -23205,6 +23259,47 @@ export declare class DescribePrefixListAttributesResponseBodyEntries extends $da
23205
23259
  [key: string]: any;
23206
23260
  });
23207
23261
  }
23262
+ export declare class DescribePrefixListsRequestTag extends $dara.Model {
23263
+ key?: string;
23264
+ value?: string;
23265
+ static names(): {
23266
+ [key: string]: string;
23267
+ };
23268
+ static types(): {
23269
+ [key: string]: any;
23270
+ };
23271
+ validate(): void;
23272
+ constructor(map?: {
23273
+ [key: string]: any;
23274
+ });
23275
+ }
23276
+ export declare class DescribePrefixListsResponseBodyPrefixListsPrefixListTagsTag extends $dara.Model {
23277
+ tagKey?: string;
23278
+ tagValue?: string;
23279
+ static names(): {
23280
+ [key: string]: string;
23281
+ };
23282
+ static types(): {
23283
+ [key: string]: any;
23284
+ };
23285
+ validate(): void;
23286
+ constructor(map?: {
23287
+ [key: string]: any;
23288
+ });
23289
+ }
23290
+ export declare class DescribePrefixListsResponseBodyPrefixListsPrefixListTags extends $dara.Model {
23291
+ tag?: DescribePrefixListsResponseBodyPrefixListsPrefixListTagsTag[];
23292
+ static names(): {
23293
+ [key: string]: string;
23294
+ };
23295
+ static types(): {
23296
+ [key: string]: any;
23297
+ };
23298
+ validate(): void;
23299
+ constructor(map?: {
23300
+ [key: string]: any;
23301
+ });
23302
+ }
23208
23303
  export declare class DescribePrefixListsResponseBodyPrefixListsPrefixList extends $dara.Model {
23209
23304
  /**
23210
23305
  * @remarks
@@ -23265,6 +23360,8 @@ export declare class DescribePrefixListsResponseBodyPrefixListsPrefixList extend
23265
23360
  * PrefixListNameSample
23266
23361
  */
23267
23362
  prefixListName?: string;
23363
+ resourceGroupId?: string;
23364
+ tags?: DescribePrefixListsResponseBodyPrefixListsPrefixListTags;
23268
23365
  static names(): {
23269
23366
  [key: string]: string;
23270
23367
  };
@@ -32286,6 +32383,8 @@ export declare class RunInstancesRequestSystemDisk extends $dara.Model {
32286
32383
  *
32287
32384
  * > The system disks of instances cannot be encrypted during instance creation in Hong Kong Zone D or Singapore Zone A.
32288
32385
  *
32386
+ * > When you use a shared encrypted image to create the disk based on an encrypted snapshot, you must set Encrypted to true to ensure that the disk uses an encryption key of your own.
32387
+ *
32289
32388
  * @example
32290
32389
  * false
32291
32390
  */
@@ -32302,7 +32401,7 @@ export declare class RunInstancesRequestSystemDisk extends $dara.Model {
32302
32401
  * @remarks
32303
32402
  * The provisioned read/write IOPS of the ESSD AutoPL disk to use as the system disk. Valid values: 0 to min{50,000, 1,000 × Capacity - Baseline IOPS}.
32304
32403
  *
32305
- * Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}
32404
+ * Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}.
32306
32405
  *
32307
32406
  * > This parameter is available only if you set `SystemDisk.Category` to `cloud_auto`. For more information, see [ESSD AutoPL disks](https://help.aliyun.com/document_detail/368372.html).
32308
32407
  *
@@ -32378,8 +32477,8 @@ export declare class RunInstancesRequestDataDisk extends $dara.Model {
32378
32477
  * @remarks
32379
32478
  * Specifies whether to enable the performance burst feature for data disk N. Valid values:
32380
32479
  *
32381
- * * true
32382
- * * false
32480
+ * * true: enables the performance burst feature for the data disk.
32481
+ * * false: disables the performance burst feature for the data disk.
32383
32482
  *
32384
32483
  * > This parameter is available only if you set DataDisk.N.Category to cloud_auto. For more information, see [ESSD AutoPL disks](https://help.aliyun.com/document_detail/368372.html).
32385
32484
  *
@@ -32391,25 +32490,25 @@ export declare class RunInstancesRequestDataDisk extends $dara.Model {
32391
32490
  * @remarks
32392
32491
  * The category of data disk N. Valid values:
32393
32492
  *
32394
- * * cloud_efficiency: ultra disk
32493
+ * * cloud_efficiency: ultra disk.
32395
32494
  *
32396
- * * cloud_ssd: standard SSD
32495
+ * * cloud_ssd: standard SSD.
32397
32496
  *
32398
- * * cloud_essd: ESSD
32497
+ * * cloud_essd: ESSD.
32399
32498
  *
32400
- * * cloud: basic disk
32499
+ * * cloud: basic disk.
32401
32500
  *
32402
- * * cloud_auto: ESSD AutoPL disk
32501
+ * * cloud_auto: ESSD AutoPL disk.
32403
32502
  *
32404
- * * cloud_essd_entry: ESSD Entry disk
32503
+ * * cloud_essd_entry: ESSD Entry disk.
32405
32504
  *
32406
32505
  * **
32407
32506
  *
32408
32507
  * **Note** This parameter can be set to `cloud_essd_entry` only when `InstanceType` is set to `ecs.u1` or `ecs.e`.
32409
32508
  *
32410
- * * elastic_ephemeral_disk_standard: standard elastic ephemeral disk
32509
+ * * elastic_ephemeral_disk_standard: standard elastic ephemeral disk.
32411
32510
  *
32412
- * * elastic_ephemeral_disk_premium: premium elastic ephemeral disk
32511
+ * * elastic_ephemeral_disk_premium: premium elastic ephemeral disk.
32413
32512
  *
32414
32513
  * For I/O optimized instances, the default value is cloud_efficiency. For non-I/O optimized instances, the default value is cloud.
32415
32514
  *
@@ -32419,10 +32518,10 @@ export declare class RunInstancesRequestDataDisk extends $dara.Model {
32419
32518
  category?: string;
32420
32519
  /**
32421
32520
  * @remarks
32422
- * Specifies whether to release data disk N when the instance is released. Valid values:
32521
+ * Specifies whether to release data disk N when the associated instance is released. Valid values:
32423
32522
  *
32424
- * * true
32425
- * * false
32523
+ * * true: releases the data disk when the associated instance is released.
32524
+ * * false: does not release the data disk when the associated instance is released.
32426
32525
  *
32427
32526
  * Default value: true.
32428
32527
  *
@@ -32445,7 +32544,7 @@ export declare class RunInstancesRequestDataDisk extends $dara.Model {
32445
32544
  * * 1st to 25th data disks: /dev/xvd`[b-z]`.
32446
32545
  * * From the 26th data disk on: /dev/xvd`[aa-zz]`. For example, the 26th data disk is named /dev/xvdaa, the 27th data disk is named /dev/xvdab, and so on.
32447
32546
  *
32448
- * > This parameter is applicable to scenarios in which a full image is used to create instances. A full image is an image that contains an operating system, application software, and business data. For these scenarios, you can set the parameter to the mount point of data disk N contained in the full image and modify the `DataDisk.N.Size` and `DataDisk.N.Category` parameters to change the category and size of data disk N created based on the image.
32547
+ * > This parameter is applicable to scenarios in which a full image is used to create instances. A full image is an image that contains an operating system, application software, and business data. For these scenarios, you can set this parameter to the mount point of data disk N in the full image and modify `DataDisk.N.Size` and `DataDisk.N.Category` to change the category and size of data disk N created based on the image.
32449
32548
  *
32450
32549
  * @example
32451
32550
  * /dev/xvdb
@@ -32471,11 +32570,13 @@ export declare class RunInstancesRequestDataDisk extends $dara.Model {
32471
32570
  * @remarks
32472
32571
  * Specifies whether to encrypt data disk N. Valid values:
32473
32572
  *
32474
- * * true
32475
- * * false
32573
+ * * true: encrypts the data disk.
32574
+ * * false: does not encrypt the data disk.
32476
32575
  *
32477
32576
  * Default value: false.
32478
32577
  *
32578
+ * > When you use a shared encrypted image to create the disk based on an encrypted snapshot, you must set Encrypted to true to ensure that the disk uses an encryption key of your own.
32579
+ *
32479
32580
  * @example
32480
32581
  * false
32481
32582
  */
@@ -32493,9 +32594,9 @@ export declare class RunInstancesRequestDataDisk extends $dara.Model {
32493
32594
  * The performance level of the ESSD to use as data disk N. The value of N must be the same as that in `DataDisk.N.Category` when DataDisk.N.Category is set to cloud_essd. Valid values:
32494
32595
  *
32495
32596
  * * PL0: A single ESSD can deliver up to 10,000 random read/write IOPS.
32496
- * * PL1 (default): A single ESSD can deliver up to 50000 random read/write IOPS.
32497
- * * PL2: A single ESSD can deliver up to 100000 random read/write IOPS.
32498
- * * PL3: A single ESSD can deliver up to 1000000 random read/write IOPS.
32597
+ * * PL1 (default): A single ESSD can deliver up to 50,000 random read/write IOPS.
32598
+ * * PL2: A single ESSD can deliver up to 100,000 random read/write IOPS.
32599
+ * * PL3: A single ESSD can deliver up to 1,000,000 random read/write IOPS.
32499
32600
  *
32500
32601
  * For information about ESSD performance levels, see [ESSDs](https://help.aliyun.com/document_detail/122389.html).
32501
32602
  *
@@ -32507,7 +32608,7 @@ export declare class RunInstancesRequestDataDisk extends $dara.Model {
32507
32608
  * @remarks
32508
32609
  * The provisioned read/write IOPS of the ESSD AutoPL disk to use as data disk N. Valid values: 0 to min{50,000, 1,000 × Capacity - Baseline IOPS}.
32509
32610
  *
32510
- * Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}
32611
+ * Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}.
32511
32612
  *
32512
32613
  * > This parameter is available only if you set DataDisk.N.Category to cloud_auto. For more information, see [ESSD AutoPL disks](https://help.aliyun.com/document_detail/368372.html).
32513
32614
  *
@@ -32532,7 +32633,7 @@ export declare class RunInstancesRequestDataDisk extends $dara.Model {
32532
32633
  *
32533
32634
  * * Valid values when DataDisk.N.Category is set to cloud: 5 to 2000.
32534
32635
  *
32535
- * * Valid values when DiskCategory is set to cloud_auto: 1 to 65536.
32636
+ * * Valid values when DataDisk.N.Category is set to cloud_auto: 1 to 65536.
32536
32637
  *
32537
32638
  * * Valid values when DataDisk.N.Category is set to cloud_essd_entry: 10 to 32768.
32538
32639
  *
@@ -32546,7 +32647,7 @@ export declare class RunInstancesRequestDataDisk extends $dara.Model {
32546
32647
  * @remarks
32547
32648
  * The ID of the snapshot to use to create data disk N. Valid values of N: 1 to 16.
32548
32649
  *
32549
- * When the `DataDisk.N.SnapshotId` parameter is specified, the `DataDisk.N.Size` parameter is ignored. The data disk is created with the size of the specified snapshot. Use snapshots created on or after July 15, 2013. Otherwise, an error is returned and your request is rejected.
32650
+ * When `DataDisk.N.SnapshotId` is specified, `DataDisk.N.Size` is ignored. The data disk is created with the size of the specified snapshot. Use snapshots created after July 15, 2013. Otherwise, an error is returned and your request is rejected.
32550
32651
  *
32551
32652
  * @example
32552
32653
  * s-bp17441ohwka0yuh****
@@ -32873,7 +32974,7 @@ export declare class RunInstancesRequestNetworkOptions extends $dara.Model {
32873
32974
  *
32874
32975
  * Default value: true.
32875
32976
  *
32876
- * > The Jumbo Frames feature is supported by only 8th-generation or later instance types. For more information, see [MTUs](https://help.aliyun.com/document_detail/200512.html).
32977
+ * > The Jumbo Frames feature is supported by only 8th-generation or later instance types. For more information, see [Jumbo Frames](https://help.aliyun.com/document_detail/200512.html).
32877
32978
  *
32878
32979
  * @example
32879
32980
  * false
@@ -42569,8 +42670,10 @@ export declare class CreatePrefixListRequest extends $dara.Model {
42569
42670
  * cn-chengdu
42570
42671
  */
42571
42672
  regionId?: string;
42673
+ resourceGroupId?: string;
42572
42674
  resourceOwnerAccount?: string;
42573
42675
  resourceOwnerId?: number;
42676
+ tag?: CreatePrefixListRequestTag[];
42574
42677
  static names(): {
42575
42678
  [key: string]: string;
42576
42679
  };
@@ -58817,8 +58920,10 @@ export declare class DescribePrefixListsRequest extends $dara.Model {
58817
58920
  * cn-chengdu
58818
58921
  */
58819
58922
  regionId?: string;
58923
+ resourceGroupId?: string;
58820
58924
  resourceOwnerAccount?: string;
58821
58925
  resourceOwnerId?: number;
58926
+ tag?: DescribePrefixListsRequestTag[];
58822
58927
  static names(): {
58823
58928
  [key: string]: string;
58824
58929
  };
@@ -69975,7 +70080,7 @@ export declare class ModifyImageShareGroupPermissionResponse extends $dara.Model
69975
70080
  export declare class ModifyImageSharePermissionRequest extends $dara.Model {
69976
70081
  /**
69977
70082
  * @remarks
69978
- * The ID of Alibaba Cloud account N to which you want to share the custom image. Valid values of N: 1 to 10. If you specify more than 10 Alibaba Cloud account IDs, the system processes only the first 10 account IDs. The excess account IDs are ignored.
70083
+ * The IDs of Alibaba Cloud accounts to which you want to share the custom image. Valid values of N: 1 to 10. If you specify more than 10 Alibaba Cloud account IDs, the system processes only the first 10 account IDs. The excess account IDs are ignored.
69979
70084
  *
69980
70085
  * @example
69981
70086
  * 1234567890
@@ -69983,7 +70088,9 @@ export declare class ModifyImageSharePermissionRequest extends $dara.Model {
69983
70088
  addAccount?: string[];
69984
70089
  /**
69985
70090
  * @remarks
69986
- * The ID of the custom image.
70091
+ * The ID of the shared custom image.
70092
+ *
70093
+ * > You can share images encrypted by using CMKs but cannot share images encrypted by using service keys. When you share an image encrypted by using a service key, an error is reported.
69987
70094
  *
69988
70095
  * This parameter is required.
69989
70096
  *
@@ -70026,7 +70133,7 @@ export declare class ModifyImageSharePermissionRequest extends $dara.Model {
70026
70133
  regionId?: string;
70027
70134
  /**
70028
70135
  * @remarks
70029
- * The ID of Alibaba Cloud account N from which you want to unshare the custom image. Valid values of N: 1 to 10. If you specify more than 10 Alibaba Cloud account IDs, the system processes only the first 10 account IDs. The excess account IDs are ignored.
70136
+ * The IDs of Alibaba Cloud accounts from which you want to unshare the custom image. Valid values of N: 1 to 10. If you specify more than 10 Alibaba Cloud account IDs, the system processes only the first 10 account IDs. The excess account IDs are ignored.
70030
70137
  *
70031
70138
  * @example
70032
70139
  * 1234567890
@@ -75866,7 +75973,7 @@ export declare class RedeployInstanceRequest extends $dara.Model {
75866
75973
  *
75867
75974
  * Default value: false.
75868
75975
  *
75869
- * > A forced stop is equivalent to a power outage, and unsaved data may be lost. We recommend that you redeploy instances that are in the Stopped state.
75976
+ * > A forced stop is equivalent to a power outage and can result in loss of data that is not written to storage devices. We recommend that you redeploy instances when they are in the Stopped state.
75870
75977
  *
75871
75978
  * @example
75872
75979
  * false
@@ -76955,10 +77062,12 @@ export declare class ReplaceSystemDiskRequest extends $dara.Model {
76955
77062
  * @remarks
76956
77063
  * Specifies whether to encrypt the disk. Valid values:
76957
77064
  *
76958
- * * true: encrypts the disk.
76959
- * * false: does not encrypt the disk.
77065
+ * * true
77066
+ * * false
76960
77067
  *
76961
- * Default value: false
77068
+ * Default value: false.
77069
+ *
77070
+ * > When you use a shared encrypted image to create the disk based on an encrypted snapshot, you must set Encrypted to true to ensure that the disk uses an encryption key of your own.
76962
77071
  *
76963
77072
  * @example
76964
77073
  * false
@@ -76966,9 +77075,7 @@ export declare class ReplaceSystemDiskRequest extends $dara.Model {
76966
77075
  encrypted?: boolean;
76967
77076
  /**
76968
77077
  * @remarks
76969
- * The ID of the image to be used to replace the system disk.
76970
- *
76971
- * If the `DiskId` parameter is not specified, this parameter is required.
77078
+ * The ID of the image used to replace the system disk. This parameter is required.
76972
77079
  *
76973
77080
  * @example
76974
77081
  * m-bp67acfmxazb4ph****
@@ -79701,7 +79808,7 @@ export declare class RunInstancesRequest extends $dara.Model {
79701
79808
  export declare class RunInstancesResponseBody extends $dara.Model {
79702
79809
  /**
79703
79810
  * @remarks
79704
- * The IDs of the instances (`InstanceIdSet`).
79811
+ * The instance IDs (`InstanceIdSet`).
79705
79812
  */
79706
79813
  instanceIdSets?: RunInstancesResponseBodyInstanceIdSets;
79707
79814
  /**
@@ -80276,6 +80383,10 @@ export declare class StartTerminalSessionRequest extends $dara.Model {
80276
80383
  * ssh root@192.168.0.246
80277
80384
  */
80278
80385
  commandLine?: string;
80386
+ /**
80387
+ * @example
80388
+ * Intranet
80389
+ */
80279
80390
  connectionType?: string;
80280
80391
  /**
80281
80392
  * @remarks
@@ -87570,7 +87681,7 @@ export default class Client extends OpenApi {
87570
87681
  */
87571
87682
  modifyAutoProvisioningGroup(request: ModifyAutoProvisioningGroupRequest): Promise<ModifyAutoProvisioningGroupResponse>;
87572
87683
  /**
87573
- * Modifies an automatic snapshot policy.
87684
+ * Modifies an automatic snapshot policy. For example, you can change the points in time of the day at which to create automatic snapshots, days of the week on which to create automatic snapshots, and retention period of automatic snapshots for the automatic snapshot policy.
87574
87685
  *
87575
87686
  * @remarks
87576
87687
  * Before you call this operation, take note of the following items:
@@ -87584,7 +87695,7 @@ export default class Client extends OpenApi {
87584
87695
  */
87585
87696
  modifyAutoSnapshotPolicyExWithOptions(request: ModifyAutoSnapshotPolicyExRequest, runtime: $dara.RuntimeOptions): Promise<ModifyAutoSnapshotPolicyExResponse>;
87586
87697
  /**
87587
- * Modifies an automatic snapshot policy.
87698
+ * Modifies an automatic snapshot policy. For example, you can change the points in time of the day at which to create automatic snapshots, days of the week on which to create automatic snapshots, and retention period of automatic snapshots for the automatic snapshot policy.
87588
87699
  *
87589
87700
  * @remarks
87590
87701
  * Before you call this operation, take note of the following items:
@@ -88094,16 +88205,15 @@ export default class Client extends OpenApi {
88094
88205
  * @remarks
88095
88206
  * Before you call this operation, read [Share a custom image](https://help.aliyun.com/document_detail/25463.html).
88096
88207
  * When you call this operation, take note of the following sharing rules:
88097
- * * You can share only the custom images that are created in your Alibaba Cloud to other Alibaba Cloud accounts.
88098
- * * You can share a custom image to up to 10 Alibaba Cloud accounts at a time. You can specify up to 10 Alibaba Cloud account IDs by using the AddAccount.N or RemoveAccount.N parameter. If you specify more than 10 account IDs, the system processes only the previous 10 account IDs. The excess account IDs are ignored.
88099
- * * You can share a custom image to up to 50 Alibaba Cloud accounts.
88100
- * * If an Elastic Compute Service (ECS) instance was created ([RunInstances](https://help.aliyun.com/document_detail/63440.html)) from a shared image, you cannot re-initialize the instance ([ReInitDisk](https://help.aliyun.com/document_detail/25519.html)) after the image owner unshares or deletes the image ([DeleteImage](https://help.aliyun.com/document_detail/25537.html)).
88208
+ * * **Sharing limits**: You can share only the custom images created in your Alibaba Cloud account to other Alibaba Cloud accounts. A custom image can be shared to up to 50 Alibaba Cloud accounts. You can share a custom image to up to 10 Alibaba Cloud accounts at a time.
88209
+ * * **Impacts on an instance**: If an instance was created ([RunInstances](https://help.aliyun.com/document_detail/63440.html)) from a shared image, you cannot re-initialize the system disk of the instance ([ReInitDisk](https://help.aliyun.com/document_detail/25519.html)) after the image owner unshares or deletes the image ([DeleteImage](https://help.aliyun.com/document_detail/25537.html)).
88210
+ * > You can share images encrypted by using customer master keys (CMKs) but cannot share images encrypted by using service keys. When you share an image encrypted by using a service key, an error is reported. If you want to share an image encrypted by using a service key, call the CopyImage operation to copy the image and change the encryption key of the image copy to a CMK.
88101
88211
  * When you publish or unpublish a community image, take note of the following items:
88102
- * * Alibaba Cloud provides only the platform on which 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 acknowledge and agree to the Community Image Agreement. Otherwise, you cannot publish community images. For more information, see [Publish a community image](https://help.aliyun.com/document_detail/208370.html).
88103
- * * You cannot publish encrypted images as community images.
88104
- * * Community images are publicly available. A community image is available to all Alibaba Cloud accounts in the region where the image resides.
88105
- * * You cannot share, export, or copy community images.
88106
- * * After you unpublish a community image, the image is no longer available to other Alibaba Cloud accounts. If an image is shared to other Alibaba Cloud accounts before it is unpublished, the image remains available to the accounts.
88212
+ * * **Responsibilities and agreement**: Alibaba Cloud provides only the platform on which 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 acknowledge and agree to the Community Image Agreement. Otherwise, you cannot publish community images. For more information, see [Publish a community image](https://help.aliyun.com/document_detail/208370.html).
88213
+ * * **Encryption limits**: You cannot publish encrypted images as community images.
88214
+ * * **Openness**: Community images are publicly available. A community image is available to all Alibaba Cloud accounts in the region where the image resides.
88215
+ * * **Feature limits**: You cannot share, export, or copy community images.
88216
+ * * **Unpublication impacts**: After you unpublish a community image, the image is no longer available to other Alibaba Cloud accounts. If an image is shared to other Alibaba Cloud accounts before it is unpublished, the image remains available to the accounts.
88107
88217
  *
88108
88218
  * @param request - ModifyImageSharePermissionRequest
88109
88219
  * @param runtime - runtime options for this request RuntimeOptions
@@ -88116,16 +88226,15 @@ export default class Client extends OpenApi {
88116
88226
  * @remarks
88117
88227
  * Before you call this operation, read [Share a custom image](https://help.aliyun.com/document_detail/25463.html).
88118
88228
  * When you call this operation, take note of the following sharing rules:
88119
- * * You can share only the custom images that are created in your Alibaba Cloud to other Alibaba Cloud accounts.
88120
- * * You can share a custom image to up to 10 Alibaba Cloud accounts at a time. You can specify up to 10 Alibaba Cloud account IDs by using the AddAccount.N or RemoveAccount.N parameter. If you specify more than 10 account IDs, the system processes only the previous 10 account IDs. The excess account IDs are ignored.
88121
- * * You can share a custom image to up to 50 Alibaba Cloud accounts.
88122
- * * If an Elastic Compute Service (ECS) instance was created ([RunInstances](https://help.aliyun.com/document_detail/63440.html)) from a shared image, you cannot re-initialize the instance ([ReInitDisk](https://help.aliyun.com/document_detail/25519.html)) after the image owner unshares or deletes the image ([DeleteImage](https://help.aliyun.com/document_detail/25537.html)).
88229
+ * * **Sharing limits**: You can share only the custom images created in your Alibaba Cloud account to other Alibaba Cloud accounts. A custom image can be shared to up to 50 Alibaba Cloud accounts. You can share a custom image to up to 10 Alibaba Cloud accounts at a time.
88230
+ * * **Impacts on an instance**: If an instance was created ([RunInstances](https://help.aliyun.com/document_detail/63440.html)) from a shared image, you cannot re-initialize the system disk of the instance ([ReInitDisk](https://help.aliyun.com/document_detail/25519.html)) after the image owner unshares or deletes the image ([DeleteImage](https://help.aliyun.com/document_detail/25537.html)).
88231
+ * > You can share images encrypted by using customer master keys (CMKs) but cannot share images encrypted by using service keys. When you share an image encrypted by using a service key, an error is reported. If you want to share an image encrypted by using a service key, call the CopyImage operation to copy the image and change the encryption key of the image copy to a CMK.
88123
88232
  * When you publish or unpublish a community image, take note of the following items:
88124
- * * Alibaba Cloud provides only the platform on which 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 acknowledge and agree to the Community Image Agreement. Otherwise, you cannot publish community images. For more information, see [Publish a community image](https://help.aliyun.com/document_detail/208370.html).
88125
- * * You cannot publish encrypted images as community images.
88126
- * * Community images are publicly available. A community image is available to all Alibaba Cloud accounts in the region where the image resides.
88127
- * * You cannot share, export, or copy community images.
88128
- * * After you unpublish a community image, the image is no longer available to other Alibaba Cloud accounts. If an image is shared to other Alibaba Cloud accounts before it is unpublished, the image remains available to the accounts.
88233
+ * * **Responsibilities and agreement**: Alibaba Cloud provides only the platform on which 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 acknowledge and agree to the Community Image Agreement. Otherwise, you cannot publish community images. For more information, see [Publish a community image](https://help.aliyun.com/document_detail/208370.html).
88234
+ * * **Encryption limits**: You cannot publish encrypted images as community images.
88235
+ * * **Openness**: Community images are publicly available. A community image is available to all Alibaba Cloud accounts in the region where the image resides.
88236
+ * * **Feature limits**: You cannot share, export, or copy community images.
88237
+ * * **Unpublication impacts**: After you unpublish a community image, the image is no longer available to other Alibaba Cloud accounts. If an image is shared to other Alibaba Cloud accounts before it is unpublished, the image remains available to the accounts.
88129
88238
  *
88130
88239
  * @param request - ModifyImageSharePermissionRequest
88131
88240
  * @returns ModifyImageSharePermissionResponse
@@ -89397,27 +89506,28 @@ export default class Client extends OpenApi {
89397
89506
  * Redeploys an Elastic Compute Service (ECS) instance. You can call this operation to redeploy an ECS instance when the instance receives a system event notification.
89398
89507
  *
89399
89508
  * @remarks
89400
- * RedeployInstance is an asynchronous operation. This operation migrates data before it restarts the instance. After the instance is redeployed, the instance enters the `Running` state. If the instance fails to be redeployed, the instance returns to the original physical server and the state before redeployment.
89401
- * Take note of the following items:
89402
- * * The instance must be in the Running or Stopped state. After the instance is redeployed, the following changes occur to the status of the instance:
89403
- * * If the instance is in the `Running` state before redeployment, the instance enters the `Stopping` state.
89404
- * * If the instance is in the `Stopped` state before redeployment, the instance enters the `Starting` state.
89509
+ * ## Usage notes
89510
+ * RedeployInstance is an asynchronous operation. The operation migrates the instance to a healthy physical server and then restarts the instance. After the instance is redeployed, it enters the Running (`Running`) state. If the instance fails to be redeployed, it returns to the original physical server and the state before the redeployment.
89511
+ * When you call this operation, take note of the following item:
89512
+ * * The instance must be in the Running (Running) or Stopped (Stopped) state. After the instance is redeployed, the following changes occur to the status of the instance:
89513
+ * * If the instance is in the Running (`Running`) state, the instance enters the Stopping (`Stopping`) state.
89514
+ * * If the instance is in the Stopped (`Stopped`) state, the instance enters the Starting (`Starting`) state.
89405
89515
  * * If an instance is deployed on a dedicated host, you cannot redeploy the instance.
89406
- * * If the `OperationLocks` parameter in the response of the DescribeInstances operation contains `"LockReason" : "security"` for an instance, the instance is locked for security reasons and cannot be redeployed.
89407
- * * If you receive notifications about simulated events that are created by calling the CreateSimulatedSystemEvent operation for an instance, you cannot redeploy the instance.
89408
- * * If the damaged local disk is isolated but the **SystemMaintenance.RebootAndReInitErrorDisk** event is not sent when you handle a local disk-related system event for an instance, you can still call the RedeployInstance operation to redeploy the instance. The SystemMaintenance.RebootAndReInitErrorDisk event indicates that the instance is restarted and the damaged disks are reinitialized due to system maintenance. For more information, see [System events for ECS instances equipped with local disks](https://help.aliyun.com/document_detail/107693.html).
89409
- * The following table describes the system events that you can handle by calling the RedeployInstance operation. The table also provides possible event status.
89516
+ * * If `OperationLocks` in the response of the DescribeInstances operation contains `"LockReason": "security"` for an instance, the instance is locked for security reasons and cannot be redeployed.
89517
+ * * If an instance receives notifications about simulated events that are created by calling the CreateSimulatedSystemEvent operation for the instance, you cannot call this operation to redeploy the instance.
89518
+ * * When you handle a local disk-related system event for an instance, if the damaged local disk is isolated but the SystemMaintenance.RebootAndReInitErrorDisk (**instance restart and re-initialization of damaged disks due to system maintenance**) event is not sent, you can still call the RedeployInstance operation to redeploy the instance. For more information, see [O&#x26;M scenarios and system events for instances equipped with local disks](https://help.aliyun.com/document_detail/107693.html).
89519
+ * The following table describes the types and states of events that you can handle by calling the RedeployInstance operation.
89410
89520
  * |System event|Event status|
89411
89521
  * |---|---|
89412
89522
  * |Instance restart due to system maintenance (SystemMaintenance.Reboot)|Inquiring and Scheduled|
89413
89523
  * |Instance redeployment due to system maintenance (SystemMaintenance.Redeploy)|Inquiring and Scheduled|
89414
89524
  * |Instance restart and replacement of damaged disks due to system maintenance (SystemMaintenance.RebootAndIsolateErrorDisk)|Inquiring|
89415
89525
  * |Instance restart and re-initialization of damaged disks due to system maintenance (SystemMaintenance.RebootAndReInitErrorDisk)|Inquiring|
89416
- * |Instance redeployment due to system errors (SystemFailure.Redeploy)|Inquiring and Scheduled|
89417
- * |For ECS instances that use only local disks: instance restart due to a system error (SystemFailure.Reboot)|Executing|
89526
+ * |Instance redeployment due to system errors (SystemFailure.Redeploy)|Inquiring|
89527
+ * |For ECS instances that use only local disks: instance restart due to system errors (SystemFailure.Reboot)|Executing|
89418
89528
  * |Isolation of damaged disks due to system maintenance (SystemMaintenance.IsolateErrorDisk)|Inquiring|
89419
89529
  * |Re-initialization of damaged disks due to system maintenance (SystemMaintenance.ReInitErrorDisk)|Inquiring|
89420
- * **Note**When instances that use local disks are redeployed, the local disks are re-initialized and data on the local disks is cleared.
89530
+ * **Note** When the system redeploys instances equipped with local disks, the local disks are re-initialized and data on the local disks is cleared.
89421
89531
  *
89422
89532
  * @param request - RedeployInstanceRequest
89423
89533
  * @param runtime - runtime options for this request RuntimeOptions
@@ -89428,27 +89538,28 @@ export default class Client extends OpenApi {
89428
89538
  * Redeploys an Elastic Compute Service (ECS) instance. You can call this operation to redeploy an ECS instance when the instance receives a system event notification.
89429
89539
  *
89430
89540
  * @remarks
89431
- * RedeployInstance is an asynchronous operation. This operation migrates data before it restarts the instance. After the instance is redeployed, the instance enters the `Running` state. If the instance fails to be redeployed, the instance returns to the original physical server and the state before redeployment.
89432
- * Take note of the following items:
89433
- * * The instance must be in the Running or Stopped state. After the instance is redeployed, the following changes occur to the status of the instance:
89434
- * * If the instance is in the `Running` state before redeployment, the instance enters the `Stopping` state.
89435
- * * If the instance is in the `Stopped` state before redeployment, the instance enters the `Starting` state.
89541
+ * ## Usage notes
89542
+ * RedeployInstance is an asynchronous operation. The operation migrates the instance to a healthy physical server and then restarts the instance. After the instance is redeployed, it enters the Running (`Running`) state. If the instance fails to be redeployed, it returns to the original physical server and the state before the redeployment.
89543
+ * When you call this operation, take note of the following item:
89544
+ * * The instance must be in the Running (Running) or Stopped (Stopped) state. After the instance is redeployed, the following changes occur to the status of the instance:
89545
+ * * If the instance is in the Running (`Running`) state, the instance enters the Stopping (`Stopping`) state.
89546
+ * * If the instance is in the Stopped (`Stopped`) state, the instance enters the Starting (`Starting`) state.
89436
89547
  * * If an instance is deployed on a dedicated host, you cannot redeploy the instance.
89437
- * * If the `OperationLocks` parameter in the response of the DescribeInstances operation contains `"LockReason" : "security"` for an instance, the instance is locked for security reasons and cannot be redeployed.
89438
- * * If you receive notifications about simulated events that are created by calling the CreateSimulatedSystemEvent operation for an instance, you cannot redeploy the instance.
89439
- * * If the damaged local disk is isolated but the **SystemMaintenance.RebootAndReInitErrorDisk** event is not sent when you handle a local disk-related system event for an instance, you can still call the RedeployInstance operation to redeploy the instance. The SystemMaintenance.RebootAndReInitErrorDisk event indicates that the instance is restarted and the damaged disks are reinitialized due to system maintenance. For more information, see [System events for ECS instances equipped with local disks](https://help.aliyun.com/document_detail/107693.html).
89440
- * The following table describes the system events that you can handle by calling the RedeployInstance operation. The table also provides possible event status.
89548
+ * * If `OperationLocks` in the response of the DescribeInstances operation contains `"LockReason": "security"` for an instance, the instance is locked for security reasons and cannot be redeployed.
89549
+ * * If an instance receives notifications about simulated events that are created by calling the CreateSimulatedSystemEvent operation for the instance, you cannot call this operation to redeploy the instance.
89550
+ * * When you handle a local disk-related system event for an instance, if the damaged local disk is isolated but the SystemMaintenance.RebootAndReInitErrorDisk (**instance restart and re-initialization of damaged disks due to system maintenance**) event is not sent, you can still call the RedeployInstance operation to redeploy the instance. For more information, see [O&#x26;M scenarios and system events for instances equipped with local disks](https://help.aliyun.com/document_detail/107693.html).
89551
+ * The following table describes the types and states of events that you can handle by calling the RedeployInstance operation.
89441
89552
  * |System event|Event status|
89442
89553
  * |---|---|
89443
89554
  * |Instance restart due to system maintenance (SystemMaintenance.Reboot)|Inquiring and Scheduled|
89444
89555
  * |Instance redeployment due to system maintenance (SystemMaintenance.Redeploy)|Inquiring and Scheduled|
89445
89556
  * |Instance restart and replacement of damaged disks due to system maintenance (SystemMaintenance.RebootAndIsolateErrorDisk)|Inquiring|
89446
89557
  * |Instance restart and re-initialization of damaged disks due to system maintenance (SystemMaintenance.RebootAndReInitErrorDisk)|Inquiring|
89447
- * |Instance redeployment due to system errors (SystemFailure.Redeploy)|Inquiring and Scheduled|
89448
- * |For ECS instances that use only local disks: instance restart due to a system error (SystemFailure.Reboot)|Executing|
89558
+ * |Instance redeployment due to system errors (SystemFailure.Redeploy)|Inquiring|
89559
+ * |For ECS instances that use only local disks: instance restart due to system errors (SystemFailure.Reboot)|Executing|
89449
89560
  * |Isolation of damaged disks due to system maintenance (SystemMaintenance.IsolateErrorDisk)|Inquiring|
89450
89561
  * |Re-initialization of damaged disks due to system maintenance (SystemMaintenance.ReInitErrorDisk)|Inquiring|
89451
- * **Note**When instances that use local disks are redeployed, the local disks are re-initialized and data on the local disks is cleared.
89562
+ * **Note** When the system redeploys instances equipped with local disks, the local disks are re-initialized and data on the local disks is cleared.
89452
89563
  *
89453
89564
  * @param request - RedeployInstanceRequest
89454
89565
  * @returns RedeployInstanceResponse
@@ -90121,23 +90232,25 @@ export default class Client extends OpenApi {
90121
90232
  * Creates Elastic Compute Service (ECS) instances. This operation helps simplify the procedure to create and manage ECS instances. When you call this operation, you can choose to create multiple ECS instances at a time, automatically start the instances, and assign public IP addresses to the instances based on outbound bandwidth parameters. You can also use the features provided by the operation, such as configuring an automatic release time for instances, using a launch template, and configuring custom CPU options, to customize instance configurations for better management of instances.
90122
90233
  *
90123
90234
  * @remarks
90124
- * *Before you call this operation, familiarize yourself with the billing and [pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS resources.**
90235
+ * \\*\\* When you create an ECS instance, you are charged for ECS resources, including the [instance type](https://help.aliyun.com/document_detail/25398.html), [image](https://help.aliyun.com/document_detail/179021.html), [block storage](https://help.aliyun.com/document_detail/179022.html), and [public bandwidth](https://help.aliyun.com/document_detail/25411.html). Before you call this operation, familiarize yourself with the billing rules and
90236
+ * [pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS resources. \\*\\*
90125
90237
  * This operation is an asynchronous operation. After a request to create ECS instances is sent, ECS instance IDs are returned but the creation and startup of the instances may be incomplete. You can call the [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) operation to query the status of the instances. When the status of an instance is `Running` in the DescribeInstanceStatus response, the instance is created and started.
90126
90238
  * ### [](#)Considerations
90127
- * * Make sure that the number of ECS instances you created or the number of vCPUs on ECS instances of all instance types you created does not exceed the corresponding quota. Go to the [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to view the quotas.
90128
- * * Before you create ECS instances of the Virtual Private Cloud (VPC) type in a region, create a VPC in the region. For more information, see [Create a VPC](https://help.aliyun.com/document_detail/65430.html).
90239
+ * * If the resource inventory is insufficient to complete instance creation, Alibaba Cloud immediately sends an instance creation failure event (SystemFailure.Delete). You can call the [DescribeInstanceHistoryEvents](https://help.aliyun.com/document_detail/2679897.html) operation to check whether an instance creation failure event exists. For more information, see [System events related to instance creation failures](https://help.aliyun.com/document_detail/2545990.html).
90240
+ * * Make sure that the number of ECS instances you create or the number of vCPUs on ECS instances of all instance types you create does not exceed the corresponding quota. Go to the [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to view the quotas.
90241
+ * * Before you create ECS instances of the Virtual Private Cloud (VPC) type in a region, [create a VPC](https://help.aliyun.com/document_detail/65430.html) in the region.
90129
90242
  * ### [](#)Precautions
90130
- * * If you create a subscription instance (`PrePaid`), available coupons in your account are used by default.
90131
- * * You can call the RunInstances operation to create up to 100 ECS instances at a time. To create more than 100 ECS instances, we recommend that you initiate multiple requests in batches or concurrently.
90243
+ * * If you create a subscription instance (`PrePaid`), available coupons in your account are automatically used.
90244
+ * * You can call the RunInstances operation to create up to 100 ECS instances in a single request. To create more than 100 ECS instances, we recommend that you initiate multiple requests in batches or concurrently.
90132
90245
  * * If you set `InternetMaxBandwidthOut` to a value greater than 0, public IP addresses are automatically assigned to the ECS instances to be created.
90133
- * > For the limits on the sum of maximum public bandwidths of ECS instances that use the pay-by-bandwidth billing method for network usage per region per Alibaba Cloud account, see the [Public bandwidth limits](~~25412#BandwidthQuota~~) section of the "Limits" topic.
90246
+ * > For the limits on the sum of maximum public bandwidths of ECS instances that use the pay-by-bandwidth billing method for network usage per region per Alibaba Cloud account, see the [Public bandwidth](~~25412#BandwidthQuota~~) section of the "Limits and quotas on ECS" topic.
90134
90247
  * ### [](#)Suggestions
90135
90248
  * * **Test scenarios**: Set `DryRun` to true to perform a dry run without performing the actual request.
90136
90249
  * * **Release of ECS instances**: Use `AutoReleaseTime` to configure an automatic release time for ECS instances in the request to RunInstances or call the [DeleteInstances](https://help.aliyun.com/document_detail/2679710.html) operation to release the instances.
90137
90250
  * * **Management and search of ECS instances**: Add tags to the ECS instances by specifying `Tag.N.Key` and `Tag.N.Value` and append incremental suffixes by specifying `UniqueSuffix` to the hostname specified by `HostName` and the instance name specified by `InstanceName`. For more information, see [Batch configure sequential names or hostnames for multiple instances](https://help.aliyun.com/document_detail/196048.html).
90138
90251
  * * **Launch template**: A launch template contains the parameters required to create an ECS instance so that you do not have to specify the parameters every time you create ECS instances. You can call the [CreateLaunchTemplate](https://help.aliyun.com/document_detail/2679729.html) operation to create a launch template. Then, in the request to `RunInstances`, you can specify `LaunchTemplateId` and `LaunchTemplateVersion` to use the launch template.
90139
90252
  * * **Disabling of Hyper-Threading (HT)**: In memory-intensive scenarios, set `CpuOptions.ThreadsPerCore` to 1 to disable HT and increase the memory-to-vCPU ratio.
90140
- * * **Enabling of Jumbo Frames**: Set `NetworkOptions.EnableJumboFrame` to true to enable the `Jumbo Frames` feature when you create ECS instances. For more information, see [MTUs](https://help.aliyun.com/document_detail/200512.html).
90253
+ * * **Enabling of Jumbo Frames**: Set `NetworkOptions.EnableJumboFrame` to true to enable the `Jumbo Frames` feature when you create ECS instances. For more information, see [Jumbo Frames](https://help.aliyun.com/document_detail/200512.html).
90141
90254
  * ## [](#)Sample requests
90142
90255
  * Use a specific image to create ECS instances of a specific instance type in the China (Hangzhou) region. The instances use disks with a specific capacity as the system disk and data disks and are automatically assigned public IP addresses. The instances have user-defined names and logon passwords. The instances are assigned to a specific security group and connected to a specific vSwitch. Request parameters:
90143
90256
  * RegionId:"cn-hangzhou", //Set the region ID to cn-hangzhou, which specifies the China (Hangzhou) region.
@@ -90170,7 +90283,7 @@ export default class Client extends OpenApi {
90170
90283
  * Amount:10, //Set the number of ECS instances that you want to create to 10.
90171
90284
  * InstanceChargeType:"PostPaid", //Set the billing method to PostPaid, which specifies the pay-as-you-go billing method.
90172
90285
  * SpotStrategy:"NoSpot" //Set this parameter to NoSpot, which is the default value and specifies that the instances are created as pay-as-you-go instances.
90173
- * **Example: Create 20 preemptible instances that use a specified bidding policy and a protection period**
90286
+ * **Example: Create 20 preemptible instances that use a specific bidding policy and a protection period**
90174
90287
  * Amount:20, //Set the number of ECS instances that you want to create to 20.
90175
90288
  * InstanceChargeType:"PostPaid",
90176
90289
  * SpotStrategy:"SpotAsPriceGo", //Set the bidding policy to SpotAsPriceGo, which specifies that the instances are created as preemptible instances for which the market price at the time of purchase is automatically used as the bid price.
@@ -90191,23 +90304,25 @@ export default class Client extends OpenApi {
90191
90304
  * Creates Elastic Compute Service (ECS) instances. This operation helps simplify the procedure to create and manage ECS instances. When you call this operation, you can choose to create multiple ECS instances at a time, automatically start the instances, and assign public IP addresses to the instances based on outbound bandwidth parameters. You can also use the features provided by the operation, such as configuring an automatic release time for instances, using a launch template, and configuring custom CPU options, to customize instance configurations for better management of instances.
90192
90305
  *
90193
90306
  * @remarks
90194
- * *Before you call this operation, familiarize yourself with the billing and [pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS resources.**
90307
+ * \\*\\* When you create an ECS instance, you are charged for ECS resources, including the [instance type](https://help.aliyun.com/document_detail/25398.html), [image](https://help.aliyun.com/document_detail/179021.html), [block storage](https://help.aliyun.com/document_detail/179022.html), and [public bandwidth](https://help.aliyun.com/document_detail/25411.html). Before you call this operation, familiarize yourself with the billing rules and
90308
+ * [pricing](https://www.alibabacloud.com/zh/pricing-calculator#/commodity/vm_intl) of ECS resources. \\*\\*
90195
90309
  * This operation is an asynchronous operation. After a request to create ECS instances is sent, ECS instance IDs are returned but the creation and startup of the instances may be incomplete. You can call the [DescribeInstanceStatus](https://help.aliyun.com/document_detail/2679688.html) operation to query the status of the instances. When the status of an instance is `Running` in the DescribeInstanceStatus response, the instance is created and started.
90196
90310
  * ### [](#)Considerations
90197
- * * Make sure that the number of ECS instances you created or the number of vCPUs on ECS instances of all instance types you created does not exceed the corresponding quota. Go to the [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to view the quotas.
90198
- * * Before you create ECS instances of the Virtual Private Cloud (VPC) type in a region, create a VPC in the region. For more information, see [Create a VPC](https://help.aliyun.com/document_detail/65430.html).
90311
+ * * If the resource inventory is insufficient to complete instance creation, Alibaba Cloud immediately sends an instance creation failure event (SystemFailure.Delete). You can call the [DescribeInstanceHistoryEvents](https://help.aliyun.com/document_detail/2679897.html) operation to check whether an instance creation failure event exists. For more information, see [System events related to instance creation failures](https://help.aliyun.com/document_detail/2545990.html).
90312
+ * * Make sure that the number of ECS instances you create or the number of vCPUs on ECS instances of all instance types you create does not exceed the corresponding quota. Go to the [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to view the quotas.
90313
+ * * Before you create ECS instances of the Virtual Private Cloud (VPC) type in a region, [create a VPC](https://help.aliyun.com/document_detail/65430.html) in the region.
90199
90314
  * ### [](#)Precautions
90200
- * * If you create a subscription instance (`PrePaid`), available coupons in your account are used by default.
90201
- * * You can call the RunInstances operation to create up to 100 ECS instances at a time. To create more than 100 ECS instances, we recommend that you initiate multiple requests in batches or concurrently.
90315
+ * * If you create a subscription instance (`PrePaid`), available coupons in your account are automatically used.
90316
+ * * You can call the RunInstances operation to create up to 100 ECS instances in a single request. To create more than 100 ECS instances, we recommend that you initiate multiple requests in batches or concurrently.
90202
90317
  * * If you set `InternetMaxBandwidthOut` to a value greater than 0, public IP addresses are automatically assigned to the ECS instances to be created.
90203
- * > For the limits on the sum of maximum public bandwidths of ECS instances that use the pay-by-bandwidth billing method for network usage per region per Alibaba Cloud account, see the [Public bandwidth limits](~~25412#BandwidthQuota~~) section of the "Limits" topic.
90318
+ * > For the limits on the sum of maximum public bandwidths of ECS instances that use the pay-by-bandwidth billing method for network usage per region per Alibaba Cloud account, see the [Public bandwidth](~~25412#BandwidthQuota~~) section of the "Limits and quotas on ECS" topic.
90204
90319
  * ### [](#)Suggestions
90205
90320
  * * **Test scenarios**: Set `DryRun` to true to perform a dry run without performing the actual request.
90206
90321
  * * **Release of ECS instances**: Use `AutoReleaseTime` to configure an automatic release time for ECS instances in the request to RunInstances or call the [DeleteInstances](https://help.aliyun.com/document_detail/2679710.html) operation to release the instances.
90207
90322
  * * **Management and search of ECS instances**: Add tags to the ECS instances by specifying `Tag.N.Key` and `Tag.N.Value` and append incremental suffixes by specifying `UniqueSuffix` to the hostname specified by `HostName` and the instance name specified by `InstanceName`. For more information, see [Batch configure sequential names or hostnames for multiple instances](https://help.aliyun.com/document_detail/196048.html).
90208
90323
  * * **Launch template**: A launch template contains the parameters required to create an ECS instance so that you do not have to specify the parameters every time you create ECS instances. You can call the [CreateLaunchTemplate](https://help.aliyun.com/document_detail/2679729.html) operation to create a launch template. Then, in the request to `RunInstances`, you can specify `LaunchTemplateId` and `LaunchTemplateVersion` to use the launch template.
90209
90324
  * * **Disabling of Hyper-Threading (HT)**: In memory-intensive scenarios, set `CpuOptions.ThreadsPerCore` to 1 to disable HT and increase the memory-to-vCPU ratio.
90210
- * * **Enabling of Jumbo Frames**: Set `NetworkOptions.EnableJumboFrame` to true to enable the `Jumbo Frames` feature when you create ECS instances. For more information, see [MTUs](https://help.aliyun.com/document_detail/200512.html).
90325
+ * * **Enabling of Jumbo Frames**: Set `NetworkOptions.EnableJumboFrame` to true to enable the `Jumbo Frames` feature when you create ECS instances. For more information, see [Jumbo Frames](https://help.aliyun.com/document_detail/200512.html).
90211
90326
  * ## [](#)Sample requests
90212
90327
  * Use a specific image to create ECS instances of a specific instance type in the China (Hangzhou) region. The instances use disks with a specific capacity as the system disk and data disks and are automatically assigned public IP addresses. The instances have user-defined names and logon passwords. The instances are assigned to a specific security group and connected to a specific vSwitch. Request parameters:
90213
90328
  * RegionId:"cn-hangzhou", //Set the region ID to cn-hangzhou, which specifies the China (Hangzhou) region.
@@ -90240,7 +90355,7 @@ export default class Client extends OpenApi {
90240
90355
  * Amount:10, //Set the number of ECS instances that you want to create to 10.
90241
90356
  * InstanceChargeType:"PostPaid", //Set the billing method to PostPaid, which specifies the pay-as-you-go billing method.
90242
90357
  * SpotStrategy:"NoSpot" //Set this parameter to NoSpot, which is the default value and specifies that the instances are created as pay-as-you-go instances.
90243
- * **Example: Create 20 preemptible instances that use a specified bidding policy and a protection period**
90358
+ * **Example: Create 20 preemptible instances that use a specific bidding policy and a protection period**
90244
90359
  * Amount:20, //Set the number of ECS instances that you want to create to 20.
90245
90360
  * InstanceChargeType:"PostPaid",
90246
90361
  * SpotStrategy:"SpotAsPriceGo", //Set the bidding policy to SpotAsPriceGo, which specifies that the instances are created as preemptible instances for which the market price at the time of purchase is automatically used as the bid price.