vSwitch を作成します。
操作説明
この操作を呼び出す際は、以下の制限事項にご注意ください。
-
VPC 内に作成できる vSwitch は最大 150 個です。
-
vSwitch CIDR ブロックの最初の IP アドレスおよび最後の 3 つの 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 から現在のインスタンス数を差し引いた値です。
-
各インスタンスは、1 つの vSwitch のみに所属できます。
-
vSwitch はマルチキャストおよびブロードキャストをサポートしていません。
-
vSwitch を作成した後は、その CIDR ブロックを変更できません。
-
CreateVSwitch は非同期操作です。リクエストを送信すると、システムはリクエスト ID を返し、タスクをバックグラウンドで実行します。DescribeVSwitchAttributes を呼び出して、タスクのステータスをクエリできます。
vSwitch のステータスが Pending の場合、vSwitch は構成中です。
vSwitch のステータスが Available の場合、vSwitch は利用可能です。
-
指定された期間内に、同一 VPC 内で CreateVSwitch 操作を繰り返し呼び出して vSwitch を作成することはできません。
今すぐお試しください
テスト
RAM 認証
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| Tag |
array<object> |
任意 |
リソースのタグ。 |
|
|
object |
任意 |
|||
| Key |
string |
任意 |
タグキー。最大 20 個のタグキーを指定できます。タグキーは空文字列にできません。 タグキーの長さは最大 128 文字です。 |
FinanceJoshua |
| Value |
string |
任意 |
タグ値。最大 20 個のタグ値を指定できます。タグ値は空文字列にできます。 タグ値の長さは最大 128 文字ですが、 |
FinanceDept |
| ZoneId |
string |
必須 |
vSwitch のゾーン ID。 最新のゾーンリストをクエリするには、DescribeZones 操作を呼び出してください。 |
cn-hangzhou-b |
| RegionId |
string |
任意 |
vSwitch のリージョン ID。 最新のリージョンリストをクエリするには、DescribeRegions 操作を呼び出してください。 |
cn-hangzhou |
| CidrBlock |
string |
必須 |
vSwitch の CIDR ブロック。以下の制限事項にご注意ください。
|
172.16.0.0/24 |
| Ipv6CidrBlock |
integer |
任意 |
vSwitch の IPv6 CIDR ブロックの下位 8 ビット。有効値：0～255。 |
12 |
| VpcId |
string |
必須 |
vSwitch を作成する VPC の ID。 |
vpc-257gqcdfvx6n**** |
| VSwitchName |
string |
任意 |
vSwitch の名前。 名前の長さは 1～128 文字で、 |
vSwitch-1 |
| Description |
string |
任意 |
vSwitch の説明。 説明の長さは 1～256 文字で、 |
vSwitch |
| ClientToken |
string |
任意 |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアント側で値を生成できますが、すべてのリクエストの中で一意であることを保証する必要があります。トークンには ASCII 文字のみを使用できます。 説明
このパラメーターを指定しない場合、ClientToken は RequestId の値に設定されます。RequestId の値は、API リクエストごとに異なる可能性があります。 |
0c593ea1-3bea-11e9-b96b-88e9fe63**** |
| VpcIpv6CidrBlock |
string |
任意 |
VPC の 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. | |
| 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. | |
| 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. | |
| 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. | |
| 400 | OperationDenied.VpcPeerExist | The operation is not allowed because the VPC peer exists. | |
| 400 | OperationDenied.CenAttached | The operation is not allowed because the VPC is attached to CEN. | |
| 400 | OperationDenied.NatgwExist | The operation is not allowed because the NAT gateway exists in VPC. | |
| 400 | MissingParam.Ipv6CidrBlock | The parameter Ipv6CidrBlock is mandatory. | |
| 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. | |
| 400 | IllegalParam.CidrBlock | The param of CidrBlock [%s] is illegal. | |
| 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. | |
| 404 | Invalid.NotExist | witch mask rule not exists. | |
| 404 | InvalidVpcId.NotFound | Specified VPC does not exist. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。