Perform a Bulk Import of Devices

In order to provision a set of devices in bulk, EdgeIQ has a few methods for creating a number of devices in the system at once. The most flexible and programmatic way to create multiple devices is through the API, but CSV functionality through the web app is available as well.

Before importing devices, you will need to create a CSV file with information formatted into the following columns.

PositionFieldDescription
1NameDevice name
2Unique IDUnique identifier of device. Please note that unique id is case sensitive, and unique ids for gateway type devices should be all lowercase if using the default auto discovered unique id (MAC address).
3Serial Number[Optional] An optional serial number for the device
4Location[Optional] A string describing the location of the device
5Company IDID of the company account for this device
6DeviceType IDThe ID of the device type for this device
7Heartbeat PeriodHeartbeat period in seconds
8Cellular Number[Optional] Cellular number associated with device
9SMS Command Password[Optional] Password for issuing commands via SMS
10DeviceConfig ID[Optional] ID of configuration to apply to these devices
11Active[Optional] true or false to mark the device active or inactive
12Heartbeat Values[Optional] A comma separated list of values to send along with heartbeat messages. Must be surrounded in quotes, e.g. "disk_size,disk_free"
13Device Integration ID[Optional] ID of a device integration to assign to the device
14Cloud Native Integration ID[Optional] ID of a cloud-native integration to assign to the device
15Parent Device ID[Optional] If the device is a sensor type device, or endpoint, the ID (not unique ID) of the parent device
16Tags[Optional] Semicolon delimited list of tags to apply to this device, e.g. tag 1;tag 2
17Metadata[Optional] Metadata to apply to this device. Semicolon delimited, colon separated key value pairs, e.g. Current Firmware:v1.5;Color:blue
18Delete?[Optional] In order to bulk delete, you may put true in this column. The device will be deleted

Once you have your CSV ready with the necessary information, navigate to DeviceOps > Devices and select CSV Upload.

Select Upload Files and locate your CSV file for import, then select Submit.

You should receive confirmation that your upload was successful.

If you select Monitor the onboarding process here you will be brought to the Messages page for Bulk Uploads and can check the status of your upload by selecting View Details.

Once your import is complete you will see a green checkbox next to it under Summary in the table.

Upon successful upload, you will be able to navigate to DeviceOps > Devices and see your new devices listed there.


Did this page help you?