Identifies the thing activation status that is used to determine if a Thing can communicate with the cloud or not. A new status is automatically registered within the Cloud Status metric each time the cloud status changes, for instance, the thing has been activated or deactivated.

Note that the cloud status metric is only used to access historical status values, while the actual status is the one saved on the object as a property.

The metric is of integer type, and each value returned corresponds to a precise status.

Value	Meaning	Description
0	INACTIVE	Incoming IoT data is discarded, events and other periodic computations are stopped.
1	TEST	Like ACTIVE but with a disclaimer in the dashboard. The number of things in TEST status is limited.
2	ACTIVE	The thing can publish data, and it is counted in the billing.
3	~~SUSPENDED~~	This status is deprecated and no longer used.
4	PROVISIONING	The thing initial status when created. When done, the status is automatically changed to ACTIVE.
5	ACTIVATING	The thing is about to be activated. When done, the status is automatically changed to ACTIVE.
6	ACTIVATING_TEST	The thing is about to be tested. When done, the status is automatically changed to TEST.

PROVISIONING, ACTIVATING and ACTIVATING_TEST are transient statuses and, for this reason, not saved in the cloud status history.

Predefined Properties

Other than the metric, on each thing object there are two additional properties:

cloudStatus: the last registered cloud status value for the thing.
cloudStatusLastUpdateTimestamp: the timestamp related to the last cloud status change.

You can reference these properties into templates, for instance to sort/filter the thing list by cloud status.

<thing-list-widget-v2>
  <property name="name"></property>
  <property name="serialNumber"></property>
  <property name="cloudStatus" filter="cloudStatus"></property>
<thing-list-widget-v2

These properties are also available via API or into insights computation (Algorithm inputs).

Predefined Properties

Related articles