750
新建虚拟边界路由器__高速通道相关接口_API 参考_云服务器 ECS-阿里云
描述
新建虚拟边界路由器（VBR）
- 只能由物理专线所有者给自己或他人创建VBR
- 每个物理专线默认能够创建2个VBR
- 为自己创建的VBR直接进入Enabled状态
- 支持为其他用户创建VBR，创建后进入Unconfirmed状态
- VlanId只允许物理专线owner指定/修改
- 同一物理专线下的同一VlanId不允许两个VBR同时再用。
- 进入Terminated状态的VBR会在7天内自动保留其VlanId，不允许其他VBR使用。7天后可以被其他VBR使用。
- 为其他用户创建的VBR，不能配置LocalGatewayIp、PeerGatewayIp和PeeringSubnetMask
- LocalGatewayIp、PeerGatewayIp、PeeringSubnetMask要做校验：PeeringSubnetMask支持[24-30]位，PeeringSubnetMask支持点分十进制表示法[255.255.255.0-255.255.255.252]，LocalGatewayIp和PeerGatewayIp必须在与PeeringSubnetMask定义的同一子网内。
例如：
- LocalGatewayIp: 192.168.50.17
- PeerGatewayIp: 192.168.50.18
- PeeringSubnetMask: 255.255.255.248
请求参数
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| Action | String | 是 | 系统规定参数，取值：CreateVirtualBorderRouter |
| RegionId | String | 是 | 所在地域 |
| PhysicalConnectionId | String | 是 | 物理专线Id |
| VbrOwnerId | String | 否 | VBR owner的User ID，缺省为当前客户（物理专线owner） |
| VlanId | Integer | 是 | 虚拟边界路由器（VBR）专线侧接口的802.1Q VLAN号设定范围 [1-2999]，该属性只允许物理专线owner指定/修改。 |
| CircuitCode | String | 否 | VBR专线侧接口对应运营商的电路编码。该属性只允许物理专线owner指定/修改。 |
| LocalGatewayIp | String | 否 | 虚拟边界路由器（VBR）专线侧接口的IP地址。该属性只允许VBR owner指定/修改。为专线所有者创建VBR时必填，为其他账号创建VBR时不可填。 |
| PeerGatewayIp | String | 否 | VBR专线侧接口对端的IP地址。该属性只允许VBR owner指定/修改。为专线所有者创建VBR时必填，为其他账号创建VBR时不可填。 |
| PeeringSubnetMask | String | 否 | VBR专线侧接口本端与对端互联的子网掩码。该属性只允许VBR owner指定/修改。为专线所有者创建VBR时必填，为其他账号创建VBR时不可填。 |
| Name | String | 否 | 虚拟边界路由器（VBR）的名称,[2,128]个字符。不能以https://和https://开头。该属性只允许VBR owner指定/修改。 |
| Description | String | 否 | 虚拟边界路由器（VBR）的描述信息,[2,256]个字符，不能以https://和https://开头。该属性只允许VBR owner指定/修改。 |
| ClientToken | String | 是 | 用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大不值过64个ASCII字符。 |
返回参数
| 名称 | 类型 | 描述 |
|---|---|---|
| VbrId | String | 虚拟边界路由器（VBR）ID |
错误码
| 错误代码 | 描述 | Http 状态码 | 语义 |
|---|---|---|---|
| InvalidRegionId.NotFound | The specified RegionId is not found. | 404 | 指定的RegionId不存在 |
| InvalidPhysicalConnectionId.NotFound | The specified PhysicalConnectionId is not found. | 400 | 指定的物理专线Id不存在 |
| InvalidVlanId.Used | The specified VlanId has been used. | 400 | 指定的VlanId已被使用 |
| MissingParameter | The input parameter 'PhysicalConnectionId' that is mandatory for processing this request is not supplied. | 400 | 缺少PhysicalConnectionId值 |
| InvalidPhysicalConnectionId.NotEnabled | The specified PhysicalConnectionId is not in Enabled state. | 400 | 指定的物理专线当前未处于正常状态 |
| InvalidVbrOwnerId.NotFound | The specified VbrOwnerId is not valid. | 404 | 指定的VBROwnerId不存在 |
| MissingParameter | The input parameter 'VlanId' that is mandatory for processing this request is not supplied. | 400 | 缺少VlanId值 |
| InvalidVlanId.Malformed | The specified VlanId is not valid. | 400 | 指定的VlanId格式不合法 |
| InvalidCircuitCode.Malformed | The specified CircuitCode is not valid. | 400 | 指定的CircuitCode格式不合法 |
| MissingParameter | The input parameter 'LocalGatewayIp' that is mandatory for processing this request is not supplied. | 400 | 缺少LocalGatewayIp值 |
| InvalidLocalGatewayIp.Malformed | The specified LocalGatewayIp is not valid. | 400 | 指定的LocalGatewayIp格式不合法 |
| MissingParameter | The input parameter 'PeerGatewayIp' that is mandatory for processing this request is not supplied. | 400 | 缺少PeerGatewayIp值 |
| InvalidPeerGatewayIp.Malformed | The specified PeerGatewayIp is not valid. | 400 | 指定的PeerGatewayIp格式不合法 |
| MissingParameter | The input parameter 'PeeringSubnetMask' that is mandatory for processing this request is not supplied. | 400 | 缺少PeerGatewayIp值 |
| InvalidPeeringSubnetMask.Malformed | The specified PeeringSubnetMask is not valid. | 400 | 指定的PeerGatewayIp格式不合法 |
| Forbidden.LocalGatewayIpNotAllowedByCaller | The caller is not allowed to specify the LocalGatewayIp parameter. | 403 | 调用方不允许指定LocalGatewayIp参数 |
| Forbidden.PeerGatewayIpNotAllowedByCaller | The caller is not allowed to specify the PeerGatewayIp parameter. | 403 | 调用方不允许指定PeerGatewayIp参数 |
| Forbidden.PeeringSubnetMaskNotAllowedByCaller | The caller is not allowed to specify the PeeringSubnetMask parameter. | 403 | 调用方不允许指定PeeringSubnetMask参数 |
| Forbidden.NameNotAllowedByCaller | The caller is not allowed to specify the Name parameter. | 403 | 调用方不允许指定Name参数 |
| Forbidden.DescriptionNotAllowedByCaller | The caller is not allowed to specify the Description parameter. | 403 | 调用方不允许指定Description参数 |
| InvalidName.Malformed | The specified ‘Name’ is not valid. | 403 | 指定的Name格式不合法 |
| InvalidDescription.Malformed | The specified ‘Description’ is not valid. | 400 | 指定的Description格式不合法 |
| QuotaExceeded.vbrPerpConn | Virtual boarder router per PhysicalConnection quota exceed. | 400 | 指定物理专线上创建的边界路由器数量超过配额 |
| QuotaExceeded.freevbr | Free virtual boarder router quota exceed. | 400 | 边界路由器数量超过配额 |
| InvalidIP.Malformed | Ip malformed. | 400 | IP格式不合法 |
| MissingParameter | LocalGatewayIp, peerGatewayIp and peeringSubnetMask must not be null. | 400 | 缺少LocalGatewayIp，peerGatewayIp或peeringSubnetMask的值 |
| InvalidIp.NotSameSubnet | Local gateway ip and peer gateway ip are not in the same subnet. | 400 | LocalGatewayIp和peerGatewayIp未在同一个子网中 |
最后更新：2016-11-23 16:03:50
上一篇：
删除物理专线__高速通道相关接口_API 参考_云服务器 ECS-阿里云
下一篇： 查询虚拟边界路由器列表__高速通道相关接口_API 参考_云服务器 ECS-阿里云
- 删除数据库__数据库管理_开放API_分布式关系型数据库 DRDS-阿里云
- ALIYUN::RAM::Role__资源列表_资源编排-阿里云
- 云监控【主题模型】__开发人员指南_消息服务-阿里云
- ShareGroupType__数据类型_API 参考_云服务器 ECS-阿里云
- 云数据库HybridDB 服务协议__服务条款_云数据库 HybridDB-阿里云
- 转换证书格式__证书管理_用户指南_负载均衡-阿里云
- 营销邮件标准及相关规范__业务指导_产品使用问题_企业邮箱-阿里云
- PostObject错误及排查___常见错误及排除_最佳实践_对象存储 OSS-阿里云
- 查询回源带宽__资源监控接口_API 手册_CDN-阿里云
- 工具__Java_SDK使用手册_归档存储-阿里云
相关内容
- 常见错误说明__附录_大数据计算服务-阿里云
- 发送短信接口__API使用手册_短信服务-阿里云
- 接口文档__Android_安全组件教程_移动安全-阿里云
- 运营商错误码（联通）__常见问题_短信服务-阿里云
- 设置短信模板__使用手册_短信服务-阿里云
- OSS 权限问题及排查__常见错误及排除_最佳实践_对象存储 OSS-阿里云
- 消息通知__操作指南_批量计算-阿里云
- 设备端快速接入(MQTT)__快速开始_阿里云物联网套件-阿里云
- 查询API调用流量数据__API管理相关接口_API_API 网关-阿里云
- 使用STS访问__JavaScript-SDK_SDK 参考_对象存储 OSS-阿里云