Virtual Border Router Query API Overview - Express Connect - Alibaba Cloud - Express Connect

Queries Virtual Border Routers (VBRs) that are created.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

vpc:DescribeVirtualBorderRouters

list

*VirtualBorderRouter

acs:vpc:{#regionId}:{#AccountId}:virtualborderrouter/{#VbrId}

None

Request parameters

Parameter	Type	Required	Description	Example
RegionId	string	Yes	The region ID of the VBR. You can call the DescribeRegions operation to query the region ID.	cn-shanghai
PageNumber	integer	No	The page number of the list. Default value: 1.	1
PageSize	integer	No	The number of entries per page in a paged query. Maximum value: 50. Default value: 10.	10
Filter	array<object>	No	The filter information.
	object	No	The filter information.
Key	string	No	The filter condition. You can specify up to 5 filter conditions. The following filter conditions are supported:	Status
Value	array	No	The filter value based on the specified Key. You can specify multiple filter values for a Key. The relationship between multiple filter values is OR, which means that a match with any one of the filter values is considered a match with the filter condition.	Active
	string	No	The filter value based on the specified Key. You can specify multiple filter values for a Key. The relationship between multiple filter values is OR, which means that a match with any one of the filter values is considered a match with the filter condition.	Active
IncludeCrossAccountVbr	boolean	No	Specifies whether to include cross-account Virtual Border Routers. true: Included. false (default): Not included.	false
ResourceGroupId	string	No	The resource group ID.	rg-acfmxazb4ph6aiy****
Tags	array<object>	No	The tags of the resource.
	object	No	The tag.
Key	string	No	The tag key of the resource. You must specify at least 1 tag key and can specify up to 20 tag keys. The tag key cannot be an empty string.	FinanceDept
Value	string	No	The tag value of the resource. You can specify up to 20 tag values. The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot start with `aliyun` or `acs:`. It cannot contain `http://` or `https://`.	FinanceJoshua

Response elements

Element	Type	Description	Example
	object	The Virtual Border Router (VBR) information.
RequestId	string	The request ID.	DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6
PageNumber	integer	The page number of the list. Default value: 1.	1
PageSize	integer	The number of entries per page in a paged query. Maximum value: 50. Default value: 10.	10
TotalCount	integer	The total number of entries returned.	1
VirtualBorderRouterSet	object
VirtualBorderRouterType	array<object>	The list of VBRs.
	array<object>	The creation time of the VBR.
CreationTime	string	The time when the VBR was created.	2020-06-08T12:20:55
Status	string	The instance status of the VBR. unconfirmed: waiting for confirmation from the other party. active: normal. terminating: stopping access. terminated: access stopped. recovering: being recovered. deleting: being deleted.	active
Type	string	The type of the VBR.	pconnVBR
MinTxInterval	integer	The alert interval for sending Bidirectional Forwarding Detection (BFD) packets. Valid values: 200 to 1000. Unit: ms.	300
PeerIpv6GatewayIp	string	The IPv6 address of the VBR on the customer side.	2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
PConnVbrExpireTime	string	The expiration time of the billable VBR.	2021-06-08T12:20:55
PhysicalConnectionOwnerUid	string	The ID of the account to which the Express Connect circuit belongs.	1688000000000****
ActivationTime	string	The time when the VBR was first activated.	2021-06-08T12:20:55
PhysicalConnectionBusinessStatus	string	The business status of the Express Connect circuit. Normal: Normal. FinancialLocked: locked due to overdue payment.	Normal
Description	string	The description of the VBR.	desc
TerminationTime	string	The time when the VBR was last terminated.	2021-06-08T12:20:55
MinRxInterval	integer	The receive interval of BFD packets. Valid values: 200 to 1000. Unit: ms.	300
PeerGatewayIp	string	The IPv4 address of the VBR on the customer side.	192.168.XX.XX
Name	string	The name of the VBR instance.	test
VbrId	string	The instance ID of the VBR.	vbr-bp1jcg5cmxjbl9xgc****
VlanId	integer	The VLAN ID of the VBR instance.	10
VlanInterfaceId	string	The ID of the router interface of the VBR.	ri-2zeo3xzyf38r4xx****
CircuitCode	string	The circuit code provided by the carrier for the Express Connect circuit.	longtel0****
LocalIpv6GatewayIp	string	The IPv6 address of the VBR on the Alibaba Cloud side.	2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
LocalGatewayIp	string	The IPv4 address of the VBR on the Alibaba Cloud side.	192.168.XX.XX
PeeringSubnetMask	string	The subnet mask for the IPv4 addresses on the Alibaba Cloud side and the customer side of the VBR instance.	255.255.255.252
EnableIpv6	boolean	Indicates whether IPv6 is enabled. true: enabled. false: disabled.	false
RouteTableId	string	The route table ID of the VBR.	vtb-bp1****
DetectMultiplier	integer	The detection time multiplier. This is the maximum number of consecutive packet losses that the receiver allows from the sender, which is used to detect whether the link is normal. Valid values: 3 to 10.	3
EccId	string	The Express Cloud Connect instance ID.	ecc-h****
CloudBoxInstanceId	string	The CloudBox instance ID.	cb-****
RecoveryTime	string	The time when the VBR was last recovered from the terminated state to the active state.	2021-05-08T12:20:55
PhysicalConnectionStatus	string	The status of the Express Connect circuit. Initial: applying. Approved: approved. Allocating: allocating resources. Allocated: under construction. Confirmed: waiting for user confirmation. Enabled: enabled. Rejected: application rejected. Canceled: canceled. Allocation Failed: resource allocation failed. Terminated: terminated.	Normal
PeeringIpv6SubnetMask	string	The subnet mask for the IPv6 addresses on the Alibaba Cloud side and the customer side of the VBR instance.	2000:1234:0:a000::/55
AccessPointId	string	The ID of the access point for the Express Connect circuit.	ap-cn-kojok1x****
PConnVbrChargeType	string	The billing method of the VBR bound to the Express Connect circuit. PrePaid: subscription. If you select this billing method, make sure that your account supports balance payment or credit payment. PostPaid: pay-as-you-go.	PrePaid
PhysicalConnectionId	string	The ID of the Express Connect circuit to which the VBR belongs.	pc-119mfjzm7x****
AssociatedPhysicalConnections	object
AssociatedPhysicalConnection	array<object>	The information about the associated Express Connect circuit.
	object	The information about the associated Express Connect circuit.
Status	string	The instance status of the VBR. unconfirmed: waiting for confirmation from the other party. active: normal. terminating: stopping access. terminated: access stopped. recovering: being recovered. deleting: being deleted.	active
VlanInterfaceId	string	The router interface ID of the VBR, which can be used as the next hop of a VBR route.	ri-kojok19x3j0q6k****
CircuitCode	string	The circuit code provided by the carrier for the Express Connect circuit.	longtel0**
PeerIpv6GatewayIp	string	The IPv6 address of the VBR on the customer side.	2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
LocalIpv6GatewayIp	string	The IPv6 address of the VBR on the Alibaba Cloud side.	2001:XXXX:3c4d:0015:0000:0000:0000:1a2b
PhysicalConnectionOwnerUid	string	The ID of the account that owns the Express Connect circuit.	12345678****
LocalGatewayIp	string	The IPv4 address of the VBR on the Alibaba Cloud side.	192.168.XX.XX
PhysicalConnectionBusinessStatus	string	The business status of the Express Connect circuit. Normal: Normal. FinancialLocked: locked due to overdue payment.	Normal
PeeringSubnetMask	string	The subnet mask for the IPv4 addresses on the Alibaba Cloud side and the customer side of the VBR instance. The two IPv4 addresses must be in the same subnet.	255.255.255.252
EnableIpv6	boolean	Indicates whether IPv6 is enabled. true: enabled. false: disabled.	true
PhysicalConnectionStatus	string	The status of the Express Connect circuit. Initial: applying. Approved: approved. Allocating: allocating resources. Allocated: under construction. Confirmed: waiting for user confirmation. Enabled: enabled. Rejected: application rejected. Canceled: canceled. Allocation Failed: resource allocation failed. Terminated: terminated.	Enabled
PeerGatewayIp	string	The IPv4 address of the VBR on the customer side.	116.62.XX.XX
PeeringIpv6SubnetMask	string	The subnet mask for the IPv6 addresses on the Alibaba Cloud side and the customer side of the VBR instance. The two IPv6 addresses must be in the same subnet.	2408:4004:cc:400::/56
PhysicalConnectionId	string	The Express Connect circuit ID.	pc-119mfjzm7****
VlanId	string	The VLAN ID of the VBR instance.	0
AssociatedCens	object
AssociatedCen	array<object>	The information about the associated Cloud Enterprise Network (CEN) instance.
	object	The instance information.
CenOwnerId	integer	The ID of the account to which the CEN instance belongs.	1688000000000****
CenId	string	The CEN instance ID.	cen-kojok19xxx****
CenStatus	string	The CEN status. Attached: associated. Attaching: being associated. Detached: disassociated. Detaching: being disassociated. Empty: not associated.	Attached
Bandwidth	integer	The bandwidth of the VBR instance. Unit: Mbit/s.	50
ResourceGroupId	string	The resource group ID. For more information about resource groups, see What is a resource group?.	rg-acfmxazb4ph6aiy****
Tags	object
Tags	array<object>	The tags of the resource.
	object	The tag.
Key	string	The tag key of the resource.	FinanceDept
Value	string	The tag value of the resource.	FinanceJoshua
EcrId	string	The instance ID of the associated Express Connect Router (ECR).	ecr-7vrbqv9lcgvzqbwwkm
SitelinkEnable	boolean	Indicates whether business access between IDCs is allowed. Valid values: true: allowed. false: not allowed. Note If no value is specified, business access between IDCs is not allowed.	false
EcrAttatchStatus	string	The association status of the Express Connect Router (ECR). Attached: associated. Attaching: being associated. Detached: disassociated. Detaching: being disassociated. Empty: not associated.	Attached
EcrOwnerId	string	The ID of the Alibaba Cloud account that owns the ECR instance.	192732132151xxxx
Mtu	integer	The MTU value supported by the VBR. Valid values: 1500 and 8500.	1500

Examples

Success response

JSON format

{
  "RequestId": "DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1,
  "VirtualBorderRouterSet": {
    "VirtualBorderRouterType": [
      {
        "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": "vtb-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": {
          "AssociatedPhysicalConnection": [
            {
              "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": {
          "AssociatedCen": [
            {
              "CenOwnerId": 0,
              "CenId": "cen-kojok19xxx****",
              "CenStatus": "Attached"
            }
          ]
        },
        "Bandwidth": 50,
        "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
        "Tags": {
          "Tags": [
            {
              "Key": "FinanceDept",
              "Value": "FinanceJoshua"
            }
          ]
        },
        "EcrId": "ecr-7vrbqv9lcgvzqbwwkm",
        "SitelinkEnable": false,
        "EcrAttatchStatus": "Attached",
        "EcrOwnerId": "192732132151xxxx",
        "Mtu": 1500
      }
    ]
  }
}

Error codes

HTTP status code	Error code	Error message	Description
400	OperationFailed.InternalError	The request processing has failed due to some unknown error.	Unknown error. Please retry the operation. The error still exists. Please submit the work order for processing.
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	The parameter is invalid.
404	InvalidFilterKey.ValueNotSupported	Specified filter key is not supported: Filter.X.key	Filter.X.key is not supported.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.