使用ReleaseEipSegmentAddress释放连续EIP组-弹性公网IP-阿里云-弹性公网IP(EIP)-阿里云帮助中心

调用ReleaseEipSegmentAddress释放连续EIP。

接口说明

ReleaseEipSegmentAddress 接口会释放连续 EIP 组内的所有 EIP。
调用 ReleaseEipSegmentAddress 接口前，请确保：
- 连续 EIP 组内 EIP 处于非绑定状态。解绑云资源，请参见 UnassociateEipAddress 。
- 连续 EIP 组内 EIP 未加入共享带宽。将 EIP 从共享带宽中移除，请参见 RemoveCommonBandwidthPackageIp 。
ReleaseEipSegmentAddress 接口属于异步接口，即系统会先返回一个请求 ID，但连续 EIP 并未完成释放，系统后台的释放任务仍在进行。您可以调用 DescribeEipSegment 查询连续 EIP 组的状态：
- 当连续 EIP 组处于 Releasing 状态时，表示连续 EIP 正在释放中，在该状态下，您只能执行查询操作，不能执行其他操作。
- 当查询不到该连续 EIP 组时，表示连续 EIP 释放完成。
ReleaseEipSegmentAddress 接口不支持并发释放同一个连续 EIP 组。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

vpc:ReleaseEipSegmentAddress

delete

*SegmentAddress

acs:vpc:{#regionId}:{#accountId}:eip/{#AllocationId}

无

名称	类型	必填	描述	示例值
RegionId	string	是	连续 EIP 所属的地域 ID。可以通过调用 DescribeRegions 接口获取地域 ID。	cn-hangzhou
SegmentInstanceId	string	是	要释放的连续 EIP 组的实例 ID。系统会释放该连续 EIP 组内的所有 EIP。	eipsg-2zett8ba055tbsxme****
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。	02fb3da4-130e-11e9-8e44-001sdfg

正常返回示例

JSON格式

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

HTTP status code	错误码	错误信息	描述
400	IncorrectEipStatus	Current elastic IP status does not support this operation.
400	Forbidden.ChargeTypeIsPrepaid	It's forbidden to release a prepaid EIP
400	Forbidden	The eip instance owener error	EIP 不属于当前调用者，请您检查该 EIP 是否可被您调用。
400	TaskConflict.AssociateGlobalAccelerationInstance	Operate too frequent.
400	InvalidOperation.DeletionProtection	The instance cannnot delete because of deletion protecion.
400	OperationFailed.InstanceNotExist	Operation failed because eip segment instance not exist.
400	OperationFailed.EipNumInconsistent	Operation failed because the number of eip is inconsistent.
400	OperationFailed.EipStatusInvalid	Operation failed because eip instance status invalid.	操作失败，因为EIP实例状态无效。
400	OperationFailed.EipInBwp	Operation failed because eip instance has been added to the bandwidth package.
400	Forbidden.EipInBwp	The EIP has been associated with an EIP bandwidth plan.	连续EIP组中的EIP加入共享带宽，不允许删除连续EIP组。
500	InternalError	The request processing has failed due to some unknown error.
404	InvalidAllocationId.NotFound	Specified allocation ID is not found.
404	Forbidden.RegionNotFound	Specified region is not found during access authentication.

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

更多信息，参考变更详情。