DescribeScalingConfigurations-Auto Scaling(ESS)-阿里云帮助中心

Queries information about ECS-type scaling configurations, including instance types and images, so that you can learn about the ECS instance templates used for scale-out activities 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 configuration belongs.	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 scaling configurations in both Active and Inactive states, 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 scaling configurations in both Active and Inactive states, 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 invalid scaling configuration names without returning an error.	scalingcon****
	string	No	The name of the scaling configuration that you want to query. The query results ignore invalid scaling configuration names without returning an error.	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 ID of the private pool. The ID of an elasticity assurance or a 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 user-defined maximum hourly price. 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 deployed on another dedicated host in the automatic deployment resource pool if the resources of the original dedicated host are insufficient. host: The instance is associated with the dedicated host. When an instance that has the economical mode enabled is restarted, the instance is still deployed on the original dedicated host. If the resources of the original dedicated host are insufficient, the instance fails to restart.	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 in the active state. The scaling group uses the active scaling configuration for automatic creation of ECS instances. Inacitve: The scaling configuration is in the inactive state. Inactive scaling configurations exist 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 user data of the ECS instance, which is encoded in Base64.	echo hello ecs!
PrivatePoolOptions.MatchCriteria	string	The private pool capacity option for instance startup. A private pool is generated after an elasticity assurance or a capacity reservation takes effect. You can select a private pool when you start an instance. Valid values: Open: open mode. The system automatically matches an open private pool. If no matching private pool is available, the public pool is used to start the instance. Target: specified mode. A specified private pool is used to start the instance. If the specified private pool is unavailable, the instance fails to start. None: none mode. No private pool is used to start the instance.	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 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. You can specify both CPU and Memory to define the range of instance types. For example, you can set CPU to 2 and Memory to 16 to define all instance types that have 2 vCPUs and 16 GiB of memory. Auto Scaling determines the set of available instance types based on factors such as I/O optimization and zones, and then creates instances at the lowest price. Note This setting takes effect only when cost optimization mode is enabled and 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. You can set this parameter to obtain the latest available image from the specified image family for instance creation. 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 from other Alibaba Cloud accounts. 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: non-I/O optimization. optimized: I/O optimization.	none
RamRoleName	string	The name of the RAM role associated with the ECS instance. The RAM role 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 system cloud disk is an ESSD.	PL1
Cpu	integer	The number of vCPUs. You can specify both CPU and Memory to define the range of instance types. For example, you can set CPU to 2 and Memory to 16 to define all instance types that have 2 vCPUs and 16 GiB of memory. Auto Scaling determines the set of available instance types based on factors such as I/O optimization and zones, and then creates instances at the lowest price. Note This setting takes effect only when cost optimization mode is enabled and 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 the 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, see the performance constrained mode section in What are burstable instances?. Unlimited: unlimited mode. For more information, see the unlimited mode section in What are burstable instances?.	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 data cloud 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 for 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 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 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, indicating the read/write capability of the storage device.	100
BurstingEnabled	boolean	Indicates whether the Burst (performance burst) feature 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. For more information, see ESSD AutoPL cloud disks.	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 of the spot instance.	0.125
InstancePatternInfos	object
InstancePatternInfo	array<object>	The collection of intelligent configuration information used to filter instance types that meet the specified requirements.
	array<object>	The collection of intelligent configuration information 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 type family. EntryLevel: entry level, which refers to shared instance types. These instance types are more cost-effective but do not guarantee stable computing performance. They are suitable for scenarios with low CPU utilization. For more information, see Shared instance types. 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 with low average CPU utilization and occasional bursts. 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: ECS Bare Metal Instance server. Arm: Arm computing. Default value: all architecture types.
	string	The architecture type of the instance type. Valid values: X86: X86 computing. Heterogeneous: heterogeneous computing, such as GPU or FPGA. BareMental: ECS Bare Metal Instance server. Arm: Arm computing. Default value: all architecture types.	X86
BurstablePerformance	string	Indicates whether burstable instance types are included. Valid values: Exclude: Burstable instance types are excluded. Include: Burstable instance types are included. Required: Only burstable instance types are included. Default value: Include.	Include
ExcludedInstanceTypes	object
ExcludedInstanceType	array	The instance types to exclude. You can use wildcard characters () to exclude a single instance type or an entire instance type family. Examples: ecs.c6.large: excludes the ecs.c6.large instance type. ecs.c6.: excludes the entire c6 instance type family.
	string	The instance types to exclude. You can use wildcard characters () to exclude a single instance type or an entire instance type family. Examples: ecs.c6.large: excludes the ecs.c6.large instance type. ecs.c6.: excludes the entire c6 instance type family.	ecs.n1.small/ecs.n1./7*
InstanceTypeFamilies	object
InstanceTypeFamily	array	The instance type families to query. N indicates that you can specify multiple instance type families. Valid values of N: 1 to 10.
	string	The instance type families to query. N indicates that you can specify multiple instance type 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 type category.
	string	The instance categorization. Valid values: Note N indicates that you can set 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: ECS 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 indicates that you can specify multiple CPU architectures. Valid values of N: 1 to 2. X86. ARM.	X86
PhysicalProcessorModels	object
PhysicalProcessorModel	array	The processor model of the instance. N indicates that you can specify multiple processor models. Valid values of N: 1 to 10.
	string	The processor model of the instance. N indicates that you can specify 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 network interface controllers (NICs) that the instance supports.	2
MinimumEniPrivateIpAddressQuantity	integer	The expected minimum number of IPv4 addresses per network interface controller (NIC) of the instance. [_single.resp.200.props.ScalingConf	2
MinimumEniIpv6AddressQuantity	integer	The maximum number of IPv6 addresses supported by the least number of elastic network interfaces (ENIs) on the instance.	1
MinimumInitialCredit	integer	The minimum initial vCPU credit value 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 of the instance. Valid values: positive integers.	2
MaximumGpuAmount	integer	The maximum number of GPUs of the instance. Valid values: positive integers.	2
SystemDiskCategories	object
SystemDiskCategory	array	The multiple disk type list for 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: ESSD.
	string	The multiple disk type list for 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: ESSD.	cloud
WeightedCapacities	object
WeightedCapacity	array	The weight of the specified instance type, which indicates the capacity of a single instance of this type in the scaling group. A higher weight means that fewer instances of this type are required to meet the expected capacity.
	string	The weight of the specified instance type, which indicates the capacity of a single instance of this type in the scaling group. A higher weight means that 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 multiple security groups to which the ECS instance belongs. ECS instances in the same security group can access each other.
	string	The IDs of the multiple security groups to which the ECS instance belongs. ECS instances in 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. [_single.resp.200.props.ScalingConfigurations.	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 refers to the number of I/O operations that a block storage device can process per second, measuring its read/write capability.	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. For more information, see ESSD AutoPL cloud disks.	false
ImageOptions.LoginAsNonRoot	boolean	Indicates whether the ECS instance uses the ecs-user user for logon. 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 operation. This prevents instances created during scale-out events from being accidentally deleted. false: Release protection is disabled. The instance can be directly released from the ECS console or by calling the API operation. 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. The value must be an integer that is 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 Policy`. When an ECS instance cannot be created based on the ECS instance type + vSwitch combination with a higher priority, Auto Scaling automatically selects the ECS instance type + vSwitch combination with the next priority 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 Policy`.
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 pattern of the elastic network interfaces (ENIs). Valid values: Standard: TCP communication pattern is used for the network interface controller (NIC). HighPerformance: Elastic RDMA Interface (ERI) is enabled and RDMA communication pattern is used for the network interface controller (NIC).	HighPerformance
Ipv6AddressCount	integer	The number of randomly generated IPv6 addresses allocated to the primary network interface.	1
SecurityGroupIds	object
SecurityGroupId	array	The ID of one or more security groups to which the elastic network interfaces (ENIs) or network interface controller (NIC) belongs.
	string	The ID of one or more security groups to which the elastic network interfaces (ENIs) or network interface controller (NIC) belongs.	sg-2vc3e1v7h****
SecondaryPrivateIpAddressCount	integer	The number of secondary private IPv4 addresses assigned to the network interface. 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 network interface (excluding the primary private IP address of the network interface). The system randomly assigns addresses from the available CIDR block of the vSwitch (NetworkInterface.N.VSwitchId) associated with the network interface.	2
VSwitchIds	object
VSwitchId	array
	string		vsw-bp67acfmxazb4p****
DedicatedHostClusterId	string	The ID of the dedicated host cluster.	dc-2zedxc67zqzt7lb4****
PasswordSetted	boolean	Indicates whether a password is set for the instance. Valid values: true: A password is set for the instance. false: No password is set for the instance.	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: A TDX confidential computing environment is built. For more information, see Build a TDX confidential computing environment.	TDX
HttpEndpoint	string	Indicates whether the access channel for instance metadata is enabled. Valid values: enabled: Enabled. disabled: Disabled.	enabled
HttpTokens	string	Indicates whether the China 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 pay-as-you-go instances are created.
Strategy	string	Resource pools include private pools generated after elasticity assurance or capacity reservation takes effect, and public pools for instance startup. Valid values: PrivatePoolFirst: Private pool first. When this strategy is selected, if 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 by 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	Indicates whether hardware-based nested virtualization is enabled. Valid values: enabled: Enabled. disabled: Not enabled.	enabled
SecondaryEniVSwitchConstraint	string		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.