修改實(shí)例VPC屬性
描述
修改云服務(wù)器實(shí)例的 VPC 屬性。
指定 VSwitchId 修改 VPC 屬性時(shí),指定的 VSwitchId,必須屬于當(dāng)前的專有網(wǎng)絡(luò)。
指定實(shí)例的當(dāng)前交換機(jī)和新的交換機(jī)必須要屬于同一個(gè)可用區(qū)。
指定 VSwitchId 不指定 PrivateIpAddress 時(shí),系統(tǒng)自動(dòng)為云服務(wù)器實(shí)例分配一個(gè)空閑的私網(wǎng) IP。
同時(shí)指定 VSwitchId 和 PrivateIpAddress 時(shí),私網(wǎng) IP 要屬于指定交換機(jī)的網(wǎng)段。
PrivateIpAddress 依賴于 VSwitchId,不能單獨(dú)指定 PrivateIpAddress。
進(jìn)行修改操作的云服務(wù)器實(shí)例必須是 Stopped 狀態(tài),新創(chuàng)建的云服務(wù)器實(shí)例必須要經(jīng)過一次啟動(dòng) / 停止才能更改所屬的交換機(jī)。
請(qǐng)求參數(shù)
名稱
類型
是否必須
描述
Action
String
是
系統(tǒng)規(guī)定參數(shù),取值:ModifyInstanceVpcAttribute
InstanceId
String
是
指定的實(shí)例 ID
VSwitchId
String
是
新的交換機(jī) ID,不能跨可用區(qū)修改實(shí)例的交換機(jī)
PrivateIpAddress
String
否
新的私網(wǎng) IP 地址,不能單獨(dú)指定
返回參數(shù)
全是公共返回參數(shù),詳見公共返回參數(shù)
錯(cuò)誤碼
錯(cuò)誤代碼
描述
Http 狀態(tài)碼
語義
InvalidVSwitchId.NotFound
Specified virtual switch does not exist.
404
指定的交換機(jī) ID 不存在
InvalidVSwitchId.Mismatch
Specified instance and virtual switch are not in the same zone.
400
指定的實(shí)例和指定的交換機(jī)不屬于同一個(gè)可用區(qū)
InvalidInstanceId.NotFound
Specified instance does not exist.
404
指定的 ECS 實(shí)例不存在
InvalidPrivateIpAddress.Mismatch
Specified private IP address is not in the CIDR block of virtual switch.
400
指定的私網(wǎng) IP 不在指定交換機(jī)的網(wǎng)段中
InvalidPrivateIpAddress.Malformed
Specified private IP address is malformed.
400
指定的私有 IP 不合法
InvalidPrivateIpAddress.Duplicated
Specified private IP address is duplicated.
400
指定的私網(wǎng) IP 已經(jīng)被使用
InvalidPrivateIp.Changing
Previous action is not finished yet.
400
實(shí)例修改私網(wǎng) IP 為完成,不能再進(jìn)行在修改
InvalidVSwitchId.NotFound
Specified virtual switch is not found in current VPC.
404
不能跨 VPC 修改實(shí)例的交換機(jī)。
IncorrectInstanceStatus
The current status of instance does not support this operation.
400
不在已停止?fàn)顟B(tài)的實(shí)例不能進(jìn)行此操作。
OperationDenied
Specified operation is denied as your instance is not in VPC.
400
實(shí)例不是 VPC 類型
InvalidPrivateIp.Changing
Specified private IP address is not in the CIDR block of virtual switch.
400
實(shí)例正在修改私網(wǎng) IP 過程中(實(shí)例一次 stop 只能修改一次私網(wǎng) IP)
示例
請(qǐng)求示例
https://ecs.aliyuncs.com/?Action=ModifyInstanceVpcAttribute
&InstanceId=35F20777-0DFF-C152-41FA-BCE0EA0B2FD7
&VSwitchId=[vswitchid]
&<公共請(qǐng)求參數(shù)>
返回示例
XML格式
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"