調用UnassociateEipAddress將彈性公網IP（EIP）從綁定的云產品上解綁。
接口說明
- UnassociateEipAddress 接口屬于異步接口，即系統會先返回一個請求 ID，但 EIP 并未完成解綁，系統后臺的解綁任務仍在進行。您可以調用 DescribeEipAddresses 查詢 EIP 的狀態：
- 當 EIP 處于 Unassociating 狀態時，表示 EIP 正在解綁中，在該狀態下，您只能執行查詢操作，不能執行其他操作。
- 當 EIP 處于 Available 時，表示 EIP 完成解綁。
- UnassociateEipAddress 接口不支持并發解綁同一個 EIP。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀?。≧ead）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| vpc:UnassociateEipAddress | delete | *Instance acs:ecs:{#regionId}:{#accountId}:instance/{#InstanceId}*Address acs:vpc:{#regionId}:{#accountId}:eip/{#AllocationId}*HaVip acs:vpc:{#regionId}:{#accountId}:havip/{#HaVipId} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Force | boolean | 否 | 當 EIP 綁定了 NAT 網關，且 NAT 網關添加了 DNAT 或 SNAT 條目時，是否強制解綁 EIP，取值：
| false |
| RegionId | string | 否 | 要解綁的 EIP 的地域 ID。 您可以通過調用 DescribeRegions 接口獲取地域 ID。 | cn-hangzhou |
| AllocationId | string | 是 | 要解綁的 EIP 的 ID。 | eip-2zeerraiwb7uj6i0d**** |
| InstanceId | string | 否 | 要解綁 EIP 的云產品實例的 ID。 支持輸入 NAT 網關實例 ID、傳統型負載均衡 CLB 實例 ID、云服務器 ECS 實例 ID、輔助彈性網卡實例 ID、高可用虛擬 IP 實例 ID、IP 地址。 | i-hp3akk9irtd69jad**** |
| InstanceType | string | 否 | 要解綁 EIP 的云產品類型，取值：
| EcsInstance |
| PrivateIpAddress | string | 否 | 要解綁 EIP 的 ECS 實例或輔助彈性網卡實例的私網 IP 地址。 | 192.XX.XX.2 |
| ClientToken | string | 否 | 客戶端 Token，用于保證請求的冪等性。 從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。ClientToken 只支持 ASCII 字符。 說明
若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。
| 02fb3da4-130e-11**** |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | IncorrectEipStatus | Current elastic IP status does not support this operation. | 指定的EIP狀態不支持此操作。 |
| 400 | InvalidInstanceId.NotFound | Specified instance does not exist. | 該實例不存在，請您檢查填寫的實例是否正確。 |
| 400 | IncorrectInstanceStatus | The current status of instance does not support this operation. | 當前實例的狀態不支持該操作。 |
| 400 | InvalidInstanceType.ValueNotSupported | The specified value of InstanceType is not supported. | 參數InstanceType的值不合法。 |
| 400 | IncorrectHaVipStatus | This operation is denied because satus of the specified HaVip is neither Available nor InUse. | 無法執行該操作，因為HaVip的狀態是Available或InUse。 |
| 400 | OperationDenied | Eip of default vpc not allow this operation | 默認專有網絡的EIP不支持該操作。 |
| 400 | InvalidParameter | The specified parameter is not valid. | 該參數值不合法。 |
| 400 | TaskConflict | The eip operate too frequent, TaskConflict. | 操作過于頻繁，任務沖突。 |
| 400 | InvalidBindingStatus | The eip binding status invalid. | EIP綁定狀態不正確。 |
| 400 | Forbidden.FinancialLocked | The ip business status is invalid. | 該實例已欠費鎖定，無法操作 |
| 400 | InvalidIpStatus.HasBeenUsedBySnatTable | The removed ip address has been used by snat table. | - |
| 400 | InvalidIpStatus.HasBeenUsedByForwardEntry | The specified address has been used by forwardTable. | - |
| 400 | Eni.Attached | The eni should be detached from ecs when associating with direct eip. | 當ENI綁定直通EIP時，需要ENI與ECS解綁 |
| 400 | InvalidEIPStatus.BizDisabled | The EIP has been locked. | EIP實例被鎖定 |
| 400 | InvalidStatus.EcsStatusNotSupport | The special instance status Pending is not support operate | 實例處于掛起狀態下，不支持操作 |
| 400 | InvalidStatus.EniStatusNotSupport | %s | - |
| 400 | InvalidStatus.SnatOrDnat | Operation failed because snat or dnat in unstable status. | 解綁EIP操作失敗，因為SNAT或DNAT處于非穩定狀態 |
| 400 | DependencyViolation.SnatEntry | The specified eip is in ip pool. | - |
| 400 | %s | %s | - |
| 400 | InvalidStatus.NotAllow | Bind instance status invalid | 綁定實例狀態無效 |
| 400 | DependencyViolation.SnatEntry | The specified resource of Snat depends on Eip, so the operation cannot be completed. | - |
| 400 | Forbidden | The eip instance owener error | EIP 不屬于當前調用者，請您檢查該 EIP 是否可被您調用。 |
| 400 | InvalidLoadBalancerId.NotFound | LoadBalancerId does not exist. | 負載均衡ID不存在。 |
| 400 | OperationFailed.SystemBusy | Operation failed because system is busy. | 系統繁忙，請稍后重試 |
| 404 | InvalidAllocationId.NotFound | Specified allocation ID is not found | 指定的公網IP不存在，請您檢查您填寫的參數是否正確。 |
| 404 | InvalidAllocationId.NotFound | Specified allocation ID is not found. | 指定的公網 IP 不存在，請您檢查填寫的公網 IP 是否正確。 |
| 404 | InvalidBindInstance.NotFound | The specified bind instance does not exist. | - |
| 404 | Forbidden.RegionNotFound | Specified region is not found during access authentication. | 指定 Region 不存在，請您檢查該 Region 是否正確。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2023-07-31 | OpenAPI 描述信息更新、OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-06-26 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |