Queries virtual border routers (VBRs).

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeVirtualBorderRouters

The operation that you want to perform. Set the value to DescribeVirtualBorderRouters.

RegionId String Yes cn-shanghai

The ID of the region where the VBRs are deployed. You can call the DescribeRegions operation to query the most recent region list.

PageNumber Integer No 1

The number of the page to return. Default value: 1.

PageSize Integer No 10

The number of entries to return on each page. Maximum value: 50. Default value: 10.

Filter.N.Key String No Status

The filter conditions. You can specify at most five filter conditions. The following filter conditions are supported:

  • PhysicalConnectionId: Filter by Express Connect circuit ID.
  • VbrId: Filter by VBR ID.
  • Status: Filter by VBR status.
  • Name: Filter by VBR name.
  • AccessPointId: Filter by access point ID.
  • eccId: Filter by Express Cloud Connect (ECC) instance ID.
  • type: Filter by Express Connect circuit type.
Filter.N.Value.N String No Active

The filter values for keys. You can specify multiple filter values for one key. The logical operator between filter values is OR. If one filter value is matched, the filter condition is matched.

IncludeCrossAccountVbr Boolean No false

Specifies whether cross-account VBRs are included.

  • true: yes
  • false: no. This is the default value.

Response parameters

Parameter Type Example Description
RequestId String DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6

The ID of the request.

PageNumber Integer 1

The number of the returned page. Default value: 1.

PageSize Integer 10

The number of entries returned per page. Maximum value: 50. Default value: 10.

TotalCount Integer 1

The total number of entries returned.

VirtualBorderRouterSet Array of VirtualBorderRouterType

The information about the queried VBRs.

VirtualBorderRouterType
CreationTime String 2020-06-08T12:20:55

The time when the VBR was created.

Status String active

The status of the VBR. Valid values:

  • unconfirmed: pending confirmation from other users
  • active: normal
  • terminating: being disabled
  • terminated: disabled
  • recovering: being enabled
  • deleting:: being deleted
Type String pconnVBR

The type of the VBR.

MinTxInterval Long 300

The time interval to send Bidirectional Forwarding Detection (BFD) packets. Valid values: 200 to 1000. Unit: milliseconds.

PeerIpv6GatewayIp String 2001:XXXX:3c4d:0015:0000:0000:0000:1a2b

The IPv6 address of the gateway device on the user side.

PConnVbrExpireTime String 2021-06-08T12:20:55

The time when the VBR expires.

PhysicalConnectionOwnerUid String 1688000000000****

The UID of the Alibaba Cloud account to which the Express Connect circuit belongs.

ActivationTime String 2021-06-08T12:20:55

The first time when the VBR was activated.

PhysicalConnectionBusinessStatus String Normal

The business status of the Express Connect circuit.

  • Normal: normal
  • FinancialLocked: locked due to overdue payments
Description String desc

The description of the VBR.

TerminationTime String 2021-06-08T12:20:55

The last time when the VBR was disabled.

MinRxInterval Long 300

The time interval to receive Bidirectional Forwarding Detection (BFD) packets. Valid values: 200 to 1000. Unit: milliseconds.

PeerGatewayIp String 192.168.XX.XX

The IPv4 address of the VBR on the user side.

Name String test

The name of the VBR.

VbrId String vbr-bp1jcg5cmxjbl9xgc****

The ID of the VBR.

VlanId Integer 10

The VLAN ID of the VBR.

VlanInterfaceId String ri-2zeo3xzyf38r4xx****

The ID of the VBR interface.

CircuitCode String longtel0****

The circuit code of the Express Connect circuit. The circuit code is predefined by the connectivity provider.

LocalIpv6GatewayIp String 2001:XXXX:3c4d:0015:0000:0000:0000:1a2b

The IPv6 address of the gateway device on the Alibaba Cloud side.

LocalGatewayIp String 192.168.XX.XX

The IPv4 address of the gateway device on the Alibaba Cloud side.

PeeringSubnetMask String 255.255.255.252

The subnet mask of the IPv4 addresses configured on the user side and Alibaba Cloud side.

EnableIpv6 Boolean false

Indicates whether IPv6 is enabled. Valid values:

  • true: enabled
  • false: disabled
RouteTableId String rtb-bp1****

The ID of the VBR route table.

DetectMultiplier Long 3

The multiple of the detection time.

This value indicates the maximum number of dropped packets that is allowed by the receiver when the initiator transmits packets. This value can be used to check whether the connection works as expected.

Valid values: 3 to 10.

EccId String ecc-h****

The ID of the ECC instance.

CloudBoxInstanceId String cb-****

The ID of the cloud box.

RecoveryTime String 2021-05-08T12:20:55

The last time when the status of the VBR changed from terminated to active.

PhysicalConnectionStatus String Normal

The status of the Express Connect circuit.

  • Initial: The application is under review.
  • Approved: The application is approved.
  • Allocating: The system is allocating resources.
  • Allocated: The Express Connect circuit is under construction.
  • Confirmed: The Express Connect circuit is pending for user confirmation.
  • Enabled: The Express Connect circuit is enabled.
  • Rejected: The application is rejected.
  • Canceled: The application is canceled.
  • Allocation Failed: The system failed to allocate resources.
  • Terminated: The Express Connect circuit is disabled.
PeeringIpv6SubnetMask String 2000:1234:0:a000::/55

The subnet mask of the IPv6 addresses configured on the user side and Alibaba Cloud side.

AccessPointId String ap-cn-kojok1x****

The ID of the access point.

PConnVbrChargeType String PrePaid

The billing method of the VBR.

  • PrePaid: subscription If you choose this billing method, make sure that your Alibaba Cloud account supports balance payments or credit payments.
  • PostPaid: pay-as-you-go
PhysicalConnectionId String pc-119mfjzm7x****

The ID of the Express Connect circuit to which the VBR belongs.

AssociatedPhysicalConnections Array of AssociatedPhysicalConnection

The information about the Express Connect circuit that is associated with the VBR.

AssociatedPhysicalConnection
Status String active

The status of the VBR. Valid values:

  • unconfirmed: pending confirmation from other users
  • active: normal
  • terminating: being disabled
  • terminated: disabled
  • recovering: being enabled
  • deleting: The endpoint is being deleted.
VlanInterfaceId String ri-kojok19x3j0q6k****

The ID of the VBR interface, which can be used as the next hop of a VBR route.

CircuitCode String longtel0**

The circuit code of the Express Connect circuit. The circuit code is predefined by the connectivity provider.

PeerIpv6GatewayIp String 2001:XXXX:3c4d:0015:0000:0000:0000:1a2b

The IPv6 address of the gateway device in the data center.

LocalIpv6GatewayIp String 2001:XXXX:3c4d:0015:0000:0000:0000:1a2b

The IPv6 address of the gateway device on the Alibaba Cloud side.

PhysicalConnectionOwnerUid String 12345678****

The UID of the Alibaba Cloud account to which the Express Connect circuit belongs.

LocalGatewayIp String 192.168.XX.XX

The IPv4 address of the gateway device on the Alibaba Cloud side.

PhysicalConnectionBusinessStatus String Normal

The business status of the Express Connect circuit.

  • Normal: normal
  • FinancialLocked: locked due to overdue payments
PeeringSubnetMask String 255.255.255.252

The subnet mask for the IPv4 addresses of the gateway devices on the Alibaba Cloud side and on the user side.

The two IPv4 addresses must fall within the same subnet.

EnableIpv6 Boolean true

Indicates whether IPv6 is enabled. Valid values:

  • true: enabled.
  • false: disabled.
PhysicalConnectionStatus String Enabled

The status of the Express Connect circuit.

  • Initial: The application is under review.
  • Approved: The application is approved.
  • Allocating: The system is allocating resources.
  • Allocated: The Express Connect circuit is under construction.
  • Confirmed: The Express Connect circuit is pending for user confirmation.
  • Enabled: The Express Connect circuit is enabled.
  • Rejected: The application is rejected.
  • Canceled: The application is canceled.
  • Allocation Failed: The system failed to allocate resources.
  • Terminated: The Express Connect circuit is disabled.
PeerGatewayIp String 116.62.XX.XX

The IPv4 address of the VBR on the user side.

PeeringIpv6SubnetMask String 2408:4004:cc:400::/56

The subnet mask for the IPv6 addresses of the gateway devices on the Alibaba Cloud side and on the user side.

The two IPv6 addresses must fall within the same subnet.

PhysicalConnectionId String pc-119mfjzm7****

The ID of the Express Connect circuit.

VlanId String 0

The VLAN ID of the VBR.

AssociatedCens Array of AssociatedCen

The information about the Cloud Enterprise Network (CEN) instance to which the VBR is attached.

AssociatedCen
CenOwnerId Long 1688000000000****

The user ID (UID) of the Alibaba Cloud account to which the CEN instance belongs.

CenId String cen-kojok19xxx****

The ID of the CEN instance.

CenStatus String Attached

The status of the CEN instance. Valid values:

  • Attached: The VBR is attached to the CEN instance.
  • Attaching: The VBR is being attached to the CEN instance.
  • Detached: The VBR is detached from the CEN instance.
  • Detaching: The VBR is being detached from the CEN instance.
  • If no value is returned, the VBR is not attached to a CEN instance.
Bandwidth Integer 50

The bandwidth of the VBR. Unit: Mbit/s.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeVirtualBorderRouters
&RegionId=cn-shanghai
&PageNumber=1
&PageSize=10
&Filter=[{"Key":"Status","Value":["Active"]}]
&IncludeCrossAccountVbr=false
&Common request parameters

Sample success responses

XML format

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

<DescribeVirtualBorderRoutersResponse>
    <RequestId>DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6</RequestId>
    <PageNumber>1</PageNumber>
    <PageSize>10</PageSize>
    <TotalCount>1</TotalCount>
    <VirtualBorderRouterSet>
        <CreationTime>2020-06-08T12:20:55</CreationTime>
        <Status>active</Status>
        <Type>pconnVBR</Type>
        <MinTxInterval>300</MinTxInterval>
        <PeerIpv6GatewayIp>2001:XXXX:3c4d:0015:0000:0000:0000:1a2b</PeerIpv6GatewayIp>
        <PConnVbrExpireTime>2021-06-08T12:20:55</PConnVbrExpireTime>
        <PhysicalConnectionOwnerUid>1688000000000****</PhysicalConnectionOwnerUid>
        <ActivationTime>2021-06-08T12:20:55</ActivationTime>
        <PhysicalConnectionBusinessStatus>Normal</PhysicalConnectionBusinessStatus>
        <Description>desc</Description>
        <TerminationTime>2021-06-08T12:20:55</TerminationTime>
        <MinRxInterval>300</MinRxInterval>
        <PeerGatewayIp>192.168.XX.XX</PeerGatewayIp>
        <Name>test</Name>
        <VbrId>vbr-bp1jcg5cmxjbl9xgc****</VbrId>
        <VlanId>10</VlanId>
        <VlanInterfaceId>ri-2zeo3xzyf38r4xx****</VlanInterfaceId>
        <CircuitCode>longtel0****</CircuitCode>
        <LocalIpv6GatewayIp>2001:XXXX:3c4d:0015:0000:0000:0000:1a2b</LocalIpv6GatewayIp>
        <LocalGatewayIp>192.168.XX.XX</LocalGatewayIp>
        <PeeringSubnetMask>255.255.255.252</PeeringSubnetMask>
        <EnableIpv6>false</EnableIpv6>
        <RouteTableId>rtb-bp1****</RouteTableId>
        <DetectMultiplier>3</DetectMultiplier>
        <EccId>ecc-h****</EccId>
        <CloudBoxInstanceId>cb-****</CloudBoxInstanceId>
        <RecoveryTime>2021-05-08T12:20:55</RecoveryTime>
        <PhysicalConnectionStatus>Normal</PhysicalConnectionStatus>
        <PeeringIpv6SubnetMask>2000:1234:0:a000::/55</PeeringIpv6SubnetMask>
        <AccessPointId>ap-cn-kojok1x****</AccessPointId>
        <PConnVbrChargeType>PrePaid</PConnVbrChargeType>
        <PhysicalConnectionId>pc-119mfjzm7x****</PhysicalConnectionId>
        <AssociatedPhysicalConnections>
            <Status>active</Status>
            <VlanInterfaceId>ri-kojok19x3j0q6k****</VlanInterfaceId>
            <CircuitCode>longtel0**</CircuitCode>
            <PeerIpv6GatewayIp>2001:XXXX:3c4d:0015:0000:0000:0000:1a2b</PeerIpv6GatewayIp>
            <LocalIpv6GatewayIp>2001:XXXX:3c4d:0015:0000:0000:0000:1a2b</LocalIpv6GatewayIp>
            <PhysicalConnectionOwnerUid>12345678****</PhysicalConnectionOwnerUid>
            <LocalGatewayIp>192.168.XX.XX</LocalGatewayIp>
            <PhysicalConnectionBusinessStatus>Normal</PhysicalConnectionBusinessStatus>
            <PeeringSubnetMask>255.255.255.252</PeeringSubnetMask>
            <EnableIpv6>true</EnableIpv6>
            <PhysicalConnectionStatus>Enabled</PhysicalConnectionStatus>
            <PeerGatewayIp>116.62.XX.XX</PeerGatewayIp>
            <PeeringIpv6SubnetMask>2408:4004:cc:400::/56</PeeringIpv6SubnetMask>
            <PhysicalConnectionId>pc-119mfjzm7****</PhysicalConnectionId>
            <VlanId>0</VlanId>
        </AssociatedPhysicalConnections>
        <AssociatedCens>
            <CenId>cen-kojok19xxx****</CenId>
            <CenStatus>Attached</CenStatus>
        </AssociatedCens>
        <Bandwidth>50</Bandwidth>
    </VirtualBorderRouterSet>
</DescribeVirtualBorderRoutersResponse>

JSON format

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

{
  "RequestId" : "DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6",
  "PageNumber" : 1,
  "PageSize" : 10,
  "TotalCount" : 1,
  "VirtualBorderRouterSet" : [ {
    "CreationTime" : "2020-06-08T12:20:55",
    "Status" : "active",
    "Type" : "pconnVBR",
    "MinTxInterval" : 300,
    "PeerIpv6GatewayIp" : "2001:XXXX:3c4d:0015:0000:0000:0000:1a2b",
    "PConnVbrExpireTime" : "2021-06-08T12:20:55",
    "PhysicalConnectionOwnerUid" : "1688000000000****",
    "ActivationTime" : "2021-06-08T12:20:55",
    "PhysicalConnectionBusinessStatus" : "Normal",
    "Description" : "desc",
    "TerminationTime" : "2021-06-08T12:20:55",
    "MinRxInterval" : 300,
    "PeerGatewayIp" : "192.168.XX.XX",
    "Name" : "test",
    "VbrId" : "vbr-bp1jcg5cmxjbl9xgc****",
    "VlanId" : 10,
    "VlanInterfaceId" : "ri-2zeo3xzyf38r4xx****",
    "CircuitCode" : "longtel0****",
    "LocalIpv6GatewayIp" : "2001:XXXX:3c4d:0015:0000:0000:0000:1a2b",
    "LocalGatewayIp" : "192.168.XX.XX",
    "PeeringSubnetMask" : "255.255.255.252",
    "EnableIpv6" : false,
    "RouteTableId" : "rtb-bp1****",
    "DetectMultiplier" : 3,
    "EccId" : "ecc-h****",
    "CloudBoxInstanceId" : "cb-****",
    "RecoveryTime" : "2021-05-08T12:20:55",
    "PhysicalConnectionStatus" : "Normal",
    "PeeringIpv6SubnetMask" : "2000:1234:0:a000::/55",
    "AccessPointId" : "ap-cn-kojok1x****",
    "PConnVbrChargeType" : "PrePaid",
    "PhysicalConnectionId" : "pc-119mfjzm7x****",
    "AssociatedPhysicalConnections" : [ {
      "Status" : "active",
      "VlanInterfaceId" : "ri-kojok19x3j0q6k****",
      "CircuitCode" : "longtel0**",
      "PeerIpv6GatewayIp" : "2001:XXXX:3c4d:0015:0000:0000:0000:1a2b",
      "LocalIpv6GatewayIp" : "2001:XXXX:3c4d:0015:0000:0000:0000:1a2b",
      "PhysicalConnectionOwnerUid" : "12345678****",
      "LocalGatewayIp" : "192.168.XX.XX",
      "PhysicalConnectionBusinessStatus" : "Normal",
      "PeeringSubnetMask" : "255.255.255.252",
      "EnableIpv6" : true,
      "PhysicalConnectionStatus" : "Enabled",
      "PeerGatewayIp" : "116.62.XX.XX",
      "PeeringIpv6SubnetMask" : "2408:4004:cc:400::/56",
      "PhysicalConnectionId" : "pc-119mfjzm7****",
      "VlanId" : "0"
    } ],
    "AssociatedCens" : [ {
      "CenId" : "cen-kojok19xxx****",
      "CenStatus" : "Attached"
    } ],
    "Bandwidth" : 50
  } ]
}

Error codes

HttpCode Error code Error message Description
404 InvalidFilterKey.ValueNotSupported Specified filter key is not supported: Filter.X.key The error message returned because Filter.X.key is not supported.

For a list of error codes, see Service error codes.