すべてのプロダクト
Search

このプロダクト

    Express Connect:DescribePhysicalConnections

    ドキュメントセンター

    Express Connect:DescribePhysicalConnections

    最終更新日:Aug 25, 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 シフト。

      • 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: Express Connect 回線のタイプ。有効な値:

      • 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

    Express Connect 回線のタイプ。有効な値: VPC。

    VPC
    Status

    string

    Express Connect 回線のステータス。有効な値:

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

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

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

    • Allocated: 工事中です。

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

    • Enabled: 有効です。

    • Rejected: アプリケーションは却下されました。

    • Canceled: キャンセルされました。

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

    • Terminating: 終了処理中です。

    • Terminated: 終了しました。

    Enabled
    CreationTime

    string

    Express Connect 回線が作成された時間。時間は ISO 8601 標準の YYYY-MM-DDThh:mm:ssZ フォーマットで表示されます。時間は協定世界時 (UTC) で表示されます。

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

    string

    アクセスポイントにおける Express Connect 回線のアクセスデバイスの場所。

    Hangzhou City, Zhejiang Province, China
    ReservationActiveTime

    string

    保留中の注文の有効期間。時間は ISO 8601 標準の YYYY-MM-DDThh:mm:ssZ フォーマットで表示されます。時間は協定世界時 (UTC) で表示されます。

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

    string

    保留中の注文のタイプ。

    有効な値: RENEW (更新注文を示します)。

    RENEW
    PortNumber

    string

    Express Connect 回線のアクセスデバイスのポート番号。

    1/1/1
    Spec

    string

    Express Connect 回線のスペック。

    単位: G は Gbit/s を示します。

    10G
    ChargeType

    string

    Express Connect 回線の課金方法。

    有効な値: Prepaid (サブスクリプションを示します)。

    Prepaid
    ReservationInternetChargeType

    string

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

    有効な値: PayByBandwidth (帯域幅課金を示します)。

    PayByBandwidth
    Description

    string

    Express Connect 回線の説明。

    desctest
    Bandwidth

    integer

    Express Connect 回線の帯域幅。

    単位: Mbit/s。

    10
    EnabledTime

    string

    Express Connect 回線が有効化された時間。時間は ISO 8601 標準の YYYY-MM-DDThh:mm:ssZ フォーマットで表示されます。時間は協定世界時 (UTC) で表示されます。

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

    string

    Express Connect 回線の接続性プロバイダー。有効な値:

    • CT: China Telecom。

    • CU: China Unicom。

    • CM: China Mobile。

    • CO: その他の中国国内接続性プロバイダー。

    • Equinix: Equinix。

    • Other: 中国本土以外のその他の接続性プロバイダー。

    CT
    PeerLocation

    string

    オンプレミスデータセンターの地理的な場所。

    Hangzhou City, Zhejiang Province, China
    RedundantPhysicalConnectionId

    string

    冗長 Express Connect 回線の ID。

    pc-119mfjzm****
    Name

    string

    Express Connect 回線の名前。

    nametest
    CircuitCode

    string

    Express Connect 回線に対して接続性プロバイダーから提供された回線コード。

    longtel001
    EndTime

    string

    Express Connect 回線の有効期限。時間は ISO 8601 標準の YYYY-MM-DDThh:mm:ssZ フォーマットで表示されます。時間は協定世界時 (UTC) で表示されます。

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

    string

    Express Connect 回線のポートタイプ。有効な値:

    • 100Base-T: 100M Ethernet ポート。

    • 1000Base-T: 1 GE ポート。

    • 1000Base-LX: GE シングルモード光ポート (10 km)。

    • 10GBase-T: 10 GE ポート。

    • 10GBase-LR: 10 GE シングルモード光ポート (10 km)。

    • 40GBase-LR: 40 GE シングルモード光ポート。

    • 100GBase-LR: 100 GE シングルモード光ポート。

    説明

    40GBase-LR または 100GBase-LR を使用するには、アカウントマネージャーにポートの可用性を確認してください。

    10GBase-LR
    BusinessStatus

    string

    Express Connect 回線のビジネスステータス。有効な値:

    • Normal: 法線です。

    • FinancialLocked: 支払い遅延によりロックされています。

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

    法線
    LoaStatus

    string

    Letter of Authorization (LOA) のステータス。有効な値:

    • Applying: LOA アプリケーションは処理中です。

    • Accept: LOA アプリケーションは承認されました。

    • Available: LOA は利用可能です。

    • Rejected: LOA アプリケーションは却下されました。

    • Completing: 回線は工事中です。

    • Complete: 回線の工事は完了しました。

    • Deleted: LOA は削除されました。

    Available
    AccessPointId

    string

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

    ap-cn-hangzhou-金融-yh-E
    AccessPointType

    string

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

    VPC
    HasReservationData

    string

    Express Connect 回線に保留中の注文データがあるかどうかを示します。有効な値:

    • true: 回線に保留中の注文データがあります。

    • false: 回線に保留中の注文データがありません。

    false
    PhysicalConnectionId

    string

    Express Connect 回線のインスタンス ID。

    pc-bp1ciz7ekd2grn1as****
    ProductType

    string

    Express Connect 回線のタイプ。有効な値:

    • VirtualPhysicalConnection: 共有 Express Connect 回線。

    • PhysicalConnection: 専用 Express Connect 回線。

    PhysicalConnection
    VirtualPhysicalConnectionCount

    integer

    現在の Express Connect 回線上に作成された共有 Express Connect 回線の数。

    0
    ParentPhysicalConnectionId

    string

    共有 Express Connect 回線に関連付けられている Express Connect 回線のインスタンス ID。

    pc-bp1ciz7ekd2grn1as****
    ParentPhysicalConnectionAliUid

    integer

    共有 Express Connect 回線に関連付けられている Express Connect 回線のオーナーの Alibaba Cloud アカウント ID。

    132193271328****
    VlanId

    string

    共有 Express Connect 回線の VLAN ID。

    10
    OrderMode

    string

    共有 Express Connect 回線の支払者。有効な値:

    • PayByPhysicalConnectionOwner: パートナーが支払者です。

    • PayByVirtualPhysicalConnectionOwner: テナントが支払者です。

    PayByPhysicalConnectionOwner
    VpconnStatus

    string

    共有 Express Connect 回線のビジネスステータス。有効な値:

    • Confirmed: 共有 Express Connect 回線は承諾されました。

    • UnConfirmed: 共有 Express Connect 回線は承諾されていません。

    • Deleted: 共有 Express Connect 回線は削除されました。

    Confirmed
    ExpectSpec

    string

    共有 Express Connect 回線の予想帯域幅。予想帯域幅は、支払い完了後に効果が有効になります。

    単位: M は Mbit/s、G は Gbit/s を示します。

    50M
    ResourceGroupId

    string

    リソースグループの ID。

    rg-acfmwu3k52p****
    AdDetailLocation

    string

    データセンターおよびラックの情報。

    Hangzhou City, Zhejiang Province, XX Data Center, Room ET135ET135-XX-2, Rack JXX, Position 30
    Tags

    object

    tags

    array<object>

    タグのリスト。

    object

    タグのリスト。

    Key

    string

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

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

    FinanceDept
    Value

    string

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

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

    FinanceJoshua
    QosId

    string

    QoS ポリシーのインスタンス ID。

    qos-bp10s3szn8rgnxuw7****
    OpticalModuleModel

    string

    ユーザーが入力した光モジュールモデル。

    SFP-GE-LR-SM1310,10KM
    MacsecKeys

    object

    MacsecKey

    array<object>

    Express Connect 回線の MACSec キー情報のリスト。

    object

    Express Connect 回線の MACSec キー情報。

    CipherSuite

    string

    MACSec 暗号スイート。有効な値: ● GCM-AES-128 ● GCM-AES-XPN-128 ● GCM-AES-256 ● GCM-AES-XPN-256

    GCM-AES-128
    Ckn

    string

    キー名。

    0123456789ABCDEF0123456789ABCDEF
    Cak

    string

    キーシークレット。

    0123456789ABCDEF0123456789ABCDEF
    StartOn

    string

    キーが作成された時間。時間は ISO 8601 標準の YYYY-MM-DDThh:mm:ssZ フォーマットで表示されます。時間は協定世界時 (UTC) で表示されます。

    2026-04-13T00:00:00Z
    Status

    string

    キーのステータス。有効な値: ● Associating: 関連付け中です。 ● Associated: 関連付け済みです。 ● AssociatedFailed: 関連付けに失敗しました。 ● Disassociating: 関連付け解除中です。 ● Disassociated: 関連付け解除済みです。

    Associated
    DownDelayTime

    integer

    Express Connect 回線のポートダウン遅延時間 (ミリ秒単位)。物理リンクダウンイベントが検出されると、アクセスデバイスはこの持続時間待機してからポートをダウンステータスに設定します。これにより、一時的な切断がサービスに影響を与えるのを防ぎます。有効な値: 0～10000。ステップは 100 です。値 0 は、リンクダウン後にポートがすぐにダウンすることを示します (デフォルト)。ModifyPhysicalConnectionAttribute 操作を呼び出すことで、この値を変更できます。

    100
    DeviceFeaturesSelected

    string

    Express Connect 回線のアクセスデバイス用に選択された高度な機能のリスト。複数の機能はコンマ (,) で区切られます。

    BFD,MACSec,LinkDelay

    例

    成功レスポンス

    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": "Hangzhou City, Zhejiang Province, China",
        "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": "Hangzhou City, Zhejiang Province, China",
        "RedundantPhysicalConnectionId": "pc-119mfjzm****",
        "Name": "nametest",
        "CircuitCode": "longtel001",
        "EndTime": "2022-04-24T16:00:00Z",
        "PortType": "10GBase-LR",
        "BusinessStatus": "法線",
        "LoaStatus": "Available",
        "AccessPointId": "ap-cn-hangzhou-金融-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": "Hangzhou City, Zhejiang Province, XX Data Center, ET135ET135-XX-2 Room, JXX Rack, position30",
        "Tags": {
          "tags": [
            {
              "Key": "FinanceDept",
              "Value": "FinanceJoshua"
            }
          ]
        },
        "QosId": "qos-bp10s3szn8rgnxuw7****",
        "OpticalModuleModel": "SFP-GE-LR-SM1310,10KM",
        "MacsecKeys": {
          "MacsecKey": [
            {
              "CipherSuite": "GCM-AES-128",
              "Ckn": "0123456789ABCDEF0123456789ABCDEF",
              "Cak": "0123456789ABCDEF0123456789ABCDEF",
              "StartOn": "2026-04-13T00:00:00Z",
              "Status": "Associated"
            }
          ]
        },
        "DownDelayTime": 100,
        "DeviceFeaturesSelected": "BFD,MACSec,LinkDelay"
      }
    ]
  }
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 OperationUnsupported.ResourceGroupId ResourceGroupId in financial region is unsupported. この操作はサポートされていません。金融クラウドではリソースグループ ID はサポートされていません。
    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 フィルターのキーはサポートされていません: Filter.X.key。

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

    変更履歴

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