阅读452 返回首页    go iPhone_iPad_Mac_apple

新建交换机__交换机相关接口_API 参考_云服务器 ECS-阿里云

描述

在指定 VPC 内创建一个新的VSwitch。

  • VSwitch 下的云产品实例不能分布在不同可用区
  • 每个 VPC 的 VSwitch 数量不允许超过 24 个
  • 每个 VSwitch 的掩码为 16 - 29 位，可以提供 8 - 65535 个 IP 地址
  • 每个 VSwitch 的第 1 个和最后 3 个 IP 地址为系统保留(以 192.168.1.0 / 24 为例，192.168.1.0 和 192.168.1.255 以及 192.168.1.253 - 254 这些地址是系统保留地址)。
  • VSwitch 不支持组播和广播
  • VSwitch 的 CIDRBlock，必须从属于所在 VPC 的 CIDRBlock
  • VSwitch 的 CIDRBlock 可以与所在 VPC 的 CIDRBlock 相同，但这意味着您的 VPC 只能拥有 1 个 VSwitch
  • VSwitch 的 CIDRBlock，不能与所在 VPC 当前 RouteEntry 的 DestCIDRBlock 相同
  • VSwitch 的 CIDRBlock，不能包含所在 VPC 当前 RouteEntry 的 DestCIDRBlock，但可以是当前 RouteEntry 的 DestCIDRBlock 的子集
  • VSwitch 创建成功后，CidrBlock 无法修改
  • VSwitch 下的云产品实例数量不允许超过 VPC 剩余的可用云产品实例数量（5000 - 当前云产品实例数量）
  • 1 个云产品实例只能属于 1 个 VSwitch

请求参数

名称 类型 是否必须 描述
Action String 是 系统规定参数，取值：CreateVSwitch
ZoneId String 是 可用区 Id
CidrBlock String 是 指定VSwitch的网段,必须采用CIDR格式来指定IP地址范围,如 192.168.1.0/24
VpcId String 是 指定VSwitch所在的 VPC
VSwitchName String 否 VSwitch名称，不填则为空，默认值为空，[2, 128] 英文或中文字符，必须以大小字母或中文开头，可包含数字，”_”或”-”，这个值会展示在控制台。不能以 https:// 和 https:// 开头。
Description String 否 VSwitch 描述，不填则为空，默认值为空，[2, 256] 英文或中文字符，不能以 https:// 和 https:// 开头。
ClientToken String 否 用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大不值过 64 个 ASCII 字符。

返回参数

名称 类型 描述
VSwitchId String 系统分配的 VSwitchID

错误码

错误代码 描述 Http 状态码 语义
InvalidZoneId.NotFound Specified zone does not exist. 404 指定的可用区不存在
InvalidVpcId.NotFound Specified VPC does not exist. 404 指定的 VPC 不存在
InvalidCidrBlock.Malformed Specified CIDR block is not valid. 400 指定的 CIDR 格式不正确
InvalidVSwitchName.Malformed Specified virtual switch name is not valid. 400 指定的 VSwitch 名字格式不正确
InvalidVSwitchDiscription.Malformed Specified virtual switch description is not valid. 400 指定的 VSwitch 描述信息格式不正确
ResourceNotAvailable Resource you requested is not available in this region or zone. 400 指定的 Region 或者可用区不支持 VPC
InvalidParameter Specified CIDR block is not valid in VPC. 400 指定的 CIDR 不正确
InvalidCidrBlock.Overlapped Specified CIDR block overlapped with other subnets. 400 指定的 CIDR 与其他 VSwitch 的 CIDR 重叠
InvalidCidrBlock.Overlapped Specified CIDR block overlapped with other entry 400 指定的 CIDR 与已有的自定义路由的 CIDR 重叠
QuotaExceeded.VSwitch Virtual switch quota exceeded. 400 VSwitch 数量达到配额上限
IncorretRouteEntryStatus Some route entry status blocked this operation. 400 部分自定义路由处于 pending 状态，创建 VSwitch 失败
IncorretVSwitchStatus Some virtual switch is modifying within the same VPC. 400 部分 VSwitch 处于 pending 状态，创建 VSwitch 失败
InvalidCirdrBlock.MaskLength Specified CIDR block is not valid. 400 指定的 CIDR 网段格式不正确
IncorrectVpcStatus Current VPC status does not support this operation. 400 指定的 VPC 处于 pending 状态，创建 VSwitch 失败

示例

请求示例

  1. https://ecs.aliyuncs.com/?Action=CreateVSwitch
  2. &CidrBlock=172.16.1.0/24
  3. &VpcId=vpc-257gq642n
  4. &ZoneId=cn-beijing-a
  5. &<公共请求参数>

返回示例

XML格式

  1. <CreateVSwitchResponse>
  2.     <RequestId>861E6630-AEC0-4B2D-B214-6CB5E44B7F04</RequestId>
  3.     <VSwitchId>vsw-25naue4gz</VSwitchId>
  4. </CreateVSwitchResponse>

JSON格式

  1. {
  2.   "RequestId": "861E6630-AEC0-4B2D-B214-6CB5E44B7F04",
  3.   "VSwitchId": "vsw-25naue4gz"
  4. }

最后更新：2016-11-23 16:03:50

  上一篇：go 修改路由器属性__路由器相关接口_API 参考_云服务器 ECS-阿里云
  下一篇：go 删除交换机__交换机相关接口_API 参考_云服务器 ECS-阿里云