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

描述

  • 只支援 可用Available)或者 已綁定InUse)狀態下的彈性網卡。
  • 操作主網卡時,網卡附加的執行個體必須處於 運行中Running)或者 已停止Stopped)狀態。
  • 網卡處於可用Available)狀態時,最多可以分配10個輔助私有IP地址。一旦掛載到執行個體上,網卡能分配的輔助私有IP地址數將受到執行個體規格限制。更多詳情,請參閱執行個體規格類型系列

請求參數

名稱 類型 是否必需 描述
Action String 系統規定參數。取值:AssignPrivateIpAddresses
NetworkInterfaceId String 彈性網卡ID。
PrivateIpAddress.N Array 從彈性網卡所屬虛擬交換器的CIDR地址段中選擇一個或多個輔助私有IP地址。N 的取值範圍:
  • 彈性網卡處於 可用Available)狀態:[1, 10]
  • 彈性網卡處於 已綁定InUse)狀態:受到執行個體規格限制,更多詳情,請參閱 執行個體規格類型系列

分配輔助私有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 指定的虛擬交換器不存在。