新建交換機
描述
在指定 VPC 內(nèi)創(chuàng)建一個新的VSwitch。
VSwitch 下的云產(chǎn)品實例不能分布在不同可用區(qū)
每個 VPC 的 VSwitch 數(shù)量不允許超過 24 個
每個 VSwitch 的掩碼為 16 - 29 位，可以提供 8 - 65535 個 IP 地址
每個 VSwitch 的第 1 個和最后 3 個 IP 地址為系統(tǒng)保留(以 192.168.1.0 / 24 為例，192.168.1.0 和 192.168.1.255 以及 192.168.1.253 - 254 這些地址是系統(tǒng)保留地址)。
VSwitch 不支持組播和廣播
VSwitch 的 CIDRBlock，必須從屬于所在 VPC 的 CIDRBlock
VSwitch 的 CIDRBlock 可以與所在 VPC 的 CIDRBlock 相同，但這意味著您的 VPC 只能擁有 1 個 VSwitch
VSwitch 的 CIDRBlock，不能與所在 VPC 當前 RouteEntry 的 DestCIDRBlock 相同
VSwitch 的 CIDRBlock，不能包含所在 VPC 當前 RouteEntry 的 DestCIDRBlock，但可以是當前 RouteEntry 的 DestCIDRBlock 的子集
VSwitch 創(chuàng)建成功后，CidrBlock 無法修改
VSwitch 下的云產(chǎn)品實例數(shù)量不允許超過 VPC 剩余的可用云產(chǎn)品實例數(shù)量(5000 - 當前云產(chǎn)品實例數(shù)量)
1 個云產(chǎn)品實例只能屬于 1 個 VSwitch
請求參數(shù)
名稱
類型
是否必須
描述
Action
String
是
系統(tǒng)規(guī)定參數(shù)，取值：CreateVSwitch
ZoneId
String
是
可用區(qū) Id
CidrBlock
String
是
指定VSwitch的網(wǎng)段
VpcId
String
是
指定VSwitch所在的 VPC
VSwitchName
String
否
VSwitch名稱，不填則為空，默認值為空，[2, 128] 英文或中文字符，必須以大小字母或中文開頭，可包含數(shù)字，”_”或”-”，這個值會展示在控制臺。不能以 和 https:// 開頭。
Description
String
否
VSwitch 描述，不填則為空，默認值為空，[2, 256] 英文或中文字符，不能以 和 https:// 開頭。
ClientToken
String
否
用于保證請求的冪等性。由客戶端生成該參數(shù)值，要保證在不同請求間唯一，最大不值過 64 個 ASCII 字符。
返回參數(shù)
名稱
類型
描述
VSwitchId
String
系統(tǒng)分配的 VSwitchID
錯誤碼
錯誤代碼
描述
Http 狀態(tài)碼
語義
InvalidZoneId.NotFound
Specified zone does not exist.
404
指定的可用區(qū)不存在
InvalidVpcId.NotFound
Specified VPC does not exist.
404
指定的 VPC 不存在
InvalidCidrBlock.Malformed
Specified CIDR block is not valid.
400
指定的 CIDR 格式不正確
InvalidVSwitchName.Malformed
Specified virtual switch name is not valid.
400
指定的 VSwitch 名字格式不正確
InvalidVSwitchDiscription.Malformed
Specified virtual switch description is not valid.
400
指定的 VSwitch 描述信息格式不正確
ResourceNotAvailable
Resource you requested is not available in this region or zone.
400
指定的 Region 或者可用區(qū)不支持 VPC
InvalidParameter
Specified CIDR block is not valid in VPC.
400
指定的 CIDR 不正確
InvalidCidrBlock.Overlapped
Specified CIDR block overlapped with other subnets.
400
指定的 CIDR 與其他 VSwitch 的 CIDR 重疊
InvalidCidrBlock.Overlapped
Specified CIDR block overlapped with other entry
400
指定的 CIDR 與已有的自定義路由的 CIDR 重疊
QuotaExceeded.VSwitch
Virtual switch quota exceeded.
400
VSwitch 數(shù)量達到配額上限
IncorretRouteEntryStatus
Some route entry status blocked this operation.
400
部分自定義路由處于 pending 狀態(tài)，創(chuàng)建 VSwitch 失敗
IncorretVSwitchStatus
Some virtual switch is modifying within the same VPC.
400
部分 VSwitch 處于 pending 狀態(tài)，創(chuàng)建 VSwitch 失敗
InvalidCirdrBlock.MaskLength
Specified CIDR block is not valid.
400
指定的 CIDR 網(wǎng)段格式不正確
IncorrectVpcStatus
Current VPC status does not support this operation.
400
指定的 VPC 處于 pending 狀態(tài)，創(chuàng)建 VSwitch 失敗
示例
請求示例
https://ecs.aliyuncs.com/?Action=CreateVSwitch
&CidrBlock=172.16.1.0/24
&VpcId=vpc-257gq642n
&ZoneId=cn-beijing-a
&<公共請求參數(shù)>
返回示例
