DeletePublicIpAddressPool - 刪除IP位址集區
調用DeletePublicIpAddressPool介面刪除IP位址集區。
介面說明
在調用本介面時,請瞭解以下內容:
-
刪除 IP 位址集區前,請確保該位址集區內的 IP 位址沒有被使用。
-
DeletePublicIpAddressPool 介面屬於非同步介面,即系統會先返回一個請求 ID,但 IP 位址集區並未刪除完成,系統背景刪除任務仍在進行。您可以調用 ListPublicIpAddressPools 查詢 IP 位址集區的狀態。
-
當 IP 位址集區處於 Deleting 狀態時,表示 IP 位址集區正在刪除中,在該狀態下,您只能執行查詢操作,不能執行其他動作。
-
當查詢不到該 IP 位址集區時,表示 IP 位址集區刪除完成。
-
-
DeletePublicIpAddressPool 介面不支援並發刪除同一個 IP 位址集區。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| PublicIpAddressPoolId |
string |
是 |
IP 位址集區的執行個體 ID。 |
pippool-6wetvn6fumkgycssx**** |
| ClientToken |
string |
否 |
用戶端 Token,用於保證請求的等冪性。 從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。 |
0c593ea1-3bea-11e9-b96b-88e9fe60000 |
| DryRun |
boolean |
否 |
是否只預檢此次請求。取值:
|
false |
| RegionId |
string |
是 |
要建立的 IP 位址集區所在的地區 ID。 |
cn-chengdu |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回資料結構體。 |
||
| RequestId |
string |
請求 ID。 |
4EC47282-1B74-4534-BD0E-403F3EE64CAF |
樣本
正常返回樣本
JSON格式
{
"RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | IncorrectStatus.PublicIpAddressPool | The status of PublicIpAddressPool [%s] is incorrect. | |
| 400 | ResourceInUse.PublicIpAddressPool | The specified resource of PublicIpAddressPool [%s] is in use. | |
| 400 | OperationFailed.ResourceIsShared | The operation is failed because of PublicIpAddressPool is shared with other users. | 公網IP位址集區已經共用給其他使用者,不允許刪除。 |
| 400 | OperationDenied.OperateSharedResource | The operation is not allowed because of the PublicIpAddressPool is a shared resource. | 該公網IP位址集區執行個體是共用資源,不允許修改。 |
| 400 | ResourceNotFound.PublicIpAddressPool | The specified resource of PublicIpAddressPool [%s] is not found. | 指定的公網IP位址集區執行個體不存在 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。