使用ListVpcPeerConnections查詢VPC對等串連列表-Virtual Private Cloud-阿里雲

調用ListVpcPeerConnections介面查詢VPC對等串連的詳細資料。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

vpc:ListVpcPeerConnections

list

*VpcPeer

acs:vpc:*:{#AccountId}:vpcpeer/{#InstanceId}

無

請求參數

名稱	類型	必填	描述	樣本值
RegionId	string	否	需要查詢詳細資料的 VPC 對等串連的地區 ID。您可以通過調用 DescribeRegions 介面擷取地區 ID。	cn-hangzhou
InstanceId	string	否	需要查詢詳細資料的 VPC 對等串連執行個體 ID。	pcc-lnk0m24khwvtkm****
VpcId	array	否	根據兩端 vpcid 過濾，不區分發起端和接收端。如果只傳入一個，則根據一端過濾
	string	否	需要查詢詳細資料的 VPC 對等串連的發起端或者接收端 VPC 的執行個體 ID。	vpc-bp1gsk7h12ew7oegk****
Name	string	否	需要查詢詳細資料的 VPC 對等串連的名稱。	vpcpeer
NextToken	string	否	是否擁有下一次查詢的令牌（Token）。取值：第一次查詢和沒有下一次查詢時，均無需填寫。如果有下一次查詢，取值為上一次 API 呼叫返回的 NextToken 值。	FFmyTO70tTpLG6I3FmYAXGKPd****
MaxResults	integer	否	分批次查詢時每次顯示的條目數。取值範圍：1~100，預設值為 20。	20
Tags	array<object>	否	標籤列表。
	object	否	標籤列表。
Value	string	否	標籤值。最多支援輸入 20 個標籤值。一旦傳入該值，可以為空白字串。一個標籤值最多支援 128 個字元，不能以`aliyun`和`acs:`開頭，不能包含`http://`或者`https://`。	FinanceJoshua
Key	string	否	標籤鍵。最多支援輸入 20 個標籤鍵。一旦傳入該值，則不允許為空白字串。一個標籤鍵最多支援 128 個字元，不能以`aliyun`和`acs:`開頭，不能包含`http://`或者`https://`。	FinanceDept
ResourceGroupId	string	否	資源群組 ID。關於資源群組的更多資訊，請參見什麼是資源群組。	rg-acfmxazb4ph6aiy****

返回參數

名稱	類型	描述	樣本值
	object	請求 ID。
RequestId	string	請求 ID。	0ED8D006-F706-4D23-88ED-E11ED39DCAC0
TotalCount	integer	列表條目數。	1
MaxResults	integer	分批次查詢時每次顯示的條目數。取值範圍：1~100，預設值為 20。	20
NextToken	string	是否擁有下一次查詢的令牌（Token）。取值：如果 NextToken 為空白表示沒有下一次查詢。如果 NextToken 有傳回值，該取值表示下一次查詢開始的令牌。	FFmyTO70tTpLG6I3FmYAXGKPd****
VpcPeerConnects	array<object>	查詢的 VPC 對等串連的詳細資料列表。
	array<object>	查詢的 VPC 對等串連的詳細資料。
AcceptingOwnerUid	integer	VPC 對等串連接收端的阿里雲帳號 ID。	25346073170691****
Status	string	VPC 對等串連的狀態。取值： Creating：建立中。 Accepting：接收中。 Updating：更新中。 Rejected：已拒絕。 Expired：已到期。 Activated：已啟用。 Deleting：刪除中。 Deleted：已刪除。關於 VPC 對等串連狀態的更多資訊，請參見 VPC 對等串連概述。	Activated
Description	string	VPC 對等串連的描述資訊。	test
ResourceGroupId	string	資源群組 ID。	rg-acfmxazb4ph6aiy****
InstanceId	string	VPC 對等串連的執行個體 ID。	pcc-lnk0m24khwvtkm****
AcceptingRegionId	string	VPC 對等串連接收端的地區 ID。	cn-hangzhou
GmtModified	string	VPC 對等串連的修改時間。使用 UTC 時間，格式為`YYYY-MM-DDThh:mm:ssZ`。	2022-04-24T19:20:45Z
Vpc	object	發起端 VPC 執行個體詳細資料。
VpcId	string	發起端 VPC 執行個體 ID。	vpc-bp1gsk7h12ew7oegk****
Ipv6Cidrs	array	發起端 IPv6 網段資訊。
	string	發起端 IPv6 網段資訊。	2408:XXXX:3c5:6e00::/56
Ipv4Cidrs	array	發起端網段資訊。
	string	發起端網段資訊。	192.168.0.0/16
GmtExpired	string	VPC 對等串連的到期時間。使用 UTC 時間，格式為`YYYY-MM-DDThh:mm:ssZ`。只有當 VPC 對等串連的 Status（狀態）為 Accepting（接收中）或 Expired（已到期）時，才會返回具體的到期時間；VPC 對等串連處於其餘狀態時，傳回值為 null。	2022-05-01T09:02:36Z
Name	string	VPC 對等串連的名稱。	vpcpeer
BizStatus	string	VPC 對等串連的商業狀態。取值： Normal：正常。 FinancialLocked：欠費鎖定。	Normal
GmtCreate	string	VPC 對等串連的建立時間。使用 UTC 時間，格式為`YYYY-MM-DDThh:mm:ssZ`。	2022-04-24T09:02:36Z
OwnerId	integer	VPC 對等串連發起端的阿里雲帳號 ID。	25346073170691****
Bandwidth	integer	VPC 對等串連的頻寬，單位：Mbps，取值範圍為大於 0 的整數。說明例外取值-1，表示無頻寬節流設定。預設值如下：跨地區 VPC 對等串連的頻寬預設值為 1024 Mbps。同地區 VPC 對等串連的頻寬預設值為-1 Mbps，即不限制頻寬。	1024
RegionId	string	VPC 對等串連發起端的地區 ID。	cn-hangzhou
AcceptingVpc	object	接收端 VPC 執行個體詳細資料。
VpcId	string	接收端 VPC 執行個體 ID。	vpc-bp1vzjkp2q1xgnind****
Ipv6Cidrs	array	接收端 IPv6 網段資訊。
	string	接收端 IPv6 網段資訊。	2408:XXXX:3b8:3a00::/56
Ipv4Cidrs	array	接收端網段資訊。
	string	接收端網段資訊。	10.0.0.0/16
LinkType	string	VPC 對等串連的鏈路類型。預設值如下：跨地區 VPC 對等串連的預設鏈路類型為 Gold（金）。同地區 VPC 對等串連的預設鏈路類型為空白。	Gold
Tags	array<object>	標籤列表。
	object	標籤列表。
Value	string	標籤值。	FinanceJoshua
Key	string	標籤鍵。	FinanceDept
ManagedService	string	歸屬雲端服務	SWAS

樣本

正常返回樣本

JSON格式

{
  "RequestId": "0ED8D006-F706-4D23-88ED-E11ED39DCAC0",
  "TotalCount": 1,
  "MaxResults": 20,
  "NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
  "VpcPeerConnects": [
    {
      "AcceptingOwnerUid": 0,
      "Status": "Activated",
      "Description": "test",
      "ResourceGroupId": "rg-acfmxazb4ph6aiy****",
      "InstanceId": "pcc-lnk0m24khwvtkm****",
      "AcceptingRegionId": "cn-hangzhou",
      "GmtModified": "2022-04-24T19:20:45Z",
      "Vpc": {
        "VpcId": "vpc-bp1gsk7h12ew7oegk****",
        "Ipv6Cidrs": [
          "2408:XXXX:3c5:6e00::/56"
        ],
        "Ipv4Cidrs": [
          "192.168.0.0/16"
        ]
      },
      "GmtExpired": "2022-05-01T09:02:36Z",
      "Name": "vpcpeer",
      "BizStatus": "Normal",
      "GmtCreate": "2022-04-24T09:02:36Z",
      "OwnerId": 0,
      "Bandwidth": 1024,
      "RegionId": "cn-hangzhou",
      "AcceptingVpc": {
        "VpcId": "vpc-bp1vzjkp2q1xgnind****",
        "Ipv6Cidrs": [
          "2408:XXXX:3b8:3a00::/56"
        ],
        "Ipv4Cidrs": [
          "10.0.0.0/16"
        ]
      },
      "LinkType": "Gold",
      "Tags": [
        {
          "Value": "FinanceJoshua",
          "Key": "FinanceDept"
        }
      ],
      "ManagedService": "SWAS"
    }
  ]
}

錯誤碼

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

變更歷史

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