全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
云服务器 ECS

ModifyInstanceVpcAttribute

更新时间:2018-01-29 11:50:36

描述

修改 ECS 实例的专有网络(VPC)属性。

  • 专有网络相关的接口,参见 专有网络(VPC)的 API 参考
  • 仅支持修改 已停止Stopped)状态下 ECS 实例的 VPC 属性。
  • 新建的 ECS 实例必须要经过一轮启动和停止才能调用该接口。
  • 已成功修改 VPC 属性的 ECS 实例必须要经过一轮启动和停止才能调用该接口。
  • 指定 VSwitchId 修改 VPC 属性时,指定的 VSwitchId,必须属于当前的专有网络。
  • 指定 VSwitchId 不指定 PrivateIpAddress 时,系统自动为 ECS 实例分配一个私网 IP。
  • 指定实例的当前交换机和新的交换机(VSwitchId)必须要属于同一个地域下的可用区。
  • 指定实例的当前交换机和新的交换机(VSwitchId)必须要属于同一个 VPC 。
  • 同时指定 VSwitchIdPrivateIpAddress 时,私网 IP 要属于指定交换机的 网段PrivateIpAddress 依赖于 VSwitchId,不能单独指定 PrivateIpAddress

请求参数

名称 类型 是否必需 描述
Action String 系统规定参数。取值:ModifyInstanceVpcAttribute
InstanceId String 指定的实例 ID。
VSwitchId String 新的交换机 ID。指定实例的当前交换机和新的交换机(VSwitchId)必须要属于同一个地域下的可用区。
PrivateIpAddress String 新的私网 IP 地址。PrivateIpAddress 依赖于 VSwitchId,不能单独指定 PrivateIpAddress

返回参数

全是公共返回参数,详见 公共参数

示例

请求示例

  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. }

错误码

错误代码 错误信息 HTTP 状态码 说明
IncorrectInstanceStatus The current status of instance does not support this operation. 400 仅支持修改 已停止Stopped)状态下 ECS 实例的 VPC 属性。
InvalidPrivateIp.Changing Previous action is not finished yet. 400 实例修改私网 IP 暂未完成,无法重复操作。
InvalidPrivateIp.Changing Specified private IP address is not in the CIDR block of virtual switch. 400 已成功修改 VPC 属性的 ECS 实例必须要经过一轮启动和停止才能调用该接口。
InvalidPrivateIpAddress.Duplicated Specified private IP address is duplicated. 400 指定的私网 IP 已经被占用。
InvalidPrivateIpAddress.Malformed Specified private IP address is malformed. 400 指定的私网 IP 不合法。
InvalidPrivateIpAddress.Mismatch Specified private IP address is not in the CIDR block of virtual switch. 400 指定的私网 IP 不在指定交换机的网段中
InvalidVSwitchId.Mismatch Specified instance and virtual switch are not in the same zone. 400 指定的实例和指定的交换机(VSwitchId)必须属于同一个地域下的同一可用区。
OperationDenied Specified operation is denied as your instance is not in VPC. 400 指定的实例的网络类型必须是专有网络(VPC)。
InvalidInstanceId.NotFound The specified InstanceId does not exist. 404 指定的 ECS 实例不存在。
InvalidVSwitchId.NotFound Specified virtual switch does not exist. 404 指定的 VSwicthId 不存在。
InvalidVSwitchId.NotFound Specified virtual switch is not found in current VPC. 404 指定实例的当前交换机和新的交换机(VSwitchId)必须要属于同一个 VPC 。
本文导读目录