VPC に VSwitch を作成します。
-
各 VPC に最大 24個 の VSwitch を作成することができます。
-
先頭1つ と末尾 3 つの VSwitch の IP アドレスはシステム用に確保されています。 たとえば、VSwitch の CIDR ブロックが192.168.1.0/24 の場合、IP アドレス 192.168.1.0、192.168.1.253、192.168.1.254、192.168.1.255 は システム用に確保されています。
-
VSwitch 配下のクラウド製品のインスタンスの数が VPC の容量の残量 (15,000 － 現在のクラウド製品のインスタンスの数) を超えることはできません 。
-
クラウド製品のインスタンスが属することができる VSwitch は１つのみです。
-
VSwitchは、ブロードキャスト、マルチキャストに対応していません。
デバッグ
API Explorerを使用することで 、API のデバッグ、SDK コード例の自動生成、API 素早い検索を簡単にすることができます。
リクエストパラメーター
| パラメーター | データ型 | 必須/省略可能 | 値の例 | 説明 |
|---|---|---|---|---|
| Action | String | 必須 | CreateVSwitch |
このアクションの名前。 値 ： CreateVSwitch |
| CidrBlock | String | 必須 | 172.16.0.0/24 |
VSwitch の CIDR ブロック。 IP アドレスの範囲は次の要件を満たす必要があります。
|
| VpcId | String | 必須 | vpc-257gq6nxxxxxxx |
VSwitch が所属する VPC を選択します。 |
| ZoneId | String | 必須 | cn-hangzhou-d |
スイッチが属するゾーンの ID。 リージョン ID を照会するには、 DescribeRegions を呼び出します。 |
| RegionId | String | 必須 | cn-hangzhou |
VSwitch が属するリージョンの ID。 |
| Ipv6CidrBlock | Integer | 省略可能 | 0 |
VSwitch の IPv6 CIDR ブロック。 IPv6 CIDR ブロックの最後の 8 bits をカスタマイズできます。 値の範囲：0 ～ 255 。 デフォルトでは、IPv6 CIDK マスクの長さは / 64 です。 |
| Description | String | 省略可能 | This is my vswitch. |
VSwitch の説明。 説明は、長さが 2 ~ 256 文字で、文頭は文字である必要があります。 先頭文字列を |
| VSwitchName | String | 省略可能 | VSwitch-1 |
VSwitch の 名前。 名前の長さは1〜128文字で、文字で始まる必要があります。 先頭文字列を |
| ClientToken | String | 省略可能 | dhueeuxxxxxxdde |
リクエストの冪等性を保証するために使用されるクライアントトークン。 クライアントによって生成されるパラメーター値で、一意である必要があります。 長さは 1 ～64 文字である必要があります。 |
| OwnerAccount | String | 省略可能 | N/A |
所有者アカウント。 |
レスポンスパラメーター
| パラメーター | データ型 | 値の例 | 説明 |
|---|---|---|---|
| RequestId | String | 861E6630-AEC0-4B2D-B214-6CB5E44B7F04 | リクエストの ID 。 |
| VSwitchId | String | vsw-25naue4gz | スイッチの ID。 |
例
リクエストの例
https://vpc.aliyuncs.com/?Action=CreateVSwitch
&CidrBlock=172.16.0.0/24
&VpcId=vpc-257gq6nxxxxxxx
&ZoneId=cn-hangzhou-b
&<CommonParameters>
-
XML 形式
<CreateVSwitchResponse> <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId> <VSwitchId>vsw-25naue4gz</VSwitchId> </CreateVSwitchResponse> -
JSON 形式
{ "RequestId":"0ED8D006-F706-4D23-88ED-E11ED28DCAC0", "VSwitchId":"vsw-25naue4gz" }
エラーコード
| HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
|---|---|---|---|
| 404 | InvalidZoneId.NotFound | 指定されたゾーンは存在しません。 | ゾーンの ID が正しくありません。 |
| 404 | InvalidVpcId.NotFound | 指定された VPC は存在しません。 | 指定された VPC は存在しません。 |
| 400 | InvalidVSwitchName.Malformed | 指定された仮想スイッチは存在しません。 | 指定された VSwitch の名前の形式が無効です。 |
| 400 | ResourceNotAvailable | このリージョンまたはゾーンでは、リクエストしたリソースは利用できません。 | このリージョンまたはゾーンでは、リクエストしたリソースは利用できません。 |
| 400 | InvalidParameter | 指定された CIDR ブロックは VPC では無効です。 | 指定された CIDR ブロックは、VPC の CIDR ブロックに属していません。 |
| 400 | InvalidCidrBlock.Overlapped | 指定された CIDR ブロックは他のサブネットと重複しています。 | 指定された CIDR ブロックは、別の VSwitch の CIDR ブロックまたは既存のカスタマールートのターゲット CIDK ブロックと重複しています。 使用されていない CIDR ブロックを選択します。 |
| 400 | InvalidCidrBlock.Overlapped | 指定された CIDR ブロックは他のエントリと重複しています。 | 指定された CIDR ブロックは、別の VSwitch の CIDR ブロック、または既存のカスタマールートのターゲット CIDK ブロックと重複しています。 使用されていない CIDR ブロックを選択します。 |
| 400 | QuotaExceeded.VSwitch | 仮想スイッチのクォータを超えました。 | VSwitch の最大数を超えています。 |
| 400 | IncorrectRouteEntryStatus | 一部のルートエントリのステータスによって、この操作がブロックされました。 | ルートテーブルには、Pending または Modifying ステータスのエントリが含まれます。 |
| 400 | IncorrectVSwitchStatus | 同じ VPC 内に変更中の仮想スイッチがあります。 | VPC に Modifying ステータスの VSwitch が 複数あります。 後ほどもう一度お試しください。 |
| 400 | InvalidCirdrBlock.MaskLength | 指定された CIDR ブロックは無効です。 | CIDR ブロックの形式が無効です。 |
| 400 | IncorrectVpcStatus | 現在の VPC のステータスでは、この操作を実行できません。 | VPC の現在のステータスでは、この操作を実行できません。 |
| 400 | MissingParameter | 必須なパラメーターが欠如しています。 | 必要なパラメーターが欠如しています。 |
| 400 | IncorrectVSwitchStatus | VSwitch を同時に作成することはできません。 | VPC に Creating ステータスの VSwitch が含まれているため、VSwitch を作成できません。 |
| 400 | Forbidden.VpcNotFound | 指定された VPC が見つかりません。 | 指定された VPC は存在しません。 |