CIDR ブロックを IP アドレスプールに追加します。
操作説明
この操作を呼び出す前に、以下の制限事項にご注意ください。
-
CIDR ブロックと IP アドレスプールは、同じリージョンに属している必要があります。
-
CIDR ブロックと IP アドレスプールは、同じ回線タイプを使用している必要があります。
-
AddPublicIpAddressPoolCidrBlock は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返し、バックグラウンドでタスクを実行します。ListPublicIpAddressPoolCidrBlocks 操作を呼び出して、タスクのステータスをクエリできます。
CIDR ブロックの状態が Modifying の場合、CIDR ブロックが追加中です。この状態では、CIDR ブロックをクエリすることのみ可能で、他の操作は実行できません。
CIDR ブロックの状態が Created の場合、CIDR ブロックが正常に追加されています。
-
指定された期間内に、同一の CIDR ブロックを IP アドレスプールに追加するために AddPublicIpAddressPoolCidrBlock 操作を繰り返し呼び出すことはできません。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| PublicIpAddressPoolId |
string |
必須 |
IP アドレスプールの ID です。 |
pippool-6wetvn6fumkgycssx**** |
| CidrBlock |
string |
任意 |
CIDR ブロックです。 説明
CidrBlock と CidrMask のいずれか一方のみを指定できます。 |
47.0.XX.XX/24 |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するためのクライアントトークンです。 クライアント側でトークンを生成できますが、異なるリクエスト間で一意であることを保証する必要があります。トークンには ASCII 文字のみを使用できます。 説明
このパラメーターを指定しない場合、システムは自動的に リクエスト ID を クライアントトークン として使用します。リクエスト ID は各リクエストごとに異なる可能性があります。 |
02fb3da4-130e-11**** |
| DryRun |
boolean |
任意 |
ドライラン(実際のリクエストを実行せずに検証のみを行う)を実施するかどうかを指定します。有効値は次のとおりです。
|
false |
| RegionId |
string |
必須 |
CIDR ブロックを追加する IP アドレスプールのリージョン ID です。 |
cn-chengdu |
| CidrMask |
integer |
任意 |
CIDR ブロックのサブネットマスクです。サブネットマスクを入力すると、システムが自動的に IP アドレスを割り当てます。 有効値:24 ~ 28 説明
CidrBlock と CidrMask のいずれか一方のみを指定できます。 |
24 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーターです。 |
||
| RequestId |
string |
リクエスト ID です。 |
4EC47282-1B74-4534-BD0E-403F3EE64CAF |
| CidrBlock |
string |
CIDR ブロックです。 |
47.0.XX.XX/28 |
例
成功レスポンス
JSONJSON
{
"RequestId": "4EC47282-1B74-4534-BD0E-403F3EE64CAF",
"CidrBlock": "47.0.XX.XX/28"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | IllegalParam.CidrBlock | The param of CidrBlock [%s] is illegal. | |
| 400 | IllegalParam.CidrBlockMask | The param of CidrBlock Mask [%s] is illegal. | |
| 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. | |
| 400 | OperationDenied.OperateSharedResource | The operation is not allowed because of the PublicIpAddressPool is a shared resource. | |
| 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. | |
| 400 | OperationFailed.ResourceNotEnough | Insufficient resources. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。