Bosch IoT Rollouts

Manage targets

Create a target

To create, i.e. to provision, a target go through the following steps:

  1. Click the + icon on the top right of the Targets view (its tooltip says Create target).

    images/confluence/download/attachments/2923973647/roUi-targets-createTarget1-version-2-modificationdate-1695722845000-api-v2.png
  2. In the dialog that opens up, fill in the fields:

    • Controller Id - a mandatory unique ID for the target.

    • Name - an optional user-friendly name. If one is not typed, the Controlled Id is assigned as Name as well.

    • Type - an optional type.

      Learn how to create one at Create a target type.

    • Description - an optional description of the target.

      images/confluence/download/attachments/2923973647/roUi-targets-createTarget2-version-2-modificationdate-1695723039000-api-v2.png
  3. Click Create.

The target will be shown as part of the Targets list.

Until it connects for the first time, its state will be UNKNOWN, also indicated by the question mark icon.

Learn how to complete the device registration here.

images/confluence/download/attachments/2923973647/roUi-targets-createTarget3-version-2-modificationdate-1695723176000-api-v2.png


Currently, targets can be provisioned also via API or via the classic Rollouts UI, see Device provisioning.

Edit a target

To edit a target, select it from the list and then open the target actions menu via the images/confluence/download/thumbnails/2923973647/wrench-version-1-modificationdate-1680854742000-api-v2.png icon.

Then select Edit.

images/confluence/download/attachments/2923973647/roUi-targets-editTarget-version-2-modificationdate-1695723497000-api-v2.png

In the dialog that opens up you can type a new or edit the current Name and Description:

images/confluence/download/attachments/2923973647/roUi-targets-editTarget2-version-3-modificationdate-1698147499000-api-v2.png

You can also select a new Type assigned to this target by using the dropdown:

images/confluence/download/attachments/2923973647/roUI-targets-editTarget2-editType-version-1-modificationdate-1698147401000-api-v2.png

Delete a target

To delete a target from your service instance, select a target on the list and then open the target actions menu via the images/confluence/download/thumbnails/2923973647/wrench-version-1-modificationdate-1680854742000-api-v2.png icon.

Then select images/confluence/download/thumbnails/2923973647/delete-version-1-modificationdate-1680854769000-api-v2.png Delete.

images/confluence/download/attachments/2923973647/roUi-targets-deleteTarget-version-3-modificationdate-1695723499000-api-v2.png


A dialog will prompt you to confirm your choice.

images/confluence/download/attachments/2923973647/image-2023-4-7_11-2-59-version-1-modificationdate-1680854579000-api-v2.png

Manage target metadata

To go through the basics of the Metadata section, visit Metadata.

On this page, we will focus on how you can manage it, i.e. on the respective create, edit, and delete actions.

In order to create a new metadata entry:

  1. Click the + icon on the right of the Metadata section (see the bottom of the rightmost column).

    images/confluence/download/attachments/2923973647/roUi-targets-metadata1-version-3-modificationdate-1695725006000-api-v2.png
  2. Type in the desired Key and Value in the Add metadata pop up.

    images/confluence/download/attachments/2923973647/roUi-targets-metadata2-version-3-modificationdate-1695724905000-api-v2.png
  3. Click Add.

  4. The new metadata entry will be then added to the list.

    images/confluence/download/attachments/2923973647/roUi-targets-metadata3-version-2-modificationdate-1695724634000-api-v2.png

You now have the possibility to delete or edit the value of each metadata entry through the respective icons on the right.

Create a rollout on manually selected targets

In some cases it is convenient to directly assign a distribution set to one or a few selected targets, for example to apply a hotfix to these targets.

To do that, follow these steps:

  1. While you are still in the Targets UI feature, select the targets which will be included in your rollout via the checkboxes in front them.

  2. Then click the first icon images/confluence/download/thumbnails/2923973647/box-delivery-version-1-modificationdate-1689163606000-api-v2.png on top of the target list (icon tooltip saying Create rollout for selected targets).

This will redirect you to the Rollouts UI feature and its Create rollout wizard. How to navigate through the wizard is explained in Create a rollout.

In case you have manually selected too many targets and thus the generated query exceeds the length restriction, you will be warned to create a rollout with a pre-saved target filter, as described in Create a rollout.

images/confluence/download/attachments/2923973647/manual-assignment-version-2-modificationdate-1689150410000-api-v2.png