ModifyInstanceVpcAttribute

The ECS 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 ECS 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 ECS instance, take note of the following items:

  • ECS instance:

    • The instance cannot be in the Locked, To Be Released, Expired, To Be Recycled, Expired and Being Recycled, or Overdue and Being Recycled state. For more information, see Overview of instances.

    • The instance cannot be associated with Server Load Balancer (SLB) instances.

    • 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 ECS instance.

    • The ECS instance cannot be associated with a high-availability virtual IP address (HAVIP).

    • The vSwitch of the ECS instance cannot be associated with a custom route table.

    • Global Accelerator (GA) cannot be activated for the ECS instance.

    • Secondary ENIs cannot be attached to the ECS instance.

    • The ECS instance cannot be assigned an IPv6 address.

    • The primary ENI of the ECS instance cannot be associated with multiple IP addresses.

    • The vSwitch 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 ECS 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 ECS 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.

    • If you use a VPC that is shared by another Alibaba Cloud account with your account and want to change the security groups of the ECS instance, specify the security groups that you created in the VPC, instead of the security group created by the VPC owner, as the new security groups.