修改一台 ECS 執行個體的專有網路 VPC 屬性。
描述
- 僅支援修改 已停止(
Stopped
)狀態下 ECS 執行個體的 VPC 屬性。 - 新建的 ECS 執行個體必須要經過一輪啟動和停止才能調用該介面。
- 已成功修改 VPC 屬性的 ECS 執行個體必須要經過一輪啟動和停止才能調用該介面。
- 指定
VSwitchId
修改 VPC 屬性時,指定的VSwitchId
,必須屬於當前的專有網路。 - 指定
VSwitchId
不指定PrivateIpAddress
時,系統自動為 ECS 執行個體分配一個私網 IP。 - 指定執行個體的當前交換器和新的交換器(
VSwitchId
)必須要屬於同一個地域下的可用性區域。 - 指定執行個體的當前交換器和新的交換器(
VSwitchId
)必須要屬於同一個 VPC 。 - 同時指定
VSwitchId
和PrivateIpAddress
時,私網 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 。 |