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 は1つのみです。

  • VSwitchは、ブロードキャスト、マルチキャストに対応していません。

VSwitch の作成後、CIDR ブロックの変更はできません。

デバッグ

API Explorerを使用することで 、API のデバッグ、SDK コード例の自動生成、API 素早い検索を簡単にすることができます。

リクエストパラメーター

パラメーター データ型 必須/省略可能 値の例 説明
Action String 必須 CreateVSwitch

このアクションの名前。 値 :

CreateVSwitch

CidrBlock String 必須 172.16.0.0/24

VSwitch の CIDR ブロック。 IP アドレスの範囲は次の要件を満たす必要があります。

  • VSwitch のサブネットマスクの長さは / 16 〜 / 29 の範囲である必要があります。
  • VSwitch の CIDR ブロックは、VPC の CIDR ブロックに属している必要があります。
  • VSwitch の CIDR ブロックと VPC 内のルートエントリのターゲット CIDR ブロックを同じにすることはできません。VPC CIDR ブロックのサブセットにすることはできます。
  • スイッチのネットワークセグメントが同じ VPC のネットワークセグメントと同じの場合、VPC に作成できるスイッチは 1 つのみです。
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 文字で、文頭は文字である必要があります。 先頭文字列を http:// or https:// にすることはできません。

VSwitchName String 省略可能 VSwitch-1

VSwitch の 名前。

名前の長さは1〜128文字で、文字で始まる必要があります。 先頭文字列を http:// または https:// にすることはできません。

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 は存在しません。

共通エラーコードをご参照ください。