Releases contiguous elastic IP addresses (EIPs).

Usage notes

  • After you call the ReleaseEipSegmentAddress operation, all EIPs in the specified group are released.
  • The ReleaseEipSegmentAddress operation is asynchronous. After you send the request, the system returns a request ID. However, the operation is still being performed in the system background. You can call the DescribeEipSegment operation to query the status of a group of contiguous EIPs:
    • If the group is in the Releasing state, EIPs in the group are being released. In this state, you can only query the group and cannot perform other operations.
    • If you cannot query the group of contiguous EIPs, the contiguous EIPs are released.
  • You cannot repeatedly call the ReleaseEipSegmentAddress operation to release a group of contiguous EIPs within the specified period of time.

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 ReleaseEipSegmentAddress

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

RegionId String Yes cn-hangzhou

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

SegmentInstanceId String Yes eipsg-2zett8ba055tbsxme****

The ID of the group to which the contiguous EIPs to be released belongs.

The system releases all EIPs in the group.

ClientToken String No 02fb3da4-130e-11e9-8e44-001sdfg

The client token that is used to ensure the idempotence of the request.

You can use the client to generate the value, but you must make sure that it is unique among different requests. The client token can contain only ASCII characters.

Note If you do not set this parameter, the system uses RequestId as ClientToken. The value of RequestId for each API request may be different.

Response parameters

Parameter Type Example Description
RequestId String F7A6301A-64BA-41EC-8284-8F4838C15D1F

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=ReleaseEipSegmentAddress
&RegionId=cn-hangzhou
&SegmentInstanceId=eipsg-2zett8ba055tbsxme****
&ClientToken=02fb3da4-130e-11e9-8e44-001sdfg
&Common request parameters

Sample success responses

XML format 

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

<ReleaseEipSegmentAddressResponse>
    <RequestId>F7A6301A-64BA-41EC-8284-8F4838C15D1F</RequestId>
</ReleaseEipSegmentAddressResponse>

JSON format 

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

{
  "RequestId" : "F7A6301A-64BA-41EC-8284-8F4838C15D1F"
}

Error codes

HttpCode Error code Error message Description
400 IncorrectEipStatus Current elastic IP status does not support this operation. The error message returned because you cannot perform the operation when the specified EIP is in the current state.
400 Forbidden.ChargeTypeIsPrepaid It's forbidden to release a prepaid EIP The error message returned because you cannot release subscription EIPs.
400 Forbbiden The eip instance owener error The error message returned because the EIPs do not belong to you. Check whether you are unauthorized to perform the operation on the EIPs.
400 TaskConflict.AssociateGlobalAccelerationInstance Operate too frequent. The error message returned because the number of requests that you send exceeds the upper limit.
404 Forbidden.RegionNotFound Specified region is not found during access authentication. The error message returned because the specified region does not exist. Check whether the specified region ID is valid.
500 InternalError The request processing has failed due to some unknown error. The error message returned because some unknown errors occurred.

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