新建交换机
描述
在指定 VPC 内创建一个新的VSwitch。
VSwitch 下的云产品实例不能分布在不同可用区
每个 VPC 的 VSwitch 数量不允许超过 24 个
每个 VSwitch 的掩码为 16 - 29 位，可以提供 8 - 65535 个 IP 地址
每个 VSwitch 的第 1 个和最后 3 个 IP 地址为系统保留(以 192.168.1.0 / 24 为例，192.168.1.0 和 192.168.1.255 以及 192.168.1.253 - 254 这些地址是系统保留地址)。
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 创建成功后，CidrBlock 无法修改
VSwitch 下的云产品实例数量不允许超过 VPC 剩余的可用云产品实例数量(5000 - 当前云产品实例数量)
1 个云产品实例只能属于 1 个 VSwitch
请求参数
名称 |
类型 |
是否必须 |
描述 |
Action
String
是
系统规定参数，取值：CreateVSwitch
ZoneId
String
是
可用区 Id
CidrBlock
String
是
指定VSwitch的网段
VpcId
String
是
指定VSwitch所在的 VPC
VSwitchName
String
否
VSwitch名称，不填则为空，默认值为空，[2, 128] 英文或中文字符，必须以大小字母或中文开头，可包含数字，”_”或”-”，这个值会展示在控制台。不能以 // 和 https:// 开头。
Description
String
否
VSwitch 描述，不填则为空，默认值为空，[2, 256] 英文或中文字符，不能以 // 和 https:// 开头。
ClientToken
String
否
用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大不值过 64 个 ASCII 字符。
返回参数
名称 |
类型 |
描述 |
VSwitchId
String
系统分配的 VSwitchID
错误码
错误代码 |
描述 |
Http 状态码 |
语义 |
InvalidZoneId.NotFound
Specified zone does not exist.
404
指定的可用区不存在
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 或者可用区不支持 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 数量达到配额上限
IncorretRouteEntryStatus
Some route entry status blocked this operation.
400
部分自定义路由处于 pending 状态，创建 VSwitch 失败
IncorretVSwitchStatus
Some virtual switch is modifying within the same VPC.
400
部分 VSwitch 处于 pending 状态，创建 VSwitch 失败
InvalidCirdrBlock.MaskLength
Specified CIDR block is not valid.
400
指定的 CIDR 网段格式不正确
IncorrectVpcStatus
Current VPC status does not support this operation.
400
指定的 VPC 处于 pending 状态，创建 VSwitch 失败
示例
请求示例
https://ecs.aliyuncs.com/?Action=CreateVSwitch
&CidrBlock=172.16.1.0/24
&VpcId=vpc-257gq642n
&ZoneId=cn-beijing-a
&<公共请求参数>
返回示例
所属专题:
