調用UnassociateHaVip 接口將HaVip與專有網絡ECS實例或彈性網卡解綁。
接口說明
在調用本接口創建高可用虛擬 IP 時，請注意：
- 要解綁的 ECS 實例的狀態必須為運行中或停止。
- 要解綁的 HaVip 實例狀態必須為 Available 或 InUse。
- UnassociateHaVip 接口屬于異步接口，即系統會返回一個請求 ID，但該 HaVip 尚未解綁成功，系統后臺的解綁任務仍在進行。您可以調用 DescribeHaVips 查詢 HaVip 的解綁狀態：
- 當 HaVip 處于 Unassociating 狀態時，表示 HaVip 正在解綁中。
- 當 HaVip 處于 Inuse 或者 Available 狀態時，表示 HaVip 解綁成功。
- UnassociateHaVip 接口不支持并發解綁同一個 HaVip。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀取（Read）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| vpc:UnassociateHaVip | delete | *Instance acs:vpc:{#regionId}:{#accountId}:instance/{#InstanceId}*HaVip acs:vpc:{#regionId}:{#accountId}:havip/{#HaVipId} |
| 無 |
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| ClientToken | string | 否 | 保證請求冪等性。從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。 | 0c593ea1-3bea-11e9-b96b-88e9fe63**** |
| RegionId | string | 是 | HaVip 實例所在的地域 ID。 您可以通過調用 DescribeRegions 接口獲取地域 ID。 | cn-shanghai |
| HaVipId | string | 是 | 要解綁的 HaVip 實例 ID。 | havip-2zeo05qre24nhrqpy**** |
| InstanceId | string | 是 | 與 HaVip 解綁的 ECS 實例 ID 或彈性網卡實例 ID。 | i-faf344422ffsfad**** |
| Force | string | 否 | 是否強制解綁與 HaVip 綁定的 ECS 實例或彈性網卡實例，取值：
說明
如果該參數取值為 False，無法解綁 HaVip 綁定的主實例。
| True |
| InstanceType | string | 否 | 要解綁 HaVip 的實例類型，取值：
說明
當要解綁的實例為彈性網卡時，該參數必須填寫。
| EcsInstance |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "C44F62BE-9CE7-4277-B117-69243F3988BF"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | IncorrectHaVipStatus | HaVip can be operated by this action only when it's status is InUse. | 只有當HAVIP的狀態是InUse時，才可以執行該操作。 |
| 400 | IncorrectInstanceStatus | ECS instance can be operated by this action only when it's status is Running or Stopped. | 只有當ECS實例的狀態為運行中或者停止狀態時，才可執行該操作。 |
| 400 | ResourceNotAssociated | The HaVip and ECS instance are not associated. | HAVIP和ECS沒有綁定。 |
| 400 | Forbidden.UnassociateMaster | Unassociating a master instance is not allowed unless the parameter Force is True. | 非強制解綁時，不允許解綁master實例。 |
| 400 | IncorrectHaVipStatus | HaVip?s status is invalid. | - |
| 400 | HA.VIP.NOT.ASSOCIATED.WITH.INSTANCE | ha vip not associated with instance. | - |
| 400 | OperationFailed.DistibuteLock | Distibute lock fail. | 操作被其他請求加鎖； |
| 400 | OperationFailed.QueryNetworkInterfaceInfo | Failed to query network interface information. | 查詢網卡信息失敗。 |
| 400 | IllegalParam.InstanceType | The specified instance type is invalid. Only ECS instances and network interface are allowed. | 綁定的實例類型不允許。 |
| 400 | InvalidNetworkInterfaceId.NotFound | The network interface is not found. | 網卡不存在。 |
| 400 | ResourceNotFound.Instance | The specified binding resource is not found. | 綁定資源不存在。 |
| 400 | Forbidden.HaVip | No permissions to perform operations on HAVIPs. Please apply for privilege--vpc_privilege_allow_buy_havip_instance. | 操作HaVip沒有權限，請到配額中心申請權限。 |
| 404 | InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | 指定的RegionId不存在。請檢查該參數是否正確。 |
| 404 | InvalidHaVipId.NotFound | The specified HaVip does not exist in the specified region. | 指定的HaVip不在指定的地域中，請您檢查選擇的地域是否正確。 |
| 404 | InvalidInstanceId.NotFound | The specified Instance does not exist in the specified region. | 該實例在該地域內不存在。 |
| 500 | InternalError | The request processing has failed due to some unknown error. | 請求處理由于某些未知錯誤失敗。 |
訪問錯誤中心查看更多錯誤碼。