修改一台 ECS 執行個體的專有網路 VPC 屬性。

描述

  • 僅支援修改 已停止Stopped)狀態下 ECS 執行個體的 VPC 屬性。
  • 新建的 ECS 執行個體必須要經過一輪啟動和停止才能調用該介面。
  • 已成功修改 VPC 屬性的 ECS 執行個體必須要經過一輪啟動和停止才能調用該介面。
  • 指定 VSwitchId 修改 VPC 屬性時,指定的 VSwitchId,必須屬於當前的專有網路。
  • 指定 VSwitchId 不指定 PrivateIpAddress 時,系統自動為 ECS 執行個體分配一個私網 IP。
  • 指定執行個體的當前交換器和新的交換器(VSwitchId)必須要屬於同一個地域下的可用性區域。
  • 指定執行個體的當前交換器和新的交換器(VSwitchId)必須要屬於同一個 VPC 。
  • 同時指定 VSwitchIdPrivateIpAddress 時,私網 IP 要屬於指定交換器的 網段PrivateIpAddress 依賴於 VSwitchId,不能單獨指定 PrivateIpAddress
  • 更多 VPC 相關介面,請參見 專有網路(VPC)的 API 參考

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:ModifyInstanceVpcAttribute
InstanceId String 執行個體 ID。
VSwitchId String 新的交換器 ID。指定執行個體的當前交換器和新的交換器(VSwitchId)必須要屬於同一個地域下的可用性區域。
PrivateIpAddress String 新的私網 IP 位址。PrivateIpAddress 依賴於 VSwitchId,不能單獨指定 PrivateIpAddress

返回參數

全是公共返回參數。參閱 公共參數

樣本

請求樣本
https://ecs.aliyuncs.com/?Action=ModifyInstanceVpcAttribute
&InstanceId=35F20777-0DFF-C152-41FA-BCE0EA0B2FD7
&VSwitchId=[vswitchid]
&<公共請求參數>
返回樣本

XML 格式

<ModifyInstanceAttributeResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</ModifyInstanceAttributeResponse>
JSON 格式
{
    "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼,請訪問 API 錯誤中心

錯誤碼 錯誤資訊 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 指定執行個體的當前交換器和新的交換器必須要屬於同一個 VPC 。