ModifyInstanceVpcAttribute

Description

The 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 points:
  • A newly created instance must be restarted to 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 points:
  • Instance:
    • The instance cannot be a Server Load Balancer (SLB) instance.
    • 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 also cannot be in the process of migration or VPC changing.
  • Network:
    • 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 within the CIDR block of the VSwitch and available. If the private IP address is not specified, the system randomly assigns one. Therefore, 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.