AssignPrivateIpAddresses -

為一塊彈性網卡分配一個或多個輔助私有IP地址。可以為網卡指定在所屬虛擬交換器（VSwitch）的CIDR私有IP地址，或者通過指定私有網路地址數量自動建立私有IP地址。

只支援已綁定（InUse）狀態下的彈性網卡。
操作主網卡時，網卡附加的執行個體必須處於運行中（Running）或者 已停止（Stopped）狀態。
網卡處於執行個體規格類型系列。

請求參數


名稱	類型	是否必需	描述
Action	String	是	系統規定參數。取值：AssignPrivateIpAddresses
NetworkInterfaceId	String	是	彈性網卡ID。
PrivateIpAddress.N	Array	否	從彈性網卡所屬虛擬交換器的CIDR地址段中選擇一個或多個輔助私有IP地址。`N` 的取值範圍：彈性網卡處於可用（`Available`）狀態：[1, 10] 彈性網卡處於執行個體規格類型系列。分配輔助私有IP地址時，您要麼指定參數`PrivateIpAddress.N`，要麼指定參數`SecondaryPrivateIpAddressCount`。
SecondaryPrivateIpAddressCount	Integer	否	指定私有IP地址數量，讓ECS為您自動建立 IP 位址。

返回參數

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

樣本

請求樣本

https://ecs.aliyuncs.com/?Action=AssignPrivateIpAddresses
&NetworkInterfaceId=eni-m5e709m1ytxc4wx7wXXX
&PrivateIpAddress.1=192.168.0.1
&PrivateIpAddress.2=192.168.10.1
&<公共請求參數>

返回樣本

XML格式

<AssignPrivateIpAddressesResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE70008</RequestId>
</AssignPrivateIpAddressesResponse>

JSON格式

{
    "RequestId": "04F0F334-1335-436C-A1D7-6C044FE70008"
}

錯誤碼

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


錯誤碼	錯誤資訊	HTTP 狀態碼	說明
InValidParameter	the parameter(s) provided is(are) invalid.	400	指定的參數無效。
MissingParameter	The input parameter that is mandatory for processing this request is not supplied.	400	您必須指定必需參數。
InvalidOperation.InvalidEniState	The operation is not allowed in the current ENI state. Expecting status is ,while current status is.	400	只支援操作可用（`Available`）或者已綁定（`InUse`）狀態下的彈性網卡。
InvalidIp.IpUnassigned	The specified IP is not assigned on this ENI.	403	未分配指定的輔助私有IP地址。
InvalidVSwitchId.IpInvalid	The specified IpAddress is not valid in VSwitch CIDR block.	403	必須從虛擬交換器的IP地址段中選擇輔助私有IP地址。
Operation.Conflict	ecs task is conflicted.	403	指定的彈性網卡正在處理其他任務，請稍後再試。
InvalidEniId.NotFound	The specified EniId is not found.	404	指定的 `NetworkInterfaceId`不存在。
InvalidVSwitchId.NotFound	The specified VSwitchId is not found.	404	指定的虛擬交換器不存在。