List of peering connections to be queried.
Updated at：2025-10-16
Description
Retrieve the list of peering connections.
Request structure
Plain Text
1GET /v{version}/peerconn?vpcId={vpcId}&marker={marker}&maxKeys={maxKeys} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization stringRequest parameters
| Parameter name | Types | Whether required | Parameter location | Description |
|---|---|---|---|---|
| version | String | Yes | URL parameter | API version number, current value is 1. |
| vpcId | String | No | URL parameter | VPC ID |
| marker | String | No | Query | The starting position of the batch list query is a system-generated string |
| maxKeys | Integer | No | Query | Maximum number of items per page is 1,000, with a default value of 1000. |
Response headers
No additional headers beyond standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| peerConns | List<[PeerConn](VPC/API Reference/Appendix.md#PeerConn)> | List containing query results |
| marker | String | Marker indicating the starting position of the query. If the result list is empty, this field does not exist. |
| isTruncated | Boolean | true indicates there is more data later, false indicates it is the last page |
| nextMarker | String | The marker value needed to fetch the next page. This field is absent when isTruncated is false. |
| maxKeys | Integer | Maximum number of items included per page |
Request example
Plain Text
1GET /v1/peerconn?vpcId=vpc-13vuxu016dew&maxKeys=1 HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: bce-auth-v1/930192808c0c11e8b62ccf3a4a052967/2018-07-20T11:37:16Z/3600/host;x-bce-account;x-bce-client-ip;x-bce-date;x-bce-request-id;x-bce-security-token/38230e0d152186b4d4ec912c2b828d1f0d2623920d640589196f3f5be25534b7Response example
Plain Text
1HTTP/1.1 200 OK
2Date: Fri, 20 Jul 2018 11:37:16 GMT
3Content-Type: application/json;charset=UTF-8
4Server: BWS
5{
6 "peerConns":[
7 {
8 "peerConnId":"peerconn-9td54fmx143e",
9 "role":"initiator",
10 "status":"active",
11 "bandwithInMbp":500,
12 "description":"peer_diff_account",
13 "localIfId":"qpif-ken2yc9j8x56",
14 "localIfName":"int-SpLVk25R",
15 "localVpcId":"vpc-13vuxu016dew",
16 "localRegion":"bj",
17 "peerVpcId":"vpc-jcvmhw9h1a35",
18 "peerRegion":"bj",
19 "peerAccountId":"75c14a239bb24b9e88b695e8e9e47952",
20 "dnsStatus":"close",
21 "paymentTiming":"Postpaid",
22 "createdTime" :"2018-08-07 19:46:55",
23 "expiredTime":"2019-08-07 19:46:55",
24 }
25 ]
26 }
27 "marker":"peerconn-9td54fmx143e",
28 "isTruncated": true,
29 "nextMarker": "peerconn-srbvvxmjn7ux",
30 "maxKeys": 1
31}