调用ModifyInstanceVpcAttribute修改一台专有网络类型ECS实例的专有网络VPC、私网IP地址或虚拟交换机。

接口说明

调用接口时,ECS实例的状态必须是已停止Stopped)。

  • 当您使用该接口修改实例的私网IP地址或虚拟交换机时,请注意:
    • 新建的ECS实例必须经过重启才能调用该接口。
    • 成功修改一次后,ECS实例必须经过重启才能继续调用该接口。
  • 当您使用该接口修改实例的专有网络VPC时,请注意:
    • 实例:
      • 不支持负载均衡实例。
      • 实例的状态不能为已锁定、等待释放、已过期、过期回收中、欠费回收中,详情请参见实例生命周期介绍。此外,实例也不能在迁移中或已在更换VPC。
    • 网络:
      • 不支持绑定辅助网卡的实例。
      • 不支持已分配IPv6地址的实例。
      • 不支持主网卡有多IP的实例。
      • 传入的虚拟交换机必须属于目标VPC。
      • 修改前后虚拟交换机可用区必须一致。
      • 如果指定主网卡私网IP,则IP必须在虚拟交换机地址段内且可用。如果不指定则随机分配,且目标虚拟交换机的可用IP数充足。
      • 如果目标VPC开启了高级网络特性,则不支持的实例规格族请参见不支持VPC高阶特性的实例规格族
      • 目标VPC的所有者账号(资源所有者),不能将该目标VPC共享给其他账号(资源使用者)使用。
    • 安全组(SecurityGroupId.N):
      • 安全组列表必须属于同一种类型。
      • 安全组的配额与实例能够加入安全组的限制有关,详情请参见使用限制的安全组章节。
      • 安全组所属的VPC必须与目标VPC一致。
      • 支持切换安全组的类型。

        当ECS实例跨类型切换安全组时,您需要充分了解两种安全组规则的配置区别,避免影响实例网络,详情请参见安全组概述

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyInstanceVpcAttribute

接口名称。对于您自行拼凑HTTP/HTTPS URL发起的API请求,Action为必选参数。取值:ModifyInstanceVpcAttribute

InstanceId String i-bp1iudwa5b1tqag1****

实例ID。

VSwitchId String vsw-bp1s5fnvk4gn3tw12****

虚拟交换机ID。

  • 传入的ID为实例的当前虚拟交换机时,表明实例不变更虚拟交换机。
  • 传入的ID为一台新的虚拟交换机,并且参数VpcId为空时,新旧虚拟交换机必须属于同一个可用区、同一个专有网络VPC。
  • 当参数VpcId不为空时,该参数传入的虚拟交换机ID必须属于VpcId,并且和原虚拟交换机属于同一个可用区。
PrivateIpAddress String 172.17.**.***

新的私网IP地址。

说明 PrivateIpAddress依赖于VSwitchId,指定的IP地址必须在虚拟交换机子网网段中。

默认值:当不传该值时,从虚拟交换机子网网段中随机分配。

VpcId String vpc-bp1vwnn14rqpyiczj****

目标VPC ID。

SecurityGroupId.N RepeatList sg-o6w9l8bc8dgmkw87****

实例修改VPC后加入的安全组ID。当且仅当传入VpcId参数时,需要同时传入该参数。

  • 安全组类型必须一致。
  • 指定实例修改后加入的安全组列表,可以是一个或者多个。参数中N的取值范围与实例能够加入安全组的限制有关,详情请参见使用限制的安全组章节。
  • 专有网络类型ECS实例的安全组必须属于VpcId所在的VPC。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

示例

请求示例

https://ecs.aliyuncs.com/?Action=ModifyInstanceVpcAttribute
&InstanceId=i-bp1iudwa5b1tqag1****
&VSwitchId=vsw-bp1s5fnvk4gn3tw12****
&<公共请求参数>

正常返回示例

XML 格式

<ModifyInstanceAttributeResponse>
      <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceAttributeResponse>

JSON 格式

{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. 指定的实例不存在,请您检查实例ID是否正确。
400 InvalidPrivateIpAddress.Malformed Specified private IP address is malformed. 指定的私有IP不合法。
400 InvalidPrivateIpAddress.Duplicated Specified private IP address is duplicated. 指定的私网IP已经被使用,请您更换IP再重试。
400 IncorrectVSwitchStatus The current status of virtual switch does not support this operation. 指定的虚拟交换机处于pending状态,无法删除。
404 InvalidVSwitchId.NotFound Specified virtual switch does not exist. 指定的虚拟交换机ID不存在。
400 IncorrectInstanceStatus The current status of instance does not support this operation. 目前实例状态不支持此类操作。
400 OperationDenied Specified operation is denied as your instance is not in VPC. 该实例不是VPC实例。
400 InvalidVSwitchId.Mismatch Specified instance and virtual switch are not in the same zone. 指定的实例和指定的虚拟交换机不属于同一个可用区。
400 InvalidPrivateIpAddress.Mismatch Specified private IP address is not in the CIDR block of virtual switch. 指定的私网IP不在指定虚拟交换机的网段中。
404 InvalidVSwitchId.NotFound Specified virtual switch is not found in current VPC. 当前 VPC 中不存在指定的虚拟交换机。
400 InvalidPrivateIp.Changing Previous action is not finished yet. 实例修改私网IP未完成,不能再进行在修改。
404 NoSuchResource The specified resource is not found. 指定的资源不存在。
400 InvalidPrivateIpAddress.Duplicated error new ip is the same with old ip 新的 IP 地址必须不同于旧的 IP 地址。
500 InternalError The request processing has failed due to some unknown error. 内部错误,请重试。如果多次尝试失败,请提交工单。
403 OperationDenied %s 拒绝操作
403 SecurityGroupInstanceLimitExceed %s 该安全组内已有的实例数量已达到最大限制。
404 InvalidSecurityGroupId.NotFound %s 指定的安全组 ID 不存在。

访问错误中心查看更多错误码。