@alicloud/ecs20140526 4.4.4 → 4.4.5

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
@@ -3353,6 +3353,14 @@ export declare class CreateAutoProvisioningGroupRequest extends $tea.Model {
3353
3353
  resourceGroupId?: string;
3354
3354
  resourceOwnerAccount?: string;
3355
3355
  resourceOwnerId?: number;
3356
+ /**
3357
+ * @remarks
3358
+ * The resource pool options to use to create instances. When you specify this parameter, take note of the following items:
3359
+ *
3360
+ * * This parameter takes effect only when the auto provisioning group creates pay-as-you-go instances.
3361
+ * * This parameter takes effect only if you set `AutoProvisioningGroupType` to instant.
3362
+ */
3363
+ resourcePoolOptions?: CreateAutoProvisioningGroupRequestResourcePoolOptions;
3356
3364
  /**
3357
3365
  * @remarks
3358
3366
  * The policy for creating preemptible instances. Valid values:
@@ -3480,6 +3488,308 @@ export declare class CreateAutoProvisioningGroupRequest extends $tea.Model {
3480
3488
  [key: string]: any;
3481
3489
  });
3482
3490
  }
3491
+ export declare class CreateAutoProvisioningGroupShrinkRequest extends $tea.Model {
3492
+ launchConfiguration?: CreateAutoProvisioningGroupShrinkRequestLaunchConfiguration;
3493
+ /**
3494
+ * @remarks
3495
+ * The name of the auto provisioning group. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with `http://` or `https://`. The name can contain letters, digits, colons (:), underscores (_), and hyphens (-).
3496
+ *
3497
+ * @example
3498
+ * apg-test
3499
+ */
3500
+ autoProvisioningGroupName?: string;
3501
+ /**
3502
+ * @remarks
3503
+ * The delivery type of the auto provisioning group. Valid values:
3504
+ *
3505
+ * * request: one-time asynchronous delivery. When the auto provisioning group is started, it attempts to asynchronously deliver an instance cluster that meets the target capacity only once. The group does not retry the operation regardless of whether all the instances are delivered.
3506
+ * * instant: one-time synchronous delivery. When the auto provisioning group is started, it attempts to synchronously deliver an instance cluster that meets the target capacity only once. The list of delivered instances and the causes of delivery failures are returned in the response.
3507
+ * * maintain: continuous delivery. When the auto provisioning group is started, it attempts to deliver an instance cluster that meets the target capacity, and monitors the real-time capacity. If the target capacity of the auto provisioning group is not reached, the auto provisioning group continues to create instances until the target capacity is reached.
3508
+ *
3509
+ * Default value: maintain.
3510
+ *
3511
+ * @example
3512
+ * maintain
3513
+ */
3514
+ autoProvisioningGroupType?: string;
3515
+ /**
3516
+ * @remarks
3517
+ * The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see [How to ensure idempotence](https://help.aliyun.com/document_detail/25693.html).
3518
+ *
3519
+ * @example
3520
+ * 0c593ea1-3bea-11e9-b96b-88e9fe637760
3521
+ */
3522
+ clientToken?: string;
3523
+ /**
3524
+ * @remarks
3525
+ * The information of data disks on the instance.
3526
+ */
3527
+ dataDiskConfig?: CreateAutoProvisioningGroupShrinkRequestDataDiskConfig[];
3528
+ /**
3529
+ * @remarks
3530
+ * The type of supplemental instances. When the sum of the `PayAsYouGoTargetCapacity` and `SpotTargetCapacity` values is smaller than the `TotalTargetCapacity` value, the auto provisioning group creates instances of the specified type to meet the total target capacity. Valid values:
3531
+ *
3532
+ * * PayAsYouGo: pay-as-you-go instances
3533
+ * * Spot: preemptible instances.
3534
+ *
3535
+ * Default value: Spot.
3536
+ *
3537
+ * @example
3538
+ * Spot
3539
+ */
3540
+ defaultTargetCapacityType?: string;
3541
+ /**
3542
+ * @remarks
3543
+ * The description of the auto provisioning group.
3544
+ *
3545
+ * @example
3546
+ * testDescription
3547
+ */
3548
+ description?: string;
3549
+ /**
3550
+ * @remarks
3551
+ * Specifies whether to release scaled-in instances when the real-time capacity of the auto provisioning group exceeds the target capacity and the group is triggered to scale in. Valid values:
3552
+ *
3553
+ * * termination: releases the scaled-in instances in the auto provisioning group.
3554
+ * * no-termination: removes the scaled-in instances from the auto provisioning group but does not release the instances.
3555
+ *
3556
+ * Default value: no-termination.
3557
+ *
3558
+ * @example
3559
+ * termination
3560
+ */
3561
+ excessCapacityTerminationPolicy?: string;
3562
+ /**
3563
+ * @remarks
3564
+ * >This parameter is in invitational preview and is not publicly available.
3565
+ *
3566
+ * @example
3567
+ * false
3568
+ */
3569
+ hibernationOptionsConfigured?: boolean;
3570
+ /**
3571
+ * @remarks
3572
+ * The extended configurations of the launch template.
3573
+ */
3574
+ launchTemplateConfig?: CreateAutoProvisioningGroupShrinkRequestLaunchTemplateConfig[];
3575
+ /**
3576
+ * @remarks
3577
+ * The ID of the launch template associated with the auto provisioning group. You can call the [DescribeLaunchTemplates](https://help.aliyun.com/document_detail/73759.html) operation to query available launch templates. When both LaunchTemplateId and `LaunchConfiguration.*` parameters are specified, LaunchTemplateId takes precedence.
3578
+ *
3579
+ * @example
3580
+ * lt-bp1fgzds4bdogu03****
3581
+ */
3582
+ launchTemplateId?: string;
3583
+ /**
3584
+ * @remarks
3585
+ * The version of the launch template associated with the auto provisioning group. You can call the [DescribeLaunchTemplateVersions](https://help.aliyun.com/document_detail/73761.html) operation to query the versions of available launch templates.
3586
+ *
3587
+ * Default value: the default version of the launch template.
3588
+ *
3589
+ * @example
3590
+ * 1
3591
+ */
3592
+ launchTemplateVersion?: string;
3593
+ /**
3594
+ * @remarks
3595
+ * The maximum price of preemptible instances in the auto provisioning group.
3596
+ *
3597
+ * > When both `MaxSpotPrice` and `LaunchTemplateConfig.N.MaxPrice` are specified, the smaller one of the two parameter values is used.
3598
+ *
3599
+ * @example
3600
+ * 2
3601
+ */
3602
+ maxSpotPrice?: number;
3603
+ /**
3604
+ * @remarks
3605
+ * The minimum target capacity of the auto provisioning group. The value must be a positive integer. When you specify this parameter, take note of the following items:
3606
+ *
3607
+ * - This parameter takes effect only when `AutoProvisioningGroupType` is set to instant.
3608
+ * - If the number of instances that can be created in the current region is smaller than the value of this parameter, the operation cannot be called and no instances are created.
3609
+ * - If the number of instances that can be created in the current region is greater than the value of this parameter, instances can be created based on the specified parameters.
3610
+ *
3611
+ * @example
3612
+ * 20
3613
+ */
3614
+ minTargetCapacity?: string;
3615
+ ownerAccount?: string;
3616
+ ownerId?: number;
3617
+ /**
3618
+ * @remarks
3619
+ * The policy for creating pay-as-you-go instances. Valid values:
3620
+ *
3621
+ * * lowest-price: cost optimization policy. The auto provisioning group selects the lowest-priced instance type to create instances.
3622
+ * * prioritized: priority-based policy. The auto provisioning group creates instances based on the priority specified by `LaunchTemplateConfig.N.Priority`.
3623
+ *
3624
+ * Default value: lowest-price.
3625
+ *
3626
+ * @example
3627
+ * prioritized
3628
+ */
3629
+ payAsYouGoAllocationStrategy?: string;
3630
+ /**
3631
+ * @remarks
3632
+ * The target capacity of pay-as-you-go instances in the auto provisioning group. The value must be less than or equal to the `TotalTargetCapacity` value.
3633
+ *
3634
+ * @example
3635
+ * 30
3636
+ */
3637
+ payAsYouGoTargetCapacity?: string;
3638
+ /**
3639
+ * @remarks
3640
+ * The ID of the region in which to create the auto provisioning group. You can call the [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) operation to query the most recent region list.
3641
+ *
3642
+ * This parameter is required.
3643
+ *
3644
+ * @example
3645
+ * cn-hangzhou
3646
+ */
3647
+ regionId?: string;
3648
+ /**
3649
+ * @remarks
3650
+ * The ID of the resource group to which to assign the auto provisioning group.
3651
+ *
3652
+ * @example
3653
+ * rg-bp67acfmxazb4p****
3654
+ */
3655
+ resourceGroupId?: string;
3656
+ resourceOwnerAccount?: string;
3657
+ resourceOwnerId?: number;
3658
+ /**
3659
+ * @remarks
3660
+ * The resource pool options to use to create instances. When you specify this parameter, take note of the following items:
3661
+ *
3662
+ * * This parameter takes effect only when the auto provisioning group creates pay-as-you-go instances.
3663
+ * * This parameter takes effect only if you set `AutoProvisioningGroupType` to instant.
3664
+ */
3665
+ resourcePoolOptionsShrink?: string;
3666
+ /**
3667
+ * @remarks
3668
+ * The policy for creating preemptible instances. Valid values:
3669
+ *
3670
+ * * lowest-price: cost optimization policy. The auto provisioning group selects the lowest-priced instance type to create instances.
3671
+ * * diversified: balanced distribution policy. The auto provisioning group creates instances in zones that are specified in extended configurations and then evenly distributes the instances across the zones.
3672
+ * * capacity-optimized: capacity-optimized distribution policy. The auto provisioning group creates instances of the optimal instance types across the optimal zones based on resource availability.
3673
+ *
3674
+ * Default value: lowest-price.
3675
+ *
3676
+ * @example
3677
+ * diversified
3678
+ */
3679
+ spotAllocationStrategy?: string;
3680
+ /**
3681
+ * @remarks
3682
+ * The operation to be performed on the preemptible instance when it is interrupted. Valid values:
3683
+ *
3684
+ * * stop: stops the preemptible instance.
3685
+ * * terminate: releases the preemptible instance.
3686
+ *
3687
+ * Default value: terminate.
3688
+ *
3689
+ * @example
3690
+ * terminate
3691
+ */
3692
+ spotInstanceInterruptionBehavior?: string;
3693
+ /**
3694
+ * @remarks
3695
+ * The number of preemptible instances of the lowest-priced instance type to be created by the auto provisioning group. This parameter takes effect when `SpotAllocationStrategy` is set to `lowest-price`.
3696
+ *
3697
+ * The value must be smaller than the N value specified in `LaunchTemplateConfig.N`.
3698
+ *
3699
+ * @example
3700
+ * 2
3701
+ */
3702
+ spotInstancePoolsToUseCount?: number;
3703
+ /**
3704
+ * @remarks
3705
+ * The target capacity of preemptible instances in the auto provisioning group. The value must be less than or equal to the `TotalTargetCapacity` value.
3706
+ *
3707
+ * @example
3708
+ * 20
3709
+ */
3710
+ spotTargetCapacity?: string;
3711
+ /**
3712
+ * @remarks
3713
+ * The information of system disks on the instance.
3714
+ */
3715
+ systemDiskConfig?: CreateAutoProvisioningGroupShrinkRequestSystemDiskConfig[];
3716
+ /**
3717
+ * @remarks
3718
+ * The tags to add to the auto provisioning group.
3719
+ */
3720
+ tag?: CreateAutoProvisioningGroupShrinkRequestTag[];
3721
+ /**
3722
+ * @remarks
3723
+ * Specifies whether to release instances in the auto provisioning group when the auto provisioning group is deleted. Valid values:
3724
+ *
3725
+ * * true: releases the instances.
3726
+ * * false: retains the instances.
3727
+ *
3728
+ * Default value: false.
3729
+ *
3730
+ * @example
3731
+ * true
3732
+ */
3733
+ terminateInstances?: boolean;
3734
+ /**
3735
+ * @remarks
3736
+ * Specifies whether to release instances in the auto provisioning group when the group expires. Valid values:
3737
+ *
3738
+ * * true: releases the instances.
3739
+ * * false: only removes the instances from the auto provisioning group but does not release them.
3740
+ *
3741
+ * Default value: false.
3742
+ *
3743
+ * @example
3744
+ * true
3745
+ */
3746
+ terminateInstancesWithExpiration?: boolean;
3747
+ /**
3748
+ * @remarks
3749
+ * The total target capacity of the auto provisioning group. The value must be a positive integer.
3750
+ *
3751
+ * The total target capacity of the auto provisioning group must be greater than or equal to the sum of the target capacity of pay-as-you-go instances specified by `PayAsYouGoTargetCapacity` and the target capacity of preemptible instances specified by `SpotTargetCapacity`.
3752
+ *
3753
+ * This parameter is required.
3754
+ *
3755
+ * @example
3756
+ * 60
3757
+ */
3758
+ totalTargetCapacity?: string;
3759
+ /**
3760
+ * @remarks
3761
+ * The time at which to start the auto provisioning group. The period of time between this point in time and the point in time specified by `ValidUntil` is the validity period of the auto provisioning group.
3762
+ *
3763
+ * Specify the time in the [ISO 8601](https://help.aliyun.com/document_detail/25696.html) standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
3764
+ *
3765
+ * By default, an auto provisioning group is started immediately after it is created.
3766
+ *
3767
+ * @example
3768
+ * 2019-04-01T15:10:20Z
3769
+ */
3770
+ validFrom?: string;
3771
+ /**
3772
+ * @remarks
3773
+ * The time at which the auto provisioning group expires. The period of time between this point in time and the point in time specified by `ValidFrom` is the validity period of the auto provisioning group.
3774
+ *
3775
+ * Specify the time in the [ISO 8601](https://help.aliyun.com/document_detail/25696.html) standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
3776
+ *
3777
+ * Default value: 2099-12-31T23:59:59Z.
3778
+ *
3779
+ * @example
3780
+ * 2019-06-01T15:10:20Z
3781
+ */
3782
+ validUntil?: string;
3783
+ static names(): {
3784
+ [key: string]: string;
3785
+ };
3786
+ static types(): {
3787
+ [key: string]: any;
3788
+ };
3789
+ constructor(map?: {
3790
+ [key: string]: any;
3791
+ });
3792
+ }
3483
3793
  export declare class CreateAutoProvisioningGroupResponseBody extends $tea.Model {
3484
3794
  /**
3485
3795
  * @remarks
@@ -3957,6 +4267,7 @@ export declare class CreateCommandRequest extends $tea.Model {
3957
4267
  * false
3958
4268
  */
3959
4269
  enableParameter?: boolean;
4270
+ launcher?: string;
3960
4271
  /**
3961
4272
  * @remarks
3962
4273
  * The name of the command. The name supports all character sets and can be up to 128 characters in length.
@@ -5772,6 +6083,13 @@ export declare class CreateImageComponentRequest extends $tea.Model {
5772
6083
  * Build
5773
6084
  */
5774
6085
  componentType?: string;
6086
+ /**
6087
+ * @remarks
6088
+ * > This parameter is in invitational preview and is not publicly available.
6089
+ *
6090
+ * @example
6091
+ * null
6092
+ */
5775
6093
  componentVersion?: string;
5776
6094
  /**
5777
6095
  * @remarks
@@ -5791,9 +6109,9 @@ export declare class CreateImageComponentRequest extends $tea.Model {
5791
6109
  description?: string;
5792
6110
  /**
5793
6111
  * @remarks
5794
- * The component name. The name must be 2 to 128 characters in length. The name must start with a letter but cannot start with http:// or https://.[ ](http://https://。、、、(:)、(_)、(.)(-)。)The name can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).
6112
+ * The name of the image component. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with http:// or https://. The name can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).
5795
6113
  *
5796
- * > If you do not configure `Name`, the return value of `ImageComponentId` is used.
6114
+ * > If you do not specify `Name`, the return value of `ImageComponentId` is used.
5797
6115
  *
5798
6116
  * @example
5799
6117
  * testComponent
@@ -5823,7 +6141,7 @@ export declare class CreateImageComponentRequest extends $tea.Model {
5823
6141
  resourceOwnerId?: number;
5824
6142
  /**
5825
6143
  * @remarks
5826
- * The operating system type supported by the image component. Only Linux is supported. Set the value to Linux.
6144
+ * The type of the operating system supported by the image component. Only Linux operating systems are supported. Set the value to Linux.
5827
6145
  *
5828
6146
  * Default value: Linux.
5829
6147
  *
@@ -5963,10 +6281,17 @@ export declare class CreateImagePipelineRequest extends $tea.Model {
5963
6281
  * This is description.
5964
6282
  */
5965
6283
  description?: string;
6284
+ /**
6285
+ * @remarks
6286
+ * > This parameter is in invitational preview and is not publicly available.
6287
+ *
6288
+ * @example
6289
+ * null
6290
+ */
5966
6291
  imageFamily?: string;
5967
6292
  /**
5968
6293
  * @remarks
5969
- * The prefix of the image name. The prefix must be 2 to 64 characters in length. It must start with a letter and cannot start with `http://` or `https://`. It can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).
6294
+ * The prefix of the image name. The prefix must be 2 to 64 characters in length. The prefix must start with a letter and cannot start with `http://` or `https://`. The prefix can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).
5970
6295
  *
5971
6296
  * The system generates the final complete image name that consists of the specified prefix and the ID of the build task (`ExecutionId`) in the format of `{ImageName}_{ExecutionId}`.
5972
6297
  *
@@ -5996,9 +6321,9 @@ export declare class CreateImagePipelineRequest extends $tea.Model {
5996
6321
  internetMaxBandwidthOut?: number;
5997
6322
  /**
5998
6323
  * @remarks
5999
- * The name of the image template. The name must be 2 to 128 characters in length. It must start with a letter and cannot start with `http://` or `https://`. It can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).
6324
+ * The name of the launch template. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with `http://` or `https://`. The name can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).
6000
6325
  *
6001
- * > If you do not specify the `Name` parameter, the return value of `ImagePipelineId` is used.
6326
+ * > If you do not specify `Name`, the return value of `ImagePipelineId` is used.
6002
6327
  *
6003
6328
  * @example
6004
6329
  * testImagePipeline
@@ -6016,6 +6341,13 @@ export declare class CreateImagePipelineRequest extends $tea.Model {
6016
6341
  * cn-hangzhou
6017
6342
  */
6018
6343
  regionId?: string;
6344
+ /**
6345
+ * @remarks
6346
+ * > This parameter is in invitational preview and is not publicly available.
6347
+ *
6348
+ * @example
6349
+ * null
6350
+ */
6019
6351
  repairMode?: string;
6020
6352
  /**
6021
6353
  * @remarks
@@ -6042,6 +6374,13 @@ export declare class CreateImagePipelineRequest extends $tea.Model {
6042
6374
  * The tags to add to the template.
6043
6375
  */
6044
6376
  tag?: CreateImagePipelineRequestTag[];
6377
+ /**
6378
+ * @remarks
6379
+ * > This parameter is in invitational preview and is not publicly available.
6380
+ *
6381
+ * @example
6382
+ * null
6383
+ */
6045
6384
  testContent?: string;
6046
6385
  /**
6047
6386
  * @remarks
@@ -6966,8 +7305,20 @@ export declare class CreateLaunchTemplateRequest extends $tea.Model {
6966
7305
  * testHostName
6967
7306
  */
6968
7307
  hostName?: string;
7308
+ /**
7309
+ * @example
7310
+ * enabled
7311
+ */
6969
7312
  httpEndpoint?: string;
7313
+ /**
7314
+ * @example
7315
+ * 3
7316
+ */
6970
7317
  httpPutResponseHopLimit?: number;
7318
+ /**
7319
+ * @example
7320
+ * optional
7321
+ */
6971
7322
  httpTokens?: string;
6972
7323
  /**
6973
7324
  * @remarks
@@ -7472,8 +7823,20 @@ export declare class CreateLaunchTemplateVersionRequest extends $tea.Model {
7472
7823
  * testHostName
7473
7824
  */
7474
7825
  hostName?: string;
7826
+ /**
7827
+ * @example
7828
+ * enabled
7829
+ */
7475
7830
  httpEndpoint?: string;
7831
+ /**
7832
+ * @example
7833
+ * 3
7834
+ */
7476
7835
  httpPutResponseHopLimit?: number;
7836
+ /**
7837
+ * @example
7838
+ * optional
7839
+ */
7477
7840
  httpTokens?: string;
7478
7841
  /**
7479
7842
  * @remarks
@@ -9137,10 +9500,10 @@ export declare class CreateSnapshotRequest extends $tea.Model {
9137
9500
  * @remarks
9138
9501
  * The category of the snapshot. Valid values:
9139
9502
  *
9140
- * * Standard: normal snapshot
9503
+ * * Standard: standard snapshot
9141
9504
  * * Flash: local snapshot
9142
9505
  *
9143
- * > This parameter is no longer used. By default, new normal snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
9506
+ * > This parameter is no longer used. By default, new standard snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
9144
9507
  *
9145
9508
  * @example
9146
9509
  * Standard
@@ -9179,11 +9542,11 @@ export declare class CreateSnapshotRequest extends $tea.Model {
9179
9542
  * Specifies whether to enable the instant access feature. Valid values:
9180
9543
  *
9181
9544
  * * true: enables the instant access feature. This feature can be enabled only for ESSDs.
9182
- * * false: does not enable the instant access feature. If InstantAccess is set to false, a normal snapshot is created.
9545
+ * * false: does not enable the instant access feature. If InstantAccess is set to false, a standard snapshot is created.
9183
9546
  *
9184
9547
  * Default value: false.
9185
9548
  *
9186
- * > This parameter is no longer used. By default, new normal snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
9549
+ * > This parameter is no longer used. By default, new standard snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
9187
9550
  *
9188
9551
  * @example
9189
9552
  * false
@@ -9195,7 +9558,7 @@ export declare class CreateSnapshotRequest extends $tea.Model {
9195
9558
  *
9196
9559
  * By default, the value of this parameter is the same as that of `RetentionDays`.
9197
9560
  *
9198
- * > This parameter is no longer used. By default, new normal snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
9561
+ * > This parameter is no longer used. By default, new standard snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
9199
9562
  *
9200
9563
  * @example
9201
9564
  * 1
@@ -9207,7 +9570,7 @@ export declare class CreateSnapshotRequest extends $tea.Model {
9207
9570
  * @remarks
9208
9571
  * The snapshot type. Valid values:
9209
9572
  *
9210
- * * Standard: normal snapshot
9573
+ * * Standard: standard snapshot
9211
9574
  * * Flash: local snapshot
9212
9575
  *
9213
9576
  * > This parameter will be removed in the future. We recommend that you use the `InstantAccess` parameter to ensure future compatibility. This parameter and the `InstantAccess` parameter cannot be specified at the same time. For more information, see the "Description" section of this topic.
@@ -9230,9 +9593,9 @@ export declare class CreateSnapshotRequest extends $tea.Model {
9230
9593
  retentionDays?: number;
9231
9594
  /**
9232
9595
  * @remarks
9233
- * The name of the snapshot. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with `http://` or `https://`. It can contain letters, digits, colons (:), underscores (_), and hyphens (-).
9596
+ * The name of the snapshot. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with http:// or https://. The name can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).
9234
9597
  *
9235
- * It cannot start with `auto` because snapshots whose names start with auto are recognized as automatic snapshots.
9598
+ * The name cannot start with `auto` because snapshots whose names start with auto are recognized as automatic snapshots.
9236
9599
  *
9237
9600
  * @example
9238
9601
  * testSnapshotName
@@ -9360,7 +9723,7 @@ export declare class CreateSnapshotGroupRequest extends $tea.Model {
9360
9723
  *
9361
9724
  * Default value: false.
9362
9725
  *
9363
- * > This parameter is no longer used. By default, new normal snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
9726
+ * > This parameter is no longer used. By default, new standard snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
9364
9727
  *
9365
9728
  * @example
9366
9729
  * false
@@ -9372,9 +9735,9 @@ export declare class CreateSnapshotGroupRequest extends $tea.Model {
9372
9735
  *
9373
9736
  * This parameter takes effect only when `InstantAccess` is set to true. The instant access feature is automatically disabled when the specified duration ends.
9374
9737
  *
9375
- * This parameter is left empty by default, which indicates that the instant access feature is automatically disabled for snapshots when the snapshots are released.
9738
+ * This parameter is left empty by default, which indicates that the instant access feature is automatically disabled when the instant access snapshots are released.
9376
9739
  *
9377
- * > This parameter is no longer used. By default, new normal snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
9740
+ * > This parameter is no longer used. By default, new standard snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
9378
9741
  *
9379
9742
  * @example
9380
9743
  * 1
@@ -11976,9 +12339,9 @@ export declare class DeleteSecurityGroupResponse extends $tea.Model {
11976
12339
  export declare class DeleteSnapshotRequest extends $tea.Model {
11977
12340
  /**
11978
12341
  * @remarks
11979
- * Specifies whether to force delete the snapshot that has been used to create disks. Valid values:
12342
+ * Specifies whether to force delete the snapshot that has been used to create cloud disks. Valid values:
11980
12343
  *
11981
- * * true: force deletes the snapshot. After the snapshot is force deleted, the disks created from the snapshot cannot be re-initialized.
12344
+ * * true: force deletes the snapshot. After the snapshot is force deleted, the cloud disks created from the snapshot cannot be re-initialized.
11982
12345
  * * false: does not force delete the snapshot.
11983
12346
  *
11984
12347
  * Default value: false.
@@ -16361,7 +16724,7 @@ export declare class DescribeDiskDefaultKMSKeyIdResponse extends $tea.Model {
16361
16724
  export declare class DescribeDiskEncryptionByDefaultStatusRequest extends $tea.Model {
16362
16725
  /**
16363
16726
  * @remarks
16364
- * The ID of the region. You can call the DescribeRegions operation to query the most recent region list.
16727
+ * The region ID. You can call the [DescribeRegions](https://help.aliyun.com/document_detail/2679950.html) operation to query the most recent region list.
16365
16728
  *
16366
16729
  * This parameter is required.
16367
16730
  *
@@ -17922,7 +18285,21 @@ export declare class DescribeHpcClustersResponse extends $tea.Model {
17922
18285
  });
17923
18286
  }
17924
18287
  export declare class DescribeImageComponentsRequest extends $tea.Model {
18288
+ /**
18289
+ * @remarks
18290
+ * > This parameter is in invitational preview and is not publicly available.
18291
+ *
18292
+ * @example
18293
+ * null
18294
+ */
17925
18295
  componentType?: string;
18296
+ /**
18297
+ * @remarks
18298
+ * > This parameter is in invitational preview and is not publicly available.
18299
+ *
18300
+ * @example
18301
+ * null
18302
+ */
17926
18303
  componentVersion?: string;
17927
18304
  /**
17928
18305
  * @remarks
@@ -17993,6 +18370,13 @@ export declare class DescribeImageComponentsRequest extends $tea.Model {
17993
18370
  resourceGroupId?: string;
17994
18371
  resourceOwnerAccount?: string;
17995
18372
  resourceOwnerId?: number;
18373
+ /**
18374
+ * @remarks
18375
+ * > This parameter is in invitational preview and is not publicly available.
18376
+ *
18377
+ * @example
18378
+ * null
18379
+ */
17996
18380
  systemType?: string;
17997
18381
  /**
17998
18382
  * @remarks
@@ -18012,7 +18396,7 @@ export declare class DescribeImageComponentsRequest extends $tea.Model {
18012
18396
  export declare class DescribeImageComponentsResponseBody extends $tea.Model {
18013
18397
  /**
18014
18398
  * @remarks
18015
- * Details about the image components.
18399
+ * The information about the image components.
18016
18400
  */
18017
18401
  imageComponent?: DescribeImageComponentsResponseBodyImageComponent;
18018
18402
  /**
@@ -18305,7 +18689,7 @@ export declare class DescribeImagePipelinesRequest extends $tea.Model {
18305
18689
  imagePipelineId?: string[];
18306
18690
  /**
18307
18691
  * @remarks
18308
- * The number of entries per page. Valid values: 1 to 500.
18692
+ * The number of entries per page. Valid values: 1 to 500
18309
18693
  *
18310
18694
  * Default value: 50.
18311
18695
  *
@@ -18371,7 +18755,7 @@ export declare class DescribeImagePipelinesRequest extends $tea.Model {
18371
18755
  export declare class DescribeImagePipelinesResponseBody extends $tea.Model {
18372
18756
  /**
18373
18757
  * @remarks
18374
- * Details about the image templates.
18758
+ * The information about the image templates.
18375
18759
  */
18376
18760
  imagePipeline?: DescribeImagePipelinesResponseBodyImagePipeline;
18377
18761
  /**
@@ -22526,7 +22910,7 @@ export declare class DescribeLaunchTemplateVersionsRequest extends $tea.Model {
22526
22910
  * @remarks
22527
22911
  * The ID of the launch template.
22528
22912
  *
22529
- * You must set LaunchTemplateId or LaunchTemplateName to specify a launch template.
22913
+ * You must set `LaunchTemplateId` or `LaunchTemplateName` to specify a launch template.
22530
22914
  *
22531
22915
  * @example
22532
22916
  * lt-bp168lnahrdwl39p****
@@ -22536,13 +22920,15 @@ export declare class DescribeLaunchTemplateVersionsRequest extends $tea.Model {
22536
22920
  * @remarks
22537
22921
  * The name of the launch template.
22538
22922
  *
22923
+ * You must set `LaunchTemplateId` or `LaunchTemplateName` to specify a launch template.
22924
+ *
22539
22925
  * @example
22540
22926
  * testLaunchTemplateName
22541
22927
  */
22542
22928
  launchTemplateName?: string;
22543
22929
  /**
22544
22930
  * @remarks
22545
- * Version N of the launch template.
22931
+ * The versions of the launch template.
22546
22932
  *
22547
22933
  * @example
22548
22934
  * 1
@@ -22550,7 +22936,7 @@ export declare class DescribeLaunchTemplateVersionsRequest extends $tea.Model {
22550
22936
  launchTemplateVersion?: number[];
22551
22937
  /**
22552
22938
  * @remarks
22553
- * The maximum version number in the version range to query.
22939
+ * The maximum version number in the version range to query. This parameter is used together with `MinVersion` to specify a version range to query.
22554
22940
  *
22555
22941
  * @example
22556
22942
  * 10
@@ -22558,7 +22944,7 @@ export declare class DescribeLaunchTemplateVersionsRequest extends $tea.Model {
22558
22944
  maxVersion?: number;
22559
22945
  /**
22560
22946
  * @remarks
22561
- * The minimum version number in the version range to query.
22947
+ * The minimum version number in the version range to query. This parameter is used together with `MaxVersion` to specify a version range to query.
22562
22948
  *
22563
22949
  * @example
22564
22950
  * 1
@@ -23395,6 +23781,13 @@ export declare class DescribeNetworkInterfaceAttributeResponseBody extends $tea.
23395
23781
  * > This parameter is in invitational preview and unavailable for general users.
23396
23782
  */
23397
23783
  slaveInterfaceSpecification?: DescribeNetworkInterfaceAttributeResponseBodySlaveInterfaceSpecification;
23784
+ /**
23785
+ * @remarks
23786
+ * This parameter is not publicly available.
23787
+ *
23788
+ * @example
23789
+ * false
23790
+ */
23398
23791
  sourceDestCheck?: boolean;
23399
23792
  /**
23400
23793
  * @remarks
@@ -23825,7 +24218,7 @@ export declare class DescribeNetworkInterfacesRequest extends $tea.Model {
23825
24218
  export declare class DescribeNetworkInterfacesResponseBody extends $tea.Model {
23826
24219
  /**
23827
24220
  * @remarks
23828
- * Details about the ENIs.
24221
+ * Details of the ENIs.
23829
24222
  */
23830
24223
  networkInterfaceSets?: DescribeNetworkInterfacesResponseBodyNetworkInterfaceSets;
23831
24224
  /**
@@ -26829,7 +27222,7 @@ export declare class DescribeSnapshotGroupsResponseBody extends $tea.Model {
26829
27222
  requestId?: string;
26830
27223
  /**
26831
27224
  * @remarks
26832
- * Details of the snapshot-consistent groups.
27225
+ * The information about the snapshot-consistent groups.
26833
27226
  */
26834
27227
  snapshotGroups?: DescribeSnapshotGroupsResponseBodySnapshotGroups;
26835
27228
  static names(): {
@@ -26996,7 +27389,7 @@ export declare class DescribeSnapshotMonitorDataRequest extends $tea.Model {
26996
27389
  * @remarks
26997
27390
  * The category of the snapshot. Valid values:
26998
27391
  *
26999
- * * Standard: normal snapshot
27392
+ * * Standard: standard snapshot
27000
27393
  * * Flash: local snapshot
27001
27394
  *
27002
27395
  * Default value: Standard.
@@ -27214,7 +27607,7 @@ export declare class DescribeSnapshotsRequest extends $tea.Model {
27214
27607
  * @remarks
27215
27608
  * The category of the snapshot. Valid values:
27216
27609
  *
27217
- * * Standard: normal snapshot
27610
+ * * Standard: standard snapshot
27218
27611
  * * Flash: local snapshot
27219
27612
  *
27220
27613
  * The local snapshot feature is replaced by the instant access feature. When you specify this parameter, take note of the following items:
@@ -27458,7 +27851,7 @@ export declare class DescribeSnapshotsResponseBody extends $tea.Model {
27458
27851
  requestId?: string;
27459
27852
  /**
27460
27853
  * @remarks
27461
- * The information about the snapshots.
27854
+ * Details about the snapshots.
27462
27855
  */
27463
27856
  snapshots?: DescribeSnapshotsResponseBodySnapshots;
27464
27857
  /**
@@ -30141,7 +30534,7 @@ export declare class DisableActivationResponse extends $tea.Model {
30141
30534
  export declare class DisableDiskEncryptionByDefaultRequest extends $tea.Model {
30142
30535
  /**
30143
30536
  * @remarks
30144
- * The region ID. You can call the [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) operation to query the most recent region list.
30537
+ * The ID of the region for which you want to disable Account-level EBS Default Encryption. You can call the [DescribeRegions](https://help.aliyun.com/document_detail/2679950.html) operation to query the most recent region list.
30145
30538
  *
30146
30539
  * This parameter is required.
30147
30540
  *
@@ -30163,7 +30556,7 @@ export declare class DisableDiskEncryptionByDefaultRequest extends $tea.Model {
30163
30556
  export declare class DisableDiskEncryptionByDefaultResponseBody extends $tea.Model {
30164
30557
  /**
30165
30558
  * @remarks
30166
- * The request ID, which uniquely identifies the request.
30559
+ * The request ID.
30167
30560
  *
30168
30561
  * @example
30169
30562
  * 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
@@ -30195,174 +30588,12 @@ export declare class DisableDiskEncryptionByDefaultResponse extends $tea.Model {
30195
30588
  [key: string]: any;
30196
30589
  });
30197
30590
  }
30198
- export declare class EipFillParamsRequest extends $tea.Model {
30199
- clientToken?: string;
30200
- ownerAccount?: string;
30201
- ownerId?: number;
30202
- resourceOwnerAccount?: string;
30203
- resourceOwnerId?: number;
30204
- userCidr?: string;
30205
- /**
30206
- * @remarks
30207
- * This parameter is required.
30208
- */
30209
- data?: string;
30210
- static names(): {
30211
- [key: string]: string;
30212
- };
30213
- static types(): {
30214
- [key: string]: any;
30215
- };
30216
- constructor(map?: {
30217
- [key: string]: any;
30218
- });
30219
- }
30220
- export declare class EipFillParamsResponseBody extends $tea.Model {
30221
- code?: string;
30222
- data?: string;
30223
- message?: string;
30224
- requestId?: string;
30225
- success?: boolean;
30226
- static names(): {
30227
- [key: string]: string;
30228
- };
30229
- static types(): {
30230
- [key: string]: any;
30231
- };
30232
- constructor(map?: {
30233
- [key: string]: any;
30234
- });
30235
- }
30236
- export declare class EipFillParamsResponse extends $tea.Model {
30237
- headers?: {
30238
- [key: string]: string;
30239
- };
30240
- statusCode?: number;
30241
- body?: EipFillParamsResponseBody;
30242
- static names(): {
30243
- [key: string]: string;
30244
- };
30245
- static types(): {
30246
- [key: string]: any;
30247
- };
30248
- constructor(map?: {
30249
- [key: string]: any;
30250
- });
30251
- }
30252
- export declare class EipFillProductRequest extends $tea.Model {
30253
- clientToken?: string;
30254
- ownerAccount?: string;
30255
- ownerId?: number;
30256
- resourceOwnerAccount?: string;
30257
- resourceOwnerId?: number;
30258
- userCidr?: string;
30259
- /**
30260
- * @remarks
30261
- * This parameter is required.
30262
- */
30263
- data?: string;
30264
- static names(): {
30265
- [key: string]: string;
30266
- };
30267
- static types(): {
30268
- [key: string]: any;
30269
- };
30270
- constructor(map?: {
30271
- [key: string]: any;
30272
- });
30273
- }
30274
- export declare class EipFillProductResponseBody extends $tea.Model {
30275
- code?: string;
30276
- data?: string;
30277
- message?: string;
30278
- requestId?: string;
30279
- success?: boolean;
30280
- static names(): {
30281
- [key: string]: string;
30282
- };
30283
- static types(): {
30284
- [key: string]: any;
30285
- };
30286
- constructor(map?: {
30287
- [key: string]: any;
30288
- });
30289
- }
30290
- export declare class EipFillProductResponse extends $tea.Model {
30291
- headers?: {
30292
- [key: string]: string;
30293
- };
30294
- statusCode?: number;
30295
- body?: EipFillProductResponseBody;
30296
- static names(): {
30297
- [key: string]: string;
30298
- };
30299
- static types(): {
30300
- [key: string]: any;
30301
- };
30302
- constructor(map?: {
30303
- [key: string]: any;
30304
- });
30305
- }
30306
- export declare class EipNotifyPaidRequest extends $tea.Model {
30307
- clientToken?: string;
30308
- ownerAccount?: string;
30309
- ownerId?: number;
30310
- resourceOwnerAccount?: string;
30311
- resourceOwnerId?: number;
30312
- userCidr?: string;
30313
- /**
30314
- * @remarks
30315
- * This parameter is required.
30316
- */
30317
- data?: string;
30318
- static names(): {
30319
- [key: string]: string;
30320
- };
30321
- static types(): {
30322
- [key: string]: any;
30323
- };
30324
- constructor(map?: {
30325
- [key: string]: any;
30326
- });
30327
- }
30328
- export declare class EipNotifyPaidResponseBody extends $tea.Model {
30329
- code?: string;
30330
- data?: string;
30331
- message?: string;
30332
- requestId?: string;
30333
- success?: boolean;
30334
- static names(): {
30335
- [key: string]: string;
30336
- };
30337
- static types(): {
30338
- [key: string]: any;
30339
- };
30340
- constructor(map?: {
30341
- [key: string]: any;
30342
- });
30343
- }
30344
- export declare class EipNotifyPaidResponse extends $tea.Model {
30345
- headers?: {
30346
- [key: string]: string;
30347
- };
30348
- statusCode?: number;
30349
- body?: EipNotifyPaidResponseBody;
30350
- static names(): {
30351
- [key: string]: string;
30352
- };
30353
- static types(): {
30354
- [key: string]: any;
30355
- };
30356
- constructor(map?: {
30357
- [key: string]: any;
30358
- });
30359
- }
30360
30591
  export declare class EnableDiskEncryptionByDefaultRequest extends $tea.Model {
30361
30592
  ownerAccount?: string;
30362
30593
  ownerId?: number;
30363
30594
  /**
30364
30595
  * @remarks
30365
- * The region ID. You can call the DescribeRegions operation to query the most recent region list.
30596
+ * The region ID. You can call the [DescribeRegions](https://help.aliyun.com/document_detail/2679950.html) operation to query the most recent region list.
30366
30597
  *
30367
30598
  * This parameter is required.
30368
30599
  *
@@ -33100,6 +33331,7 @@ export declare class ModifyCommandRequest extends $tea.Model {
33100
33331
  * This is description.
33101
33332
  */
33102
33333
  description?: string;
33334
+ launcher?: string;
33103
33335
  /**
33104
33336
  * @remarks
33105
33337
  * The command name. The name supports all character sets and can be up to 128 characters in length.
@@ -34431,7 +34663,7 @@ export declare class ModifyDiskDefaultKMSKeyIdRequest extends $tea.Model {
34431
34663
  KMSKeyId?: string;
34432
34664
  /**
34433
34665
  * @remarks
34434
- * The region ID. You can call the [DescribeRegions](https://help.aliyun.com/document_detail/25609.html) operation to query the most recent region list.
34666
+ * The region ID. You can call the [DescribeRegions](https://help.aliyun.com/document_detail/2679950.html) operation to query the most recent region list.
34435
34667
  *
34436
34668
  * This parameter is required.
34437
34669
  *
@@ -35880,12 +36112,12 @@ export declare class ModifyInstanceChargeTypeRequest extends $tea.Model {
35880
36112
  * @remarks
35881
36113
  * Specifies whether to automatically complete the payment. Valid values:
35882
36114
  *
35883
- * * true: The payment is automatically completed. Make sure that your account balance is sufficient. Otherwise, your order becomes invalid and is canceled.
36115
+ * * true: The payment is automatically completed. Maintain a sufficient account balance. Otherwise, your order becomes invalid and is canceled.
35884
36116
  * * false: An order is generated but no payment is made.
35885
36117
  *
35886
36118
  * Default value: true.
35887
36119
  *
35888
- * > If your account balance is insufficient, you can set AutoPay to false to generate an unpaid order. Then, you can log on to the ECS console to pay for the order.
36120
+ * > If your account balance is insufficient, you can set AutoPay to false to generate an unpaid order. Then, you can log on to the ECS console to pay for the order.
35889
36121
  *
35890
36122
  * @example
35891
36123
  * false
@@ -35901,9 +36133,9 @@ export declare class ModifyInstanceChargeTypeRequest extends $tea.Model {
35901
36133
  clientToken?: string;
35902
36134
  /**
35903
36135
  * @remarks
35904
- * Specifies whether to perform only a dry run. Valid Values:
36136
+ * Specifies whether to perform only a dry run, without performing the actual request. Valid values:
35905
36137
  *
35906
- * * true: performs only a dry run. The system checks whether your AccessKey pair is valid, whether Resource Access Management (RAM) users are granted permissions, and whether the required parameters are specified. If the request fails the dry run, an error message is returned. If the request passes the dry run, the `DryRunOperation` error code is returned.
36138
+ * * true: performs only a dry run. The system checks the request for potential issues, including invalid AccessKey pairs, unauthorized Resource Access Management (RAM) users, and missing parameter values. If the request fails the dry run, an error message is returned. If the request passes the dry run, the `DryRunOperation` error code is returned.
35907
36139
  * * false: performs a dry run and performs the actual request. If the request passes the dry run, a 2xx HTTP status code is returned and the operation is performed.
35908
36140
  *
35909
36141
  * Default value: false.
@@ -35914,7 +36146,10 @@ export declare class ModifyInstanceChargeTypeRequest extends $tea.Model {
35914
36146
  dryRun?: boolean;
35915
36147
  /**
35916
36148
  * @remarks
35917
- * Specifies whether to change the billing method of all data disks attached to the instance from pay-as-you-go to subscription.
36149
+ * Specifies whether to change the billing method of all data disks on the instance from pay-as-you-go to subscription. Valid values:
36150
+ *
36151
+ * * true
36152
+ * * false
35918
36153
  *
35919
36154
  * Default value: false.
35920
36155
  *
@@ -35926,8 +36161,8 @@ export declare class ModifyInstanceChargeTypeRequest extends $tea.Model {
35926
36161
  * @remarks
35927
36162
  * The new billing method. Valid values:
35928
36163
  *
35929
- * * PrePaid
35930
- * * PostPaid
36164
+ * * PrePaid: subscription
36165
+ * * PostPaid: pay-as-you-go
35931
36166
  *
35932
36167
  * Default value: PrePaid.
35933
36168
  *
@@ -35947,7 +36182,10 @@ export declare class ModifyInstanceChargeTypeRequest extends $tea.Model {
35947
36182
  instanceIds?: string;
35948
36183
  /**
35949
36184
  * @remarks
35950
- * Specifies whether to return cost details of the order after the billing method is changed from subscription to pay-as-you-go.
36185
+ * Specifies whether to return cost details of the order after the billing method is changed from subscription to pay-as-you-go. Valid values:
36186
+ *
36187
+ * * true
36188
+ * * false
35951
36189
  *
35952
36190
  * Default value: false.
35953
36191
  *
@@ -36362,7 +36600,7 @@ export declare class ModifyInstanceMetadataOptionsRequest extends $tea.Model {
36362
36600
  httpEndpoint?: string;
36363
36601
  /**
36364
36602
  * @remarks
36365
- * > This parameter is in invitational preview and is not publicly available.
36603
+ * > This parameter is not publicly available.
36366
36604
  *
36367
36605
  * @example
36368
36606
  * 1
@@ -39127,7 +39365,7 @@ export declare class ModifySnapshotAttributeRequest extends $tea.Model {
39127
39365
  *
39128
39366
  * Default value: false.
39129
39367
  *
39130
- * > This parameter is no longer used. By default, new normal snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
39368
+ * > This parameter is no longer used. By default, new standard snapshots of Enterprise SSDs (ESSDs) are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
39131
39369
  *
39132
39370
  * @example
39133
39371
  * false
@@ -39784,6 +40022,9 @@ export declare class ModifyVpcAttributeResponse extends $tea.Model {
39784
40022
  export declare class PurchaseElasticityAssuranceRequest extends $tea.Model {
39785
40023
  privatePoolOptions?: PurchaseElasticityAssuranceRequestPrivatePoolOptions;
39786
40024
  /**
40025
+ * @remarks
40026
+ * The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make sure that the token is unique among different requests. The `token` can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see [How to ensure idempotence](https://help.aliyun.com/document_detail/25693.html).
40027
+ *
39787
40028
  * @example
39788
40029
  * 123e4567-e89b-12d3-a456-426655440000
39789
40030
  */
@@ -39791,17 +40032,35 @@ export declare class PurchaseElasticityAssuranceRequest extends $tea.Model {
39791
40032
  ownerAccount?: string;
39792
40033
  ownerId?: number;
39793
40034
  /**
40035
+ * @remarks
40036
+ * The term of the elasticity assurance. The unit of the term is determined by the PeriodUnit value. Valid values:
40037
+ *
40038
+ * * When the PeriodUnit parameter is set to Month, valid values are 1, 2, 3, 4, 5, 6, 7, 8, and 9.
40039
+ * * When the PeriodUnit parameter is set to Year, valid values are 1, 2, 3, 4, and 5.
40040
+ *
40041
+ * Default value: 1.
40042
+ *
39794
40043
  * @example
39795
40044
  * 1
39796
40045
  */
39797
40046
  period?: number;
39798
40047
  /**
40048
+ * @remarks
40049
+ * The unit of the term of the elasticity assurance. Valid values:
40050
+ *
40051
+ * * Month
40052
+ * * Year
40053
+ *
40054
+ * Default value: Year.
40055
+ *
39799
40056
  * @example
39800
40057
  * Month
39801
40058
  */
39802
40059
  periodUnit?: string;
39803
40060
  /**
39804
40061
  * @remarks
40062
+ * The region ID of the elasticity assurance. You can call the [DescribeRegions](https://help.aliyun.com/document_detail/2679950.html) operation to query the most recent region list.
40063
+ *
39805
40064
  * This parameter is required.
39806
40065
  *
39807
40066
  * @example
@@ -39811,6 +40070,9 @@ export declare class PurchaseElasticityAssuranceRequest extends $tea.Model {
39811
40070
  resourceOwnerAccount?: string;
39812
40071
  resourceOwnerId?: number;
39813
40072
  /**
40073
+ * @remarks
40074
+ * The time when the elasticity assurance takes effect. The default value is the time when the elasticity assurance is created. Specify the time in the ISO 8601 standard in the `yyyy-MM-ddTHH:mm:ssZ` format. The time must be in UTC. For more information, see [ISO 8601](https://help.aliyun.com/document_detail/25696.html).
40075
+ *
39814
40076
  * @example
39815
40077
  * 2024-06-18T00:00Z
39816
40078
  */
@@ -39827,6 +40089,9 @@ export declare class PurchaseElasticityAssuranceRequest extends $tea.Model {
39827
40089
  }
39828
40090
  export declare class PurchaseElasticityAssuranceResponseBody extends $tea.Model {
39829
40091
  /**
40092
+ * @remarks
40093
+ * The request ID.
40094
+ *
39830
40095
  * @example
39831
40096
  * 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
39832
40097
  */
@@ -47777,6 +48042,36 @@ export declare class CreateAutoProvisioningGroupRequestLaunchTemplateConfig exte
47777
48042
  [key: string]: any;
47778
48043
  });
47779
48044
  }
48045
+ export declare class CreateAutoProvisioningGroupRequestResourcePoolOptions extends $tea.Model {
48046
+ /**
48047
+ * @remarks
48048
+ * The IDs of private pools. The ID of a private pool is the same as the ID of the elasticity assurance or capacity reservation that is associated with the private pool. You can specify the IDs of only targeted private pools for this parameter.
48049
+ */
48050
+ privatePoolIds?: string[];
48051
+ /**
48052
+ * @remarks
48053
+ * Specifies which resource pools to use to create instances. Resource pools include the public pool and the private pools that are associated with elasticity assurance and capacity reservations in the Active state. Valid values:
48054
+ *
48055
+ * * PrivatePoolFirst: uses private pools first. If you set this parameter to PrivatePoolFirst, you can specify ResourcePoolOptions.PrivatePoolIds or leave ResourcePoolOptions.PrivatePoolIds empty. If you specify ResourcePoolOptions.PrivatePoolIds, the specified private pools are used first. If you leave ResourcePoolOptions.PrivatePoolIds empty or the private pools that you specify in ResourcePoolOptions.PrivatePoolIds have insufficient capacity, matching open private pools are used. If no matching open private pools exist, the public pool is used.
48056
+ * * PrivatePoolOnly: uses only private pools. If you set this parameter to PrivatePoolOnly, you must specify ResourcePoolOptions.PrivatePoolIds. If the private pools that you specify in ResourcePoolOptions.PrivatePoolIds have insufficient capacity, instances cannot be created.
48057
+ * * PublicPoolOnly: uses the public pool.
48058
+ *
48059
+ * Default value: PublicPoolOnly.
48060
+ *
48061
+ * @example
48062
+ * PrivatePoolFirst
48063
+ */
48064
+ strategy?: string;
48065
+ static names(): {
48066
+ [key: string]: string;
48067
+ };
48068
+ static types(): {
48069
+ [key: string]: any;
48070
+ };
48071
+ constructor(map?: {
48072
+ [key: string]: any;
48073
+ });
48074
+ }
47780
48075
  export declare class CreateAutoProvisioningGroupRequestSystemDiskConfig extends $tea.Model {
47781
48076
  /**
47782
48077
  * @remarks
@@ -47801,7 +48096,866 @@ export declare class CreateAutoProvisioningGroupRequestSystemDiskConfig extends
47801
48096
  [key: string]: any;
47802
48097
  });
47803
48098
  }
47804
- export declare class CreateAutoProvisioningGroupRequestTag extends $tea.Model {
48099
+ export declare class CreateAutoProvisioningGroupRequestTag extends $tea.Model {
48100
+ /**
48101
+ * @remarks
48102
+ * The key of tag N to add to the auto provisioning group.
48103
+ *
48104
+ * Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 128 characters in length. It cannot start with aliyun or acs: and cannot contain http:// or https://.
48105
+ *
48106
+ * @example
48107
+ * TestKey
48108
+ */
48109
+ key?: string;
48110
+ /**
48111
+ * @remarks
48112
+ * The value of tag N to add to the auto provisioning group.
48113
+ *
48114
+ * Valid values of N: 1 to 20. The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot contain http:// or https://.
48115
+ *
48116
+ * @example
48117
+ * TestValue
48118
+ */
48119
+ value?: string;
48120
+ static names(): {
48121
+ [key: string]: string;
48122
+ };
48123
+ static types(): {
48124
+ [key: string]: any;
48125
+ };
48126
+ constructor(map?: {
48127
+ [key: string]: any;
48128
+ });
48129
+ }
48130
+ export declare class CreateAutoProvisioningGroupShrinkRequestLaunchConfigurationArn extends $tea.Model {
48131
+ /**
48132
+ * @remarks
48133
+ * > This parameter is in invitational preview and is not publicly available.
48134
+ *
48135
+ * @example
48136
+ * 123456789012****
48137
+ */
48138
+ assumeRoleFor?: number;
48139
+ /**
48140
+ * @remarks
48141
+ * > This parameter is in invitational preview and is not publicly available.
48142
+ *
48143
+ * @example
48144
+ * 34458433936495****:alice
48145
+ */
48146
+ roleType?: string;
48147
+ /**
48148
+ * @remarks
48149
+ * > This parameter is in invitational preview and is not publicly available.
48150
+ *
48151
+ * @example
48152
+ * acs:ram::123456789012****:role/adminrole
48153
+ */
48154
+ rolearn?: string;
48155
+ static names(): {
48156
+ [key: string]: string;
48157
+ };
48158
+ static types(): {
48159
+ [key: string]: any;
48160
+ };
48161
+ constructor(map?: {
48162
+ [key: string]: any;
48163
+ });
48164
+ }
48165
+ export declare class CreateAutoProvisioningGroupShrinkRequestLaunchConfigurationDataDisk extends $tea.Model {
48166
+ /**
48167
+ * @remarks
48168
+ * Specifies whether to enable the performance burst feature for data disk N. Valid values:
48169
+ *
48170
+ * * true
48171
+ * * false
48172
+ *
48173
+ * > This parameter is available only if you set LaunchConfiguration.DataDisk.N.Category to cloud_auto. For more information, see [ESSD AutoPL disks](https://help.aliyun.com/document_detail/368372.html).
48174
+ *
48175
+ * @example
48176
+ * false
48177
+ */
48178
+ burstingEnabled?: boolean;
48179
+ /**
48180
+ * @remarks
48181
+ * The category of data disk N. Valid values of N: 1 to 16. Valid values:
48182
+ *
48183
+ * * cloud_efficiency: ultra disk.
48184
+ * * cloud_ssd: standard SSD.
48185
+ * * cloud_essd: ESSD.
48186
+ * * cloud: basic disk.
48187
+ *
48188
+ * For I/O optimized instances, the default value is cloud_efficiency. For non-I/O optimized instances, the default value is cloud.
48189
+ *
48190
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48191
+ *
48192
+ * @example
48193
+ * cloud_ssd
48194
+ */
48195
+ category?: string;
48196
+ /**
48197
+ * @remarks
48198
+ * Specifies whether to release data disk N when the instance to which the data disk is attached is released. Valid values:
48199
+ *
48200
+ * * true
48201
+ * * false
48202
+ *
48203
+ * Default value: true.
48204
+ *
48205
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48206
+ *
48207
+ * @example
48208
+ * true
48209
+ */
48210
+ deleteWithInstance?: boolean;
48211
+ /**
48212
+ * @remarks
48213
+ * The description of data disk N. The description must be 2 to 256 characters in length and cannot start with `http://` or `https://`. When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48214
+ *
48215
+ * @example
48216
+ * DataDisk_Description
48217
+ */
48218
+ description?: string;
48219
+ /**
48220
+ * @remarks
48221
+ * The mount point of data disk N. When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48222
+ *
48223
+ * @example
48224
+ * /dev/vd1
48225
+ */
48226
+ device?: string;
48227
+ /**
48228
+ * @remarks
48229
+ * The name of data disk N. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with `http://` or `https://`. The name can contain letters, digits, periods (.), colons (:), underscores (_), and hyphens (-).
48230
+ *
48231
+ * This parameter is left empty by default.
48232
+ *
48233
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48234
+ *
48235
+ * @example
48236
+ * cloud_ssdData
48237
+ */
48238
+ diskName?: string;
48239
+ /**
48240
+ * @remarks
48241
+ * > This parameter is not publicly available.
48242
+ *
48243
+ * @example
48244
+ * null
48245
+ */
48246
+ encryptAlgorithm?: string;
48247
+ /**
48248
+ * @remarks
48249
+ * Specifies whether to encrypt data disk N. Valid values:
48250
+ *
48251
+ * * true
48252
+ * * false
48253
+ *
48254
+ * Default value: false.
48255
+ *
48256
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48257
+ *
48258
+ * @example
48259
+ * false
48260
+ */
48261
+ encrypted?: boolean;
48262
+ /**
48263
+ * @remarks
48264
+ * The ID of the Key Management Service (KMS) key to use for data disk N. When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48265
+ *
48266
+ * @example
48267
+ * 0e478b7a-4262-4802-b8cb-00d3fb40****
48268
+ */
48269
+ kmsKeyId?: string;
48270
+ /**
48271
+ * @remarks
48272
+ * The performance level of the Enterprise SSD (ESSD) to use as data disk N. The value of N in this parameter must be the same as the value of N in `LaunchConfiguration.DataDisk.N.Category`. Valid values:
48273
+ *
48274
+ * * PL0: A single ESSD can deliver up to 10,000 random read/write IOPS.
48275
+ * * PL1 (default): A single ESSD can deliver up to 50,000 random read/write IOPS.
48276
+ * * PL2: A single ESSD can deliver up to 100,000 random read/write IOPS.
48277
+ * * PL3: A single ESSD can deliver up to 1,000,000 random read/write IOPS.
48278
+ *
48279
+ * For more information about ESSD performance levels, see [ESSDs](https://help.aliyun.com/document_detail/122389.html).
48280
+ *
48281
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48282
+ *
48283
+ * @example
48284
+ * PL1
48285
+ */
48286
+ performanceLevel?: string;
48287
+ /**
48288
+ * @remarks
48289
+ * 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}.
48290
+ *
48291
+ * Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}.
48292
+ *
48293
+ * > This parameter is available only if you set LaunchConfiguration.DataDisk.N.Category to cloud_auto. For more information, see [ESSD AutoPL disks](https://help.aliyun.com/document_detail/368372.html).
48294
+ *
48295
+ * @example
48296
+ * 40000
48297
+ */
48298
+ provisionedIops?: number;
48299
+ /**
48300
+ * @remarks
48301
+ * The size of data disk N. Valid values of N: 1 to 16. Unit: GiB. Valid values:
48302
+ *
48303
+ * * Valid values if you set LaunchConfiguration.DataDisk.N.Category to cloud_efficiency: 20 to 32768.
48304
+ *
48305
+ * * Valid values if you set LaunchConfiguration.DataDisk.N.Category to cloud_ssd: 20 to 32768.
48306
+ *
48307
+ * * Valid values if you set LaunchConfiguration.DataDisk.N.Category to cloud_essd: vary based on the `LaunchConfiguration.DataDisk.N.PerformanceLevel` value.
48308
+ *
48309
+ * * Valid values if you set LaunchConfiguration.DataDisk.N.PerformanceLevel to PL0: 40 to 32768.
48310
+ * * Valid values if you set LaunchConfiguration.DataDisk.N.PerformanceLevel to PL1: 20 to 32768.
48311
+ * * Valid values if you set LaunchConfiguration.DataDisk.N.PerformanceLevel to PL2: 461 to 32768.
48312
+ * * Valid values if you set LaunchConfiguration.DataDisk.N.PerformanceLevel to PL3: 1261 to 32768.
48313
+ *
48314
+ * * Valid values if you set LaunchConfiguration.DataDisk.N.Category to cloud: 5 to 2000.
48315
+ *
48316
+ * > The value of this parameter must be greater than or equal to the size of the snapshot specified by `LaunchConfiguration.DataDisk.N.SnapshotId`.
48317
+ *
48318
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48319
+ *
48320
+ * @example
48321
+ * 20
48322
+ */
48323
+ size?: number;
48324
+ /**
48325
+ * @remarks
48326
+ * The ID of the snapshot to use to create data disk N. Valid values of N: 1 to 16.
48327
+ *
48328
+ * If you specify this parameter, `LaunchConfiguration.DataDisk.N.Size` is ignored. The size of data disk N is the same as that of the snapshot specified by this parameter. Use snapshots created after July 15, 2013. Otherwise, an error is returned and your request is rejected.
48329
+ *
48330
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48331
+ *
48332
+ * @example
48333
+ * s-bp17441ohwka0yuh****
48334
+ */
48335
+ snapshotId?: string;
48336
+ static names(): {
48337
+ [key: string]: string;
48338
+ };
48339
+ static types(): {
48340
+ [key: string]: any;
48341
+ };
48342
+ constructor(map?: {
48343
+ [key: string]: any;
48344
+ });
48345
+ }
48346
+ export declare class CreateAutoProvisioningGroupShrinkRequestLaunchConfigurationSystemDisk extends $tea.Model {
48347
+ /**
48348
+ * @remarks
48349
+ * Specifies whether to enable the performance burst feature for the system disk. Valid values:
48350
+ *
48351
+ * * true
48352
+ * * false
48353
+ *
48354
+ * > This parameter is available only if you set `LaunchConfiguration.SystemDisk.Category` to `cloud_auto`. For more information, see [ESSD AutoPL disks](https://help.aliyun.com/document_detail/368372.html).
48355
+ *
48356
+ * @example
48357
+ * false
48358
+ */
48359
+ burstingEnabled?: boolean;
48360
+ /**
48361
+ * @remarks
48362
+ * The algorithm to use to encrypt the system disk. Valid values:
48363
+ *
48364
+ * * aes-256
48365
+ * * sm4-128
48366
+ *
48367
+ * Default value: aes-256.
48368
+ *
48369
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48370
+ *
48371
+ * > This parameter is not publicly available.
48372
+ *
48373
+ * @example
48374
+ * aes-256
48375
+ */
48376
+ encryptAlgorithm?: string;
48377
+ /**
48378
+ * @remarks
48379
+ * Specifies whether to encrypt the system disk. Valid values:
48380
+ *
48381
+ * * true
48382
+ * * false
48383
+ *
48384
+ * Default value: false.
48385
+ *
48386
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48387
+ *
48388
+ * @example
48389
+ * false
48390
+ */
48391
+ encrypted?: string;
48392
+ /**
48393
+ * @remarks
48394
+ * The ID of the KMS key to use for the system disk.
48395
+ *
48396
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48397
+ *
48398
+ * @example
48399
+ * 0e478b7a-4262-4802-b8cb-00d3fb40****
48400
+ */
48401
+ KMSKeyId?: string;
48402
+ /**
48403
+ * @remarks
48404
+ * 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}.
48405
+ *
48406
+ * Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}.
48407
+ *
48408
+ * > This parameter is available only if you set LaunchConfiguration.SystemDisk.Category to cloud_auto. For more information, see [ESSD AutoPL disks](https://help.aliyun.com/document_detail/368372.html).
48409
+ *
48410
+ * @example
48411
+ * 40000
48412
+ */
48413
+ provisionedIops?: number;
48414
+ static names(): {
48415
+ [key: string]: string;
48416
+ };
48417
+ static types(): {
48418
+ [key: string]: any;
48419
+ };
48420
+ constructor(map?: {
48421
+ [key: string]: any;
48422
+ });
48423
+ }
48424
+ export declare class CreateAutoProvisioningGroupShrinkRequestLaunchConfigurationTag extends $tea.Model {
48425
+ /**
48426
+ * @remarks
48427
+ * The key of the tag. Valid values of N: 1 to 20. The tag key cannot be an empty string. It can be up to 128 characters in length and cannot start with acs: or aliyun. It cannot contain `http://` or `https://`. If both the LaunchTemplateId and LaunchConfiguration.* parameters are specified, the LaunchTemplateId parameter takes precedence.
48428
+ *
48429
+ * @example
48430
+ * TestKey
48431
+ */
48432
+ key?: string;
48433
+ /**
48434
+ * @remarks
48435
+ * The value of the tag. Valid values of N: 1 to 20. The tag value can be an empty string. It can be up to 128 characters in length. It cannot start with acs: or contain `http://` or `https://`. If both the LaunchTemplateId and LaunchConfiguration.* parameters are specified, the LaunchTemplateId parameter takes precedence.
48436
+ *
48437
+ * @example
48438
+ * TestValue
48439
+ */
48440
+ value?: string;
48441
+ static names(): {
48442
+ [key: string]: string;
48443
+ };
48444
+ static types(): {
48445
+ [key: string]: any;
48446
+ };
48447
+ constructor(map?: {
48448
+ [key: string]: any;
48449
+ });
48450
+ }
48451
+ export declare class CreateAutoProvisioningGroupShrinkRequestLaunchConfiguration extends $tea.Model {
48452
+ /**
48453
+ * @remarks
48454
+ * > This parameter is in invitational preview and is not publicly available.
48455
+ */
48456
+ arn?: CreateAutoProvisioningGroupShrinkRequestLaunchConfigurationArn[];
48457
+ /**
48458
+ * @remarks
48459
+ * The automatic release time of the pay-as-you-go instance. Specify the time in the [ISO 8601](https://help.aliyun.com/document_detail/25696.html) standard in the `yyyy-MM-ddTHH:mm:ssZ` format. The time must be in Coordinated Universal Time (UTC).
48460
+ *
48461
+ * * If the value of `ss` is not `00`, the start time is automatically rounded down to the nearest minute based on the value of `mm`.
48462
+ * * The specified time must be at least 30 minutes later than the current time.
48463
+ * * The specified time can be at most three years later than the current time.
48464
+ *
48465
+ * @example
48466
+ * 2018-01-01T12:05:00Z
48467
+ */
48468
+ autoReleaseTime?: string;
48469
+ /**
48470
+ * @remarks
48471
+ * The performance mode of the burstable instance. Valid values:
48472
+ *
48473
+ * * Standard: the standard mode. For more information, see the "Standard mode" section in the [Overview of burstable instances](https://help.aliyun.com/document_detail/59977.html) topic.
48474
+ * * Unlimited: the unlimited mode. For more information, see the "Unlimited mode" section in the [Overview of burstable instances](https://help.aliyun.com/document_detail/59977.html) topic.
48475
+ *
48476
+ * This parameter is empty by default.
48477
+ *
48478
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48479
+ *
48480
+ * @example
48481
+ * Standard
48482
+ */
48483
+ creditSpecification?: string;
48484
+ /**
48485
+ * @remarks
48486
+ * The cloud disks in the extended configurations of the launch template.
48487
+ */
48488
+ dataDisk?: CreateAutoProvisioningGroupShrinkRequestLaunchConfigurationDataDisk[];
48489
+ /**
48490
+ * @remarks
48491
+ * The ID of the deployment set.
48492
+ *
48493
+ * @example
48494
+ * ds-bp1frxuzdg87zh4p****
48495
+ */
48496
+ deploymentSetId?: string;
48497
+ /**
48498
+ * @remarks
48499
+ * The instance hostname. Take note of the following items:
48500
+ *
48501
+ * * The hostname cannot start or end with a period (.) or hyphen (-). The hostname cannot contain consecutive periods (.) or hyphens (-).
48502
+ * * For Windows instances, the hostname must be 2 to 15 characters in length and cannot contain periods (.) or contain only digits. It can contain letters, digits, and hyphens (-).
48503
+ * * For instances that run other operating systems such as Linux, the hostname must be 2 to 64 characters in length. You can use periods (.) to separate a hostname into multiple segments. Each segment can contain letters, digits, and hyphens (-).
48504
+ * * You cannot specify both `LaunchConfiguration.HostName` and `LaunchConfiguration.HostNames.N`. Otherwise, an error is returned.
48505
+ * * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48506
+ *
48507
+ * @example
48508
+ * k8s-node-[1,4]-ecshost
48509
+ */
48510
+ hostName?: string;
48511
+ /**
48512
+ * @remarks
48513
+ * The hostname of instance N. You can use this parameter to specify different hostnames for multiple instances. Take note of the following items:
48514
+ *
48515
+ * - This parameter takes effect only when `AutoProvisioningGroupType` is set to instant.
48516
+ * - The value of N indicates the number of instances. Valid values of N: 1 to 1000. The value of N must be the same as the TotalTargetCapacity value.
48517
+ * - The hostname cannot start or end with a period (.) or hyphen (-). The hostname cannot contain consecutive periods (.) or hyphens (-).
48518
+ * - For Windows instances, the hostname must be 2 to 15 characters in length and cannot contain periods (.) or contain only digits. The hostname can contain letters, digits, and hyphens (-).
48519
+ * - For instances that run other operating systems such as Linux, the hostname must be 2 to 64 characters in length. You can use periods (.) to separate the hostname into multiple segments. Each segment can contain letters, digits, and hyphens (-).
48520
+ * - You cannot specify both `LaunchConfiguration.HostName` and `LaunchConfiguration.HostNames.N`. Otherwise, an error is returned.
48521
+ * - When both LaunchTemplateId and LaunchConfiguration.* parameters are specified, LaunchTemplateId takes precedence.
48522
+ *
48523
+ * @example
48524
+ * ecs-host-01
48525
+ */
48526
+ hostNames?: string[];
48527
+ /**
48528
+ * @remarks
48529
+ * The name of the image family. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with `aliyun` or `acs:`. The name cannot contain `http://` or `https://`. The name can contain letters, digits, colons (:), underscores (_), and hyphens (-).
48530
+ *
48531
+ * @example
48532
+ * hangzhou-daily-update
48533
+ */
48534
+ imageFamily?: string;
48535
+ /**
48536
+ * @remarks
48537
+ * The ID of the image to be used to create the instance. You can call the [DescribeImages](https://help.aliyun.com/document_detail/25534.html) operation to query available image resources. When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48538
+ *
48539
+ * @example
48540
+ * m-bp1g7004ksh0oeuc****
48541
+ */
48542
+ imageId?: string;
48543
+ /**
48544
+ * @remarks
48545
+ * The instance description. The description must be 2 to 256 characters in length. The description can contain letters and cannot start with `http://` or `https://`. When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48546
+ *
48547
+ * @example
48548
+ * Instance_Description
48549
+ */
48550
+ instanceDescription?: string;
48551
+ /**
48552
+ * @remarks
48553
+ * The instance name. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with `http://` or `https://`. The name can contain letters, digits, colons (:), underscores (_), periods (.), and hyphens (-).
48554
+ *
48555
+ * The default value of this parameter is the `InstanceId` value.
48556
+ *
48557
+ * When you batch create instances, you can batch configure sequential names for the instances. For more information, see [Batch configure sequential names or hostnames for multiple instances](https://help.aliyun.com/document_detail/196048.html).
48558
+ *
48559
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48560
+ *
48561
+ * @example
48562
+ * k8s-node-[1,4]-alibabacloud
48563
+ */
48564
+ instanceName?: string;
48565
+ /**
48566
+ * @remarks
48567
+ * The billing method for network usage. Valid values:
48568
+ *
48569
+ * * PayByBandwidth: pay-by-bandwidth
48570
+ * * PayByTraffic: pay-by-traffic
48571
+ *
48572
+ * > When the pay-by-traffic billing method for network usage is used, the maximum inbound and outbound bandwidth values are used as the upper limits of bandwidth instead of guaranteed performance specifications. When demands outstrip resource supplies, the maximum bandwidths may be limited. If you want guaranteed bandwidth for your instance, use the pay-by-bandwidth billing method.
48573
+ *
48574
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48575
+ *
48576
+ * @example
48577
+ * PayByTraffic
48578
+ */
48579
+ internetChargeType?: string;
48580
+ /**
48581
+ * @remarks
48582
+ * The maximum inbound public bandwidth. Unit: Mbit/s. Valid values:
48583
+ *
48584
+ * * When the maximum outbound public bandwidth is less than or equal to 10 Mbit/s, the valid values of this parameter are 1 to 10 and the default value is 10.
48585
+ * * When the maximum outbound public bandwidth is greater than 10 Mbit/s, the valid values of this parameter are 1 to the value of `LaunchConfiguration.InternetMaxBandwidthOut`, and the default value is the value of `LaunchConfiguration.InternetMaxBandwidthOut`.
48586
+ *
48587
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48588
+ *
48589
+ * @example
48590
+ * 10
48591
+ */
48592
+ internetMaxBandwidthIn?: number;
48593
+ /**
48594
+ * @remarks
48595
+ * The maximum outbound public bandwidth. Unit: Mbit/s. Valid values: 0 to 100.
48596
+ *
48597
+ * Default value: 0.
48598
+ *
48599
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48600
+ *
48601
+ * @example
48602
+ * 10
48603
+ */
48604
+ internetMaxBandwidthOut?: number;
48605
+ /**
48606
+ * @remarks
48607
+ * Specifies whether the instance is I/O optimized. Valid values:
48608
+ *
48609
+ * * none: The instance is not I/O optimized.
48610
+ * * optimized: The instance is I/O optimized.
48611
+ *
48612
+ * For instances of retired instance types, the default value is none. For instances of other instance types, the default value is optimized.
48613
+ *
48614
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48615
+ *
48616
+ * @example
48617
+ * optimized
48618
+ */
48619
+ ioOptimized?: string;
48620
+ /**
48621
+ * @remarks
48622
+ * The key pair name.
48623
+ *
48624
+ * * For Windows instances, this parameter is ignored. This parameter is empty by default.
48625
+ * * By default, password-based logon is disabled for Linux instances.
48626
+ *
48627
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48628
+ *
48629
+ * @example
48630
+ * KeyPair_Name
48631
+ */
48632
+ keyPairName?: string;
48633
+ /**
48634
+ * @remarks
48635
+ * The instance password. The password must be 8 to 30 characters in length and contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. The password can contain the following special characters:
48636
+ *
48637
+ * ``( ) ` ~ ! @ # $ % ^ & * - _ + = | { } ``: ; \\" < > , . ? /`` For Windows instances, the password cannot start with a forward slash (/). When both LaunchTemplateId and LaunchConfiguration.* parameters are specified, LaunchTemplateId takes precedence. `
48638
+ *
48639
+ * @example
48640
+ * EcsV587!
48641
+ */
48642
+ password?: string;
48643
+ /**
48644
+ * @remarks
48645
+ * Specifies whether to use the password preset in the image. Valid values:
48646
+ *
48647
+ * * true: uses the password preset in the image.
48648
+ * * false: does not use the password preset in the image.
48649
+ *
48650
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48651
+ *
48652
+ * @example
48653
+ * true
48654
+ */
48655
+ passwordInherit?: boolean;
48656
+ /**
48657
+ * @remarks
48658
+ * The name of the instance Resource Access Management (RAM) role. You can call the [ListRoles](https://help.aliyun.com/document_detail/28713.html) operation provided by RAM to query the instance RAM roles that you created. When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48659
+ *
48660
+ * @example
48661
+ * RAM_Name
48662
+ */
48663
+ ramRoleName?: string;
48664
+ /**
48665
+ * @remarks
48666
+ * The ID of the resource group to which to assign the instance. When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48667
+ *
48668
+ * @example
48669
+ * rg-bp67acfmxazb4p****
48670
+ */
48671
+ resourceGroupId?: string;
48672
+ /**
48673
+ * @remarks
48674
+ * Specifies whether to enable security hardening. Valid values:
48675
+ *
48676
+ * * Active: enables security hardening. This value is applicable only to public images.
48677
+ * * Deactive: disables security hardening. This value is applicable to all image types.
48678
+ *
48679
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48680
+ *
48681
+ * @example
48682
+ * Active
48683
+ */
48684
+ securityEnhancementStrategy?: string;
48685
+ /**
48686
+ * @remarks
48687
+ * The ID of the security group to which to assign the instance. When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48688
+ *
48689
+ * @example
48690
+ * sg-bp15ed6xe1yxeycg****
48691
+ */
48692
+ securityGroupId?: string;
48693
+ /**
48694
+ * @remarks
48695
+ * The IDs of the security groups to which the new ECS instances belong.
48696
+ */
48697
+ securityGroupIds?: string[];
48698
+ /**
48699
+ * @remarks
48700
+ * The system disk information of instances. When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48701
+ */
48702
+ systemDisk?: CreateAutoProvisioningGroupShrinkRequestLaunchConfigurationSystemDisk;
48703
+ /**
48704
+ * @remarks
48705
+ * The category of the system disk. Valid values:
48706
+ *
48707
+ * * cloud_efficiency: ultra disk
48708
+ * * cloud_ssd: standard SSD
48709
+ * * cloud_essd: enhanced SSD (ESSD)
48710
+ * * cloud: basic disk
48711
+ *
48712
+ * For non-I/O optimized instances of retired instance types, the default value is cloud. For other instances, the default value is cloud_efficiency.
48713
+ *
48714
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48715
+ *
48716
+ * @example
48717
+ * cloud_ssd
48718
+ */
48719
+ systemDiskCategory?: string;
48720
+ /**
48721
+ * @remarks
48722
+ * The description of the system disk. The description must be 2 to 256 characters in length. The description can contain letters and cannot start with `http://` or `https://`.
48723
+ *
48724
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48725
+ *
48726
+ * @example
48727
+ * SystemDisk_Description
48728
+ */
48729
+ systemDiskDescription?: string;
48730
+ /**
48731
+ * @remarks
48732
+ * The name of the system disk. The name must be 2 to 128 characters in length. The name must start with a letter and cannot start with `http://` or `https://`. The name can contain letters, digits, periods (.), colons (:), underscores (_), and hyphens (-).
48733
+ *
48734
+ * This parameter is empty by default.
48735
+ *
48736
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48737
+ *
48738
+ * @example
48739
+ * cloud_ssdSystem
48740
+ */
48741
+ systemDiskName?: string;
48742
+ /**
48743
+ * @remarks
48744
+ * The performance level of the ESSD to be used as the system disk. Valid values:
48745
+ *
48746
+ * * PL0 (default): A single ESSD can deliver up to 10,000 random read/write IOPS.
48747
+ * * PL1: A single ESSD can deliver up to 50,000 random read/write IOPS.
48748
+ * * PL2: A single ESSD can deliver up to 100,000 random read/write IOPS.
48749
+ * * PL3: A single ESSD can deliver up to 1,000,000 random read/write IOPS.
48750
+ *
48751
+ * For more information about ESSD performance levels, see [ESSDs](https://help.aliyun.com/document_detail/122389.html).
48752
+ *
48753
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48754
+ *
48755
+ * @example
48756
+ * PL0
48757
+ */
48758
+ systemDiskPerformanceLevel?: string;
48759
+ /**
48760
+ * @remarks
48761
+ * The size of the system disk. Valid values: 20 to 500. Unit: GiB. The value must be at least 20 and greater than or equal to the size of the image specified by LaunchConfiguration.ImageId.
48762
+ *
48763
+ * Default value: 40 or the size of the image specified by LaunchConfiguration.ImageId, whichever is greater.
48764
+ *
48765
+ * When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48766
+ *
48767
+ * @example
48768
+ * 40
48769
+ */
48770
+ systemDiskSize?: number;
48771
+ /**
48772
+ * @remarks
48773
+ * The tag in the extended configurations of the launch template.
48774
+ */
48775
+ tag?: CreateAutoProvisioningGroupShrinkRequestLaunchConfigurationTag[];
48776
+ /**
48777
+ * @remarks
48778
+ * The instance user data. The user data must be encoded in Base64. The raw data can be up to 32 KB in size. When both LaunchTemplateId and LaunchConfiguration.\\* parameters are specified, LaunchTemplateId takes precedence.
48779
+ *
48780
+ * @example
48781
+ * ZWNobyBoZWxsbyBlY3Mh
48782
+ */
48783
+ userData?: string;
48784
+ static names(): {
48785
+ [key: string]: string;
48786
+ };
48787
+ static types(): {
48788
+ [key: string]: any;
48789
+ };
48790
+ constructor(map?: {
48791
+ [key: string]: any;
48792
+ });
48793
+ }
48794
+ export declare class CreateAutoProvisioningGroupShrinkRequestDataDiskConfig extends $tea.Model {
48795
+ /**
48796
+ * @remarks
48797
+ * The category of data disk N. You can use this parameter to specify multiple disk categories, and the disk categories are prioritized in the order in which they are specified. If a specified disk category is unavailable, the system uses the next available disk category. Valid values:
48798
+ *
48799
+ * - cloud_efficiency: ultra disk
48800
+ * - cloud_ssd: standard SSD
48801
+ * - cloud_essd: ESSD
48802
+ * - cloud: basic disk
48803
+ *
48804
+ * @example
48805
+ * cloud_efficiency
48806
+ */
48807
+ diskCategory?: string;
48808
+ static names(): {
48809
+ [key: string]: string;
48810
+ };
48811
+ static types(): {
48812
+ [key: string]: any;
48813
+ };
48814
+ constructor(map?: {
48815
+ [key: string]: any;
48816
+ });
48817
+ }
48818
+ export declare class CreateAutoProvisioningGroupShrinkRequestLaunchTemplateConfig extends $tea.Model {
48819
+ /**
48820
+ * @remarks
48821
+ * The architectures of the instance types.
48822
+ */
48823
+ architectures?: string[];
48824
+ /**
48825
+ * @remarks
48826
+ * Specifies whether to include burstable instance types. Valid values:
48827
+ *
48828
+ * * Exclude: does not include burstable instance types.
48829
+ * * Include: includes burstable instance types.
48830
+ * * Required: includes only burstable instance types.
48831
+ *
48832
+ * Default value: Include.
48833
+ *
48834
+ * @example
48835
+ * Include
48836
+ */
48837
+ burstablePerformance?: string;
48838
+ /**
48839
+ * @remarks
48840
+ * The number of vCPU cores of the instance type.
48841
+ */
48842
+ cores?: number[];
48843
+ /**
48844
+ * @remarks
48845
+ * The instance types that you want to exclude.
48846
+ */
48847
+ excludedInstanceTypes?: string[];
48848
+ /**
48849
+ * @remarks
48850
+ * The instance family level of the instance type in extended configuration N. This parameter is used to filter instance types. Valid values:
48851
+ *
48852
+ * * EntryLevel: entry level (shared instance types). Instance types of this level are the most cost-effective but may not provide 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).
48853
+ * * EnterpriseLevel: enterprise level. Instance types of this level provide stable performance and dedicated resources and are suitable for scenarios that require high stability. For more information, see the [Overview of instance families](https://help.aliyun.com/document_detail/25378.html) topic.
48854
+ * * CreditEntryLevel: credit entry level (burstable instance types). CPU credits are used to ensure computing performance. Instance types of this level are suitable for scenarios in which the CPU utilization is low but may fluctuate in specific cases. For more information, see [Overview of burstable instances](https://help.aliyun.com/document_detail/59977.html).
48855
+ *
48856
+ * Valid values of N: 1 to 10.
48857
+ *
48858
+ * @example
48859
+ * EnterpriseLevel
48860
+ */
48861
+ instanceFamilyLevel?: string;
48862
+ /**
48863
+ * @remarks
48864
+ * The instance type in extended configuration N. Valid values of N: 1 to 20. For more information about the valid values of this parameter, see [Instance families](https://help.aliyun.com/document_detail/25378.html).
48865
+ *
48866
+ * @example
48867
+ * ecs.g5.large
48868
+ */
48869
+ instanceType?: string;
48870
+ /**
48871
+ * @remarks
48872
+ * The maximum price of preemptible instances in extended configuration N.
48873
+ *
48874
+ * > If you specify one or more other `LaunchTemplateConfig.N.*` parameters, you must also specify `LaunchTemplateConfig.N.MaxPrice`.
48875
+ *
48876
+ * @example
48877
+ * 3
48878
+ */
48879
+ maxPrice?: number;
48880
+ /**
48881
+ * @remarks
48882
+ * > This parameter is in invitational preview and is not publicly available.
48883
+ *
48884
+ * @example
48885
+ * false
48886
+ */
48887
+ maxQuantity?: number;
48888
+ /**
48889
+ * @remarks
48890
+ * The memory sizes of the instance type.
48891
+ */
48892
+ memories?: number[];
48893
+ /**
48894
+ * @remarks
48895
+ * The priority of extended configuration N. A value of 0 indicates the highest priority. Valid values: 0 to ∞.
48896
+ *
48897
+ * @example
48898
+ * 1
48899
+ */
48900
+ priority?: number;
48901
+ /**
48902
+ * @remarks
48903
+ * The ID of the vSwitch in extended configuration N. The zone of the ECS instances created from the extended configuration is determined by the vSwitch.
48904
+ *
48905
+ * > If you specify one or more other `LaunchTemplateConfig.N.*` parameters, you must also specify `LaunchTemplateConfig.N.VSwitchId`.
48906
+ *
48907
+ * @example
48908
+ * vsw-sn5bsitu4lfzgc5o7****
48909
+ */
48910
+ vSwitchId?: string;
48911
+ /**
48912
+ * @remarks
48913
+ * The weight of the instance type in extended configuration N. A greater weight indicates that a single instance has more computing power and fewer instances are required. The value must be greater than 0.
48914
+ *
48915
+ * The weight is calculated based on the computing power of the specified instance type and the minimum computing power of a single instance in the cluster to be created by the auto provisioning group. For example, assume that the minimum computing power of a single instance is 8 vCPUs and 60 GiB of memory.
48916
+ *
48917
+ * * For an instance type with 8 vCPUs and 60 GiB of memory, you can set the weight to 1.
48918
+ * * For an instance type with 16 vCPUs and 120 GiB of memory, you can set the weight to 2.
48919
+ *
48920
+ * @example
48921
+ * 2
48922
+ */
48923
+ weightedCapacity?: number;
48924
+ static names(): {
48925
+ [key: string]: string;
48926
+ };
48927
+ static types(): {
48928
+ [key: string]: any;
48929
+ };
48930
+ constructor(map?: {
48931
+ [key: string]: any;
48932
+ });
48933
+ }
48934
+ export declare class CreateAutoProvisioningGroupShrinkRequestSystemDiskConfig extends $tea.Model {
48935
+ /**
48936
+ * @remarks
48937
+ * The category of the system disk. You can specify multiple disk categories, and the disk categories are prioritized in the order in which they are specified. If a specified disk category is unavailable, the system uses the next available disk category. Valid values:
48938
+ *
48939
+ * - cloud_efficiency: ultra disk.
48940
+ * - cloud_ssd: standard SSD.
48941
+ * - cloud_essd: ESSD
48942
+ * - cloud: basic disk.
48943
+ *
48944
+ * @example
48945
+ * cloud_ssd
48946
+ */
48947
+ diskCategory?: string;
48948
+ static names(): {
48949
+ [key: string]: string;
48950
+ };
48951
+ static types(): {
48952
+ [key: string]: any;
48953
+ };
48954
+ constructor(map?: {
48955
+ [key: string]: any;
48956
+ });
48957
+ }
48958
+ export declare class CreateAutoProvisioningGroupShrinkRequestTag extends $tea.Model {
47805
48959
  /**
47806
48960
  * @remarks
47807
48961
  * The key of tag N to add to the auto provisioning group.
@@ -53292,6 +54446,7 @@ export declare class DescribeCommandsResponseBodyCommandsCommand extends $tea.Mo
53292
54446
  * true
53293
54447
  */
53294
54448
  latest?: boolean;
54449
+ launcher?: string;
53295
54450
  /**
53296
54451
  * @remarks
53297
54452
  * The name of the command.
@@ -56777,7 +57932,35 @@ export declare class DescribeElasticityAssurancesRequestTag extends $tea.Model {
56777
57932
  [key: string]: any;
56778
57933
  });
56779
57934
  }
57935
+ export declare class DescribeElasticityAssurancesResponseBodyElasticityAssuranceSetElasticityAssuranceItemAllocatedResourcesAllocatedResourceElasticityAssuranceUsagesElasticityAssuranceUsage extends $tea.Model {
57936
+ accountId?: string;
57937
+ serviceName?: string;
57938
+ usedAmount?: number;
57939
+ static names(): {
57940
+ [key: string]: string;
57941
+ };
57942
+ static types(): {
57943
+ [key: string]: any;
57944
+ };
57945
+ constructor(map?: {
57946
+ [key: string]: any;
57947
+ });
57948
+ }
57949
+ export declare class DescribeElasticityAssurancesResponseBodyElasticityAssuranceSetElasticityAssuranceItemAllocatedResourcesAllocatedResourceElasticityAssuranceUsages extends $tea.Model {
57950
+ elasticityAssuranceUsage?: DescribeElasticityAssurancesResponseBodyElasticityAssuranceSetElasticityAssuranceItemAllocatedResourcesAllocatedResourceElasticityAssuranceUsagesElasticityAssuranceUsage[];
57951
+ static names(): {
57952
+ [key: string]: string;
57953
+ };
57954
+ static types(): {
57955
+ [key: string]: any;
57956
+ };
57957
+ constructor(map?: {
57958
+ [key: string]: any;
57959
+ });
57960
+ }
56780
57961
  export declare class DescribeElasticityAssurancesResponseBodyElasticityAssuranceSetElasticityAssuranceItemAllocatedResourcesAllocatedResource extends $tea.Model {
57962
+ availableAmount?: number;
57963
+ elasticityAssuranceUsages?: DescribeElasticityAssurancesResponseBodyElasticityAssuranceSetElasticityAssuranceItemAllocatedResourcesAllocatedResourceElasticityAssuranceUsages;
56781
57964
  /**
56782
57965
  * @remarks
56783
57966
  * The instance type.
@@ -56885,6 +58068,7 @@ export declare class DescribeElasticityAssurancesResponseBodyElasticityAssurance
56885
58068
  * This is description.
56886
58069
  */
56887
58070
  description?: string;
58071
+ elasticityAssuranceOwnerId?: string;
56888
58072
  /**
56889
58073
  * @remarks
56890
58074
  * The time when the elasticity assurance expires.
@@ -57285,8 +58469,29 @@ export declare class DescribeImageComponentsRequestTag extends $tea.Model {
57285
58469
  });
57286
58470
  }
57287
58471
  export declare class DescribeImageComponentsResponseBodyImageComponentImageComponentSetParametersParameter extends $tea.Model {
58472
+ /**
58473
+ * @remarks
58474
+ * > This parameter is in invitational preview and is not publicly available.
58475
+ *
58476
+ * @example
58477
+ * null
58478
+ */
57288
58479
  defaultValue?: string;
58480
+ /**
58481
+ * @remarks
58482
+ * > This parameter is in invitational preview and is not publicly available.
58483
+ *
58484
+ * @example
58485
+ * null
58486
+ */
57289
58487
  name?: string;
58488
+ /**
58489
+ * @remarks
58490
+ * > This parameter is in invitational preview and is not publicly available.
58491
+ *
58492
+ * @example
58493
+ * null
58494
+ */
57290
58495
  type?: string;
57291
58496
  static names(): {
57292
58497
  [key: string]: string;
@@ -57358,6 +58563,13 @@ export declare class DescribeImageComponentsResponseBodyImageComponentImageCompo
57358
58563
  * Build
57359
58564
  */
57360
58565
  componentType?: string;
58566
+ /**
58567
+ * @remarks
58568
+ * > This parameter is in invitational preview and is not publicly available.
58569
+ *
58570
+ * @example
58571
+ * null
58572
+ */
57361
58573
  componentVersion?: string;
57362
58574
  /**
57363
58575
  * @remarks
@@ -57410,6 +58622,10 @@ export declare class DescribeImageComponentsResponseBodyImageComponentImageCompo
57410
58622
  * SELF
57411
58623
  */
57412
58624
  owner?: string;
58625
+ /**
58626
+ * @remarks
58627
+ * > This parameter is in invitational preview and is not publicly available.
58628
+ */
57413
58629
  parameters?: DescribeImageComponentsResponseBodyImageComponentImageComponentSetParameters;
57414
58630
  /**
57415
58631
  * @remarks
@@ -58098,6 +59314,13 @@ export declare class DescribeImagePipelinesResponseBodyImagePipelineImagePipelin
58098
59314
  * This is description.
58099
59315
  */
58100
59316
  description?: string;
59317
+ /**
59318
+ * @remarks
59319
+ * > This parameter is in invitational preview and is not publicly available.
59320
+ *
59321
+ * @example
59322
+ * null
59323
+ */
58101
59324
  imageFamily?: string;
58102
59325
  /**
58103
59326
  * @remarks
@@ -58139,6 +59362,13 @@ export declare class DescribeImagePipelinesResponseBodyImagePipelineImagePipelin
58139
59362
  * testImagePipeline
58140
59363
  */
58141
59364
  name?: string;
59365
+ /**
59366
+ * @remarks
59367
+ * > This parameter is in invitational preview and is not publicly available.
59368
+ *
59369
+ * @example
59370
+ * null
59371
+ */
58142
59372
  repairMode?: string;
58143
59373
  /**
58144
59374
  * @remarks
@@ -58161,6 +59391,13 @@ export declare class DescribeImagePipelinesResponseBodyImagePipelineImagePipelin
58161
59391
  * The tags of the image template.
58162
59392
  */
58163
59393
  tags?: DescribeImagePipelinesResponseBodyImagePipelineImagePipelineSetTags;
59394
+ /**
59395
+ * @remarks
59396
+ * > This parameter is in invitational preview and is not publicly available.
59397
+ *
59398
+ * @example
59399
+ * null
59400
+ */
58164
59401
  testContent?: string;
58165
59402
  /**
58166
59403
  * @remarks
@@ -60387,6 +61624,30 @@ export declare class DescribeInstanceTypeFamiliesResponseBodyInstanceTypeFamilie
60387
61624
  [key: string]: any;
60388
61625
  });
60389
61626
  }
61627
+ export declare class DescribeInstanceTypesResponseBodyInstanceTypesInstanceTypeCpuOptionsSupportedTopologyTypes extends $tea.Model {
61628
+ supportedTopologyType?: string[];
61629
+ static names(): {
61630
+ [key: string]: string;
61631
+ };
61632
+ static types(): {
61633
+ [key: string]: any;
61634
+ };
61635
+ constructor(map?: {
61636
+ [key: string]: any;
61637
+ });
61638
+ }
61639
+ export declare class DescribeInstanceTypesResponseBodyInstanceTypesInstanceTypeCpuOptions extends $tea.Model {
61640
+ supportedTopologyTypes?: DescribeInstanceTypesResponseBodyInstanceTypesInstanceTypeCpuOptionsSupportedTopologyTypes;
61641
+ static names(): {
61642
+ [key: string]: string;
61643
+ };
61644
+ static types(): {
61645
+ [key: string]: any;
61646
+ };
61647
+ constructor(map?: {
61648
+ [key: string]: any;
61649
+ });
61650
+ }
60390
61651
  export declare class DescribeInstanceTypesResponseBodyInstanceTypesInstanceTypeEnhancedNetwork extends $tea.Model {
60391
61652
  /**
60392
61653
  * @remarks
@@ -60485,6 +61746,7 @@ export declare class DescribeInstanceTypesResponseBodyInstanceTypesInstanceType
60485
61746
  * 4
60486
61747
  */
60487
61748
  cpuCoreCount?: number;
61749
+ cpuOptions?: DescribeInstanceTypesResponseBodyInstanceTypesInstanceTypeCpuOptions;
60488
61750
  /**
60489
61751
  * @remarks
60490
61752
  * The CPU base frequency. Unit: GHz.
@@ -61101,6 +62363,11 @@ export declare class DescribeInstancesResponseBodyInstancesInstanceHibernationOp
61101
62363
  });
61102
62364
  }
61103
62365
  export declare class DescribeInstancesResponseBodyInstancesInstanceImageOptions extends $tea.Model {
62366
+ /**
62367
+ * @example
62368
+ * true
62369
+ */
62370
+ currentOSNVMeSupported?: boolean;
61104
62371
  /**
61105
62372
  * @remarks
61106
62373
  * Indicates whether the instance that uses the image supports logons of the ecs-user user. Valid values:
@@ -61798,7 +63065,7 @@ export declare class DescribeInstancesResponseBodyInstancesInstance extends $tea
61798
63065
  imageId?: string;
61799
63066
  /**
61800
63067
  * @remarks
61801
- * Details about the image options.
63068
+ * The image options.
61802
63069
  */
61803
63070
  imageOptions?: DescribeInstancesResponseBodyInstancesInstanceImageOptions;
61804
63071
  /**
@@ -64050,8 +65317,20 @@ export declare class DescribeLaunchTemplateVersionsResponseBodyLaunchTemplateVer
64050
65317
  * testHostName
64051
65318
  */
64052
65319
  hostName?: string;
65320
+ /**
65321
+ * @example
65322
+ * enabled
65323
+ */
64053
65324
  httpEndpoint?: string;
65325
+ /**
65326
+ * @example
65327
+ * 3
65328
+ */
64054
65329
  httpPutResponseHopLimit?: number;
65330
+ /**
65331
+ * @example
65332
+ * optional
65333
+ */
64055
65334
  httpTokens?: string;
64056
65335
  /**
64057
65336
  * @remarks
@@ -64333,7 +65612,7 @@ export declare class DescribeLaunchTemplateVersionsResponseBodyLaunchTemplateVer
64333
65612
  createTime?: string;
64334
65613
  /**
64335
65614
  * @remarks
64336
- * The creator of the launch template version.
65615
+ * The ID of the Alibaba Cloud account that created the launch template.
64337
65616
  *
64338
65617
  * @example
64339
65618
  * 123456789****
@@ -65071,6 +66350,9 @@ export declare class DescribeNetworkInterfaceAttributeResponseBodyEnhancedNetwor
65071
66350
  /**
65072
66351
  * @remarks
65073
66352
  * This parameter is not publicly available.
66353
+ *
66354
+ * @example
66355
+ * false
65074
66356
  */
65075
66357
  enableSriov?: boolean;
65076
66358
  static names(): {
@@ -65946,6 +67228,13 @@ export declare class DescribeNetworkInterfacesResponseBodyNetworkInterfaceSetsNe
65946
67228
  * true
65947
67229
  */
65948
67230
  serviceManaged?: boolean;
67231
+ /**
67232
+ * @remarks
67233
+ * > This parameter is in invitational preview and is not publicly available.
67234
+ *
67235
+ * @example
67236
+ * false
67237
+ */
65949
67238
  sourceDestCheck?: boolean;
65950
67239
  /**
65951
67240
  * @remarks
@@ -69002,7 +70291,7 @@ export declare class DescribeSnapshotGroupsResponseBodySnapshotGroupsSnapshotGro
69002
70291
  export declare class DescribeSnapshotGroupsResponseBodySnapshotGroupsSnapshotGroupSnapshotsSnapshot extends $tea.Model {
69003
70292
  /**
69004
70293
  * @remarks
69005
- * Indicates whether the snapshot can be used to create or roll back disks. Valid values:
70294
+ * Indicates whether the snapshot can be shared and be used to create or roll back a disk. Valid values:
69006
70295
  *
69007
70296
  * * true
69008
70297
  * * false
@@ -69016,7 +70305,9 @@ export declare class DescribeSnapshotGroupsResponseBodySnapshotGroupsSnapshotGro
69016
70305
  * Indicates whether the instant access feature is enabled. Valid values:
69017
70306
  *
69018
70307
  * * true: The instant access feature is enabled. By default, the instant access feature is enabled for ESSDs.
69019
- * * false: The instant access feature is disabled. The snapshot is a normal snapshot for which the instant access feature is disabled.
70308
+ * * false: The instant access feature is disabled. The snapshot is a standard snapshot for which the instant access feature is disabled.
70309
+ *
70310
+ * > This parameter is no longer used. By default, standard snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
69020
70311
  *
69021
70312
  * @example
69022
70313
  * true
@@ -69024,9 +70315,9 @@ export declare class DescribeSnapshotGroupsResponseBodySnapshotGroupsSnapshotGro
69024
70315
  instantAccess?: boolean;
69025
70316
  /**
69026
70317
  * @remarks
69027
- * The retention period of the instant access feature. After the retention period ends, the snapshot is automatically released.
70318
+ * The validity period of the instant access feature. When the validity period ends, the instant access snapshot is automatically released.
69028
70319
  *
69029
- * > This parameter is deprecated. The normal snapshots of enhanced SSDs (ESSDs) are upgraded to support the instant access feature by default. No additional configurations are required to enable the feature and you are not charged for the feature. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
70320
+ * > This parameter is no longer used. By default, standard snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
69030
70321
  *
69031
70322
  * @example
69032
70323
  * 3
@@ -69192,7 +70483,7 @@ export declare class DescribeSnapshotGroupsResponseBodySnapshotGroupsSnapshotGro
69192
70483
  snapshotGroupId?: string;
69193
70484
  /**
69194
70485
  * @remarks
69195
- * Details of the snapshots in the snapshot-consistent group.
70486
+ * The information about the snapshots in the snapshot-consistent group.
69196
70487
  */
69197
70488
  snapshots?: DescribeSnapshotGroupsResponseBodySnapshotGroupsSnapshotGroupSnapshots;
69198
70489
  /**
@@ -69264,9 +70555,9 @@ export declare class DescribeSnapshotLinksResponseBodySnapshotLinksSnapshotLink
69264
70555
  * Indicates whether the instant access feature is enabled. Valid values:
69265
70556
  *
69266
70557
  * * true: The instant access feature is enabled. This feature can be enabled only for enhanced SSDs (ESSDs).
69267
- * * false: The instant access feature is disabled. The snapshot is a normal snapshot for which the instant access feature is disabled.
70558
+ * * false: The instant access feature is disabled. The snapshot is a standard snapshot for which the instant access feature is disabled.
69268
70559
  *
69269
- * > This parameter is no longer used. By default, new normal snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
70560
+ * > This parameter is no longer used. By default, new standard snapshots of ESSDs are upgraded to instant access snapshots free of charge without the need for additional configurations. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
69270
70561
  *
69271
70562
  * @example
69272
70563
  * false
@@ -69550,7 +70841,7 @@ export declare class DescribeSnapshotsResponseBodySnapshotsSnapshotTags extends
69550
70841
  export declare class DescribeSnapshotsResponseBodySnapshotsSnapshot extends $tea.Model {
69551
70842
  /**
69552
70843
  * @remarks
69553
- * Indicates whether the snapshot can be used to create or roll back a disk. Valid values:
70844
+ * Indicates whether the snapshot can be shared and be used to create or roll back a cloud disk. Valid values:
69554
70845
  *
69555
70846
  * * true
69556
70847
  * * false
@@ -69597,8 +70888,10 @@ export declare class DescribeSnapshotsResponseBodySnapshotsSnapshot extends $tea
69597
70888
  * @remarks
69598
70889
  * Indicates whether the instant access feature is enabled. Valid values:
69599
70890
  *
69600
- * * true: The instant access feature is enabled. By default, the instant access feature is enabled for Enterprise SSDs (ESSDs).
69601
- * * false: The instant access feature is disabled. The snapshot is a normal snapshot for which the instant access feature is disabled.
70891
+ * * true: The instant access feature is enabled. By default, the instant access feature is enabled for Enterprise SSDs (ESSDs) and ESSD Entry disks.
70892
+ * * false: The instant access feature is disabled. The snapshot is a standard snapshot for which the instant access feature is disabled.
70893
+ *
70894
+ * > This parameter is no longer used. The standard snapshots of ESSDs are upgraded to support the instant access feature by default. No additional configurations are required to enable the feature and you are not charged for the feature. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
69602
70895
  *
69603
70896
  * @example
69604
70897
  * false
@@ -69610,7 +70903,7 @@ export declare class DescribeSnapshotsResponseBodySnapshotsSnapshot extends $tea
69610
70903
  *
69611
70904
  * By default, the value of this parameter is the same as the value of `RetentionDays`.
69612
70905
  *
69613
- * > This parameter is no longer used. The normal snapshots of ESSDs are upgraded to support the instant access feature by default. No additional configurations are required to enable the feature and you are not charged for the feature. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
70906
+ * > This parameter is no longer used. The standard snapshots of ESSDs are upgraded to support the instant access feature by default. No additional configurations are required to enable the feature and you are not charged for the feature. For more information, see [Use the instant access feature](https://help.aliyun.com/document_detail/193667.html).
69614
70907
  *
69615
70908
  * @example
69616
70909
  * 30
@@ -73368,6 +74661,8 @@ export declare class ModifyReservedInstancesResponseBodyReservedInstanceIdSets e
73368
74661
  export declare class PurchaseElasticityAssuranceRequestPrivatePoolOptions extends $tea.Model {
73369
74662
  /**
73370
74663
  * @remarks
74664
+ * The ID of the elasticity assurance.
74665
+ *
73371
74666
  * This parameter is required.
73372
74667
  *
73373
74668
  * @example
@@ -73375,6 +74670,14 @@ export declare class PurchaseElasticityAssuranceRequestPrivatePoolOptions extend
73375
74670
  */
73376
74671
  id?: string;
73377
74672
  /**
74673
+ * @remarks
74674
+ * The type of the private pool that is associated with the elasticity assurance. Valid values:
74675
+ *
74676
+ * * Open: open private pool. If you use the elasticity assurance to create ECS instances, the open private pool that is associated with the elasticity assurance is automatically matched. If no capacity is available in the open private pool, resources in the public pool are automatically used to create the ECS instances.
74677
+ * * Target: targeted private pool. If you use the elasticity assurance to create ECS instances, the targeted private pool that is associated with the elasticity assurance is automatically matched. If no capacity is available in the private pool, the ECS instances fail to be created.
74678
+ *
74679
+ * Default value: Open.
74680
+ *
73378
74681
  * @example
73379
74682
  * Open
73380
74683
  */
@@ -74819,25 +76122,25 @@ export declare class RunInstancesRequestDataDisk extends $tea.Model {
74819
76122
  * @remarks
74820
76123
  * The category of data disk N. Valid values:
74821
76124
  *
74822
- * * cloud_efficiency: ultra disk.
76125
+ * * cloud_efficiency: ultra disk
74823
76126
  *
74824
- * * cloud_ssd: standard SSD.
76127
+ * * cloud_ssd: standard SSD
74825
76128
  *
74826
- * * cloud_essd: ESSD.
76129
+ * * cloud_essd: ESSD
74827
76130
  *
74828
- * * cloud: basic disk.
76131
+ * * cloud: basic disk
74829
76132
  *
74830
- * * cloud_auto: ESSD AutoPL disk.
76133
+ * * cloud_auto: ESSD AutoPL disk
74831
76134
  *
74832
- * * cloud_essd_entry: ESSD Entry disk.
76135
+ * * cloud_essd_entry: ESSD Entry disk
74833
76136
  *
74834
76137
  * **
74835
76138
  *
74836
76139
  * **Note** This parameter can be set to `cloud_essd_entry` only when `InstanceType` is set to `ecs.u1` or `ecs.e`.
74837
76140
  *
74838
- * * elastic_ephemeral_disk_standard: standard elastic ephemeral disk.
76141
+ * * elastic_ephemeral_disk_standard: standard elastic ephemeral disk
74839
76142
  *
74840
- * * elastic_ephemeral_disk_premium: premium elastic ephemeral disk.
76143
+ * * elastic_ephemeral_disk_premium: premium elastic ephemeral disk
74841
76144
  *
74842
76145
  * For I/O optimized instances, the default value is cloud_efficiency. For non-I/O optimized instances, the default value is cloud.
74843
76146
  *
@@ -74873,7 +76176,7 @@ export declare class RunInstancesRequestDataDisk extends $tea.Model {
74873
76176
  * * 1st to 25th data disks: /dev/xvd`[b-z]`.
74874
76177
  * * 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.
74875
76178
  *
74876
- * > 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 `DataDisk.N.Size` and `DataDisk.N.Category` to change the category and size of data disk N created based on the image.
76179
+ * > 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.
74877
76180
  *
74878
76181
  * @example
74879
76182
  * /dev/xvdb
@@ -74921,11 +76224,11 @@ export declare class RunInstancesRequestDataDisk extends $tea.Model {
74921
76224
  * 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:
74922
76225
  *
74923
76226
  * * PL0: A single ESSD can deliver up to 10,000 random read/write IOPS.
74924
- * * PL1 (default): A single ESSD can deliver up to 50,000 random read/write IOPS.
74925
- * * PL2: A single ESSD can deliver up to 100,000 random read/write IOPS.
74926
- * * PL3: A single ESSD can deliver up to 1,000,000 random read/write IOPS.
76227
+ * * PL1 (default): A single ESSD can deliver up to 50000 random read/write IOPS.
76228
+ * * PL2: A single ESSD can deliver up to 100000 random read/write IOPS.
76229
+ * * PL3: A single ESSD can deliver up to 1000000 random read/write IOPS.
74927
76230
  *
74928
- * For more information about ESSD performance levels, see [ESSDs](https://help.aliyun.com/document_detail/122389.html).
76231
+ * For information about ESSD performance levels, see [ESSDs](https://help.aliyun.com/document_detail/122389.html).
74929
76232
  *
74930
76233
  * @example
74931
76234
  * PL1
@@ -74935,7 +76238,7 @@ export declare class RunInstancesRequestDataDisk extends $tea.Model {
74935
76238
  * @remarks
74936
76239
  * 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}.
74937
76240
  *
74938
- * Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}.
76241
+ * Baseline IOPS = min{1,800 + 50 × Capacity, 50,000}
74939
76242
  *
74940
76243
  * > 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).
74941
76244
  *
@@ -74953,14 +76256,14 @@ export declare class RunInstancesRequestDataDisk extends $tea.Model {
74953
76256
  *
74954
76257
  * * Valid values when DataDisk.N.Category is set to cloud_essd: vary based on the value of `DataDisk.N.PerformanceLevel`.
74955
76258
  *
74956
- * * Valid values when DataDisk.N.PerformanceLevel is set to PL0: 1 to 32768.
74957
- * * Valid values when DataDisk.N.PerformanceLevel is set to PL1: 20 to 32768.
74958
- * * Valid values when DataDisk.N.PerformanceLevel is set to PL2: 461 to 32768.
74959
- * * Valid values when DataDisk.N.PerformanceLevel is set to PL3: 1261 to 32768.
76259
+ * * Valid values when DataDisk.N.PerformanceLevel is set to PL0: 1 to 65536.
76260
+ * * Valid values when DataDisk.N.PerformanceLevel is set to PL1: 20 to 65536.
76261
+ * * Valid values when DataDisk.N.PerformanceLevel is set to PL2: 461 to 65536.
76262
+ * * Valid values when DataDisk.N.PerformanceLevel is set to PL3: 1261 to 65536.
74960
76263
  *
74961
76264
  * * Valid values when DataDisk.N.Category is set to cloud: 5 to 2000.
74962
76265
  *
74963
- * * Valid values when DataDisk.N.Category is set to cloud_auto: 1 to 32768.
76266
+ * * Valid values when DiskCategory is set to cloud_auto: 1 to 65536.
74964
76267
  *
74965
76268
  * * Valid values when DataDisk.N.Category is set to cloud_essd_entry: 10 to 32768.
74966
76269
  *
@@ -74974,7 +76277,7 @@ export declare class RunInstancesRequestDataDisk extends $tea.Model {
74974
76277
  * @remarks
74975
76278
  * The ID of the snapshot to use to create data disk N. Valid values of N: 1 to 16.
74976
76279
  *
74977
- * If `DataDisk.N.SnapshotId` is specified, `DataDisk.N.Size` is ignored. The data disk is created based on the size of the specified snapshot. Use snapshots created after July 15, 2013. Otherwise, an error is returned and your request is rejected.
76280
+ * 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.
74978
76281
  *
74979
76282
  * @example
74980
76283
  * s-bp17441ohwka0yuh****
@@ -74982,7 +76285,7 @@ export declare class RunInstancesRequestDataDisk extends $tea.Model {
74982
76285
  snapshotId?: string;
74983
76286
  /**
74984
76287
  * @remarks
74985
- * The ID of the dedicated block storage cluster to which data disk N belongs. If you want to use a disk in a dedicated block storage cluster as data disk N when you create the instance, specify this parameter.
76288
+ * The ID of the dedicated block storage cluster to which data disk N belongs. If you want to use a disk in a dedicated block storage cluster as data disk N when you create the instance, you must specify this parameter.
74986
76289
  *
74987
76290
  * @example
74988
76291
  * dbsc-j5e1sf2vaf5he8m2****
@@ -76435,7 +77738,7 @@ export default class Client extends OpenApi {
76435
77738
  */
76436
77739
  copyImage(request: CopyImageRequest): Promise<CopyImageResponse>;
76437
77740
  /**
76438
- * Copies a normal or encrypted snapshot from one region to another.
77741
+ * Copies a standard or encrypted snapshot from one region to another.
76439
77742
  *
76440
77743
  * @remarks
76441
77744
  * ## [](#)Usage notes
@@ -76449,7 +77752,7 @@ export default class Client extends OpenApi {
76449
77752
  */
76450
77753
  copySnapshotWithOptions(request: CopySnapshotRequest, runtime: $Util.RuntimeOptions): Promise<CopySnapshotResponse>;
76451
77754
  /**
76452
- * Copies a normal or encrypted snapshot from one region to another.
77755
+ * Copies a standard or encrypted snapshot from one region to another.
76453
77756
  *
76454
77757
  * @remarks
76455
77758
  * ## [](#)Usage notes
@@ -76518,11 +77821,11 @@ export default class Client extends OpenApi {
76518
77821
  * * Auto Provisioning is provided free of charge. However, you are charged for instance resources that are created in auto provisioning groups. For more information, see [Overview of preemptible instances](https://help.aliyun.com/document_detail/52088.html) and [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
76519
77822
  * * When you specify both a launch template (`LaunchTemplateId`) and extended configurations (`LaunchConfiguration.*` parameters), LaunchTemplateId takes precedence.
76520
77823
  *
76521
- * @param request - CreateAutoProvisioningGroupRequest
77824
+ * @param tmpReq - CreateAutoProvisioningGroupRequest
76522
77825
  * @param runtime - runtime options for this request RuntimeOptions
76523
77826
  * @returns CreateAutoProvisioningGroupResponse
76524
77827
  */
76525
- createAutoProvisioningGroupWithOptions(request: CreateAutoProvisioningGroupRequest, runtime: $Util.RuntimeOptions): Promise<CreateAutoProvisioningGroupResponse>;
77828
+ createAutoProvisioningGroupWithOptions(tmpReq: CreateAutoProvisioningGroupRequest, runtime: $Util.RuntimeOptions): Promise<CreateAutoProvisioningGroupResponse>;
76526
77829
  /**
76527
77830
  * Creates an auto provisioning group. When you call this operation, you can specify parameters, such as ResourceGroupId, AutoProvisioningGroupType, and ValidFrom, in the request.
76528
77831
  *
@@ -76893,12 +78196,13 @@ export default class Client extends OpenApi {
76893
78196
  * Creates an image component. Image components are used to store the image template commands that are commonly used to create images.
76894
78197
  *
76895
78198
  * @remarks
78199
+ * ## [](#)Usage notes
76896
78200
  * Take note of the following items:
76897
- * * Only custom image components can be created.
76898
- * * The images must run Linux operating systems. This indicates that you must set `SystemType` to Linux.
76899
- * * You must set the image component type to image build component by setting the `ComponentType` parameter to Build.
76900
- * * You can use Dockerfile to edit the content of image components, and then pass the edited content into the `Content` parameter. The content size must not be greater than 16 KB. `FROM` commands cannot be used in image components. An image component supports up to 127 commands. For information about supported commands, see [Description of commands supported by Image Builder](https://help.aliyun.com/document_detail/200206.html).
76901
- * You can use image components to create image templates in the Elastic Compute Service (ECS) console, but cannot call API operations to use image components to create image templates. For more information, see [Overview of Image Builder](https://help.aliyun.com/document_detail/197410.html).
78201
+ * * You can create only custom image components.
78202
+ * * Only Linux operating systems are supported. Set `SystemType` to Linux.
78203
+ * * Only image build components are supported. Set `ComponentType` to Build.
78204
+ * * You can use Dockerfile to edit the content of image components and pass the edited content into the `Content` parameter. The content size can be up to 16 KB. `FROM` commands cannot be used in image components. An image component supports up to 127 commands. For information about the supported commands, see [Commands supported by Image Builder](https://help.aliyun.com/document_detail/200206.html).
78205
+ * You can use image components to create image templates in the Elastic Compute Service (ECS) console, but cannot call API operations to create image templates from image components. For more information, see [What is Image Builder](https://help.aliyun.com/document_detail/197410.html).
76902
78206
  *
76903
78207
  * @param request - CreateImageComponentRequest
76904
78208
  * @param runtime - runtime options for this request RuntimeOptions
@@ -76909,12 +78213,13 @@ export default class Client extends OpenApi {
76909
78213
  * Creates an image component. Image components are used to store the image template commands that are commonly used to create images.
76910
78214
  *
76911
78215
  * @remarks
78216
+ * ## [](#)Usage notes
76912
78217
  * Take note of the following items:
76913
- * * Only custom image components can be created.
76914
- * * The images must run Linux operating systems. This indicates that you must set `SystemType` to Linux.
76915
- * * You must set the image component type to image build component by setting the `ComponentType` parameter to Build.
76916
- * * You can use Dockerfile to edit the content of image components, and then pass the edited content into the `Content` parameter. The content size must not be greater than 16 KB. `FROM` commands cannot be used in image components. An image component supports up to 127 commands. For information about supported commands, see [Description of commands supported by Image Builder](https://help.aliyun.com/document_detail/200206.html).
76917
- * You can use image components to create image templates in the Elastic Compute Service (ECS) console, but cannot call API operations to use image components to create image templates. For more information, see [Overview of Image Builder](https://help.aliyun.com/document_detail/197410.html).
78218
+ * * You can create only custom image components.
78219
+ * * Only Linux operating systems are supported. Set `SystemType` to Linux.
78220
+ * * Only image build components are supported. Set `ComponentType` to Build.
78221
+ * * You can use Dockerfile to edit the content of image components and pass the edited content into the `Content` parameter. The content size can be up to 16 KB. `FROM` commands cannot be used in image components. An image component supports up to 127 commands. For information about the supported commands, see [Commands supported by Image Builder](https://help.aliyun.com/document_detail/200206.html).
78222
+ * You can use image components to create image templates in the Elastic Compute Service (ECS) console, but cannot call API operations to create image templates from image components. For more information, see [What is Image Builder](https://help.aliyun.com/document_detail/197410.html).
76918
78223
  *
76919
78224
  * @param request - CreateImageComponentRequest
76920
78225
  * @returns CreateImageComponentResponse
@@ -76924,15 +78229,16 @@ export default class Client extends OpenApi {
76924
78229
  * Creates an image template. Image templates can be used to create images.
76925
78230
  *
76926
78231
  * @remarks
76927
- * You can use image templates to specify custom image content and create images across regions and accounts. When you call this operation, take note of the following items:
78232
+ * ## [](#)Usage notes
78233
+ * You can use image templates to customize image content and create images across regions and accounts. Take note of the following items:
76928
78234
  * * You can create only custom image templates.
76929
78235
  * * You can configure only public, custom, or shared Linux images or image families as the source images when you create image templates.
76930
- * * 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 by using the pay-as-you-go billing method. For more information, see [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
76931
- * For the `BuildContent` parameter that specifies the content of image templates, take note of the following items:
76932
- * * If the `BuildContent` value contains `FROM` commands, the `FROM` commands override the values of `BaseImageType` that specifies the type of the source images and `BaseImage` that specifies the source image.
78236
+ * * When you create an image from an image template, an intermediate Elastic Compute Service (ECS) instance that uses the pay-as-you-go billing method is created. You are charged for the instance. For more information, see [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
78237
+ * When you use the `BuildContent` parameter to specify the content of the image template, take note of the following items:
78238
+ * * If the `BuildContent` value contains `FROM` commands, the `FROM` commands override the values of `BaseImageType` that specifies the type of the source image and `BaseImage` that specifies the source image.
76933
78239
  * * If the `BuildContent` value does not contain `FROM` commands, the system creates a `FROM` command that consists of the `BaseImageType` and `BaseImage` values in the format of `<BaseImageType>:<BaseImage>` and adds the command to the first line of the template content.
76934
- * * You can use Dockerfile to edit the content of image templates and then pass the edited content into the `BuildContent` parameter. The content of an image template cannot exceed 16 KB in size and can contain up to 127 commands. For information about commands supported by image templates, see [Description of commands supported by Image Builder](https://help.aliyun.com/document_detail/200206.html).
76935
- * 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 of Image Builder](https://help.aliyun.com/document_detail/197410.html).
78240
+ * * You can use Dockerfile to edit the content of the image template 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 commands supported by image templates, see [Commands supported by Image Builder](https://help.aliyun.com/document_detail/200206.html).
78241
+ * 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 [What is Image Builder](https://help.aliyun.com/document_detail/197410.html).
76936
78242
  *
76937
78243
  * @param request - CreateImagePipelineRequest
76938
78244
  * @param runtime - runtime options for this request RuntimeOptions
@@ -76943,15 +78249,16 @@ export default class Client extends OpenApi {
76943
78249
  * Creates an image template. Image templates can be used to create images.
76944
78250
  *
76945
78251
  * @remarks
76946
- * You can use image templates to specify custom image content and create images across regions and accounts. When you call this operation, take note of the following items:
78252
+ * ## [](#)Usage notes
78253
+ * You can use image templates to customize image content and create images across regions and accounts. Take note of the following items:
76947
78254
  * * You can create only custom image templates.
76948
78255
  * * You can configure only public, custom, or shared Linux images or image families as the source images when you create image templates.
76949
- * * 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 by using the pay-as-you-go billing method. For more information, see [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
76950
- * For the `BuildContent` parameter that specifies the content of image templates, take note of the following items:
76951
- * * If the `BuildContent` value contains `FROM` commands, the `FROM` commands override the values of `BaseImageType` that specifies the type of the source images and `BaseImage` that specifies the source image.
78256
+ * * When you create an image from an image template, an intermediate Elastic Compute Service (ECS) instance that uses the pay-as-you-go billing method is created. You are charged for the instance. For more information, see [Pay-as-you-go](https://help.aliyun.com/document_detail/40653.html).
78257
+ * When you use the `BuildContent` parameter to specify the content of the image template, take note of the following items:
78258
+ * * If the `BuildContent` value contains `FROM` commands, the `FROM` commands override the values of `BaseImageType` that specifies the type of the source image and `BaseImage` that specifies the source image.
76952
78259
  * * If the `BuildContent` value does not contain `FROM` commands, the system creates a `FROM` command that consists of the `BaseImageType` and `BaseImage` values in the format of `<BaseImageType>:<BaseImage>` and adds the command to the first line of the template content.
76953
- * * You can use Dockerfile to edit the content of image templates and then pass the edited content into the `BuildContent` parameter. The content of an image template cannot exceed 16 KB in size and can contain up to 127 commands. For information about commands supported by image templates, see [Description of commands supported by Image Builder](https://help.aliyun.com/document_detail/200206.html).
76954
- * 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 of Image Builder](https://help.aliyun.com/document_detail/197410.html).
78260
+ * * You can use Dockerfile to edit the content of the image template 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 commands supported by image templates, see [Commands supported by Image Builder](https://help.aliyun.com/document_detail/200206.html).
78261
+ * 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 [What is Image Builder](https://help.aliyun.com/document_detail/197410.html).
76955
78262
  *
76956
78263
  * @param request - CreateImagePipelineRequest
76957
78264
  * @returns CreateImagePipelineResponse
@@ -77107,7 +78414,7 @@ export default class Client extends OpenApi {
77107
78414
  */
77108
78415
  createLaunchTemplate(request: CreateLaunchTemplateRequest): Promise<CreateLaunchTemplateResponse>;
77109
78416
  /**
77110
- * Creates a version for a launch template. You can use the created version to create Elastic Compute Service (ECS) instances, scaling groups, or auto provisioning groups. When you call this operation, you can specify parameters, such as LaunchTemplateId, VersionDescription, and Tag, in the request.
78417
+ * Creates a version for a launch template. You can use the created version to create Elastic Compute Service (ECS) instances, scaling groups, or auto provisioning groups. When you call this operation, you can specify parameters, such as LaunchTemplateId, VersionDescription, and instance-related parameters, in the request.
77111
78418
  *
77112
78419
  * @remarks
77113
78420
  * ## [](#)Usage notes
@@ -77119,7 +78426,7 @@ export default class Client extends OpenApi {
77119
78426
  */
77120
78427
  createLaunchTemplateVersionWithOptions(request: CreateLaunchTemplateVersionRequest, runtime: $Util.RuntimeOptions): Promise<CreateLaunchTemplateVersionResponse>;
77121
78428
  /**
77122
- * Creates a version for a launch template. You can use the created version to create Elastic Compute Service (ECS) instances, scaling groups, or auto provisioning groups. When you call this operation, you can specify parameters, such as LaunchTemplateId, VersionDescription, and Tag, in the request.
78429
+ * Creates a version for a launch template. You can use the created version to create Elastic Compute Service (ECS) instances, scaling groups, or auto provisioning groups. When you call this operation, you can specify parameters, such as LaunchTemplateId, VersionDescription, and instance-related parameters, in the request.
77123
78430
  *
77124
78431
  * @remarks
77125
78432
  * ## [](#)Usage notes
@@ -77360,20 +78667,19 @@ export default class Client extends OpenApi {
77360
78667
  * This parameter is empty by default, which indicates that the snapshot is not automatically released.
77361
78668
  *
77362
78669
  * @remarks
77363
- * ## [](#)Usage notes
77364
78670
  * The local snapshot feature is replaced by the instant access feature. Take note of the following items:
77365
78671
  * * If you have used the local snapshot feature before December 14, 2020, you can use the Category parameter.
77366
- * * If you have not used the local snapshot feature before December 14, 2020, new snapshots of your enhanced SSDs (ESSDs) at performance levels 0, 1, 2, and 3 (PL0, PL1, PL2, and PL3 ESSDs) and ESSD AutoPL disks are instantly available after creation without the need for additional configurations, regardless of whether the snapshots are manually or automatically created. The InstantAccess, InstantAccessRetentionDays, and DisableInstantAccess parameters in this operation that are related to the instant access feature no longer take effect. Available is added to the response parameters of the DescribeSnapshots and DescribeSnapshotGroup operations to indicate whether the snapshot is available.
78672
+ * * If you have not used the local snapshot feature before December 14, 2020, new snapshots of your Enterprise SSD (ESSD) series disks are instantly available after creation without the need for additional configurations, regardless of whether the snapshots are manually or automatically created. ESSD-series disks include ESSDs, ESSD AutoPL disks, ESSD Entry disks, and Regional ESSDs. The InstantAccess, InstantAccessRetentionDays, and DisableInstantAccess parameters that are related to the instant access feature no longer take effect in API operations. The Available parameter is added to the DescribeSnapshots and DescribeSnapshotGroups operations to indicate whether snapshots are available.
77367
78673
  * In the following scenarios, you cannot create snapshots for a disk:
77368
78674
  * * The number of manual snapshots of the disk has reached 256.
77369
78675
  * * A snapshot is being created for the disk.
77370
78676
  * * The Elastic Compute Service (ECS) instance to which the disk is attached has never been started.
77371
78677
  * * The ECS instance to which the disk is attached is not in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
77372
- * * 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.
78678
+ * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}` when you query information about an ECS instance, the instance is locked for security reasons and no operations are allowed on the instance.
77373
78679
  * When you create a snapshot, take note of the following items:
77374
78680
  * * If a snapshot is being created, you cannot use this snapshot to create a custom image by calling the [CreateImage](https://help.aliyun.com/document_detail/25535.html) operation.
77375
78681
  * * When a snapshot is being created for a disk that is attached to an ECS instance, do not change the instance state.
77376
- * * You can create snapshots for a disk that is in the **Expired** (`Expired`) state. If the release time scheduled for a disk arrives while a snapshot is being created for the disk, the snapshot is in the **Creating** (`Creating` state and is deleted when the disk is released.
78682
+ * * You can create snapshots for a disk that is in the **Expired** (`Expired`) state. If the release time scheduled for a disk arrives while a snapshot is being created for the disk, the snapshot is in the **Creating** (`Creating`) state and is deleted when the disk is released.
77377
78683
  *
77378
78684
  * @param request - CreateSnapshotRequest
77379
78685
  * @param runtime - runtime options for this request RuntimeOptions
@@ -77385,20 +78691,19 @@ export default class Client extends OpenApi {
77385
78691
  * This parameter is empty by default, which indicates that the snapshot is not automatically released.
77386
78692
  *
77387
78693
  * @remarks
77388
- * ## [](#)Usage notes
77389
78694
  * The local snapshot feature is replaced by the instant access feature. Take note of the following items:
77390
78695
  * * If you have used the local snapshot feature before December 14, 2020, you can use the Category parameter.
77391
- * * If you have not used the local snapshot feature before December 14, 2020, new snapshots of your enhanced SSDs (ESSDs) at performance levels 0, 1, 2, and 3 (PL0, PL1, PL2, and PL3 ESSDs) and ESSD AutoPL disks are instantly available after creation without the need for additional configurations, regardless of whether the snapshots are manually or automatically created. The InstantAccess, InstantAccessRetentionDays, and DisableInstantAccess parameters in this operation that are related to the instant access feature no longer take effect. Available is added to the response parameters of the DescribeSnapshots and DescribeSnapshotGroup operations to indicate whether the snapshot is available.
78696
+ * * If you have not used the local snapshot feature before December 14, 2020, new snapshots of your Enterprise SSD (ESSD) series disks are instantly available after creation without the need for additional configurations, regardless of whether the snapshots are manually or automatically created. ESSD-series disks include ESSDs, ESSD AutoPL disks, ESSD Entry disks, and Regional ESSDs. The InstantAccess, InstantAccessRetentionDays, and DisableInstantAccess parameters that are related to the instant access feature no longer take effect in API operations. The Available parameter is added to the DescribeSnapshots and DescribeSnapshotGroups operations to indicate whether snapshots are available.
77392
78697
  * In the following scenarios, you cannot create snapshots for a disk:
77393
78698
  * * The number of manual snapshots of the disk has reached 256.
77394
78699
  * * A snapshot is being created for the disk.
77395
78700
  * * The Elastic Compute Service (ECS) instance to which the disk is attached has never been started.
77396
78701
  * * The ECS instance to which the disk is attached is not in the **Stopped** (`Stopped`) or **Running** (`Running`) state.
77397
- * * 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.
78702
+ * * If the response contains `{"OperationLocks": {"LockReason" : "security"}}` when you query information about an ECS instance, the instance is locked for security reasons and no operations are allowed on the instance.
77398
78703
  * When you create a snapshot, take note of the following items:
77399
78704
  * * If a snapshot is being created, you cannot use this snapshot to create a custom image by calling the [CreateImage](https://help.aliyun.com/document_detail/25535.html) operation.
77400
78705
  * * When a snapshot is being created for a disk that is attached to an ECS instance, do not change the instance state.
77401
- * * You can create snapshots for a disk that is in the **Expired** (`Expired`) state. If the release time scheduled for a disk arrives while a snapshot is being created for the disk, the snapshot is in the **Creating** (`Creating` state and is deleted when the disk is released.
78706
+ * * You can create snapshots for a disk that is in the **Expired** (`Expired`) state. If the release time scheduled for a disk arrives while a snapshot is being created for the disk, the snapshot is in the **Creating** (`Creating`) state and is deleted when the disk is released.
77402
78707
  *
77403
78708
  * @param request - CreateSnapshotRequest
77404
78709
  * @returns CreateSnapshotResponse
@@ -77408,17 +78713,16 @@ export default class Client extends OpenApi {
77408
78713
  * Creates a snapshot-consistent group for the disks of an Elastic Compute Service (ECS) instance. A snapshot-consistent group contains snapshots of one or more disks.
77409
78714
  *
77410
78715
  * @remarks
77411
- * ## [](#)Usage notes
77412
- * You can specify `InstanceId` to create a snapshot-consistent group for disks on a specific (ECS instance. You can also specify `DiskId.N` to create a snapshot-consistent group for multiple disks on multiple ECS instances within the same zone.
77413
- * > You cannot specify both `DiskId.N` and `ExcludeDiskId.N` in the same request. If `InstanceId` is specified, you can use `DiskId.N` to specify only disks on the ECS instance specified by InstanceId and cannot use DiskId.N to specify disks across ECS instances.
78716
+ * You can specify `InstanceId` to create a snapshot-consistent group for disks on a specific ECS instance. You can also specify `DiskId.N` to create a snapshot-consistent group for multiple disks on multiple ECS instances within the same zone.
78717
+ * > You cannot specify both `DiskId.N` and `ExcludeDiskId.N` in the same request. If you specify `InstanceId`, you can use `DiskId.N` to specify only disks on the specified ECS instance and cannot use DiskId.N to specify disks across ECS instances.
77414
78718
  * Take note of the following items:
77415
78719
  * * The disks for which you want to create a snapshot must be in the **In Use** (`In_use`) or **Unattached** (`Available`) state.
77416
78720
  * * If a disk is in the **In Use** (`In_use`) state, make sure that the ECS instance to which the disk is attached is in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
77417
78721
  * * If a disk is in the **Unattached** (`Available`) state, make sure that the disk has been attached to ECS instances. Snapshots cannot be created for disks that have never been attached to an ECS instance.
77418
- * * Snapshot-consistent groups can be used to create snapshots only for enhanced SSDs (ESSDs).
78722
+ * * Snapshot-consistent groups can be used to create snapshots only for Enterprise SSDs (ESSDs), ESSD AutoPL disks, and ESSD Entry disks.
77419
78723
  * * A snapshot-consistent group can contain snapshots of up to 16 disks, including system disks and data disks, and cannot exceed 32 TiB in size.
77420
78724
  * * Snapshots that you created are stored indefinitely until you delete the snapshots. We recommend that you delete unnecessary snapshots on a regular basis to prevent excess snapshot storage fees.
77421
- * * Snapshot-consistent groups cannot be created for disks for which multi-attach feature is enabled. If disks for which the multi-attach feature is enabled are attached to an ECS instance, specify the `ExcludeDiskId.N` parameter to exclude the disks.
78725
+ * * Snapshot-consistent groups cannot be created for disks for which multi-attach feature is enabled. If disks for which the multi-attach feature is enabled are attached to an ECS instance, you must specify the `ExcludeDiskId.N` parameter to exclude the disks.
77422
78726
  * For more information about the snapshot-consistent group feature, see [Create a snapshot-consistent group](https://help.aliyun.com/document_detail/199625.html).
77423
78727
  *
77424
78728
  * @param request - CreateSnapshotGroupRequest
@@ -77430,17 +78734,16 @@ export default class Client extends OpenApi {
77430
78734
  * Creates a snapshot-consistent group for the disks of an Elastic Compute Service (ECS) instance. A snapshot-consistent group contains snapshots of one or more disks.
77431
78735
  *
77432
78736
  * @remarks
77433
- * ## [](#)Usage notes
77434
- * You can specify `InstanceId` to create a snapshot-consistent group for disks on a specific (ECS instance. You can also specify `DiskId.N` to create a snapshot-consistent group for multiple disks on multiple ECS instances within the same zone.
77435
- * > You cannot specify both `DiskId.N` and `ExcludeDiskId.N` in the same request. If `InstanceId` is specified, you can use `DiskId.N` to specify only disks on the ECS instance specified by InstanceId and cannot use DiskId.N to specify disks across ECS instances.
78737
+ * You can specify `InstanceId` to create a snapshot-consistent group for disks on a specific ECS instance. You can also specify `DiskId.N` to create a snapshot-consistent group for multiple disks on multiple ECS instances within the same zone.
78738
+ * > You cannot specify both `DiskId.N` and `ExcludeDiskId.N` in the same request. If you specify `InstanceId`, you can use `DiskId.N` to specify only disks on the specified ECS instance and cannot use DiskId.N to specify disks across ECS instances.
77436
78739
  * Take note of the following items:
77437
78740
  * * The disks for which you want to create a snapshot must be in the **In Use** (`In_use`) or **Unattached** (`Available`) state.
77438
78741
  * * If a disk is in the **In Use** (`In_use`) state, make sure that the ECS instance to which the disk is attached is in the **Running** (`Running`) or **Stopped** (`Stopped`) state.
77439
78742
  * * If a disk is in the **Unattached** (`Available`) state, make sure that the disk has been attached to ECS instances. Snapshots cannot be created for disks that have never been attached to an ECS instance.
77440
- * * Snapshot-consistent groups can be used to create snapshots only for enhanced SSDs (ESSDs).
78743
+ * * Snapshot-consistent groups can be used to create snapshots only for Enterprise SSDs (ESSDs), ESSD AutoPL disks, and ESSD Entry disks.
77441
78744
  * * A snapshot-consistent group can contain snapshots of up to 16 disks, including system disks and data disks, and cannot exceed 32 TiB in size.
77442
78745
  * * Snapshots that you created are stored indefinitely until you delete the snapshots. We recommend that you delete unnecessary snapshots on a regular basis to prevent excess snapshot storage fees.
77443
- * * Snapshot-consistent groups cannot be created for disks for which multi-attach feature is enabled. If disks for which the multi-attach feature is enabled are attached to an ECS instance, specify the `ExcludeDiskId.N` parameter to exclude the disks.
78746
+ * * Snapshot-consistent groups cannot be created for disks for which multi-attach feature is enabled. If disks for which the multi-attach feature is enabled are attached to an ECS instance, you must specify the `ExcludeDiskId.N` parameter to exclude the disks.
77444
78747
  * For more information about the snapshot-consistent group feature, see [Create a snapshot-consistent group](https://help.aliyun.com/document_detail/199625.html).
77445
78748
  *
77446
78749
  * @param request - CreateSnapshotGroupRequest
@@ -78842,7 +80145,7 @@ export default class Client extends OpenApi {
78842
80145
  */
78843
80146
  describeDiagnosticReports(request: DescribeDiagnosticReportsRequest): Promise<DescribeDiagnosticReportsResponse>;
78844
80147
  /**
78845
- * Queries the key used for default encryption of cloud disks in a region.
80148
+ * Queries the Key Management Service (KMS) key used by the Account-level Elastic Block Storage (EBS) Default Encryption feature in a region.
78846
80149
  *
78847
80150
  * @param request - DescribeDiskDefaultKMSKeyIdRequest
78848
80151
  * @param runtime - runtime options for this request RuntimeOptions
@@ -78850,7 +80153,7 @@ export default class Client extends OpenApi {
78850
80153
  */
78851
80154
  describeDiskDefaultKMSKeyIdWithOptions(request: DescribeDiskDefaultKMSKeyIdRequest, runtime: $Util.RuntimeOptions): Promise<DescribeDiskDefaultKMSKeyIdResponse>;
78852
80155
  /**
78853
- * Queries the key used for default encryption of cloud disks in a region.
80156
+ * Queries the Key Management Service (KMS) key used by the Account-level Elastic Block Storage (EBS) Default Encryption feature in a region.
78854
80157
  *
78855
80158
  * @param request - DescribeDiskDefaultKMSKeyIdRequest
78856
80159
  * @returns DescribeDiskDefaultKMSKeyIdResponse
@@ -80313,10 +81616,9 @@ export default class Client extends OpenApi {
80313
81616
  */
80314
81617
  describeSendFileResults(request: DescribeSendFileResultsRequest): Promise<DescribeSendFileResultsResponse>;
80315
81618
  /**
80316
- * Queries the information of one or more snapshot-consistent groups.
81619
+ * Queries the information of one or more snapshot-consistent groups, such as the status of the groups, IDs of the instances associated with the groups, and snapshot creation progress.
80317
81620
  *
80318
81621
  * @remarks
80319
- * ## [](#)Usage notes
80320
81622
  * You can specify multiple request parameters to be queried, such as `InstanceId`, `SnapshotGroupId.N`, and `Status.N`. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions.
80321
81623
  *
80322
81624
  * @param request - DescribeSnapshotGroupsRequest
@@ -80325,10 +81627,9 @@ export default class Client extends OpenApi {
80325
81627
  */
80326
81628
  describeSnapshotGroupsWithOptions(request: DescribeSnapshotGroupsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeSnapshotGroupsResponse>;
80327
81629
  /**
80328
- * Queries the information of one or more snapshot-consistent groups.
81630
+ * Queries the information of one or more snapshot-consistent groups, such as the status of the groups, IDs of the instances associated with the groups, and snapshot creation progress.
80329
81631
  *
80330
81632
  * @remarks
80331
- * ## [](#)Usage notes
80332
81633
  * You can specify multiple request parameters to be queried, such as `InstanceId`, `SnapshotGroupId.N`, and `Status.N`. Specified parameters have logical AND relations. Only the specified parameters are included in the filter conditions.
80333
81634
  *
80334
81635
  * @param request - DescribeSnapshotGroupsRequest
@@ -80407,7 +81708,7 @@ export default class Client extends OpenApi {
80407
81708
  */
80408
81709
  describeSnapshotPackage(request: DescribeSnapshotPackageRequest): Promise<DescribeSnapshotPackageResponse>;
80409
81710
  /**
80410
- * Queries all snapshots of an Elastic Compute Service (ECS) instance or a disk. When you call this operation, you can specify parameters, such as InstanceId, DiskId, SnapshotLinkId, and Status, in the request.
81711
+ * Queries the details of all snapshots of an Elastic Compute Service (ECS) instance or a cloud disk. The details include the status of the snapshots, amount of remaining time required to create the snapshots, and the retention period of the automatic snapshots in days.
80411
81712
  *
80412
81713
  * @remarks
80413
81714
  * You can configure multiple request parameters such as `InstanceId`, `DiskId`, and `SnapshotIds` to query snapshots. Configured parameters have logical AND relations. Only the configured parameters are included in the filter conditions.
@@ -80419,7 +81720,7 @@ export default class Client extends OpenApi {
80419
81720
  */
80420
81721
  describeSnapshotsWithOptions(request: DescribeSnapshotsRequest, runtime: $Util.RuntimeOptions): Promise<DescribeSnapshotsResponse>;
80421
81722
  /**
80422
- * Queries all snapshots of an Elastic Compute Service (ECS) instance or a disk. When you call this operation, you can specify parameters, such as InstanceId, DiskId, SnapshotLinkId, and Status, in the request.
81723
+ * Queries the details of all snapshots of an Elastic Compute Service (ECS) instance or a cloud disk. The details include the status of the snapshots, amount of remaining time required to create the snapshots, and the retention period of the automatic snapshots in days.
80423
81724
  *
80424
81725
  * @remarks
80425
81726
  * You can configure multiple request parameters such as `InstanceId`, `DiskId`, and `SnapshotIds` to query snapshots. Configured parameters have logical AND relations. Only the configured parameters are included in the filter conditions.
@@ -80921,7 +82222,11 @@ export default class Client extends OpenApi {
80921
82222
  * Disables account-level default encryption of Elastic Block Storage (EBS) resources in a region. After you disable account-level default encryption of EBS resources in a region, the encryption status of existing disks in the region does not change. When you create a disk, you can still choose to encrypt the disk.
80922
82223
  *
80923
82224
  * @remarks
80924
- * You can use only an Alibaba Cloud account to call this operation.
82225
+ * **Instructions**
82226
+ * * Only Alibaba Cloud accounts can call this operation.
82227
+ * * **Considerations**
82228
+ * * After Account-level EBS Default Encryption is disabled, the encryption status of existing cloud disks is not affected.
82229
+ * * After Account-level EBS Default Encryption is disabled, you can still choose to encrypt new cloud disks when you purchase the disks.
80925
82230
  *
80926
82231
  * @param request - DisableDiskEncryptionByDefaultRequest
80927
82232
  * @param runtime - runtime options for this request RuntimeOptions
@@ -80932,64 +82237,32 @@ export default class Client extends OpenApi {
80932
82237
  * Disables account-level default encryption of Elastic Block Storage (EBS) resources in a region. After you disable account-level default encryption of EBS resources in a region, the encryption status of existing disks in the region does not change. When you create a disk, you can still choose to encrypt the disk.
80933
82238
  *
80934
82239
  * @remarks
80935
- * You can use only an Alibaba Cloud account to call this operation.
82240
+ * **Instructions**
82241
+ * * Only Alibaba Cloud accounts can call this operation.
82242
+ * * **Considerations**
82243
+ * * After Account-level EBS Default Encryption is disabled, the encryption status of existing cloud disks is not affected.
82244
+ * * After Account-level EBS Default Encryption is disabled, you can still choose to encrypt new cloud disks when you purchase the disks.
80936
82245
  *
80937
82246
  * @param request - DisableDiskEncryptionByDefaultRequest
80938
82247
  * @returns DisableDiskEncryptionByDefaultResponse
80939
82248
  */
80940
82249
  disableDiskEncryptionByDefault(request: DisableDiskEncryptionByDefaultRequest): Promise<DisableDiskEncryptionByDefaultResponse>;
80941
82250
  /**
80942
- * @deprecated OpenAPI EipFillParams is deprecated
80943
- *
80944
- * @param request - EipFillParamsRequest
80945
- * @param runtime - runtime options for this request RuntimeOptions
80946
- * @returns EipFillParamsResponse
80947
- */
80948
- eipFillParamsWithOptions(request: EipFillParamsRequest, runtime: $Util.RuntimeOptions): Promise<EipFillParamsResponse>;
80949
- /**
80950
- * @deprecated OpenAPI EipFillParams is deprecated
80951
- *
80952
- * @param request - EipFillParamsRequest
80953
- * @returns EipFillParamsResponse
80954
- */
80955
- eipFillParams(request: EipFillParamsRequest): Promise<EipFillParamsResponse>;
80956
- /**
80957
- * @deprecated OpenAPI EipFillProduct is deprecated
80958
- *
80959
- * @param request - EipFillProductRequest
80960
- * @param runtime - runtime options for this request RuntimeOptions
80961
- * @returns EipFillProductResponse
80962
- */
80963
- eipFillProductWithOptions(request: EipFillProductRequest, runtime: $Util.RuntimeOptions): Promise<EipFillProductResponse>;
80964
- /**
80965
- * @deprecated OpenAPI EipFillProduct is deprecated
80966
- *
80967
- * @param request - EipFillProductRequest
80968
- * @returns EipFillProductResponse
80969
- */
80970
- eipFillProduct(request: EipFillProductRequest): Promise<EipFillProductResponse>;
80971
- /**
80972
- * @deprecated OpenAPI EipNotifyPaid is deprecated
80973
- *
80974
- * @param request - EipNotifyPaidRequest
80975
- * @param runtime - runtime options for this request RuntimeOptions
80976
- * @returns EipNotifyPaidResponse
80977
- */
80978
- eipNotifyPaidWithOptions(request: EipNotifyPaidRequest, runtime: $Util.RuntimeOptions): Promise<EipNotifyPaidResponse>;
80979
- /**
80980
- * @deprecated OpenAPI EipNotifyPaid is deprecated
80981
- *
80982
- * @param request - EipNotifyPaidRequest
80983
- * @returns EipNotifyPaidResponse
80984
- */
80985
- eipNotifyPaid(request: EipNotifyPaidRequest): Promise<EipNotifyPaidResponse>;
80986
- /**
80987
- * Enables account-level default encryption of Elastic Block Storage (EBS) resources in a region. After you enable account-level default encryption of EBS resources in a region, new pay-as-you-go and subscription cloud disks in the region must be encrypted. You can use the default Key Management Service (KMS) key ID for account-level default encryption of EBS resources or specify other KMS key IDs to encrypt the cloud disks. The first time you enable account-level default encryption of EBS resources in a region, the service key in the region is automatically used to encrypt EBS resources. You can call the ModifyDiskDefaultKMSKeyId or ResetDiskDefaultKMSKeyId operation to change the KMS key ID used for account-level default encryption of EBS resources.
82251
+ * Enables the Account-level Elastic Block Storage (EBS) Default Encryption feature in a region.
80988
82252
  *
80989
82253
  * @remarks
80990
- * You can use only an Alibaba Cloud account to call the EnableDiskEncryptionByDefault operation.
80991
- * * Before you call the EnableDiskEncryptionByDefault operation, you must activate KMS.
80992
- * * After you enable the account-level default encryption feature of EBS resources, you can purchase only encrypted cloud disks. For more information, see the [Limits](https://help.aliyun.com/zh/ecs/user-guide/encryption-overview?#59e20ff07fko1) section of the "Encrypt cloud disks" topic.
82254
+ * > The Account-level EBS Default Encryption feature is available only in specific regions and to specific users. To use Account-level EBS Default Encryption, [submit a ticket](https://workorder-intl.console.aliyun.com/console.htm#/ticket/list).
82255
+ * * **Precautions**
82256
+ * * Only Alibaba Cloud accounts can call this operation.
82257
+ * * Before you can enable the Account-level EBS Default Encryption feature in a region, you must [activate Key Management Service (KMS)](https://help.aliyun.com/document_detail/480156.html) in the region.
82258
+ * * After you enable the Account-level EBS Default Encryption feature in a region, you can purchase only encrypted cloud disks in the region. For more information, see the [Limits](~~59643#50de175230erj~~) section of the "Encrypt cloud disks" topic.
82259
+ * * **Considerations**
82260
+ * * After you enable the Account-level EBS Default Encryption feature in a region, new pay-as-you-go and subscription cloud disks in the region must be encrypted. You can use the KMS key configured for the Account-level EBS Default Encryption feature or specify other KMS keys to encrypt the cloud disks.
82261
+ * * The first time you enable the Account-level EBS Default Encryption feature in a region, the service key in the region is automatically used to encrypt EBS resources.
82262
+ * * **Suggestions**
82263
+ * * You can call the [DescribeDiskEncryptionByDefaultStatus](https://help.aliyun.com/document_detail/2851493.html) operation to query whether the Account-level EBS Default Encryption feature is enabled in a region and the [DescribeDiskDefaultKMSKeyId](https://help.aliyun.com/document_detail/2851490.html) operation to query the ID of the KMS key used by the Account-level EBS Default Encryption feature in a region.
82264
+ * * You can call the [ModifyDiskDefaultKMSKeyId](https://help.aliyun.com/document_detail/2851492.html) or [ResetDiskDefaultKMSKeyId](https://help.aliyun.com/document_detail/2851539.html) operation to change or reset the KMS key used by the Account-level EBS Default Encryption feature in a region.
82265
+ * * You can call the [DisableDiskEncryptionByDefault](https://help.aliyun.com/document_detail/2851491.html) operation to disable the Account-level EBS Default Encryption feature in a region.
80993
82266
  *
80994
82267
  * @param request - EnableDiskEncryptionByDefaultRequest
80995
82268
  * @param runtime - runtime options for this request RuntimeOptions
@@ -80997,12 +82270,21 @@ export default class Client extends OpenApi {
80997
82270
  */
80998
82271
  enableDiskEncryptionByDefaultWithOptions(request: EnableDiskEncryptionByDefaultRequest, runtime: $Util.RuntimeOptions): Promise<EnableDiskEncryptionByDefaultResponse>;
80999
82272
  /**
81000
- * Enables account-level default encryption of Elastic Block Storage (EBS) resources in a region. After you enable account-level default encryption of EBS resources in a region, new pay-as-you-go and subscription cloud disks in the region must be encrypted. You can use the default Key Management Service (KMS) key ID for account-level default encryption of EBS resources or specify other KMS key IDs to encrypt the cloud disks. The first time you enable account-level default encryption of EBS resources in a region, the service key in the region is automatically used to encrypt EBS resources. You can call the ModifyDiskDefaultKMSKeyId or ResetDiskDefaultKMSKeyId operation to change the KMS key ID used for account-level default encryption of EBS resources.
82273
+ * Enables the Account-level Elastic Block Storage (EBS) Default Encryption feature in a region.
81001
82274
  *
81002
82275
  * @remarks
81003
- * You can use only an Alibaba Cloud account to call the EnableDiskEncryptionByDefault operation.
81004
- * * Before you call the EnableDiskEncryptionByDefault operation, you must activate KMS.
81005
- * * After you enable the account-level default encryption feature of EBS resources, you can purchase only encrypted cloud disks. For more information, see the [Limits](https://help.aliyun.com/zh/ecs/user-guide/encryption-overview?#59e20ff07fko1) section of the "Encrypt cloud disks" topic.
82276
+ * > The Account-level EBS Default Encryption feature is available only in specific regions and to specific users. To use Account-level EBS Default Encryption, [submit a ticket](https://workorder-intl.console.aliyun.com/console.htm#/ticket/list).
82277
+ * * **Precautions**
82278
+ * * Only Alibaba Cloud accounts can call this operation.
82279
+ * * Before you can enable the Account-level EBS Default Encryption feature in a region, you must [activate Key Management Service (KMS)](https://help.aliyun.com/document_detail/480156.html) in the region.
82280
+ * * After you enable the Account-level EBS Default Encryption feature in a region, you can purchase only encrypted cloud disks in the region. For more information, see the [Limits](~~59643#50de175230erj~~) section of the "Encrypt cloud disks" topic.
82281
+ * * **Considerations**
82282
+ * * After you enable the Account-level EBS Default Encryption feature in a region, new pay-as-you-go and subscription cloud disks in the region must be encrypted. You can use the KMS key configured for the Account-level EBS Default Encryption feature or specify other KMS keys to encrypt the cloud disks.
82283
+ * * The first time you enable the Account-level EBS Default Encryption feature in a region, the service key in the region is automatically used to encrypt EBS resources.
82284
+ * * **Suggestions**
82285
+ * * You can call the [DescribeDiskEncryptionByDefaultStatus](https://help.aliyun.com/document_detail/2851493.html) operation to query whether the Account-level EBS Default Encryption feature is enabled in a region and the [DescribeDiskDefaultKMSKeyId](https://help.aliyun.com/document_detail/2851490.html) operation to query the ID of the KMS key used by the Account-level EBS Default Encryption feature in a region.
82286
+ * * You can call the [ModifyDiskDefaultKMSKeyId](https://help.aliyun.com/document_detail/2851492.html) or [ResetDiskDefaultKMSKeyId](https://help.aliyun.com/document_detail/2851539.html) operation to change or reset the KMS key used by the Account-level EBS Default Encryption feature in a region.
82287
+ * * You can call the [DisableDiskEncryptionByDefault](https://help.aliyun.com/document_detail/2851491.html) operation to disable the Account-level EBS Default Encryption feature in a region.
81006
82288
  *
81007
82289
  * @param request - EnableDiskEncryptionByDefaultRequest
81008
82290
  * @returns EnableDiskEncryptionByDefaultResponse
@@ -82012,12 +83294,12 @@ export default class Client extends OpenApi {
82012
83294
  */
82013
83295
  modifyDiskChargeType(request: ModifyDiskChargeTypeRequest): Promise<ModifyDiskChargeTypeResponse>;
82014
83296
  /**
82015
- * Changes the Key Management Service (KMS) key used for account-level default encryption in a region.
83297
+ * Changes the Key Management Service (KMS) key used by the Account-level Elastic Block Storage (EBS) Default Encryption feature in a region.
82016
83298
  *
82017
83299
  * @remarks
82018
83300
  * Only Alibaba Cloud accounts can call this operation.
82019
- * * Before you can call this operation in a region, you must enable account-level default encryption of Elastic Block Storage (EBS) resources in the region.
82020
- * * The first time you use a custom master key (CMK), you must use the AliyunECSDiskEncryptDefaultRole role to grant Elastic Compute Service (ECS) access to KMS resources. For more information, see [Grant access to KMS keys through RAM roles](https://help.aliyun.com/zh/ecs/access-ecs-encrypted-resources-through-the-ram-role?#b82bf8fbd42t8).
83301
+ * * Before you can call this operation in a region, make sure that the Account-level EBS Default Encryption feature is enabled in the region.
83302
+ * * The first time you use a customer master key (CMK), you must use the `AliyunECSDiskEncryptDefaultRole` role to grant Elastic Compute Service (ECS) access to KMS resources. For more information, see [Grant access to KMS keys through RAM roles](https://help.aliyun.com/document_detail/2838993.html).
82021
83303
  *
82022
83304
  * @param request - ModifyDiskDefaultKMSKeyIdRequest
82023
83305
  * @param runtime - runtime options for this request RuntimeOptions
@@ -82025,12 +83307,12 @@ export default class Client extends OpenApi {
82025
83307
  */
82026
83308
  modifyDiskDefaultKMSKeyIdWithOptions(request: ModifyDiskDefaultKMSKeyIdRequest, runtime: $Util.RuntimeOptions): Promise<ModifyDiskDefaultKMSKeyIdResponse>;
82027
83309
  /**
82028
- * Changes the Key Management Service (KMS) key used for account-level default encryption in a region.
83310
+ * Changes the Key Management Service (KMS) key used by the Account-level Elastic Block Storage (EBS) Default Encryption feature in a region.
82029
83311
  *
82030
83312
  * @remarks
82031
83313
  * Only Alibaba Cloud accounts can call this operation.
82032
- * * Before you can call this operation in a region, you must enable account-level default encryption of Elastic Block Storage (EBS) resources in the region.
82033
- * * The first time you use a custom master key (CMK), you must use the AliyunECSDiskEncryptDefaultRole role to grant Elastic Compute Service (ECS) access to KMS resources. For more information, see [Grant access to KMS keys through RAM roles](https://help.aliyun.com/zh/ecs/access-ecs-encrypted-resources-through-the-ram-role?#b82bf8fbd42t8).
83314
+ * * Before you can call this operation in a region, make sure that the Account-level EBS Default Encryption feature is enabled in the region.
83315
+ * * The first time you use a customer master key (CMK), you must use the `AliyunECSDiskEncryptDefaultRole` role to grant Elastic Compute Service (ECS) access to KMS resources. For more information, see [Grant access to KMS keys through RAM roles](https://help.aliyun.com/document_detail/2838993.html).
82034
83316
  *
82035
83317
  * @param request - ModifyDiskDefaultKMSKeyIdRequest
82036
83318
  * @returns ModifyDiskDefaultKMSKeyIdResponse
@@ -83220,7 +84502,11 @@ export default class Client extends OpenApi {
83220
84502
  */
83221
84503
  modifyVpcAttribute(request: ModifyVpcAttributeRequest): Promise<ModifyVpcAttributeResponse>;
83222
84504
  /**
83223
- * 购买一个准备完毕的弹性保障包
84505
+ * Purchases an elasticity assurance that is not in the Active state and for which resources are prepared.
84506
+ *
84507
+ * @remarks
84508
+ * Before you call this operation, familiarize yourself with the billing rules and [pricing](https://www.alibabacloud.com/zh?spm=5176.28117011.nav-v2-dropdown-language.exp-location-zh.9ae4165bF98IHz&_p_lc=1) of elasticity assurances.
84509
+ * Before you purchase an elasticity assurance, you can call the [DescribeElasticityAssurances](https://help.aliyun.com/document_detail/2679748.html) operation to query the elasticity assurances that you can purchase.
83224
84510
  *
83225
84511
  * @param request - PurchaseElasticityAssuranceRequest
83226
84512
  * @param runtime - runtime options for this request RuntimeOptions
@@ -83228,7 +84514,11 @@ export default class Client extends OpenApi {
83228
84514
  */
83229
84515
  purchaseElasticityAssuranceWithOptions(request: PurchaseElasticityAssuranceRequest, runtime: $Util.RuntimeOptions): Promise<PurchaseElasticityAssuranceResponse>;
83230
84516
  /**
83231
- * 购买一个准备完毕的弹性保障包
84517
+ * Purchases an elasticity assurance that is not in the Active state and for which resources are prepared.
84518
+ *
84519
+ * @remarks
84520
+ * Before you call this operation, familiarize yourself with the billing rules and [pricing](https://www.alibabacloud.com/zh?spm=5176.28117011.nav-v2-dropdown-language.exp-location-zh.9ae4165bF98IHz&_p_lc=1) of elasticity assurances.
84521
+ * Before you purchase an elasticity assurance, you can call the [DescribeElasticityAssurances](https://help.aliyun.com/document_detail/2679748.html) operation to query the elasticity assurances that you can purchase.
83232
84522
  *
83233
84523
  * @param request - PurchaseElasticityAssuranceRequest
83234
84524
  * @returns PurchaseElasticityAssuranceResponse
@@ -83609,7 +84899,8 @@ export default class Client extends OpenApi {
83609
84899
  * Renews one or more subscription dedicated hosts.
83610
84900
  *
83611
84901
  * @remarks
83612
- * Valid vouchers can be applied when you renew the subscription plan dedicated hosts. In order to use vouchers, make sure that your account supports the credit card payment method.
84902
+ * ## [](#)Usage notes
84903
+ * When you renew subscription dedicated hosts, vouchers are used first by default. Make sure that your account supports credit card payments or balance payments.
83613
84904
  *
83614
84905
  * @param request - RenewDedicatedHostsRequest
83615
84906
  * @param runtime - runtime options for this request RuntimeOptions
@@ -83620,7 +84911,8 @@ export default class Client extends OpenApi {
83620
84911
  * Renews one or more subscription dedicated hosts.
83621
84912
  *
83622
84913
  * @remarks
83623
- * Valid vouchers can be applied when you renew the subscription plan dedicated hosts. In order to use vouchers, make sure that your account supports the credit card payment method.
84914
+ * ## [](#)Usage notes
84915
+ * When you renew subscription dedicated hosts, vouchers are used first by default. Make sure that your account supports credit card payments or balance payments.
83624
84916
  *
83625
84917
  * @param request - RenewDedicatedHostsRequest
83626
84918
  * @returns RenewDedicatedHostsResponse
@@ -83781,7 +85073,7 @@ export default class Client extends OpenApi {
83781
85073
  */
83782
85074
  resetDisk(request: ResetDiskRequest): Promise<ResetDiskResponse>;
83783
85075
  /**
83784
- * Resets the Key Management Service (KMS) key used for account-level default encryption in a region to the service key.
85076
+ * Resets the Key Management Service (KMS) key used by Account-level Elastic Block Storage (EBS) Default Encryption in a region to the service key.
83785
85077
  *
83786
85078
  * @remarks
83787
85079
  * Only Alibaba Cloud accounts can call this operation.
@@ -83793,7 +85085,7 @@ export default class Client extends OpenApi {
83793
85085
  */
83794
85086
  resetDiskDefaultKMSKeyIdWithOptions(request: ResetDiskDefaultKMSKeyIdRequest, runtime: $Util.RuntimeOptions): Promise<ResetDiskDefaultKMSKeyIdResponse>;
83795
85087
  /**
83796
- * Resets the Key Management Service (KMS) key used for account-level default encryption in a region to the service key.
85088
+ * Resets the Key Management Service (KMS) key used by Account-level Elastic Block Storage (EBS) Default Encryption in a region to the service key.
83797
85089
  *
83798
85090
  * @remarks
83799
85091
  * Only Alibaba Cloud accounts can call this operation.
@@ -84105,121 +85397,57 @@ export default class Client extends OpenApi {
84105
85397
  */
84106
85398
  runCommand(request: RunCommandRequest): Promise<RunCommandResponse>;
84107
85399
  /**
84108
- * Creates one or more pay-as-you-go or subscription Elastic Compute Service (ECS) instances. When you call this operation, you can specify multiple parameters, such as ImageId, InstanceType, SecurityGroupId, and VSwitchId, in the request.
85400
+ * Creates pay-as-you-go or subscription Elastic Compute Service (ECS) instances. This operation provides a wide array of features and functions and 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 them. 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.
84109
85401
  *
84110
85402
  * @remarks
84111
85403
  * ## [](#)Usage notes
84112
- * * **Preparations**:
84113
- * * Cost estimation: Learn about the billing methods of ECS resources. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
84114
- * * Instance type selection: Call the [DescribeInstanceTypes](https://help.aliyun.com/document_detail/25620.html) operation to query the performance data of instance types, or see [Best practices for selecting instance types](https://help.aliyun.com/document_detail/58291.html) to learn about how to select instance types.
84115
- * * Query of available resources: Call the [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) operation to query resources available in a specific region or zone.
84116
- * * Network planning: Make sure that you have security groups available for use. For more information, see [CreateSecurityGroup](https://help.aliyun.com/document_detail/25553.html). Before you create an instance of the Virtual Private Cloud (VPC) type, [create a VPC](https://help.aliyun.com/document_detail/65430.html) in the region where you want to create the instance.
84117
- * * **Comparison with CreateInstance**:
84118
- * RunInstances has the following advantages over CreateInstance:
84119
- * * You can call the RunInstances operation to create up to 100 instances at a time, instead of repeatedly calling the CreateInstance operation.
84120
- * * After an instance is created, the instance enters the `Starting` state and then transitions to the `Running` state. You do not need to call the [StartInstance](https://help.aliyun.com/document_detail/25500.html) operation to start the instance.
84121
- * * When you create an instance, you can specify `InternetMaxBandwidthOut` to assign a public IP address to the instance, without the need to call the [AllocatePublicIpAddress](https://help.aliyun.com/document_detail/25544.html) operation.
84122
- * * You can use `AutoReleaseTime` to set the time when to automatically release the instances, without the need to call the [ModifyInstanceAutoReleaseTime](https://help.aliyun.com/document_detail/47576.html) operation.
84123
- * * You can specify `LaunchTemplateId` and `LaunchTemplateVersion` to use a launch template. This way, you do not need to configure a large number of parameters every time you create instances.
84124
- * * You can specify `UniqueSuffix` to batch configure sequential names or hostnames for multiple instances for easy management and retrieval.
84125
- * * When you call the RunInstances operation to create instances, you can configure the enclave-based confidential computing mode and the trusted system mode for the instances.
84126
- * * You can set `NetworkOptions.EnableJumboFrame` to true to enable the Jumbo Frames feature when you create instances. For more information, see [MTUs](https://help.aliyun.com/document_detail/200512.html).
84127
- * * **Considerations**:
84128
- * * You can create up to 100 instances at a time.
84129
- * * You can use `AutoReleaseTime` to set the time when to automatically release the instances.
84130
- * * After you create instances and obtain their IDs, you can call the [DescribeInstances](https://help.aliyun.com/document_detail/25506.html) operation to check the status of the instances.
84131
- * * By default, instances automatically start after they are created. Instances are ready for use when they are in the Running (`Running`) state.
84132
- * * Starting November 27, 2020, the maximum bandwidth value that is available for you to create ECS instances or change ECS instance configurations is subject to the throttling policy of your account. To increase the maximum bandwidth value, submit a ticket. The throttling policy imposes the following constraints: In 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 the total maximum bandwidth value of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
84133
- * * Different from the [CreateInstance](https://help.aliyun.com/document_detail/25499.html) operation, the `RunInstances` operation allows the system to assign public IP addresses to new instances if you set `InternetMaxBandwidthOut` to a value greater than 0.
84134
- * * When you call the RunInstances operation to create an instance, you can use one of the following methods to attach a primary elastic network interface (ENI) to the instance. Take 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.
84135
- * * Specify parameters such as `SecurityGroupId`, `VSwitchId`, `PrivateIpAddress`, `NetworkInterfaceQueueNumber`, and `Ipv6AddressCount` to configure the primary ENI.
84136
- * * 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 attached to the instance. If `NetworkInterface.N.InstanceType` is set to `Secondary` or left empty, the secondary ENI is attached to the instance.
84137
- * * If a parameter is invalid or available resources are insufficient, an error is returned after you call the RunInstances operation. For more information, see the "Error codes" section of this topic.
84138
- * * If the maximum number of instances of the specified instance type that can be created in the specified region or the maximum number of vCPUs for all instance types in a zone is exceeded, the `QuotaExceed.ElasticQuota` error is returned when you call the operation. You can go to the [ECS console](https://ecs.console.aliyun.com/?spm=a2c8b.12215451.favorites.decs.5e3a336aMGTtzy#/privileges/quota) or the [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to request a quota increase.
84139
- * * If the capacity of disks that belong to the specified disk category exceeds the quota limit for the specified zone, the `QuotaExceed.DiskCapacity` error is returned when you call the operation. You can go to the [Quota Center](https://quotas.console.aliyun.com/products/disk/quotas) to view and increase the disk capacity quota.
84140
- * * **Best practices**:
84141
- * * 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 instances. You can call the [CreateAutoProvisioningGroup](https://help.aliyun.com/document_detail/122738.html) operation to create an auto provisioning group to deploy an instance cluster across different zones, different billing methods, and instance families. For more information, see [Use auto provisioning group-related API operations to batch create ECS instances](https://help.aliyun.com/document_detail/200772.html).
84142
- * * You can call the `RunInstances` operation to batch create instances. To better manage and search for the instances, we recommend that you add tags to the instances by specifying `Tag.N.Key` and `Tag.N.Value`. You can also append incremental suffixes (`UniqueSuffix`) to the hostname (`HostName`) and to the instance name (`InstanceName`).
84143
- * * 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](https://help.aliyun.com/document_detail/74686.html) operation to create a launch template. Then, in your request to call the `RunInstances` operation, you can specify `LaunchTemplateId` and `LaunchTemplateVersion` to use the launch template.
84144
- * ### [](#-1)Example 1: Create a subscription instance
84145
- * Use the aliyun_3_x64_20G_alibase_20221102.vhd image to create a one-month subscription instance of the ecs.g7.large instance type in the China (Hangzhou) region, and enable auto-renewal to renew the instance for one month on expiration. The instance uses a 40 GiB enhanced SSD (ESSD) as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
84146
- * http(s)://ecs.aliyuncs.com/?Action=RunInstances
84147
- * &RegionId=cn-hangzhou
84148
- * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
84149
- * &InstanceType=ecs.g7.large
84150
- * &SecurityGroupId=sg-bp150uqocpf9jj70****
84151
- * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
84152
- * &InstanceChargeType=PrePaid
84153
- * &SystemDisk.Size=40
84154
- * &DataDisk.1.Size=100
84155
- * &DataDisk.1.Category=cloud_essd
84156
- * &SystemDisk.Category=cloud_essd
84157
- * &Amount=1
84158
- * &Period=1
84159
- * &PeriodUnit=Month
84160
- * &AutoRenew=true
84161
- * &AutoRenewPeriod=1
84162
- * &HostName=ECS-test
84163
- * &Password=ECS@test1234
84164
- * &InternetMaxBandwidthOut=10
84165
- * &<Common request parameters>
84166
- * ### [](#-2)Example 2: Create a pay-as-you-go instance
84167
- * Use the aliyun_3_x64_20G_alibase_20221102.vhd image to create a pay-as-you-go instance of the ecs.g7.large instance type in the China (Hangzhou) region. The instance uses a 40 GiB ESSD as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
84168
- * http(s)://ecs.aliyuncs.com/?Action=RunInstances
84169
- * &RegionId=cn-hangzhou
84170
- * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
84171
- * &InstanceType=ecs.g7.large
84172
- * &SecurityGroupId=sg-bp150uqocpf9jj70****
84173
- * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
84174
- * &InstanceChargeType=PostPaid
84175
- * &SystemDisk.Size=40
84176
- * &DataDisk.1.Size=100
84177
- * &DataDisk.1.Category=cloud_essd
84178
- * &SystemDisk.Category=cloud_essd
84179
- * &HostName=ECS-test
84180
- * &Password=ECS@test1234
84181
- * &InternetMaxBandwidthOut=10
84182
- * &<Common request parameters>
84183
- * ### [](#-3)Example 3: Create a preemptible instance
84184
- * Use the aliyun_3_x64_20G_alibase_20221102.vhd image to create a preemptible instance of the ecs.g7.large instance type that has a 1-hour protection period in the China (Hangzhou) region. The market price of the instance type at the time of purchase is automatically used as the bidding price. The instance uses a 40 GiB ESSD as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
84185
- * http(s)://ecs.aliyuncs.com/?Action=RunInstances
84186
- * &RegionId=cn-hangzhou
84187
- * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
84188
- * &InstanceType=ecs.g7.large
84189
- * &SecurityGroupId=sg-bp150uqocpf9jj70****
84190
- * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
84191
- * &InstanceChargeType=PostPaid
84192
- * &SystemDisk.Size=40
84193
- * &DataDisk.1.Size=100
84194
- * &DataDisk.1.Category=cloud_essd
84195
- * &SystemDisk.Category=cloud_essd
84196
- * &HostName=ECS-test
84197
- * &Password=ECS@test1234
84198
- * &InternetMaxBandwidthOut=10
84199
- * &SpotStrategy=SpotAsPriceGo
84200
- * &SpotDuration=1
84201
- * &<Common request parameters>
84202
- * ### [](#-4)Example 4: Create a subscription instance on a dedicated host
84203
- * Use the aliyun_3_x64_20G_alibase_20221102.vhd image to create a one-month subscription instance of the ecs.g7.large instance type on the dh-bp12w10wll9xcjq2\\*\\*\\*\\* dedicated host in the China (Hangzhou) region. The instance uses a 40 GiB ESSD as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
84204
- * http(s)://ecs.aliyuncs.com/?Action=RunInstances
84205
- * &RegionId=cn-hangzhou
84206
- * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
84207
- * &InstanceType=ecs.g7.large
84208
- * &SecurityGroupId=sg-bp150uqocpf9jj70****
84209
- * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
84210
- * &InstanceChargeType=PrePaid
84211
- * &Amount=1
84212
- * &Period=1
84213
- * &PeriodUnit=Month
84214
- * &SystemDisk.Size=40
84215
- * &DataDisk.1.Size=100
84216
- * &DataDisk.1.Category=cloud_essd
84217
- * &SystemDisk.Category=cloud_essd
84218
- * &HostName=ECS-test
84219
- * &Password=ECS@test1234
84220
- * &InternetMaxBandwidthOut=10
84221
- * &DedicatedHostId=dh-bp12w10wll9xcjq2****
84222
- * &<Common request parameters>
85404
+ * **Before you call this operation, familiarize yourself with the billing rules and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS resources.**
85405
+ * 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.
85406
+ * * **Prerequisites**:
85407
+ * * Make sure that real-name verification is completed for your Alibaba Cloud account. For more information, see [Real-name verification](https://help.aliyun.com/document_detail/48263.html).
85408
+ * * 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.
85409
+ * * 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).
85410
+ * * **Limits**:
85411
+ * * 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 call this operation multiple times.
85412
+ * * If you set `InternetMaxBandwidthOut` to a value greater than 0, public IP addresses are automatically assigned to the ECS instances to be created.
85413
+ * > Starting November 27, 2020, when you create ECS instances or change ECS instance configurations, the maximum bandwidth value that you can specify is subject to the throttling policy of your account. To increase the maximum bandwidth value, submit a ticket. The throttling policy imposes the following constraints: In 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 the total bandwidth value of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
85414
+ * * **Suggestions**:
85415
+ * * In test scenarios, you can set `DryRun` to true to perform a dry run without performing the actual request.
85416
+ * * You can 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.
85417
+ * * To better manage and search for ECS instances, we recommend that you add tags to the 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`.
85418
+ * * A launch template contains the 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](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.
85419
+ * * In memory-intensive scenarios, you can set `CpuOptions.ThreadsPerCore` to 1 to disable Hyper-Threading (HT) and increase the memory-to-vCPU ratio.
85420
+ * * You can 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).
85421
+ * ## [](#)Sample requests:
85422
+ * 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:
85423
+ * RegionId: Set RegionId to cn-hangzhou, which indicates the China (Hangzhou) region.
85424
+ * ImageId: Specify the ID of an image. Example: aliyun_3_x64_20G_alibase_20221102.vhd.
85425
+ * InstanceType: Specify an instance type. Example: ecs.g7.large.
85426
+ * SecurityGroupId: Specify a security group ID. Example: sg-bp150uqocpf9jj70****.
85427
+ * VSwitchId: Specify a vSwitch ID. Example: vsw-bp1qo7s91cbch5i4l****.
85428
+ * SystemDisk.Size: Specify the size of the system disk. Example: 40.
85429
+ * DataDisk.Size: Specify the size of a data disk. Example: 100.
85430
+ * DataDisk.Category: Specify the category of a data disk. Example: cloud_essd.
85431
+ * SystemDisk.Category: Specify the category of the system disk. Example: cloud_essd.
85432
+ * HostName: Specify a hostname for the instance. Example: ECS-test.
85433
+ * Password: Specify the logon password of the instance. Example: ECS@test1234.
85434
+ * InternetMaxBandwidthOut: Specify the outbound public bandwidth. Example: 10.
85435
+ * Examples on how to create instances of different types based on the preceding parameters:
85436
+ * **Example 1: Create five subscription ECS instances for which auto-renewal is enabled**
85437
+ * Amount: "5".
85438
+ * InstanceChargeType: "PrePaid", which specifies the subscription billing method.
85439
+ * Period: "1".
85440
+ * PeriodUnit: "Month".
85441
+ * AutoRenew: "true", which specifies that auto-renewal is enabled.
85442
+ * AutoRenewPeriod: "1", which specifies a subscription period of one month.
85443
+ * **Example 2: Create 10 pay-as-you-go instances**
85444
+ * Amount: "10".InstanceChargeType: "PostPaid".
85445
+ * SpotStrategy: "NoSpot", which specifies that the instance is created as a pay-as-you-go instance.
85446
+ * **Example 3: Create 20 preemptible instances that have a specified bidding policy and a protection period**
85447
+ * Amount: "20".
85448
+ * InstanceChargeType: "PostPaid".
85449
+ * SpotStrategy: Specify the bidding policy for the instance. Example: SpotAsPriceGo, which specifies that the instance is created as a preemptible instance for which the market price at the time of purchase is automatically used as the bid price.
85450
+ * SpotDuration: "1", which specifies a 1-hour protection period.
84223
85451
  *
84224
85452
  * @param request - RunInstancesRequest
84225
85453
  * @param runtime - runtime options for this request RuntimeOptions
@@ -84227,121 +85455,57 @@ export default class Client extends OpenApi {
84227
85455
  */
84228
85456
  runInstancesWithOptions(request: RunInstancesRequest, runtime: $Util.RuntimeOptions): Promise<RunInstancesResponse>;
84229
85457
  /**
84230
- * Creates one or more pay-as-you-go or subscription Elastic Compute Service (ECS) instances. When you call this operation, you can specify multiple parameters, such as ImageId, InstanceType, SecurityGroupId, and VSwitchId, in the request.
85458
+ * Creates pay-as-you-go or subscription Elastic Compute Service (ECS) instances. This operation provides a wide array of features and functions and 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 them. 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.
84231
85459
  *
84232
85460
  * @remarks
84233
85461
  * ## [](#)Usage notes
84234
- * * **Preparations**:
84235
- * * Cost estimation: Learn about the billing methods of ECS resources. For more information, see [Billing overview](https://help.aliyun.com/document_detail/25398.html).
84236
- * * Instance type selection: Call the [DescribeInstanceTypes](https://help.aliyun.com/document_detail/25620.html) operation to query the performance data of instance types, or see [Best practices for selecting instance types](https://help.aliyun.com/document_detail/58291.html) to learn about how to select instance types.
84237
- * * Query of available resources: Call the [DescribeAvailableResource](https://help.aliyun.com/document_detail/66186.html) operation to query resources available in a specific region or zone.
84238
- * * Network planning: Make sure that you have security groups available for use. For more information, see [CreateSecurityGroup](https://help.aliyun.com/document_detail/25553.html). Before you create an instance of the Virtual Private Cloud (VPC) type, [create a VPC](https://help.aliyun.com/document_detail/65430.html) in the region where you want to create the instance.
84239
- * * **Comparison with CreateInstance**:
84240
- * RunInstances has the following advantages over CreateInstance:
84241
- * * You can call the RunInstances operation to create up to 100 instances at a time, instead of repeatedly calling the CreateInstance operation.
84242
- * * After an instance is created, the instance enters the `Starting` state and then transitions to the `Running` state. You do not need to call the [StartInstance](https://help.aliyun.com/document_detail/25500.html) operation to start the instance.
84243
- * * When you create an instance, you can specify `InternetMaxBandwidthOut` to assign a public IP address to the instance, without the need to call the [AllocatePublicIpAddress](https://help.aliyun.com/document_detail/25544.html) operation.
84244
- * * You can use `AutoReleaseTime` to set the time when to automatically release the instances, without the need to call the [ModifyInstanceAutoReleaseTime](https://help.aliyun.com/document_detail/47576.html) operation.
84245
- * * You can specify `LaunchTemplateId` and `LaunchTemplateVersion` to use a launch template. This way, you do not need to configure a large number of parameters every time you create instances.
84246
- * * You can specify `UniqueSuffix` to batch configure sequential names or hostnames for multiple instances for easy management and retrieval.
84247
- * * When you call the RunInstances operation to create instances, you can configure the enclave-based confidential computing mode and the trusted system mode for the instances.
84248
- * * You can set `NetworkOptions.EnableJumboFrame` to true to enable the Jumbo Frames feature when you create instances. For more information, see [MTUs](https://help.aliyun.com/document_detail/200512.html).
84249
- * * **Considerations**:
84250
- * * You can create up to 100 instances at a time.
84251
- * * You can use `AutoReleaseTime` to set the time when to automatically release the instances.
84252
- * * After you create instances and obtain their IDs, you can call the [DescribeInstances](https://help.aliyun.com/document_detail/25506.html) operation to check the status of the instances.
84253
- * * By default, instances automatically start after they are created. Instances are ready for use when they are in the Running (`Running`) state.
84254
- * * Starting November 27, 2020, the maximum bandwidth value that is available for you to create ECS instances or change ECS instance configurations is subject to the throttling policy of your account. To increase the maximum bandwidth value, submit a ticket. The throttling policy imposes the following constraints: In 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 the total maximum bandwidth value of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
84255
- * * Different from the [CreateInstance](https://help.aliyun.com/document_detail/25499.html) operation, the `RunInstances` operation allows the system to assign public IP addresses to new instances if you set `InternetMaxBandwidthOut` to a value greater than 0.
84256
- * * When you call the RunInstances operation to create an instance, you can use one of the following methods to attach a primary elastic network interface (ENI) to the instance. Take 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.
84257
- * * Specify parameters such as `SecurityGroupId`, `VSwitchId`, `PrivateIpAddress`, `NetworkInterfaceQueueNumber`, and `Ipv6AddressCount` to configure the primary ENI.
84258
- * * 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 attached to the instance. If `NetworkInterface.N.InstanceType` is set to `Secondary` or left empty, the secondary ENI is attached to the instance.
84259
- * * If a parameter is invalid or available resources are insufficient, an error is returned after you call the RunInstances operation. For more information, see the "Error codes" section of this topic.
84260
- * * If the maximum number of instances of the specified instance type that can be created in the specified region or the maximum number of vCPUs for all instance types in a zone is exceeded, the `QuotaExceed.ElasticQuota` error is returned when you call the operation. You can go to the [ECS console](https://ecs.console.aliyun.com/?spm=a2c8b.12215451.favorites.decs.5e3a336aMGTtzy#/privileges/quota) or the [Quota Center](https://quotas.console.aliyun.com/products/ecs/quotas) to request a quota increase.
84261
- * * If the capacity of disks that belong to the specified disk category exceeds the quota limit for the specified zone, the `QuotaExceed.DiskCapacity` error is returned when you call the operation. You can go to the [Quota Center](https://quotas.console.aliyun.com/products/disk/quotas) to view and increase the disk capacity quota.
84262
- * * **Best practices**:
84263
- * * 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 instances. You can call the [CreateAutoProvisioningGroup](https://help.aliyun.com/document_detail/122738.html) operation to create an auto provisioning group to deploy an instance cluster across different zones, different billing methods, and instance families. For more information, see [Use auto provisioning group-related API operations to batch create ECS instances](https://help.aliyun.com/document_detail/200772.html).
84264
- * * You can call the `RunInstances` operation to batch create instances. To better manage and search for the instances, we recommend that you add tags to the instances by specifying `Tag.N.Key` and `Tag.N.Value`. You can also append incremental suffixes (`UniqueSuffix`) to the hostname (`HostName`) and to the instance name (`InstanceName`).
84265
- * * 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](https://help.aliyun.com/document_detail/74686.html) operation to create a launch template. Then, in your request to call the `RunInstances` operation, you can specify `LaunchTemplateId` and `LaunchTemplateVersion` to use the launch template.
84266
- * ### [](#-1)Example 1: Create a subscription instance
84267
- * Use the aliyun_3_x64_20G_alibase_20221102.vhd image to create a one-month subscription instance of the ecs.g7.large instance type in the China (Hangzhou) region, and enable auto-renewal to renew the instance for one month on expiration. The instance uses a 40 GiB enhanced SSD (ESSD) as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
84268
- * http(s)://ecs.aliyuncs.com/?Action=RunInstances
84269
- * &RegionId=cn-hangzhou
84270
- * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
84271
- * &InstanceType=ecs.g7.large
84272
- * &SecurityGroupId=sg-bp150uqocpf9jj70****
84273
- * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
84274
- * &InstanceChargeType=PrePaid
84275
- * &SystemDisk.Size=40
84276
- * &DataDisk.1.Size=100
84277
- * &DataDisk.1.Category=cloud_essd
84278
- * &SystemDisk.Category=cloud_essd
84279
- * &Amount=1
84280
- * &Period=1
84281
- * &PeriodUnit=Month
84282
- * &AutoRenew=true
84283
- * &AutoRenewPeriod=1
84284
- * &HostName=ECS-test
84285
- * &Password=ECS@test1234
84286
- * &InternetMaxBandwidthOut=10
84287
- * &<Common request parameters>
84288
- * ### [](#-2)Example 2: Create a pay-as-you-go instance
84289
- * Use the aliyun_3_x64_20G_alibase_20221102.vhd image to create a pay-as-you-go instance of the ecs.g7.large instance type in the China (Hangzhou) region. The instance uses a 40 GiB ESSD as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
84290
- * http(s)://ecs.aliyuncs.com/?Action=RunInstances
84291
- * &RegionId=cn-hangzhou
84292
- * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
84293
- * &InstanceType=ecs.g7.large
84294
- * &SecurityGroupId=sg-bp150uqocpf9jj70****
84295
- * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
84296
- * &InstanceChargeType=PostPaid
84297
- * &SystemDisk.Size=40
84298
- * &DataDisk.1.Size=100
84299
- * &DataDisk.1.Category=cloud_essd
84300
- * &SystemDisk.Category=cloud_essd
84301
- * &HostName=ECS-test
84302
- * &Password=ECS@test1234
84303
- * &InternetMaxBandwidthOut=10
84304
- * &<Common request parameters>
84305
- * ### [](#-3)Example 3: Create a preemptible instance
84306
- * Use the aliyun_3_x64_20G_alibase_20221102.vhd image to create a preemptible instance of the ecs.g7.large instance type that has a 1-hour protection period in the China (Hangzhou) region. The market price of the instance type at the time of purchase is automatically used as the bidding price. The instance uses a 40 GiB ESSD as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
84307
- * http(s)://ecs.aliyuncs.com/?Action=RunInstances
84308
- * &RegionId=cn-hangzhou
84309
- * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
84310
- * &InstanceType=ecs.g7.large
84311
- * &SecurityGroupId=sg-bp150uqocpf9jj70****
84312
- * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
84313
- * &InstanceChargeType=PostPaid
84314
- * &SystemDisk.Size=40
84315
- * &DataDisk.1.Size=100
84316
- * &DataDisk.1.Category=cloud_essd
84317
- * &SystemDisk.Category=cloud_essd
84318
- * &HostName=ECS-test
84319
- * &Password=ECS@test1234
84320
- * &InternetMaxBandwidthOut=10
84321
- * &SpotStrategy=SpotAsPriceGo
84322
- * &SpotDuration=1
84323
- * &<Common request parameters>
84324
- * ### [](#-4)Example 4: Create a subscription instance on a dedicated host
84325
- * Use the aliyun_3_x64_20G_alibase_20221102.vhd image to create a one-month subscription instance of the ecs.g7.large instance type on the dh-bp12w10wll9xcjq2\\*\\*\\*\\* dedicated host in the China (Hangzhou) region. The instance uses a 40 GiB ESSD as the system disk and a 100 GiB ESSD as a data disk and is automatically assigned private and public IP addresses. The outbound public bandwidth of the instance is 10 Mbit/s. The instance name is ECS-test and the logon password of the instance is ECS@test1234.
84326
- * http(s)://ecs.aliyuncs.com/?Action=RunInstances
84327
- * &RegionId=cn-hangzhou
84328
- * &ImageId=aliyun_3_x64_20G_alibase_20221102.vhd
84329
- * &InstanceType=ecs.g7.large
84330
- * &SecurityGroupId=sg-bp150uqocpf9jj70****
84331
- * &VSwitchId=vsw-bp1qo7s91cbch5i4l****
84332
- * &InstanceChargeType=PrePaid
84333
- * &Amount=1
84334
- * &Period=1
84335
- * &PeriodUnit=Month
84336
- * &SystemDisk.Size=40
84337
- * &DataDisk.1.Size=100
84338
- * &DataDisk.1.Category=cloud_essd
84339
- * &SystemDisk.Category=cloud_essd
84340
- * &HostName=ECS-test
84341
- * &Password=ECS@test1234
84342
- * &InternetMaxBandwidthOut=10
84343
- * &DedicatedHostId=dh-bp12w10wll9xcjq2****
84344
- * &<Common request parameters>
85462
+ * **Before you call this operation, familiarize yourself with the billing rules and [pricing](https://www.aliyun.com/price/product#/ecs/detail) of ECS resources.**
85463
+ * 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.
85464
+ * * **Prerequisites**:
85465
+ * * Make sure that real-name verification is completed for your Alibaba Cloud account. For more information, see [Real-name verification](https://help.aliyun.com/document_detail/48263.html).
85466
+ * * 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.
85467
+ * * 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).
85468
+ * * **Limits**:
85469
+ * * 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 call this operation multiple times.
85470
+ * * If you set `InternetMaxBandwidthOut` to a value greater than 0, public IP addresses are automatically assigned to the ECS instances to be created.
85471
+ * > Starting November 27, 2020, when you create ECS instances or change ECS instance configurations, the maximum bandwidth value that you can specify is subject to the throttling policy of your account. To increase the maximum bandwidth value, submit a ticket. The throttling policy imposes the following constraints: In 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 the total bandwidth value of all instances that use the pay-by-bandwidth billing method for network usage cannot exceed 50 Gbit/s.
85472
+ * * **Suggestions**:
85473
+ * * In test scenarios, you can set `DryRun` to true to perform a dry run without performing the actual request.
85474
+ * * You can 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.
85475
+ * * To better manage and search for ECS instances, we recommend that you add tags to the 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`.
85476
+ * * A launch template contains the 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](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.
85477
+ * * In memory-intensive scenarios, you can set `CpuOptions.ThreadsPerCore` to 1 to disable Hyper-Threading (HT) and increase the memory-to-vCPU ratio.
85478
+ * * You can 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).
85479
+ * ## [](#)Sample requests:
85480
+ * 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:
85481
+ * RegionId: Set RegionId to cn-hangzhou, which indicates the China (Hangzhou) region.
85482
+ * ImageId: Specify the ID of an image. Example: aliyun_3_x64_20G_alibase_20221102.vhd.
85483
+ * InstanceType: Specify an instance type. Example: ecs.g7.large.
85484
+ * SecurityGroupId: Specify a security group ID. Example: sg-bp150uqocpf9jj70****.
85485
+ * VSwitchId: Specify a vSwitch ID. Example: vsw-bp1qo7s91cbch5i4l****.
85486
+ * SystemDisk.Size: Specify the size of the system disk. Example: 40.
85487
+ * DataDisk.Size: Specify the size of a data disk. Example: 100.
85488
+ * DataDisk.Category: Specify the category of a data disk. Example: cloud_essd.
85489
+ * SystemDisk.Category: Specify the category of the system disk. Example: cloud_essd.
85490
+ * HostName: Specify a hostname for the instance. Example: ECS-test.
85491
+ * Password: Specify the logon password of the instance. Example: ECS@test1234.
85492
+ * InternetMaxBandwidthOut: Specify the outbound public bandwidth. Example: 10.
85493
+ * Examples on how to create instances of different types based on the preceding parameters:
85494
+ * **Example 1: Create five subscription ECS instances for which auto-renewal is enabled**
85495
+ * Amount: "5".
85496
+ * InstanceChargeType: "PrePaid", which specifies the subscription billing method.
85497
+ * Period: "1".
85498
+ * PeriodUnit: "Month".
85499
+ * AutoRenew: "true", which specifies that auto-renewal is enabled.
85500
+ * AutoRenewPeriod: "1", which specifies a subscription period of one month.
85501
+ * **Example 2: Create 10 pay-as-you-go instances**
85502
+ * Amount: "10".InstanceChargeType: "PostPaid".
85503
+ * SpotStrategy: "NoSpot", which specifies that the instance is created as a pay-as-you-go instance.
85504
+ * **Example 3: Create 20 preemptible instances that have a specified bidding policy and a protection period**
85505
+ * Amount: "20".
85506
+ * InstanceChargeType: "PostPaid".
85507
+ * SpotStrategy: Specify the bidding policy for the instance. Example: SpotAsPriceGo, which specifies that the instance is created as a preemptible instance for which the market price at the time of purchase is automatically used as the bid price.
85508
+ * SpotDuration: "1", which specifies a 1-hour protection period.
84345
85509
  *
84346
85510
  * @param request - RunInstancesRequest
84347
85511
  * @returns RunInstancesResponse