文档

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 查询交换机的创建状态:

    • 当交换机处于 Pending 状态时,表示交换机正在配置中。
    • 当交换机处于 Available 状态时,表示交换机可用。
  • CreateVSwitch 接口不支持在同一个 VPC 中并发创建交换机。

  • CreateVSwitch 接口不支持创建 100.64.0.0/10 及其子网网段的交换机。

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
vpc:CreateVSwitchWrite
  • VPC
    acs:vpc:{#regionId}:{#accountId}:vpc/{#VpcId}
  • VSwitch
    acs:vpc:{#regionId}:{#accountId}:vswitch/*
  • vpc:tag

请求参数

名称类型必填描述示例值
Tagobject []

资源的标签。

Keystring

资源的标签键。最多支持输入 20 个标签键。如需传入该值,则不能输入空字符串。

一个标签键最多支持 128 个字符,不能以aliyunacs:开头,不能包含http://或者https://

FinanceJoshua
Valuestring

资源的标签值。最多支持输入 20 个标签值。如需传入该值,可以输入空字符串。

最多支持 128 个字符,不能以aliyunacs:开头,不能包含http://或者https://

FinanceDept
ZoneIdstring

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

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

cn-hangzhou-b
RegionIdstring

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

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

cn-hangzhou
CidrBlockstring

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

  • 交换机的网段的掩码长度范围为 16~29 位。

  • 交换机的网段必须从属于所在 VPC 的网段。

  • 交换机的网段不能与所在 VPC 中路由条目的目标网段相同,但可以是目标网段的子集。

  • 交换机的网段不能是 100.64.0.0/10 及其子网网段。

172.16.0.0/24
Ipv6CidrBlockinteger

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

12
VpcIdstring

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

vpc-257gqcdfvx6n****
VSwitchNamestring

交换机的名称。

名称长度为 1~128 个字符,不能以http://https://开头。

vSwitch-1
Descriptionstring

交换机的描述信息。

描述长度为 1~256 个字符,不能以http://https://开头。

vSwitch
ClientTokenstring

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

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

说明 若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。
0c593ea1-3bea-11e9-b96b-88e9fe63****
VpcIpv6CidrBlockstring

VPC 的 IPv6 网段。

2408:XXXX:0:6a::/56

返回参数

名称类型描述示例值
object

返回信息。

VSwitchIdstring

创建的交换机的 ID。

vsw-25navfgbue4g****
RequestIdstring

请求 ID。

0ED8D006-F706-4D23-88ED-E11ED28DCAC0

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
400OperationFailed.ResourceConflictvpc only support one cloud box.-
400OperationFailed.IdempotentTokenProcessingAction is processing.-
400InvalidDescription.MalformedInvalid description.-
400InvalidVSwitchName.MalformedSpecified virtual switch name is not valid.该vSwitch名字格式不正确,请您确认vSwitch名字格式。
400InvalidVSwitchDiscription.MalformedSpecified virtual switch description is not valid.交换机描述不合法。
400Abs.Vpc.InvalidDescription.MalformedSpecified virtual switch name is not valid.-
400MissingParam.vpcIdThe parameter vpcId is mandatory.参数缺失,vpcId是必选参数
400ResourceNotAvailableResource you requested is not available in this region or zone.当前地域或可用区不支持创建交换机。
400InvalidParameterSpecified CIDR block is not valid in VPC.该网段不在VPC网段内。
400InvalidCidrBlock.OverlappedSpecified CIDR block overlapped with other subnets.该交换机网段与其他交换机的网段重叠或与已有的自定义路由的目标网段重叠,请使用其他未被占用的网段。
400InvalidCidrBlock.OverlappedSpecified CIDR block overlapped with other entry.该交换机网段与其他交换机的网段重叠或与已有的自定义路由的目标网段重叠,请使用其他未被占用的网段。
400QuotaExceeded.VSwitchVirtual switch quota exceeded.vSwitch数量达到配额上限,请您减少vSwitch数量后再试。
400IncorrectRouteEntryStatusSome route entry status blocked this operation.无法执行该操作,当前路由表中有路由条目的状态为pending或modifying。
400IncorrectVSwitchStatusSome virtual switch is modifying within the same VPC.同一个VPC下存在多个“修改中”的虚拟交换机,请您稍后重试。
400InvalidCirdrBlock.MaskLengthSpecified CIDR block is not valid .该CIDR网段格式不正确。
400IncorrectVpcStatusCurrent VPC status does not support this operation.当前VPC的状态无法支持这个操作。
400CreateVSwitch.IncorrectStatus.cbnStatusCurrent CBN status does not support this operation.当前CBN的状态不支持创建虚拟交换机(VSwitch)操作
400InvalidCidrBlock.MalformedSpecified CIDR block is not valid.该CIDR格式不正确。
400MissingParameterMiss mandatory parameter.缺少必要参数,请您检查必填参数是否都已填后再进行操作。
400IncorrectVSwitchStatusVSwitch Creation simultaneously is not supported.创建交换机失败,VPC中有交换机的状态为Creating。
400TaskConflictThe operation is too frequent, TaskConflict.操作太频繁,请稍后重试
400VPC.SWITCH.RULE.QUOTA.NOT.EXISTSvSwitch quota rule not exists.-
400Forbidden.VpcNotFoundSpecified VPC can not found.指定的VPC不存在,请您检查VPC是否正确。
400RouteConflict.AlreadyExistRoute conflict exists in routing table.路由表中存在路由冲突。
400OperationFailed.CidrAcrossClassic link instance cidr must not across.-
400Duplicated.ClientToken%s-
400OperationFailed.Ipv6CidrBlockExisted%s-
400IllegalParam.Ipv6CidrBlock%s-
400OperationFailed.VpcIpv6Disabled%s-
400IncorrectStatus.cbnStatusCurrent CBN status does not support this operation.CBN当前状态不正确
400OperationFailed.NotifyCenCreateFailed to notify cen when create vswitch.-
400OperationFailed.DistibuteLockDistibute lock fail.-
400UnsupportedFeature.CloudBoxIpv6The IPv6 feature is not supported by cloud box.云盒不支持创建IPv6。
400OperationDenied.VpcPeerExistThe operation is not allowed because the VPC peer exists.指定操作被禁止,因为VPC存在对等连接。
400OperationDenied.CenAttachedThe operation is not allowed because the VPC is attached to CEN.指定操作被禁止,因为VPC关联了CEN。
400OperationDenied.NatgwExistThe operation is not allowed because the NAT gateway exists in VPC.指定操作被禁止,因为VPC中创建有NAT网关。
400MissingParam.Ipv6CidrBlockThe parameter Ipv6CidrBlock is mandatory.参数缺失,Ipv6CidrBlock是必选参数
400IllegalParam.VpcIpv6CidrBlock%s-
400OperationDenied.OtherSubnetCreatingThe operation is not allowed because the other VSwitch is creating.-
400OperationDenied.VpcPeerExistsThe operation is not allowed because the VpcPeer exists.指定操作被禁止,因为VPC内存在VPC对等连接。
400IllegalParam.CidrBlockThe param of CidrBlock [%s] is illegal.CidrBlock非法
404Invalid.NotExistwitch mask rule not exists.-
404InvalidStatus.RouteEntryRouteEntry status error.-
404InvalidZoneId.NotFoundSpecified zone does not exist.可用区ID不正确。
404InvalidVpcId.NotFoundSpecified VPC does not exist.该VPC不存在。

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

变更历史

变更时间变更内容概要操作
2024-01-17OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    错误码 400 变更
    删除错误码:404
2023-09-06OpenAPI 错误码发生变更看变更集
变更项变更内容
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:404
2023-07-05OpenAPI 描述信息更新、OpenAPI 错误码发生变更、OpenAPI 入参发生变更看变更集
变更项变更内容
API 描述OpenAPI 描述信息更新
错误码OpenAPI 错误码发生变更
    删除错误码:400
    删除错误码:404
入参OpenAPI 入参发生变更
    新增入参:Tag
  • 本页导读 (1)
文档反馈