All Products
Search
Document Center

Express Connect:DescribeVirtualBorderRoutersForPhysicalConnection

Last Updated:Jun 12, 2026

Mengkueri Virtual Border Router (VBR) di bawah sirkuit Express Connect tertentu, termasuk VBR yang dimiliki oleh pemilik sirkuit dan VBR yang dimiliki oleh akun lain.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

RegionId

string

Yes

Wilayah tempat sirkuit Express Connect berada. Anda dapat memanggil operasi DescribeRegions untuk mengkueri ID wilayah.

cn-shanghai

PhysicalConnectionId

string

Yes

ID sirkuit Express Connect.

pc-119mfj****

PageNumber

integer

No

Nomor halaman daftar. Nilai default: 1.

1

PageSize

integer

No

Jumlah entri per halaman dalam kueri berhalaman. Nilai maksimum: 50. Nilai default: 10.

10

Filter

array<object>

No

Daftar kondisi filter.

object

No

Daftar kondisi filter.

Key

string

No

Kondisi filter. Anda dapat menentukan hingga 5 kondisi filter. Kondisi filter berikut didukung:

  • PhysicalConnectionId: ID instans sirkuit Express Connect.

  • VbrId: ID instans Virtual Border Router.

  • Status: status Virtual Border Router.

  • Name: nama Virtual Border Router.

  • AccessPointId: ID instans titik akses.

  • eccId: ID instans Express Cloud Connect.

  • type: tipe Virtual Border Router.

Status

Value

array

No

Nilai filter berdasarkan Key yang ditentukan. Anda dapat menentukan beberapa nilai filter untuk satu Key. Hubungan antar nilai filter adalah OR, yang berarti kecocokan dengan salah satu nilai filter dianggap sebagai kecocokan untuk kondisi filter.

Active

string

No

Nilai filter berdasarkan Key yang ditentukan. Anda dapat menentukan beberapa nilai filter untuk satu Key. Hubungan antar nilai filter adalah OR, yang berarti kecocokan dengan salah satu nilai filter dianggap sebagai kecocokan untuk kondisi filter.

Active

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

7C5AE8B3-A2D8-428D-A2FF-93A225C0821E

PageNumber

integer

Nomor halaman daftar. Nilai default: 1.

1

PageSize

integer

Jumlah entri per halaman dalam kueri berhalaman. Nilai maksimum: 50. Nilai default: 10.

10

TotalCount

integer

Jumlah total entri dalam daftar.

1

VirtualBorderRouterForPhysicalConnectionSet

object

VirtualBorderRouterForPhysicalConnectionType

array<object>

Kumpulan informasi instans VBR yang dikueri.

object

Status

string

The status of the VBR. Valid values:

  • unconfirmed

  • active

  • terminating

  • terminated

  • recovering

  • deleting

Active

CreationTime

string

The time when the VBR was created.

2021-06-08T12:20:55

Type

string

The VBR type.

pconnVBR

PeerIpv6GatewayIp

string

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

This parameter is required when you create a VBR for the owner of the Express Connect circuit. You can ignore this parameter when you create a VBR for another Alibaba Cloud account.

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

CircuitCode

string

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

longtel0**

LocalIpv6GatewayIp

string

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

ipv6bw-uf6hcyzu65v98v3du****

PConnVbrExpireTime

string

The time when the VBR associated with the Express Connect circuit expires.

2021-06-10T12:20:55

LocalGatewayIp

string

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

192.168.XX.X

BandwidthStatus

string

The status of the bandwidth. Valid values:

  • Active

  • Inactive

Active

ActivationTime

string

The time when the VBR was first activated.

2021-06-08T12:20:55

VbrOwnerUid

integer

The ID of the Alibaba Cloud account to which the VBR belongs.

If the owner of the VBR is the same as that of the Express Connect circuit, this parameter is empty.

253460731706911258

PeeringSubnetMask

string

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

The two IPv4 addresses must fall within the same subnet.

255.255.255.0

EnableIpv6

boolean

Indicates whether IPv6 is enabled. Valid values:

  • true

  • false

true

EccId

string

The ID of the ECC instance.

ecc-sjghe****

Bandwidth

string

The bandwidth of the VBR that is associated with the Express Connect circuit. Unit: Mbit/s.

10

RecoveryTime

string

The last time when the status of the VBR changed from Terminated to Active.

2021-06-08T12:20:55

TerminationTime

string

The last time when the VBR was disabled.

2021-06-07T12:20:55

PConnVbrBussinessStatus

string

The status of the VBR associated with the Express Connect circuit. Valid values:

  • Normal

  • FinancialLocked

Normal

PeerGatewayIp

string

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

162.62.XX.XX

PeeringIpv6SubnetMask

string

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.

2408:4004:cc:400::/56

VbrId

string

The VBR ID.

vbr-bp16ksp61j7e0tk****

PConnVbrChargeType

string

The billing method of the VBR. Valid values:

  • PrePaid: subscription. If you choose this billing method, make sure that your Apsara Stack account supports balance payments or credit payments.

  • PostPaid: pay-as-you-go.

PrePaid

VlanId

integer

The VLAN ID of the VBR.

1678

VbrName

string

The name of the VBR instance.

aliyun-to-bin-10G-A-QOS

Contoh

Respons sukses

JSONformat

{
  "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,
        "VbrName": "aliyun-to-bin-10G-A-QOS"
      }
    ]
  }
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidPhysicalConnectionId.NotFound The specified physicalConnection is not found.
404 InvalidRegionId.NotFound The RegionId provided does not exist in our records.
404 InvalidPhysicalConnectionId.NotFound The specified PhysicalConnectionId does not belong to user.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.