ModifyScalingConfiguration

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

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

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

• optimized: The instance is I/O optimized.

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

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

• SpotWithPriceLimit: a spot instance for which you specify the maximum hourly price.

• SpotAsPriceGo: a spot instance for which the system automatically bids based on the current market price.

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

The name of a 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 instances that are automatically created using this scaling configuration.

The hostname of the ECS instance. A period (.) or a hyphen (-) cannot be used as the first or last character of the hostname. Consecutive periods (.) or hyphens (-) are not allowed. The naming conventions for hostnames vary based on the instance operating system:

• For 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 of only digits.

• For other instance types, 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 (-).

The ID of the image file that is used to create the instances.

The name of the image file. The image name must be unique in a region. If you specify `ImageId`, `ImageName` is ignored.

You cannot use `ImageName` to specify a Marketplace image.

The number of vCPUs. Unit: cores.

You can specify both `Cpu` and `Memory` to define a range of instance types. For example, if you set `Cpu` to 2 and `Memory` to 16, all instance types with 2 vCPUs and 16 GiB of memory are matched. Auto Scaling determines the available instance types based on factors such as I/O optimization and zone, and then creates the instance of the lowest-priced instance type.

The memory size. Unit: GiB.

You can specify both `Cpu` and `Memory` to define a range of instance types. For example, if you set `Cpu` to 2 and `Memory` to 16, all instance types with 2 vCPUs and 16 GiB of memory are matched. Auto Scaling determines the available instance types based on factors such as I/O optimization and zone, and then creates the instance of the lowest-priced instance type.

The billing method for network usage. Valid values:

• PayByBandwidth: pay-by-bandwidth. If you set the value to PayByBandwidth, the value of `InternetMaxBandwidthOut` is the selected fixed bandwidth.

• PayByTraffic: pay-by-data-transfer. If you set the value to PayByTraffic, the value of `InternetMaxBandwidthOut` is the maximum bandwidth, and the 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 disk. Valid values:

• cloud: basic disk.

• cloud_efficiency: ultra disk.

• cloud_ssd: standard SSD.

• cloud_essd: ESSD.

• ephemeral_ssd: local SSD.

You cannot specify this parameter and SystemDiskCategories at the same time. If neither this parameter nor SystemDiskCategories is specified, this parameter has a default value. If the instance type is from instance family I and the instance is not I/O optimized, the default value is `cloud`. Otherwise, the default value is `cloud_efficiency`.

The size of the system disk. Unit: GiB. Value range:

• Basic disks: 20 to 500.

• ESSDs:

  • PL0: 1 to 2048.

  • PL1: 20 to 2048.

  • PL2: 461 to 2048.

  • PL3: 1261 to 2048.

• ESSD AutoPL cloud disks: 1 to 2048.

• Other disk categories: 20 to 2048.

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

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

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

The ID of the automatic snapshot policy used for the system disk.

The performance level of the ESSD that is used as the system disk. Valid values:

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

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

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

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

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

The custom data of the ECS instance. The data must be Base64-encoded. The raw data can be up to 32 KB in size.

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

• For Windows instances, this parameter is ignored. The default value is empty.

• For Linux instances, password-based logon is disabled by default.

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

Specifies whether to use the password that is preset in the image. If you use this parameter, make sure that a password is set for the image.

The tags of the ECS instance. You can specify up to 20 tags in key-value pairs. The following limits apply to keys and values:

• A key can be up to 64 characters in length, cannot start with aliyun or acs:, and cannot contain http:// or https://. If you specify tags, the key cannot be an empty string.

• A value can be up to 128 characters in length, cannot start with aliyun or acs:, and cannot contain http:// or https://. The 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 overwrite the parameter. Valid values:

• true: Overwrite the parameter.

• false: Do not overwrite the parameter.

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 English or Chinese characters in length and cannot start with http:// or https://.

The number of randomly generated IPv6 addresses to be assigned to the ENI.

The performance mode of the burstable instance. Valid values:

• Standard: the standard mode. For more information about the instance performance, see the "Performance modes" section in What is a burstable instance?.

• Unlimited: the unlimited mode. For more information about the instance performance, see the "Performance modes" section in What is a burstable instance?.

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

The ID of the zone to which the ECS instance belongs.

Specifies whether to create the ECS instance on a dedicated host. If you specify `DedicatedHostId`, the `SpotStrategy` and `SpotPriceLimit` settings in the request are ignored. This is because dedicated hosts do not support spot instances.

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

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

• default: The instance is not associated with the dedicated host. If you restart an instance that was stopped in economical mode, the instance may be placed on a different dedicated host in the automatic deployment resource pool if the resources of the original dedicated host are insufficient.

• host: The instance is associated with the dedicated host. If you restart an instance that was stopped in economical mode, the instance is still placed on the original dedicated host. If the resources of the original dedicated host are insufficient, the instance fails to restart.

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

• default: Create the instance not on a dedicated host.

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

The scheduling options.

The capacity option of the private pool for starting the instance. The private pool is generated after an Elastic Assurance service or a Capacity Reservation service takes effect. You can select a private pool to start an instance. Valid values:

• Open: open mode. The system automatically matches the instance with an open private pool. If no open private pools are available, the instance is started using public pool resources. You do not need to set the `PrivatePoolOptions.Id` parameter in this mode.

• Target: specified mode. The instance is started using the capacity of a specified private pool. If the specified private pool is unavailable, the instance fails to start. You must specify the private pool ID by setting the `PrivatePoolOptions.Id` parameter in this mode.

• None: no mode. The instance is not started using the capacity of a private pool.

The ID of the private pool. The private pool can be an Elastic Assurance service or a Capacity Reservation service.

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

• 1: Alibaba Cloud ensures that the instance runs for 1 hour and is not automatically released. After 1 hour, the system automatically compares the bid price with the market price and checks the resource inventory to determine whether to retain or release the instance.

• 0: Alibaba Cloud does not ensure that the instance runs for 1 hour after it is created. The system automatically compares the bid price with the market price and checks the resource inventory to determine whether to retain or release the instance.

Default value: 1.

The interruption mode of the spot instance. Currently, only Terminate is supported, which is the default value. This value indicates that the instance is directly released.

The password of the ECS instance. 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. Special characters can be:

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

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

Specifies whether to encrypt the system disk. Valid values:

• true: encrypt the system disk.

• false: do not encrypt the system disk.

Default value: false.

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

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

• AES-256.

• SM4-128.

Default value: AES-256.

The pre-configured IOPS of the system disk.

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

• true: enable.

• false: disable.

For more information, see ESSD AutoPL cloud disks.

Specifies whether to log on to the ECS instance as the ecs-user user. For more information, see Manage logon usernames of ECS instances. Valid values:

true: yes.

false: no.

The release protection attribute of the instance. This parameter specifies whether you can release the instance using the ECS console or by calling the DeleteInstance operation. This prevents the instance from being accidentally released. Valid values:

• true: enables release protection. You cannot release the instance using the ECS console or by calling the DeleteInstance operation.

• false: disables release protection. You can release the instance using the ECS console or by calling the DeleteInstance operation.

The ID of the storage set.

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: enable.

• disabled: disable.

Default value: enabled.

Specifies whether to enforce the security-hardened mode (IMDSv2) when you access instance metadata. Valid values:

• optional: does not enforce the use of IMDSv2.

• required: enforces the use of IMDSv2. If you set the value to `required`, you cannot access instance metadata in normal mode.

Default value: optional.

The maximum inbound public bandwidth. Unit: Mbit/s. Value range:

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

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