AssignPrivateIpAddresses

Description

• The ENI to which you want to assign private IP addresses must be in the Available (Available) or Bound (InUse) state.
• When you perform operations on the primary ENI, the instance to which the ENI is bound must be in the Running or Stopped state.
• When an ENI is in the Available state, up to 10 secondary private IP addresses can be assigned to it. When an ENI is bound to an instance, the number of private IP addresses that can be assigned to the ENI is subject to the instance type. For more information, see Instance families.
• After the operation is called, you can obtain the private IP addresses assigned to the ENI from the response.

Request parameters

Response parameters

Examples

Sample requests

https://ecs.aliyuncs.com/?Action=AssignPrivateIpAddresses
&NetworkInterfaceId=eni-bp67acfmxazb4p****
&RegionId=cn-hangzhou
&PrivateIpAddress.1=10.1.**.**
&PrivateIpAddress.2=10.1.**.**
&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<AssignPrivateIpAddressesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <AssignedPrivateIpAddressesSet>
        <PrivateIpSet>
            <PrivateIpAddress>192.168.**.**</PrivateIpAddress>
        </PrivateIpSet>
        <NetworkInterfaceId>eni-bp125p95hhdhn3ot****</NetworkInterfaceId>
    </AssignedPrivateIpAddressesSet>
</AssignPrivateIpAddressesResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "AssignedPrivateIpAddressesSet" : {
    "PrivateIpSet" : {
      "PrivateIpAddress" : [ "192.168.**.**" ]
    },
    "NetworkInterfaceId" : "eni-bp125p95hhdhn3ot****"
  }
}

Error codes

For a list of error codes, visit the API Error Center.