修改实例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"
}