阿里云如何使用新建交换机接口

　　新建交换机

　　描述

　　在指定 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] 英文或中文字符，必须以大小字母或中文开头，可包含数字，”_”或”-”，这个值会展示在控制台。不能以 http:// 和 https:// 开头。 Description String 否 VSwitch 描述，不填则为空，默认值为空，[2, 256] 英文或中文字符，不能以 http:// 和 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

　　&<公共请求参数>

　　返回示例