AddPublicIpAddressPoolCidrBlock - 為IP位址集區添加IP位址區段
調用AddPublicIpAddressPoolCidrBlock介面將IP地址網段添加至IP位址集區。
介面說明
在調用本介面時，請瞭解以下內容：
IP 位址網段和 IP 位址集區需屬於同一地區。
IP 位址網段和 IP 位址集區需屬於同一 ISP 線路類型。
- AddPublicIpAddressPoolCidrBlock 介面屬於非同步介面，即系統會先返回一個請求 ID，但 IP 位址網段並未添加完成，系統背景新增工作仍在進行。您可以調用 ListPublicIpAddressPoolCidrBlocks 查詢 IP 位址集區中 IP 位址網段的狀態。
當 IP 位址網段處於 Modifying 狀態時，表示 IP 位址網段正在添加中，在該狀態下，您只能執行查詢操作，不能執行其他動作。
當 IP 位址網段處於 Created 狀態時，表示 IP 位址網段添加完成。
AddPublicIpAddressPoolCidrBlock 介面不支援並發添加同一個 IP 位址網段至 IP 位址集區。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| PublicIpAddressPoolId |
string |
是 |
IP 位址集區的執行個體 ID。 |
pippool-6wetvn6fumkgycssx**** |
| CidrBlock |
string |
否 |
IP 位址網段。 說明
不支援同時配置 CidrBlock 與 CidrMask，請選擇其中一個進行配置。 |
47.0.XX.XX/24 |
| ClientToken |
string |
否 |
用戶端 Token，用於保證請求的等冪性。 從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken 只支援 ASCII 字元。 說明
若您未指定，則系統自動使用 API 請求的 RequestId 作為 ClientToken 標識。每次 API 請求的 RequestId 不一樣。 |
02fb3da4-130e-11**** |
| DryRun |
boolean |
否 |
是否只預檢此次請求。取值：
|
false |
| RegionId |
string |
是 |
要添加網段的 IP 位址集區所在的地區 ID。 |
cn-chengdu |
| CidrMask |
integer |
否 |
IP 位址網段掩碼。 輸入遮罩後，系統會自動分配 IP 位址網段。 取值範圍：24~28。 說明
不支援同時配置 CidrBlock 與 CidrMask，請選擇其中一個進行配置。 |
24 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
返回資料結構體。 |
||
| RequestId |
string |
請求 ID。 |
4EC47282-1B74-4534-BD0E-403F3EE64CAF |
| CidrBlock |
string |
IP 位址段。 |
47.0.XX.XX/28 |
樣本
正常返回樣本
JSON格式
{
"RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
"CidrBlock": "47.0.XX.XX/28"
}錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | IllegalParam.CidrBlock | The param of CidrBlock [%s] is illegal. | CidrBlock非法 |
| 400 | IllegalParam.CidrBlockMask | The param of CidrBlock Mask [%s] is illegal. | CidrBlock掩碼非法 |
| 400 | IncorrectStatus.PublicIpAddressPool | The status of PublicIpAddressPool [%s] is incorrect. | |
| 400 | OperationDenied.CidrBlockBelongToOtherUser | The operation is not allowed because of CidrBlock belong to other user. | |
| 400 | ResourceNotFound.PublicIpAddressPool | The specified resource ofPublicIpAddressPool [%s] is not found. | |
| 400 | QuotaExceeded.PoolIpQuantity | The quota of PoolIpQuantity is exceeded. | 位址集區中IP數量配額超出限制。 |
| 400 | OperationDenied.OperateSharedResource | The operation is not allowed because of the PublicIpAddressPool is a shared resource. | 該公網IP位址集區執行個體是共用資源，不允許修改。 |
| 400 | MissingParam.CidrBlockOrCidrMask | CidrBlock or CidrMask is not specified. | 給位址集區添加位址區段失敗，因為缺少位址區段或掩碼參數。 |
| 400 | DuplicatedParam.CidrBlockAndCidrMask | CidrBlock and CidrMask cannot be specified at the same time. | 給位址集區添加位址區段失敗，因為位址區段和位址遮罩不能同時輸入。 |
| 400 | Forbidden.FinancialLocked | The instance is locked due to outstanding payments. | 該執行個體已欠費鎖定，無法操作 |
| 400 | ResourceNotEnough.CidrBlock | The specified resource is not enough. | 指定的資源不足 |
| 400 | MissingParam.PublicIpAddressPoolId | The parameter PublicIpAddressPoolId is missing. | 參數PublicIpAddressPoolId缺失。 |
| 400 | OperationFailed.ResourceNotEnough | Insufficient resources. | 您申請的資源不足，如仍需申請，請提工單處理 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊，參考變更詳情。