Skip to content

Files

Latest commit

JimacoMS4JimacoMS4
Change author on John Lian's Hub articles to Kelly
Feb 10, 2022
2894582 · Feb 10, 2022

History

History
75 lines (52 loc) · 3.76 KB

iot-hub-preview-mode.md

File metadata and controls

75 lines (52 loc) · 3.76 KB
title description services author ms.service ms.topic ms.date ms.author
Turn on preview mode for Azure IoT Hub
Learn how to turn on preview mode for IoT Hub, why you would want to, and some warnings
iot-hub
kgremban
iot-fundamentals
conceptual
11/24/2020
kgremban

Turn on preview mode for IoT Hub to try select new features

New features are in public preview for IoT Hub, including:

  • MQTT 5
  • ECC server certificate
  • TLS fragment length negotiation
  • X509 CA chain support for HTTPS/WebSocket

These features are improvements at the IoT Hub protocol and authentication layers, so they're only available for new IoT hub for now. They're not available for existing IoT hubs yet. To preview these features, the IoT hub must be created with preview mode turned on.

Turn on preview mode for a new IoT hub

  1. Sign in to the Azure portal.

  2. From the Azure homepage, select the + Create a resource button, and then enter IoT Hub in the Search the Marketplace field.

  3. Select IoT Hub from the search results, and then select Create.

  4. On the Basics tab, complete the fields as you normally would except for Region. Select one of these regions:

    • Central US
    • West Europe
    • South East Asia

  5. Select Management tab, then expand the Advanced settings section.

  6. Next to Preview mode, select On. Review the warning text carefully.

    :::image type="content" source="media/iot-hub-preview-mode/turn-on-preview-mode-at-create.png" alt-text="Image showing where to select the preview mode option when creating a new IoT hub":::

  7. Select Next: Review + create, then Create.

Once created, an IoT Hub in preview mode always shows this banner, letting you know to use this IoT hub for preview purposes only:

:::image type="content" source="media/iot-hub-preview-mode/banner.png" alt-text="Image showing banner for preview mode IoT hub":::

Using an IoT hub in preview mode

Do not use an IoT hub in preview mode for production. Preview mode is intended only to preview the select features listed at top of this page. Some other limitations to IoT Hub preview mode are

  • Some existing IoT Hub features such as IP filter, private link, managed identity, device streams, and failover may work unexpectedly or not at all.
  • An IoT hub in preview mode can't be changed or upgraded to a normal IoT hub.
  • We can't guarantee the normal IoT Hub SLA - do not use for production.

Tip

Preview mode isn't required for device streams and distributed tracing. To use these older preview features, follow the their documentation as normal.

Next steps