---
id: "azure-device-update"
type: "component"
kind: "iot-hub"
provider: "azure"
category: "messaging"
docs: "https://learn.microsoft.com/en-us/azure/iot-hub-device-update/understand-device-update"
url: "https://localhost:3000/catalogue/components/azure-device-update"
---

# Device Update for IoT Hub

Over-the-air update service that distributes package-based and image-based updates to devices registered in an IoT hub.

| | |
|---|---|
| Provider | [azure](https://localhost:3000/catalogue?provider=azure) |
| Kind | [IoT hub](https://localhost:3000/catalogue/kinds/iot-hub) |
| Category | Messaging |
| Official docs | [https://learn.microsoft.com/en-us/azure/iot-hub-device-update/understand-device-update](https://learn.microsoft.com/en-us/azure/iot-hub-device-update/understand-device-update) |

## Properties

| property | type | values | required | kind default | this component |
|---|---|---|---|---|---|
| `automaticRollback` | boolean | — | no | — | inherited |
| `deltaUpdates` | boolean | — | no | false | inherited |
| `deviceCount` | integer | — | no | — | inherited |
| `deviceGrouping` | boolean | — | no | true | inherited |
| `deviceProvisioning` | boolean | — | no | — | inherited |
| `deviceTwin` | boolean | — | no | — | **true** |
| `managed` | boolean | — | no | false | **true** |
| `messagesPerDayLimit` | integer | — | no | — | inherited |
| `perDeviceIdentity` | boolean | — | no | true | inherited |
| `protocol` | enum | `mqtt`, `amqp`, `http`, `multi`, `lorawan` | no | — | inherited |
| `updateType` | enum | `package-based`, `image-based` | no | — | inherited |

Bold values are the ones this component pins.

## Rules that apply · 0

No rule selects this kind or its category.

## Other products of the same kind · 21

- [IoT Platform](https://localhost:3000/catalogue/components/alibaba-iot-platform.md) `alibaba-iot-platform` — alibabacloud
- [Alibaba Cloud Link WAN](https://localhost:3000/catalogue/components/alibaba-link-wan.md) `alibaba-link-wan` — alibabacloud
- [AWS IoT Core](https://localhost:3000/catalogue/components/aws-iot-core.md) `aws-iot-core` — aws
- [AWS IoT Device Management](https://localhost:3000/catalogue/components/aws-iot-device-management.md) `aws-iot-device-management` — aws
- [AWS IoT FleetWise](https://localhost:3000/catalogue/components/aws-iot-fleetwise.md) `aws-iot-fleetwise` — aws
- [Managed integrations for AWS IoT Device Management](https://localhost:3000/catalogue/components/aws-iot-managed-integrations.md) `aws-iot-managed-integrations` — aws
- [AWS IoT SiteWise](https://localhost:3000/catalogue/components/aws-iot-sitewise.md) `aws-iot-sitewise` — aws
- [AWS IoT Core for LoRaWAN](https://localhost:3000/catalogue/components/aws-iot-wireless.md) `aws-iot-wireless` — aws
- [Amazon Monitron](https://localhost:3000/catalogue/components/aws-monitron.md) `aws-monitron` — aws
- [Azure IoT Central](https://localhost:3000/catalogue/components/azure-iot-central.md) `azure-iot-central` — azure
- [Azure IoT Hub](https://localhost:3000/catalogue/components/azure-iot-hub.md) `azure-iot-hub` — azure
- [Eclipse Ditto](https://localhost:3000/catalogue/components/ditto.md) `ditto` — default
- [EMQX](https://localhost:3000/catalogue/components/emqx.md) `emqx` — default
- [HiveMQ](https://localhost:3000/catalogue/components/hivemq.md) `hivemq` — default
- [Eclipse Hono](https://localhost:3000/catalogue/components/hono.md) `hono` — default
- [Generic IoT hub](https://localhost:3000/catalogue/components/iot-hub.md) `iot-hub` — default
- [OPC UA server](https://localhost:3000/catalogue/components/opc-ua-server.md) `opc-ua-server` — default
- [ThingsBoard](https://localhost:3000/catalogue/components/thingsboard.md) `thingsboard` — default
- [VerneMQ](https://localhost:3000/catalogue/components/vernemq.md) `vernemq` — default
- [Manufacturing Connect](https://localhost:3000/catalogue/components/google-manufacturing-connect.md) `google-manufacturing-connect` — gcp
- [OCI Internet of Things Platform](https://localhost:3000/catalogue/components/oci-iot.md) `oci-iot` — oci

## Use it in a design

```yaml
nodes:
  - { id: "azure-device-update", component: "azure-device-update" }
```

## Source (`component` YAML, verbatim)

```yaml
# yaml-language-server: $schema=../../schema/component.schema.json
# Device Update for IoT Hub: the over-the-air update service that publishes, distributes and tracks firmware
# and package updates for devices registered in an IoT hub ("Introduction to Device Update for Azure IoT
# Hub"). That page states the service orchestrates the agent workflow through IoT Hub device twin properties,
# groups devices by compatibility properties and device twin tags, supports package-based and image-based
# updates, can roll back automatically to a fallback version, and offers delta updates in public preview.
schemaVersion: "1"
type: "component"
id: "azure-device-update"
kind: "iot-hub"
provider: "azure"
docs: "https://learn.microsoft.com/en-us/azure/iot-hub-device-update/understand-device-update"
defaults:
  managed: true
  deviceTwin: true
properties:
  updateType:
    type: "enum"
    values: ["package-based", "image-based"]
  deviceGrouping:
    type: "boolean"
    default: true
  automaticRollback:
    type: "boolean"
  deltaUpdates:
    type: "boolean"
    default: false
```

Human page: https://localhost:3000/catalogue/components/azure-device-update