Explicit device registration

In this step you will configure your device in the IoT Hub. To achieve this you will have to register a device in the IoT Hub. This defines the properties of the device identity.

Prerequisites

Your are logged in to the Bosch IoT Hub - Management API. Refer to Login to Bosch IoT Hub - Management API

Add device registration

The following steps are needed for the registration of a new device. Device registration is done by performing an HTTP POST request which contains the device identity information.

  1. In the Management API, navigate to the devices section and select the POST operation.

  2. Press the Try it out button.

  3. Enter your tenant-id in the tenant-id field (the tenant-id can be retrieved from the IoT Suite Portal as well).

  4. Check the Request body. You should make sure that the device-id is not already taken by another device of your subscription.

  5. In addition to the mandatory fields (enabled, device-id) additional custom fields can be added. Especially at registering a gateway that shall support Implicit device registration, you have to add the authorities option:

    {
      "enabled": true,
      "authorities": ["auto-provisioning-enabled"],
      "device-id": "org.example.acp:gw-01"
    }
    
  6. Finally run the request by hitting the Execute button.

  7. Verify that the request was successful (HTTP status code 201).

Your device has now been registered on the IoT Hub.

Note
Please take into account that the protocol adapters of the Bosch IoT Hub have a caching mechanism in place for devices and their credentials. That means if you make changes in the device’s or credentials' properties, it takes some time until the protocol adapters apply the changes. Currently the cache setting is configured to 10 minutes.
Corporate information Data protection notice Legal information Support Free plans