修改实例VPC属性
描述
修改云服务器实例的 VPC 属性。
指定 VSwitchId 修改 VPC 属性时，指定的 VSwitchId，必须属于当前的专有网络。
指定实例的当前交换机和新的交换机必须要属于同一个可用区。
指定 VSwitchId 不指定 PrivateIpAddress 时，系统自动为云服务器实例分配一个空闲的私网 IP。
同时指定 VSwitchId 和 PrivateIpAddress 时，私网 IP 要属于指定交换机的网段。
PrivateIpAddress 依赖于 VSwitchId，不能单独指定 PrivateIpAddress。
进行修改操作的云服务器实例必须是 Stopped 状态，新创建的云服务器实例必须要经过一次启动 / 停止才能更改所属的交换机。
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
String
是
系统规定参数，取值：ModifyInstanceVpcAttribute
InstanceId
String
是
指定的实例 ID
VSwitchId
String
是
新的交换机 ID，不能跨可用区修改实例的交换机
PrivateIpAddress
String
否
新的私网 IP 地址，不能单独指定
返回参数
全是公共返回参数，详见公共返回参数
错误码
错误代码 |
描述 |
Http 状态码 |
语义 |
InvalidVSwitchId.NotFound
Specified virtual switch does not exist.
404
指定的交换机 ID 不存在
InvalidVSwitchId.Mismatch
Specified instance and virtual switch are not in the same zone.
400
指定的实例和指定的交换机不属于同一个可用区
InvalidInstanceId.NotFound
Specified instance does not exist.
404
指定的 ECS 实例不存在
InvalidPrivateIpAddress.Mismatch
Specified private IP address is not in the CIDR block of virtual switch.
400
指定的私网 IP 不在指定交换机的网段中
InvalidPrivateIpAddress.Malformed
Specified private IP address is malformed.
400
指定的私有 IP 不合法
InvalidPrivateIpAddress.Duplicated
Specified private IP address is duplicated.
400
指定的私网 IP 已经被使用
InvalidPrivateIp.Changing
Previous action is not finished yet.
400
实例修改私网 IP 为完成，不能再进行在修改
InvalidVSwitchId.NotFound
Specified virtual switch is not found in current VPC.
404
不能跨 VPC 修改实例的交换机。
IncorrectInstanceStatus
The current status of instance does not support this operation.
400
不在已停止状态的实例不能进行此操作。
OperationDenied
Specified operation is denied as your instance is not in VPC.
400
实例不是 VPC 类型
InvalidPrivateIp.Changing
Specified private IP address is not in the CIDR block of virtual switch.
400
实例正在修改私网 IP 过程中（实例一次 stop 只能修改一次私网 IP）
示例
请求示例
https://ecs.aliyuncs.com/?Action=ModifyInstanceVpcAttribute
&InstanceId=35F20777-0DFF-C152-41FA-BCE0EA0B2FD7
&VSwitchId=[vswitchid]
&<公共请求参数>
返回示例
XML格式
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
所属专题: