Unassigns one or more secondary private IP addresses from an elastic network interface (ENI).
Description
- The ENI from which to unassign secondary private IP addresses must be in the Available (Available) or InUse (InUse) state.
- If the ENI is a primary ENI, the Elastic Compute Service (ECS) instance to which the ENI is bound must be in the Running (Running) or Stopped (Stopped) state.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | UnassignPrivateIpAddresses |
The operation that you want to perform. Set the value to UnassignPrivateIpAddresses. |
RegionId | String | Yes | cn-hangzhou |
The region ID of the ENI. You can call the DescribeRegions operation to query the most recent region list. |
NetworkInterfaceId | String | Yes | eni-bp67acfmxazb4ph**** |
The ID of the ENI. |
PrivateIpAddress.N | String | Yes | 192.168.**.** |
The secondary private IP addresses to be unassigned. Valid values of N: 1 to 10. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
The ID of the request. |
Examples
Sample requests
https://ecs.aliyuncs.com/?Action=UnassignPrivateIpAddresses
&NetworkInterfaceId=eni-bp67acfmxazb4ph****
&PrivateIpAddress.1=192.168.**.**
&RegionId=cn-hangzhou
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<UnassignPrivateIpAddressesResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FE70008</RequestId>
</UnassignPrivateIpAddressesResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "04F0F334-1335-436C-A1D7-6C044FE70008"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | UnsupportedParameter | %s | The error message returned because a specified parameter is not supported. |
400 | InvalidParameter | %s | The error message returned because a specified parameter is invalid. |
400 | InvalidInstanceID.Malformed | %s | The error message returned because the specified InstanceId parameter is invalid. |
400 | InvalidOperation.InvalidEcsState | %s | The error message returned because the operation is not supported while the instance is in the current state. |
400 | InvalidOperation.InvalidEniState | %s | The error message returned because the operation is not supported while the ENI is in the current state. |
400 | InvalidOperation.DetachPrimaryEniNotAllowed | %s | The error message returned because the primary ENI cannot be unbound from the instance. |
400 | MissingParameter | %s | The error message returned because a required parameter is not specified. |
400 | Forbidden.RegionId | %s | The error message returned because the service is unavailable in the current region. |
400 | InvalidAction | %s | The error message returned because the operation is invalid. |
403 | InvalidUserType.NotSupported | %s | The error message returned because your account does not support this operation. |
403 | Abs.InvalidAccount.NotFound | %s | The error message returned because your Alibaba Cloud account does not exist or because your AccessKey pair has expired. |
403 | Forbidden.NotSupportRAM | %s | The error message returned because RAM users are not authorized to perform this operation. |
403 | Forbidden.SubUser | %s | The error message returned because you are not authorized to manage this resource. Contact the owner of the Alibaba Cloud account for authorization. |
403 | MaxEniCountExceeded | %s | The error message returned because the maximum number of ENIs that can be managed has been reached. |
403 | EniPerInstanceLimitExceeded | %s | The error message returned because the maximum number of ENIs that can be bound to the instance has been reached. |
403 | InvalidOperation.AvailabilityZoneMismatch | %s | The error message returned because the operation is invalid. |
403 | InvalidOperation.VpcMismatch | %s | The error message returned because the operation is invalid. Check whether the virtual private cloud (VPC) in the operation corresponds to other parameters. |
403 | SecurityGroupInstanceLimitExceed | %s | The error message returned because the maximum number of instances in the security group has been reached. |
403 | InvalidSecurityGroupId.NotVpc | %s | The error message returned because the specified SecurityGroupId parameter is invalid and the network type of the security group is not VPC. |
403 | InvalidOperation.InvalidEniType | %s | The error message returned because the operation is not supported while the ENI is of the current type. |
403 | InvalidVSwitchId.IpInvalid | %s | The error message returned because the specified private IP address is invalid. |
403 | InvalidIp.IpUnassigned | %s | The error message returned because the specified IP address is not assigned. |
403 | Operation.Conflict | %s | The error message returned because this operation conflicts with another operation in progress. Try again later. |
403 | InvalidOperation.EniServiceManaged | %s | The error message returned because the operation is invalid. |
404 | InvalidEcsId.NotFound | %s | The error message returned because the specified instance does not exist. |
404 | InvalidEniId.NotFound | %s | The error message returned because the specified NetworkInterfaceId parameter does not exist. |
404 | InvalidVSwitchId.NotFound | %s | The error message returned because the specified vSwitchId does not exist. |
404 | InvalidSecurityGroupId.NotFound | %s | The error message returned because the specified security group does not exist. |
404 | InvalidInstanceId.NotFound | %s | The error message returned because the specified instance does not exist. |
For a list of error codes, visit the API Error Center.