View details of peering connection
Updated at：2025-10-16
Description
Access detailed information about a specified peering connection.
Request structure
Plain Text
1GET /v{version}/peerconn/{peerConnId} 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. |
| peerConnId | String | Yes | URL parameter | ID of peering connection |
| role | String | No | Query | "initiator" denotes the initiating end, and "acceptor" denotes the accepting end. Peering connections in the same region can be queried for details accordingly. If this parameter is not set, information for either end will be randomly returned for the same region |
Response headers
No additional headers beyond standard ones.
Response parameters
| Parameter name | Types | Description |
|---|---|---|
| peerConnId | String | ID of peering connection |
| role | String | "initiator" denotes the initiating end, "acceptor" denotes the accepting end |
| status | [PeerConnStatus](VPC/API Reference/Appendix.md#PeerConnStatus) | Status of peering connection |
| bandwithInMbp | Integer | Bandwidth of peering connection |
| description | String | Remark for peering connection |
| localIfId | String | ID of local API for peering connection |
| localIfName | String | Name of local API for peering connection |
| localVpcId | String | ID of local VPC for peering connection |
| localRegion | String | Local region of peering connection |
| peerVpcId | String | ID of peer VPC for peering connection |
| peerRegion | String | Peer region of peering connection |
| peerAccountId | String | Peer account ID of peering connection |
| createdTime | String | Creation time of peering connection |
| expiredTime | String | Expiration time of peering connection. For postpay, this value is empty |
| dnsStatus | [DnsStatus](VPC/API Reference/Appendix.md#DnsStatus) | Synchronization status of peering connection with DNS |
| paymentTiming | String | Billing type for peering connection: "Prepaid" for prepay, "Postpaid" for Postpay |
| tags | List<[TagModel](VPC/API Reference/Appendix.md#tagmodel)> | List of tags bound to peering connection |
| deleteProtect | Boolean | Whether to enable release protection |
Request example
Plain Text
1GET /v1/peerconn/peerconn-9td54fmx143e 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 "peerConnId":"peerconn-cbp4xrtzk3fb",
7 "role":"initiator",
8 "status":"active",
9 "bandwithInMbp":1000,
10 "description":"mypeerconn",
11 "localIfId":"qpif-qz9a61ujsizt",
12 "localIfName":"dsds",
13 "localVpcId":"20fada00-f66e-40de-bed4-954af13dc0b2",
14 "localRegion":"bj",
15 "peerVpcId":"1aa1427d-92cf-45d0-bc31-ab4d9fe71425",
16 "peerRegion":"bj",
17 "peerAccountId":"75c14a239bb24b9e88b695e8e9e47952",
18 "createdTime": "2018-08-03 20:38:43",
19 "expiredTime":"2019-08-03 20:38:43",
20 "dnsStatus":"close",
21 "paymentTiming":"Postpaid",
22 "tags":[
23 {
24 "tagKey": "tagKey",
25 "tagValue": "tagValue"
26 }
27 ],
28 "deleteProtect":true
29}