vSwitch の予約済み CIDR ブロックを作成します。
操作説明
この操作を呼び出して vSwitch の予約済み CIDR ブロックを作成する際は、以下の点にご注意ください。
VPC 内の予約済み IPv4 および IPv6 CIDR ブロックの最大値はそれぞれ 100 です。
- 予約済み CIDR ブロックには、それが属する vSwitch のシステム予約済み IP アドレスを含めることはできません。
IPv4 CIDR ブロック: vSwitch の最初の 3 つおよび最後の 3 つの IP アドレスはシステム予約済み IP アドレスです。
IPv6 CIDR ブロック: vSwitch の最初の 9 つおよび最後の 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 |
必須 |
予約済み CIDR ブロックを作成する vSwitch の ID。 |
vsw-25navfgbue4g**** |
| VSwitchCidrReservationName |
string |
任意 |
vSwitch の予約済み CIDR ブロックの名前。 名前の長さは 1~128 文字で、英字または漢字で始める必要があります。数字、アンダースコア (_)、ハイフン (-) を含めることができます。 |
ReservationName |
| VSwitchCidrReservationDescription |
string |
任意 |
vSwitch の予約済み CIDR ブロックの説明。このパラメーターを指定しない場合、説明は空になります。デフォルト値は空です。 説明の長さは 1~256 文字で、英字または漢字で始める必要があります。 |
ReservationDescription |
| IpVersion |
string |
任意 |
vSwitch の予約済み CIDR ブロックの IP バージョン。有効な値:
説明
IPv4 の予約済み CIDR ブロックを作成する場合、このパラメーターを指定する必要はありません。IPv6 の予約済み CIDR ブロックを作成する場合、このパラメーターは必須です。 |
IPv4 |
| VSwitchCidrReservationMask |
string |
任意 |
vSwitch の予約済み CIDR ブロックのマスク。
説明
|
28 |
| VSwitchCidrReservationCidr |
string |
任意 |
vSwitch の予約済み CIDR ブロック。マスク長も指定できます。
説明
|
192.168.1.64/28 |
| VSwitchCidrReservationType |
string |
任意 |
vSwitch の予約済み CIDR ブロックのタイプ。有効な値: prefix。これは、IP アドレスが CIDR ブロック単位で割り当てられることを示すプレフィックスです。 説明
ユーザーまたはクラウドサービスがエラスティックネットワークインターフェイス (ENI) に CIDR ブロックを自動的に割り当てる場合、CIDR ブロックは予約済み CIDR ブロックから割り当てられる必要があります。予約済み CIDR ブロック内のすべての IP アドレスが割り当てられている場合、システムはエラーを返します。 |
prefix |
| 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。 |
||
| VSwitchCidrReservationId |
string |
vSwitch の予約済み CIDR ブロックのインスタンス ID。 |
vcr-bp1m12saqteraw3rp**** |
| RequestId |
string |
リクエスト ID。 |
54B48E3D-DF70-471B-AA93-08E683A1B45 |
例
成功レスポンス
JSONJSON
{
"VSwitchCidrReservationId": "vcr-bp1m12saqteraw3rp****",
"RequestId": "54B48E3D-DF70-471B-AA93-08E683A1B45"
}
エラーコード
|
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. | ネットワークインターフェースコントローラー (NIC) に関連付けられた 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 | この VPC は一部の高度な機能をサポートしていません。サポートが必要な場合はチケットを提出してください。 |
| 400 | QuotaExceeded.CidrReservationCount | The quota of VSwitchCidrReservation is exceeded. | 作成した CidrReservation の数が制限を超えています。 |
| 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 は、vSwitch マスクより 2 以上大きい値である必要があります。 |
| 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. | %s のクォータ制限により操作が失敗したためエラーが発生しました。予約済み CIDR ブロックのマスクが、現在の IP プレフィックスのデフォルトマスク %s/%s を超えています。 |
| 400 | IllegalParam.ReservedType | IpPrefixNumber is only supported with Prefix reserved type. | IpPrefixNumber は Prefix 予約タイプでのみサポートされます。 |
| 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 と併用できません。 |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。