全部產品
Search
文件中心

Virtual Private Cloud:GetVpcPeerConnectionAttribute - 查詢單個VPC對等串連屬性

更新時間:Sep 25, 2025

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

調試

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

調試

授權資訊

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

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

vpc:GetVpcPeerConnectionAttribute

get

*PeerConnection

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

請求參數

名稱

類型

必填

描述

樣本值

InstanceId

string

需要查詢詳細資料的 VPC 對等串連執行個體 ID。

pcc-lnk0m24khwvtkm****

返回參數

名稱

類型

描述

樣本值

object

請求 ID。

RequestId

string

請求 ID。

473469C7-AA6F-4DC5-B3DB-A3AC0DE3C83E

InstanceId

string

VPC 對等串連的執行個體 ID。

pcc-lnk0m24khwvtkm****

GmtCreate

string

VPC 對等串連的建立時間。使用 UTC 時間,格式為YYYY-MM-DDThh:mm:ssZ

2022-04-24T09:02:36Z

GmtModified

string

VPC 對等串連的修改時間。使用 UTC 時間,格式為YYYY-MM-DDThh:mm:ssZ

2022-04-24T19:20:45Z

Name

string

VPC 對等串連的名稱。

vpcpeer

Description

string

VPC 對等串連的描述資訊。

test

OwnerId

integer

VPC 對等串連發起端的阿里雲帳號 ID。

25346073170691****

AcceptingOwnerUid

integer

VPC 對等串連接收端的阿里雲帳號 ID。

28311773240248****

RegionId

string

VPC 對等串連發起端的地區 ID。

cn-hangzhou

AcceptingRegionId

string

VPC 對等串連接收端的地區 ID。

cn-hangzhou

Bandwidth

integer

VPC 對等串連的頻寬,單位:Mbps,取值範圍為大於 0 的整數。

說明

例外取值-1,表示無頻寬節流設定。

預設值如下:

  • 跨地區 VPC 對等串連的頻寬預設值為 1024 Mbps。

  • 同地區 VPC 對等串連的頻寬預設值為-1 Mbps,即不限制頻寬。

1024

Status

string

VPC 對等串連的狀態。取值:

  • Creating:建立中。

  • Accepting:接收中。

  • Updating:更新中。

  • Rejected:已拒絕。

  • Expired:已到期。

  • Activated:已啟用。

  • Deleting:刪除中。

  • Deleted:已刪除。

關於 VPC 對等串連狀態的更多資訊,請參見 VPC 對等串連概述

Activated

BizStatus

string

VPC 對等串連的商業狀態。取值:

  • Normal:正常。

  • FinancialLocked:欠費鎖定。

Normal

GmtExpired

string

VPC 對等串連的到期時間。

只有當 VPC 對等串連的 Status(狀態)為 Accepting(接收中)或 Expired(已到期)時,才會返回具體的到期時間;VPC 對等串連處於其餘狀態時,傳回值為 null

2022-05-01T09:02:36Z

ResourceGroupId

string

資源群組 ID。

rg-acfmxazb4ph6aiy****

Vpc

object

發起端 VPC 執行個體詳細資料。

VpcId

string

發起端 VPC 執行個體 ID。

vpc-bp1gsk7h12ew7oegk****

Ipv4Cidrs

array

發起端網段資訊。

string

發起端網段資訊。

192.168.0.0/16

Ipv6Cidrs

array

發起端 IPv6 網段資訊。

string

發起端 IPv6 網段資訊。

2408:XXXX:3c5:6e00::/56

AcceptingVpc

object

接收端 VPC 執行個體詳細資料。

VpcId

string

接收端 VPC 執行個體 ID。

vpc-bp1vzjkp2q1xgnind****

Ipv4Cidrs

array

接收端網段資訊。

string

接收端網段資訊。

10.0.0.0/16

Ipv6Cidrs

array

接收端 IPv6 網段資訊。

string

接收端 IPv6 網段資訊。

2408:XXXX:3b8:3a00::/56

Tags

array<object>

標籤列表。

object

標籤列表。

Value

string

標籤值。

FinanceJoshua

Key

string

標籤鍵。

FinanceDept

LinkType

string

VPC 對等串連的鏈路類型。

預設值如下:

  • 跨地區 VPC 對等串連的預設鏈路類型為 Gold(金)。

  • 同地區 VPC 對等串連的預設鏈路類型為空白。

Gold

ManagedService

string

歸屬雲端服務

SWAS

樣本

正常返回樣本

JSON格式

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

錯誤碼

HTTP status code

錯誤碼

錯誤資訊

描述

400 ResourceNotFound.InstanceId The specified resource of %s is not found. 未找到指定執行個體

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

變更歷史

更多資訊,參考變更詳情