DescribeScalingConfigurations - Auto Scaling - Alibaba Cloud Documentation Center

Queries information about ECS-type scaling configurations, including instance types and images, to help you understand the details of ECS instance templates used for scale-out in advance.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

ess:DescribeScalingConfigurations

get

*All Resource

*

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region ID of the scaling group to which the scaling configurations belong.	cn-qingdao
PageNumber	integer	No	The page number of the scaling configuration list. Minimum value: 1. Default value: 1.	1
PageSize	integer	No	The number of entries per page for a paged query. Maximum value: 50. Default value: 10.	50
ScalingGroupId	string	No	The ID of the scaling group. You can query all scaling configurations in the specified scaling group.	asg-bp17pelvl720x3v7****
ScalingConfigurationId	array	No	The ID of the scaling configuration that you want to query. The query results include both active and inactive scaling configurations, which are identified by the LifecycleState response parameter.	asc-bp17pelvl720x5ub****
	string	No	The ID of the scaling configuration that you want to query. The query results include both active and inactive scaling configurations, which are identified by the LifecycleState response parameter.	asc-bp17pelvl720x5ub****
ScalingConfigurationName	array	No	The name of the scaling configuration that you want to query. The query results ignore the names of inactive scaling configurations, and no error is returned.	scalingcon****
	string	No	The name of the scaling configuration that you want to query. The query results ignore the names of inactive scaling configurations, and no error is returned.	scalingcon****

Response elements

Element	Type	Description	Example
	object
RequestId	string	The request ID.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****
PageNumber	integer	The current page number.	1
PageSize	integer	The number of entries per page.	50
TotalCount	integer	The total number of scaling configurations.	1
ScalingConfigurations	object
ScalingConfiguration	array<object>	The collection of scaling configuration information.
	array<object>	The collection of scaling configuration information.
DeploymentSetId	string	The ID of the deployment set to which the ECS instance belongs.	ds-bp1frxuzdg87zh4p****
CreationTime	string	The time when the scaling configuration was created.	2014-08-14T10:58Z
ScalingConfigurationName	string	The name of the scaling configuration.	scalingconfigura****
SystemDiskDescription	string	The description of the system cloud disk.	Test system disk.
KeyPairName	string	The name of the key pair used to log on to the ECS instance.	keypair****
SecurityGroupId	string	The ID of the security group to which the ECS instance belongs. ECS instances in the same security group can access each other.	sg-bp18kz60mefs****
PrivatePoolOptions.Id	string	The private pool ID, which is the ID of the elasticity assurance or capacity reservation.	eap-bp67acfmxazb4****
SystemDiskAutoSnapshotPolicyId	string	The ID of the automatic snapshot policy applied to the system cloud disk.	sp-bp12m37ccmxvbmi5****
SpotStrategy	string	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 maximum price limit. SpotAsPriceGo: a spot instance priced at the market price at the time of purchase.	NoSpot
ScalingGroupId	string	The ID of the scaling group to which the scaling configuration belongs.	asg-bp17pelvl720x3v7****
Affinity	string	Indicates 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 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, the instance remains on the original dedicated host. If the resources of the original dedicated host are insufficient, the instance fails to restart.	default
Tenancy	string	Indicates whether the instance is created 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 `DedicatedHostId`, Alibaba Cloud automatically selects a dedicated host for the instance.	default
SystemDiskSize	integer	The size of the system cloud disk. Unit: GiB.	100
Ipv6AddressCount	integer	The number of randomly generated IPv6 addresses allocated to the network interface controller (NIC).	1
SpotDuration	integer	The retention period of the spot instance. Unit: hours.	1
LifecycleState	string	The status of the scaling configuration in the scaling group. Valid values: Active: The scaling configuration is active. The scaling group uses the active scaling configuration for automatic creation of ECS instances. Inacitve: The scaling configuration is inactive. Inactive scaling configurations are retained in the scaling group, but the scaling group does not use them for automatic creation of ECS instances.	Active
InstanceName	string	The name of the ECS instance.	instance****
SecurityEnhancementStrategy	string	Indicates whether security hardening is enabled. 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.	Active
UserData	string	The instance user data of the ECS instance, encoded in Base64.	echo hello ecs!
PrivatePoolOptions.MatchCriteria	string	The private pool capacity 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 for startup. Target: specified mode. The instance uses the specified private pool capacity for startup. If the specified private pool capacity is unavailable, the instance fails to start. None: none mode. The instance does not use private pool capacity for startup.	Open
DedicatedHostId	string	Indicates whether the ECS instance is created 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 `DedicatedHostId` is specified. You can call DescribeDedicatedHosts to query the list of dedicated host IDs.	dh-bp67acfmxazb4p****
InstanceGeneration	string	The generation of the ECS instance.	ecs-3
HpcClusterId	string	The ID of the HPC cluster to which the ECS instance belongs.	hpc-clus****
PasswordInherit	boolean	Specifies whether to use the password preset in the image.	true
Memory	integer	The memory size. Unit: GiB. Specifying both CPU and Memory defines the range of instance types. For example, CPU=2 and Memory=16 defines all instance types with 2 vCPUs and 16 GiB of memory. Auto Scaling determines the set of available instance types based on factors such as I/O optimization and zones, and then creates instances with the lowest price based on price sorting. Note This configuration takes effect only in cost optimization mode when no instance type is specified in the scaling configuration.	16
ImageId	string	The ID of the image file used for automatic creation of instances.	centos6u5_64_20G_aliaegis_2014****.vhd
ImageFamily	string	The name of the image family. When this parameter is specified, the latest available image in the image family is used to create instances. If `ImageId` is already specified, this parameter cannot be set.	hangzhou-daily-update
ImageOwnerAlias	string	The source of the image. Valid values: system: a public image provided by Alibaba Cloud. self: a custom image that you created. others: a shared image or community image provided by other Alibaba Cloud users. marketplace: an image from Alibaba Cloud Marketplace.	system
LoadBalancerWeight	integer	The weight of the ECS instance as a backend server. Valid values: 1 to 100.	1
SystemDiskCategory	string	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: ESSD. cloud_auto: ESSD AutoPL cloud disk.	cloud
HostName	string	The hostname of the ECS instance.	LocalHost
SystemDiskName	string	The name of the system cloud disk.	cloud_ssd_Test
InternetMaxBandwidthOut	integer	The maximum outbound public bandwidth. Unit: Mbit/s.	10
InternetMaxBandwidthIn	integer	The maximum inbound public bandwidth. Unit: Mbit/s.	10
InstanceType	string	The instance type of the ECS instance.	ecs.g6.large
InstanceDescription	string	The description of the ECS instance.	FinanceDept
IoOptimized	string	Indicates whether the instance is I/O optimized. Valid values: none: The instance is not I/O optimized. optimized: The instance is I/O optimized.	none
RamRoleName	string	The name of the RAM role associated with the ECS instance. The RAM role name is provided and maintained by Resource Access Management (RAM). You can call ListRoles to query available RAM roles. For information about how to create a RAM role, see CreateRole.	ramrole****
SystemDiskPerformanceLevel	string	The performance level (PL) of the system cloud disk when the disk is an ESSD.	PL1
Cpu	integer	The number of vCPUs. Specifying both CPU and Memory defines the range of instance types. For example, CPU=2 and Memory=16 defines all instance types with 2 vCPUs and 16 GiB of memory. Auto Scaling determines the set of available instance types based on factors such as I/O optimization and zones, and then creates instances with the lowest price based on price sorting. Note This configuration takes effect only in cost optimization mode when no instance type is specified in the scaling configuration.	2
ResourceGroupId	string	The ID of the resource group to which the ECS instance belongs.	rg-aekzn2ou7xo****
ZoneId	string	The zone ID of the instance. You can call DescribeZones to query the list of available zones.	cn-hangzhou-g
InternetChargeType	string	The billing method for network usage. Valid values: PayByBandwidth: pay-by-bandwidth. The value of InternetMaxBandwidthOut is the fixed bandwidth value. PayByTraffic: pay-by-traffic. The value of InternetMaxBandwidthOut is only a bandwidth upper limit. Billing is based on the actual network traffic.	PayByTraffic
ImageName	string	The name of the image file.	centos6u5_64_20G_aliaegis_20140703.vhd
ScalingConfigurationId	string	The ID of the scaling configuration.	asc-bp1ezrfgoyn5kijl****
CreditSpecification	string	The running mode of the burstable instance. Valid values: Standard: standard mode. For more information about instance performance, see the performance constrained mode section in What are burstable instances?. Unlimited: unlimited mode. For more information about instance performance, see the unlimited mode section in What are burstable instances?.	Standard
SpotInterruptionBehavior	string	The interruption pattern of the spot instance.	Terminate
DataDisks	object
DataDisk	array<object>	The collection of data cloud disk information.
	array<object>	The collection of data cloud disk information.
PerformanceLevel	string	The performance level (PL) of the data cloud disk when the disk is an ESSD.	PL1
Description	string	The description of the data cloud disk.	FinanceDept
SnapshotId	string	The ID of the snapshot used to create the data cloud disk.	s-23f2i****
Device	string	The mount point of the data cloud disk.	/dev/xvdb
Size	integer	The size of the data cloud disk. Unit: GiB. Valid values: cloud: 5 to 2000. cloud_efficiency: 20 to 32768. cloud_ssd: 20 to 32768. cloud_essd: 20 to 32768. ephemeral_ssd: 5 to 800.	200
DiskName	string	The name of the data cloud disk.	cloud_ssdData
AutoSnapshotPolicyId	string	The ID of the automatic snapshot policy applied to the data cloud disk.	sp-bp19nq9enxqkomib****
Category	string	The category of the data cloud disk. Valid values: cloud: basic cloud disk. The DeleteWithInstance property of a basic cloud disk created along 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. cloud_regional_disk_auto: regional ESSD.	cloud
KMSKeyId	string	The ID of the KMS key associated with the data cloud disk.	0e478b7a-4262-4802-b8cb-00d3fb40****
DeleteWithInstance	boolean	Indicates whether the data cloud disk is released when the instance is released. Valid values: true: The data cloud disk is released when the instance is released. false: The data cloud disk is retained when the instance is released.	true
Encrypted	string	Indicates whether the data cloud disk is encrypted. Valid values: true: encrypted. false: not encrypted.	false
Categories	object
Category	array	The multiple disk type list for the data cloud disk. The first disk type has the highest priority, and the priority of subsequent disk types decreases in order. When a higher-priority disk type is unavailable, Auto Scaling automatically attempts the next-priority disk type to create the data cloud disk. Valid values: cloud: basic cloud disk. The DeleteWithInstance property of a basic cloud disk created along 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. cloud_regional_disk_auto: regional ESSD.
	string	The multiple disk type list for the data cloud disk. The first disk type has the highest priority, and the priority of subsequent disk types decreases in order. When a higher-priority disk type is unavailable, Auto Scaling automatically attempts the next-priority disk type to create the data cloud disk. Valid values: cloud: basic cloud disk. The DeleteWithInstance property of a basic cloud disk created along with the instance is set to true. cloud_efficiency: ultra cloud disk. cloud_ssd: standard SSD. cloud_essd: ESSD.	cloud_essd
ProvisionedIops	integer	The provisioned IOPS (Input/Output Operations Per Second) performance metrics of the data cloud disk. Note IOPS (Input/Output Operations Per Second) measures the number of I/O operations that block storage can process per second, representing the read/write (output/input) capability. The unit is operations per second.	100
BurstingEnabled	boolean	Indicates whether Burst (performance burst) is enabled for the data cloud disk. Valid values: true: enabled. false: not enabled. Note This parameter is returned only when `DataDisk.Category` is set to `cloud_auto`.	false
Tags	object
Tag	array<object>	The collection of tag information.
	object	The collection of tag information.
Key	string	The tag key of the instance. Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be up to 128 characters in length and cannot start with `aliyun` or `acs:`. The tag key cannot contain `http://` or `https://`.	binary
Value	string	The tag value of the instance. Valid values of N: 1 to 20. The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot start with `acs:`. The tag value cannot contain `http://` or `https://`.	alterTable
SpotPriceLimit	object
SpotPriceModel	array<object>	The collection of spot instance information.
	object	The collection of spot instance information.
InstanceType	string	The instance type of the spot instance.	ecs.g6.large
PriceLimit	number	The price limit for the spot instance.	0.125
InstancePatternInfos	object
InstancePatternInfo	array<object>	The collection of intelligent configuration information, which is used to filter instance types that meet the specified requirements.
	array<object>	The collection of intelligent configuration information, which is used to filter instance types that meet the specified requirements.
MaxPrice	number	The maximum hourly price for pay-as-you-go or spot instances.	2
Cores	integer	The number of vCPU cores of the instance type.	2
Memory	number	The memory size of the instance type. Unit: GiB.	4
InstanceFamilyLevel	string	The level of the instance family. Valid values: EntryLevel: entry level, which refers to shared instance types. These instance types are more cost-effective but cannot guarantee stable computing performance. They are suitable for scenarios in which CPU utilization is low. For more information, see Shared instance families. EnterpriseLevel: enterprise level. These instance types provide stable performance and dedicated resources. They are suitable for scenarios that require high stability. For more information, see Instance families. CreditEntryLevel: credit entry level, which refers to burstable instances. These instance types use CPU credits to ensure computing performance. They are suitable for scenarios in which CPU utilization is typically low but occasionally spikes. For more information, see Burstable instances.	EnterpriseLevel
Architectures	object
Architecture	array	The architecture type of the instance type. Valid values: X86: x86 computing. Heterogeneous: heterogeneous computing, such as GPU or FPGA. BareMental: Elastic Compute Service Bare Metal Instance server. Arm: Arm computing. Default value: all architecture types are included.
	string	The architecture type of the instance type. Valid values: X86: x86 computing. Heterogeneous: heterogeneous computing, such as GPU or FPGA. BareMental: Elastic Compute Service Bare Metal Instance server. Arm: Arm computing. Default value: all architecture types are included.	X86
BurstablePerformance	string	Specifies whether burstable instance types are included. Valid values: Exclude: Burstable instance types are not included. Include: Burstable instance types are included. Required: Only burstable instance types are included. Default value: Include.	Include
ExcludedInstanceTypes	object
ExcludedInstanceType	array	The instance type to exclude. You can use wildcard characters () to exclude a single instance type or an entire instance family. Examples: ecs.c6.large: excludes the ecs.c6.large instance type. ecs.c6.: excludes the entire c6 instance family.
	string	The instance type to exclude. You can use wildcard characters () to exclude a single instance type or an entire instance family. Examples: ecs.c6.large: excludes the ecs.c6.large instance type. ecs.c6.: excludes the entire c6 instance family.	ecs.n1.small/ecs.n1./7*
InstanceTypeFamilies	object
InstanceTypeFamily	array	The instance family to query. N specifies that you can set multiple instance families. Valid values of N: 1 to 10.
	string	The instance family to query. N specifies that you can set multiple instance families. Valid values of N: 1 to 10.	ecs.g6
MinimumCpuCoreCount	integer	The minimum number of vCPU cores of the instance type.	2
MaximumCpuCoreCount	integer	The maximum number of vCPU cores of the instance type. Note The value of `MaximumCpuCoreCount` cannot exceed four times the value of `MinimumCpuCoreCount`.	4
GpuSpecs	object
GpuSpec	array	The GPU type.
	string	The GPU type.	NVIDIA V100
InstanceCategories	object
InstanceCategory	array	The instance category.
	string	The instance categorization. Valid values: Note N specifies that you can settings multiple instance categories. Valid values of N: 1 to 10. General-purpose: general-purpose. Compute-optimized: compute-optimized. Memory-optimized: memory-optimized. Big data: big data. Local SSDs: local SSD. High Clock Speed: high frequency. Enhanced: enhanced. Shared: shared. Compute-optimized with GPU: GPU computing. Visual Compute-optimized: visual compute-optimized. Heterogeneous Service: heterogeneous service. Compute-optimized with FPGA: FPGA-accelerated compute-optimized. Compute-optimized with NPU: NPU-accelerated compute-optimized. ECS Bare Metal: Elastic Compute Service Bare Metal Instance server. High Performance Compute: high-performance computing (HPC).	Compute-optimized with GPU
CpuArchitectures	object
CpuArchitecture	array	The CPU architecture of the instance type.
	string	The CPU architecture of the instance type. Valid values: Note N specifies that you can set multiple CPU architectures. Valid values of N: 1 to 2. X86. ARM.	X86
PhysicalProcessorModels	object
PhysicalProcessorModel	array	The processor model of the instance. N specifies that you can set multiple processor models. Valid values of N: 1 to 10.
	string	The processor model of the instance. N specifies that you can set multiple processor models. Valid values of N: 1 to 10.	Intel Xeon(Ice Lake) Platinum 8369B", "Intel Xeon(Skylake) Platinum 8163", … "Intel Xeon(Cascade Lake) Platinum 8269CY
MinimumEniQuantity	integer	The minimum number of elastic network interfaces (ENIs) that the instance supports.	2
MinimumEniPrivateIpAddressQuantity	integer	The expected minimum number of IPv4 addresses per elastic network interfaces (ENIs) on the instance.	2
MinimumEniIpv6AddressQuantity	integer	The minimum number of IPv6 addresses per elastic network interfaces (ENIs) on the instance.	1
MinimumInitialCredit	integer	The minimum initial vCPU credits for burstable instances (t5 and t6).	12
MinimumBaselineCredit	integer	The minimum baseline vCPU computing performance (sum of all vCPUs) for burstable instances (t5 and t6).	12
MinimumMemorySize	number	The minimum memory size of the instance. Unit: GiB.	4
MaximumMemorySize	number	The maximum memory size of the instance. Unit: GiB.	4
MinimumGpuAmount	integer	The minimum number of GPUs on the instance. Valid values: positive integers.	2
MaximumGpuAmount	integer	The maximum number of GPUs on the instance. Valid values: positive integers.	2
SystemDiskCategories	object
SystemDiskCategory	array	The multiple disk types of the system cloud disk. The first disk type has the highest priority, and the priority decreases in order. When a higher-priority disk type is unavailable, Auto Scaling automatically attempts the next-priority disk type to create the system cloud disk. Valid values: cloud: basic cloud disk. cloud_efficiency: ultra cloud disk. cloud_ssd: standard SSD. cloud_essd: Enterprise SSD (ESSD).
	string	The multiple disk types of the system cloud disk. The first disk type has the highest priority, and the priority decreases in order. When a higher-priority disk type is unavailable, Auto Scaling automatically attempts the next-priority disk type to create the system cloud disk. Valid values: cloud: basic cloud disk. cloud_efficiency: ultra cloud disk. cloud_ssd: standard SSD. cloud_essd: Enterprise SSD (ESSD).	cloud
WeightedCapacities	object
WeightedCapacity	array	The weight of the specified instance type, which represents the capacity of a single instance of this type in the scaling group. A larger weight means fewer instances of this type are required to meet the expected capacity.
	string	The weight of the specified instance type, which represents the capacity of a single instance of this type in the scaling group. A larger weight means fewer instances of this type are required to meet the expected capacity.	4
InstanceTypes	object
InstanceType	array	The collection of instance types of the ECS instance.
	string	The collection of instance types of the ECS instance.	ecs.g6.large
SecurityGroupIds	object
SecurityGroupId	array	The IDs of the security groups to which the ECS instance belongs. ECS instances within the same security group can access each other.
	string	The IDs of the security groups to which the ECS instance belongs. ECS instances within the same security group can access each other.	sg-bp18kz60mefs****
SchedulerOptions	object	The scheduling options.
ManagedPrivateSpaceId	string	The intelligent fully managed resource pool.	testManagedPrivateSpaceId
SystemDisk.Encrypted	boolean	Indicates whether the system cloud disk is encrypted. Valid values: true: Encrypted. false: Not encrypted.	false
SystemDisk.KMSKeyId	string	The ID of the KMS key used for the system cloud disk.	0e478b7a-4262-4802-b8cb-00d3fb40****
SystemDisk.EncryptAlgorithm	string	The encryption algorithm used for the system cloud disk. Valid values: AES-256. SM4-128.	AES-256
SystemDisk.ProvisionedIops	integer	The provisioned IOPS (Input/Output Operations Per Second) performance metrics of the system cloud disk. Note IOPS (Input/Output Operations Per Second) measures the number of I/O operations that can be processed per second, representing the read/write capability of block storage. Unit: operations per second.	100
SystemDisk.BurstingEnabled	boolean	Indicates whether the Burst (performance burst) feature is enabled for the system cloud disk. Valid values: true: Enabled. false: Not enabled. Note This parameter is supported only when SystemDisk.Category is set to cloud_auto.	false
ImageOptions.LoginAsNonRoot	boolean	Indicates whether the ECS instance uses the ecs-user user to log on. Valid values: true: Yes. false: No.	false
DeletionProtection	boolean	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: Release protection is enabled. The instance cannot be directly released from the ECS console or by calling the API. This prevents instances scaled out by Auto Scaling from being accidentally deleted. false: Release protection is disabled. The instance can be directly released from the ECS console or by calling the API. Note This property does not affect normal scale-in activities of Auto Scaling. Pay-as-you-go instances with release protection enabled can still be released during scale-in activities.	false
StorageSetId	string	The ID of the storage set.	ss-bp67acfmxazb4p****
StorageSetPartitionNumber	integer	The maximum number of partitions in the storage set. Valid values: integers greater than or equal to 2.	2
CustomPriorities	object
CustomPriority	array<object>	The custom priority of the ECS instance type + vSwitch combination. Note This parameter takes effect only when the `scaling policy` of the scaling group is set to `Priority`. When an ECS instance cannot be created based on a higher-priority ECS instance type + vSwitch combination, Auto Scaling automatically selects the next-priority ECS instance type + vSwitch combination to create the ECS instance. Note If you specify custom priorities for only some ECS instance type + vSwitch combinations, the unspecified combinations have lower priorities than the specified ones. The unspecified combinations are still prioritized based on the vSwitch order of the scaling group and the instance type order of the scaling configuration. For example, if the vSwitch order of the scaling group is vsw1 and vsw2, the instance type order of the scaling configuration is type1 and type2, and the custom priority order is `["vsw2+type2", "vsw1+type2"]`, the final priority is `vsw2+type2` > `vsw1+type2` > `vsw1+type1` > `vsw2+type1`.
	object	The custom priority of the ECS instance type + vSwitch combination. Important This parameter takes effect only when the `scaling policy` of the scaling group is set to `Priority`.
InstanceType	string	The instance type of the ECS instance. Note The instance type must be included in the instance type list of the scaling configuration.	ecs.g6.large
VswitchId	string	The ID of the vSwitch. Note The vSwitch must be included in the vSwitch list of the scaling group.	vsw-bp14zolna43z266bq****
NetworkInterfaces	object
NetworkInterface	array<object>	The list of elastic network interfaces (ENIs).
	array<object>	The list of elastic network interfaces (ENIs).
InstanceType	string	The type of the elastic network interfaces (ENIs). Valid values: Primary: primary network interface controller (NIC). Secondary: secondary elastic network interfaces (ENIs).	Primary
NetworkInterfaceTrafficMode	string	The communication mode of the elastic network interfaces (ENIs). Valid values: Standard: uses the TCP communication mode. HighPerformance: enables the Elastic RDMA Interface (ERI) and uses the RDMA communication mode.	HighPerformance
Ipv6AddressCount	integer	The number of randomly generated IPv6 addresses assigned to the primary ENI.	1
SecurityGroupIds	object
SecurityGroupId	array	The IDs of one or more security groups to which the elastic network interfaces (ENIs) belongs.
	string	The IDs of one or more security groups to which the elastic network interfaces (ENIs) belongs.	sg-2vc3e1v7h****
SecondaryPrivateIpAddressCount	integer	The number of secondary private IPv4 addresses assigned to the ENI. Valid values: 1 to 49. The value cannot exceed the IP address limit for the instance type. For more information, see Instance families. NetworkInterface.N.SecondaryPrivateIpAddressCount specifies the number of secondary private IPv4 addresses assigned to the ENI (excluding the primary private IP address of the ENI). The system randomly assigns addresses from the available CIDR block of the vSwitch (NetworkInterface.N.VSwitchId) to which the ENI belongs.	2
VSwitchIds	object
VSwitchId	array	The ID of the vSwitch to which the elastic network interfaces (ENIs) belongs.
	string	The ID of the vSwitch to which the elastic network interfaces (ENIs) belongs.	vsw-bp67acfmxazb4p****
DedicatedHostClusterId	string	The ID of the dedicated host cluster.	dc-2zedxc67zqzt7lb4****
PasswordSetted	boolean	Indicates whether an instance password is set. Valid values: true: An instance password is set. false: No instance password is set.	false
SecurityOptions	object	The security options.
ConfidentialComputingMode	string	The confidential computing mode. Valid values: Enclave: The ECS instance uses Enclave to build a confidential computing environment. For more information, see Build a confidential computing environment by using Enclave. TDX: Builds a TDX confidential computing environment. For more information, see Build a TDX confidential computing environment.	TDX
HttpEndpoint	string	Specifies whether the access channel for instance metadata is enabled. Valid values: enabled: Enabled. disabled: Disabled.	enabled
HttpTokens	string	Specifies whether the hardened mode (IMDSv2) is forcefully used when accessing instance metadata. Valid values: optional: Not forcefully used. required: Forcefully used. After this value is set, instance metadata cannot be accessed in normal mode.	optional
ResourcePoolOptions	object	The resource pool policy used when creating instances. This parameter takes effect only when creating pay-as-you-go instances.
Strategy	string	The resource pool includes private pools generated after elasticity assurance or capacity reservation takes effect, and public pools, from which instances can be launched. Valid values: PrivatePoolFirst: Private pool first. When this strategy is selected and ResourcePoolOptions.PrivatePoolIds is specified or PrivatePoolTags conditions are met, the corresponding private pool is used first. If no private pool is specified or the specified private pool has insufficient capacity, open-type private pools are automatically matched. If no matching private pool is available, the public pool is used to create instances. PrivatePoolOnly: Private pool only. When this strategy is selected, ResourcePoolOptions.PrivatePoolIds must be specified. If the specified private pool has insufficient capacity, instance creation fails. PublicPoolFirst: Public pool first. The public pool is used first to create instances. When public pool resources are insufficient, private pool resources are used as a supplement. Open-type private pools are automatically matched first. If no matching private pool is available, the Target-type private pools specified in ResourcePoolOptions.PrivatePoolIds or matching PrivatePoolTags conditions are used. None: No resource pool policy is used. Default value: None.	PrivatePoolFirst
PrivatePoolIds	object
PrivatePoolId	array	The private pool ID, which is the elasticity assurance ID or capacity reservation ID. This parameter cannot be specified together with the PrivatePoolTags parameter.
	string	The private pool ID, which is the elasticity assurance ID or capacity reservation ID. This parameter cannot be specified together with the PrivatePoolTags parameter.	eap-bp67acfmxazb4****
PrivatePoolTags	object
PrivatePoolTag	array<object>	Filters available Target private pools by tag.
	object	Filters available Target private pools by tag.
Key	string	The tag key of the private pool. Filters available Target private pools by tag.	TestKey
Value	string	The tag value of the private pool.	TestValue
CpuOptions	object	The CPU options.
NestedVirtualization	string	Specifies whether the hardware-based nested virtualization feature is enabled. Valid values: enabled: Enabled. disabled: Not enabled.	enabled
SecondaryEniVSwitchConstraint	string	Settings whether a vSwitch for secondary elastic network interfaces (ENIs) must be selected from the VSwitchIds list when the VSwitchIds parameter is active.	Strict

Examples

Success response

JSON format

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "PageNumber": 1,
  "PageSize": 50,
  "TotalCount": 1,
  "ScalingConfigurations": {
    "ScalingConfiguration": [
      {
        "DeploymentSetId": "ds-bp1frxuzdg87zh4p****",
        "CreationTime": "2014-08-14T10:58Z",
        "ScalingConfigurationName": "scalingconfigura****",
        "SystemDiskDescription": "Test system disk.",
        "KeyPairName": "keypair****",
        "SecurityGroupId": "sg-bp18kz60mefs****",
        "PrivatePoolOptions.Id": "eap-bp67acfmxazb4****",
        "SystemDiskAutoSnapshotPolicyId": "sp-bp12m37ccmxvbmi5****",
        "SpotStrategy": "NoSpot",
        "ScalingGroupId": "asg-bp17pelvl720x3v7****",
        "Affinity": "default",
        "Tenancy": "default",
        "SystemDiskSize": 100,
        "Ipv6AddressCount": 1,
        "SpotDuration": 1,
        "LifecycleState": "Active",
        "InstanceName": "instance****",
        "SecurityEnhancementStrategy": "Active",
        "UserData": "echo hello ecs!",
        "PrivatePoolOptions.MatchCriteria": "Open",
        "DedicatedHostId": "dh-bp67acfmxazb4p****",
        "InstanceGeneration": "ecs-3",
        "HpcClusterId": "hpc-clus****",
        "PasswordInherit": true,
        "Memory": 16,
        "ImageId": "centos6u5_64_20G_aliaegis_2014****.vhd",
        "ImageFamily": "hangzhou-daily-update",
        "ImageOwnerAlias": "system",
        "LoadBalancerWeight": 1,
        "SystemDiskCategory": "cloud",
        "HostName": "LocalHost",
        "SystemDiskName": "cloud_ssd_Test",
        "InternetMaxBandwidthOut": 10,
        "InternetMaxBandwidthIn": 10,
        "InstanceType": "ecs.g6.large",
        "InstanceDescription": "FinanceDept",
        "IoOptimized": "none",
        "RamRoleName": "ramrole****",
        "SystemDiskPerformanceLevel": "PL1",
        "Cpu": 2,
        "ResourceGroupId": "rg-aekzn2ou7xo****",
        "ZoneId": "cn-hangzhou-g",
        "InternetChargeType": "PayByTraffic",
        "ImageName": "centos6u5_64_20G_aliaegis_20140703.vhd",
        "ScalingConfigurationId": "asc-bp1ezrfgoyn5kijl****",
        "CreditSpecification": "Standard",
        "SpotInterruptionBehavior": "Terminate",
        "DataDisks": {
          "DataDisk": [
            {
              "PerformanceLevel": "PL1",
              "Description": "FinanceDept",
              "SnapshotId": "s-23f2i****",
              "Device": "/dev/xvdb",
              "Size": 200,
              "DiskName": "cloud_ssdData",
              "AutoSnapshotPolicyId": "sp-bp19nq9enxqkomib****",
              "Category": "cloud",
              "KMSKeyId": "0e478b7a-4262-4802-b8cb-00d3fb40****",
              "DeleteWithInstance": true,
              "Encrypted": "false",
              "Categories": {
                "Category": [
                  "cloud_essd"
                ]
              },
              "ProvisionedIops": 100,
              "BurstingEnabled": false
            }
          ]
        },
        "Tags": {
          "Tag": [
            {
              "Key": "binary",
              "Value": "alterTable"
            }
          ]
        },
        "SpotPriceLimit": {
          "SpotPriceModel": [
            {
              "InstanceType": "ecs.g6.large",
              "PriceLimit": 0.125
            }
          ]
        },
        "InstancePatternInfos": {
          "InstancePatternInfo": [
            {
              "MaxPrice": 2,
              "Cores": 2,
              "Memory": 4,
              "InstanceFamilyLevel": "EnterpriseLevel",
              "Architectures": {
                "Architecture": [
                  "X86"
                ]
              },
              "BurstablePerformance": "Include",
              "ExcludedInstanceTypes": {
                "ExcludedInstanceType": [
                  "ecs.n1.small/ecs.n1.*/*7*"
                ]
              },
              "InstanceTypeFamilies": {
                "InstanceTypeFamily": [
                  "ecs.g6"
                ]
              },
              "MinimumCpuCoreCount": 2,
              "MaximumCpuCoreCount": 4,
              "GpuSpecs": {
                "GpuSpec": [
                  "NVIDIA V100"
                ]
              },
              "InstanceCategories": {
                "InstanceCategory": [
                  "Compute-optimized with GPU"
                ]
              },
              "CpuArchitectures": {
                "CpuArchitecture": [
                  "X86"
                ]
              },
              "PhysicalProcessorModels": {
                "PhysicalProcessorModel": [
                  "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,
              "MaximumMemorySize": 4,
              "MinimumGpuAmount": 2,
              "MaximumGpuAmount": 2
            }
          ]
        },
        "SystemDiskCategories": {
          "SystemDiskCategory": [
            "cloud"
          ]
        },
        "WeightedCapacities": {
          "WeightedCapacity": [
            "4"
          ]
        },
        "InstanceTypes": {
          "InstanceType": [
            "ecs.g6.large"
          ]
        },
        "SecurityGroupIds": {
          "SecurityGroupId": [
            "sg-bp18kz60mefs****"
          ]
        },
        "SchedulerOptions": {
          "ManagedPrivateSpaceId": "testManagedPrivateSpaceId"
        },
        "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": {
          "CustomPriority": [
            {
              "InstanceType": "ecs.g6.large",
              "VswitchId": "vsw-bp14zolna43z266bq****"
            }
          ]
        },
        "NetworkInterfaces": {
          "NetworkInterface": [
            {
              "InstanceType": "Primary",
              "NetworkInterfaceTrafficMode": "HighPerformance",
              "Ipv6AddressCount": 1,
              "SecurityGroupIds": {
                "SecurityGroupId": [
                  "sg-2vc3e1v7h****"
                ]
              },
              "SecondaryPrivateIpAddressCount": 2,
              "VSwitchIds": {
                "VSwitchId": [
                  "vsw-bp67acfmxazb4p****"
                ]
              }
            }
          ]
        },
        "DedicatedHostClusterId": "dc-2zedxc67zqzt7lb4****",
        "PasswordSetted": false,
        "SecurityOptions": {
          "ConfidentialComputingMode": "TDX"
        },
        "HttpEndpoint": "enabled",
        "HttpTokens": "optional",
        "ResourcePoolOptions": {
          "Strategy": "PrivatePoolFirst",
          "PrivatePoolIds": {
            "PrivatePoolId": [
              "eap-bp67acfmxazb4****"
            ]
          },
          "PrivatePoolTags": {
            "PrivatePoolTag": [
              {
                "Key": "TestKey",
                "Value": "TestValue"
              }
            ]
          }
        },
        "CpuOptions": {
          "NestedVirtualization": "enabled"
        },
        "SecondaryEniVSwitchConstraint": "Strict"
      }
    ]
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.