すべてのプロダクト
Search

このプロダクト

    Express Connect:ListVirtualPhysicalConnections

    ドキュメントセンター

    Express Connect:ListVirtualPhysicalConnections

    最終更新日:Aug 25, 2026

    共有 Express Connect 回線の情報を照会します。

    今すぐお試しください

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

    list

    *PhysicalConnection。

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

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    PhysicalConnectionId

    string

    任意

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

    本 Topic の以降の内容では、共有 Express Connect 回線と区別するため、共有 Express Connect 回線に関連付けられている Express Connect 回線を単に Express Connect 回線と呼びます。

    pc-bp1ciz7ekd2grn1as****
    VirtualPhysicalConnectionBusinessStatus

    string

    任意

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

    • Normal: 法線。

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

    • SecurityLocked: セキュリティ上の理由によりロック済み。

    Normal
    VirtualPhysicalConnectionIds

    array

    任意

    共有 Express Connect 回線の情報。

    pc-xxx

    string

    任意

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

    複数のインスタンス ID を指定できます。N の有効な値: 1 ～ 20。

    pc-bp1mrgfbtmc9brre7****
    IsConfirmed

    boolean

    任意

    共有 Express Connect 回線がテナントによって確認および承認されているかどうかを指定します。有効な値:

    • true: はい。

    • false: いいえ。

    true
    VirtualPhysicalConnectionStatuses

    array

    任意

    共有 Express Connect 回線のビジネスステータス情報。

    pc-xxx

    string

    任意

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

    • Confirmed: 共有 Express Connect 回線は承認されています。

    • UnConfirmed: 共有 Express Connect 回線は未承認です。

    • Deleted: 共有 Express Connect 回線は削除されています。

    複数のビジネスステータスを指定できます。N の有効な値: 1 ～ 20。

    Confirmed
    VirtualPhysicalConnectionAliUids

    array

    任意

    共有 Express Connect 回線のオーナーの Alibaba Cloud アカウント情報。

    189xxx

    string

    任意

    共有 Express Connect 回線のオーナーの Alibaba Cloud アカウント ID。

    複数の Alibaba Cloud アカウント ID を指定できます。N の有効な値: 1 ～ 20。

    15346073170691****
    VlanIds

    array

    任意

    共有 Express Connect 回線の VLAN ID。

    pc-xxx

    string

    任意

    共有 Express Connect 回線の VLAN ID。

    複数の VLAN ID を指定できます。N の有効な値: 1 ～ 20。

    10
    MaxResults

    integer

    任意

    ページネーションを使用して結果をクエリする場合の 1 ページあたりのエントリ数。有効な値: 1 ～ 100。デフォルト値: 20。

    20
    NextToken

    string

    任意

    次のクエリトークンが存在するかどうかを示します。有効な値:

    • 最初のクエリの場合、または次のクエリが存在しない場合は、このパラメーターを指定する必要はありません。

    • 次のクエリが存在する場合は、このパラメーターを前の API 呼び出しで返された NextToken 値に設定します。

    dd20****
    RegionId

    string

    必須

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

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

    cn-shanghai
    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-acfmxazb4p****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーター。

    RequestId

    string

    リクエスト ID。

    2A55F69E-EE3D-5CBE-8805-734F7D5B46B9
    VirtualPhysicalConnections

    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: リソース割り当てに失敗しました。

    • Terminated: 終了しました。

    Enabled
    CreationTime

    string

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

    2021-06-08T12:20:55Z
    AdLocation

    string

    Express Connect 回線のアクセスデバイスの物理的な場所。

    Yuhang Economic Development Zone, XX Intersection, Yuhang XX Data Center, Room E***
    PortNumber

    string

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

    80
    Spec

    string

    共有 Express Connect 回線の帯域幅値。

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

    50M
    ChargeType

    string

    Express Connect 回線の課金方法。

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

    Prepaid
    Description

    string

    Express Connect 回線の説明。

    desctest
    Bandwidth

    integer

    Express Connect 回線の帯域幅。単位: Mbit/s。

    50
    EnabledTime

    string

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

    2021-10-08T10:44:00Z
    LineOperator

    string

    アクセス用の物理回線を提供するキャリア。有効な値:

    • CT: China Telecom。

    • CU: China Unicom。

    • CM: China Mobile。

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

    • Equinix: Equinix。

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

    CU
    PeerLocation

    string

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

    No. XX, XX Street, XX District, Hangzhou, Zhejiang Province
    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) で表示されます。

    2021-11-08T16:00:00Z
    PortType

    string

    Express Connect 回線のアクセスデバイスのポートタイプ。有効な値:

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

    • 1000Base-T: GE 電気ポート。

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

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

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

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

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

    10GBase-LR
    BusinessStatus

    string

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

    • Normal: 法線。

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

    • SecurityLocked: セキュリティ上の理由によりロック済み。

    Normal
    LoaStatus

    string

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

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

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

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

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

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

    • Complete: Express Connect 回線の工事は完了しています。

    • Deleted: LOA は削除されています。

    Available
    AccessPointId

    string

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

    ap-cn-hangzhou-finance-yh-E
    PhysicalConnectionId

    string

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

    pc-bp1mrgfbtmc9brre7****
    ProductType

    string

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

    • VirtualPhysicalConnection: 共有 Express Connect 回線。

    • PhysicalConnection: 専用 Express Connect 回線。

    VirtualPhysicalConnection
    ParentPhysicalConnectionId

    string

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

    pc-bp1ciz7ekd2grn1as****
    VirtualPhysicalConnectionStatus

    string

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

    • Confirmed: 共有 Express Connect 回線は承認されています。

    • UnConfirmed: 共有 Express Connect 回線は未承認です。

    • Deleted: 共有 Express Connect 回線は削除されています。

    Confirmed
    ParentPhysicalConnectionAliUid

    string

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

    18311773240248****
    OrderMode

    string

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

    • PayByPhysicalConnectionOwner: 共有 Express Connect 回線に関連付けられている Express Connect 回線のオーナーが支払者です。

    • PayByVirtualPhysicalConnectionOwner: 共有 Express Connect 回線のオーナーが支払者です。

    PayByPhysicalConnectionOwner
    AliUid

    string

    共有 Express Connect 回線のオーナーの Alibaba Cloud アカウント ID。

    15346073170691****
    VlanId

    string

    共有 Express Connect 回線の VLAN ID。

    10
    ExpectSpec

    string

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

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

    50M
    ResourceGroupId

    string

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

    rg-acfm3wmsyui****
    Tags

    array<object>

    タグリスト。

    object

    タグリスト。

    Key

    string

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

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

    FinanceDept
    Value

    string

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

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

    FinanceJoshua
    NextToken

    string

    次のクエリトークンが存在するかどうかを示します。有効な値:

    • NextToken が空の場合、次のクエリは存在しません。

    • NextToken に戻り値がある場合、その値は次のクエリのトークンです。

    dd20****
    TotalCount

    integer

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

    1
    Count

    integer

    現在のクエリで返されたエントリ数。

    1

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "2A55F69E-EE3D-5CBE-8805-734F7D5B46B9",
  "VirtualPhysicalConnections": [
    {
      "Type": "VPC",
      "Status": "Enabled",
      "CreationTime": "2021-06-08T12:20:55Z",
      "AdLocation": "Yuhang Economic Development Zone, XXX Intersection, Yuhang XX Data Center, Room E***",
      "PortNumber": "80",
      "Spec": "50M",
      "ChargeType": "Prepaid",
      "Description": "desctest",
      "Bandwidth": 50,
      "EnabledTime": "2021-10-08T10:44:00Z",
      "LineOperator": "CU",
      "PeerLocation": "No. XX, XX Street, XX District, Hangzhou, Zhejiang Province",
      "RedundantPhysicalConnectionId": "pc-119mfjzm****",
      "Name": "nametest",
      "CircuitCode": "longtel001",
      "EndTime": "2021-11-08T16:00:00Z",
      "PortType": "10GBase-LR",
      "BusinessStatus": "Normal",
      "LoaStatus": "Available",
      "AccessPointId": "ap-cn-hangzhou-finance-yh-E",
      "PhysicalConnectionId": "pc-bp1mrgfbtmc9brre7****",
      "ProductType": "VirtualPhysicalConnection",
      "ParentPhysicalConnectionId": "pc-bp1ciz7ekd2grn1as****",
      "VirtualPhysicalConnectionStatus": "Confirmed",
      "ParentPhysicalConnectionAliUid": "18311773240248****",
      "OrderMode": "PayByPhysicalConnectionOwner",
      "AliUid": "15346073170691****",
      "VlanId": "10",
      "ExpectSpec": "50M",
      "ResourceGroupId": "rg-acfm3wmsyui****",
      "Tags": [
        {
          "Key": "FinanceDept",
          "Value": "FinanceJoshua"
        }
      ]
    }
  ],
  "NextToken": "dd20****",
  "TotalCount": 1,
  "Count": 1
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 IllegalParam.Bandwidth The param of Bandwidth [%s] is illegal. 指定された帯域幅が無効です。
    400 ResourceNotFound.PhysicalConnectionId The specified PhysicalConnectionId [%s] is not found. PhysicalConnectionId が見つかりませんでした。

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

    変更履歴

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