Modifies a scaling configuration.

Description

If you want to change the name of a scaling configuration in a scaling group, make sure that the new name is unique within the scaling group.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameter

ParameterTypeRequiredExampleDescription
ActionStringNoModifyScalingConfiguration

The operation that you want to perform. Set the value to ModifyScalingConfiguration.

ScalingConfigurationIdStringNoasc-bp16har3jpj6fjbx****

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

IoOptimizedStringNonone

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

  • none: The instance is a non-I/O optimized instance.
  • optimized: The instance is an I/O optimized instance.
SpotStrategyStringNoNoSpot

The preemption policy that you want to apply to pay-as-you-go instances and preemptible instances. Valid values:

  • NoSpot: The instance is created as a pay-as-you-go instance.
  • SpotWithPriceLimit: The instance is created as a preemptible instance with a user-defined maximum hourly price.
  • SpotAsPriceGo: The instance is a preemptible instance for which the market price at the time of purchase is used as the bid price.
ScalingConfigurationNameStringNotest-modify

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 or a digit.

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

InstanceNameStringNoinst****

The name of the Elastic Compute Service (ECS) instance that is created by Auto Scaling based on the scaling configuration.

HostNameStringNohos****

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

  • 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. You can use periods (.) to separate a hostname into multiple segments. Each segment can contain letters, digits, and hyphens (-).
ImageIdStringNocentos6u5_64_20G_aliaegis_2014****.vhd

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

Note If the image that is specified in the scaling configuration contains a system disk and data disks, the data that is stored in the data disks is cleared after you modify the image.
ImageNameStringNosuse11sp3_64_20G_aliaegis_2015****.vhd

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

You cannot use the ImageName parameter to specify images that are purchased from Alibaba Cloud Marketplace.

CpuIntegerNo2

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 the Cpu and Memory parameters, Auto Scaling determines the available instance types based on factors such as I/O optimization requirements and zones. Then, Auto Scaling preferentially creates instances of the instance type that is provided at the lowest price.

Note You can specify CPU and memory specifications to determine the range of instance types only if the Scaling Policy parameter is set to Cost Optimization Policy and no instance type is specified in the scaling configuration.
MemoryIntegerNo16

The memory size.

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 the Cpu and Memory parameters, Auto Scaling determines the available instance types based on factors such as I/O optimization requirements and zones. Then, Auto Scaling preferentially creates instances of the instance type that is provided at the lowest price.

Note You can specify CPU and memory specifications to determine the range of instance types only if the Scaling Policy parameter is set to Cost Optimization Policy and no instance type is specified in the scaling configuration.
InternetChargeTypeStringNoPayByBandwidth

The billing method for network usage. Valid values:

  • PayByBandwidth: You are charged for the maximum available bandwidth that is specified by the InternetMaxBandwidthOut parameter.
  • PayByTraffic: You are charged for the actual traffic that is used. The InternetMaxBandwidthOut parameter specifies only the maximum available bandwidth.
InternetMaxBandwidthOutIntegerNo50

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

  • If you set the InternetChargeType parameter to PayByBandwidth and you leave this parameter empty, this parameter is automatically set to 0.
  • If you set the InternetChargeType parameter to PayByTraffic and you leave this parameter empty, an error is reported.
SystemDisk.CategoryStringNocloud_efficiency

The category of the system disk. Valid values:

  • cloud: basic disk
  • cloud_efficiency: ultra disk
  • cloud_ssd: standard SSD
  • cloud_essd: enhanced SSD (ESSD)
  • ephemeral_ssd: local standard SSD
  • cloud_auto: ESSD AutoPL disk

You cannot specify the SystemDisk.Category and SystemDiskCategories.N parameters at the same time. If you do not specify the SystemDisk.Category or SystemDiskCategories.N parameters, the default value of the SystemDisk.Category parameter is used. The default value of this parameter for non-I/O optimized instances of Generation I instance types is cloud. The default value of this parameter for instances of other types is cloud_efficiency.

SystemDisk.SizeIntegerNo50

The size of the system disk. Unit: GiB.

  • Valid values if you set the SystemDisk.Category parameter to cloud: 20 to 500.
  • Valid values if you set the SystemDisk.Category parameter to cloud_efficiency: 20 to 500
  • Valid values if you set the SystemDisk.Category parameter to cloud_ssd: 20 to 500
  • Valid values if you set the SystemDisk.Category parameter to cloud_essd: 20 to 500
  • Valid values if you set the SystemDisk.Category parameter to cloud_essd: 20 to 500

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

SystemDisk.DiskNameStringNocloud_ssdSystem

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

SystemDisk.DescriptionStringNoTest system disk.

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

SystemDisk.AutoSnapshotPolicyIdStringNosp-bp12m37ccmxvbmi5****

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

SystemDisk.PerformanceLevelStringNoPL0

The performance level (PL) of the system disk of the ESSD category. Valid values:

  • PL0: An ESSD can deliver up to 10,000 random read/write IOPS.
  • PL1: An ESSD can deliver up to 50,000 random read/write IOPS.
  • PL2: An ESSD can deliver up to 100,000 random read/write IOPS.
  • PL3: An ESSD can deliver up to 1,000,000 random read/write IOPS.
Note For more information about how to select ESSD PLs, see ESSDs.
LoadBalancerWeightIntegerNo.50

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

UserDataStringNoecho hello ecs!

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

KeyPairNameStringNoKeyPair_Name

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

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

The name of the RAM role that is associated with 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. For more information about how to create a RAM role, see CreateRole.

PasswordInheritBooleanNofalse

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

TagsStringNo{"key1":"value1","key2":"value2", ... "key5":"value5"}

The tags of the ECS instance. The tags must be specified in the key-value format. You can specify up to 20 tags. The following rules apply to tag keys and tag values:

  • 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://. You cannot specify an empty string as a tag key.
  • 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://. You can specify an empty string as a tag value.
DeploymentSetIdStringNods-bp13v7bjnj9gis****

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

SecurityGroupIdStringNosg-F876F****

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

OverrideBooleanNotrue

Specifies whether to overwrite existing data. Valid values:

  • true
  • false
ResourceGroupIdStringNoabcd1234abcd****

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

HpcClusterIdStringNohpc-clusterid

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

InstanceDescriptionStringNoTest instance.

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

Ipv6AddressCountIntegerNo1

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

CreditSpecificationStringNoStandard

The performance mode of the burstable instance. Valid values:

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

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

ZoneIdStringNocn-hangzhou-g

The zone ID of the ECS instance.

DedicatedHostIdStringNodh-bp67acfmxazb4p****

The ID of the dedicated host on which you want to create the ECS instance. Preemptible instances cannot be created on dedicated hosts. If you specify the DedicatedHostId parameter, the SpotStrategy and SpotPriceLimit parameters are ignored.

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

AffinityStringNodefault

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

  • default: does not associate the instance with the dedicated host. If you start 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 with the dedicated host. If you start 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.
TenancyStringNodefault

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

  • default: does not create the instance on a dedicated host.
  • host: creates the instance on a dedicated host. If you do not specify the DedicatedHostId parameter, the system selects a dedicated host for the instance.
SchedulerOptionsMapNo["testManagedPrivateSpaceId****"]

The options of the scheduler.

PrivatePoolOptions.MatchCriteriaStringNoOpen

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

  • Open: open private pool. The system selects a matching open private pool to start the instance. If no matching open private pools are found, the resources in the public pool are used. In this case, you do not need to specify the PrivatePoolOptions.Id parameter.
  • Target: specified private pool. The resources in the specified private pool are used to start the instance. If the specified private pool is unavailable, the instance cannot be started. If you set this parameter to Target, you must specify the PrivatePoolOptions.Id parameter.
  • None: no private pool. The resources in private pools are not used to start the instance.
PrivatePoolOptions.IdStringNoeap-bp67acfmxazb4****

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.

SpotDurationIntegerNo1

The retention period of the preemptible instance. Unit: hours. Valid values: 0, 1, 2, 3, 4, 5, and 6.

  • The following retention periods are available in invitational preview: 2, 3, 4, 5, and 6 hours. If you want to set this parameter to one of these values, submit a ticket.
  • If you set this parameter to 0, no retention period is specified for the preemptible instance.
SpotInterruptionBehaviorStringNoTerminate

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

DataDisk.N.PerformanceLevelStringNoPL1

The PL of data disk N that is of the ESSD category. If you set the DataDisk.N.Category parameter to cloud_essd, the N value must be the same as the N value in DataDisk.N.Category. Valid values:

  • PL0: An ESSD can deliver up to 10,000 random read/write IOPS.
  • PL1: An ESSD can deliver up to 50,000 random read/write IOPS.
  • PL2: An ESSD can deliver up to 100,000 random read/write IOPS.
  • PL3: An ESSD can deliver up to 1,000,000 random read/write IOPS.
Note For more information about how to select ESSD PLs, see ESSDs.
DataDisk.N.AutoSnapshotPolicyIdStringNosp-bp19nq9enxqkomib****

The ID of the automatic snapshot policy that you want to apply to data disk N. Valid values of N: 1 to 16.

DataDisk.N.EncryptedStringNofalse

Specifies whether to encrypt data disk N. Valid values of N: 1 to 16. Valid values:

  • true
  • false
DataDisk.N.DescriptionStringNoTest data disk.

The description of data disk N. Valid values of N: 1 to 16. The description must be 2 to 256 characters in length. The description can contain letters but cannot start with http:// or https://.

DataDisk.N.SnapshotIdStringNos-snapshot****

The ID of the snapshot that you want to use to create data disk N. Valid values of N: 1 to 16. If you specify this parameter, the DataDisk.N.Size parameter is ignored. The size of the disk is the same as the size of the specified snapshot.

If you specify a snapshot created on or before July 15, 2013, the operation fails and the system returns InvalidSnapshot.TooOld.

DataDisk.N.Categories.NStringNocloud

Category N of data disk N. The first N in DataDisk.N.Categories.N represents the serial number of the data disk. Valid values of N: 1 to 16. The second N in DataDisk.N.Categories.N represents the serial number of the category of data disk N. Valid values of N: 1 to 4. You can specify up to four data disk categories in a scaling configuration. A smaller value of N specifies a higher priority. If Auto Scaling cannot create instances by using the disk that has the highest priority, Auto Scaling creates instances by using the disk that has the next highest priority. Valid values:

  • cloud: basic disk. The DeleteWithInstance attribute of a basic disk that is created together with the instance is set to true.
  • cloud_efficiency: ultra disk.
  • cloud_ssd: standard SSD.
  • cloud_essd: ESSD.
Note You cannot specify the DataDisk.N.Categories.N and DataDisk.N.Category parameters at the same time.
DataDisk.N.SizeIntegerNo100

The size of data disk N. Unit: GiB. Valid values of N: 1 to 16.

  • Valid values if you set the DataDisk.N.Category parameter to cloud: 5 to 2000.
  • Valid values if you set the DataDisk.N.Category parameter to cloud_efficiency: 20 to 32768.
  • Valid values if you set the DataDisk.N.Category parameter to cloud_essd: 20 to 32768.
  • Valid values if you set the DataDisk.N.Category parameter to ephemeral_ssd: 5 to 800.

The value of the DataDisk.N.Size parameter must be greater than or equal to the size of the snapshot that is specified by the SnapshotId parameter.

DataDisk.N.DeviceStringNo/dev/xvdb

The mount target of data disk N. Valid values of N: 1 to 16. If you do not specify this parameter, the system automatically assigns a mount target when Auto Scaling creates ECS instances. The name of the mount target ranges from /dev/xvdb to /dev/xvdz.

DataDisk.N.DiskNameStringNocloud_ssdData

The name of data disk N. Valid values of N: 1 to 16. 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://.

DataDisk.N.CategoryStringNocloud_ssd

The category of data disk N. Valid values of N: 1 to 16. Valid values:

  • cloud: basic disk. The DeleteWithInstance attribute of a basic disk that is created together with the instance is set to true.
  • cloud_efficiency: ultra disk.
  • cloud_ssd: standard SSD.
  • cloud_essd: ESSD.
  • ephemeral_ssd: local standard SSD.
  • cloud_auto: ESSD AutoPL disk.

You cannot specify the DataDisk.N.Category and DataDisk.N.Categories.N parameters at the same time. If you do not specify the DataDisk.N.Category or DataDisk.N.Categories.N parameters, the default value of the DataDisk.N.Category parameter is used.

  • The default value is cloud_efficiency for I/O optimized instances.
  • The default value is cloud for non-I/O optimized instances.
DataDisk.N.DeleteWithInstanceBooleanNotrue

Specifies whether to release data disk N when the instance to which data disk N is attached is released. Valid values of N: 1 to 16. Valid values:

  • true
  • false

This parameter is available only for independent disks whose DataDisk.N.Category parameter is set to cloud, cloud_efficiency, cloud_ssd, or cloud_essd. If you specify this parameter for disks of other categories, an error is reported.

DataDisk.N.KMSKeyIdStringNo0e478b7a-4262-4802-b8cb-00d3fb40****

The ID of the Key Management Service (KMS) key that is used to encrypt data disk N. Valid values of N: 1 to 16.

DataDisk.N.ProvisionedIopsLongNo100

The preconfigured input/output operations per second (IOPS) for data disk N.

Note IOPS measures the number of read and write operations that an Elastic Block Storage (EBS) device can process per second.
DataDisk.N.BurstingEnabledBooleanNofalse

Specifies whether to enable the burst feature for data disk N. Valid values:

  • true
  • false
    Note This parameter is available only if you set the DataDisk.Category parameter to cloud_auto.
SpotPriceLimit.N.PriceLimitFloatNo0.125

The price limit of preemptible instance N. Valid values of N: 1 to 10. This parameter is available only if you set the SpotStrategy parameter to SpotWithPriceLimit.

SpotPriceLimit.N.InstanceTypeStringNoecs.g6.large

The instance type of preemptible instance N. Valid values of N: 1 to 10. This parameter is available only if you set the SpotStrategy parameter to SpotWithPriceLimit.

InstanceTypes.NStringNoecs.g6.large

Instance type N. If you specify this parameter, the InstanceType parameter is ignored. Valid values of N: 1 to 10.

The first instance type has the highest priority. The priority decreases based on the specified orders of the instance types. Auto Scaling creates instances based on the priorities of instance types. If Auto Scaling cannot create instances of the instance type that has the highest priority, Auto Scaling creates instances of the instance type that has the next highest priority.

InstanceTypeOverride.N.InstanceTypeStringNoecs.c5.xlarge

Instance type N that you want to use to override the instance type that is specified in the launch template. If you want to specify the weighted capacity of instance type N in the scaling configuration, you must specify the InstanceTypeOverride.N.InstanceType parameter and the InstanceTypeOverride.N.WeightedCapacity parameter at the same time.

The InstanceTypeOverride.N.InstanceType parameter specifies instance type N, and the InstanceTypeOverride.N.WeightedCapacity parameter specifies the weighted capacity of the specified instance type in the scaling configuration. Valid values of N: 1 to 10.

Note You cannot specify the InstanceTypeOverride.N.InstanceType and InstanceTypes parameters at the same time.

For information about valid values of InstanceType in InstanceTypeOverride.N.InstanceType, see Instance families.

InstanceTypeOverride.N.WeightedCapacityIntegerNo4

The weight of instance type N. If you want to specify the weighted capacity of instance type N in the scaling configuration, you must specify the InstanceTypeOverride.N.InstanceType parameter and the InstanceTypeOverride.N.WeightedCapacity parameter at the same time. The value of N in the two parameters must be the same.

The weight specifies the capacity of an instance of instance type N in the scaling group. A higher weight specifies that a smaller number of instances of the specified instance type are required to meet the expected capacity requirement.

Performance metrics, such as the number of vCPUs and the memory size of each instance type, may vary. You can specify different weights for different instance types based on your business requirements.

Example:

  • Current capacity: 0
  • Expected capacity: 6
  • Capacity of ecs.c5.xlarge: 4

To meet the expected capacity requirement, Auto Scaling must create two ecs.c5.xlarge instances.

Note The capacity of the scaling group cannot exceed the sum of the maximum number of instances that is specified by the MaxSize parameter and the maximum weight of the instance types.

Valid values of WeightedCapacity in the InstanceTypeOverride.N.WeightedCapacity parameter: 1 to 500.

SecurityGroupIds.NStringNosg-bp18kz60mefs****

The ID of the security group.

InstancePatternInfo.N.CoresIntegerNo2

The number of vCPUs that is provided for instance type N in intelligent configuration mode. This parameter is used to filter the available instance types that meet the specified criteria. For more information, see Overview of instance families. Valid values of N: 1 to 10

Take note of the following items:

  • The InstancePatternInfo.N parameter is available only for scaling groups that reside in virtual private clouds (VPCs).
  • You must specify the InstancePatternInfo.N, InstancePatternInfo.N.Cores, and InstancePatternInfo.N.Memory parameters at the same time.
  • If you specify an instance type by using the InstanceType or InstanceTypes.N parameter, Auto Scaling preferentially uses the instance type that is specified by the InstanceType or InstanceTypes.N parameter for scale-out activities. If the specified instance type does not have sufficient inventory, Auto Scaling creates instances of the instance type that is specified by the InstancePatternInfo.N parameter and provided at the lowest price.
InstancePatternInfo.N.InstanceFamilyLevelStringNoEnterpriseLevel

The instance family level in intelligent configuration mode. This parameter is used to filter available instance types that meet the specified criteria. Valid values:

  • EntryLevel: shared instance type. Instances of this level are cost-effective, but do not provide stable computing performance. Instances of this level are suitable for scenarios in which the CPU utilization is low. For more information, see Shared instance families.
  • EnterpriseLevel: Instances of this level provide stable performance and dedicated resources, and are suitable for business scenarios that require high stability. For more information, see Overview of instance families.
  • CreditEntryLevel: This value is available only for burstable instances. CPU credits are used to ensure computing performance. This level is suitable for scenarios in which the CPU utilization is low but may fluctuate in specific cases. For more information, see Overview of burstable instances

Valid values of N: 1 to 10

InstancePatternInfo.N.MaxPriceFloatNo2

The maximum hourly price for a pay-as-you-go instance or a preemptible instance in intelligent configuration mode. This parameter is used to filter the available instance types that meet the specified criteria. Valid values of N: 1 to 10

Note If you set the SpotStrategy parameter to SpotWithPriceLimit, you must specify this parameter. In other cases, you do not need to specify this parameter.
InstancePatternInfo.N.MemoryFloatNo4

The memory size that is provided for instance type N in intelligent configuration mode. Unit: GiB. This parameter is used to filter the available instance types that meet the specified criteria. For more information, see Overview of instance families. Valid values of N: 1 to 10

InstancePatternInfo.N.Architecture.NStringNoX86

Architecture N of instance type N. Valid values:

  • X86: x86 architecture.
  • Heterogeneous: heterogeneous architecture, such as GPUs and FPGAs.
  • BareMetal: ECS Bare Metal Instance architecture.
  • Arm: ARM architecture.
  • SuperComputeCluster: Super Computing Cluster architecture.

By default, all values are included.

InstancePatternInfo.N.BurstablePerformanceStringNoInclude

Specifies whether to include burstable instance types. Valid values:

  • Exclude: does not include burstable instance types.
  • Include: includes burstable instance types.
  • Required: includes only burstable instance types.

Default value: Include.

InstancePatternInfo.N.ExcludedInstanceType.NStringNoecs.n1.small/ecs.n1.*/*7*

Instance type N that you want to exclude. You can use wildcard characters such as an asterisk (*) to exclude an instance type or an instance family. Examples:

  • ecs.c6.large: excludes the ecs.c6.large instance type
  • ecs.c6.*: excludes the c6 instance family.
Note Separate multiple instance types with forward slashes (/). Example: ecs.n1.small/ecs.n1.*/*7*.
SystemDiskCategories.NStringNocloud

Category N of the system disk. Valid values of N: 1 to 4. A smaller value of N indicates a higher priority. If Auto Scaling cannot create instances by using the disk that has the highest priority, Auto Scaling creates instances by using the disk that has the next highest priority. Valid values:

  • cloud: basic disk
  • cloud_efficiency: ultra disk
  • cloud_ssd: standard SSD
  • cloud_essd: ESSD
Note You cannot specify the SystemDiskCategories.N and SystemDisk.Category parameters at the same time.
SystemDisk.EncryptedBooleanNofalse

Specifies whether to encrypt the system disk. Valid values:

  • true
  • false

Default value: false.

SystemDisk.KMSKeyIdStringNo0e478b7a-4262-4802-b8cb-00d3fb40****

The ID of the KMS key that is used to encrypt the system disk.

SystemDisk.EncryptAlgorithmStringNoAES-256

The encryption algorithm that is used to encrypt the system disk. Valid values:

  • AES-256
  • SM4-128

Default value: AES-256.

SystemDisk.ProvisionedIopsLongNo100

The preconfigured IOPS for the system disk.

Note IOPS measures the number of read and write operations that an EBS device can process per second.
SystemDisk.BurstingEnabledBooleanNofalse

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

  • true
  • false
    Note This parameter is available only if you set the SystemDisk.Category parameter to cloud_auto.

Response parameters

ParameterTypeExampleDescription
RequestIdString473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

The ID of the region.

Examples

Sample requests

http(s)://ess.aliyuncs.com/?Action=ModifyScalingConfiguration
&ScalingConfigurationId=asc-bp16har3jpj6fjbx****
&IoOptimized=none
&SpotStrategy=NoSpot
&ScalingConfigurationName=test-modify
&InstanceName=inst****
&HostName=hos****
&ImageId=centos6u5_64_20G_aliaegis_2014****.vhd
&ImageName=suse11sp3_64_20G_aliaegis_2015****.vhd
&Cpu=2
&Memory=16
&InternetChargeType=PayByBandwidth
&InternetMaxBandwidthOut=50
&SystemDisk.Category=cloud_efficiency
&SystemDisk.Size=50
&SystemDisk.DiskName=cloud_ssdSystem
&SystemDisk.Description=Test system disk.
&SystemDisk.AutoSnapshotPolicyId=sp-bp12m37ccmxvbmi5****
&SystemDisk.PerformanceLevel=PL0
&LoadBalancerWeight=50
&UserData=echo hello ecs!
&KeyPairName=KeyPair_Name
&RamRoleName=RamRoleTest
&PasswordInherit=false
&Tags={"key1":"value1","key2":"value2", ... "key5":"value5"}
&DeploymentSetId=ds-bp13v7bjnj9gis****
&SecurityGroupId=sg-F876F****
&Override=true
&ResourceGroupId=abcd1234abcd****
&HpcClusterId=hpc-clusterid
&InstanceDescription=Test instance.
&Ipv6AddressCount=1
&CreditSpecification=Standard
&ImageFamily=hangzhou-daily-update
&ZoneId=cn-hangzhou-g
&DedicatedHostId=dh-bp67acfmxazb4p****
&Affinity=default
&Tenancy=default
&PrivatePoolOptions.MatchCriteria=Open
&PrivatePoolOptions.Id=eap-bp67acfmxazb4****
&SpotDuration=1
&SpotInterruptionBehavior=Terminate
&DataDisk=[{"PerformanceLevel":"PL1","AutoSnapshotPolicyId":"sp-bp19nq9enxqkomib****","Encrypted":"false","Description":"Test data disk.","SnapshotId":"s-snapshot****","Categories":["cloud"],"Size":100,"Device":"/dev/xvdb","DiskName":"cloud_ssdData","Category":"cloud_ssd","DeleteWithInstance":true,"KMSKeyId":"0e478b7a-4262-4802-b8cb-00d3fb40****","ProvisionedIops":100,"BurstingEnabled":false}]
&SpotPriceLimit=[{"PriceLimit":0.125,"InstanceType":"ecs.g6.large"}]
&InstanceTypes=["ecs.g6.large"]
&InstanceTypeOverride=[{"InstanceType":"ecs.c5.xlarge","WeightedCapacity":4}]
&SecurityGroupIds=["sg-bp18kz60mefs****"]
&InstancePatternInfo=[{"Cores":2,"InstanceFamilyLevel":"EnterpriseLevel","MaxPrice":2.0,"Memory":4.0,"Architecture":["X86"],"BurstablePerformance":"Include","ExcludedInstanceType":["ecs.n1.small/ecs.n1.*/*7*"]}]
&SystemDiskCategories=["cloud"]
&SystemDisk.Encrypted=false
&SystemDisk.KMSKeyId=0e478b7a-4262-4802-b8cb-00d3fb40****
&SystemDisk.EncryptAlgorithm=AES-256
&SystemDisk.ProvisionedIops=100
&SystemDisk.BurstingEnabled=false
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<ModifyScalingConfigurationResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyScalingConfigurationResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Error codes

For a list of error codes, see Service error codes.

HTTP status code

Error code

Error message

Description

403

Forbidden.Unauthorized

A required authorization for the specified action is not supplied.

The error message returned because you are not authorized to perform the operation.

404

InvalidDataDiskSnapshotId.NotFound

Snapshot "XXX" does not exist.

The error message returned because the specified snapshot does not exist.

400

InvalidDataDiskSnapshotId.SizeNotSupported

The capacity of snapshot "XXX" exceeds the size limit of the specified disk category.

The error message returned because the size of the specified snapshot exceeds the maximum size allowed for the specified disk.

404

InvalidImageId.NotFound

The specified image does not exist.

The error message returned because the specified image does not exist.

400

InvalidKeyPairName.NotFound

The specified KeyPairName does not exist in our records.

The error message returned because the specified key pair does not exist.

400

InvalidNetworkType.ForRAMRole

RAMRole can’t be used For classic instance.

The error message returned because the network type of an instance is classic network. The classic network does not support the RamRoleName parameter.

400

InvalidParamter

The specified value of parameter is not valid.

The error message returned because the value that you specified for a parameter is invalid.

400

InvalidScalingConfigurationName.Duplicate

The specified value of parameter is duplicated.

The error message returned because the specified scaling configuration name already exists.

400

InvalidSecurityGroupId.IncorrectNetworkType

The network type of specified Security Group does not support this action.

The error message returned because the network type of the specified security group is different from the network type of the scaling group.

400

InvalidSecurityGroupId.VPCMismatch

The specified security group and the specified virtual switch are not in the same VPC.

The error message returned because the specified security group and vSwitch do not reside in the same VPC.

400

InvalidTags.KeyValue

The specified tags key/value cannot be empty.

The error message returned because no value is specified for the Tags parameter.

400

InvalidTags.ListSize

The specified tags list size cannot be more than "20".

The error message returned because the maximum number of tags that can be specified has been reached.

400

InvalidUserData.Base64FormatInvalid

The specified parameter UserData must be base64 encoded.

The error message returned because the specified user data is not encoded in Base64.

400

InvalidUserData.SizeExceeded

The specified parameter UserData exceeds the size.

The error message returned because the maximum size of the user data has been reached.