CreateDefaultVSwitch - 创建默认交换机

调用CreateDefaultVSwitch接口创建一个默认的交换机。

接口说明

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

  • 每个默认交换机网段的第 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 减去当前云产品实例数量)。

  • 默认交换机不支持组播和广播。

  • 默认交换机创建成功后,无法修改网段。

  • CreateDefaultVSwitch 接口属于异步接口,即系统会返回一个实例 ID,但该默认交换机尚未创建完成,系统后台任务仍在进行中。您可以调用 DescribeVSwitchAttributes 查询默认交换机的创建状态:

    • 当默认交换机处于 Pending 状态时,表示默认交换机正在配置中。
    • 当默认交换机处于 Available 状态时,表示默认交换机可用。
  • 当指定地域的可用区已有默认交换机时,调用该接口创建默认交换机会失败。

  • 创建默认交换机时,需要先创建一个默认 VPC。您可以通过调用 CreateDefaultVpc 接口创建默认 VPC。

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
ZoneIdstring

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

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

cn-hangzhou-b
RegionIdstring

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

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

cn-hangzhou
Ipv6CidrBlockinteger

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

12
ClientTokenstring

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

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

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

返回参数

名称类型描述示例值
object

创建的默认交换机的 ID。

VSwitchIdstring

创建的默认交换机的 ID。

vsw-bp1a4b5qhmxftjimq****
RequestIdstring

请求 ID。

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

示例

正常返回示例

JSON格式

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

错误码

HTTP status code错误码错误信息描述
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.-
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.DefaultVpcNotExist%s-
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网关。
400OperationDenied.OtherSubnetCreatingother subnet is creating-
400OperationFailed.DefaultVSwitchExistA default vSwitch already exists in the zone.当前可用区已经存在默认交换机。
404Invalid.NotExistwitch mask rule not exists.-
404InvalidStatus.RouteEntryRouteEntry status error.-
404InvalidZoneId.NotFoundSpecified zone does not exist.可用区ID不正确。
404InvalidVpcId.NotFoundSpecified VPC does not exist.该VPC不存在。

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