调用ModifyVirtualBorderRouterAttribute接口修改边界路由器(VBR)的配置。
修改边界路由器属性
- VlanId只允许物理专线的所有者可以修改。
- 同一物理专线下的同一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必须在同一个网段内。
例如:
- LocalGatewayIp: 192.168.xx.17
- PeerGatewayIp: 192.168.xx.18
- PeeringSubnetMask: 255.255.255.248
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyVirtualBorderRouterAttribute |
要执行的操作,取值: ModifyVirtualBorderRouterAttribute。 |
RegionId | String | 是 | cn-shanghai |
VBR所在的地域。您可以通过调用DescribeRegions接口获取地域ID。 |
VbrId | String | 是 | vbr-************** |
边界路由器的ID。 |
AssociatedPhysicalConnections | String | 否 | pc-kojok19xxxxxxxxx |
物理专线ID。 |
CircuitCode | String | 否 | longtel001 |
运营商为物理专线提供的电路编码。 说明 只有物理专线的所有者可以指定该参数。
|
ClientToken | String | 否 | 02fb3da4-130e-11e9-8e44-00xxxxxxxx |
用于保证请求的幂等性。 由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符。 |
Description | String | 否 | VBR |
VBR的描述信息。 长度为2-256个字符,必须以字母或中文开头,但不能以 |
DetectMultiplier | Long | 否 | 3 |
检测时间倍数。即接收方允许发送方发送报文的最大连接丢包数,用来检测链路是否正常,取值:3-10。 |
LocalGatewayIp | String | 否 | 116.62.xx.xx |
VBR的阿里云侧互联IP。 |
MinRxInterval | Long | 否 | 100 |
配置BFD报文的接收间隔,取值:200-1000,单位为ms。 |
MinTxInterval | Long | 否 | 100 |
配置BFD报文的发送间隔,取值:200-1000,单位为ms。 |
Name | String | 否 | test |
VBR的名称。 长度为2-128个字符,必须以字母或中文开头,可包含数字,点号(.),下划线(_)和短横线(-)。但不能以 |
PeerGatewayIp | String | 否 | 120.120.xx.xx |
VBR专线侧接口对端的IP地址。该属性只允许VBR owner指定/修改。不允许把Enabled状态的VBR的该属性改为空。 |
PeeringSubnetMask | String | 否 | 255.255.128.0 |
VBR的阿里云侧和客户侧互联IP的子网掩码。 两个IP地址必须位于同一个子网中。 |
VlanId | Integer | 否 | 12 |
VBR的VLAN ID,取值范围为:1-2999。 说明 只有物理专线的所有者可以指定该参数,同一条物理专线下的两个VBR的VLAN ID不能相同。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 980960B0-2969-40BF-8542-EBB34FD358AB |
请求ID。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ModifyVirtualBorderRouterAttribute
&RegionId=cn-shanghai
&VbrId=vbr-***********
&<公共请求参数>
正常返回示例
XML
格式
<ModifyVirtualBorderRouterAttributeResponse>
<RequestId>980960B0-2969-40BF-8542-EBB34FD358AB</RequestId>
</ModifyVirtualBorderRouterAttributeResponse>
JSON
格式
{
"RequestId":"980960B0-2969-40BF-8542-EBB34FD358AB"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
404 | InvalidRegionId.NotFound | The specified RegionId is not found. | 指定的 RegionId 不存在,请您检查此产品在该地域是否可用。 |
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 不合法,请您检查该参数是否正确。 |
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参数。 |
400 | InvalidIp.NotSameSubnet | Local gateway ip and peer gateway ip are not in the same subnet. | 本地网关 IP 地址与对端网关 IP 地址不在同一个子网内。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交