vSwitch 用の予約済み CIDR ブロックを作成します。
操作説明
この操作を呼び出して vSwitch 用の予約済み CIDR ブロックを作成する場合は、次の項目に注意してください。
VPC 内の予約済み IPv4 CIDR ブロックと予約済み IPv6 CIDR ブロックの最大値は、それぞれ 100 です。
- 予約済み CIDR ブロックには、それが属する vSwitch のシステム予約済み IP アドレスを含めることはできません。
IPv4 CIDR ブロック: vSwitch の最初の IP アドレスと最後の 3 つの IP アドレスは、システム予約済み IP アドレスです。
IPv6 CIDR ブロック: vSwitch の最初の IP アドレスと最後の 9 つの IP アドレスは、システム予約済み IP アドレスです。
- CreateVSwitchCidrReservation 操作は非同期です。リクエストを送信すると、システムはインスタンス ID を返しますが、vSwitch 用の予約済み CIDR ブロックはまだ作成されていません。システムはバックグラウンドで実行を継続します。 ListVSwitchCidrReservations を呼び出して、vSwitch 用の予約済み CIDR ブロックの作成ステータスを照会できます。
vSwitch 用の予約済み CIDR ブロックが Assigning 状態の場合、vSwitch 用の予約済み CIDR ブロックを割り当てる処理を行っています。
vSwitch 用の予約済み CIDR ブロックが Assigned 状態の場合、vSwitch 用の予約済み CIDR ブロックを割り当てる処理が完了しています。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vpc:CreateVSwitchCidrReservation |
create |
*VSwitchCidrReservation。
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Tag |
array<object> |
任意 |
リソースのタグ。 |
|
|
object |
任意 |
タグのフォーマット情報。 |
||
| Key |
string |
任意 |
リソースのタグキー。最大 20 個のタグキーを指定できます。このパラメーターを指定する場合、値は空の文字列にできません。 タグキーの長さは最大 128 文字です。aliyun または acs: で始めることはできず、 |
FinanceDept |
| Value |
string |
任意 |
リソースのタグ値。最大 20 個のタグ値を指定できます。値は空の文字列にできます。 タグ値の長さは最大 128 文字です。aliyun または acs: で始めることはできず、 |
FinanceJoshua |
| VSwitchId |
string |
必須 |
vSwitch 用の予約済み CIDR ブロックが属する vSwitch の ID。 |
vsw-25navfgbue4g**** |
| VSwitchCidrReservationName |
string |
任意 |
vSwitch 用の予約済み CIDR ブロックの名前。 名前の長さは 1~128 文字で、英字または漢字で始める必要があります。数字、アンダースコア (_)、ハイフン (-) を含めることができます。 |
ReservationName |
| VSwitchCidrReservationDescription |
string |
任意 |
vSwitch 用の予約済み CIDR ブロックの説明。このパラメーターを空のままにすると、デフォルト値は空になります。 説明の長さは 1~256 文字で、英字または漢字で始める必要があります。 |
ReservationDescription |
| IpVersion |
string |
任意 |
vSwitch 用の予約済み CIDR ブロックの IP バージョン。有効な値:
説明
vSwitch 用の IPv4 予約済み CIDR ブロックを作成する場合は、このパラメーターを指定する必要はありません。vSwitch 用の IPv6 予約済み CIDR ブロックを作成する場合は、このパラメーターが必須です。 |
IPv4 |
| VSwitchCidrReservationMask |
string |
任意 |
vSwitch 用の予約済み CIDR ブロックのマスク。
説明
|
28 |
| VSwitchCidrReservationCidr |
string |
任意 |
vSwitch 用の予約済み CIDR ブロック。
説明
|
192.168.1.64/28 |
| VSwitchCidrReservationType |
string |
任意 |
vSwitch 用の予約済み CIDR ブロックのタイプ。有効な値: prefix (IP アドレスが CIDR ブロックごとに割り当てられるプレフィックスであることを示します)。 説明
ユーザーまたはクラウドサービスの呼び出し時に CIDR ブロックをエラスティックネットワークインターフェイスコントローラー (NIC) に自動的に割り当てる場合、CIDR ブロックは予約済み CIDR ブロックから割り当てる必要があります。予約済み CIDR ブロック内の IP アドレスが枯渇すると、システムはエラーを返します。 |
プレフィックス |
| IpPrefixNumber |
integer |
任意 |
予約する IP プレフィックスの予期される数。有効な値: 1~32。 |
1 |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用されるクライアントトークン。 クライアントを使用してトークンを生成できますが、異なるリクエストの呼び出し間でトークンが一意であることを確認する必要があります。トークンには ASCII 文字のみを含めることができます。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として自動的に使用します。RequestId は API リクエストごとに異なる場合があります。 |
123e4567-e89b-12d3-a456-426655440000 |
| DryRun |
boolean |
任意 |
ドライランを実行するかどうかを指定します。有効な値:
|
false |
| RegionId |
string |
必須 |
vSwitch のリージョン ID。 DescribeRegions 操作を呼び出して、最新のリージョンリストを照会できます。 |
cn-hangzhou |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
vSwitch 用の予約済み CIDR ブロックのインスタンス ID。 |
||
| RequestId |
string |
リクエスト ID。 |
54B48E3D-DF70-471B-AA93-08E683A1B45 |
| VSwitchCidrReservationId |
string |
vSwitch 用の予約済み CIDR ブロックのインスタンス ID。 |
vcr-bp1m12saqteraw3rp**** |
例
成功レスポンス
JSONJSON
{
"RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45",
"VSwitchCidrReservationId": "vcr-bp1m12saqteraw3rp****"
}
エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | IllegalParamFormat | IllegalParamFormat | パラメーターのフォーマットが正しくありません。 |
| 400 | IllegalParamFormat.VSwitchCidrReservationCidr | The param format of VSwitchCidrReservationCidr is illegal. | VSwitchCidrReservationCidr パラメーターのフォーマットが無効です。 |
| 400 | ResourceNotFound.VSwitch | The specified resource of VSwitch is not found. | 指定された vSwitch インスタンスが存在しません。 |
| 400 | UnsupportedFeature.ReservedType | The specified ReservedType is not supported. | 指定された ReservedType はサポートされていません。 |
| 400 | UnsupportedFeature.VSwitchIpv6 | The ipv6 feature of switch is not supported. | 指定された vSwitch で IPv6 が有効になっていません。 |
| 400 | OperationFailed.VSwitchCidrReservationCidr | The specified VSwitchCidrReservationCidr conflicts with existed cidr reservation or vswitch cidr. | 指定された VSwitchCidrReservationCidr が既存の VSwitchCidrReservation CIDR ブロックと競合しています。 |
| 400 | MissingParam.CidrReservationMaskOrCidrReservationCidr | Either VSwitchCidrReservationMask or VSwitchCidrReservationCidr should be specified. | VSwitchCidrReservationMask パラメーターと VSwitchCidrReservationCidr パラメーターの両方を空にすることはできません。いずれか一方を指定して、もう一度お試しください。 |
| 400 | UnsupportedRegion | UnsupportedRegion | 現在のリージョンでは、プレフィックスリストルートの操作はサポートされていません。 |
| 400 | UnsupportedFeature.VpcAdvancedFeature | UnsupportedFeature.VpcAdvancedFeature | 指定された vSwitch が属する VPC は高度な特徴をサポートしていません。別の vSwitch を使用して再試行してください。 |
| 400 | QuotaExceeded.CidrReservationCount | The quota of VSwitchCidrReservation is exceeded. | VSwitchCidrReservation インスタンスの数がクォータを超えています。 |
| 400 | Conflict.CidrReservationMaskAndCidrReservationCidr | The specified VSwitchCidrReservationMask and VSwitchCidrReservationCidr is conflict. | 指定された VSwitchCidrReservationMask が VSwitchCidrReservationCidr と競合しています。API ドキュメントのメトリックの説明に基づいてパラメーターを変更し、リトライしてください。 |
| 400 | OperationFailed.CidrNotEnoughInVSwitch | No enough cidr to allocate in this vswitch. | 指定された vSwitch に CidrReservation を割り当てるための十分な CIDR ブロックがありません。 |
| 400 | OperationFailed.SystemReservedIpContained | The specified VSwitchCidrReservationCidr cannot contain system reserved IP addresses. | 指定された VSwitchCidrReservationCidr にシステム予約済み IP アドレスを含めることはできません。 |
| 400 | OperationFailed.AlreadyUsedIpContained | The specified VSwitchCidrReservationCidr cannot contain already used IP addresses. | 指定された予約済み CIDR ブロックに、すでに使用中の IP アドレスを含めることはできません。 |
| 400 | IncorrectStatus.VSWITCH | The status of the specified VSwitch is invalid. | vSwitch が異常な状態です。 |
| 400 | IllegalParam.VSwitchCidrReservationMask | The specified VSwitchCidrReservationMask must be at least 2 bits greater than the vSwitch mask. | VSwitchCidrReservationMask パラメーターが無効です。API リファレンスのパラメーター説明に基づいて値を変更し、リトライしてください。 |
| 400 | QuotaExceeded.VSwitchCidrReservationMask | The operation is failed because of %s. The mask of the reserved subnet cidr exceeds the current default mask of IP Prefix, %s/%s. | VSwitchCidrReservationMask がクォータを超えています。API リファレンスのパラメーター説明に基づいて値を変更し、リトライしてください。 |
| 400 | IllegalParam.ReservedType | IpPrefixNumber is only supported with Prefix reserved type. | IpPrefixNumber は、プレフィックス予約タイプでのみサポートされています。 |
| 400 | MissingParam.VSwitchCidrReservationParam | One of IpPrefixNumber, VSwitchCidrReservationMask, or VSwitchCidrReservationCidr must be specified. | IpPrefixNumber、VSwitchCidrReservationMask、または VSwitchCidrReservationCidr のいずれかを指定する必要があります。 |
| 400 | Conflict.VSwitchCidrReservationParam | IpPrefixNumber cannot be used together with VSwitchCidrReservationCidr or VSwitchCidrReservationMask. | IpPrefixNumber を VSwitchCidrReservationCidr または VSwitchCidrReservationMask と併用することはできません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。