すべてのプロダクト
Search

このプロダクト

    Express Connect:DescribePhysicalConnections

    ドキュメントセンター

    Express Connect:DescribePhysicalConnections

    最終更新日:Jun 19, 2026

    指定されたリージョンの Express Connect 回線に関する情報を照会します。

    操作説明

    デフォルトでは、指定されたリージョン内のすべての Express Connect 回線の情報がクエリされます。DescribePhysicalConnections 操作が提供するフィルターオプションを使用して、特定の Express Connect 回線の情報をクエリできます。サポートされるフィルターオプションについては、この Topic のリクエストパラメーターセクションの Key の説明を参照してください。

    今すぐお試しください

    この 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:DescribePhysicalConnections

    list

    *PhysicalConnection

    acs:vpc:{#regionId}:{#accountId}:physicalconnection/*

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    RegionId

    string

    必須

    Express Connect 回線のリージョン ID。

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

    cn-hangzhou
    PageNumber

    integer

    任意

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

    1
    PageSize

    integer

    任意

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

    10
    IncludeReservationData

    boolean

    任意

    まだ効果が発生していない注文のデータを返すかどうかを指定します。有効な値:

    • true: まだ効果が発生していない注文のデータを返します。

    • false (デフォルト): まだ効果が発生していない注文のデータを返しません。

    false
    ClientToken

    string

    任意

    リクエストのべき等性を確保するために使用されるクライアントトークン。

    クライアントから異なるリクエスト間で一意性を確保するパラメーター値を生成してください。ClientToken は ASCII 文字のみをサポートしています。

    02fb3da4-130e-11e9-8e44-001
    Filter

    array<object>

    任意

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

    object

    任意

    フィルター条件。

    Key

    string

    任意

    フィルター条件。有効な値:

    • PhysicalConnectionId: Express Connect 回線 ID。

    • AccessPointId: アクセスポイント ID。

    • Type: Express Connect 回線タイプ。このフィルター条件は値 VPC のみをサポートしています。

    • LineOperator: Express Connect 回線のキャリア。このフィルター条件は以下の値をサポートしています:

      • CT: China Telecom。

      • CU: China Unicom。

      • CM: China Mobile。

      • CO: 中国国内のその他のキャリア。

      • Equinix: Equinix。

      • Other: 中国以外のその他のキャリア。

    • Spec: Express Connect 回線のスペック。このフィルター条件は以下の値をサポートしています:

      • 1G and below。

      • 10G。

      • 40G。

      • 100G。

    説明

    40G および 100G のスペックはデフォルトでは利用できません。アカウントマネージャーにアプリケーションを提出し、承認を受けたユーザーのみがこれらの値を使用できます。

    • Status: Express Connect 回線のステータス。このフィルター条件は以下の値をサポートしています:

      • Initial: アプリケーション保留中。

      • Approved: 承認済み。

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

      • Allocated: 建設中。

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

      • Enabled: 有効。

      • Rejected: アプリケーション拒否。

      • Canceled: キャンセル済み。

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

      • Terminating: 停止中。

      • Terminated: 停止済み。

    • Name: Express Connect 回線の名前。

    • ProductType: 回線タイプ。有効な値:

      • VirtualPhysicalConnection: 共有 Express Connect 回線。

      • PhysicalConnection: 専用 Express Connect 回線。

    一度に最大 5 つのフィルター条件を指定できます。フィルター条件は AND の関係を持ちます。すべてのフィルター条件が満たされた場合にのみ結果が返されます。

    Name
    Value

    array

    任意

    フィルター値のリスト。

    1

    string

    任意

    フィルター条件に対応するフィルター値。

    各フィルター条件は最大 5 つのフィルター値をサポートしています。複数のフィルター値は OR の関係を持ちます。いずれかのフィルター値に一致する Record は、そのフィルター条件に一致するとみなされます。

    nametest
    Tags

    array<object>

    任意

    タグのリスト。

    object

    任意

    タグのリスト。

    Key

    string

    任意

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

    タグキーは最大 64 文字の長さで、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

    FinanceDept
    Value

    string

    任意

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

    タグ値は最大 128 文字の長さで、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

    FinanceJoshua
    ResourceGroupId

    string

    任意

    Express Connect 回線が属するリソースグループの ID。

    rg-aek2yvwibxr****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答パラメーター。

    RequestId

    string

    リクエスト ID。

    0E6D0EC4-7C91-53E2-9F65-64BF713114B0
    PageNumber

    integer

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

    1
    PageSize

    integer

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

    10
    TotalCount

    integer

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

    1
    PhysicalConnectionSet

    object

    PhysicalConnectionType

    array<object>

    Express Connect 回線のリスト。

    array<object>

    Express Connect 回線の詳細。

    Type

    string

    物理接続のタイプです。有効値：VPC。

    VPC
    Status

    string

    物理接続のステータスです。有効値：

    • Initial：アプリケーションの審査中です。

    • Approved：アプリケーションが承認されました。

    • Allocating：リソースを割り当てています。

    • Allocated：物理接続を構築中です。

    • Confirmed：物理接続がご利用の確認待ちです。

    • Enabled：物理接続が有効です。

    • Rejected：アプリケーションが拒否されました。

    • Canceled：アプリケーションがキャンセルされました。

    • Allocation Failed：リソースの割り当てに失敗しました。

    • Terminating：物理接続を終了しています。

    • Terminated：物理接続が終了しました。

    Enabled
    CreationTime

    string

    物理接続が作成された時刻です。

    2021-08-24T07:30:58Z
    AdLocation

    string

    アクセスポイントの場所です。

    浙江省杭州市XX区XX镇XX路10号
    ReservationActiveTime

    string

    保留中の注文が有効になる時刻です。

    2022-02-25T11:01:04Z
    ReservationOrderType

    string

    保留中の注文のタイプです。

    有効値：RENEW（更新注文を示します）。

    RENEW
    PortNumber

    string

    アクセスデバイスのポート番号です。

    1/1/1
    Spec

    string

    物理接続の仕様です。

    単位：G（Gbps）。

    10G
    ChargeType

    string

    物理接続の課金方法です。

    有効値：Prepaid。

    Prepaid
    ReservationInternetChargeType

    string

    保留中の注文の課金方法です。

    有効値：PayByBandwidth。

    PayByBandwidth
    Description

    string

    物理接続の説明です。

    desctest
    Bandwidth

    integer

    物理接続の帯域幅です。

    単位：Mbps。

    10
    EnabledTime

    string

    物理接続が有効になった時刻です。

    2021-08-24T07:33:18Z
    LineOperator

    string

    物理接続を提供する回線オペレーターです。有効値：

    • CT：China Telecom。

    • CU：China Unicom。

    • CM：China Mobile。

    • CO：その他の中国国内回線オペレーター。

    • Equinix：Equinix。

    • Other：中国以外のその他の海外オペレーター。

    CT
    PeerLocation

    string

    ご利用のオンプレミスデータセンターの地理的位置です。

    浙江省杭州市XX区XX镇XX路XX号
    RedundantPhysicalConnectionId

    string

    冗長物理接続の ID です。

    pc-119mfjzm****
    Name

    string

    物理接続の名前です。

    nametest
    CircuitCode

    string

    回線オペレーターが提供する回線コードです。

    longtel001
    EndTime

    string

    物理接続の有効期限です。

    2022-04-24T16:00:00Z
    PortType

    string

    物理接続のポートタイプです。有効値：

    • 100Base-T：100 Mbps の電気ポート。

    • 1000Base-T：1 Gbps の電気ポート。

    • 1000Base-LX：1 Gbps のシングルモード光ポート（10 km）。

    • 10GBase-T：10 Gbps の電気ポート。

    • 10GBase-LR：10 Gbps のシングルモード光ポート（10 km）。

    • 40GBase-LR：40 Gbps のシングルモード光ポート。

    • 100GBase-LR：100 Gbps のシングルモード光ポート。

    説明

    40GBase-LR および 100GBase-LR のポートタイプは、ポートの可用性に応じて異なります。詳細については、アカウントマネージャーにお問い合わせください。

    10GBase-LR
    BusinessStatus

    string

    物理接続のビジネスステータスです。有効値：

    • Normal：物理接続は正常に動作しています。

    • FinancialLocked：支払い遅延により物理接続がロックされています。

    • SecurityLocked：セキュリティ上の理由により物理接続がロックされています。

    Normal
    LoaStatus

    string

    委任状 (LOA) のステータスです。有効値：

    • Applying：LOA の申請中です。

    • Accept：LOA の申請が承認されました。

    • Available：LOA が利用可能です。

    • Rejected：LOA の申請が拒否されました。

    • Completing：物理接続を構築中です。

    • Complete：物理接続の構築が完了しました。

    • Deleted：LOA が削除されました。

    Available
    AccessPointId

    string

    アクセスポイント ID です。

    ap-cn-hangzhou-finance-yh-E
    AccessPointType

    string

    アクセスポイントのタイプです。

    VPC
    HasReservationData

    string

    物理接続に保留中の注文が存在するかどうかを示します。有効値：

    • true

    • false

    false
    PhysicalConnectionId

    string

    物理接続 ID です。

    pc-bp1ciz7ekd2grn1as****
    ProductType

    string

    物理接続のタイプです。有効値：

    • VirtualPhysicalConnection：ホスト接続。

    • PhysicalConnection：専用物理接続。

    PhysicalConnection
    VirtualPhysicalConnectionCount

    integer

    物理接続上のホスト接続数です。

    0
    ParentPhysicalConnectionId

    string

    ホスト接続に関連付けられた専用物理接続の ID です。

    pc-bp1ciz7ekd2grn1as****
    ParentPhysicalConnectionAliUid

    integer

    専用物理接続を所有する Alibaba Cloud アカウントの ID です。

    132193271328****
    VlanId

    string

    ホスト接続の VLAN ID です。

    10
    OrderMode

    string

    ホスト接続の支払者です。有効値：

    • PayByPhysicalConnectionOwner：専用物理接続の所有者がホスト接続の料金を支払います。

    • PayByVirtualPhysicalConnectionOwner：ホスト接続の所有者がホスト接続の料金を支払います。

    PayByPhysicalConnectionOwner
    VpconnStatus

    string

    ホスト接続のビジネスステータスです。有効値：

    • Confirmed：ホスト接続が承認されました。

    • UnConfirmed：ホスト接続が承認待ちです。

    • Deleted：ホスト接続が削除されました。

    Confirmed
    ExpectSpec

    string

    支払い完了後に有効になるホスト接続の期待帯域幅です。

    単位：M（Mbps）、G（Gbps）。

    50M
    ResourceGroupId

    string

    リソースグループ ID です。

    rg-acfmwu3k52p****
    AdDetailLocation

    string

    データセンター、スイート、ラックに関する情報など、アクセスポイントの詳細な場所です。

    浙江省杭州市XX区XX镇XX路10号, XX机房, ET135ET135-XX-2包间, JXX机柜, position30
    Tags

    object

    tags

    array<object>

    タグのリストです。

    object

    タグの詳細です。

    Key

    string

    タグキーです。空文字列にすることはできません。

    キーの長さは最大 64 文字で、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。キーは aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

    FinanceDept
    Value

    string

    タグ値です。空文字列にできます。

    値の長さは最大 128 文字で、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を含めることができます。値は aliyun または acs: で始めることはできず、http:// または https:// を含めることはできません。

    FinanceJoshua
    QosId

    string

    サービス品質 (QoS) ポリシーの ID です。

    qos-bp10s3szn8rgnxuw7****
    OpticalModuleModel

    string

    MacsecKeys

    object

    MacsecKey

    array<object>

    object

    CipherSuite

    string

    Ckn

    string

    Cak

    string

    StartOn

    string

    Status

    string

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "0E6D0EC4-7C91-53E2-9F65-64BF713114B0",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 1,
  "PhysicalConnectionSet": {
    "PhysicalConnectionType": [
      {
        "Type": "VPC",
        "Status": "Enabled",
        "CreationTime": "2021-08-24T07:30:58Z",
        "AdLocation": "浙江省杭州市XX区XX镇XX路10号",
        "ReservationActiveTime": "2022-02-25T11:01:04Z",
        "ReservationOrderType": "RENEW",
        "PortNumber": "1/1/1",
        "Spec": "10G",
        "ChargeType": "Prepaid",
        "ReservationInternetChargeType": "PayByBandwidth",
        "Description": "desctest",
        "Bandwidth": 10,
        "EnabledTime": "2021-08-24T07:33:18Z",
        "LineOperator": "CT",
        "PeerLocation": "浙江省杭州市XX区XX镇XX路XX号",
        "RedundantPhysicalConnectionId": "pc-119mfjzm****",
        "Name": "nametest",
        "CircuitCode": "longtel001",
        "EndTime": "2022-04-24T16:00:00Z",
        "PortType": "10GBase-LR",
        "BusinessStatus": "Normal",
        "LoaStatus": "Available",
        "AccessPointId": "ap-cn-hangzhou-finance-yh-E",
        "AccessPointType": "VPC",
        "HasReservationData": "false",
        "PhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
        "ProductType": "PhysicalConnection",
        "VirtualPhysicalConnectionCount": 0,
        "ParentPhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
        "ParentPhysicalConnectionAliUid": 0,
        "VlanId": "10",
        "OrderMode": "PayByPhysicalConnectionOwner",
        "VpconnStatus": "Confirmed",
        "ExpectSpec": "50M",
        "ResourceGroupId": "rg-acfmwu3k52p****",
        "AdDetailLocation": "浙江省杭州市XX区XX镇XX路10号, XX机房, ET135ET135-XX-2包间, JXX机柜,  position30",
        "Tags": {
          "tags": [
            {
              "Key": "FinanceDept",
              "Value": "FinanceJoshua"
            }
          ]
        },
        "QosId": "qos-bp10s3szn8rgnxuw7****",
        "OpticalModuleModel": "",
        "MacsecKeys": {
          "MacsecKey": [
            {
              "CipherSuite": "",
              "Ckn": "",
              "Cak": "",
              "StartOn": "",
              "Status": ""
            }
          ]
        }
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 OperationUnsupported.ResourceGroupId ResourceGroupId in financial region is unsupported.
    400 InvalidTagKey.Malformed The specified tag key is invalid.
    400 OperationFailed.InternalError The request processing has failed due to some unknown error.
    404 InvalidFilterKey.ValueNotSupported Specified filter key is not supported: Filter.X.key

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

    変更履歴

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