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, using the
POST /devices/bulk request. You provide what is essentially a device template along with a list of unique device identifiers. See the Devices API documentation for more information.
It's also possible to define a set of devices to be created using a CSV file. This file can be uploaded via the
/devices/csv_bulk_upload endpoint. The endpoint will process 1000 rows at a time, so to upload more, break the devices into multiple files.
|2||Unique ID||Unique 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).|
|3||Location||[Optional] A string describing the location of the device|
|4||Company ID||ID of the company account for this device|
|5||DeviceType ID||The ID of the device type for this device|
|6||Heartbeat Period||Heartbeat period in seconds|
|7||Cellular Number||[Optional] Cellular number associated with device|
|8||SMS Command Password||[Optional] Password for issuing commands via SMS|
|9||DeviceConfig ID||[Optional] ID of configuration to apply to these devices|
|11||Heartbeat Values||[Optional] A comma separated list of values to send along with heartbeat messages. Must be surrounded in quotes, e.g. |
|12||Device Integration ID||[Optional] ID of a device integration to assign to the device|
|13||Cloud Native Integration ID||[Optional] ID of a cloud-native integration to assign to the device|
|14||Parent Device ID||[Optional] If the device is a sensor type device, or endpoint, the ID (not unique ID) of the parent device|
|15||Tags||[Optional] Semicolon delimited list of tags to apply to this device, e.g. |
|16||Metadata||[Optional] Metadata to apply to this device. Semicolon delimited, colon separated key value pairs, e.g. |
|17||Delete?||[Optional] In order to bulk delete, you may put |
For a template, here is an example file to get you started.
See the Device API documentation for more information about the upload endpoint.
Updated 7 months ago