Auto Scaling：ModifyScalingConfiguration

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

Specifies whether to create I/O optimized instances from the scaling configuration. Valid values:

• none: creates non-I/O optimized instances from the scaling configuration.
• optimized: creates I/O optimized instances from the scaling configuration.

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

• NoSpot: The instances are created as regular pay-as-you-go instances.
• SpotWithPriceLimit: The instances are preemptible instances that have a user-defined maximum hourly price.
• SpotAsPriceGo: The instances are preemptible instances 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 (.). The name must start with a letter or a digit.

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

The name of the Elastic Compute Service (ECS) instance that is automatically created by using the scaling configuration.

The hostname of the ECS instance. The hostname cannot start or end with a period (.) or a hyphen (-). The hostname cannot contain consecutive periods (.) or hyphens (-). Naming conventions for different types of instances:

• Windows instances: The hostname must be 2 to 15 characters in length, and can contain letters, digits, and hyphens (-). The hostname cannot contain periods (.) or contain only digits.
• Other instances, such as Linux instances: The hostname must be 2 to 64 characters in length. Separate a hostname into multiple segments with periods (.). Each segment can contain letters, digits, and hyphens (-).

The ID of the image that is used by Auto Scaling to automatically create ECS instances.

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

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

The number of vCPUs.

You can specify the number of vCPUs and the memory size to determine the range of instance types. For example, you can set Cpu to 2 and Memory to 16 to specify instance types that have 2 vCPUs and 16 GiB of memory. If you specify Cpu and Memory, Auto Scaling determines the available instance types based on factors such as I/O optimization requirements and zones. Then, Auto Scaling preferentially creates instances by using the lowest-priced instance type.

The memory size. Unit: GiB.

You can specify the number of vCPUs and the memory size to determine the range of instance types. For example, you can set Cpu to 2 and Memory to 16 to specify instance types that have 2 vCPUs and 16 GiB of memory. If you specify Cpu and Memory, Auto Scaling determines the available instance types based on factors such as I/O optimization requirements and zones. Then, Auto Scaling preferentially creates instances by using the lowest-priced instance type.

The billing method for network usage. Valid values:

• PayByBandwidth: pay-by-bandwidth. You are charged for the bandwidth specified by InternetMaxBandwidthOut.
• PayByTraffic: pay-by-traffic. You are charged for the actual traffic generated. InternetMaxBandwidthOut specifies only the maximum available bandwidth.

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

• If you set InternetChargeType to PayByBandwidth: 0 to 100. If you leave this parameter empty, this parameter is automatically set to 0.
• If you set InternetChargeType to PayByTraffic: 0 to 100. If you leave this parameter empty, an error is returned.

The category of the system disk. Valid values:

• cloud: basic disk.
• cloud_efficiency: ultra disk.
• cloud_ssd: standard SSD.
• cloud_essd: Enterprise SSD (ESSD).
• ephemeral_ssd: local SSD.

If you specify SystemDisk.Category, you cannot specify SystemDiskCategories. If you do not specify SystemDisk.Category or SystemDiskCategories, the default value of SystemDisk.Category is used. The default value for non-I/O optimized instances of Generation I instance families is cloud. The default value for other instances is cloud_efficiency.

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

• If you set SystemDisk.Category to cloud: 20 to 500.
• If you set SystemDisk.Category to cloud_efficiency: 20 to 500.
• If you set SystemDisk.Category to cloud_ssd: 20 to 500.
• If you set SystemDisk.Category to cloud_essd: 20 to 500.
• If you set SystemDisk.Category to ephemeral_ssd: 20 to 500.

The value of SystemDisk.Size must be greater than or equal to max{20, ImageSize}.

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

Default value: null.

The description of the system disk. The description must be 2 to 256 characters in length. The description can contain letters but cannot start with http:// or https://.

The ID of the automatic snapshot policy that you want to apply to the system disk.

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

• PL0: An ESSD can provide up to 10,000 random read/write IOPS.
• PL1: An ESSD can provide up to 50,000 random read/write IOPS.
• PL2: An ESSD can provide up to 100,000 random read/write IOPS.
• PL3: An ESSD can provide up to 1,000,000 random read/write IOPS.

The weight of an ECS instance as a backend server. Valid values: 1 to 100.

The user data of the Elastic Compute Service (ECS) instance. The user data must be encoded in Base64 format. The size of raw data before Base64 encoding cannot exceed 32 KB.

The name of the key pair that you can use to log on to an ECS instance.

• Windows instances do not support this parameter.
• By default, the username and password authentication method is disabled for Linux instances.

The name of the RAM role that you want to attach to the ECS instance. The name is provided and maintained by Resource Access Management (RAM). You can call the ListRoles operation to query the available RAM roles. You can call the CreateRole operation to create RAM roles.

Specifies whether to use the password that is preconfigured in the image. Before you use this parameter, make sure that a password is configured in the image.

The tags of the ECS instance. Specify the tags as key-value pairs. You can specify up to 20 tags. When you specify tag keys and tag values, take note of the following items:

• A tag key can be up to 64 characters in length. The key cannot start with acs: or aliyun, and cannot contain http:// or https://. The tag key cannot be an empty string.
• A tag value can be up to 128 characters in length. The value cannot start with acs: or aliyun, and cannot contain http:// or https://. The tag value can be an empty string.

The ID of the deployment set of the ECS instances that are created by using the scaling configuration.

The ID of the security group with which ECS instances are associated. The ECS instances that are associated with the same security group can access each other.

Specifies whether to override existing data. Valid values:

• true
• false

The ID of the resource group to which the ECS instances belong.

The ID of the Elastic High Performance Computing (E-HPC) cluster to which the ECS instances belong.

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

The number of randomly generated IPv6 addresses that you want to allocate to the elastic network interface (ENI).

The performance mode of burstable instances. Valid values:

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

The name of the image family. If you specify this parameter, the latest custom images that are available in the specified image family are returned. Then, you can use the images to create instances. If you specify ImageId, you cannot specify ImageFamily.

The zone ID of the ECS instances that are created by using the scaling configuration.

The ID of the dedicated host on which you want to create ECS instances. You cannot create preemptible instances on dedicated hosts. If you specify DedicatedHostId, SpotStrategy and SpotPriceLimit are ignored.

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

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

• default: does not associate the instance on the dedicated host with the dedicated host. If you restart an instance that was stopped in Economical Mode and the original dedicated host of the instance has insufficient resources, the instance is automatically deployed to another dedicated host in the automatic deployment resource pool.
• host: associates the instance on a dedicated host with the dedicated host. If you restart an instance that was stopped in Economical Mode, the instance remains on the original dedicated host. If the original dedicated host has insufficient resources, the instance cannot be started.

Specifies whether to create ECS instances on dedicated hosts. Valid values:

• default: creates ECS instances on non-dedicated hosts.
• host: creates ECS instances on dedicated hosts. If you do not specify DedicatedHostId, the system randomly selects a dedicated host for an ECS instance.

The scheduler options.

The type of the private pool that you want to use to start ECS instances. A private pool is generated when an elasticity assurance or a capacity reservation takes effect. You can specify a private pool for Auto Scaling to start ECS instances. Valid values:

• Open: open private pool. Auto Scaling selects a matching open private pool to start ECS instances. If no matching open private pools exist, the resources in the public pool are used. In this case, you do not need to specify PrivatePoolOptions.Id.
• Target: specified private pool. Auto Scaling uses the resources in the specified private pool to start ECS instances. If the specified private pool does not exist, Auto Scaling cannot start ECS instances. If you set this parameter to Target, you must specify PrivatePoolOptions.Id.
• None: no private pool. Auto Scaling does not use the resources of private pools to start ECS instances.

The ID of the private pool. The ID of a private pool is the same as the ID of the elasticity assurance or capacity reservation for which the private pool is generated.

The protection period of preemptible instances. Unit: hours. Valid values:

• 1: After a preemptible instance is created, Alibaba Cloud ensures that the instance is not automatically released within 1 hour. After the 1-hour protection period ends, Alibaba Cloud compares the bidding price with the market price and checks the resource inventory to determine whether to release the instance.
• 0: After a preemptible instance is created, Alibaba Cloud does not ensure that the instance is not automatically released within 1 hour. Alibaba Cloud compares the biding price with the market price and checks the resource inventory to determine whether to release the instance.

Default value: 1.

The interruption mode of the preemptible instance. Default value: Terminate. Set the value to Terminate. This value specifies that the preemptible instance is to be released.

The data disks.

The preemptible instance types.

The instance type. If you specify InstanceTypes, InstanceType is ignored.

Auto Scaling creates instances based on the priorities of instance types. If Auto Scaling cannot create instances by using the instance type that has the highest priority, Auto Scaling creates instances by using the instance type that has the next highest priority.

The instance types.

The IDs of the security groups.

The information about the intelligent configuration settings, which determine the available instance types.

The categories of the system disks. If Auto Scaling cannot create disks by using the disk category of the highest priority, Auto Scaling creates disks by using the disk category of the next highest priority. Valid values:

• cloud: basic disk.
• cloud_efficiency: ultra disk.
• cloud_ssd: standard SSD.
• cloud_essd: ESSD.

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. The following special characters are supported:

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

The password of a Windows instance cannot start with a forward slash (/).

Specifies whether to encrypt the system disk. Valid values:

• true
• false

Default value: false.

The ID of the KMS key that you want to use to encrypt the system disk.

The encryption algorithm of the system disk. Valid values:

• AES-256
• SM4-128

Default value: AES-256.

The IOPS metric that is preconfigured for the system disk.

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

• true
• false

Specifies whether to use ecs-user to log on to an ECS instance created from the scaling configuration. For information about logon usernames, see Manage the logon username of an instance. Valid values:

true

false

Specifies whether to enable the Release Protection feature for ECS instances. If you enable this feature, you cannot directly release the ECS instances in the ECS console or by calling the DeleteInstance operation. Valid values:

• true: enables the Release Protection feature. In this case, you cannot directly release the ECS instances in the ECS console or by calling the DeleteInstance operation.
• false: disables the Release Protection feature. In this case, you can directly release the ECS instances in the ECS console or by calling the DeleteInstance operation.

The priority of the custom ECS instance type + vSwitch combination.

If Auto Scaling cannot create ECS instances by using the custom ECS instance type + vSwitch combination of the highest priority, Auto Scaling creates ECS instances by using the custom ECS instance type + vSwitch combination of the next highest priority.

• Example: The specified order of vSwitches for your scaling group is vsw1 and vsw2, and the specified order of instance types in your scaling configuration is type1 and type 2. In addition, you use CustomPriorities to specify ["vsw2+type2", "vsw1+type2"]. In this example, the vsw2+type2 combination has the highest priority and the vsw2+type1 combination has the lowest priority. The vsw1+type2 combination has a higher priority than the vsw1+type1 combination.

The ENIs.

The ID of the dedicated host cluster.