全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
云服务器 ECS

ModifyInstanceVpcAttribute

更新时间:2017-09-12 17:11:01

描述

修改 ECS 实例的 VPC 属性。

  • 专有网络相关的接口,参见 专有网络 VPC 的 API 参考
  • 指定 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 The specified InstanceId 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)

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=ModifyInstanceVpcAttribute
  2. &InstanceId=35F20777-0DFF-C152-41FA-BCE0EA0B2FD7
  3. &VSwitchId=[vswitchid]
  4. &<公共请求参数>

返回示例

XML 格式

  1. <ModifyInstanceAttributeResponse>
  2. <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
  3. </ModifyInstanceAttributeResponse>

JSON 格式

  1. {
  2. "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
  3. }
本文导读目录