接口说明

调用接口时，ECS实例的状态必须是已停止（Stopped）。

• 当您使用该接口修改实例的私网IP地址或虚拟交换机时，请注意：
  • 新建的ECS实例必须经过重启才能调用该接口。
  • 成功修改一次后，ECS实例必须经过重启才能继续调用该接口。
• 当您使用该接口修改实例的专有网络VPC时，请注意：
  • 实例：
    • 不支持已关联负载均衡实例的ECS实例。
    • 实例的状态不能为已锁定、等待释放、已过期、过期回收中、欠费回收中。更多信息，请参见实例生命周期介绍。
    • 实例不能在其它云服务中被使用。例如，实例不能在迁移中、不能已在更换VPC或实例内部署的数据库不能被DTS服务管理等。
  • 网络：
    • 不支持配置了EIP网卡可见模式或多EIP网卡可见模式的实例。
    • 不支持绑定高可用虚拟IP（HaVip）的实例。
    • 不支持交换机绑定了自定义路由表的实例。
    • 不支持开通了全球加速（GA）的实例。
    • 不支持绑定辅助网卡的实例。
    • 不支持已分配IPv6地址的实例。
    • 不支持主网卡有多IP的实例。
    • 传入的虚拟交换机必须属于目标VPC。
    • 修改前后虚拟交换机可用区必须一致。
    • 如果指定主网卡私网IP，则IP必须在虚拟交换机地址段内且可用。如果不指定则随机分配，且目标虚拟交换机的可用IP数充足。
    • 如果目标VPC开启了高级网络特性，则需要注意部分实例规格族不支持该特性。更多信息，请参见不支持VPC高阶特性的实例规格族。
    • 目标VPC的所有者账号（资源所有者），不能将该目标VPC共享给其他账号（资源使用者）使用。
  • 安全组（SecurityGroupId.N）：
    • 安全组列表必须属于同一种类型。
    • 安全组的配额与实例能够加入安全组的限制有关。更多信息，请参见使用限制。
    • 安全组所属的VPC必须与目标VPC一致。

    • 支持切换安全组的类型。

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

请求参数

返回数据

示例

请求示例

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

错误码

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