Releases an Elastic IP Address (EIP).
Note Only EIPs in the Available state can be released.
Debug
Use OpenAPI Explorer to perform debug operations and generate SDK code examples.
Request parameters
| Parameter | Type | Required? | Example value | Description |
|---|---|---|---|---|
| Action | String | Yes | ReleaseEipAddress |
The name of this action. Value: ReleaseEipAddress |
| AllocationId | String | Yes | eip-2zeerraiwb7uj6i0d0fo3 |
The ID of the EIP to be released. |
| RegionId | String | Yes | cn-hangzhou |
The ID of the region to which the EIP belongs. To query the region ID, call DescribeRegions. |
Response parameters
| Parameter | Type | Example value | Description |
|---|---|---|---|
| RequestId | String | 748C38F6-9A3D-482E-83FB-DB6C39C68AEA |
The ID of the request. |
Examples
Request example
https://vpc.aliyuncs.com/?Action=ReleaseEipAddress
&AllocationId=eip-25877c70x
&<CommonParameters>
Response example
XML format
<<? xml version="1.0" encoding="UTF-8" ? >
<ReleaseEipAddressResponse>
<RequestId>748C38F6-9A3D-482E-83FB-DB6C39C68AEA</RequestId>
</ReleaseEipAddressResponse>JSON format
{
"RequestId":"748C38F6-9A3D-482E-83FB-DB6C39C68AEA"
}Errors
| HTTP status code | Error code | Error message | Description |
|---|---|---|---|
| 404 | InvalidAllocationId.NotFound | Specified allocation ID is not found | The specified public IP address does not exist. |
| 400 | IncorrectEipStatus | Current elastic IP status does not support this operation. | The status of the specified EIP does not permit this operation. |
| 500 | InternalError | The request processing has failed due to some unknown error. | The request failed to be processed due to unknown errors. |
| 404 | Forbidden.RegionNotFound | Specified region is not found during access authentication. | The specified region does not exist. |
| 400 | Forbidden.ChargeTypeIsPrepaid | It's forbidden to release a prepaid EIP | Subscription EIPs cannot be released. |
| 400 | Forbbiden | The eip instance owener error | You are not authorized to release the specified EIP. |
| 400 | TaskConflict.AssociateGlobalAccelerationInstance | Operate too frequent. | Too many requests were sent. |
For a list of error codes, visit the API Error Center.