ListVirtualPhysicalConnections - 查詢共用專線的資訊 - Express Connect

調用ListVirtualPhysicalConnections介面查詢共用專線的資訊

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

vpc:ListVirtualPhysicalConnections

list

*PhysicalConnection

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

無

請求參數

名稱	類型	必填	描述	樣本值
PhysicalConnectionId	string	否	共用專線關聯的物理專線 ID。本文以下內容將共用專線關聯的物理專線，簡稱為物理專線，和共用專線互做區分。	pc-bp1ciz7ekd2grn1as****
VirtualPhysicalConnectionBusinessStatus	string	否	共用專線的商業狀態。取值： Normal：正常。 FinancialLocked：欠費鎖定。 SecurityLocked：因安全原因被鎖定。	Normal
VirtualPhysicalConnectionIds	array	否	共用專線資訊。	pc-xxx
	string	否	共用專線執行個體 ID。支援輸入多個執行個體 ID，N 的取值範圍：1~20。	pc-bp1mrgfbtmc9brre7****
IsConfirmed	boolean	否	共用專線是否已被租戶確認接收。取值： true：是。 false：否。	true
VirtualPhysicalConnectionStatuses	array	否	共用專線的業務狀態資訊。	pc-xxx
	string	否	共用專線的業務狀態。取值： Confirmed：共用專線已被確認接收。 UnConfirmed：共用專線未被確認接收。 Deleted：共用專線已被刪除。支援輸入多種業務狀態，N 的取值範圍：1~20。	Confirmed
VirtualPhysicalConnectionAliUids	array	否	共用專線擁有者的阿里雲帳號資訊。	189xxx
	string	否	共用專線擁有者的阿里雲帳號（主帳號）ID。支援輸入多個阿里雲帳號（主帳號）ID，N 的取值範圍：1~20。	15346073170691****
VlanIds	array	否	共用專線的 VLAN ID。	pc-xxx
	string	否	共用專線的 VLAN ID。支援輸入多個 VLAN ID，N 的取值範圍：1~20。	10
MaxResults	integer	否	分批次查詢時每次顯示的條目數。取值範圍：1~100，預設值為 20。	20
NextToken	string	否	是否擁有下一次查詢的令牌（Token）。取值：第一次查詢和沒有下一次查詢時，均無需填寫。如果有下一次查詢，取值為上一次 API 呼叫返回的 NextToken 值。	dd20****
RegionId	string	是	共用專線所屬的地區 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	否	共用專線所屬的資源群組 ID。	rg-acfmxazb4p****

返回參數

名稱	類型	描述	樣本值
	object	返回結果。
RequestId	string	請求 ID。	2A55F69E-EE3D-5CBE-8805-734F7D5B46B9
VirtualPhysicalConnections	array<object>	共用專線資訊列表。
	array<object>	共用專線詳細資料。
Type	string	物理專線的類型。預設值為 VPC。	VPC
Status	string	物理專線的狀態。取值： Initial：申請中。 Approved：審批通過。 Allocating：正在分配資源。 Allocated：接入施工中。 Confirmed：等待使用者確認。 Enabled：已開通。 Rejected：申請被拒絕。 Canceled：已取消。 Allocation Failed：資源分派失敗。 Terminated：已終止。	Enabled
CreationTime	string	物理專線的建立時間。	2021-06-08T12:20:55
AdLocation	string	物理專線接入裝置所在的物理位置。	餘杭經濟開發區XXX交叉口, 餘杭XX機房, E***包間
PortNumber	string	物理專線接入裝置的連接埠號碼。	80
Spec	string	共用專線的頻寬值。單位：M 表示 Mbps，G 表示 Gbps。	50M
ChargeType	string	物理專線的付費方式。取值：Prepaid，表示預付費。	Prepaid
Description	string	物理專線的描述資訊。	desctest
Bandwidth	integer	物理專線的頻寬。單位：Mbps。	50
EnabledTime	string	物理專線的開通時間。	2021-10-08T10:44Z
LineOperator	string	提供接入物理線路的電訊廠商。取值： CT：中國電信。 CU：中國聯通。 CM：中國移動。 CO：中國其他。 Equinix：Equinix。 Other：境外其他。	CU
PeerLocation	string	本機資料中心的地理位置。	浙江省杭州市XX區XX街道XX號
RedundantPhysicalConnectionId	string	冗餘物理專線的 ID。	pc-119mfjzm****
Name	string	物理專線的名稱。	nametest
CircuitCode	string	電訊廠商為物理專線提供的電路編碼。	longtel001
EndTime	string	共用專線的到期時間。時間按照 ISO8601 標準表示，並使用 UTC 時間。格式為：YYYY-MM-DDThh:mm:ssZ。	2021-11-08T16:00:00Z
PortType	string	物理專線接入連接埠類型。取值： 100Base-T：百兆電口。 1000Base-T：千兆電口。 1000Base-LX：千兆單模光口（10 千米）。 10GBase-T：萬兆電口。 10GBase-LR：萬兆單模光口（10 千米）。 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
PhysicalConnectionId	string	共用專線執行個體 ID。	pc-bp1mrgfbtmc9brre7****
ProductType	string	物理專線類型。取值： VirtualPhysicalConnection：共用專線。 PhysicalConnection：獨享專線。	VirtualPhysicalConnection
ParentPhysicalConnectionId	string	物理專線的執行個體 ID。	pc-bp1ciz7ekd2grn1as****
VirtualPhysicalConnectionStatus	string	共用專線的業務狀態。取值： Confirmed：共用專線已確認接收。 UnConfirmed：共用專線未被確認接收。 Deleted：共用專線已被刪除。	Confirmed
ParentPhysicalConnectionAliUid	string	物理專線所屬的阿里雲帳號（主帳號）ID。	18311773240248****
OrderMode	string	共用專線的付費方式。取值： PayByPhysicalConnectionOwner：表示共用專線關聯的物理專線的擁有者付費。 PayByVirtualPhysicalConnectionOwner：表示共用專線的擁有者付費。	PayByPhysicalConnectionOwner
AliUid	string	共用專線擁有者的阿里雲帳號（主帳號）ID。	15346073170691****
VlanId	string	共用專線的 VLAN ID。	10
ExpectSpec	string	共用專線的預計頻寬值。完成支付後，預計頻寬值才會生效。單位：M 表示 Mbps，G 表示 Gbps。	50M
ResourceGroupId	string	共用專線所屬的資源群組 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	是否擁有下一次查詢的令牌（Token）。取值：如果 NextToken 為空白表示沒有下一次查詢。如果 NextToken 有傳回值，該取值表示下一次查詢開始的令牌。	dd20****
TotalCount	integer	總條目數。	1
Count	integer	本次查詢的條目數。	1

樣本

正常返回樣本

JSON格式

{
  "RequestId": "2A55F69E-EE3D-5CBE-8805-734F7D5B46B9",
  "VirtualPhysicalConnections": [
    {
      "Type": "VPC",
      "Status": "Enabled",
      "CreationTime": "2021-06-08T12:20:55",
      "AdLocation": "餘杭經濟開發區XXX交叉口, 餘杭XX機房, E***包間",
      "PortNumber": "80",
      "Spec": "50M",
      "ChargeType": "Prepaid",
      "Description": "desctest",
      "Bandwidth": 50,
      "EnabledTime": "2021-10-08T10:44Z",
      "LineOperator": "CU",
      "PeerLocation": "浙江省杭州市XX區XX街道XX號",
      "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 status code	錯誤碼	錯誤資訊	描述
400	IllegalParam.Bandwidth	The param of Bandwidth [%s] is illegal.	傳入的頻寬不合法。
400	ResourceNotFound.PhysicalConnectionId	The specified PhysicalConnectionId [%s] is not found.	PhysicalConnectionId未找到。

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊，參考變更詳情。