CreateVSwitch_专有网络_API文档-阿里云OpenAPI开发者门户

接口说明

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

每个 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 及其子网网段的交换机。

流控信息

请求速率为300/60(s)。更多流控信息，请前往配额中心查看

授权信息

如下是此API对应的授权信息，用于RAM权限策略语句的Action元素中，为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置，使用方法可参考访问控制帮助文档。

具体说明如下：展开详情

操作	访问级别	资源类型	条件关键字	关联操作

vpc:CreateVSwitch	Create	VPC acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId} VSwitch acs:vpc:{#regionId}:{#accountId}:vswitch/*	vpc:tag	无

请求参数

字段名称	字段详情
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

返回示例

错误码

没有我想要的错误码, 点击反馈

全局错误码

HTTP 状态码	错误码	错误信息	操作

400	OperationFailed.ResourceConflict	vpc only support one cloud box.	诊断
400	OperationFailed.IdempotentTokenProcessing	Action is processing.	诊断
400	InvalidDescription.Malformed	Invalid description.	诊断
400	InvalidVSwitchName.Malformed	Specified virtual switch name is not valid.	诊断
400	InvalidVSwitchDiscription.Malformed	Specified virtual switch description is not valid.	诊断
400	Abs.Vpc.InvalidDescription.Malformed	Specified virtual switch name is not valid.	诊断
400	MissingParam.vpcId	The parameter vpcId is mandatory.	诊断
400	ResourceNotAvailable	Resource you requested is not available in this region or zone.	诊断
400	InvalidParameter	Specified CIDR block is not valid in VPC.	诊断
400	InvalidCidrBlock.Overlapped	Specified CIDR block overlapped with other subnets.	诊断
400	QuotaExceeded.VSwitch	Virtual switch quota exceeded.	诊断
400	IncorrectRouteEntryStatus	Some route entry status blocked this operation.	诊断
400	IncorrectVSwitchStatus	Some virtual switch is modifying within the same VPC.	诊断
400	InvalidCirdrBlock.MaskLength	Specified CIDR block is not valid .	诊断
400	IncorrectVpcStatus	Current VPC status does not support this operation.	诊断
400	CreateVSwitch.IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	诊断
400	InvalidCidrBlock.Malformed	Specified CIDR block is not valid.	诊断
400	MissingParameter	Miss mandatory parameter.	诊断
400	TaskConflict	The operation is too frequent, TaskConflict.	诊断
400	VPC.SWITCH.RULE.QUOTA.NOT.EXISTS	vSwitch quota rule not exists.	诊断
400	Forbidden.VpcNotFound	Specified VPC can not found.	诊断
400	RouteConflict.AlreadyExist	Route conflict exists in routing table.	诊断
400	OperationFailed.CidrAcross	Classic link instance cidr must not across.	诊断
400	Duplicated.ClientToken	%s	诊断
400	OperationFailed.Ipv6CidrBlockExisted	%s	诊断
400	IllegalParam.Ipv6CidrBlock	%s	诊断
400	OperationFailed.VpcIpv6Disabled	%s	诊断
400	IncorrectStatus.cbnStatus	Current CBN status does not support this operation.	诊断
400	OperationFailed.NotifyCenCreate	Failed to notify cen when create vswitch.	诊断
400	OperationFailed.DistibuteLock	Distibute lock fail.	诊断
400	UnsupportedFeature.CloudBoxIpv6	The IPv6 feature is not supported by cloud box.	诊断
400	OperationDenied.VpcPeerExist	The operation is not allowed because the VPC peer exists.	诊断
400	OperationDenied.CenAttached	The operation is not allowed because the VPC is attached to CEN.	诊断
400	OperationDenied.NatgwExist	The operation is not allowed because the NAT gateway exists in VPC.	诊断
400	MissingParam.Ipv6CidrBlock	The parameter Ipv6CidrBlock is mandatory.	诊断
400	IllegalParam.VpcIpv6CidrBlock	%s	诊断
400	OperationDenied.OtherSubnetCreating	The operation is not allowed because the other VSwitch is creating.	诊断
400	OperationDenied.VpcPeerExists	The operation is not allowed because the VpcPeer exists.	诊断
400	IllegalParam.CidrBlock	The param of CidrBlock [%s] is illegal.	诊断
404	Invalid.NotExist	witch mask rule not exists.	诊断
404	InvalidStatus.RouteEntry	RouteEntry status error.	诊断
404	InvalidZoneId.NotFound	Specified zone does not exist.	诊断
404	InvalidVpcId.NotFound	Specified VPC does not exist.	诊断

变更历史

	变更时间	变更内容概要	操作
	2024-01-17	变更错误码400
	2023-07-05	新增请求参数Tag
	2021-11-17	变更错误码400

CreateVSwitch_专有网络_API文档

接口说明

流控信息

授权信息

请求参数

返回参数

返回示例

错误码

变更历史

相关示例