调用CreateVSwitch接口创建交换机。

API描述

调用该接口创建交换机时，请注意：

  • 每个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减去当前云产品实例数量）。
  • 一个云产品实例只能属于一个交换机。
  • 交换机不支持组播和广播。
  • 交换机创建成功后，无法修改网段。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateVSwitch

要执行的操作，取值：CreateVSwitch。

CidrBlock String 是 172.16.0.0/24

交换机的网段。交换机网段要求如下：

  • 交换机的网段的掩码长度范围为16～29位。
  • 交换机的网段必须从属于所在VPC的网段。
  • 交换机的网段不能与所在VPC中路由条目的目标网段相同，但可以是目标网段的子集。
VpcId String 是 vpc-257gqcdfvx6n****

要创建的交换机所属的VPC ID。

ZoneId String 是 cn-hangzhou-b

要创建的交换机所属的可用区ID。您可以通过调用DescribeZones接口获取可用区ID。

RegionId String 是 cn-hangzhou

要创建的交换机的地域ID。您可以通过调用DescribeRegions接口获取地域ID。

Ipv6CidrBlock Integer 否 12

交换机IPv6网段的最后8比特位，取值：0～255。

Description String 否 This is my vswitch.

交换机的描述信息。

描述长度为2～256个字符，必须以字母或中文开头，但不能以http://或https://开头。

VSwitchName String 否 VSwitch-1

交换机的名称。

名称长度为2～128个字符，必须以字母或中文开头，但不能以http://或https://开头。

ClientToken String 否 0c593ea1-3bea-11e9-b96b-88e9fe637760

保证请求幂等性。从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符，且不能超过64个字符。更多详情，请参见如何保证幂等性。

VpcIpv6CidrBlock String 否 2408:XXXX:0:6a::/56

VPC的IPv6网段。

返回数据

名称 类型 示例值 描述
VSwitchId String vsw-25navfgbue4g****

创建的交换机的ID。
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

请求ID。

示例

请求示例

http(s)://vpc.aliyuncs.com/?Action=CreateVSwitch
&CidrBlock=172.16.0.0/24
&VpcId=vpc-257gqcdfvx6n****
&ZoneId=cn-hangzhou-b
&<公共请求参数>

正常返回示例

XML格式 

<CreateVSwitchResponse>
      <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
      <VSwitchId>vsw-25naue4cdvf****</VSwitchId>
</CreateVSwitchResponse>

JSON格式 

{
    "RequestId": "0ED8D006-F706-4D23-88ED-E11ED28DCAC0",
    "VSwitchId": "vsw-25naue4cdvf****"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidZoneId.NotFound Specified zone does not exist. 可用区ID不正确。
404 InvalidVpcId.NotFound Specified VPC does not exist. 该VPC不存在。
400 InvalidVSwitchName.Malformed Specified virtual switch name is not valid. 该 VSwitch 名字格式不正确，请您确认VSwitch 名字格式。
400 InvalidVSwitchDiscription.Malformed Specified virtual switch description is not valid. 交换机描述不合法。
400 ResourceNotAvailable Resource you requested is not available in this region or zone. 当前地域或可用区不支持创建交换机。
400 InvalidParameter Specified CIDR block is not valid in VPC. 该网段不在VPC网段内。
400 InvalidCidrBlock.Overlapped Specified CIDR block overlapped with other subnets. 该交换机网段与其他交换机的网段重叠或与已有的自定义路由的目标网段重叠，请使用其他未被占用的网段。
400 InvalidCidrBlock.Overlapped Specified CIDR block overlapped with other entry. 该交换机网段与其他交换机的网段重叠或与已有的自定义路由的目标网段重叠，请使用其他未被占用的网段。
400 QuotaExceeded.VSwitch Virtual switch quota exceeded. VSwitch 数量达到配额上限，请您减少 VSwitch 数量后再试。
400 IncorrectRouteEntryStatus Some route entry status blocked this operation. 无法执行该操作，当前路由表中有路由条目的状态为pending或modifying。
400 IncorrectVSwitchStatus Some virtual switch is modifying within the same VPC. 同一个 VPC 下存在多个“修改中”的虚拟交换机，请您稍后重试。
400 InvalidCirdrBlock.MaskLength Specified CIDR block is not valid . 该 CIDR 网段格式不正确。
400 IncorrectVpcStatus Current VPC status does not support this operation. 当前VPC的状态无法支持这个操作。
400 InvalidCidrBlock.Malformed Specified CIDR block is not valid. 该CIDR格式不正确。
400 MissingParameter Miss mandatory parameter. 缺少必要参数，请您检查必填参数是否都已填后再进行操作。
400 IncorrectVSwitchStatus VSwitch Creation simultaneously is not supported. 创建交换机失败，VPC中有交换机的状态为Creating。
400 Forbidden.VpcNotFound Specified VPC can not found. 指定的 VPC 不存在，请您检查 VPC 是否正确。
400 UnsupportedFeature.CloudBoxIpv6 The IPv6 feature is not supported by cloud box. 云盒不支持创建Ipv6。
400 OperationDenied.VpcPeerExist The operation is not allowed because the VPC peer exists. 指定操作被禁止，因为vpc存在对等连接。
400 OperationDenied.CenAttached The operation is not allowed because the VPC is attached to CEN. 指定操作被禁止，因为vpc关联了cen
400 OperationDenied.NatgwExist The operation is not allowed because the NAT gateway exists in VPC. 指定操作被禁止，因为vpc中创建有nat网关。

访问错误中心查看更多错误码。