调用ReleaseEipSegmentAddress接口释放连续EIP。

使用说明

  • ReleaseEipSegmentAddress接口会释放连续EIP组内的所有EIP。
  • ReleaseEipSegmentAddress接口属于异步接口，即系统会先返回一个请求ID，但连续EIP并未完成释放，系统后台的释放任务仍在进行。您可以调用DescribeEipSegment查询连续EIP组的状态：
    • 当连续EIP组处于Releasing状态时，表示连续EIP正在释放中，在该状态下，您只能执行查询操作，不能执行其他操作。
    • 当查询不到该连续EIP组时，表示连续EIP释放完成。
  • ReleaseEipSegmentAddress接口不支持并发释放同一个连续EIP组。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ReleaseEipSegmentAddress

系统规定参数。取值：ReleaseEipSegmentAddress。

RegionId String 是 cn-hangzhou

连续EIP所属的地域ID。可以通过调用DescribeRegions接口获取地域ID。

SegmentInstanceId String 是 eipsg-2zett8ba055tbsxme****

要释放的连续EIP组的实例ID。

系统会释放该连续EIP组内的所有EIP。
ClientToken String 否 02fb3da4-130e-11e9-8e44-001sdfg

客户端Token，用于保证请求的幂等性。

从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

说明 若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。

返回数据

名称 类型 示例值 描述
RequestId String F7A6301A-64BA-41EC-8284-8F4838C15D1F

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ReleaseEipSegmentAddress
&RegionId=cn-hangzhou
&SegmentInstanceId=eipsg-2zett8ba055tbsxme****
&ClientToken=02fb3da4-130e-11e9-8e44-001sdfg
&公共请求参数

正常返回示例

XML格式 

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

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

JSON格式 

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

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

错误码

HttpCode 错误码 错误信息 描述
400 IncorrectEipStatus Current elastic IP status does not support this operation. 指定的EIP状态不支持此操作。
400 Forbidden.ChargeTypeIsPrepaid It's forbidden to release a prepaid EIP 预付费的 EIP 实例不能释放。
400 Forbbiden The eip instance owener error EIP 不属于当前调用者，请您检查该 EIP 是否可被您调用。
400 TaskConflict.AssociateGlobalAccelerationInstance Operate too frequent. 操作过于频繁。
404 Forbidden.RegionNotFound Specified region is not found during access authentication. 指定 Region 不存在，请您检查该 Region 是否正确。
500 InternalError The request processing has failed due to some unknown error. 请求处理由于某些未知错误失败。

访问错误中心查看更多错误码。