UnassignIpv6Addresses -

Usage notes

Take note of the following items:

The ENI 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 attached 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.
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-bp14v2sdd3v8ht****	The ID of the ENI.
Ipv6Address.N	String	No	2001:db8:1234:1a00::***	IPv6 address N. Valid values of N: 1 to 10. Note When you call this operation, you must specify `Ipv6Address.N` or `Ipv6Prefix.N`. Otherwise, an error is reported.
Ipv6Prefix.N	String	No	2001:db8:1234:1a00:****::/80	IPv6 prefix N. Valid values of N: 1 to 10. Note When you call this operation, you must specify `Ipv6Address.N` or `Ipv6Prefix.N`. Otherwise, an error is reported.

Response parameters

Parameter	Type	Example	Description
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	The ID of the request.

Examples

Sample requests

http(s)://ecs.aliyuncs.com/?Action=UnassignIpv6Addresses
&RegionId=cn-hangzhou
&NetworkInterfaceId=eni-bp14v2sdd3v8ht****
&Ipv6Address=["2001:db8:1234:1a00::***"]
&<Common request parameters>

Sample success responses

XML format

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

<UnassignIpv6AddressesResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</UnassignIpv6AddressesResponse>

JSON format

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Error codes

HTTP status code	Error code	Error message	Description
400	UnsupportedParameter	%s	A specified parameter is not supported.
400	InvalidParameter	%s	Invalid parameter value.
400	InvalidInstanceID.Malformed	%s	Invalid InstanceId format.
400	MissingParameter	%s	A required parameter is not specified.
400	InvalidOperation.InvalidEcsState	%s	This operation cannot be performed on the instance in the current state.
400	InvalidOperation.InvalidEniState	%s	This operation cannot be performed on the ENI in the current state.
400	InvalidParameter.Conflict	%s	Invalid parameter value. Check whether parameter conflicts exist. %s is a variable. An error message is dynamically returned based on call conditions.
403	InvalidUserType.NotSupported	%s	Your account does not support this operation.
403	Abs.InvalidAccount.NotFound	%s	Your Alibaba Cloud account is not found, or your AccessKey pair expired.
403	Forbedden.NotSupportRAM	%s	Resource Access Management (RAM) users do not have the permissions to perform this operation.
403	Forbbiden.SubUser	%s	You have no access to the resource. Contact the owner of the Alibaba Cloud account.
403	InvalidOperation.InvalidEniType	%s	This operation cannot be performed on this type of ENI.
403	InvalidIp.IpUnassigned	%s	The specified IP address is not assigned.
403	InvalidIp.IpRepeated	%s	The specified IP address already exists.
403	Forbidden.RegionId	%s	The service is unavailable in the current region.
403	InvalidOperation.EniServiceManaged	%s	The operation is invalid.
403	InvalidIp.IpPrefixIllegal	The ip prefixes %s is/are illegal.	The IP prefix is invalid and is not in the CIDR format.
403	InvalidIp.IpPrefixMaskInvalid	The ip prefixes mask %s is illegal which must be between %s and %s.	The IP prefix mask is invalid and is not within the valid range.
403	InvalidIp.IpPrefixMaskNotSame	The ip prefixes %s are illegal which mask must be same.	The IP prefix masks are not the same.
403	InvalidIp.IpPrefixNotStrict	The ip prefix must be strict cidr format.	The IP prefix is invalid and is not in the CIDR format.
403	MissingParameter	These parameters %s cannot be both empty.	A required parameter is not specified. The required parameters cannot be empty.
404	InvalidEniId.NotFound	%s	The ENI ID is not found.
500	InvalidOperation.RegionNotSupportIpPrefix	The current region does not support ip prefix.	IP prefixes cannot be assigned in the region.

For a list of error codes, see Service error codes.