すべてのプロダクト
Search

このプロダクト

    Express Connect:DescribeVirtualBorderRouters

    ドキュメントセンター

    Express Connect:DescribeVirtualBorderRouters

    最終更新日:Aug 12, 2026

    作成済みの仮想ボーダールーター (VBR) を照会します。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    vpc:DescribeVirtualBorderRouters

    list

    *VirtualBorderRouter

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    VBR のリージョン ID。 DescribeRegions 操作を呼び出してリージョン ID をクエリできます。

    cn-shanghai
    PageNumber

    integer

    任意

    リストのページ番号。デフォルト値: 1。

    1
    PageSize

    integer

    任意

    ページングクエリにおける 1 ページあたりのエントリ数。最大値: 50。デフォルト値: 10。

    10
    Filter

    array<object>

    任意

    フィルターフォーマット。

    object

    任意

    フィルターフォーマット。

    Key

    string

    任意

    フィルター条件。最大 5 つのフィルター条件を指定できます。以下のフィルター条件がサポートされています:

    Status
    Value

    array

    任意

    指定された Key に基づくフィルター値。1 つの Key に対して複数のフィルター値を指定できます。複数のフィルター値の関係は OR であり、いずれかのフィルター値に一致すれば、そのフィルター条件に一致したとみなされます。

    Active

    string

    任意

    指定された Key に基づくフィルター値。1 つの Key に対して複数のフィルター値を指定できます。複数のフィルター値の関係は OR であり、いずれかのフィルター値に一致すれば、そのフィルター条件に一致したとみなされます。

    Active
    IncludeCrossAccountVbr

    boolean

    任意

    クロスアカウントの仮想ボーダールーターを含めるかどうかを指定します。

    • true: 含めます。

    • false (デフォルト): 含めません。

    false
    ResourceGroupId

    string

    任意

    リソースグループの ID。

    rg-acfmxazb4ph6aiy****
    Tags

    array<object>

    任意

    リソースのタグ。

    object

    任意

    タグ。

    Key

    string

    任意

    リソースのタグキー。少なくとも 1 つのタグキーを指定する必要があり、最大 20 個のタグキーを指定できます。タグキーを空文字列にすることはできません。

    FinanceDept
    Value

    string

    任意

    リソースのタグ値。最大 20 個のタグ値を指定できます。タグ値は空文字列にできます。

    タグ値の長さは最大 128 文字で、aliyun または acs: で始まることはできません。また、http:// または https:// を含めることはできません。

    FinanceJoshua

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    Virtual Border Router (VBR) の情報。

    RequestId

    string

    リクエスト ID。

    DE77A7F3-3B74-41C0-A5BC-CAFD188C28B6
    PageNumber

    integer

    リストのページ番号。デフォルト値: 1。

    1
    PageSize

    integer

    ページングクエリにおける 1 ページあたりのエントリ数。最大値: 50。デフォルト値: 10。

    10
    TotalCount

    integer

    返されたエントリの総数。

    1
    VirtualBorderRouterSet

    object

    VirtualBorderRouterType

    array<object>

    VBR のリスト。

    array<object>

    VBR の作成時間。

    CreationTime

    string

    VBR が作成された時間。

    2020-06-08T12:20:55
    Status

    string

    VBR のインスタンスステータス。

    • unconfirmed: 相手からの確認待ち。

    • active: アクティブな。

    • terminating: アクセス停止中。

    • terminated: アクセス停止済み。

    • recovering: 復旧中。

    • deleting: 削除中。

    active
    Type

    string

    VBR のタイプ。

    pconnVBR
    MinTxInterval

    integer

    双方向転送検出 (BFD) パケットを送信するための通知間隔。有効な値: 200 ～ 1000。単位: ms。

    300
    PeerIpv6GatewayIp

    string

    ユーザー側の VBR の IPv6 アドレス。

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

    string

    課金対象 VBR の有効期限時間。

    2021-06-08T12:20:55
    PhysicalConnectionOwnerUid

    string

    Express Connect 回線が属するアカウントの ID。

    1688000000000****
    ActivationTime

    string

    VBR が最初に有効化された時間。

    2021-06-08T12:20:55
    PhysicalConnectionBusinessStatus

    string

    Express Connect 回線のビジネスステータス。

    • Normal: 法線。

    • FinancialLocked: 支払い遅延によりロック済み。

    Normal
    Description

    string

    VBR の説明。

    desc
    TerminationTime

    string

    VBR が最後に終了した時間。

    2021-06-08T12:20:55
    MinRxInterval

    integer

    BFD パケットの受信間隔。有効な値: 200 ～ 1000。単位: ms。

    300
    PeerGatewayIp

    string

    ユーザー側の VBR の IPv4 アドレス。

    192.168.XX.XX
    Name

    string

    VBR インスタンスの名前。

    test
    VbrId

    string

    VBR のインスタンス ID。

    vbr-bp1jcg5cmxjbl9xgc****
    VlanId

    integer

    VBR インスタンスの VLAN ID。

    10
    VlanInterfaceId

    string

    VBR のルーターインターフェイスの ID。

    ri-2zeo3xzyf38r4xx****
    CircuitCode

    string

    Express Connect 回線に対してキャリアから提供された回線コード。

    longtel0****
    LocalIpv6GatewayIp

    string

    Alibaba Cloud 側の VBR の IPv6 アドレス。

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

    string

    Alibaba Cloud 側の VBR の IPv4 アドレス。

    192.168.XX.XX
    PeeringSubnetMask

    string

    VBR インスタンスの Alibaba Cloud 側およびユーザー側の IPv4 アドレスのサブネットマスク。

    255.255.255.252
    EnableIpv6

    boolean

    IPv6 が有効かどうかを示します。

    • true: 有効。

    • false: 無効。

    false
    RouteTableId

    string

    VBR のルートテーブル ID。

    vtb-bp1****
    DetectMultiplier

    integer

    検出時間の乗数。

    これは、リンクが正常かどうかを検出するために使用される、送信者からの連続パケット損失を受信者が許可する最大値です。

    有効な値: 3 ～ 10。

    3
    EccId

    string

    Express Cloud Connect インスタンス ID。

    ecc-h****
    CloudBoxInstanceId

    string

    CloudBox インスタンス ID。

    cb-****
    RecoveryTime

    string

    VBR が terminated 状態から アクティブな 状態に最後に復旧した時間。

    2021-05-08T12:20:55
    PhysicalConnectionStatus

    string

    Express Connect 回線のステータス。

    • Initial: アプリケーション申請中。

    • Approved: 承認済み。

    • Allocating: リソース割り当て中。

    • Allocated: 構築中。

    • Confirmed: ユーザーの確認待ち。

    • Enabled: 有効。

    • Rejected: アプリケーション却下。

    • Canceled: キャンセル済み。

    • Allocation Failed: リソース割り当て失敗した。

    • Terminated: 終了済み。

    Normal
    PeeringIpv6SubnetMask

    string

    VBR インスタンスの Alibaba Cloud 側およびユーザー側の IPv6 アドレスのサブネットマスク。

    2000:1234:0:a000::/55
    AccessPointId

    string

    Express Connect 回線のアクセスポイントの ID。

    ap-cn-kojok1x****
    PConnVbrChargeType

    string

    Express Connect 回線にバインドされている VBR の課金方法。

    • PrePaid: サブスクリプション。この課金方法を選択する場合は、アカウントが残高払いまたはクレジット払いに対応していることを確認してください。

    • PostPaid: 従量課金。

    PrePaid
    PhysicalConnectionId

    string

    VBR が属する Express Connect 回線の ID。

    pc-119mfjzm7x****
    AssociatedPhysicalConnections

    object

    AssociatedPhysicalConnection

    array<object>

    関連付けられた Express Connect 回線に関する情報。

    object

    関連付けられた Express Connect 回線に関する情報。

    Status

    string

    VBR のインスタンスステータス。

    • unconfirmed: 相手からの確認待ち。

    • active: アクティブな。

    • terminating: アクセス停止中。

    • terminated: アクセス停止済み。

    • recovering: 復旧中。

    • deleting: 削除中。

    active
    VlanInterfaceId

    string

    VBR のルーターインターフェイス ID。VBR ルートのネクストホップとして使用できます。

    ri-kojok19x3j0q6k****
    CircuitCode

    string

    Express Connect 回線に対してキャリアから提供された回線コード。

    longtel0**
    PeerIpv6GatewayIp

    string

    ユーザー側の VBR の IPv6 アドレス。

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

    string

    Alibaba Cloud 側の VBR の IPv6 アドレス。

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

    string

    Express Connect 回線を所有するアカウントの ID。

    12345678****
    LocalGatewayIp

    string

    Alibaba Cloud 側の VBR の IPv4 アドレス。

    192.168.XX.XX
    PhysicalConnectionBusinessStatus

    string

    Express Connect 回線のビジネスステータス。

    • Normal: 法線。

    • FinancialLocked: 支払い遅延によりロック済み。

    Normal
    PeeringSubnetMask

    string

    VBR インスタンスの Alibaba Cloud 側およびユーザー側の IPv4 アドレスのサブネットマスク。

    2 つの IPv4 アドレスは同じサブネット内にある必要があります。

    255.255.255.252
    EnableIpv6

    boolean

    IPv6 が有効かどうかを示します。

    • true: 有効。

    • false: 無効。

    true
    PhysicalConnectionStatus

    string

    Express Connect 回線のステータス。

    • Initial: アプリケーション申請中。

    • Approved: 承認済み。

    • Allocating: リソース割り当て中。

    • Allocated: 構築中。

    • Confirmed: ユーザーの確認待ち。

    • Enabled: 有効。

    • Rejected: アプリケーション却下。

    • Canceled: キャンセル済み。

    • Allocation Failed: リソース割り当て失敗した。

    • Terminated: 終了済み。

    Enabled
    PeerGatewayIp

    string

    ユーザー側の VBR の IPv4 アドレス。

    116.62.XX.XX
    PeeringIpv6SubnetMask

    string

    VBR インスタンスの Alibaba Cloud 側およびユーザー側の IPv6 アドレスのサブネットマスク。

    2 つの IPv6 アドレスは同じサブネット内にある必要があります。

    2408:4004:cc:400::/56
    PhysicalConnectionId

    string

    Express Connect 回線 ID。

    pc-119mfjzm7****
    VlanId

    string

    VBR インスタンスの VLAN ID。

    0
    AssociatedCens

    object

    AssociatedCen

    array<object>

    関連付けられた Cloud Enterprise Network (CEN) インスタンスに関する情報。

    object

    インスタンス情報。

    CenOwnerId

    integer

    CEN インスタンスが属するアカウントの ID。

    1688000000000****
    CenId

    string

    CEN インスタンス ID。

    cen-kojok19xxx****
    CenStatus

    string

    CEN ステータス。

    • Attached: 関連付け済み。

    • Attaching: 関連付け中。

    • Detached: 関連付け解除済み。

    • Detaching: 関連付け解除中。

    • Empty: 関連付けなし。

    Attached
    Bandwidth

    integer

    VBR インスタンスの帯域幅。単位: Mbit/s。

    50
    ResourceGroupId

    string

    リソースグループ ID。

    リソースグループの詳細については、「リソースグループとは」をご参照ください。

    rg-acfmxazb4ph6aiy****
    Tags

    object

    Tags

    array<object>

    リソースのタグ。

    object

    タグ。

    Key

    string

    リソースのタグキー。

    FinanceDept
    Value

    string

    リソースのタグ値。

    FinanceJoshua
    EcrId

    string

    関連付けられた Express Connect Router (ECR) のインスタンス ID。

    ecr-7vrbqv9lcgvzqbwwkm
    SitelinkEnable

    boolean

    IDC 間のビジネスアクセスが許可されているかどうかを示します。有効な値:

    • true: 許可。

    • false: 不許可。

    説明

    値が指定されていない場合、IDC 間のビジネスアクセスは許可されません。

    false
    EcrAttatchStatus

    string

    Express Connect Router (ECR) の関連付けステータス。

    • Attached: 関連付け済み。

    • Attaching: 関連付け中。

    • Detached: 関連付け解除済み。

    • Detaching: 関連付け解除中。

    • Empty: 関連付けなし。

    Attached
    EcrOwnerId

    string

    ECR インスタンスを所有する Alibaba Cloud アカウントの ID。

    192732132151xxxx
    Mtu

    integer

    VBR でサポートされる MTU 値。有効な値: 1500 および 8500。

    1500

    例

    成功レスポンス

    JSONJSON

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

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 OperationFailed.InternalError The request processing has failed due to some unknown error. 不明なエラーが発生しました。操作を再試行してください。エラーが解決しない場合は、チケットを起票してください。
    404 InvalidRegionId.NotFound The RegionId provided does not exist in our records. パラメーターが無効です。
    404 InvalidFilterKey.ValueNotSupported Specified filter key is not supported: Filter.X.key フィルターのキーはサポートされていません: Filter.X.key。

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。