調用ModifyInstanceVpcAttribute修改一臺專有網絡類型ECS實例的專有網絡VPC、私網IP地址或虛擬交換機。
接口說明
調用接口時,ECS 實例的狀態必須是已停止(Stopped
)。
-
當您使用該接口修改實例的私網 IP 地址或虛擬交換機時,請注意:
- 新建的 ECS 實例必須經過重啟才能調用該接口。
- 成功修改一次后,ECS 實例必須經過重啟才能繼續調用該接口。
-
當您使用該接口修改實例的專有網絡 VPC 時,請注意:
- 實例:
- 不支持已關聯負載均衡實例的 ECS 實例。
- 實例的狀態不能為已鎖定、等待釋放、已過期、過期回收中、欠費回收中。更多信息,請參見實例生命周期介紹。
- 實例不能在其它云服務中被使用。例如,實例不能在遷移中、不能已在更換 VPC 或實例內部署的數據庫不能被 DTS 服務管理等。
- 網絡:
- 不支持配置了 EIP 網卡可見模式或多 EIP 網卡可見模式的實例。
- 不支持綁定高可用虛擬 IP(HaVip)的實例。
- 不支持交換機綁定了自定義路由表的實例。
- 不支持開通了全球加速(GA)的實例。
- 不支持綁定輔助網卡的實例。
- 不支持已分配 IPv6 地址的實例。
- 不支持主網卡有多 IP 的實例。
- 傳入的虛擬交換機必須屬于目標 VPC。
- 修改前后虛擬交換機可用區必須一致。
- 如果指定主網卡私網 IP,則 IP 必須在虛擬交換機地址段內且可用。如果不指定則隨機分配,且目標虛擬交換機的可用 IP 數充足。
- 目標 VPC 的所有者賬號(資源所有者),不能將該目標 VPC 共享給其他賬號(資源使用者)使用。
- 安全組(SecurityGroupId.N):
- 實例:
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceId | string | 是 | 實例 ID。 | i-bp1iudwa5b1tqag1**** |
VSwitchId | string | 是 | 虛擬交換機 ID。
| vsw-bp1s5fnvk4gn3tw12**** |
PrivateIpAddress | string | 否 | 新的私網 IP 地址。 說明
PrivateIpAddress 依賴于VSwitchId ,指定的 IP 地址必須在虛擬交換機子網網段中。
默認值:當不傳該值時,從虛擬交換機子網網段中隨機分配。 | 172.17.**.** |
VpcId | string | 否 | 目標 VPC ID。 | vpc-bp1vwnn14rqpyiczj**** |
SecurityGroupId | array | 否 | 實例修改 VPC 后加入的安全組 ID 列表。當且僅當傳入
| |
string | 否 | 安全組 ID。 | sg-o6w9l8bc8dgmkw87**** |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InvalidTarget.TrafficMirrorSession | Instance is target of traffic mirror session. | - |
400 | InvalidSource.TrafficMirrorSession | Instance is source of traffic mirror session. | - |
400 | InvalidPrivateIpAddress.Malformed | Specified private IP address is malformed. | 指定的私有 IP 不合法。 |
400 | InvalidPrivateIpAddress.Duplicated | Specified private IP address is duplicated. | - |
400 | IncorrectVSwitchStatus | The current status of virtual switch does not support this operation. | 指定的虛擬交換機處于 pending 狀態,無法刪除。 |
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 不在指定虛擬交換機的網段中。 |
400 | InvalidPrivateIp.Changing | Previous action is not finished yet. | 實例修改私網IP未完成,不能再進行在修改。 |
400 | InvalidPrivateIpAddress.Duplicated | The specified IP address already exists on current ENI. | - |
400 | OperationDenied | The operation is denied due to existence of an SNAT entity. | - |
400 | PrimaryEniHasSubIp | Primary network interface of the specified instance has more than one private ip. | 主網卡有多個輔助私網IP。 |
400 | VSwitchIdNotMatch | The subnet of private ip is different to the instance, please unbind ha vip. | 虛擬交換機地址段,不包含指定的IP,請檢查。 |
400 | InvalidOperation.EniCountExceeded | The number of ENIs in an enterprise security group has reached the maximum limit. | - |
400 | InvalidParameter.SecurityGroupId | Security group ids are invalid. | 無效的安全組ID |
400 | InvalidPrivateIpAddress.Duplicated | The specified private IP address "%s" is duplicated. | 指定的IP地址已經被使用。 |
401 | InvalidOperation.SecurityGroupNotAuthorized | The specified security group is not authorized to operate. | 沒有權限操作當前安全組 |
403 | OperationDenied | The Specified operation is denied as your instance is locked for security reasons. | 實例由于安全問題被鎖定,指定操作被拒絕。 |
403 | InvalidIp.Ipv6Assigned | The specified instance has been assigned IPv6 address. | - |
403 | OperationDenied | %s | 拒絕操作。 |
403 | SecurityGroupInstanceLimitExceed | %s | 該安全組內已有的實例數量已達到最大限制。 |
403 | InvalidInstance.HasTransitionRecord | The operation is denied because the specified instance has a migration plan. | - |
403 | InvalidInstanceStatus.NotNormal | The Specified operation is denied due to instance status. | - |
403 | InvalidVpcId.SharedVpc | The Specified operation is denied as your targe vpc is SharedVpc. | - |
403 | InvalidOperation.NotAllowed | The operation is denied because the specified VPC has advanced features enabled. | - |
403 | InvalidParameter.ToSecurityGroupId | %s | - |
403 | InvalidOperation.ResourceManagedByCloudProduct | %s | 云產品托管的安全組不支持修改操作。 |
403 | InvalidOperation.VswAndEcsAvailabilityZoneMismatch | Specified instance and virtual switch are not in the same zone. | 實例和目標交換機不屬于同一個可用區。 |
403 | InvalidOperation.CloudBoxEcsNotSupport | Cloud box ecs instance does not support modifying VPC. | 云盒實例不支持修改VPC |
403 | AclLimitExceed | %s | 網卡或實例的安全組規則數量超過限額值。 |
404 | InvalidInstanceId.NotFound | The specified InstanceId does not exist. | 指定的實例ID未找到。 |
404 | InvalidVSwitchId.NotFound | Specified virtual switch does not exist. | 指定的虛擬交換機 ID 不存在。 |
404 | InvalidVSwitchId.NotFound | Specified virtual switch is not found in current VPC. | 當前 VPC 中不存在指定的虛擬交換機。 |
404 | NoSuchResource | The specified resource is not found. | 指定的資源不存在。 |
404 | InvalidParameter.InvalidInstanceId | The specified InstanceId does not exist. | - |
404 | InvalidParameter.VSwitchId | The specified virtual vswitch does not exist. | 指定的交換機不存在。 |
404 | InvalidRegion.ValueNotSupported | The specified Region does not exist. | - |
404 | InvalidInstance.AttachedEni | The Specified operation is denied due to elastic network interface. | 實例綁定了輔助網卡,不允許更換VPC。 |
404 | InvalidIp.MultiPrimaryIp | The Specified operation is denied due to multi private ip. | 主網卡有多個私網IP,不允許該操作。 |
404 | InvalidIp.Ipv6 | The Specified operation is denied due to ipv6. | - |
404 | InvalidVSwitch.NotBelongToVpc | %s | 指定的VSwitchId不屬于指定的VPC。請檢查參數值是否正確。 |
404 | InvalidParameter.EniNo | %s | - |
404 | InvalidSecurityGroupId.NotFound | %s | 指定的安全組 ID 不存在。 |
404 | InvalidParameter.SecurityGroupIdRepeated | %s | - |
404 | InvalidSecurityGroupType.NotSupportClassic | The specified SecurityGroupIds have classic group type. | 指定的安全組的網絡類型為經典網絡。請檢查 SecurityGroupIds 參數值是否正確。 |
404 | InvalidSecurityGroupVpc.NotBelongToOneVpc | The specified SecurityGroupIds are belong to different vpc. | 指定的安全組ID屬于不同的VPC。請檢查 SecurityGroupIds 參數值是否正確。您可以調用 DescribeSecurityGroups 查詢指定安全組所屬的VPC。 |
404 | EnterpriseGroupLimited.MutliGroupType | The specified instance can not join multi SecurityGroup types. | 指定的實例不能同時加入普通安全組和企業安全組。您可以調用 DescribeSecurityGroups 查詢指定安全組的類型。 |
404 | InvalidParameter.AlreadyInTargetVpc | The specified instance is already in the destination VPC. | - |
404 | InvalidParameter.SecurityGroupId | The specified SecurityGroupId.N is invalid or does not exist. | - |
404 | JoinedGroupLimitExceed | The specified instance has exceed quota of SecurityGroup. | - |
404 | InvalidParameter.MustBeEmpty | The specified parameter SecurityGroupId.N and VpcId need be empty. | 指定的參數,SecurityGroupId.N和VpcId必須為空。 |
404 | InvalidParameter.NotEnoughIpInVSwitch | The specified virtual switch has not enough available ip. | - |
404 | InvalidDependence.MutliDirectlyEip | The Specified operation is denied due to multi directly Eips. | - |
404 | InvalidDependence.HaVip | The Specified operation is denied due to HaVip. | - |
404 | InvalidDependence.NextHopOfCustomRouter | The Specified operation is denied due to next hop of Custom Router. | 指定的實例是自定義路由的下一跳,不允許操作。 |
404 | InvalidDependence.BeenUsedAsAppServer | The Specified operation is denied due to AppServer. | - |
404 | InvalidDependence.GrantAccess | The Specified operation is denied due to grant access. | ECS實例可能使用了其他產品(DBS、DTS、DMS、Workbench等),有授權其它產品訪問的記錄,存在反向訪問規則。 |
404 | InvalidDependence.BindGA | The Specified operation is denied due to GA. | - |
404 | InvalidDependence.SLB | The Specified operation is denied as your instance with alb or clb. | 由于實例綁定ALB或者CLB,該操作被拒絕。 |
500 | InternalError | The request processing has failed due to some unknown error. | 內部錯誤,請重試。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-07-03 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-01-23 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-12-19 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-12-15 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2023-04-27 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |