Verify instance family compatibility, OS support, NVMe drivers, and disk types before changing an instance type.
Pre-change inspection checklist
|
Item |
Description |
|
Instance |
Cross-platform change restriction: Cross-platform changes are not supported by default due to potential instruction-set and feature compatibility issues. This mainly applies to changes between Intel and AMD platforms. |
|
Restriction on upgrading legacy instances: When changing certain instance types of the 6th generation or earlier to 8th-generation or later instance types, the change may not be supported due to architecture changes, feature compatibility, instruction-set compatibility, and other issues. First refer to the Supported instance type changes section on this page to confirm whether the current instance type can be upgraded to a higher generation. |
|
|
Restriction on special instance families: Security-enhanced, big data, local SSD, persistent memory, and other special instance families do not support changes by default due to their specialized logic. |
|
|
Image |
Image compatibility restriction: Be sure to confirm in advance by referring to 2. Check OS compatibility in the Pre-change check operations section below. For mission-critical workloads, back up the system disk before the change. Note that if you initiate an instance type change based on an incompatible image, we strongly recommend that you first validate the change on a single node after backing up your data, to confirm that the impact on your business is acceptable. Alibaba Cloud cannot guarantee rollback capability for changes performed on incompatible operating systems. |
|
Disk |
Disk type restriction: If the current instance uses a disk of type Ultra Disk, Standard SSD, or ESSD Entry and the target instance type is a new 7th-generation or later type, you must first change the disk to a type supported by the target instance type. Confirm in advance by referring to 4. Check disk type compatibility in the Pre-change check operations section below. Note: For instance types using Basic Disk, submit a ticket for consultation before the change. |
|
NVMe driver restriction: When the target upgrade is to an 8th-generation or later instance type, confirm in advance that the NVMe driver has been installed. |
Pre-change check operations
1. Verify instance type changeability
Confirm that the current instance type supports changes and that the target instance type is valid.
-
Confirm that the current instance type is not in the instance types that do not support changes list.
-
In the supported instance type changes list, find the current instance family and confirm the target family is supported.
You can also call the DescribeResourcesModification API operation to query available target instance types.
2. Check OS compatibility
Some instance types, especially those based on different CPU architectures such as AMD, Intel, and Yitian, have specific OS requirements. If the current OS is incompatible with the target instance type, the change fails.
Use the following compatibility lists to verify OS support for the target instance type.
If they are incompatible but you still need to change the instance type, request that the restriction be lifted.
3. Check NVMe driver compatibility
8th-generation and later instances (such as g8i, c8i, r8i, u2i, g8a, c8a, r8a, and u2a) use the NVMe protocol for disk communication and require the NVMe driver. Check the NVMe driver in these scenarios:
-
Scenario 1: Changing from a 7th-generation or earlier to an 8th-generation or later instance type
The source instance must have the NVMe driver installed, or its image must support NVMe driver installation.
-
Scenario 2: The source instance is 8th-generation or later
The source instance must have the NVMe driver installed.
Determine the generation from the instance family name. See Instance type naming convention.
4. Check disk type compatibility
Different instance types support different disk types. For example, the g7 family supports only ESSD-series disks. If the current instance has a disk unsupported by the target instance type, the change is blocked.
On the instance type change page, the system detects disk compatibility issues and prompts you to change the disk type. Review the prompts and note any cost changes.

Supported instance type changes
The following tables list supported source-to-target instance family changes.
Call DescribeResourcesModification to query supported instance type changes for an existing instance.
Table 1. Entry-level x86 compute-optimized instance families
|
Source instance family |
Supported target instance families |
|
e |
|
|
t6 |
|
|
t5 |
|
|
n4, mn4, xn4, e4 |
|
|
t1, s1, s2, s3, m1, m2, c1, c2 |
|
|
n1, n2, e3 |
|
Table 2. Enterprise-level compute-optimized instance families
|
Source instance type (family) |
Supported target instance families |
|
g9a, c9a, r9a, g9ae, c9ae, r9ae, u2a |
g9a, c9a, r9a, g9ae, c9ae, r9ae, u2a |
|
g9i, c9i, r9i, hfg9i, hfc9i, hfr9i |
g9i, c9i, r9i, hfg9i, hfc9i, hfr9i, u2i |
|
|
|
|
|
g8y, c8y, r8y |
g8y, c8y, r8y |
|
g7se, c7se, r7se |
|
|
g7a, c7a, r7a |
|
|
ebmg7a, ebmc7a, ebmr7a |
ebmg7a, ebmc7a, ebmr7a |
|
ebmhfc7, ebmhfg7, ebmhfr7 |
ebmhfc7, ebmhfg7, ebmhfr7 |
|
g7, c7, r7 |
|
|
ebmg7, ebmc7, ebmr7 |
ebmg7, ebmc7, ebmr7 |
|
|
|
g7nex, c7nex |
Important
ecs.g7nex.32xlarge can only be changed to ecs.c7nex.32xlarge. |
|
g6r, c6r |
|
|
|
|
g6a, c6a, r6a |
|
|
g6t |
g6t |
|
c6t |
c6t |
|
ebmg6a, ebmc6a, ebmr6a |
ebmg6a, ebmc6a, ebmr6a |
|
g5, g5ne, r5, c5, ic5 |
|
|
hfc5, hfg5 |
|
|
u2i |
u2i |
|
u1 |
|
|
sn1ne, sn2ne, se1ne |
|
|
se1 |
|
|
re6 |
|
|
re4e |
|
|
re4 |
|
|
gn8v |
gn8v |
|
gn8v-tee |
gn8v-tee |
|
sgn8ia |
sgn8ia |
|
gn8is |
gn8is |
|
sgn7i-vws |
sgn7i-vws |
|
vgn7i-vws |
vgn7i-vws |
|
gn7e |
gn7e |
|
gn7s |
gn7s |
|
gn7i |
gn7i |
|
gn7 |
gn7 |
|
gn6i |
gn6i |
|
vgn6i |
vgn6i, vgn6i-vws, sgn7i-vws |
|
vgn6i-vws |
vgn6i-vws |
|
gn6e |
gn6e |
|
gn6v |
gn6v |
|
gn5i |
gn5i |
|
sn1, sn2, se1 |
|
|
c4, ce4, cm4 |
|
Instance types that do not support changes
On the instance type change page in the ECS console, if the current instance type cannot be changed, the operation button is disabled and a prompt appears.
The following instance families do not support instance type changes:
|
Instance family type |
Instance family |
|
Enterprise-level x86 compute-optimized instance families |
|
|
Enterprise-level heterogeneous computing instance family |
|
|
ECS Bare Metal Instance family |
|
|
High-performance computing (HPC) & Super Computing Cluster (SCC) instance families |
|
FAQ
Common issues and solutions when changing an instance type:
|
Issue |
Description |
Solution |
|
Specification not found |
The target instance type does not exist. |
Select another target instance type. See Instance families. |
|
Instance type is retired |
The target instance type is retired. |
Select another target instance type. See Instance families. |
|
No inventory in the region |
The target instance type is out of stock in the current region. In regions with extremely tight inventory, changes to certain high-core-count instance types may also be initiated but ultimately fail. |
Select another in-stock instance type, or change the instance type across zones (same family only). View purchasable regions for an instance type Call DescribeResourcesModification to query instance type inventory in a specific zone. |
|
Only changes within the same instance family are supported |
Some instance types only support changes within the same family. |
Select a target instance type within the same family. For example, a gn7e instance can only change to another gn7e instance type. |
|
The target instance family does not match the source instance family |
The target instance type belongs to an incompatible family. |
Select a compatible target instance type from Supported instance type changes. |
|
The architecture of the target instance type does not match the source instance |
The architecture (ARM or x86) of the target instance does not match the source. |
Select a target instance type with the same architecture as the source. |
|
The number of CPU cores or the memory size of the target instance type is not supported |
The CPU core count or memory size of the target instance is unsupported by the source OS. For Windows limits, see Memory Limits for Windows and Windows Server Releases. |
Select a target instance type with compatible CPU cores and memory size. |
|
The boot mode of the target instance type does not match the current instance |
For example, if the target is a security-enhanced instance type that supports only UEFI boot mode, the source instance must also support UEFI. |
Select a target instance type with a compatible boot mode. |
|
The target instance type does not support reverting to the current source instance type |
Most instance type changes (especially cross-generation upgrades from legacy instances) are one-way. Reverting may encounter driver compatibility, CPU instruction-set compatibility, and network and storage feature compatibility issues, which require completely different handling than the original upgrade. |
Consider performing an OS upgrade or SMC migration instead. Back up your business data first, validate on a small scale before the operation, and confirm in advance whether the change can be downgraded or rolled back. |
|
The target instance type does not support the image version used by the current instance type |
The OS installed on the system disk of the current instance type is not in the list of operating systems supported by the target instance type. This often occurs when upgrading legacy instances across generations. |
We recommend that you upgrade the OS or perform an SMC migration first. To proceed with the change, back up your business data first, validate on a small scale before the operation, and confirm in advance whether the change can be downgraded or rolled back. If your business allows, evaluate whether an OS upgrade is feasible. |
|
Subscription instances do not support changing the disk type during an upgrade (or do not support downgrading the instance type while upgrading the disk type) |
When you use a subscription instance, if you need to upgrade the current instance to a more expensive target instance type and simultaneously change the disk type to satisfy change restrictions, you cannot select a disk type with a lower unit price. |
To change the disk to a lower-priced disk type when upgrading the instance type, first change the disk type separately, and then initiate the instance type change. You can also submit a ticket for consultation before the operation. |


> Configure NVMe Driver Status.