調用ReleaseEipAddress接口釋放指定的彈性公網IP（EIP）。
接口說明
在調用本接口時，請了解以下內容：
-
釋放 EIP 前，請確保滿足以下條件：
-
只有處于 Available 狀態的 EIP 才可以被釋放。
-
僅按量計費類型的 EIP 支持釋放，包年包月類型的 EIP 不支持釋放。
-
-
ReleaseEipAddress 接口屬于異步接口，即系統會先返回一個請求 ID，但該 EIP 實例并未釋放完成，系統后臺的釋放任務仍在進行。您可以調用 DescribeEipAddresses 查詢 EIP 實例的狀態：
-
當 EIP 實例處于 Releasing 狀態時，表示 EIP 實例正在釋放中，在該狀態下，您只能執行查詢操作，不能執行其他操作。
-
當查詢不到該 EIP 實例時，表示 EIP 實例釋放完成。
-
-
ReleaseEipAddress 接口不支持并發釋放同一個 EIP 實例。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| vpc:ReleaseEipAddress | update | *Address acs:vpc:{#regionId}:{#accountId}:eip/{#AllocationId} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 否 | 要釋放的 EIP 所在的地域 ID。您可以通過調用 DescribeRegions 接口獲取地域 ID。 | cn-hangzhou |
| AllocationId | string | 是 | 要釋放的 EIP 的 ID。 | eip-2zeerraiwb7uj6i0d**** |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "748C38F6-9A3D-482E-83FB-DB6C39C68AEA"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 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 | 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. | 參數不匹配，請檢查參數 |
| 404 | InvalidAllocationId.NotFound | Specified allocation ID is not found. | 指定的公網 IP 不存在，請您檢查填寫的公網 IP 是否正確。 |
| 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. | 請求處理由于某些未知錯誤失敗。 |
訪問錯誤中心查看更多錯誤碼。