Data connection lifecycle | emnify Documentation

ID	Description
3	Create PDP Context
5	Delete PDP Context

Create PDP Context

A Packet Data Protocol (PDP) context allows UE to exchange IP packets over the network.

A Create PDP Context event indicates the activation of data connectivity.

Example: a device has established a data session and started transferring data. This device appears as Online in the emnify Portal as long as there hasn’t been a subsequent Delete PDP Context event.

Example JSON response: create PDP context accepted

1 {
2   "timestamp": "2021-10-27T08:38:02.000Z",
3   "alert": false,
4   "description": "New PDP Context successfully activated with SGSN CP=60.195.159.61, DP=117.72.59.30.",
5   "id": 31877325941,
6   "event_type": {
7     "id": 3,
8     "description": "Create PDP Context"
9   },
10   "event_source": {
11     "id": 0,
12     "description": "Network"
13   },
14   "event_severity": {
15     "id": 0,
16     "description": "Info"
17   },
18   "organisation": {
19     "id": 1825,
20     "name": "Test Org"
21   },
22   "endpoint": {
23     "id": 20200078,
24     "imei": "960407272413998",
25     "ip_address": "189.79.243.228",
26     "name": "Test Sim 2",
27     "tags": null
28   },
29   "sim": {
30     "iccid": "5746435358418205328",
31     "id": 646486,
32     "production_date": "2020-12-23T13:02:11.000Z"
33   },
34   "imsi": {
35     "id": 12105613,
36     "import_date": "2020-12-23T13:02:11.000Z",
37     "imsi": "693601932595201"
38   },
39   "detail": {
40     "country": {
41       "mcc": "262",
42       "name": "Germany",
43       "country_code": "49",
44       "iso_code": "de",
45       "id": 74
46     },
47     "id": 3,
48     "session_id": "d12c574f-e219-45a4-8836-d17a50f66fb1",
49     "pdp_context": {
50       "breakout_ip": "97.106.216.29",
51       "rac": null,
52       "sgsn_control_plane_ip_address": "117.72.59.30",
53       "rat_type": 2,
54       "tx_teid_data_plane": 557727595,
55       "region": "eu-west-1",
56       "apn": "em",
57       "tx_teid_control_plane": 570842943,
58       "tunnel_created": "2021-10-27T08:38:02",
59       "ggsn_data_plane_ip_address": "150.85.110.76",
60       "sgsn_data_plane_ip_address": "223.253.0.120",
61       "rx_teid": 96601675,
62       "ci": 5174,
63       "imsi": "82186563190127",
64       "lac": 921,
65       "mcc": "262",
66       "sac": null,
67       "ggsn_control_plane_ip_address": "60.195.159.61",
68       "mnc": "02",
69       "nsapi": 5,
70       "ue_ip_address": "101.124.109.214",
71       "imeisv": "6887426203768011",
72       "pdp_context_id": 51755555,
73       "gtp_version": 1,
74       "operator_id": "3",
75       "tariff_profile_id": "395978", // coverage policy
76       "ratezone_id": "8178", // coverage area
77       "tariff_id": "555" // data plan
78     },
79     "name": "Vodafone"
80   }
81 }

Example JSON response: create PDP context rejected because data service is disabled in the service profile

1 {
2   "timestamp": "2021-10-24T12:43:51.000Z",
3   "alert": true,
4   "description": "PDP Context Request rejected, because data service disabled in service profile.",
5   "id": 2836707022,
6   "event_type": {
7     "id": 3,
8     "description": "Create PDP Context"
9   },
10   "event_source": {
11     "id": 1,
12     "description": "Policy Control"
13   },
14   "event_severity": {
15     "id": 1,
16     "description": "Warn"
17   },
18   "organisation": {
19     "id": 1222,
20     "name": "Test Org"
21   },
22   "endpoint": {
23     "id": 14002489,
24     "imei": "211785743231328",
25     "ip_address": "173.97.253.42",
26     "name": "Test Sim 2",
27     "tags": null
28   },
29   "sim": {
30     "iccid": "41595256071723032296",
31     "id": 801148,
32     "production_date": "2020-12-23T13:02:11.000Z"
33   },
34   "imsi": {
35     "id": 62004293,
36     "import_date": "2020-12-23T13:02:11.000Z",
37     "imsi": "175904061168404"
38   }
39 }

Example JSON response: create PDP context rejected because the device doesn't have a quota

1 {
2   "timestamp": "2021-10-27T08:55:59.000Z",
3   "alert": true,
4   "description": "PDP Context Request rejected, because endpoint has no quota.",
5   "id": 7745432124,
6   "event_type": {
7     "id": 3,
8     "description": "Create PDP Context"
9   },
10   "event_source": {
11     "id": 1,
12     "description": "Policy Control"
13   },
14   "event_severity": {
15     "id": 1,
16     "description": "Warn"
17   },
18   "organisation": {
19     "id": 177,
20     "name": "Test Org"
21   },
22   "endpoint": {
23     "id": 10238,
24     "imei": "127957062642784",
25     "ip_address": "113.252.159.78",
26     "name": "Test Sim 2",
27     "tags": null
28   },
29   "sim": {
30     "iccid": "6300267938152764468",
31     "id": 3012262,
32     "production_date": "2020-12-23T13:02:11.000Z"
33   },
34   "imsi": {
35     "id": 66367669,
36     "import_date": "2020-12-23T13:02:11.000Z",
37     "imsi": "85785128232645"
38   }
39 }

Example JSON response: create PDP Context Request rejected because the device's quota volume is exhausted, and the defined action is to block data traffic

1 {
2   "timestamp": "2021-10-27T09:12:27.000Z",
3   "alert": true,
4   "description": "PDP Context Request rejected, because quota volume of endpoint is exhausted and defined action is to block data traffic.",
5   "id": 7598008306,
6   "event_type": {
7     "id": 3,
8     "description": "Create PDP Context"
9   },
10   "event_source": {
11     "id": 1,
12     "description": "Policy Control"
13   },
14   "event_severity": {
15     "id": 1,
16     "description": "Warn"
17   },
18   "organisation": {
19     "id": 8087,
20     "name": "Test Org"
21   },
22   "endpoint": {
23     "id": 39063467,
24     "imei": "454208457191395",
25     "ip_address": "120.133.145.19",
26     "name": "Test Sim 2",
27     "tags": null
28   },
29   "sim": {
30     "iccid": "91447762462599458698",
31     "id": 609020,
32     "production_date": "2020-12-23T13:02:11.000Z"
33   },
34   "imsi": {
35     "id": 97534929,
36     "import_date": "2020-12-23T13:02:11.000Z",
37     "imsi": "715343715967543"
38   }
39 }

Example JSON response: create PDP context request rejected because the SIM isn't activated

1 {
2   "timestamp": "2021-10-27T12:33:17.000Z",
3   "alert": true,
4   "description": "PDP Context Request rejected, because SIM is not activated.",
5   "id": 117138486882,
6   "event_type": {
7     "id": 3,
8     "description": "Create PDP Context"
9   },
10   "event_source": {
11     "id": 1,
12     "description": "Policy Control"
13   },
14   "event_severity": {
15     "id": 1,
16     "description": "Warn"
17   },
18   "organisation": {
19     "id": 4823,
20     "name": "Test Org"
21   },
22   "endpoint": {
23     "id": 1257319,
24     "imei": "25631320011492911",
25     "ip_address": "230.105.77.310",
26     "name": "Test Sim 2",
27     "tags": null
28   },
29   "sim": {
30     "iccid": "87901100765269508687",
31     "id": 45142,
32     "production_date": "2020-12-23T13:02:11.000Z"
33   },
34   "imsi": {
35     "id": 497998,
36     "import_date": "2020-12-23T13:02:11.000Z",
37     "imsi": "76604441813689"
38   }
39 }

Delete PDP Context

Data session between the device and the network is deleted.

Example: a device disconnected and ended a data transfer. The event details also show the data transmitted, and the device appears as Attached in the emnify Portal.

Example JSON response

1 {
2     "timestamp": "2021-10-27T08:40:10.000Z",
3     "alert": false,
4     "description": "PDP Context deleted.",
5     "id": 1906081382592,
6     "event_type": {
7         "id": 5,
8         "description": "Delete PDP Context"
9     },
10     "event_source": {
11         "id": 0,
12         "description": "Network"
13     },
14     "event_severity": {
15         "id": 0,
16         "description": "Info"
17     },
18     "organisation": {
19         "id": 39089,
20         "name": "Test Org"
21     },
22     "endpoint": {
23         "id": 8163445,
24         "imei": "82586199276110710",
25         "ip_address": "104.86.8.106",
26         "name": "Test Sim 2",
27         "tags": null
28     },
29     "sim": {
30         "iccid": "9335742231782809262",
31         "id": 1931060,
32         "production_date": "2020-12-23T13:02:11.000Z"
33     },
34     "imsi": {
35         "id": 5216225,
36         "import_date": "2020-12-23T13:02:11.000Z",
37         "imsi": "49652622520507"
38     },
39     "detail": {
40         "country": {
41             "country_code": "49",
42             "mcc": "262",
43             "name": "Germany",
44             "iso_code": "de",
45             "id": 82
46         },
47         "volume": {
48             "total": 0.641984,
49             "rx": 0.418811,
50             "tx": 0.223173
51         },
52         "id": 3,
53         "session_id": "2a4ff039-fbb9-4eaa-b74c-2f0eaafaf624",
54         "pdp_context": {
55             "breakout_ip": null,
56             "rac": null,
57             "sgsn_control_plane_ip_address": "234.39.123.228",
58             "rat_type": 2,
59             "tx_teid_data_plane": 966839357,
60             "region": "eu-west-1",
61             "apn": null,
62             "tx_teid_control_plane": 397629956,
63             "tunnel_created": "2021-10-27T08:38:02",
64             "ggsn_data_plane_ip_address": "225.129.61.136",
65             "sgsn_data_plane_ip_address": "173.69.12.45",
66             "rx_teid": 18195957,
67             "ci": 6471,
68             "imsi": "369573775632443",
69             "lac": 767,
70             "mcc": "262",
71             "sac": null,
72             "ggsn_control_plane_ip_address": "67.185.18.116",
73             "mnc": "02",
74             "nsapi": 5,
75             "ue_ip_address": "66.185.97.229",
76             "imeisv": "4555797980633712",
77             "pdp_context_id": 79790039,
78             "gtp_version": 1
79         },
80         "name": "Vodafone"
81     }
82 }