调用ListVpcPeerConnections查询VPC对等连接列表_专有网络VPC(VPC)-阿里云帮助中心

调用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 对等连接的详细信息列表。
	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

示例

正常返回示例

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"
        }
      ]
    }
  ]
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。