vSwitch を作成します。
操作説明
この API を呼び出して vSwitch を作成する際は、以下の点にご注意ください。
-
各 Virtual Private Cloud (VPC) 内の vSwitch 数は 150 を超えることはできません。
-
各 vSwitch CIDR ブロックの最初の IP アドレスと最後の 3 つの 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 から現在のクラウドサービスインスタンス数を引いた数) を超えることはできません。
-
クラウドサービスインスタンスは、1 つの vSwitch にのみ所属できます。
-
vSwitch は、マルチキャストおよびブロードキャストをサポートしていません。
-
vSwitch の作成後、その CIDR ブロックを変更することはできません。
-
CreateVSwitch API は非同期です。リクエストを送信すると、システムはインスタンス ID を返しますが、vSwitch はまだ作成されていません。バックグラウンドタスクはまだ実行中です。DescribeVSwitchAttributes を呼び出して、vSwitch の作成ステータスを確認できます。
vSwitch が Pending 状態の場合、vSwitch は構成中です。
vSwitch が Available 状態の場合、vSwitch は使用可能です。
-
CreateVSwitch API は、同じ VPC 内での vSwitch の同時作成をサポートしていません。
-
CreateVSwitch API を呼び出す際、vSwitch の CIDR ブロックを、次の予約済みアドレス範囲内に設定することはできません：100.64.0.0/10、127.0.0.0/8、169.254.0.0/16、または 224.0.0.0/4。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
vpc:CreateVSwitch |
create |
*VPC。
*VSwitch。
|
|
なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Tag |
array<object> |
任意 |
リソースのタグ。最大 20 個のタグを指定できます。 |
|
|
object |
任意 |
タグ。 |
||
| Key |
string |
任意 |
リソースのタグキー。タグキーを空の文字列にすることはできません。 タグキーは最大 128 文字です。 |
FinanceJoshua |
| Value |
string |
任意 |
リソースのタグ値。タグ値は空の文字列にすることもできます。 タグ値は最大 128 文字です。 |
FinanceDept |
| ZoneId |
string |
必須 |
vSwitch を作成するゾーンの ID。 DescribeZones API を呼び出して、ゾーン ID を照会できます。 |
cn-hangzhou-b |
| RegionId |
string |
任意 |
作成する vSwitch のリージョン ID。 DescribeRegions API を呼び出して、リージョン ID を照会できます。 |
cn-hangzhou |
| CidrBlock |
string |
必須 |
vSwitch の CIDR ブロック。次の要件があります：
説明
vSwitch の作成後に、CIDR ブロックを変更することはできません。 |
172.16.0.0/24 |
| Ipv6CidrBlock |
integer |
任意 |
vSwitch の IPv6 CIDR ブロックの末尾 8 ビット。有効値： 0 ～ 255。 このパラメーターは、vSwitch が所属する VPC で IPv6 が有効な場合にのみ指定できます。このパラメーターを指定すると、vSwitch に IPv6 CIDR ブロックが割り当てられます。IPv6 CIDR ブロックの割り当て後は変更できません。CIDR ブロックが、VPC 内の他の vSwitch と重複しないようにしてください。 |
12 |
| VpcId |
string |
必須 |
vSwitch が属する VPC の ID。 |
vpc-257gqcdfvx6n**** |
| VSwitchName |
string |
任意 |
vSwitch の名前。 名前は 1 ～ 128 文字で、 |
vSwitch-1 |
| Description |
string |
任意 |
vSwitch の説明。 説明は 1 ～ 256 文字で、 |
vSwitch |
| ClientToken |
string |
任意 |
リクエストのべき等性を確保するために使用するクライアントトークン。 クライアント側でトークンを生成できますが、リクエスト間でトークンが一意になるようにする必要があります。ClientToken の値には ASCII 文字のみを含めることができます。 説明
このパラメーターを指定しない場合、システムは API リクエストの RequestId を ClientToken として使用します。 RequestId は API リクエストごとに異なる場合があります。 |
0c593ea1-3bea-11e9-b96b-88e9fe63**** |
| VpcIpv6CidrBlock |
string |
任意 |
VPC の IPv6 CIDR ブロック。vSwitch が属する VPC に複数の IPv6 CIDR ブロックがある場合、このパラメーターを指定して、vSwitch に割り当てる IPv6 CIDR ブロック範囲を決定できます。このパラメーターを指定しない場合、VPC で IPv6 を有効化したときに割り当てられた IPv6 CIDR ブロックが使用されます。 |
2408:XXXX:0:6a::/56 |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
レスポンスパラメーター。 |
||
| VSwitchId |
string |
作成した vSwitch の ID。 |
vsw-25navfgbue4g**** |
| RequestId |
string |
リクエスト ID。 |
0ED8D006-F706-4D23-88ED-E11ED28DCAC0 |
例
成功レスポンス
JSONJSON
{
"VSwitchId": "vsw-25navfgbue4g****",
"RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | OperationFailed.ResourceConflict | vpc only support one cloud box. | |
| 400 | OperationFailed.IdempotentTokenProcessing | Action is processing. | |
| 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 | MissingParam.vpcId | The parameter vpcId is mandatory. | |
| 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. | 仮想スイッチのクオータ上限に達しました。 |
| 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. | |
| 400 | CreateVSwitch.IncorrectStatus.cbnStatus | Current CBN status does not support this operation. | Cloud Enterprise Network (CEN) の現在のステータスでは、vSwitch の作成はサポートされていません。 |
| 400 | InvalidCidrBlock.Malformed | Specified CIDR block is not valid. | |
| 400 | MissingParameter | Miss mandatory parameter. | |
| 400 | TaskConflict | The operation is too frequent, TaskConflict. | 操作の実行頻度が高すぎます。しばらく待ってからもう一度お試しください。 |
| 400 | VPC.SWITCH.RULE.QUOTA.NOT.EXISTS | vSwitch quota rule not exists. | |
| 400 | Forbidden.VpcNotFound | Specified VPC can not found. | 指定された 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.NotifyCenCreate | Failed to notify cen when create vswitch. | |
| 400 | OperationFailed.DistibuteLock | Distibute lock fail. | 別のリクエストによって操作がロック済みです。 |
| 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 (Cloud Enterprise Network) インスタンスに関連付けられているため、この操作は禁止されています。 |
| 400 | OperationDenied.NatgwExist | The operation is not allowed because the NAT gateway exists in VPC. | VPC に NAT Gateway が存在するため、この操作は禁止されています。 |
| 400 | MissingParam.Ipv6CidrBlock | The parameter Ipv6CidrBlock is mandatory. | 必須パラメーター Ipv6CidrBlock が不足しています。 |
| 400 | IllegalParam.VpcIpv6CidrBlock | %s | |
| 400 | OperationDenied.OtherSubnetCreating | The operation is not allowed because the other VSwitch is creating. | |
| 400 | OperationDenied.VpcPeerExists | The operation is not allowed because the VpcPeer exists. | VPC に VPC ピアリング接続インスタンスが存在するため、操作は拒否されました。 |
| 400 | IllegalParam.CidrBlock | The param of CidrBlock [%s] is illegal. | CidrBlock パラメーターが無効です。 |
| 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. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。