ModifyInstanceVpcAttribute

Description

The target ECS 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:
  • A newly created instance must be restarted before you call this operation.
  • 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, 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 (DTS).
  • Network:
    • The cut-through mode or multi-EIP to 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 be attached with a secondary NIC.
    • The instance cannot be assigned with an IPv6 address.
    • The primary NIC of the instance cannot be associated with multiple IP addresses.
    • The VSwitch must belong to the target VPC.
    • The zones of the VSwitches before and after the modification must be the same.
    • If the private IP address of the primary NIC 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 target VSwitch CIDR block must be sufficient.
    • If advanced features are enabled in the target VPC, refer to Instance families that do not support advanced VPC features for the application scope of advanced features.
    • The Alibaba Cloud account that owns the target 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 are based on the maximum number of security groups to which the instance can belong. For more information, see the "Security groups" section in Limits.
    • The VPC to which the security group belongs must be the target 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 affecting the instance network. For more information, see Security group 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.