全部產品
Search

搜尋本產品

    Express Connect：DescribeVirtualBorderRoutersForPhysicalConnection - 查詢邊界路由器（VBR）

    文件中心

    Express Connect：DescribeVirtualBorderRoutersForPhysicalConnection - 查詢邊界路由器（VBR）

    更新時間：Apr 27, 2026

    查詢指定物理專線下的邊界路由器（VBR），包括物理專線所有者的VBR和其他帳號的VBR。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    當前API暫無授權資訊透出。

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    物理專線所在的地區。 您可以通過調用 DescribeRegions 介面擷取地區 ID。

    cn-shanghai
    PhysicalConnectionId

    string

    是

    物理專線的 ID。

    pc-119mfj****
    PageNumber

    integer

    否

    列表的頁碼，預設值為 1。

    1
    PageSize

    integer

    否

    分頁查詢時每頁的行數，最大值為 50。預設值為 10。

    10
    Filter

    array<object>

    否

    過濾條件列表。

    object

    否

    過濾條件列表。

    Key

    string

    否

    過濾條件，最多可提供 5 個過濾條件。支援如下過濾條件：

    • PhysicalConnectionId：物理專線執行個體 ID。

    • VbrId：邊界路由器執行個體 ID。

    • Status：邊界路由器狀態。

    • Name：邊界路由器名稱。

    • AccessPointId：存取點 ID。

    • eccId：Express Cloud Connect執行個體 ID。

    • type：邊界路由器類型。

    Status
    Value

    array

    否

    根據 Key 指定過濾值。一個 Key 支援指定多個過濾值，每個過濾值之間是或的關係，即只要符合其中一個過濾值，則視為匹配該過濾條件。

    Active

    string

    否

    根據 Key 指定過濾值。一個 Key 支援指定多個過濾值，每個過濾值之間是或的關係，即只要符合其中一個過濾值，則視為匹配該過濾條件。

    Active

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

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

    integer

    列表的頁碼，預設值為 1。

    1
    PageSize

    integer

    分頁查詢時每頁的行數，最大值：50。預設值：10。

    10
    TotalCount

    integer

    列表條目數。

    1
    VirtualBorderRouterForPhysicalConnectionSet

    object

    VirtualBorderRouterForPhysicalConnectionType

    array<object>

    查詢到的 VBR 執行個體資訊合集。

    object

    Status

    string

    VBR 執行個體狀態。取值：

    • unconfirmed：等待他人確認。

    • active：正常。

    • terminating：終止接入中。

    • terminated：已終止接入。

    • recovering：恢複中。

    • deleting：刪除中。

    Active
    CreationTime

    string

    建立 VBR 的時間。

    2021-06-08T12:20:55
    Type

    string

    VBR 類型。

    pconnVBR
    PeerIpv6GatewayIp

    string

    VBR 執行個體的客戶側互聯 IPv6 地址。

    為物理專線所有者建立 VBR 執行個體時必填，為其他帳號建立 VBR 執行個體時無需填寫。

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

    string

    電訊廠商為物理專線提供的電路編碼。

    longtel0**
    LocalIpv6GatewayIp

    string

    VBR 執行個體的阿里雲側互聯 IPv6 地址。

    ipv6bw-uf6hcyzu65v98v3du****
    PConnVbrExpireTime

    string

    物理專線綁定的 VBR 到期時間。

    2021-06-10T12:20:55
    LocalGatewayIp

    string

    VBR 執行個體的阿里雲側互聯 IPv4 地址。

    192.168.XX.X
    BandwidthStatus

    string

    頻寬生效狀態。取值：

    • Active：正常。

    • Inactive：異常。

    Active
    ActivationTime

    string

    VBR 第一次啟用的時間。

    2021-06-08T12:20:55
    VbrOwnerUid

    integer

    VBR 所有者的帳號 ID。

    VBR 和物理專線的所有者相同時該參數為空白。

    253460731706911258
    PeeringSubnetMask

    string

    VBR 執行個體的阿里雲側和客戶側互聯 IPv4 的子網路遮罩。

    兩個 IPv4 地址必須位於同一個子網。

    255.255.255.0
    EnableIpv6

    boolean

    是否啟用 IPv6。取值：

    • true：開啟。

    • false：關閉。

    true
    EccId

    string

    Express Cloud Connect執行個體 ID。

    ecc-sjghe****
    Bandwidth

    string

    物理專線下綁定的邊界路由器頻寬值，單位：Mbps。

    10
    RecoveryTime

    string

    VBR 最近一次從 Terminated 狀態恢複到 Active 狀態的時間。

    2021-06-08T12:20:55
    TerminationTime

    string

    VBR 最近一次被終止的時間。

    2021-06-07T12:20:55
    PConnVbrBussinessStatus

    string

    物理專線綁定的 VBR 運行狀態。取值：

    • Normal：正常。

    • FinancialLocked：欠費鎖定。

    Normal
    PeerGatewayIp

    string

    VBR 執行個體的客戶側互聯 IPv4 地址。

    162.62.XX.XX
    PeeringIpv6SubnetMask

    string

    VBR 執行個體的阿里雲側和客戶側互聯 IPv6 的子網路遮罩。

    兩個 IPv6 地址必須位於同一個子網。

    2408:4004:cc:400::/56
    VbrId

    string

    VBR 執行個體 ID。

    vbr-bp16ksp61j7e0tk****
    PConnVbrChargeType

    string

    物理專線綁定的邊界路由器付費類型。取值：

    • PrePaid：預付費，訂用帳戶。選擇該類付費方式時，您必須確認自己的帳號支援餘額支付或信用支付。

    • PostPaid：隨用隨付。

    PrePaid
    VlanId

    integer

    VBR 執行個體的 VLAN ID。

    1678
    VbrName

    string

    VBR 執行個體名稱。

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

    樣本

    正常返回樣本

    JSON格式

    {
  "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"
      }
    ]
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 InvalidPhysicalConnectionId.NotFound The specified physicalConnection is not found. 沒有找到此專線ID對應的物理專線。
    404 InvalidRegionId.NotFound The RegionId provided does not exist in our records. 指定的RegionId不存在
    404 InvalidPhysicalConnectionId.NotFound The specified PhysicalConnectionId does not belong to user.

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。