ReleaseEipAddress - 釋放指定EIP

更新時間:
Copy as MD

調用ReleaseEipAddress介面釋放指定的Elastic IP Address(EIP)。

介面說明

在調用本介面時,請瞭解以下內容:

  • 釋放 EIP 前,請確保滿足以下條件:

    • 只有處於 Available 狀態的 EIP 才可以被釋放。

    • 僅隨用隨付類型的 EIP 支援釋放,訂用帳戶類型的 EIP 不支援釋放。

  • ReleaseEipAddress 介面屬於非同步介面,即系統會先返回一個請求 ID,但該 EIP 執行個體並未釋放完成,系統背景釋放任務仍在進行。您可以調用 DescribeEipAddresses 查詢 EIP 執行個體的狀態:

    • 當 EIP 執行個體處於 Releasing 狀態時,表示 EIP 執行個體正在釋放中,在該狀態下,您只能執行查詢操作,不能執行其他動作。

    • 當查詢不到該 EIP 執行個體時,表示 EIP 執行個體釋放完成。

  • ReleaseEipAddress 介面不支援並發釋放同一個 EIP 執行個體。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

RegionId

string

要釋放的 EIP 所在的地區 ID。您可以通過調用 DescribeRegions 介面擷取地區 ID。

cn-hangzhou

AllocationId

string

要釋放的 EIP 的 ID。

eip-2zeerraiwb7uj6i0d****

返回參數

名稱

類型

描述

樣本值

object

返回請求列表。

RequestId

string

請求 ID。

748C38F6-9A3D-482E-83FB-DB6C39C68AEA

樣本

正常返回樣本

JSON格式

{
  "RequestId": "748C38F6-9A3D-482E-83FB-DB6C39C68AEA"
}

錯誤碼

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 TaskConflict.AssociateGlobalAccelerationInstance Operate too frequent.
400 InvalidOperation.DeletionProtection The instance cannnot delete because of deletion protecion.
400 Forbidden.ReleaseSegmentEip Release single segment eip is forbidden.
400 Forbidden The eip instance owner error EIP 不屬於當前調用者,請您檢查該 EIP 是否可被您調用。
400 Mismatch.%sAnd%s The %s and %s are mismatched. 參數不匹配,請檢查參數
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.

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

變更歷史

更多資訊,參考變更詳情