.. role:: raw-html-m2r(raw)
   :format: html


Azure Device Update for IoT Hub client library for Python
=========================================================

The library provides access to the Device Update for IoT Hub service that enables customers to publish updates for their IoT devices to the cloud, and then deploy these updates to their devices (approve updates to groups of devices managed and provisioned in IoT Hub).

`Source code <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/deviceupdate/azure-iot-deviceupdate>`_ | `Package (PyPI) <https://aka.ms/azsdk/python/deviceupdate-pypi>`_ | `Product documentation <https://docs.microsoft.com/azure/iot-hub-device-update/understand-device-update>`_

*Disclaimer*
----------------

*Azure SDK Python packages support for Python 2.7 has ended 01 January 2022. For more information and questions, please refer to https://github.com/Azure/azure-sdk-for-python/issues/20691*

Getting started
---------------

Prerequisites
^^^^^^^^^^^^^


* Microsoft Azure Subscription: To call Microsoft Azure services, you need to create an `Azure subscription <https://azure.microsoft.com/free/>`_
* Device Update for IoT Hub instance
* Azure IoT Hub instance
* Python 3.6 or later is required to use this package.

Install the package
^^^^^^^^^^^^^^^^^^^

Install the Device Update for IoT Hub client library for Python with `pip <https://pypi.org/project/pip/>`_\ :

.. code-block:: bash

   pip install azure-iot-deviceupdate

Key concepts
------------

Device Update for IoT Hub is a managed service that enables you to deploy over-the-air updates for your IoT devices. The client library has one main component named **DeviceUpdateClient**. The component allows you to access all three main client services:


* **UpdatesOperations**\ : update management (import, enumerate, delete, etc.)
* **ManagementOperations**\ : deployment management (manage devices and deployments)

You can learn more about Device Update for IoT Hub by visiting `Device Update for IoT Hub <https://github.com/azure/iot-hub-device-update>`_.

Examples
--------

You can familiarize yourself with different APIs using `Samples <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/deviceupdate/azure-iot-deviceupdate/samples>`_.

Troubleshooting
---------------

The Device Update for IoT Hub client will raise exceptions defined in `Azure Core <https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/README.md>`_.

Next steps
----------

Get started with our `Samples <https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/deviceupdate/azure-iot-deviceupdate/samples>`_.

Contributing
------------

If you encounter any bugs or have suggestions, please file an issue in the `Issues <https://github.com/Azure/azure-sdk-for-python/issues>`_ section of the project.

:raw-html-m2r:`<!-- LINKS -->`


Indices and tables
------------------

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

.. toctree::
  :maxdepth: 5
  :glob:
  :caption: Developer Documentation

  azure.iot.deviceupdate.rst