Merge pull request #295215 from kgremban/feb20-hubreliability

IoT Hub reliability - ADO 375944

Author: v-regandowner

articles/iot-hub/.openpublishing.redirection.iot-hub.json

@@ -1592,22 +1592,27 @@
     },
     {
       "source_path_from_root": "/articles/iot-hub/schedule-jobs-dotnet.md",
-      "redirect_url": "/azure/iot-hub/howto-schedule-broadcast-jobs",
+      "redirect_url": "/azure/iot-hub/how-to-schedule-broadcast-jobs",
       "redirect_document_id": false
     },
     {
       "source_path_from_root": "/articles/iot-hub/schedule-jobs-java.md",
-      "redirect_url": "/azure/iot-hub/howto-schedule-broadcast-jobs",
+      "redirect_url": "/azure/iot-hub/how-to-schedule-broadcast-jobs",
       "redirect_document_id": false
     },
     {
       "source_path_from_root": "/articles/iot-hub/schedule-jobs-python.md",
-      "redirect_url": "/azure/iot-hub/howto-schedule-broadcast-jobs",
+      "redirect_url": "/azure/iot-hub/how-to-schedule-broadcast-jobs",
+      "redirect_document_id": false
+    },
+    {
+      "source_path_from_root": "/articles/iot-hub/iot-hub-ha-dr.md",
+      "redirect_url": "/azure/iot-hub/how-to-schedule-broadcast-jobs",
       "redirect_document_id": false
     },
     {
       "source_path_from_root": "/articles/iot-hub/schedule-jobs-node.md",
-      "redirect_url": "/azure/iot-hub/howto-schedule-broadcast-jobs",
+      "redirect_url": "/azure/reliability/reliability-iot-hub?toc=/azure/iot-hub/toc.json&bc=/azure/iot-hub/breadcrumb/toc.json",
       "redirect_document_id": false
     }
   ]

articles/iot-hub/TOC.yml

@@ -157,14 +157,15 @@
       - name: Understanding IoT hub IP address
         displayName: service tags, firewall rules, IP filter
         href: iot-hub-understand-ip-address.md
-    - name: Scaling and availability
+    - name: Reliability and scaling
       items:
       - name: Best practices for large-scale IoT device deployments
         displayName: device provisioning, staggered provisioning schedule, reprovisioning devices, monitoring devices
         href: ../iot-dps/concepts-deploy-at-scale.md?toc=/azure/iot-hub/toc.json&bc=/azure/iot-hub/breadcrumb/toc.json
-      - name: High availability and disaster recovery
-        displayName: HA, DR, availability zone, failover, failback
-        href: iot-hub-ha-dr.md
+      - name: Reliability
+        href: ../reliability/reliability-iot-hub.md?toc=/azure/iot-hub/toc.json&bc=/azure/iot-hub/breadcrumb/toc.json
+      - name: Disable disaster recovery
+        href: how-to-disable-dr.md
     - name: Authentication and authorization
       items:
       - name: Microsoft Entra ID

articles/iot-hub/how-to-disable-dr.md

@@ -0,0 +1,52 @@
+---
+title: Disable disaster recovery in IoT Hub
+titleSuffix: Azure IoT Hub
+description: How to turn off disaster recovery failover for Azure IoT Hub in select regions using the Azure portal.
+author: kgremban
+ms.author: kgremban
+ms.service: azure-iot-hub
+ms.topic: how-to
+ms.date: 05/02/2025
+
+#Customer intent: As an engineer responsible for business continuity, I want to learn how to disable disaster recovery in IoT Hub so that I can avoid data replication outside of the region.
+---
+
+# Disable disaster recovery in IoT Hub
+
+IoT Hub provides Microsoft-initiated failover and manual failover by replicating data to the [paired region](../reliability//regions-paired.md) for each IoT hub. For some regions, you can avoid data replication outside of the region by disabling disaster recovery when creating an IoT hub.
+
+## Prerequisites
+
+To disable disaster recovery in IoT Hub, you need the following:
+
+* An Azure subscription. If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/).
+* The following regions support disabling disaster recovery:
+  * **Brazil South**; paired region, South Central US.
+  * **Southeast Asia (Singapore)**; paired region, East Asia (Hong Kong SAR).
+
+## Create an IoT hub without disaster recovery
+
+To disable disaster recovery in the Azure portal, follow these steps:
+
+1. Sign in to the [Azure portal](https://portal.azure.com/).
+
+1. In the Azure portal, [create your IoT hub](/azure/iot-hub/create-hub?tabs=portal) in one of the [supported regions](#prerequisites). Make sure that **Disaster recovery enabled** is unselected:
+
+    :::image type="content" source="media/iot-hub-ha-dr/singapore.png" alt-text="Screenshot that shows disaster recovery option for an IoT hub in Singapore region.":::
+
+1. Note that failover capability won't be available if you disable disaster recovery for an IoT hub.
+
+    :::image type="content" source="media/iot-hub-ha-dr/disaster-recovery-disabled.png" alt-text="Screenshot that shows disaster recovery disabled for an IoT hub in Singapore region.":::
+
+You can also disable disaster recovery when you create an IoT hub using an [ARM template](/azure/templates/microsoft.devices/iothubs?tabs=bicep#iothubproperties).
+
+## Disable disaster recovery for an existing IoT hub
+
+You can only disable disaster recovery to avoid data replication when you create an IoT hub. If you want to configure an existing IoT hub to disable disaster recovery, create a new IoT hub with disaster recovery disabled and then manually migrate your existing IoT hub.
+
+1. [Create a new IoT hub with disaster recovery disabled](#create-an-iot-hub-without-disaster-recovery).
+1. Follow [How to migrate an IoT hub](migrate-hub-state-cli.md) to manually migrate your existing IoT hub.
+
+## Related content
+
+- [Reliability in IoT Hub](../reliability/reliability-iot-hub.md)