ModifyInstanceVpcAttribute - 修改专有网络类型实例的VPC属性

修改一台专有网络ECS实例的专有网络VPC、私网IP地址、安全组ID或虚拟交换机。

接口说明

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

  • 当您使用该接口修改实例的私网 IP 地址或虚拟交换机时,请注意:

    • 新建的 ECS 实例必须经过重启才能调用该接口。
    • 成功修改一次后,ECS 实例必须经过重启才能继续调用该接口。
  • 当您使用该接口修改实例的专有网络 VPC 时,请注意:

    • 实例:
      • 不支持已关联负载均衡实例的 ECS 实例。
      • 实例的状态不能为已锁定、等待释放、已过期、过期回收中、欠费回收中。更多信息,请参见实例生命周期介绍
      • 实例不能在其它云服务中被使用。例如,实例不能在迁移中、不能已在更换 VPC 或实例内部署的数据库不能被 DTS 服务管理等。
    • 网络:
      • 不支持配置了 EIP 网卡可见模式或多 EIP 网卡可见模式的实例。
      • 不支持绑定高可用虚拟 IP(HaVip)的实例。
      • 不支持交换机绑定了自定义路由表的实例。
      • 不支持开通了全球加速(GA)的实例。
      • 不支持绑定辅助网卡的实例。
      • 不支持已分配 IPv6 地址的实例。
      • 不支持主网卡有多 IP 的实例。
      • 传入的虚拟交换机必须属于目标 VPC。
      • 修改前后虚拟交换机可用区必须一致。
      • 如果指定主网卡私网 IP,则 IP 必须在虚拟交换机地址段内且可用。如果不指定则随机分配,且目标虚拟交换机的可用 IP 数充足。
      • 如果您使用的是其他账号共享给您的 VPC,那么您需要确保目标安全组是由您的账号在该共享 VPC 中创建的,而不是由 VPC 所有者的账号创建的安全组。
    • 安全组(SecurityGroupId.N):
      • 安全组列表必须属于同一种类型。
      • 安全组的配额与实例能够加入安全组的限制有关。更多信息,请参见使用限制
      • 安全组所属的 VPC 必须与目标 VPC 一致。
      • 支持切换安全组的类型。 当 ECS 实例跨类型切换安全组时,您需要充分了解两种安全组规则的配置区别,避免影响实例网络。更多信息,请参见安全组概述

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
ecs:ModifyInstanceVpcAttributeupdate
*Instance
acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}
*VSwitch
acs:vpc:{#regionId}:{#accountId}:vswitch/{#vswitchId}
  • vpc:tag
  • vpc:VPC

请求参数

名称类型必填描述示例值
InstanceIdstring

实例 ID。

i-bp1iudwa5b1tqag1****
VSwitchIdstring

虚拟交换机 ID。

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

新的私网 IP 地址。

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

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

172.17.**.**
VpcIdstring

目标 VPC ID。

vpc-bp1vwnn14rqpyiczj****
SecurityGroupIdarray

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

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

安全组 ID。

sg-o6w9l8bc8dgmkw87****

返回参数

名称类型描述示例值
object
RequestIdstring

请求 ID。

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400InvalidTarget.TrafficMirrorSessionInstance is target of traffic mirror session.-
400InvalidSource.TrafficMirrorSessionInstance is source of traffic mirror session.-
400InvalidPrivateIpAddress.MalformedSpecified private IP address is malformed.指定的私有 IP 不合法。
400InvalidPrivateIpAddress.DuplicatedSpecified private IP address is duplicated.-
400IncorrectVSwitchStatusThe current status of virtual switch does not support this operation.指定的虚拟交换机处于 pending 状态,无法删除。
400IncorrectInstanceStatusThe current status of instance does not support this operation.目前实例状态不支持此类操作。
400OperationDeniedSpecified operation is denied as your instance is not in VPC.该实例不是 VPC 实例。
400InvalidVSwitchId.MismatchSpecified instance and virtual switch are not in the same zone.指定的实例和指定的虚拟交换机不属于同一个可用区。
400InvalidPrivateIpAddress.MismatchSpecified private IP address is not in the CIDR block of virtual switch.指定的私网 IP 不在指定虚拟交换机的网段中。
400InvalidPrivateIp.ChangingPrevious action is not finished yet.实例修改私网IP未完成,不能再进行在修改。
400InvalidPrivateIpAddress.DuplicatedThe specified IP address already exists on current ENI.-
400OperationDeniedThe operation is denied due to existence of an SNAT entity.-
400PrimaryEniHasSubIpPrimary network interface of the specified instance has more than one private ip.主网卡有多个辅助私网IP。
400VSwitchIdNotMatchThe subnet of private ip is different to the instance, please unbind ha vip.虚拟交换机地址段,不包含指定的IP,请检查。
400InvalidOperation.EniCountExceededThe number of ENIs in an enterprise security group has reached the maximum limit.-
400InvalidParameter.SecurityGroupIdSecurity group ids are invalid.无效的安全组ID
400InvalidPrivateIpAddress.DuplicatedThe specified private IP address "%s" is duplicated.指定的IP地址已经被使用。
401InvalidOperation.SecurityGroupNotAuthorizedThe specified security group is not authorized to operate.没有权限操作当前安全组
403OperationDeniedThe Specified operation is denied as your instance is locked for security reasons.实例由于安全问题被锁定,指定操作被拒绝。
403InvalidIp.Ipv6AssignedThe specified instance has been assigned IPv6 address.-
403OperationDenied%s拒绝操作。
403SecurityGroupInstanceLimitExceed%s该安全组内已有的实例数量已达到最大限制。
403InvalidInstance.HasTransitionRecordThe operation is denied because the specified instance has a migration plan.-
403InvalidInstanceStatus.NotNormalThe Specified operation is denied due to instance status.-
403InvalidVpcId.SharedVpcThe Specified operation is denied as your targe vpc is SharedVpc.-
403InvalidOperation.NotAllowedThe operation is denied because the specified VPC has advanced features enabled.-
403InvalidParameter.ToSecurityGroupId%s-
403InvalidOperation.ResourceManagedByCloudProduct%s云产品托管的安全组不支持修改操作。
403InvalidOperation.VswAndEcsAvailabilityZoneMismatchSpecified instance and virtual switch are not in the same zone.实例和目标交换机不属于同一个可用区。
403InvalidOperation.CloudBoxEcsNotSupportCloud box ecs instance does not support modifying VPC.云盒实例不支持修改VPC
403AclLimitExceed%s网卡或实例的安全组规则数量超过限额值。
404InvalidInstanceId.NotFoundThe specified InstanceId does not exist.指定的InstanceId不存在。
404InvalidVSwitchId.NotFoundSpecified virtual switch does not exist.指定的虚拟交换机 ID 不存在。
404InvalidVSwitchId.NotFoundSpecified virtual switch is not found in current VPC.当前 VPC 中不存在指定的虚拟交换机。
404NoSuchResourceThe specified resource is not found.指定的资源不存在。
404InvalidParameter.InvalidInstanceIdThe specified InstanceId does not exist.-
404InvalidParameter.VSwitchIdThe specified virtual vswitch does not exist.指定的交换机不存在。
404InvalidRegion.ValueNotSupportedThe specified Region does not exist.-
404InvalidInstance.AttachedEniThe Specified operation is denied due to elastic network interface.实例绑定了辅助网卡,不允许更换VPC。
404InvalidIp.MultiPrimaryIpThe Specified operation is denied due to multi private ip.主网卡有多个私网IP,不允许该操作。
404InvalidIp.Ipv6The Specified operation is denied due to ipv6.-
404InvalidVSwitch.NotBelongToVpc%s指定的VSwitchId不属于指定的VPC。请检查参数值是否正确。
404InvalidParameter.EniNo%s-
404InvalidSecurityGroupId.NotFound%s指定的安全组 ID 不存在。
404InvalidParameter.SecurityGroupIdRepeated%s-
404InvalidSecurityGroupType.NotSupportClassicThe specified SecurityGroupIds have classic group type.指定的安全组的网络类型为经典网络。请检查 SecurityGroupIds 参数值是否正确。
404InvalidSecurityGroupVpc.NotBelongToOneVpcThe specified SecurityGroupIds are belong to different vpc.指定的安全组ID属于不同的VPC。请检查 SecurityGroupIds 参数值是否正确。您可以调用 DescribeSecurityGroups 查询指定安全组所属的VPC。
404EnterpriseGroupLimited.MutliGroupTypeThe specified instance can not join multi SecurityGroup types.指定的实例不能同时加入普通安全组和企业安全组。您可以调用 DescribeSecurityGroups 查询指定安全组的类型。
404InvalidParameter.AlreadyInTargetVpcThe specified instance is already in the destination VPC.-
404InvalidParameter.SecurityGroupIdThe specified SecurityGroupId.N is invalid or does not exist.-
404JoinedGroupLimitExceedThe specified instance has exceed quota of SecurityGroup.-
404InvalidParameter.MustBeEmptyThe specified parameter SecurityGroupId.N and VpcId need be empty.指定的参数,SecurityGroupId.N和VpcId必须为空。
404InvalidParameter.NotEnoughIpInVSwitchThe specified virtual switch has not enough available ip.-
404InvalidDependence.MutliDirectlyEipThe Specified operation is denied due to multi directly Eips.-
404InvalidDependence.HaVipThe Specified operation is denied due to HaVip.-
404InvalidDependence.NextHopOfCustomRouterThe Specified operation is denied due to next hop of Custom Router.指定的实例是自定义路由的下一跳,不允许操作。
404InvalidDependence.BeenUsedAsAppServerThe Specified operation is denied due to AppServer.-
404InvalidDependence.GrantAccessThe Specified operation is denied due to grant access.ECS实例可能使用了其他产品(DBS、DTS、DMS、Workbench等),有授权其它产品访问的记录,存在反向访问规则。
404InvalidDependence.BindGAThe Specified operation is denied due to GA.-
404InvalidDependence.SLBThe Specified operation is denied as your instance with alb or clb.由于实例绑定ALB或者CLB,该操作被拒绝。
500InternalErrorThe request processing has failed due to some unknown error.内部错误,请重试。

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

变更历史

变更时间变更内容概要操作
2024-07-03OpenAPI 错误码发生变更查看变更详情
2024-01-23OpenAPI 错误码发生变更查看变更详情
2023-12-19OpenAPI 错误码发生变更查看变更详情
2023-12-15OpenAPI 错误码发生变更查看变更详情
2023-04-27OpenAPI 错误码发生变更查看变更详情