调用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个字符，必须以字母或中文开头，但不能以 |
| Name | String | 否 | VBR |
VBR的名称。 长度为2～128个字符，必须以字母或中文开头，可包含数字、下划线（_）和短划线（-）。但不能以 |
| AssociatedPhysicalConnections | String | 否 | [ { "CircuitCode ": "longtel001", " LocalGatewayIp ": "192.168.XX.XX", "PeerGatewayIp" : "192.168.XX.XX", " PeeringSubnetMask ": "255.255.255.252", " PhysicalConnectionId ": "pc-kojok19****" } ] |
VBR关联的物理专线的列表信息，包含以下参数：
|
| Action | String | 是 | ModifyVirtualBorderRouterAttribute |
系统规定参数。取值：ModifyVirtualBorderRouterAttribute。 |
| ClientToken | String | 否 | 02fb3da4-130e-11e9-8e44-00**** |
客户端Token，用于保证请求的幂等性。 由客户端生成该参数值，要保证在不同请求间唯一，最大值不超过64个ASCII字符。 |
| LocalIpv6GatewayIp | String | 否 | 2001:XXXX:3c4d:0015:0000:0000:0000:1a2b |
VBR实例的阿里云侧互联IPv6地址。 |
| PeerIpv6GatewayIp | String | 否 | 2001:XXXX:3c4d:0015:0000:0000:0000:2a2b |
VBR实例的客户侧互联IPv6地址。
|
| PeeringIpv6SubnetMask | String | 否 | 2408:4004:cc:400::/56 |
VBR实例的阿里云侧和客户侧互联IPv6的子网掩码。 两个IPv6地址必须位于同一个子网中。 |
| EnableIpv6 | Boolean | 否 | false |
是否启用IPv6。
|
| 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 | InvalidIp.NotSameSubnet | Local gateway ip and peer gateway ip are not in the same subnet. | 本地网关 IP 地址与对端网关 IP 地址不在同一个子网内。 |
| 400 | OperationFailed.PconnTrafficNotEnable | The operation is failed because of PconnTrafficNotEnable. | 操作失败，因为出方向流量未开通。 |
| 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不存在，请您检查此产品在该地域是否可用。 |
访问错误中心查看更多错误码。