找不到 API ? 点击 反馈吧
- 专有网络(VPC)
- 路由器
- 交换机
- 查询交换机预留网段ListVSwitchCidrReservations
- 创建交换机预留网段CreateVSwitchCidrReservation
- 查询交换机预留网段的用量情况GetVSwitchCidrReservationUsage
- 修改交换机预留网段的名称和描述信息ModifyVSwitchCidrReservationAttribute
- 创建交换机CreateVSwitch
- 创建默认交换机CreateDefaultVSwitch
- 查询交换机下的私网IP可用性CheckCanAllocateVpcPrivateIpAddress
- 删除交换机DeleteVSwitch
- 修改指定交换机的名称和描述信息ModifyVSwitchAttribute
- 查询可组网信息DescribeVSwitches
- 查询指定交换机的配置信息DescribeVSwitchAttributes
- 删除交换机预留网段DeleteVSwitchCidrReservation
- 路由表
- 前缀列表
- DHCP选项集
- 流日志
- 网络ACL
- 高可用虚拟IP
- 流量镜像
- 弹性公网IP
- 共享带宽
- 物理专线
- 故障演练
- QoS策略
- 边界路由器
- BGP
- NAT
- IPv4网关
- VPN网关
- 用户网关
- 绑定VPN网关实例
- 绑定转发路由器实例
- SSL客户端
- SSL服务端
- IPsec服务端
- IPv6网关
- IPv6转换服务
- 地域
- 标签
- 路由器接口
- 高速上云服务
- 全球加速实例
- 网关终端节点
- 资源组
CreateVSwitch
创建一个交换机
服务地址:
华东1(杭州)
参数配置
高级配置
输入参数
只看必填
注意事项
Tag资源的标签
ZoneId要创建的交换机所属的可用区ID
RegionId要创建的交换机的地域ID
CidrBlock交换机的网段
Ipv6CidrBlock交换机IPv6网段的最后8比特位
VpcId要创建的交换机所属的VPC ID
VSwitchName交换机的名称
Description交换机的描述信息
VpcIpv6CidrBlockVPC的IPv6网段
幂等性参数
ClientToken客户端Token
文档
调用结果
SDK 示例
CLI示例
相关示例 (3)
调用历史
错误码
流控
插件下载了解更多
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
Alibaba Cloud Developer ToolkitbetaAlibaba Cloud OpenAPI
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.
接口说明
调用该接口创建交换机时,请注意以下事项:
-
每个 VPC 内的交换机数量不能超过 150 个。
-
每个交换机网段的第 1 个和最后 3 个 IP 地址为系统保留地址。例如 192.168.1.0/24 的系统保留地址为 192.168.1.0、192.168.1.253、192.168.1.254 和 192.168.1.255。
-
交换机下的云产品实例数量不允许超过 VPC 剩余的可用云产品实例数量(15000 减去当前云产品实例数量)。
-
一个云产品实例只能属于一个交换机。
-
交换机不支持组播和广播。
-
交换机创建成功后,无法修改网段。
-
CreateVSwitch 接口属于异步接口,即系统会返回一个实例 ID,但该交换机尚未创建完成,系统后台任务仍在进行中。您可以调用 DescribeVSwitchAttributes 查询交换机的创建状态:
- 当交换机处于 Pending 状态时,表示交换机正在配置中。
- 当交换机处于 Available 状态时,表示交换机可用。
-
CreateVSwitch 接口不支持在同一个 VPC 中并发创建交换机。
-
CreateVSwitch 接口不支持创建 100.64.0.0/10 及其子网网段的交换机。
请求参数
字段名称 | 字段详情 |
---|---|
Tagarray<object> | 资源的标签。 子级条数 <= 21 |
ZoneIdstring | 要创建的交换机所属的可用区 ID。展开详情 示例值:cn-hangzhou-b参考取值来源: DescribeZones |
RegionIdstring | 要创建的交换机的地域 ID。展开详情 示例值:cn-hangzhou参考取值来源: DescribeRegions |
CidrBlockstring | 交换机的网段。交换机网段要求如下: 展开详情 示例值:172.16.0.0/24参考取值来源: AssociateVpcCidrBlock AllocateVpcIpv6Cidr AddPublicIpAddressPoolCidrBlock ListPublicIpAddressPoolCidrBlocks |
Ipv6CidrBlockinteger<int32> | 交换机 IPv6 网段的最后 8 比特位,取值:0~255。 示例值:12 |
VpcIdstring | 要创建的交换机所属的 VPC ID。 示例值:vpc-257gqcdfvx6n****参考取值来源: CreateVpc |
VSwitchNamestring | 交换机的名称。 展开详情 示例值:vSwitch-1参考取值来源: DescribeVSwitches |
Descriptionstring | 交换机的描述信息。 展开详情 示例值:vSwitch |
ClientTokenstring | 客户端 Token,用于保证请求的幂等性。展开详情 示例值:0c593ea1-3bea-11e9-b96b-88e9fe63**** |
VpcIpv6CidrBlockstring | VPC 的 IPv6 网段。 示例值:2408:XXXX:0:6a::/56参考取值来源: DescribeVpcs |
返回参数
字段名称 | 字段详情 |
---|---|
VSwitchIdstring | 创建的交换机的 ID。 示例值:vsw-25navfgbue4g**** |
RequestIdstring | 请求 ID。 示例值:0ED8D006-F706-4D23-88ED-E11ED28DCAC0 |
变更历史
变更时间 | 变更内容概要 | 操作 | |
---|---|---|---|
2024-01-17 | 变更错误码400 | ||
2023-07-05 | 新增请求参数Tag | ||
2021-11-17 | 变更错误码400 |