调用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. 该物理专线不属于您的账号。

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