呼叫 DeleteHaVip 介面刪除高可用虛擬 IP(HaVip)。
介面說明
在呼叫本介面刪除 HaVip 時,請注意:
-
HaVip 必須是 available 狀態才可以刪除。
-
確保沒有任何路由指向要刪除的 HaVip。
-
確保要刪除的 HaVip 沒有繫結任何 EIP。
-
DeleteHaVip 介面屬於非同步介面,即系統會返回一個請求 ID,但該 HaVip 尚未刪除成功,系統後台的刪除任務仍在進行。您可以呼叫 DescribeHaVips 查詢 HaVip 的刪除狀態:
當 HaVip 處於 Deleting 狀態時,表示 HaVip 正在刪除中。
當查詢不到指定 HaVip 時,表示 HaVip 刪除成功。
-
DeleteHaVip 介面不支援並發刪除同一個 HaVip。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
vpc:DeleteHaVip |
delete |
*HaVip
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| ClientToken |
string |
否 |
用戶端 Token,用於保證請求的冪等性。 從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。 說明
若您未指定,則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 可能不一樣。 |
0c593ea1-3bea-11e9-b96b-88e9fe637760 |
| RegionId |
string |
是 |
HaVip 所在的地域。您可以透過呼叫 DescribeRegions 介面取得地域 ID。 |
cn-shanghai |
| HaVipId |
string |
是 |
要刪除的 HaVip 的 ID。 |
havip-2zeo05qre24nhrqpy**** |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
C44F62BE-9CE7-4277-B117-69243F3988BF |
樣本
正常返回樣本
JSON格式
{
"RequestId": "C44F62BE-9CE7-4277-B117-69243F3988BF"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | IncorrectStatus | HaVip can be deleted only when it is status is Available. | |
| 400 | DependencyViolation.HaVipReferedByRouteEntry | HaVip cannot be deleted when it is refered by a route table entry as next hop. | |
| 400 | DependencyViolation.HaVipAssociatedWithEIP | HaVip cannot be deleted when it is associated with EIP. | |
| 400 | IncorrectHaVipStatus | HaVip?s status is invalid. | |
| 400 | Forbidden.HaVip | No permissions to perform operations on HAVIPs. Please apply for privilege--vpc_privilege_allow_buy_havip_instance. | |
| 400 | InvalidRegionId.NotFound | The RegionId provided does not exist in our records. | |
| 404 | InvalidHaVipId.NotFound | The specified HaVip does not exist in the specified region. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。