CreateVSwitch
创建一个交换机
服务地址:
华东1(杭州)
输入参数
只看必填
Tag资源的标签
0标签
Key资源的标签键
Value资源的标签值
ZoneId要创建的交换机所属的可用区ID
RegionId要创建的交换机的地域ID
CidrBlock交换机的网段
Ipv6CidrBlock交换机IPv6网段的最后8比特位
VpcId要创建的交换机所属的VPC ID
VSwitchName交换机的名称
Description交换机的描述信息
VpcIpv6CidrBlockVPC的IPv6网段
幂等性参数
ClientToken客户端Token
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
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 比特位,取值:0255

示例值: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