Device Update for IoT Hub Resource Management
To get started with Device Update you'll need to create a Device Update account, instance and set access control roles.
- Access to an IoT Hub. It is recommended that you use a S1 (Standard) tier or above.
- Supported browsers:
- Microsoft Edge
- Google Chrome
Create a device update account
Go to Azure portal
Click Create a Resource and search for "Device Update for IoT Hub"
Click Create -> Device Update for IoT Hub
Specify the Azure Subscription to be associated with your Device Update Account and Resource Group
Specify a Name and Location for your Device Update Account
You can go to Azure Products-by-region page to discover the regions where Device Update for IoT Hub is available. If Device Update for IoT Hub is not available in your region you can choose to create an account in an available region closest to you.
Optionally, you can check the box to assign the Device Update administrator role to yourself. You can also use the steps listed in the "Configure access control roles" section to provide a combination of roles to users and applications for the right level of access.
Click Next: Review + create>
Review the details and then select Create. You will see your deployment is in progress.
You will see the deployment status change to "complete" in a few minutes. Click Go to resource
Create a device update instance
An instance of Device Update is associated with a single IoT hub. Select the IoT hub that will be used with Device Update. We will create a new Shared Access policy during this step to ensure Device Update uses only the required permissions to work with IoT Hub (registry write and service connect). This policy ensures that access is only limited to Device Update.
To create a Device Update instance after an account has been created.
Once you are in your newly created account resource, go to the Instance Management Instances blade
Click Create and specify an instance name and select your IoT Hub
The IoT Hub you link to your Device Update resource, doesn't need to be in the same region as your Device Update Account. However, for better performance it is recommended that your IoT Hub be in a region same as or close to the region of your Device Update account.
Click Create. You will see the instance in a "Creating" state.
Allow 5-10 mins for the instance deployment to complete. Refresh the status till you see the "Provisioning State" turn to "Succeeded".
Configure IoT Hub
In order for Device Update to receive change notifications from IoT Hub, Device Update integrates with the "Built-In" Event Hub. Clicking the "Configure IoT Hub" button configures the required message routes and access policy required to communicate with IoT devices.
To configure IoT Hub
Once the Instance "Provisioning State" turns to "Succeeded", select the instance in the Instance Management blade. Click Configure IoT Hub
Select I agree to make these changes
If you are using a Free tier of Azure IoT Hub, the allowed number of message routes are limited to 5. Device Update for IoT Hub needs to configure 4 message routes to work as expected.
Configure access control roles
In order for other users to have access to Device Update, users must be granted access to this resource. You can skip this step if you assigned the Device Update administrator role to yourself during account creation and don't need to provide access to additional users or applications.
Go to Access control (IAM) within the Device Update account
Click Add role assignments
Under Role tab, select a Device Update role from the given options
- Device Update Administrator
- Device Update Reader
- Device Update Content Administrator
- Device Update Content Reader
- Device Update Deployments Administrator
- Device Update Deployments Reader
Assign access to a user or Azure AD group
Click Review + assign
Review the new role assignments and click Review + assign again
You are now ready to use the Device Update experience from within your IoT Hub
Try updating a device using one of the following quick tutorials:
- Device update on a simulator
- Device update on Raspberry Pi
- Device update on Ubuntu Server 18.04 x64 Package agent