DeletePublicIpAddressPool - 刪除IP位址集區

更新時間:
Copy as MD

調用DeletePublicIpAddressPool介面刪除IP位址集區。

介面說明

在調用本介面時,請瞭解以下內容:

  • 刪除 IP 位址集區前,請確保該位址集區內的 IP 位址沒有被使用。

  • DeletePublicIpAddressPool 介面屬於非同步介面,即系統會先返回一個請求 ID,但 IP 位址集區並未刪除完成,系統背景刪除任務仍在進行。您可以調用 ListPublicIpAddressPools 查詢 IP 位址集區的狀態。

    • 當 IP 位址集區處於 Deleting 狀態時,表示 IP 位址集區正在刪除中,在該狀態下,您只能執行查詢操作,不能執行其他動作。

    • 當查詢不到該 IP 位址集區時,表示 IP 位址集區刪除完成。

  • DeletePublicIpAddressPool 介面不支援並發刪除同一個 IP 位址集區。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

PublicIpAddressPoolId

string

IP 位址集區的執行個體 ID。

pippool-6wetvn6fumkgycssx****

ClientToken

string

用戶端 Token,用於保證請求的等冪性。

從您的用戶端產生一個參數值,確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。

0c593ea1-3bea-11e9-b96b-88e9fe60000

DryRun

boolean

是否只預檢此次請求。取值:

  • true:發送檢查請求,不會刪除位址集區。檢查項包括是否填寫了必需參數、請求格式、業務限制。如果檢查不通過,則返回對應錯誤。如果檢查通過,則返回錯誤碼DryRunOperation

  • false(預設值):發送正常請求,通過檢查後返回 HTTP 2xx 狀態代碼並直接進行操作。

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位址集區執行個體不存在

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情