Elastic Compute Service:ModifyInstanceVpcAttribute

Usage notes

The instance that you want to manage must be in the Stopped (Stopped) state.

• When you call this operation to change the private IP address or vSwitch of an instance, take note of the following items:

  • If the instance is a new instance, you must restart the instance before you call this operation.
  • After the private IP address or vSwitch of the instance is changed, you must restart the instance before you can recall this operation.

• When you call this operation to change the VPC of an instance, take note of the following items:

  • Instance:

    • The instance cannot be associated with Server Load Balancer (SLB) instances.
    • The instance cannot be in the Locked, To Be Released, Expired, Expired and Being Recycled, or Overdue and Being Recycled state. For more information, see Instance lifecycle.
    • The instance cannot be used in other Alibaba Cloud services. For example, the instance cannot be in the process of being migrated or having its VPC changed, or the databases deployed on the instance cannot be managed by Data Transmission Service (DTS).

  • Network:

    • The cut-through mode or the multi-elastic IP address (EIP)-to-elastic network interface (ENI) mode cannot be enabled for the instance.
    • The instance cannot be associated with a high-availability virtual IP address (HAVIP).
    • The vSwitch of the instance cannot be associated with a custom route table.
    • Global Accelerator (GA) cannot be activated for the instance.
    • The instance cannot have secondary ENIs.
    • The instance cannot be assigned an IPv6 address.
    • The primary ENI of the instance cannot be associated with multiple IP addresses.
    • The new vSwitch that you specify must belong to the new VPC.
    • The original and new vSwitches must reside in the same zone.
    • If you assign a private IP address to the primary ENI of the instance, the private IP address must be an idle IP address within the CIDR block of the new vSwitch. If you do not assign a private IP address to the primary ENI of the instance, a private IP address is randomly assigned to the ENI. Make sure that sufficient IP addresses are available in the CIDR block of the new vSwitch.
    • The Alibaba Cloud account that owns the new VPC cannot share the VPC with other accounts.

  • Security group (SecurityGroupId.N):

    • All security groups must be of the same type.
    • The valid values of N vary based on the maximum number of security groups to which an instance can belong. For more information, see the "Security group limits" section in Limits .
    • The security groups that you specify must belong to the new VPC.
    • You can switch the instance to security groups of a different type. To ensure network connectivity, we recommend that you understand the differences in rule configurations of the two security group types before you switch an instance to security groups of a different type. For more information, see Overview .