首页/云/云网络与负载均衡速查/用 CLI 创建 VPC 与交换机(阿里云)

用 CLI 创建 VPC 与交换机(阿里云)

阿里云 CLI 可直接创建 VPC、交换机等资源,便于把网络初始化写进脚本。下面是在杭州地域创建 VPC 与交换机的命令示例,执行前需先用 aliyun configure 配置好访问凭证。

这条命令行干什么

阿里云 CLI(aliyun)可以把 VPC、交换机等网络资源的创建写进脚本,适合批量初始化、环境复制与基础设施即代码落地。创建顺序是「先 VPC、再交换机」:交换机必须落在某个已有 VPC 的网段内,且绑定到具体的可用区。执行前需先用 aliyun configure 配好 AccessKey 与默认地域。

创建 VPC 与交换机

创建 VPC 与交换机
# 1) 创建 VPC(10.10.0.0/16)
aliyun vpc CreateVpc --RegionId cn-hangzhou \
  --CidrBlock 10.10.0.0/16 --VpcName prod-vpc
# 2) 在返回的 VpcId 上创建交换机
aliyun vpc CreateVSwitch --RegionId cn-hangzhou \
  --CidrBlock 10.10.1.0/24 --VpcId vpc-bp1xxxxxxxx \
  --ZoneId cn-hangzhou-i --VSwitchName sbn-app-a
# 3) 查询创建结果
aliyun vpc DescribeVSwitches --RegionId cn-hangzhou --VpcId vpc-bp1xxxxxxxx

基本信息

适用平台阿里云 CLI(vpc 产品线)
前置条件安装 aliyun CLI 并执行 aliyun configure 配置凭证
权限建议生产操作使用 RAM 子账号授权,避免主账号 AccessKey
对应控制台专有网络 VPC → 创建 VPC 与交换机
输出格式加 --output cols=... 可只取需要的字段,便于脚本消费

典型使用场景

  • 批量初始化:为新项目一次性建好 VPC 与多个可用区的交换机,避免逐个点控制台
  • 环境复制:把测试环境的网络拓扑按同一套命令复制到新地域,快速拉出对等环境
  • CI/CD 集成:在流水线里创建临时网络跑完测试再回收,资源不长期占用
  • 审计留痕:用脚本创建比手工操作更容易复现、评审与版本化
  • 灾备演练:按预案脚本快速重建网络层,验证从零恢复的耗时与步骤

脚本化的注意点

把创建动作写进脚本后,最容易出问题的不是命令本身,而是上下文:RegionId 与 ZoneId 是否同属一个地域、交换机网段是否落在 VPC 网段内且与既有子网不重叠、凭证是否用的是最小权限的 RAM 子账号。建议把地域、网段、可用区都抽成变量并打印出来,再执行创建,出问题时能一眼看出是参数错误还是权限不足。

关键参数读法

参数含义注意点
RegionId资源所在地域与 ZoneId 必须属于同一地域
CidrBlockVPC 或交换机的地址段交换机网段须落在 VPC 网段内且不重叠
ZoneId交换机所在可用区写错会报错或建到意外位置
VpcIdVPC 的唯一标识由上一步创建结果返回
创建 VPC 不重启任何服务,但网段与可用区选定后不可更改,执行前先确认规划。
脚本里先打印实际使用的 ZoneId 与 CidrBlock 再执行创建,可避免复制模板时残留旧值。创建完成后用 DescribeVpcs 与 DescribeVSwitches 复核,比只看命令返回码更可靠。

易错点

  • ZoneId 与 RegionId 不匹配,命令报参数错误或创建到非预期可用区
  • 在脚本里硬编码 AccessKey,凭证泄漏会波及整个账号
  • 交换机网段与已有子网重叠,创建失败或造成路由歧义
  • 创建后立即把实例放进去却没配安全组,实例能 ping 通却访问不了服务

数据来源与参考

  • 阿里云 CLI 参考(vpc CreateVpc / CreateVSwitch)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌