ModifyInstanceVpcAttribute

Description

The instance must be in the Stopped (Stopped) state.

• When you call this operation to modify 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 on it.
  • After the private IP address or vSwitch of an instance is modified, you must restart the instance before you can call this operation again.
• When you call this operation to modify 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, To Be Recycled, Expired and Being Recycled, or Overdue and Being Recycled state. For more information, see ECS instance lifecycle.
    • The instance cannot be used in other 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 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.
    • The instance cannot have Global Acceleration (GA) activated.
    • The instance cannot be attached with a secondary ENI.
    • The instance cannot be assigned an IPv6 address.
    • The primary ENI of the instance cannot be associated with multiple IP addresses.
    • The vSwitch must belong to the new VPC.
    • The zones of the vSwitches before and after the modification must be the same.
    • If the private IP address of the primary ENI is specified, the private IP address must be available and within the CIDR block of the vSwitch. If the private IP address is not specified, the system randomly assigns one. The available IP addresses in the new vSwitch CIDR block must be sufficient.
    • If advanced features are enabled in the new VPC, take note of the instance families that do not support advanced VPC features. For more information, see Instance families that do not support advanced VPC features.
    • The Alibaba Cloud account that owns the new VPC cannot share the VPC to other accounts.
  • Security group (SecurityGroupId.N):
    • All security groups must be of the same type.
    • The valid values of N depend 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 VPC to which the security group belongs must be the new VPC.

    • You can switch the instance to a security group of a different type.

      When you switch an ECS instance to a security group of a different type, you must understand the differences between the rule configurations of the two security group types to avoid impacts on the instance network. For more information, see Overview.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=ModifyInstanceVpcAttribute
&InstanceId=i-bp1iudwa5b1tqag1****
&VSwitchId=vsw-bp1s5fnvk4gn3tw12****
&<Common request parameters>

Sample success responses

XML format

<ModifyInstanceAttributeResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceAttributeResponse>

JSON format

{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Error codes

For a list of error codes, visit the API Error Center.