ReleaseEipSegmentAddress

呼叫 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
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.
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.
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.

訪問錯誤中心查看更多錯誤碼。

更多資訊，參考變更詳情。