Bosch IoT Asset Communication

2021-04-16 - Device Provisioning

The Device Provisioning API v1 has been improved to allow specifying a requested-acks parameter for the Bosch IoT Things related part of provisioning and de-provisioning.

Example

Let us assume you provision a new device and - additionally to the request body - you request an acknowledgement from Bosch IoT Things: search-persisted.

The request in the scope of Bosch IoT Suite for Device Management might look like in the following snippet:

https://deviceprovisioning.eu-1.bosch-iot-suite.com/api/1/<your-instance-id>/devices?authScope=deviceManagementSubscription&requested-acks=search-persisted&timeout=5s

images/confluence/download/attachments/1679030332/provision-with-ack.png

Upon success you will get status code 201, the JSON result aggregated from Bosch IoT Hub and Bosch IoT Things, as well as various response headers.

As Bosch IoT Things would first persist the twin, and afterwards update the search index, the "search-persisted" is the "latest".

Therefore the complete response might delay for a second.
On the other hand, with "search-persisted" you get the guarantee that the search index is already updated for the newly created device.

images/confluence/download/attachments/1679030332/things-provision-with-ack.png

Find more details about Bosch IoT Things acknowledgements at https://docs.bosch-iot-suite.com/things/basic-concepts/ack/#acknowledgement-requests.