Reclaims one or more IPv6 addresses assigned to an elastic network interface (ENI).

Description

When you call this operation, take note of the following items:

  • The ENI must be in the Available (Available) or Bound (InUse) state.
  • The Elastic Compute Service (ECS) instance to which the primary ENI is bound must be in the Running (Running) or Stopped (Stopped) state.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes UnassignIpv6Addresses

The operation that you want to perform. Set the value to UnassignIpv6Addresses.

Ipv6Address.N RepeatList Yes 2001:db8:1234:1a00::***

The list of IPv6 addresses to be assigned to the ENI. Set the value of N to 1.

NetworkInterfaceId String Yes eni-bp14v2sdd3v8ht****

The ID of the ENI.

RegionId String Yes cn-hangzhou

The region ID of the ENI. You can call the DescribeRegions operation to query the most recent region list.

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=UnassignIpv6Addresses
&Ipv6Address.1=2001:db8:1234:1a00::***
&NetworkInterfaceId=eni-bp14v2sdd3v8ht****
&RegionId=cn-hangzhou
&<Common request parameters>|

Sample success responses

XML format

<UnassignIpv6AddressesResponse>
      <RequestId>48285314-3192-47FE-B4C8-9D51E7Fxxxxx</RequestId>
</UnassignIpv6AddressesResponse>

JSON format

{
    "RequestId": "48285314-3192-47FE-B4C8-9D51E7Fxxxxx"
}

Error codes

HTTP status code Error code Error message Description
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 has expired.
403 MissingParameter %s The error message returned because a required parameter is not specified.
403 Forbedden.NotSupportRAM %s The error message returned because RAM users are not authorized to perform this operation.
400 UnsupportedParameter %s The error message returned because a specified parameter is not supported.
403 Forbbiden.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.
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.
404 InvalidEniId.NotFound %s The error message returned because the specified NetworkInterfaceId parameter does not exist.
403 InvalidOperation.InvalidEniType %s The error message returned because the ENI type does not support this operation.
403 InvalidIp.IpUnassigned %s The error message returned because the specified IP address is not assigned.
403 InvalidIp.IpRepeated %s The error message returned because the specified IP address already exists.
403 InvalidIp.Address %s The error message returned because the specified IPv6 address is invalid.
403 Forbidden.RegionId %s The error message returned because the service is unavailable in the current region.
403 InvalidOperation.EniServiceManaged %s The error message returned because the operation is invalid.

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