vSwitch の予約済み CIDR ブロックを作成します。
操作説明
概要
以下の点にご注意ください。
-
VPC 内の各 vSwitch に対して、最大で 10 個の予約済み IPv4 CIDR ブロックおよび 10 個の予約済み IPv6 CIDR ブロックを作成できます。
-
vSwitch の予約済み CIDR ブロックを作成した後、その CIDR ブロックには、当該 vSwitch が属する VPC のサブネットゲートウェイの IP アドレスを含めることはできません。
-
CreateVSwitchCidrReservation は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返し、バックグラウンドでタスクを実行します。タスクのステータスは、ListVSwitchCidrReservations を呼び出して確認できます。
vSwitch のステータスが Assigning の場合、予約済み CIDR ブロックが作成中です。
vSwitch のステータスが Assigned の場合、予約済み CIDR ブロックが作成済みです。
-
vSwitch の予約済み IPv4 CIDR ブロックを作成する場合、vSwitch の最初の IP アドレスおよび最後の 3 つの IP アドレスはシステムによって予約されます。これらの 4 つの IP アドレスは割り当てられません。
-
vSwitch の予約済み IPv6 CIDR ブロックを作成する場合、vSwitch の最初の IP アドレスおよび最後の 9 つの IP アドレスはシステムによって予約されます。これらの 10 の IP アドレスは割り当てられません。たとえば、CIDR ブロックが 192.168.1.0/24 の vSwitch に対して予約済み IPv4 CIDR ブロックを作成する場合、次の IP アドレスを予約済み CIDR ブロックに含めることはできません:192.168.1.0、192.168.1.253、192.168.1.254、192.168.1.255。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vpc:CreateVSwitchCidrReservation |
create |
*VSwitchCidrReservation
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Tag |
array<object> |
任意 |
リソースタグ |
|
|
object |
任意 |
|||
| Key |
string |
任意 |
リソースに追加するタグ N のキーです。最大 20 個のタグキーを指定できます。タグキーは空文字列にすることはできません。 タグキーの長さは最大 128 文字です。先頭を aliyun または acs: にすることはできず、http:// または https:// を含めることはできません。 |
FinanceDept |
| Value |
string |
任意 |
リソースに追加するタグ N の値です。最大 20 個のタグ値を指定できます。タグ値は空文字列にすることもできます。 タグ値の長さは最大 128 文字です。先頭を acs: または aliyun にすることはできず、http:// または https:// を含めることはできません。 |
FinanceJoshua |
| VSwitchId |
string |
必須 |
予約済み CIDR ブロックが属する vSwitch の ID です。 |
vsw-25navfgbue4g**** |
| VSwitchCidrReservationName |
string |
任意 |
予約済み CIDR ブロックの名前です。 名前の長さは 2~128 文字で、数字、アンダースコア (_)、ハイフン (-) を使用できます。先頭は英字である必要があります。 |
ReservationName |
| VSwitchCidrReservationDescription |
string |
任意 |
予約済み CIDR ブロックの説明です。デフォルトではこのパラメーターは空です。 説明の長さは 2~256 文字で、先頭は英字である必要があります。 |
ReservationDescription |
| IpVersion |
string |
任意 |
予約済み CIDR ブロックの IP バージョンです。有効な値は次のとおりです。
|
IPv4 |
| VSwitchCidrReservationMask |
string |
任意 |
予約済み CIDR ブロックのサブネットマスクです。
説明
VSwitchCidrReservationMask および VSwitchCidrReservationCidr のいずれか一方を指定する必要があります。 |
28 |
| VSwitchCidrReservationCidr |
string |
任意 |
vSwitch の予約済み CIDR ブロックです。
説明
VSwitchCidrReservationMask および VSwitchCidrReservationCidr のいずれか一方を指定する必要があります。 |
192.168.1.64/28 |
| VSwitchCidrReservationType |
string |
任意 |
予約済み CIDR ブロックのタイプです。値を prefix に設定します。 説明
ユーザーまたはクラウドサービスが ENI (Elastic Network Interface) に CIDR ブロックを割り当てる場合、その CIDR ブロックは予約済み CIDR ブロックから割り当てる必要があります。予約済み CIDR ブロックの容量が枯渇している場合は、エラーが返されます。 |
prefix |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークンです。 クライアント側でトークンを生成できますが、異なるリクエスト間でトークンが一意になるようにする必要があります。トークンには ASCII 文字のみを使用できます。 説明
このパラメーターを指定しない場合、システムは自動的に リクエスト ID を クライアントトークン として使用します。リクエスト ID は各リクエストごとに異なる可能性があります。 |
123e4567-e89b-12d3-a456-426655440000 |
| DryRun |
boolean |
任意 |
実際のリクエストを実行せずにドライランのみを実施するかどうかを指定します。有効な値は次のとおりです。
|
false |
| RegionId |
string |
必須 |
vSwitch がデプロイされているリージョンの ID です。 最新のリージョンリストを照会するには、DescribeRegions 操作を呼び出してください。 |
cn-hangzhou |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
予約済み CIDR ブロックの ID です。 |
||
| VSwitchCidrReservationId |
string |
予約済み 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. | |
| 400 | ResourceNotFound.VSwitch | The specified resource of VSwitch is not found. | |
| 400 | UnsupportedFeature.ReservedType | The specified ReservedType is not supported. | |
| 400 | UnsupportedFeature.VSwitchIpv6 | The ipv6 feature of switch is not supported. | |
| 400 | OperationFailed.VSwitchCidrReservationCidr | The specified VSwitchCidrReservationCidr conflicts with existed cidr reservation or vswitch cidr. | |
| 400 | MissingParam.CidrReservationMaskOrCidrReservationCidr | Either VSwitchCidrReservationMask or VSwitchCidrReservationCidr should be specified. | |
| 400 | UnsupportedRegion | UnsupportedRegion | |
| 400 | UnsupportedFeature.VpcAdvancedFeature | UnsupportedFeature.VpcAdvancedFeature | |
| 400 | QuotaExceeded.CidrReservationCount | The quota of VSwitchCidrReservation is exceeded. | |
| 400 | Conflict.CidrReservationMaskAndCidrReservationCidr | The specified VSwitchCidrReservationMask and VSwitchCidrReservationCidr is conflict. | |
| 400 | OperationFailed.CidrNotEnoughInVSwitch | No enough cidr to allocate in this vswitch. | |
| 400 | OperationFailed.SystemReservedIpContained | The specified VSwitchCidrReservationCidr cannot contain system reserved IP addresses. | |
| 400 | OperationFailed.AlreadyUsedIpContained | The specified VSwitchCidrReservationCidr cannot contain already used IP addresses. | |
| 400 | IncorrectStatus.VSWITCH | The status of the specified VSwitch is invalid. | |
| 400 | IllegalParam.VSwitchCidrReservationMask | The specified VSwitchCidrReservationMask must be at least 2 bits greater than the vSwitch mask. | |
| 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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。