CreateDefaultVSwitch_专有网络_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

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

  • 每个默认交换机网段的第 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。

流控信息

当前云产品API请求速率暂未透出。

授权信息

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

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
vpc:CreateDefaultVSwitch
Write
VSwitch
acs:vpc:{#regionid}:{#accountId}:vswitch/*

请求参数

字段名称字段详情
ZoneIdstring

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

示例值:cn-hangzhou-b参考取值来源:
    DescribeZones
RegionIdstring

要创建的默认交换机的地域 ID。展开详情

示例值:cn-hangzhou参考取值来源:
    DescribeRegions
Ipv6CidrBlockinteger<int32>

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

示例值:12
ClientTokenstring

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

示例值:0c593ea1-3bea-11e9-b96b-88e9fe63****

返回参数

字段名称字段详情
VSwitchIdstring

创建的默认交换机的 ID。

示例值:vsw-bp1a4b5qhmxftjimq****
RequestIdstring

请求 ID。

示例值:0ED8D006-F706-4D23-88ED-E11ED28DCAC0

返回示例

错误码

全局错误码
HTTP 状态码错误码错误信息操作
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
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.DefaultVpcNotExist
%s诊断
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
OperationDenied.OtherSubnetCreating
other subnet is creating诊断
400
OperationFailed.DefaultVSwitchExist
A default vSwitch already exists in the zone.诊断
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.诊断

变更历史

暂无变更历史

相关示例