调用DescribeVirtualBorderRoutersForPhysicalConnection查询边界路由器(VBR)

查询指定物理专线下的边界路由器（VBR），包括物理专线所有者的VBR和其他账号的VBR。

调试

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

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
vpc:DescribeVirtualBorderRoutersForPhysicalConnection	list	PhysicalConnection acs:vpc:{#regionId}:{#accountId}:physicalconnection/{#PhysicalConnectionId}	vpc:PhysicalConnection	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	物理专线所在的地域。您可以通过调用 DescribeRegions 接口获取地域 ID。	cn-shanghai
PhysicalConnectionId	string	是	物理专线的 ID。	pc-119mfj****
PageNumber	integer	否	列表的页码，默认值为 1。	1
PageSize	integer	否	分页查询时每页的行数，最大值为 50。默认值为 10。	10
Filter	array<object>	否	过滤条件列表。
	object	否	过滤条件列表。
Key	string	否	过滤条件，最多可提供 5 个过滤条件。支持如下过滤条件： PhysicalConnectionId：物理专线实例 ID。 VbrId：边界路由器实例 ID。 Status：边界路由器状态。 Name：边界路由器名称。 AccessPointId：接入点 ID。 eccId：高速上云服务实例 ID。 type：边界路由器类型。	Status
Value	array	否	根据 Key 指定过滤值。一个 Key 支持指定多个过滤值，每个过滤值之间是或的关系，即只要符合其中一个过滤值，则视为匹配该过滤条件。
	string	否	根据 Key 指定过滤值。一个 Key 支持指定多个过滤值，每个过滤值之间是或的关系，即只要符合其中一个过滤值，则视为匹配该过滤条件。	Active

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	7C5AE8B3-A2D8-428D-A2FF-93A225C0821E
PageNumber	integer	列表的页码，默认值为 1。	1
PageSize	integer	分页查询时每页的行数，最大值：50。默认值：10。	10
TotalCount	integer	列表条目数。	1
VirtualBorderRouterForPhysicalConnectionSet	array<object>	查询到的 VBR 实例信息合集。
	object
Status	string	VBR 实例状态。取值： unconfirmed：等待他人确认。 active：正常。 terminating：终止接入中。 terminated：已终止接入。 recovering：恢复中。 deleting：删除中。	Active
CreationTime	string	创建 VBR 的时间。	2021-06-08T12:20:55
Type	string	VBR 类型。	pconnVBR
PeerIpv6GatewayIp	string	VBR 实例的客户侧互联 IPv6 地址。为物理专线所有者创建 VBR 实例时必填，为其他账号创建 VBR 实例时无需填写。	2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
CircuitCode	string	运营商为物理专线提供的电路编码。	longtel0**
LocalIpv6GatewayIp	string	VBR 实例的阿里云侧互联 IPv6 地址。	ipv6bw-uf6hcyzu65v98v3du****
PConnVbrExpireTime	string	物理专线绑定的 VBR 到期时间。	2021-06-10T12:20:55
LocalGatewayIp	string	VBR 实例的阿里云侧互联 IPv4 地址。	192.168.XX.X
BandwidthStatus	string	带宽生效状态。取值： Active：正常。 Inactive：异常。	Active
ActivationTime	string	VBR 第一次激活的时间。	2021-06-08T12:20:55
VbrOwnerUid	long	VBR 所有者的账号 ID。 VBR 和物理专线的所有者相同时该参数为空。	253460731706911258
PeeringSubnetMask	string	VBR 实例的阿里云侧和客户侧互联 IPv4 的子网掩码。两个 IPv4 地址必须位于同一个子网。	255.255.255.0
EnableIpv6	boolean	是否启用 IPv6。取值： true：开启。 false：关闭。	true
EccId	string	高速上云服务实例 ID。	ecc-sjghe****
Bandwidth	string	物理专线下绑定的边界路由器带宽值，单位：Mbps。	10
RecoveryTime	string	VBR 最近一次从 Terminated 状态恢复到 Active 状态的时间。	2021-06-08T12:20:55
TerminationTime	string	VBR 最近一次被终止的时间。	2021-06-07T12:20:55
PConnVbrBussinessStatus	string	物理专线绑定的 VBR 运行状态。取值： Normal：正常。 FinancialLocked：欠费锁定。	Normal
PeerGatewayIp	string	VBR 实例的客户侧互联 IPv4 地址。	162.62.XX.XX
PeeringIpv6SubnetMask	string	VBR 实例的阿里云侧和客户侧互联 IPv6 的子网掩码。两个 IPv6 地址必须位于同一个子网。	2408:4004:cc:400::/56
VbrId	string	VBR 实例 ID。	vbr-bp16ksp61j7e0tk****
PConnVbrChargeType	string	物理专线绑定的边界路由器付费类型。取值： PrePaid：预付费，包年包月。选择该类付费方式时，您必须确认自己的账号支持余额支付或信用支付。 PostPaid：按量付费。	PrePaid
VlanId	integer	VBR 实例的 VLAN ID。	1678

示例

正常返回示例

JSON格式

{
  "RequestId": "7C5AE8B3-A2D8-428D-A2FF-93A225C0821E",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1,
  "VirtualBorderRouterForPhysicalConnectionSet": {
    "VirtualBorderRouterForPhysicalConnectionType": [
      {
        "Status": "Active",
        "CreationTime": "2021-06-08T12:20:55",
        "Type": "pconnVBR",
        "PeerIpv6GatewayIp": "2001:XXXX:3c4d:0015:0000:0000:0000:1a2b",
        "CircuitCode": "longtel0**",
        "LocalIpv6GatewayIp": "ipv6bw-uf6hcyzu65v98v3du****",
        "PConnVbrExpireTime": "2021-06-10T12:20:55",
        "LocalGatewayIp": "192.168.XX.X",
        "BandwidthStatus": "Active",
        "ActivationTime": "2021-06-08T12:20:55",
        "VbrOwnerUid": 253460731706911260,
        "PeeringSubnetMask": "255.255.255.0",
        "EnableIpv6": true,
        "EccId": "ecc-sjghe****",
        "Bandwidth": "10",
        "RecoveryTime": "2021-06-08T12:20:55",
        "TerminationTime": "2021-06-07T12:20:55",
        "PConnVbrBussinessStatus": "Normal",
        "PeerGatewayIp": "162.62.XX.XX",
        "PeeringIpv6SubnetMask": "2408:4004:cc:400::/56",
        "VbrId": "vbr-bp16ksp61j7e0tk****",
        "PConnVbrChargeType": "PrePaid",
        "VlanId": 1678
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidPhysicalConnectionId.NotFound	The specified physicalConnection is not found.	没有找到此专线ID对应的物理专线。
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	指定的RegionId不存在。请检查该参数是否正确。
404	InvalidPhysicalConnectionId.NotFound	The specified PhysicalConnectionId does not belong to user.	该物理专线不属于您的账号。

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

变更历史

变更时间	变更内容概要	操作
2023-09-11	OpenAPI 描述信息更新、OpenAPI 错误码发生变更	查看变更详情