List all Cloud Connect attachments of an organization

Lists all Cloud Connect attachments of the logged in organisation if it is an Enterprise. For Master organisations it lists all attachments of the direct child organisations. Deleted attachments are left out by default. Additionally the attachments can be filtered by status and type. Master organisations can also filter by organisation ID of their direct child organisations.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

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

Query parameters

statusenumOptional

Numerical ID of the Cloud Connect attachment status

1 - Pending Customer Action
2 - Pending AWS Activation
3 - Pending EGN Activation
4 - Pending CRG Activation
5 - Active
6 - Deactivation Pending
7 - Deactivated
8 - Rolling Back

Numerical ID of the Cloud Connect attachment status * `1` - Pending Customer Action * `2` - Pending AWS Activation * `3` - Pending EGN Activation * `4` - Pending CRG Activation * `5` - Active * `6` - Deactivation Pending * `7` - Deactivated * `8` - Rolling Back

typeenumOptional

Numerical ID of the Cloud Connect attachment type

1 - Transit Gateway
2 - IPSec VPN
3 - IPSec VPN BGP
4 - IPSec VPN BGP High Availability
5 - Direct Connect
6 - Shared
7 - Transit Gateway (Classic)
8 - IPSec VPN (Classic)

Numerical ID of the Cloud Connect attachment type * `1` - Transit Gateway * `2` - IPSec VPN * `3` - IPSec VPN BGP * `4` - IPSec VPN BGP High Availability * `5` - Direct Connect * `6` - Shared * `7` - Transit Gateway (Classic) * `8` - IPSec VPN (Classic)

organisationdoubleOptional

Numerical ID of an Organization

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

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

1	[
2	{
3	"id": 75,
4	"name": "Attachment to StrongSwan",
5	"user_id": 123,
6	"creation_date": "2019-10-21T10:19:02.000Z",
7	"aws_transit_gateway_attachment_id": "tgw-attach-0abce8655d0bafb83",
8	"aws_vpn_connection_id": "vpn-0085c553b38c5deeb",
9	"status": {
10	"id": 5,
11	"description": "Active"
12	},
13	"type": {
14	"id": 3,
15	"description": "IPSec VPN BGP"
16	},
17	"region": "eu-west-2",
18	"organisation_id": 123
19	},
20	{
21	"id": 104,
22	"name": "Attachment to VPC",
23	"user_id": 123,
24	"creation_date": "2019-10-22T07:59:26.000Z",
25	"aws_transit_gateway_attachment_id": "tgw-attach-0f84169771fa2f4a3",
26	"status": {
27	"id": 5,
28	"description": "Active"
29	},
30	"type": {
31	"id": 1,
32	"description": "Transit Gateway"
33	},
34	"region": "eu-west-1",
35	"organisation_id": 123
36	}
37	]

Authentication

Query parameters

Response

Errors