新建交換機(jī)
描述
在指定 VPC 內(nèi)創(chuàng)建一個(gè)新的VSwitch。
VSwitch 下的云產(chǎn)品實(shí)例不能分布在不同可用區(qū)
每個(gè) VPC 的 VSwitch 數(shù)量不允許超過(guò) 24 個(gè)
每個(gè) VSwitch 的掩碼為 16 - 29 位，可以提供 8 - 65535 個(gè) IP 地址
每個(gè) VSwitch 的第 1 個(gè)和最后 3 個(gè) 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 個(gè) VSwitch
VSwitch 的 CIDRBlock，不能與所在 VPC 當(dāng)前 RouteEntry 的 DestCIDRBlock 相同
VSwitch 的 CIDRBlock，不能包含所在 VPC 當(dāng)前 RouteEntry 的 DestCIDRBlock，但可以是當(dāng)前 RouteEntry 的 DestCIDRBlock 的子集
VSwitch 創(chuàng)建成功后，CidrBlock 無(wú)法修改
VSwitch 下的云產(chǎn)品實(shí)例數(shù)量不允許超過(guò) VPC 剩余的可用云產(chǎn)品實(shí)例數(shù)量(5000 - 當(dāng)前云產(chǎn)品實(shí)例數(shù)量)
1 個(gè)云產(chǎn)品實(shí)例只能屬于 1 個(gè) VSwitch
請(qǐng)求參數(shù)
名稱(chēng)
類(lèi)型
是否必須
描述
Action
String
是
系統(tǒng)規(guī)定參數(shù)，取值：CreateVSwitch
ZoneId
String
是
可用區(qū) Id
CidrBlock
String
是
指定VSwitch的網(wǎng)段
VpcId
String
是
指定VSwitch所在的 VPC
VSwitchName
String
否
VSwitch名稱(chēng)，不填則為空，默認(rèn)值為空，[2, 128] 英文或中文字符，必須以大小字母或中文開(kāi)頭，可包含數(shù)字，”_”或”-”，這個(gè)值會(huì)展示在控制臺(tái)。不能以 和 https:// 開(kāi)頭。
Description
String
否
VSwitch 描述，不填則為空，默認(rèn)值為空，[2, 256] 英文或中文字符，不能以 和 https:// 開(kāi)頭。
ClientToken
String
否
用于保證請(qǐng)求的冪等性。由客戶端生成該參數(shù)值，要保證在不同請(qǐng)求間唯一，最大不值過(guò) 64 個(gè) ASCII 字符。
返回參數(shù)
名稱(chēng)
類(lèi)型
描述
VSwitchId
String
系統(tǒng)分配的 VSwitchID
錯(cuò)誤碼
錯(cuò)誤代碼
描述
Http 狀態(tài)碼
語(yǔ)義
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ù)量達(dá)到配額上限
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 失敗
示例
請(qǐng)求示例
https://ecs.aliyuncs.com/?Action=CreateVSwitch
&CidrBlock=172.16.1.0/24
&VpcId=vpc-257gq642n
&ZoneId=cn-beijing-a
&<公共請(qǐng)求參數(shù)>
返回示例
