Get possible data stream statuses | emnify Documentation

List Possible Data Stream Statuses.

(1) is the normal Running state meaning your data stream is active and streams data.

(2) indicates a Paused data stream. It will not send messages to your destination. However, messages meant for this data stream are routed and will be stored up to 7 days. You will first receive historic data once you resume a paused streamer after longer pausing.

(3) indicates that an Error has occurred. This might be problems in the configuration (e.g. missing permissions) or your destination has been unavailable for a longer period of time and the data stream exceeded maximum retries. You may restart the streamer in order to fix a temporary problem, misconfigured streamers will continue to fail.

(4) is a Pending state. Your data stream has not been initialized, yet. This state may occur for a very short time.

List Possible Data Stream Statuses. (`1`) is the normal `Running` state meaning your data stream is active and streams data. (`2`) indicates a `Paused` data stream. It will not send messages to your destination. However, messages meant for this data stream are routed and will be stored up to 7 days. You will first receive historic data once you resume a paused streamer after longer pausing. (`3`) indicates that an `Error` has occurred. This might be problems in the configuration (e.g. missing permissions) or your destination has been unavailable for a longer period of time and the data stream exceeded maximum retries. You may restart the streamer in order to fix a temporary problem, misconfigured streamers will continue to fail. (`4`) is a `Pending` state. Your data stream has not been initialized, yet. This state may occur for a very short time.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

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

Response

Possible connection statuses

iddouble or null

Enum item identifier

descriptionstring or null

Enum item description

Errors

List Possible Data Stream Statuses.

(1) is the normal Running state meaning your data stream is active and streams data.

(4) is a Pending state. Your data stream has not been initialized, yet. This state may occur for a very short time.

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

1	[
2	{
3	"id": 1,
4	"description": "Running"
5	},
6	{
7	"id": 2,
8	"description": "Paused"
9	},
10	{
11	"id": 3,
12	"description": "Error"
13	},
14	{
15	"id": 4,
16	"description": "Pending"
17	}
18	]