调用ModifyVirtualBorderRouterAttribute接口修改边界路由器VBR（Virtual Border Router）的配置。

使用说明

  • VlanId只允许物理专线的所有者修改。
  • 同一物理专线下的同一VLAN ID不允许被两个VBR同时使用。
  • 进入Terminated状态的VBR会在7天内自动保留其VLAN ID，不允许其他VBR使用。7天后可以被其他VBR使用。
  • 其他账号的VBR实例，不能配置LocalGatewayIp、PeerGatewayIp和PeeringSubnetMask。
  • PeeringSubnetMask支持24～30位（255.255.255.0～255.255.255.252）。
  • LocalGatewayIp和PeerGatewayIp必须在同一个网段内。例如，LocalGatewayIp：192.168.XX.XX，PeerGatewayIp：192.168.XX.XX，PeeringSubnetMask：255.255.255.248。

调试

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

请求参数

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

VBR所在的地域ID。

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

VbrId String 是 vbr-bp1lhl0taikrte****

VBR实例ID。

VlanId Integer 否 0

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

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

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

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

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

该属性只允许VBR所有者指定或修改。
PeerGatewayIp String 否 192.168.XX.X

VBR实例的客户侧互联IP。

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

VBR实例的阿里云侧和客户侧互联IP的子网掩码。该属性只允许VBR所有者指定或修改。

两个IP地址必须位于同一个子网中。
MinTxInterval Long 否 300

配置BFD报文的发送间隔，取值：200～1000，单位：ms。
MinRxInterval Long 否 300

配置BFD报文的接收间隔，取值：200～1000，单位：ms。
DetectMultiplier Long 否 3

检测时间倍数，即接收方允许发送方发送报文的最大连接丢包数，用来检测链路是否正常。

取值：3～10。
Description String 否 desc

VBR的描述信息。

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

VBR的名称。

长度为2～128个字符，必须以字母或中文开头，可包含数字、下划线（_）和短划线（-）。但不能以http:// 或https://开头。
AssociatedPhysicalConnections String 否 [ { "CircuitCode ": "longtel001", " LocalGatewayIp ": "192.168.XX.XX", "PeerGatewayIp" : "192.168.XX.XX", " PeeringSubnetMask ": "255.255.255.252", " PhysicalConnectionId ": "pc-kojok19****" } ]

VBR关联的物理专线的列表信息，包含以下参数：

  • CircuitCode：运营商为物理专线提供的电路编码。
  • LocalGatewayIp：VBR实例的阿里云侧互联IP。
  • PeerGatewayIp：VBR实例的客户侧互联IP。
  • PeeringSubnetMask：VBR实例的阿里云侧和客户侧互联IP的子网掩码。
  • PhysicalConnectionId：物理专线实例ID。
Action String 是 ModifyVirtualBorderRouterAttribute

系统规定参数。取值：ModifyVirtualBorderRouterAttribute。
ClientToken String 否 02fb3da4-130e-11e9-8e44-00****

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

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

说明 若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId不一样。
LocalIpv6GatewayIp String 否 2001:XXXX:3c4d:0015:0000:0000:0000:1a2b

VBR实例的阿里云侧互联IPv6地址。
PeerIpv6GatewayIp String 否 2001:XXXX:3c4d:0015:0000:0000:0000:2a2b

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

  • 该属性只允许VBR所有者指定或者修改。
  • 为物理专线所有者创建VBR实例时必填，为其他账号创建VBR实例时无需填写。
PeeringIpv6SubnetMask String 否 2408:4004:cc:400::/56

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

两个IPv6地址必须位于同一个子网中。
EnableIpv6 Boolean 否 false

是否启用IPv6。

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

带宽值。单位：Mbps。

返回数据

名称 类型 示例值 描述
RequestId String 980960B0-2969-40BF-8542-EBB34FD358AB

请求ID。

示例

请求示例

http(s)://[Endpoint]/?RegionId=cn-shanghai
&VbrId=vbr-bp1lhl0taikrte****
&VlanId=0
&CircuitCode=longtel001
&LocalGatewayIp=192.168.XX.XX
&PeerGatewayIp=192.168.XX.X
&PeeringSubnetMask=255.255.255.252
&MinTxInterval=300
&MinRxInterval=300
&DetectMultiplier=3
&Description=desc
&Name=VBR
&AssociatedPhysicalConnections=[   {     "CircuitCode ": "longtel001",     " LocalGatewayIp ": "192.168.XX.XX",     "PeerGatewayIp" : "192.168.XX.XX",     " PeeringSubnetMask ": "255.255.255.252",     " PhysicalConnectionId ": "pc-kojok19****"   } ]
&Action=ModifyVirtualBorderRouterAttribute
&ClientToken=02fb3da4-130e-11e9-8e44-00****
&LocalIpv6GatewayIp=2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
&PeerIpv6GatewayIp=2001:XXXX:3c4d:0015:0000:0000:0000:2a2b
&PeeringIpv6SubnetMask=2408:4004:cc:400::/56
&EnableIpv6=false
&Bandwidth=100
&公共请求参数

正常返回示例

XML格式

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

<ModifyVirtualBorderRouterAttributeResponse>
    <RequestId>980960B0-2969-40BF-8542-EBB34FD358AB</RequestId>
</ModifyVirtualBorderRouterAttributeResponse>

JSON格式

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

{
  "RequestId" : "980960B0-2969-40BF-8542-EBB34FD358AB"
}

错误码

HttpCode 错误码 错误信息 描述
400 IllegalParam.CidrBlock The specified CidrBlock is illegal. CidrBlock参数非法。
400 InvalidVbrId.NotFound The specified VirutalBorderRouter is not found. 该边界路由器不存在，请您检查输入的边界路由器是否正确。
400 InvalidVlanId.Used The specified VlanId has been used. 该VLAN已经被占用。
400 InvalidCircuitCode.Malformed The specified CircuitCode is not valid. 该CircuitCode不合法。
400 InvalidVlanId.Malformed The specified VlanId is not valid. 参数VlanId的值不合法。
400 InvalidIp.Malformed The specified ip address is not valid. 指定的私网 IP 不合法，请您检查该私网IP是否正确。
400 InvalidPeeringSubnetMask.Malformed The specified PeeringSubnetMask is not valid. 指定的PeeringSubnetMask不合法，请您检查该参数是否正确。
400 InvalidName.Malformed The specified Name is not valid. 参数Name值不合法
400 InvalidDescription.Malformed The specifid Description is not valid. 参数Description值不合法
400 MissingParameter LocalGatewayIp, peerGatewayIp and peeringSubnetMask must not be null. 参数缺失LocalGatewayIp，peerGatewayIp，peeringSubnetMask不能为空
400 InvalidIp.NotSameSubnet Local gateway ip and peer gateway ip are not in the same subnet. 本地网关IP地址与对端网关IP地址不在同一个子网内。
400 OperationFailed.VlanIdInUse Operation failed because vlanId is in use. vlanId已经被使用
400 OperationUnsupported.IPV6ForThisRegion This Region do not support IPV6. 地域不支持IPV6
400 OperationFailed.PconnTrafficNotEnable The operation is failed because of PconnTrafficNotEnable. 操作失败，因为出方向流量未开通。
400 OperationDenied.VBRAssociateVPconn The operation is not allowed because of VBRAssociateVPconn. VBR不允许绑定Vpconn
400 OperationFailed.PhysicalConnectionFinancialLocked Update failed, the physical connection is financial locked. 共享端口为欠费锁定状态，无法修改vlan。
400 OperationFailed.PhysicalConnectionTerminated Update failed, the physical connection is terminated. 共享端口为已终止状态，无法修改vlan。
403 Forbidden.CircuitCodeNotAllowedByCaller The caller is not allowed to modify. 不允许修改CircuitCode参数。
403 Forbidden.CircuitCodeNotAllowedByCaller The caller is not allowed to specify the CircuitCode parameter. 不允许指定CircuitCode参数。
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.VlanIdNotAllowedByCaller The caller is not allowed to specify the VlanId. 不允许指定VLAN ID。
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不存在，请您检查此产品在该地域是否可用。

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