新建交换机
描述
在指定 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
&<公共请求参数>
返回示例