调用DescribeVirtualBorderRoutersForPhysicalConnection接口查询指定物理专线下的VBR实例，包括物理专线所有者的VBR实例和其他账号的VBR实例。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeVirtualBorderRoutersForPhysicalConnection

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

RegionId String 是 cn-shanghai

物理专线所在的地域。 您可以通过调用DescribeRegions 接口获取地域ID。

PhysicalConnectionId String 是 pc-119mfj****

物理专线的ID。

PageNumber Integer 否 1

列表的页码，默认值为1。

PageSize Integer 否 10

分页查询时每页的行数，最大值为50。默认值为10。

Filter.N.Key String 否 Status

过滤条件，最多可提供5个过滤条件。支持如下过滤条件：

  • PhysicalConnectionId：物理专线实例ID。
  • VbrId：边界路由器实例ID。
  • Status：边界路由器状态。
  • Name：边界路由器名称。
  • AccessPointId：接入点ID。
  • eccId：高速上云服务实例ID。
  • type：边界路由器类型。
Filter.N.Value.N String 否 Active

根据Key指定过滤值。一个Key支持指定多个过滤值，每个过滤值之间是或的关系，即只要符合其中一个过滤值，则视为匹配该过滤条件。

返回数据

名称 类型 示例值 描述
RequestId String 7C5AE8B3-A2D8-428D-A2FF-93A225C0821E

请求ID。
PageNumber Integer 1

列表的页码，默认值为1。

PageSize Integer 10

分页查询时每页的行数，最大值：50。默认值：10。

TotalCount Integer 1

列表条目数。
VirtualBorderRouterForPhysicalConnectionSet Array of VirtualBorderRouterForPhysicalConnectionType

查询到的VBR实例信息合集。
VirtualBorderRouterForPhysicalConnectionType
Status String Active

VBR实例状态。取值：

  • Unconfirmed：等待他人确认。
  • Active：正常。
  • Terminating：终止接入中。
  • Terminated：已终止接入。
  • Recovering：恢复中。
  • Deleting：删除中。
CreationTime String 2021-06-08T12:20:55

创建VBR的时间。
Type String pconnVBR

VBR类型。
PeerIpv6GatewayIp String 2001:XXXX:3c4d:0015:0000:0000:0000:1a2b

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

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

运营商为物理专线提供的电路编码。
LocalIpv6GatewayIp String ipv6bw-uf6hcyzu65v98v3du****

VBR实例的阿里云侧互联IPv6地址。
PConnVbrExpireTime String 2021-06-10T12:20:55

物理专线绑定的VBR到期时间。
LocalGatewayIp String 192.168.XX.X

VBR实例的阿里云侧互联IPv4地址。
BandwidthStatus String Active

带宽生效状态。取值：

  • Active：正常。
  • Inactive：异常。
ActivationTime String 2021-06-08T12:20:55

VBR第一次激活的时间。
VbrOwnerUid Long 253460731706911258

VBR所有者的账号ID。

VBR和物理专线的所有者相同时该参数为空。
PeeringSubnetMask String 255.255.255.0

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

两个IPv4地址必须位于同一个子网。
EnableIpv6 Boolean true

是否启用IPv6。取值：

  • true：开启。
  • false：关闭。
EccId String ecc-sjghe****

高速上云服务实例ID。
Bandwidth String 10

物理专线下绑定的边界路由器带宽值，单位：Mbps。
RecoveryTime String 2021-06-08T12:20:55

VBR最近一次从Terminated状态恢复到Active状态的时间。
TerminationTime String 2021-06-07T12:20:55

VBR最近一次被终止的时间。
PConnVbrBussinessStatus String Normal

物理专线绑定的VBR运行状态。取值：

  • Normal：正常。
  • FinancialLocked：欠费锁定。
PeerGatewayIp String 162.62.XX.XX

VBR实例的客户侧互联IPv4地址。
PeeringIpv6SubnetMask String 2408:4004:cc:400::/56

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

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

VbrId String vbr-bp16ksp61j7e0tk****

VBR实例ID。
PConnVbrChargeType String PrePaid

物理专线绑定的边界路由器付费类型。取值：

  • PrePaid：预付费，包年包月。选择该类付费方式时，您必须确认自己的账号支持余额支付或信用支付。
  • PostPaid：按量付费。
VlanId Integer 1678

VBR实例的VLAN ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeVirtualBorderRoutersForPhysicalConnection
&RegionId=cn-shanghai
&PhysicalConnectionId=pc-119mfj****
&PageNumber=1
&PageSize=10
&Filter=[{"Key":"Status","Value":["Active"]}]
&公共请求参数

正常返回示例

XML格式 

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

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

JSON格式 

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

{
  "RequestId" : "7C5AE8B3-A2D8-428D-A2FF-93A225C0821E",
  "PageNumber" : 1,
  "PageSize" : 10,
  "TotalCount" : 1,
  "VirtualBorderRouterForPhysicalConnectionSet" : [ {
    "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
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidPhysicalConnectionId.NotFound The specified physicalConnection is not found. 没有找到此专线ID对应的物理专线。
404 InvalidPhysicalConnectionId.NotFound The specified PhysicalConnectionId does not belong to user. 该物理专线不属于您的账号。

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