Auto Scaling:ModifyScalingConfiguration

The ID of the scaling configuration that you want to modify.

Specifies whether the instance is an I/O optimized instance. Valid values:

• none: The instance is not an I/O optimized instance.

• optimized: The instance is an I/O optimization instance.

The preemption policy for pay-as-you-go instances. Valid values:

• NoSpot: a regular pay-as-you-go instance.

• SpotWithPriceLimit: a spot instance with a user-defined maximum hourly price.

• SpotAsPriceGo: a spot instance for which the market price at the time of purchase is automatically used as the bid price.

The name of the scaling configuration. The name must be 2 to 64 characters in length and can contain letters, digits, underscores (_), hyphens (-), and periods (.). It must start with a letter, digit, or Chinese character.

The name of the scaling configuration must be unique within a scaling group in the same region. If you do not specify this parameter, the ID of the scaling configuration is used by default.

The name of the ECS instance that is automatically created by using the scaling configuration.

The hostname of the Elastic Compute Service (ECS) server. A period (.) or a hyphen (-) cannot be used as the first or last character, or used consecutively. In addition, the naming conventions for different types of instances are as follows:

• Windows instances: The hostname must be 2 to 15 characters in length and can contain letters, digits, and hyphens (-). It cannot contain periods (.) or consist entirely of digits.

• Other instances (such as Linux): The hostname must be 2 to 64 characters in length and can contain multiple periods (.). Each segment between two periods (.) can contain letters, digits, and hyphens (-).

The ID of the image file used for automatic creation of instances.

The name of the image. Image names must be unique within a region. If you specify ImageId, ImageName is ignored.

You cannot use ImageName to specify images from Alibaba Cloud Marketplace.

The number of vCPUs. Unit: cores.

You can specify both CPU and Memory to define the range of instance types. For example, CPU=2 and Memory=16 defines all instance types with 2 vCPUs and 16 GiB of memory. Auto Scaling determines the set of active instance types based on factors such as I/O optimization and zones, and then creates instances of the lowest-priced instance type based on sorting by price.

The memory size. Unit: GiB.

You can specify both CPU and Memory to define the range of instance types. For example, CPU=2 and Memory=16 defines all instance types with 2 vCPUs and 16 GiB of memory. Auto Scaling determines the set of active instance types based on factors such as I/O optimization and zones, and then creates instances of the lowest-priced instance type based on sorting by price.

The billing method for network usage. Valid values:

• PayByBandwidth: pay-by-bandwidth. In this case, the value of InternetMaxBandwidthOut specifies the fixed bandwidth value.

• PayByTraffic: pay-by-traffic. In this case, the value of InternetMaxBandwidthOut specifies only the maximum bandwidth, and billing is based on the actual network traffic.

The maximum outbound public bandwidth. Unit: Mbit/s. Valid values: 0 to 100.

Default value: 0.

The category of the system cloud disk. Valid values:

• cloud: basic cloud disk.

• cloud_efficiency: ultra cloud disk.

• cloud_ssd: standard SSD.

• cloud_essd: Enterprise SSD (ESSD).

• ephemeral_ssd: local SSD.

This parameter cannot be specified together with SystemDiskCategories. If neither this parameter nor SystemDiskCategories is specified, a default value is used. If the instance type belongs to Generation I instance families and the instance is not an I/O optimization instance, the default value is cloud. Otherwise, the default value is cloud_efficiency.

The size of the system cloud disk. Unit: GiB. Valid values:

• Basic cloud disk: 20 to 500.

• ESSD:

  • PL0: 1 to 2048.

  • PL1: 20 to 2048.

  • PL2: 461 to 2048.

  • PL3: 1261 to 2048.

• ESSD AutoPL: 1 to 2048.

• Other cloud disk types: 20 to 2048.

The value of this parameter must be greater than or equal to max{1, ImageSize}.

The name of the system cloud disk. The name must be 2 to 128 characters in length and can contain letters, digits, colons (:), underscores (_), and hyphens (-). It must start with a letter or Chinese character and cannot start with http:// or https://. Default value: empty.

The description of the system cloud disk. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

The ID of the automatic snapshot policy applied to the system cloud disk.

The performance level (PL) of the system cloud disk when the disk is an ESSD. Valid values:

• PL0: A single ESSD can deliver up to 10,000 random read/write IOPS.

• PL1: A single ESSD can deliver up to 50,000 random read/write IOPS.

• PL2: A single ESSD can deliver up to 100,000 random read/write IOPS.

• PL3: A single ESSD can deliver up to 1,000,000 random read/write IOPS.

The weight of SLB backend server. Valid values: 1 to 100.

The user data of the ECS instance. The data must be encoded in Base64. The maximum size of the raw data before encoding is 32 KB.

The name of the key pair used to log on to the ECS instance.

• For Windows instances, this parameter is ignored and is empty by default.

• For Linux instances, password-based logon is disabled during initialization.

The name of the RAM role associated with the ECS instance. This name is provided and maintained by RAM. You can call the ListRoles operation to query available RAM roles. For more information about how to create a RAM role, see the CreateRole operation.

Specifies whether to use the password preset in the image. To use this parameter, ensure that a password is configured for the image.

The tags of the ECS instance. Tags are specified as key-value pairs. You can specify up to 20 tags. The following limits apply to Key and Value:

• Key can be up to 64 characters in length and cannot start with aliyun or acs:. It cannot contain http:// or https://. Key cannot be an empty string.

• Value can be up to 128 characters in length and cannot start with aliyun or acs:. It cannot contain http:// or https://. Value can be an empty string.

The ID of the deployment set to which the ECS instance belongs.

The ID of the security group to which the ECS instance belongs. ECS instances in the same security group can access each other.

Specifies whether to override existing data. Valid values:

• true: overrides existing data.

• false: does not override existing data.

The ID of the resource group to which the ECS instance belongs.

The ID of the HPC cluster to which the ECS instance belongs.

The description of the ECS instance. The description must be 2 to 256 characters in length and cannot start with http:// or https://.

The number of randomly generated IPv6 addresses allocated to the elastic network interfaces (ENIs).

Modifies the running mode of a burstable instance. Valid values:

• Standard: standard mode. For more information, see the performance constrained mode section in Overview of burstable instances.

• Unlimited: unlimited mode. For more information, see the unlimited mode section in Overview of burstable instances.

The name of the image family. You can set this parameter to obtain the latest available image from the specified image family for instance creation. If you have specified the ImageId parameter, you cannot specify this parameter.

The zone ID of the ECS instance.

Specifies whether to create the ECS instance on a dedicated host. Because dedicated hosts do not support the creation of spot instances, if you specify the DedicatedHostId parameter, the SpotStrategy and SpotPriceLimit settings in the request are automatically ignored.

You can call the DescribeDedicatedHosts operation to query the list of dedicated host IDs.

Specifies whether the instance on a dedicated host is associated with the dedicated host. Valid values:

• default: The instance is not associated with the dedicated host. When an instance that has the economical mode enabled is restarted, the instance may be placed on another dedicated host in the automatic deployment resource pool if the original dedicated host has insufficient resources.

• host: The instance is associated with the dedicated host. When an instance that has the economical mode enabled is restarted, the instance remains on the original dedicated host. If the original dedicated host has insufficient resources, the instance fails to restart.

Specifies whether to create the instance on a dedicated host. Valid values:

• default: creates an instance that is not on a dedicated host.

• host: creates an instance on a dedicated host. If you do not specify DedicatedHostId, Alibaba Cloud automatically selects a dedicated host for the instance.

The scheduler options.

The private pool option for instance startup. A private pool is generated after an elasticity assurance or capacity reservation takes effect. You can select a private pool when you start an instance. Valid values:

• Open: open mode. The system automatically matches an open private pool. If no matching private pool is available, the public pool is used to start the instance. You do not need to specify PrivatePoolOptions.Id in this mode.

• Target: specified mode. A specified private pool is used to start the instance. If the specified private pool is unavailable, the instance fails to start. In this mode, you must specify the private pool ID, which means PrivatePoolOptions.Id is required.

• None: no private pool is used. The instance does not use any private pool capacity for startup.

The private pool ID, which is the ID of the elasticity assurance or capacity reservation.

The protection period of the spot instance. Unit: hours. Valid values:

• 1: After a spot instance is created, Alibaba Cloud ensures that the instance is not automatically released within 1 hour. After 1 hour, the system compares the bid price with the market price and checks resource availability to determine whether to retain automatic release the instance.

• 0: After a spot instance is created, Alibaba Cloud does not ensure that the instance runs for 1 hour. The system compares the bid price with the market price and checks resource availability to determine whether to retain automatic release the instance.

Default value: 1.

The interruption mode of the spot instance. Currently, only Terminate (default) is supported, which directly releases the instance.

The password of the ECS instance. The password must be 8 to 30 characters in length and must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters. The following special characters are supported:

`()~!@#$%^&*-_+=|{}[]:;'<>,.?/

For Windows instances, the password cannot start with a forward slash (/).

Specifies whether to encrypt the system cloud disk. Valid values:

• true: encrypts the system cloud disk.

• false: does not encrypt the system cloud disk.

Default value: false.

The ID of the KMS key used for the system cloud disk.

The encryption algorithm for the system cloud disk. Valid values:

• AES-256.

• SM4-128.

Default value: AES-256.

The provisioned IOPS (Input/Output Operations Per Second) performance metrics for the system cloud disk.

Specifies whether to enable the burst feature for the system cloud disk. Valid values:

• true: enables the burst feature.

• false: does not enable the burst feature.

<props="china">For more information, see [ESSD AutoPL disks]( ESSD AutoPL cloud disks

Specifies whether the ECS instance uses the ecs-user account to log on. For more information, see Manage the logon name of an ECS instance. Valid values:

• true: The ecs-user account is used.

• false: The ecs-user account is not used.

The release protection property of the instance. Specifies whether the instance can be directly released from the ECS console or by calling the DeleteInstance operation, to prevent accidental deletion. Valid values:

• true: Enables release protection. The instance cannot be directly released from the ECS console or by calling the DeleteInstance operation.

• false: Disables release protection. The instance can be directly released from the ECS console or by calling the DeleteInstance operation.

The storage set ID.

The maximum number of partitions in the storage set. The value must be an integer that is greater than or equal to 2.

The ID of the dedicated host cluster.

Specifies whether to enable the access channel for instance metadata. Valid values:

• enabled: enabled.

• disabled: disabled.

Default value: enabled.

Specifies whether to forcefully use the security-hardened mode (IMDSv2) to access instance metadata. Valid values:

• optional: does not forcefully use the security-hardened mode.

• required: forcefully uses the security-hardened mode. After you set this value, instance metadata cannot be accessed in normal mode.

Default value: optional.

The maximum inbound public bandwidth. Unit: Mbit/s. Valid values:

• If the purchased maximum outbound public bandwidth is less than or equal to 10 Mbit/s: 1 to 10. Default value: 10.

• If the purchased maximum outbound public bandwidth is greater than 10 Mbit/s: 1 to the value of InternetMaxBandwidthOut. Default value: the value of InternetMaxBandwidthOut.

Specifies whether a vSwitch must be selected from the VSwitchIds list for the secondary elastic network interfaces (ENIs) when the VSwitchIds parameter is set for the secondary network interface controller (NIC).

• Strict: strict mode. If no vSwitch in VSwitchIds meets the conditional requirements, instance creation fails.

• Tolerant: tolerant mode. If no vSwitch in VSwitchIds meets the conditional requirements, no secondary network interface controller (NIC) is configured, but the instance is still created as active.

Default value: Strict.