调用CreateVSwitch接口创建交换机。

使用说明

调用该接口创建交换机时,请注意以下事项:

  • 每个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查询交换机的创建状态:
    • 当交换机处于Creating状态时,表示交换机正在创建中。
    • 当交换机处于Created状态时,表示交换机创建完成。
  • CreateVSwitch接口不支持在同一个VPC中并发创建交换机。

调试

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

请求参数

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

系统规定参数。取值:CreateVSwitch

ZoneId String cn-hangzhou-b

要创建的交换机所属的可用区ID。

您可以通过调用DescribeZones接口获取可用区ID。

RegionId String cn-hangzhou

要创建的交换机的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

CidrBlock String 172.16.0.0/24

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

  • 交换机的网段的掩码长度范围为16~29位。
  • 交换机的网段必须从属于所在VPC的网段。
  • 交换机的网段不能与所在VPC中路由条目的目标网段相同,但可以是目标网段的子集。
Ipv6CidrBlock Integer 12

交换机IPv6网段的最后8比特位,取值:0255

VpcId String vpc-257gqcdfvx6n****

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

VSwitchName String vSwitch-1

交换机的名称。

名称长度为2~128个字符,以英文字母或中文开头,可包含数字、下划线(_)和短划线(-)。

Description String vSwitch

交换机的描述信息。

描述可以为空,或输入2~256个中英文字符,不能以http://和https://开头。

ClientToken String 0c593ea1-3bea-11e9-b96b-88e9fe63****

客户端Token,用于保证请求的幂等性。

从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
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格式

HTTP/1.1 200 OK
Content-Type:application/xml

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

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
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 RouteConflict.AlreadyExist Route conflict exists in routing table. 路由表中存在路由冲突。
400 IncorrectStatus.cbnStatus Current CBN status does not support this operation. CBN当前状态不正确
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网关。
400 OperationDenied.VpcPeerExists The operation is not allowed because the VpcPeer exists. 指定操作被禁止,因为VPC内存在VPC对等连接。
404 InvalidZoneId.NotFound Specified zone does not exist. 可用区ID不正确。
404 InvalidVpcId.NotFound Specified VPC does not exist. 该VPC不存在。

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