Auto Scaling:ModifyScalingConfiguration

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

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

• none: The instance is not an I/O optimization 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 created by automatic creation based on the scaling configuration.

The hostname of the Elastic Computing Service (ECS) server. A period (.) or a hyphen (-) cannot be used as the first or last character, or used consecutively. Naming conventions vary based on instance type:

• 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 file. 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.

You can specify both CPU and Memory to define the range of instance types. For example, setting CPU to 2 and Memory to 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 settings and zones, and then creates instances at the lowest price based on sorting by price.

The memory size.

You can specify both CPU and Memory to define the range of instance types. For example, setting CPU to 2 and Memory to 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 settings and zones, and then creates instances at the lowest price based on sorting by price.

The billing method for network usage. Valid values:

• PayByBandwidth: pay-by-bandwidth. The value of InternetMaxBandwidthOut is used as the fixed bandwidth value.

• PayByTraffic: pay-by-traffic. The value of InternetMaxBandwidthOut is used as the peak bandwidth. 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. The DeleteWithInstance property of a basic cloud disk created together with the instance is set to true.

• cloud_efficiency: ultra cloud disk.

• cloud_ssd: standard SSD.

• cloud_essd: ESSD.

• ephemeral_ssd: local SSD.

• cloud_auto: ESSD AutoPL cloud disk.

This parameter cannot be specified together with SystemDiskCategories.N. If neither this parameter nor SystemDiskCategories.N 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 cloud disk: 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}.

Default value: max{40, 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://.

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 that is 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. The name is provided and maintained by RAM. You can call ListRoles to query available RAM roles. For more information about how to create a RAM role, see CreateRole.

Specifies whether to use the password preset in the image. To use this parameter, make sure 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 keys and values:

• A key can be up to 64 characters in length and cannot start with aliyun or acs:. It cannot contain http:// or https://. A key cannot be an empty string when tags are used.

• A value can be up to 128 characters in length and cannot start with aliyun or acs:. It cannot contain http:// or https://. A 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 network interface controller (NIC).

The running mode of the burstable instance. Valid values:

• Standard: standard mode. For more information, see the performance constrained mode section in What are burstable instances?.

• Unlimited: unlimited mode. For more information, see the unlimited mode section in What are burstable instances?.

The name of the image family. You can specify this parameter to obtain the latest available image from the specified image family for instance creation. If you have specified ImageId, 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, the SpotStrategy and SpotPriceLimit settings in the request are automatically ignored when you specify DedicatedHostId.

You can call DescribeDedicatedHosts 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 after it is stopped, the instance is deployed on another 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. When an instance that has the economical mode enabled is restarted after it is stopped, the instance is still deployed 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: 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. After an elasticity assurance or capacity reservation takes effect, a private pool is generated for instances to use during startup. Valid values:

• Open: open mode. The system automatically matches available open private pool capacity. If no matching private pool capacity is available, public pool resources are used. You do not need to specify PrivatePoolOptions.Id.

• Target: specified mode. The instance uses the specified private pool capacity to start. If the specified private pool capacity is unavailable, the instance fails to start. You must specify the private pool ID, which means PrivatePoolOptions.Id is required.

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

The ID of the private pool. The private pool ID is the same as the ID of the elasticity assurance or capacity reservation.

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

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

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

Default value: 1.

The interruption mode of the spot instance. 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: The system cloud disk is encrypted.

• false: The system cloud disk is not encrypted.

Default value: false.

The ID of the Key Management Service (KMS) key used by the system cloud disk.

The encryption algorithm used by the system cloud disk. Valid values:

• AES-256.

• SM4-128.

Default value: AES-256.

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

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

• true: Enabled.

• false: Not enabled.

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

• true: Yes.

• false: No.

The release protection property of the ECS instance. This property applies only to pay-as-you-go instances and specifies whether the instance can be directly released from the ECS console or by calling the DeleteInstance operation. Valid values:

• true: Enables release protection. The instance cannot be directly released from the ECS console or by calling the API operation. This prevents instances created during scale-out from being accidentally deleted.

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

The ID of the storage set.

The maximum number of partitions in the storage set. Valid values: 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: The security-hardened mode is not forcefully used.

• required: The security-hardened mode is forcefully used. 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 outbound public bandwidth is less than or equal to 10 Mbit/s: 1 to 10. Default value: 10.

• If the purchased 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 interface (ENI) when the VSwitchIds parameter is set for the secondary ENI.

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

• Tolerant: tolerant mode. If no vSwitch in the VSwitchIds list meets the requirements, no secondary elastic network interface (ENI) is configured, and the instance is still created.

Default value: Strict.