DescribeNetworkPeerConnections - 查询网络对等连接列表-边缘节点服务 ENS(ENS)-阿里云帮助中心

调用DescribeNetworkPeerConnections接口查询网络对等连接。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
InstanceId	string	否	网络对等连接的实例 ID。	pcc-5inkeimcipxk26yqtzm4q****
EnsRegionId	string	否	ENS 的节点 ID。	cn-xian-unicom
Name	string	否	网络对等连接名称。	test0
NetworkIds	array	否	根据两端网络 ID 过滤，不区分发起端和接收端。
	string	否	根据两端网络 ID 过滤，不区分发起端和接收端。	n-5****
PageNumber	integer	否	列表的页码，默认值为 1。	1
PageSize	integer	否	分页查询时设置的每页行数。默认值：10，取值：10~100。	10

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	CEF72CEB-54B6-4AE8-B225-F876FF7BA984
PageNumber	string	当前查询页码。	1
PageSize	string	分页查询时每页的行数。	30
TotalCount	string	列表条目数。	1
NetworkPeerConnects	array<object>	查询的网络对等连接的详细信息列表。
	array<object>	查询的网络对等连接的详细信息。
InstanceId	string	网络对等连接的实例 ID。	pcc-521pzxdg****
CreationTime	string	创建时间，UTC 时间。	2024-05-31T06:43:29Z
Name	string	网络对等连接实例的名称。	test
Description	string	描述信息。	desc
EnsRegionId	string	ENS 节点 ID。	cn-dongguan-9
Status	string	网络对等连接实例的状态。 Creating：创建中。 Activated：已激活。 Deleting：删除中。	Activated
NetworkId	string	网络对等连接发起端的网络 ID。	n-5q73bm****
AcceptingNetworkId	string	网络对等连接接收端的网络 ID。	n-5q28114****
Network	object	发起端网络实例详细信息。
NetworkId	string	发起端网络 ID。	n-5q73bm****
Ipv4Cidrs	array	发起端网段信息。
	string	发起端网段信息。	10.0.0.0/8
AcceptingNetwork	object	接收端网段信息。
NetworkId	string	接收端网络 ID	n-5q28114****
Ipv4Cidrs	array	接收端网段信息。
	string	接收端网段信息。	192.168.0.0/16

示例

正常返回示例

JSON格式

{
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984",
  "PageNumber": "1",
  "PageSize": "30",
  "TotalCount": "1",
  "NetworkPeerConnects": [
    {
      "InstanceId": "pcc-521pzxdg****",
      "CreationTime": "2024-05-31T06:43:29Z",
      "Name": "test",
      "Description": "desc",
      "EnsRegionId": "cn-dongguan-9",
      "Status": "Activated",
      "NetworkId": "n-5q73bm****",
      "AcceptingNetworkId": "n-5q28114****\n",
      "Network": {
        "NetworkId": "n-5q73bm****",
        "Ipv4Cidrs": [
          "10.0.0.0/8"
        ]
      },
      "AcceptingNetwork": {
        "NetworkId": "n-5q28114****",
        "Ipv4Cidrs": [
          "192.168.0.0/16"
        ]
      }
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	ens.interface.error	Failed to call API.	接口调用发生异常。
400	NoPermission	Permission denied.
400	InvalidParameter.%s	The specified field %s invalid. Please check it again.

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

变更历史

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