すべてのプロダクト
Search

このプロダクト

    Express Connect:DescribeVirtualBorderRoutersForPhysicalConnection

    ドキュメントセンター

    Express Connect:DescribeVirtualBorderRoutersForPhysicalConnection

    最終更新日:Apr 27, 2026

    指定された Express Connect 回線インターフェイス配下の仮想ボーダールータ (VBR) を照会します。これには、Express Connect 回線インターフェイスの所有者が所有する VBR および他のアカウントに属する VBR が含まれます。

    今すぐお試しください

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

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    Express Connect 回線インターフェイスがデプロイされているリージョンです。DescribeRegions 操作を呼び出して、リージョン ID を取得できます。

    cn-shanghai
    PhysicalConnectionId

    string

    必須

    Express Connect 回線の ID です。

    pc-119mfj****
    PageNumber

    integer

    任意

    ページ番号です。デフォルト値は 1 です。

    1
    PageSize

    integer

    任意

    1 ページあたりのエントリ数です。最大値は 50、デフォルト値は 10 です。

    10
    Filter

    array<object>

    任意

    フィルター条件のキーです。

    object

    任意

    フィルター条件のリストです。

    Key

    string

    任意

    フィルター条件です。最大 5 つのフィルター条件を指定できます。サポートされるフィルター条件は以下のとおりです。

    • PhysicalConnectionId：Express Connect 回線インターフェイス ID で VBR をフィルターします。

    • VbrId：ID で VBR をフィルターします。

    • Status：ステータスで VBR をフィルターします。

    • Name：名前で VBR をフィルターします。

    • AccessPointId：アクセスポイント ID で VBR をフィルターします。

    • eccId：Express Cloud Connect (ECC) インスタンスの ID で VBR をフィルターします。

    • type：タイプで VBR をフィルターします。

    Status
    Value

    array

    任意

    キーに対するフィルター値です。1 つのキーに対して複数のフィルター値を指定できます。フィルター値間の論理演算子は OR です。いずれかのフィルター値が一致すれば、フィルター条件は一致したものとみなされます。

    Active

    string

    任意

    キーに対するフィルター値です。1 つのキーに対して複数のフィルター値を指定できます。フィルター値間の論理演算子は OR です。いずれかのフィルター値が一致すれば、フィルター条件は一致したものとみなされます。

    Active

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    RequestId

    string

    リクエスト ID です。

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

    integer

    ページ番号です。デフォルト値は 1 です。

    1
    PageSize

    integer

    1 ページあたりのエントリ数です。最大値は 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

    ユーザー側のゲートウェイデバイスの IPv6 アドレスです。

    このパラメーターは、Express Connect 回線インターフェイスの所有者向けに VBR を作成する場合に必須です。他の Alibaba Cloud アカウント向けに VBR を作成する場合は、このパラメーターを無視できます。

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

    string

    Express Connect 回線の回線コードです。回線コードは接続プロバイダーによって提供されます。

    longtel0**
    LocalIpv6GatewayIp

    string

    Alibaba Cloud 側のゲートウェイデバイスの IPv6 アドレスです。

    ipv6bw-uf6hcyzu65v98v3du****
    PConnVbrExpireTime

    string

    Express Connect 回線インターフェイスに関連付けられた VBR の有効期限切れ時刻です。

    2021-06-10T12:20:55
    LocalGatewayIp

    string

    Alibaba Cloud 側のゲートウェイデバイスの IPv4 アドレスです。

    192.168.XX.X
    BandwidthStatus

    string

    帯域幅のステータスです。有効な値は以下のとおりです。

    • Active

    • Inactive

    Active
    ActivationTime

    string

    VBR が初めてアクティブになった時刻です。

    2021-06-08T12:20:55
    VbrOwnerUid

    integer

    VBR が属する Alibaba Cloud アカウントの ID です。

    VBR の所有者が Express Connect 回線インターフェイスの所有者と同じである場合、このパラメーターは空になります。

    253460731706911258
    PeeringSubnetMask

    string

    ユーザー側および Alibaba Cloud 側で設定された IPv4 アドレスのサブネットマスクです。

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

    255.255.255.0
    EnableIpv6

    boolean

    IPv6 が有効かどうかを示します。有効な値は以下のとおりです。

    • true

    • false

    true
    EccId

    string

    ECC インスタンスの ID です。

    ecc-sjghe****
    Bandwidth

    string

    Express Connect 回線インターフェイスに関連付けられた VBR の帯域幅です。単位は Mbit/s です。

    10
    RecoveryTime

    string

    VBR のステータスが Terminated から Active に変更された最新の時刻です。

    2021-06-08T12:20:55
    TerminationTime

    string

    VBR が無効化された最新の時刻です。

    2021-06-07T12:20:55
    PConnVbrBussinessStatus

    string

    Express Connect 回線に関連付けられた VBR のステータスです。有効な値は以下のとおりです。

    • Normal

    • FinancialLocked

    Normal
    PeerGatewayIp

    string

    ユーザー側のゲートウェイデバイスの IPv4 アドレスです。

    162.62.XX.XX
    PeeringIpv6SubnetMask

    string

    Alibaba Cloud 側およびユーザー側のゲートウェイデバイスの IPv6 アドレス用のサブネットマスクです。

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

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

    string

    VBR ID です。

    vbr-bp16ksp61j7e0tk****
    PConnVbrChargeType

    string

    VBR の課金方法です。有効な値は以下のとおりです。

    • PrePaid：サブスクリプション。この課金方法を選択する場合、ご利用の Apsara Stack アカウントが残高支払いまたは与信支払いをサポートしていることをご確認ください。

    • PostPaid：従量課金。

    PrePaid
    VlanId

    integer

    VBR の VLAN ID です。

    1678
    VbrName

    string

    VBR インスタンスの名前です。

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

    例

    成功レスポンス

    JSONJSON

    {
  "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 ステータスコード

    エラーコード

    エラーメッセージ

    説明
    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.

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

    変更履歴

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