Modifies a scaling configuration of the Elastic Compute Service (ECS) type. If a scaling configuration does not meet your business requirements, you can call the ModifyScalingConfiguration operation to modify the 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.
When you call the ModifyScalingConfiguration operation to modify a scaling configuration, you can use only one of the following methods to configure a primary elastic network interface (ENI) in each call. If you use both methods in a call, the call fails and an error message is returned.
Specify
SecurityGroupId
,SecurityGroupIds.N
, andIpv6AddressCount
to configure primary ENI-related information.Specify
NetworkInterfaces.N
to configure primary and secondary ENIs. You must use NetworkInterfaces.N to specify at least one primary ENI. If you setNetworkInterfaces.N.InstanceType
toPrimary
, a primary ENI is configured. If you setNetworkInterfaces.N.InstanceType
toSecondary
or leave the parameter empty, a secondary ENI is configured.NoteIf you use one of the preceding methods to modify ENI information when you call the ModifyScalingConfiguration operation, the ENI information configured by using the other method is cleared.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
Action | String | Yes | ModifyScalingConfiguration | The operation that you want to perform. Set the value to ModifyScalingConfiguration. |
ScalingConfigurationId | String | Yes | asc-bp16har3jpj6fjbx**** | The ID of the scaling configuration that you want to modify. |
IoOptimized | String | No | none | Specifies whether to create I/O optimized ECS instances. Valid values:
|
SpotStrategy | String | No | NoSpot | The preemption policy that you want to apply to pay-as-you-go or preemptible instances. Valid values:
|
ScalingConfigurationName | String | No | test-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 in a region. If you leave this parameter empty, the value of ScalingConfigurationId is used. |
InstanceName | String | No | inst**** | The name series of the ECS instances that Auto Scaling creates based on the scaling configuration. |
HostName | String | No | hos**** | The hostname series of the ECS instances that Auto Scaling creates based on the scaling configuration. A hostname cannot start or end with a period (.) or a hyphen (-). It cannot contain consecutive periods (.) or hyphens (-). Naming conventions:
|
ImageId | String | No | centos6u5_64_20G_aliaegis_2014****.vhd | The ID of the image that Auto Scaling uses to automatically create ECS instances. Note If the image that you specify in the scaling configuration contains system disks and data disks, the data on the data disks is cleared after you modify the image. |
ImageName | String | No | suse11sp3_64_20G_aliaegis_2015****.vhd | The name of the image. The 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. |
Cpu | Integer | No | 2 | The number of vCPUs. You can specify the number of vCPUs and the memory size to define the range of instance types. For example, you can set Cpu to 2 and Memory to 16 to specify the 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. Note You can specify Cpu and Memory to define the range of instance types only if you set Scaling Policy to Cost Optimization Policy and you do not specify an instance type in the scaling configuration. |
Memory | Integer | No | 16 | The memory size. You can specify the number of vCPUs and the memory size to define the range of instance types. For example, you can set Cpu to 2 and Memory to 16 to specify the 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. Note You can specify Cpu and Memory to define the range of instance types only if you set Scaling Policy to Cost Optimization Policy and you do not specify an instance type in the scaling configuration. |
InternetChargeType | String | No | PayByBandwidth | The billing method for network usage. Valid values:
|
InternetMaxBandwidthOut | Integer | No | 50 | The maximum outbound public bandwidth. Unit: Mbit/s. Valid values:
|
SystemDisk.Category | String | No | cloud_efficiency | The category of the system disk. Valid values:
If you specify SystemDisk.Category, you cannot specify |
SystemDisk.Size | Integer | No | 50 | The size of the system disk. Unit: GiB. Valid values:
The value of SystemDisk.Size must be greater than or equal to the value of max{20, ImageSize}. |
SystemDisk.DiskName | String | No | cloud_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 (-). It must start with a letter but cannot start with |
SystemDisk.Description | String | No | Test system disk. | The description of the system disk. The description must be 2 to 256 characters in length. It can contain letters but cannot start with |
SystemDisk.AutoSnapshotPolicyId | String | No | sp-bp12m37ccmxvbmi5**** | The ID of the automatic snapshot policy that you want to apply to the system disk. |
SystemDisk.PerformanceLevel | String | No | PL0 | The performance level (PL) of the system disk of the ESSD category. Valid values:
Note For more information about how to select ESSD PLs, see ESSDs. |
LoadBalancerWeight | Integer | No | 50 | The load balancing weight of each ECS instance. Valid values: 1 to 100. |
UserData | String | No | ZWNobyBoZWxsbyBlY3Mh | The user data of ECS instances. You must encode the user data in the Base64 format. The raw data before Base64 encoding cannot exceed 32 KB in size. |
KeyPairName | String | No | KeyPair_Name | The name of the key pair that you can use to log on to an ECS instance.
|
RamRoleName | String | No | RamRoleTest | The name of the Resource Access Management (RAM) role that you want to attach to the ECS instances. The name is provided and maintained by RAM. You can call the ListRoles operation to query the available RAM roles. You can call the CreateRole operation to create RAM roles. |
PasswordInherit | Boolean | No | false | 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. |
Tags | String | No | {"key1":"value1","key2":"value2", ... "key5":"value5"} | The tags of ECS instances. The tags must be specified in the key-value format. You can specify up to 20 tags for each instance. Take note of the following items when you specify tag keys and tag values:
|
DeploymentSetId | String | No | ds-bp13v7bjnj9gis**** | The ID of the deployment set to which ECS instances belong. |
SecurityGroupId | String | No | sg-F876F**** | The ID of the security group with which ECS instances are associated. ECS instances that are associated with the same security group can communicate with each other. |
Override | Boolean | No | true | Specifies whether to override existing data. Valid values:
|
ResourceGroupId | String | No | abcd1234abcd**** | The ID of the resource group to which ECS instances belong. |
HpcClusterId | String | No | hpc-clusterid | The ID of the Elastic High Performance Computing (E-HPC) cluster to which ECS instances belong. |
InstanceDescription | String | No | Test instance. | The description of ECS instances. The description must be 2 to 256 characters in length. It can contain letters but cannot start with |
Ipv6AddressCount | Integer | No | 1 | The number of randomly generated IPv6 addresses that you want to allocate to the ENI. |
CreditSpecification | String | No | Standard | The performance mode of burstable instances. Valid values:
|
ImageFamily | String | No | hangzhou-daily-update | The name of the image family. You can specify this parameter to obtain the latest available images in the current image family for instance creation. If you specify |
ZoneId | String | No | cn-hangzhou-g | The zone ID of ECS instances. |
DedicatedHostId | String | No | dh-bp67acfmxazb4p**** | The ID of the dedicated host on which you can create ECS instances. Preemptible instances cannot be created on dedicated hosts. If you specify DedicatedHostId, SpotStrategy and SpotPriceLimit are ignored. You can call the DescribeDedicatedHosts operation to query dedicated host IDs. |
Affinity | String | No | default | Specifies whether to associate the ECS instance on a dedicated host with the dedicated host. Valid values:
|
Tenancy | String | No | default | Specifies whether to create ECS instances on dedicated hosts. Valid values:
|
SchedulerOptions | Map | No | ["testManagedPrivateSpaceId****"] | The scheduler options. |
PrivatePoolOptions.MatchCriteria | String | No | Open | 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 select a private pool for Auto Scaling to start ECS instances. Valid values:
|
PrivatePoolOptions.Id | String | No | eap-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. |
SpotDuration | Integer | No | 1 | The protection period of preemptible instances. Unit: hours. Valid values:
Note Alibaba Cloud sends ECS system events to notify you 5 minutes before an instance is released. Preemptible instances are billed by second. We recommend that you specify a protection period based on your business requirements. Default value: 1. |
SpotInterruptionBehavior | String | No | Terminate | The interruption mode of preemptible instances. Default value: Terminate. Set the value to Terminate. This value specifies that Auto Scaling directly releases preemptible instances. |
DataDisk.N.PerformanceLevel | String | No | PL1 | The PL of data disk N of the ESSD category. If you set DataDisk.N.Category to cloud_essd, the value of N in this parameter must be the same as the value of N in DataDisk.N.Category. Valid values:
Note For more information about how to select ESSD PLs, see ESSDs. |
DataDisk.N.AutoSnapshotPolicyId | String | No | sp-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.Encrypted | String | No | false | Specifies whether to encrypt data disk N. Valid values of N: 1 to 16. Valid values of this parameter:
|
DataDisk.N.Description | String | No | Test 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. It can contain letters but cannot start with |
DataDisk.N.SnapshotId | String | No | s-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, DataDisk.N.Size is ignored. The size of the data disk is the same as the size of the specified snapshot. If you specify a snapshot that is created on or before July 15, 2013, the operation fails and InvalidSnapshot.TooOld is returned. |
DataDisk.N.Categories.N | String | No | cloud | 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 the first N: 1 to 16. The second N in DataDisk.N.Categories.N represents the serial number of the data disk category. Valid values of the second N: 1 to 4. A smaller value of N specifies a higher priority. If Auto Scaling cannot create disks by using the disk category that has the highest priority, it creates disks by using the disk category that has the next highest priority. Valid values:
Note If you specify this parameter, you cannot specify |
DataDisk.N.Size | Integer | No | 100 | The size of data disk N. Unit: GiB. Valid values of N: 1 to 16. Valid values:
The size of the data disk must be greater than or equal to the size of the snapshot that is specified by SnapshotId. |
DataDisk.N.Device | String | No | /dev/xvdb | The mount target of data disk N. Valid values of N: 1 to 16. If you leave this parameter empty, 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.DiskName | String | No | cloud_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 (-). It must start with a letter but cannot start with |
DataDisk.N.Category | String | No | cloud_ssd | The category of data disk N. Valid values of N: 1 to 16. Valid values:
If you specify DataDisk.N.Category, you cannot specify
|
DataDisk.N.DeleteWithInstance | Boolean | No | true | 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 of this parameter:
This parameter is available only for independent disks whose DataDisk.N.Category 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.KMSKeyId | String | No | 0e478b7a-4262-4802-b8cb-00d3fb40**** | The ID of the Key Management Service (KMS) key that you want to use to encrypt data disk N. Valid values of N: 1 to 16. |
DataDisk.N.ProvisionedIops | Long | No | 100 | The provisioned IOPS of data disk N. Note IOPS refers to the number of read and write operations that an Elastic Block Storage (EBS) device can process per second. |
DataDisk.N.BurstingEnabled | Boolean | No | false | Specifies whether to enable the Burst feature for data disk N. Valid values:
|
SpotPriceLimit.N.PriceLimit | Float | No | 0.125 | The price limit of preemptible instance N. Valid values of N: 1 to 10. This parameter takes effect only if you set SpotStrategy to SpotWithPriceLimit. |
SpotPriceLimit.N.InstanceType | String | No | ecs.g6.large | The instance type of preemptible instance N. Valid values of N: 1 to 10. This parameter takes effect only if you set SpotStrategy to SpotWithPriceLimit. |
InstanceTypes.N | String | No | ecs.g6.large | Instance type N. If you specify this parameter, InstanceType is ignored. Valid values of N: 1 to 10. The first instance type that is specified by using InstanceTypes.N has the highest priority. The priority decreases based on the specified order of instance types. 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, it creates instances by using the instance type that has the next highest priority. |
InstanceTypeOverride.N.InstanceType | String | No | ecs.c5.xlarge | If you want to specify the weight of instance type N in the scaling configuration, you must specify InstanceTypeOverride.N.InstanceType and InstanceTypeOverride.N.WeightedCapacity. This parameter specifies instance type N. You can use InstanceTypeOverride.N.InstanceType to specify multiple instance types and use InstanceTypeOverride.N.WeightedCapacity to specify the weights of the instance types. Valid values of N: 1 to 10. Note If you specify InstanceTypeOverride.N.InstanceType, you cannot specify InstanceTypes. For information about the valid values of InstanceType in InstanceTypeOverride.N.InstanceType, see Overview of instance families. |
InstanceTypeOverride.N.WeightedCapacity | Integer | No | 4 | If you want to specify the weight of instance type N in the scaling configuration, specify InstanceTypeOverride.N.WeightedCapacity after you specify InstanceTypeOverride.N.InstanceType. The value of N in the two parameters must be the same. This parameter specifies the weight of instance type N. 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 is required to achieve the expected capacity. 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. Examples:
To achieve the expected capacity, Auto Scaling must scale out two ecs.c5.xlarge instances. Note The total capacity of the scaling group cannot exceed the sum of the maximum group size defined by MaxSize and the highest weight assigned to an instance type. Valid values of WeightedCapacity in InstanceTypeOverride.N.WeightedCapacity: 1 to 500. |
SecurityGroupIds.N | String | No | sg-bp18kz60mefs**** | The ID of the security group. |
InstancePatternInfo.N.Cores | Integer | No | 2 | The number of vCPUs that you want to allocate to instance type N in intelligent configuration mode. You can specify this parameter to obtain the instance types that meet the specified criteria. For more information, see Overview of instance families. Valid values of N: 1 to 10. When you specify this parameter, take note of the following items:
|
InstancePatternInfo.N.InstanceFamilyLevel | String | No | EnterpriseLevel | The level of instance type N in intelligent configuration mode. You can specify this parameter to obtain the instance types that meet the specified criteria. Valid values:
Valid values of N: 1 to 10. |
InstancePatternInfo.N.MaxPrice | Float | No | 2 | The maximum price per hour for pay-as-you-go instance N or preemptible instance N in intelligent configuration mode. You can specify this parameter to obtain the instance types that meet the specified criteria. Valid values of N: 1 to 10. Note If you set SpotStrategy to SpotWithPriceLimit, you must specify this parameter. In other cases, this parameter is optional. |
InstancePatternInfo.N.Memory | Float | No | 4 | The memory size of instance type N in intelligent configuration mode. Unit: GiB. You can specify this parameter to obtain the 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.N | String | No | X86 | Architecture N of instance type N. Valid values:
By default, all values are selected. |
InstancePatternInfo.N.BurstablePerformance | String | No | Include | Specifies whether to include burstable instance types. Valid values:
Default value: Include. |
InstancePatternInfo.N.ExcludedInstanceType.N | String | No | ecs.n1.small/ecs.n1.*/*7* | The instance type that you want to exclude. You can use wildcard characters such as an asterisk (*) to exclude an instance type or an instance family. Examples:
Note Separate multiple instance types with forward slashes (/). Example: |
InstancePatternInfo.N.InstanceTypeFamilies.N | String | No | ["ecs.g6", "ecs.c6", … "ecs.r6"] | Instance family N. Valid values of N: 1 to 10. |
InstancePatternInfo.N.MinimumCpuCoreCount | Integer | No | 2 | The minimum number of vCPUs per instance type. |
InstancePatternInfo.N.MaximumCpuCoreCount | Integer | No | 4 | The maximum number of vCPUs per instance type. Note The value of |
InstancePatternInfo.N.GpuSpecs.N | String | No | ["NVIDIA V100"] | The GPU model. |
InstancePatternInfo.N.InstanceCategories.N | String | No | Compute-optimized with GPU | Category N of the instance type. Note Up to 10 categories of ECS instances are supported.
|
InstancePatternInfo.N.CpuArchitectures.N | String | No | ["X86", "ARM"] | CPU architecture N of the instance type. Valid values: Note Up to two CPU architectures are supported.
|
InstancePatternInfo.N.PhysicalProcessorModels.N | String | No | "PhysicalProcessorModels": [ "[\"Intel Xeon(Ice Lake) Platinum 8369B\", \"Intel Xeon(Skylake) Platinum 8163\", … \"Intel Xeon(Cascade Lake) Platinum 8269CY\"]" ], | Processor model N of the instance type. Up to 10 processor models are supported. |
InstancePatternInfo.N.MinimumEniQuantity | Integer | No | 2 | The minimum number of ENIs per instance. |
InstancePatternInfo.N.MinimumEniPrivateIpAddressQuantity | Integer | No | 2 | The minimum number of IPv4 addresses per ENI. |
InstancePatternInfo.N.MinimumEniIpv6AddressQuantity | Integer | No | 1 | The minimum number of IPv6 addresses per ENI. |
InstancePatternInfo.N.MinimumInitialCredit | Integer | No | 12 | The minimum initial vCPU credits per t5 or t6 burstable instance. |
InstancePatternInfo.N.MinimumBaselineCredit | Integer | No | 12 | The minimum baseline vCPU computing performance (overall baseline performance of all vCPUs) per t5 or t6 burstable instance. |
InstancePatternInfo.N.MinimumMemorySize | Float | No | 4 | The minimum memory size per instance. Unit: GiB. |
InstancePatternInfo.N.MaximumMemorySize | Float | No | 4 | The maximum memory size per instance. Unit: GiB. |
InstancePatternInfo.N.MinimumGpuAmount | Integer | No | 2 | The minimum number of GPUs per instance. Valid values: integers greater than or equal to 1. |
InstancePatternInfo.N.MaximumGpuAmount | Integer | No | 2 | The maximum number of GPUs per instance. Valid values: integers greater than or equal to 1. |
SystemDiskCategories.N | String | No | cloud | Category N of the system disk. Valid values of N: 1 to 4. You can specify up to four system disk categories in a scaling configuration. A smaller value of N specifies a higher priority. If Auto Scaling cannot create disks by using the disk category that has the highest priority, it creates disks by using the disk category that has the next highest priority. Valid values:
Note If you specify this parameter, you cannot specify |
Password | String | No | 123abc**** | The password series of ECS instances. A 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 any of the following special characters: |
SystemDisk.Encrypted | Boolean | No | false | Specifies whether to encrypt the system disk. Valid values:
Default value: false. |
SystemDisk.KMSKeyId | String | No | 0e478b7a-4262-4802-b8cb-00d3fb40**** | The ID of the KMS key that you want to use to encrypt the system disk. |
SystemDisk.EncryptAlgorithm | String | No | AES-256 | The algorithm that you want to use to encrypt the system disk. Valid values:
Default value: AES-256. |
SystemDisk.ProvisionedIops | Long | No | 100 | The provisioned IOPS of the system disk. Note IOPS refers to the number of read and write operations that an EBS device can process per second. |
SystemDisk.BurstingEnabled | Boolean | No | false | Specifies whether to enable the Burst feature for the system disk. Valid values:
|
ImageOptions.LoginAsNonRoot | Boolean | No | false | Specifies whether to use ecs-user to log on to an ECS instance. For more information, see Manage the logon username of an instance. Valid values:
|
DeletionProtection | Boolean | No | false | Specifies whether to enable the Release Protection feature for ECS instances. This parameter is available only for pay-as-you-go instances. You can use this parameter to specify whether to directly release ECS instances in the ECS console or by calling the DeleteInstance operation. Valid values:
Note The Release Protection feature does not affect normal scale-in operations. If you enable the Release Protection feature for an ECS instance and the ECS instance meets the requirements defined in the scale-in policy, the ECS instance may still be released during a scale-in event. |
StorageSetId | String | No | ss-bp67acfmxazb4p**** | The ID of the storage set. |
StorageSetPartitionNumber | Integer | No | 2 | The maximum number of partitions in the storage set. Valid values: integers greater than or equal to 2. |
CustomPriorities.N.InstanceType | String | No | ecs.g6.large | You can use Note This parameter takes effect only if you set Scaling Policy to If Auto Scaling cannot create ECS instances by using the ECS instance type + vSwitch combination that has the highest priority, it automatically creates ECS instances by using the ECS instance type + vSwitch combination that has the next highest priority. Note If you specify priorities only for specific ECS instance type + vSwitch combinations, Auto Scaling preferentially uses the combinations that have specified priorities. If the combinations do not provide sufficient resources, Auto Scaling uses the combinations that do not have specified priorities based on the specified orders of vSwitches and instance types. Example: The specified order of vSwitches for a scaling group is vsw1 and vsw2 and the specified order of instance types in the scaling configuration is type1 and type 2. In addition, you use CustomPriorities to specify |
CustomPriorities.N.VswitchId | String | No | vsw-bp14zolna43z266bq**** | You can use Note This parameter takes effect only if you set Scaling Policy to |
NetworkInterfaces.N.InstanceType | String | No | Primary | The ENI type. If you specify this parameter, you must specify
Default value: Secondary. |
NetworkInterfaces.N.NetworkInterfaceTrafficMode | String | No | HighPerformance | The communication mode of the ENI. Valid values:
Default value: Standard. Note The number of ERIs per instance cannot exceed the maximum number of ERIs that the instance type of the instance supports. For more information, see Overview of instance families. |
NetworkInterfaces.N.Ipv6AddressCount | Integer | No | 1 | The number of randomly generated IPv6 addresses that you want to assign to the primary ENI. When you specify this parameter, take note of the following items:
|
NetworkInterfaces.N.SecurityGroupIds.N | String | No | sg-2ze55shrh**** | The IDs of one or more security groups to which ENI N belongs. When you specify this parameter, take note of the following items:
|
DedicatedHostClusterId | String | No | dc-2zedxc67zqzt7lb4**** | The ID of the dedicated host cluster. |
SecurityOptions.ConfidentialComputingMode | String | No | TDX | The confidential computing mode. Valid values:
|
Response parameters
Parameter | Type | Example | Description |
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** | The request ID. |
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=ZWNobyBoZWxsbyBlY3Mh
&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*"],"InstanceTypeFamilies":["[\"ecs.g6\", \"ecs.c6\", … \"ecs.r6\"]"],"MinimumCpuCoreCount":2,"MaximumCpuCoreCount":4,"GpuSpecs":["[\"NVIDIA V100\"]"],"InstanceCategories":["[\"Compute-optimized with GPU\" ]"],"CpuArchitectures":["[\"X86\", \"ARM\"]"],"PhysicalProcessorModels":["[\"Intel Xeon(Ice Lake) Platinum 8369B\", \"Intel Xeon(Skylake) Platinum 8163\", … \"Intel Xeon(Cascade Lake) Platinum 8269CY\"]"],"MinimumEniQuantity":2,"MinimumEniPrivateIpAddressQuantity":2,"MinimumEniIpv6AddressQuantity":1,"MinimumInitialCredit":12,"MinimumBaselineCredit":12,"MinimumMemorySize":4.0,"MaximumMemorySize":4.0,"MinimumGpuAmount":2,"MaximumGpuAmount":2}]
&SystemDiskCategories=["cloud"]
&SystemDisk.Encrypted=false
&SystemDisk.KMSKeyId=0e478b7a-4262-4802-b8cb-00d3fb40****
&SystemDisk.EncryptAlgorithm=AES-256
&SystemDisk.ProvisionedIops=100
&SystemDisk.BurstingEnabled=false
&ImageOptions.LoginAsNonRoot=false
&DeletionProtection=false
&StorageSetId=ss-bp67acfmxazb4p****
&StorageSetPartitionNumber=2
&CustomPriorities=[{"InstanceType":"ecs.g6.large","VswitchId":"vsw-bp14zolna43z266bq****"}]
&NetworkInterfaces=[{"InstanceType":"Primary","NetworkInterfaceTrafficMode":"HighPerformance","Ipv6AddressCount":1,"SecurityGroupIds":["sg-2ze55shrh****"]}]
&DedicatedHostClusterId=dc-2zedxc67zqzt7lb4****
&<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. | You do not have the permissions to call the operation. |
404 | InvalidDataDiskSnapshotId.NotFound | Snapshot "XXX" does not exist. | The snapshot does not exist. |
400 | InvalidDataDiskSnapshotId.SizeNotSupported | The capacity of snapshot "XXX" exceeds the size limit of the specified disk category. | The size of the snapshot exceeds the maximum size that is allowed for the disk. |
404 | InvalidImageId.NotFound | The specified image does not exist. | The image does not exist. |
400 | InvalidKeyPairName.NotFound | The specified KeyPairName does not exist in our records. | The key pair does not exist. |
400 | InvalidNetworkType.ForRAMRole | RAMRole can’t be used For classic instance. | An ECS instance uses the classic network. The classic network does not support RamRoleName. |
400 | InvalidParamter | The specified value of parameter is not valid. | The value of a parameter is invalid. |
400 | InvalidScalingConfigurationName.Duplicate | The specified value of parameter is duplicated. | The scaling configuration name already exists. |
400 | InvalidSecurityGroupId.IncorrectNetworkType | The network type of specified Security Group does not support this action. | The network type of the 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 security group and vSwitch do not reside in the same VPC. |
400 | InvalidTags.KeyValue | The specified tags key/value cannot be empty. | Tags is left empty. |
400 | InvalidTags.ListSize | The specified tags list size cannot be more than "20". | The maximum number of tags that can be specified has been reached. |
400 | InvalidUserData.Base64FormatInvalid | The specified parameter UserData must be base64 encoded. | The user data is not encoded in the Base64 format. |
400 | InvalidUserData.SizeExceeded | The specified parameter UserData exceeds the size. | The maximum size of the user data has been reached. |
400 | InvalidSecurityGroupId.IncorrectType | The managed security group "XXX" is not supported. | Managed security group "XXX" is not supported. |