为一块弹性网卡分配一个或多个辅助私有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 指定的虚拟交换机不存在。