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

Elastic Compute Service:CreateVSwitch

最終更新日:Sep 15, 2026

vSwitch を作成します。

説明

この API は廃止されました。一時的にアクセス可能ですが、更新やバグ修正対応は一切行われません。代わりに Vpc(2016-04-28) - CreateVSwitch への移行を推奨します。より強化された機能に加え、サポートも引き続きご利用いただけます。

今すぐお試しください

この 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:CreateVSwitch

create

*すべてのリソース。

*

  • vpc:tag
なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

ZoneId

string

必須

VSwitch を作成するゾーンの ID。

CidrBlock

string

必須

VSwitch の CIDR ブロック。

VpcId

string

必須

VSwitch が属する VPC の ID。

RegionId

string

任意

VSwitch が配置されているリージョンの ID。

VSwitchName

string

任意

VSwitch の名前。

Description

string

任意

VSwitch の説明。

ClientToken

string

任意

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

レスポンスフィールド

フィールド

型

説明

例

object

RequestId

string

VSwitchId

string

例

成功レスポンス

JSONJSON

{
  "RequestId": "",
  "VSwitchId": ""
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 OperationFailed.IdempotentTokenProcessing Action is processing.
400 InvalidDescription.Malformed Invalid description.
400 InvalidVSwitchName.Malformed Specified virtual switch name is not valid. VSwitch 名のフォーマットが無効です。VSwitch 名のフォーマットを確認してください。
400 InvalidVSwitchDiscription.Malformed Specified virtual switch description is not valid. 指定された vSwitch の説明のフォーマットが無効です。
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. この vSwitch の CIDR ブロックが、他の vSwitch の CIDR ブロックまたは既存のカスタムルートの送信先 CIDR ブロックと重複しています。使用中でない CIDR ブロックを使用してください。
400 QuotaExceeded.VSwitch Virtual switch quota exceeded. vSwitch の数がクォータ制限に達しました。
400 IncorrectRouteEntryStatus Some route entry status blocked this operation. 現在のルートテーブル内のルートエントリが保留中または変更中の状態であるため、操作を実行できません。
400 IncorrectVSwitchStatus Some virtual switch is modifying within the same VPC. 指定された vSwitch は保留中の状態であるため削除できません。
400 InvalidCirdrBlock.MaskLength Specified CIDR block is not valid . 指定された CIDR ブロックのフォーマットが無効です。
400 IncorrectVpcStatus Current VPC status does not support this operation. VPC の現在の状態では、この操作はサポートされていません。
400 InvalidCidrBlock.Malformed Specified CIDR block is not valid. 指定された CIDR ブロックの形式が無効です。
400 MissingParameter Miss mandatory parameter. 必須パラメーターが不足しています。
400 TaskConflict The operation is too frequent, TaskConflict. EIP の操作が頻繁すぎます。
400 RouteConflict.AlreadyExist Route conflict exists in routing table.
400 OperationFailed.CidrAcross Classic link instance cidr must not across.
400 VPC.SWITCH.RULE.QUOTA.NOT.EXISTS vSwitch quota rule not exists.
400 CreateVSwitch.IncorrectStatus.cbnStatus Current CBN status does not support this operation.
400 OperationFailed.NotifyCenCreate Failed to notify cen when create vswitch.
400 Forbidden.VpcNotFound Specified VPC can not found.
400 Duplicated.ClientToken %s
400 OperationFailed.DistibuteLock Distibute lock fail.
400 IllegalParam.CidrBlock The param of CidrBlock [%s] is illegal. CidrBlock [%s] が無効です。
400 OperationDenied.ZoneIsDisabled The specified zone is disabled. You cannot create a vSwitch in a disabled zone. 現在のゾーンは無効化されています。このゾーンでは vSwitch を作成できません。
400 Forbidden.OperateShareResource The operation is forbidden because the resource is shared. リソースが共有リソースであるため、この操作は禁止されています。
400 InvalidRegionId.NotFound Specified value of regionId is not supported. 指定された RegionId が存在しません。このリージョンでプロダクトが利用可能かどうかを確認してください。
500 InternalError The request processing has failed due to some unknown error.
404 Invalid.NotExist witch mask rule not exists.
404 InvalidStatus.RouteEntry RouteEntry status error.
404 InvalidZoneId.NotFound Specified zone does not exist. 指定されたゾーン ID が存在しません。
404 InvalidVpcId.NotFound Specified VPC does not exist. 指定された VPC ID が存在しません。

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

変更履歴

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