View details of a Cloud Connect attachment

GET

https://cdn.emnify.net/api/v1/cnc/breakout/:cloudconnect_attachment_id

GET

/api/v1/cnc/breakout/:cloudconnect_attachment_id

1 import requests
2 
3 url = "https://cdn.emnify.net/api/v1/cnc/breakout/cloudconnect_attachment_id"
4 
5 headers = {"Authorization": "Bearer <token>"}
6 
7 response = requests.get(url, headers=headers)
8 
9 print(response.json())

Try it

200Retrieved

1 [
2   {
3     "id": 123,
4     "name": "Attachment to dynamic VPN",
5     "description": "Description for Attachment to dynamic VPN",
6     "user_id": 123,
7     "creation_date": "2019-10-22T10:07:45.000Z",
8     "termination_date": {},
9     "aws_transit_gateway_attachment_id": "tgw-attach-00efd80dc6288e61a",
10     "aws_vpn_connection_id": "vpn-06aa01dfec8d0060f",
11     "status": {
12       "id": 5,
13       "description": "Active"
14     },
15     "type": {
16       "id": 3,
17       "description": "IPSec VPN BGP"
18     },
19     "region": "eu-west-1",
20     "tunnel_information": {
21       "0": {
22         "outside_address": "198.51.100.1",
23         "inside_cidr": "169.254.59.80/30",
24         "psk": "my-preshared-key",
25         "metrics": {
26           "tunnel_state": "down",
27           "bytes_in": {
28             "Tue Oct 22 2019 10:24:00 GMT+0000 (Coordinated Universal Time)": 210,
29             "Tue Oct 22 2019 10:29:00 GMT+0000 (Coordinated Universal Time)": 336,
30             "Tue Oct 22 2019 10:34:00 GMT+0000 (Coordinated Universal Time)": 294,
31             "Tue Oct 22 2019 10:39:00 GMT+0000 (Coordinated Universal Time)": 210,
32             "Tue Oct 22 2019 10:44:00 GMT+0000 (Coordinated Universal Time)": 294,
33             "Tue Oct 22 2019 10:49:00 GMT+0000 (Coordinated Universal Time)": 210,
34             "Tue Oct 22 2019 10:54:00 GMT+0000 (Coordinated Universal Time)": 210,
35             "Tue Oct 22 2019 10:59:00 GMT+0000 (Coordinated Universal Time)": 294,
36             "Tue Oct 22 2019 11:04:00 GMT+0000 (Coordinated Universal Time)": 210,
37             "Tue Oct 22 2019 11:09:00 GMT+0000 (Coordinated Universal Time)": 210,
38             "Tue Oct 22 2019 11:14:00 GMT+0000 (Coordinated Universal Time)": 210,
39             "Tue Oct 22 2019 11:19:00 GMT+0000 (Coordinated Universal Time)": 210
40           },
41           "bytes_out": {
42             "Tue Oct 22 2019 10:24:00 GMT+0000 (Coordinated Universal Time)": 1616,
43             "Tue Oct 22 2019 10:29:00 GMT+0000 (Coordinated Universal Time)": 1520,
44             "Tue Oct 22 2019 10:34:00 GMT+0000 (Coordinated Universal Time)": 1700,
45             "Tue Oct 22 2019 10:39:00 GMT+0000 (Coordinated Universal Time)": 1394,
46             "Tue Oct 22 2019 10:44:00 GMT+0000 (Coordinated Universal Time)": 1700,
47             "Tue Oct 22 2019 10:49:00 GMT+0000 (Coordinated Universal Time)": 1394,
48             "Tue Oct 22 2019 10:54:00 GMT+0000 (Coordinated Universal Time)": 1616,
49             "Tue Oct 22 2019 10:59:00 GMT+0000 (Coordinated Universal Time)": 1478,
50             "Tue Oct 22 2019 11:04:00 GMT+0000 (Coordinated Universal Time)": 1616,
51             "Tue Oct 22 2019 11:09:00 GMT+0000 (Coordinated Universal Time)": 1394,
52             "Tue Oct 22 2019 11:14:00 GMT+0000 (Coordinated Universal Time)": 1616,
53             "Tue Oct 22 2019 11:19:00 GMT+0000 (Coordinated Universal Time)": 1394
54           }
55         },
56         "asn": 65000,
57         "public_ip": "192.0.2.1"
58       },
59       "1": {
60         "outside_address": "198.51.100.2",
61         "inside_cidr": "169.254.53.156/30",
62         "psk": "my-preshared-key",
63         "metrics": {
64           "tunnel_state": "up",
65           "bytes_in": {
66             "Tue Oct 22 2019 10:24:00 GMT+0000 (Coordinated Universal Time)": 210,
67             "Tue Oct 22 2019 10:29:00 GMT+0000 (Coordinated Universal Time)": 336,
68             "Tue Oct 22 2019 10:34:00 GMT+0000 (Coordinated Universal Time)": 294,
69             "Tue Oct 22 2019 10:39:00 GMT+0000 (Coordinated Universal Time)": 210,
70             "Tue Oct 22 2019 10:44:00 GMT+0000 (Coordinated Universal Time)": 210,
71             "Tue Oct 22 2019 10:49:00 GMT+0000 (Coordinated Universal Time)": 294,
72             "Tue Oct 22 2019 10:54:00 GMT+0000 (Coordinated Universal Time)": 210,
73             "Tue Oct 22 2019 10:59:00 GMT+0000 (Coordinated Universal Time)": 210,
74             "Tue Oct 22 2019 11:04:00 GMT+0000 (Coordinated Universal Time)": 210,
75             "Tue Oct 22 2019 11:09:00 GMT+0000 (Coordinated Universal Time)": 210,
76             "Tue Oct 22 2019 11:14:00 GMT+0000 (Coordinated Universal Time)": 294,
77             "Tue Oct 22 2019 11:19:00 GMT+0000 (Coordinated Universal Time)": 210
78           },
79           "bytes_out": {
80             "Tue Oct 22 2019 10:24:00 GMT+0000 (Coordinated Universal Time)": 1616,
81             "Tue Oct 22 2019 10:29:00 GMT+0000 (Coordinated Universal Time)": 1520,
82             "Tue Oct 22 2019 10:34:00 GMT+0000 (Coordinated Universal Time)": 1700,
83             "Tue Oct 22 2019 10:39:00 GMT+0000 (Coordinated Universal Time)": 1394,
84             "Tue Oct 22 2019 10:44:00 GMT+0000 (Coordinated Universal Time)": 1616,
85             "Tue Oct 22 2019 10:49:00 GMT+0000 (Coordinated Universal Time)": 1478,
86             "Tue Oct 22 2019 10:54:00 GMT+0000 (Coordinated Universal Time)": 1616,
87             "Tue Oct 22 2019 10:59:00 GMT+0000 (Coordinated Universal Time)": 1394,
88             "Tue Oct 22 2019 11:04:00 GMT+0000 (Coordinated Universal Time)": 1616,
89             "Tue Oct 22 2019 11:09:00 GMT+0000 (Coordinated Universal Time)": 1394,
90             "Tue Oct 22 2019 11:14:00 GMT+0000 (Coordinated Universal Time)": 1700,
91             "Tue Oct 22 2019 11:19:00 GMT+0000 (Coordinated Universal Time)": 1394
92           }
93         },
94         "asn": 65000,
95         "public_ip": "192.0.2.2"
96       }
97     },
98     "organisation_id": 123,
99     "customer_cidr": [
100       "10.0.0.0/24"
101     ]
102   }
103 ]

Displays the details including configured CIDR blocks of a Cloud Connect Attachment.

For active IPSec VPN attachments, the tunnel information (public IP, outisde address, inside CIDR, PSK, ASN) including metrics over the last hour (tunnel state, bytes in/out) will be displayed as well.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Path parameters

cloudconnect_attachment_idstringRequired

Response

idinteger or null

namestring or null

descriptionstring or null

user_idinteger or null

creation_datestring or null

The date this attachment was created in UTC

accept_attachment_expiry_datestring or null

The expiry date of the accept attachment state in UTC. This will only be returned if the breakout is of type Transit Gateway (type_id: 1) and in Status Pending AWS Actvation (status_id: 2)

termination_datestring or null

aws_transit_gateway_attachment_idstring or null

aws_vpn_connection_idstring or null

This is only set when the breakout is a VPN attachment

statusobject or null

typeobject or null

regionstring or null

The customer region that this attachment belongs to

tunnel_informationobject or null