すべてのプロダクト
Search
ドキュメントセンター

Virtual Private Cloud:CreateDefaultVSwitch

最終更新日:Oct 26, 2026

デフォルト vSwitch を作成します。

操作説明

この操作を呼び出してデフォルト vSwitch を作成する場合は、次の項目に注意してください。

  • 各デフォルト vSwitch の CIDR ブロックの最初の IP アドレスと最後の 3 つの IP アドレスは、システム予約済み IP アドレスです。たとえば、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 の作成後、その CIDR ブロックを変更することはできません。

  • CreateDefaultVSwitch 操作は非同期です。この操作を呼び出すと、システムはインスタンス ID を返しますが、デフォルト vSwitch はまだ作成されておらず、バックグラウンドタスクが進行中です。 DescribeVSwitchAttributes 操作を呼び出して、デフォルト vSwitch の作成ステータスをクエリできます。

    • デフォルト vSwitch が Pending 状態の場合、デフォルト vSwitch は設定中です。

    • デフォルト vSwitch が Available 状態の場合、デフォルト vSwitch は利用可能です。

  • 指定されたリージョンの指定されたゾーンにデフォルト vSwitch がすでに存在する場合、デフォルト vSwitch を作成する呼び出しは失敗します。

  • デフォルト vSwitch を作成するには、まずデフォルト VPC を作成する必要があります。 CreateDefaultVpc 操作を呼び出して、デフォルト VPC を作成できます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

  • アクション:特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

  • API:アクションを具体的に実行するための API。

  • アクセスレベル:各 API に対して事前定義されているアクセスの種類。有効な値:create、list、get、update、delete。

  • リソースタイプ:アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

    • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

    • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

  • 条件キー:サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

  • 依存アクション:ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

vpc:CreateDefaultVSwitch

create

*VSwitch

acs:vpc:{#regionid}:{#accountId}:vswitch/*

なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

ZoneId

string

必須

作成するデフォルト vSwitch のゾーンの ID。

DescribeZones 操作を呼び出して、ゾーン ID をクエリできます。

cn-hangzhou-b

RegionId

string

必須

作成するデフォルト vSwitch のリージョンの ID。

DescribeRegions 操作を呼び出して、リージョン ID をクエリできます。

cn-hangzhou

Ipv6CidrBlock

integer

任意

vSwitch の IPv6 CIDR ブロックの最後の 8 ビット。有効な値: 0 から 255。

12

ClientToken

string

任意

リクエストのべき等性を確保するために使用されるクライアントトークン。

クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。クライアントトークンには ASCII 文字のみを使用できます。

説明

このパラメーターを指定しない場合、システムは API 呼び出しの RequestId を ClientToken として自動的に使用します。各 API 呼び出しの RequestId は一意です。

0c593ea1-3bea-11e9-b96b-88e9fe63****

レスポンスフィールド

フィールド

型

説明

例

object

作成されたデフォルト vSwitch の ID。

VSwitchId

string

作成されたデフォルト vSwitch の ID。

vsw-bp1a4b5qhmxftjimq****

RequestId

string

リクエスト ID。

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

例

成功レスポンス

JSONJSON

{
  "VSwitchId": "vsw-bp1a4b5qhmxftjimq****",
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidDescription.Malformed Invalid description.
400 InvalidVSwitchName.Malformed Specified virtual switch name is not valid. vSwitch 名のフォーマットが無効です。名前のフォーマットを確認してください。
400 InvalidVSwitchDiscription.Malformed Specified virtual switch description is not valid.
400 Abs.Vpc.InvalidDescription.Malformed Specified virtual switch name is not valid.
400 ResourceNotAvailable Resource you requested is not available in this region or zone.
400 InvalidParameter Specified CIDR block is not valid in VPC.
400 InvalidCidrBlock.Overlapped Specified CIDR block overlapped with other subnets.
400 QuotaExceeded.VSwitch Virtual switch quota exceeded. vSwitch の数がクォータ制限に達しました。vSwitch の数を減らして、もう一度お試しください。
400 IncorrectRouteEntryStatus Some route entry status blocked this operation.
400 IncorrectVSwitchStatus Some virtual switch is modifying within the same VPC. VPC 内の別の vSwitch が作成中の状態であるため、vSwitch の作成に失敗しました。
400 InvalidCirdrBlock.MaskLength Specified CIDR block is not valid . CIDR ブロックのフォーマットが無効です。
400 IncorrectVpcStatus Current VPC status does not support this operation.
400 CreateVSwitch.IncorrectStatus.cbnStatus Current CBN status does not support this operation. 現在の CBN のステータスでは、vSwitch を作成できません。
400 InvalidCidrBlock.Malformed Specified CIDR block is not valid.
400 MissingParameter Miss mandatory parameter.
400 TaskConflict The operation is too frequent, TaskConflict. EIP に対する操作が頻繁すぎます。
400 VPC.SWITCH.RULE.QUOTA.NOT.EXISTS vSwitch quota rule not exists.
400 Forbidden.VpcNotFound Specified VPC can not found. 指定された VPC が存在しません。VPC が正しいかどうかを確認してください。
400 RouteConflict.AlreadyExist Route conflict exists in routing table. ルートテーブルでルートの競合が発生しています。
400 OperationFailed.CidrAcross Classic link instance cidr must not across.
400 Duplicated.ClientToken %s
400 OperationFailed.Ipv6CidrBlockExisted %s
400 IllegalParam.Ipv6CidrBlock %s
400 OperationFailed.VpcIpv6Disabled %s
400 IncorrectStatus.cbnStatus Current CBN status does not support this operation. CBN の現在のステータスが無効です。
400 OperationFailed.DefaultVpcNotExist %s
400 UnsupportedFeature.CloudBoxIpv6 The IPv6 feature is not supported by cloud box. CloudBox は IPv6 アドレスの作成をサポートしていません。
400 OperationDenied.VpcPeerExist The operation is not allowed because the VPC peer exists. VPC にピアリング接続が存在するため、指定された操作は許可されません。
400 OperationDenied.CenAttached The operation is not allowed because the VPC is attached to CEN. VPC が CEN インスタンスに関連付けられているため、指定された操作は許可されません。
400 OperationDenied.NatgwExist The operation is not allowed because the NAT gateway exists in VPC. VPC 内に NAT ゲートウェイが存在するため、指定された操作は許可されません。
400 OperationDenied.OtherSubnetCreating other subnet is creating
400 OperationFailed.DefaultVSwitchExist A default vSwitch already exists in the zone. 現在のゾーンにはすでにデフォルト vSwitch が存在するため、エラーとなります。
400 InvalidStatus.RouteEntry RouteEntry status error.
400 InvalidZoneId.NotFound Specified zone does not exist.
400 OperationDenied.ZoneIsDisabled The specified zone is disabled. You cannot create a vSwitch in a disabled zone. 現在のゾーンは無効化されています。このゾーンに vSwitch を作成することはできません。
404 Invalid.NotExist witch mask rule not exists.
404 InvalidVpcId.NotFound Specified VPC does not exist.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。