调用CreateVirtualBorderRouter接口创建边界路由器VBR（Virtual Border Router）实例。

使用说明

  • 为本账号创建VBR实例后，VBR实例状态为Enabled。
  • 为其他账号创建VBR实例后，VBR实例状态为Unconfirmed，需要对方账号确认。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
RegionId String 是 cn-shanghai

物理专线所在的地域ID。

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

PhysicalConnectionId String 是 pc-2zextbehcx****

物理专线实例ID。

VbrOwnerId Long 否 168811111****

VBR所有者的账号ID。

默认为当前用户的账号ID或物理专线所有者的账号ID。
VlanId Integer 是 0

VBR的VLAN ID，取值范围：0～2999。

说明 只有物理专线的所有者可以指定该参数，同一条物理专线下的两个VBR的VLAN ID不能相同。
CircuitCode String 否 longtel001

运营商为物理专线提供的电路编码。

说明 只有物理专线所有者可以指定该参数。
LocalGatewayIp String 否 192.168.XX.XX

VBR实例的阿里云侧互联IP。

PeerGatewayIp String 否 116.62.XX.XX

VBR实例的客户侧互联IP。

该属性只允许VBR所有者指定或者修改。

为物理专线所有者创建VBR实例时必填，为其他账号创建VBR实例时无需填写。
PeeringSubnetMask String 否 255.255.255.252

VBR实例的阿里云侧和客户侧互联IP的子网掩码。

两个IP地址必须位于同一个子网中。

Description String 否 desc

VBR的描述信息。

长度为2～256个字符，必须以字母或中文开头，但不能以http:// 或https://开头。

Name String 否 test

VBR的名称。

长度为2～128个字符，必须以字母或中文开头，可包含数字、下划线（_）和短划线（-）。但不能以http:// 或https://开头。

ClientToken String 否 123e4567-e89b-12d3-a456-426655440000

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

由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符。

说明 若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
Action String 是 CreateVirtualBorderRouter

系统规定参数。取值：CreateVirtualBorderRouter。

LocalIpv6GatewayIp String 否 2001:XXXX:3c4d:0015:0000:0000:0000:1a2b

VBR实例的阿里云侧互联IPv6地址。
PeerIpv6GatewayIp String 否 2001:XXXX:4:4:4:4:4:4

VBR实例的客户侧互联IPv6地址。

该属性只允许VBR所有者指定或者修改。

为物理专线所有者创建VBR实例时必填，为其他账号创建VBR实例时无需填写。
PeeringIpv6SubnetMask String 否 2408:4004:cc:400::/56

VBR实例的阿里云侧和客户侧互联IPv6的子网掩码。

两个IPv6地址必须位于同一个子网中。

EnableIpv6 Boolean 否 true

是否启用IPv6。取值：

  • true：开启。
  • false（默认值）：关闭。
Bandwidth Long 否 100

带宽值，单位：Mbps。

返回数据

名称 类型 示例值 描述
VbrId String vbr-bp1jcg5cmxjbl9xgc****

VBR实例ID。
RequestId String 4EC47282-1B74-4534-BD0E-403F3EE64CAF

请求ID。

示例

请求示例

http(s)://[Endpoint]/?RegionId=cn-shanghai
&PhysicalConnectionId=pc-2zextbehcx****
&VlanId=0
&CircuitCode=longtel001
&LocalGatewayIp=192.168.XX.XX
&PeerGatewayIp=116.62.XX.XX
&PeeringSubnetMask=255.255.255.252
&Description=desc
&Name=test
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&Action=CreateVirtualBorderRouter
&LocalIpv6GatewayIp=2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
&PeerIpv6GatewayIp=2001:XXXX:4:4:4:4:4:4
&PeeringIpv6SubnetMask=2408:4004:cc:400::/56
&EnableIpv6=true
&Bandwidth=100
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<CreateVirtualBorderRouterResponse>
    <VbrId>vbr-bp1jcg5cmxjbl9xgc****</VbrId>
    <RequestId>4EC47282-1B74-4534-BD0E-403F3EE64CAF</RequestId>
</CreateVirtualBorderRouterResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "VbrId" : "vbr-bp1jcg5cmxjbl9xgc****",
  "RequestId" : "4EC47282-1B74-4534-BD0E-403F3EE64CAF"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidPhysicalConnectionId.NotFound The specified PhysicalConnectionId is not found. 该物理专线ID不存在。
400 InvalidVlanId.Used The specified VlanId has been used. 该VLAN已经被占用。
400 MissingParameter The input parameter 'PhysicalConnectionId' that is mandatory for processing this request is not supplied. 必须指定参数PhysicalConnectionId。
400 InvalidPhysicalConnectionId.NotEnabled The specified PhysicalConnectionId is not in Enabled state. 该物理专线当前未处于正常状态，请检查物理专线后再创建。
400 InvalidVlanId.Malformed The specified VlanId is not valid. 参数VlanId的值不合法。
400 InvalidCircuitCode.Malformed The specified CircuitCode is not valid. 该CircuitCode不合法。
400 MissingParameter The input parameter 'LocalGatewayIp' that is mandatory for processing this request is not supplied. 必须指定参数LocalGatewayIp。
400 InvalidLocalGatewayIp.Malformed The specified LocalGatewayIp is not valid. 该本端网关的IP不合法。
400 MissingParameter The input parameter 'PeerGatewayIp' that is mandatory for processing this request is not supplied. 必须指定参数PeerGatewayIp。
400 MissingParameter The input parameter 'PeeringSubnetMask' that is mandatory for processing this request is not supplied. 必须指定参数PeeringSubnetMask。
400 InvalidPeeringSubnetMask.Malformed The specified PeeringSubnetMask is not valid. 指定的 PeeringSubnetMask 不合法，请您检查该参数是否正确。
400 InvalidName.Malformed The specified ?Name? is not valid. 该名称格式不合法。
400 InvalidDescription.Malformed The specifid ?Description? is not valid. 指定的资源描述格式不合法。长度为2-256个字符，不能以 http:// 和 https:// 开头。
400 QuotaExceeded.vbrPerpConn Virtual boarder router per PhysicalConnection quota exceed. 超过了每个物理专线上的边界路由器配额上限，请您减少该物理专线上的边界路由器数量后再试。
400 QuotaExceeded.freevbr Free virtual boarder router quota exceed. 超过边界路由器配额。
400 InvalidIp.NotSameSubnet Local gateway ip and peer gateway ip are not in the same subnet. 本地网关 IP 地址与对端网关 IP 地址不在同一个子网内。
400 OperationFailed.PconnExistVlan0Vbr The physical connection has VLAN 0 VBR. You cannot create another VBR. 专线上已经存在VLAN 0 VBR，不允许创建其它VBR。
400 OperationFailed.Vlan0VbrUnSharePconn VLAN 0 VBR cannot share the physical connection with another VBR. 专线已有其它VLAN 0 VBR，不允许在此专线创建VLAN 0 VBR。
400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. 操作失败，因为出方向流量未开通。
403 Forbidden.LocalGatewayIpNotAllowedByCaller The caller is not allowed to specify the LocalGatewayIp parameter. 不允许指定LocalGatewayIp参数。
403 Forbidden.PeerGatewayIpNotAllowedByCaller The caller is not allowed to specify the PeerGatewayIp parameter. 不允许指定PeerGatewayIp参数。
403 Forbidden.PeeringSubnetMaskNotAllowedByCaller The caller is not allowed to specify the PeeringSubnetMask parameter. 不允许指定PeeringSubnetMask参数。
403 Forbidden.NameNotAllowedByCaller The caller is not allowed to specify the Name parameter. 不允许指定Name参数。
403 Forbidden.DescriptionNotAllowedByCaller The caller is not allowed to specify the Description parameter. 不允许指定Description参数。
404 InvalidRegionId.NotFound The specified RegionId is not found. 指定的RegionId不存在，请您检查此产品在该地域是否可用。
404 InvalidVbrOwnerId.NotFound The specified VbrOwnerId is not valid. 参数VbrOwnerId的值不合法。
404 CROSS_BID.FORBIDDEN Create VBR across bid is illegal 禁止为其他站点的用户创建 VBR。

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