Auto Scaling:CreateScalingConfiguration

The ID of the scaling group to which the scaling configuration belongs.

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

The name of the image file. Image names are unique within a region. You cannot use this parameter to specify images from Alibaba Cloud Marketplace.

The instance type of the ECS instance. For more information, see Instance families.

The number of vCPUs. Unit: cores.

You can specify both Cpu and Memory to define the range of instance types. For example, you can set Cpu to 2 and Memory to 16 to define all instance types that have 2 vCPUs and 16 GiB of memory. Auto Scaling determines the available instance types based on factors such as I/O optimization and zones, and creates instances with the lowest price sorted by price.

The memory size. Unit: GiB.

You can specify both Cpu and Memory to define the range of instance types. For example, you can set Cpu to 2 and Memory to 16 to define all instance types that have 2 vCPUs and 16 GiB of memory. Auto Scaling determines the available instance types based on factors such as I/O optimization and zones, and creates instances with the lowest price sorted by price.

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 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 optimized instance.

The default value is none for instances of retired instance types. The default value is optimized for instances of other instance types.

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 maximum bandwidth. Billing is based on the actual network traffic.

If this parameter is not specified, the default value is PayByBandwidth for the classic network and PayByTraffic for VPC.

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

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

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

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.

• ephemeral_ssd: local SSD.

• cloud_essd: Enterprise SSD (ESSD).

• 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 is a Series I instance type and the instance is not an I/O optimized 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 (-). The name must start with a letter or a 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.

Settings for the performance level (PL) of the system cloud disk when the disk is a standard SSD. 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.

Default value: PL1.

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, digit, or Chinese character.

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

The weight of the ECS instance as a backend server of the associated load balancing instance. Valid values: 1 to 100.

Default value: 50.

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 tag keys and values:

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

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

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 enable security hardening. Valid values:

• Active: Security hardening is enabled. This value is applicable only to public images.

• Deactive: Security hardening is disabled. This value is applicable to all image types.

The name of the ECS instance that is created through automatic creation by using the scaling configuration.

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

• 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 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 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 priced at the market price at the time of purchase.

Default value: NoSpot.

Specifies whether to use the password preset in the image. To use this parameter, make sure that a password is configured for the image. Valid values:

• true: The preset password of the image is used.

• false: The preset password of the image is not used.

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 (/).

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 client token that is used to ensure the idempotence of the request.

You can use the client to generate the token, but 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.

The number of randomly generated IPv6 addresses allocated to the network interface controller (NIC).

The running pattern of the burstable instance. Valid values:

• Standard: standard pattern.

• Unlimited: unlimited pattern.

For more information, see the performance schema 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 the ImageId parameter is already specified, you cannot set 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 the DedicatedHostId parameter.

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, the instance may be placed on another dedicated host in the automatic deployment resource pool if the original dedicated host has insufficient available 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 available resources, the instance fails to restart.

Default value: default.

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

• default: The instance is not created on a dedicated host.

• host: The instance is created on a dedicated host. If you do not specify the DedicatedHostId parameter, Alibaba Cloud automatically selects a dedicated host for the instance.

Default value: default.

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 set the PrivatePoolOptions.Id parameter in this mode.

• Target: specified mode. The instance uses the capacity of the specified private pool to start. If the specified private pool capacity is unavailable, the instance fails to start. In this mode, you must specify the private pool ID. The PrivatePoolOptions.Id parameter is required.

• None: none mode. The instance does not use private pool capacity to start.

The private pool ID, which is 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 for 1 hour. After 1 hour, the system automatically compares the bid price with the marketplace price and checks the resource inventory to determine whether to retain or revoke 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 marketplace price and checks the resource inventory to determine whether to retain or revoke the instance.

Default value: 1.

The interruption pattern of the spot instance. Only Terminate (default) is supported, which directly releases the instance.

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 Key Management Service (KMS) key used for the system cloud disk.

The encryption algorithm used 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 of the system cloud disk.

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

• true: enables the feature.

• false: does not enable the feature.

For more information, see ESSD AutoPL cloud disks.

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.

Default value: false.

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 in Auto Scaling from being accidentally deleted.

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

Default value: false.

The ID of the storage set.

The maximum number of partitions in the storage set. Valid values: integers that are 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: enables the access channel.

• disabled: disables the access channel.

Default value: enabled.

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

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

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

Default value: optional.

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

• 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 elastic network interface (ENI) is set, but the instance is still created with active status.

Default value: Strict.