Updates to Azure IoT Hub reliability guide

Author: johndowns

articles/iot-hub/TOC.yml

@@ -163,7 +163,7 @@
         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
+        displayName: HA, DR, availability zone, failover, failback <!-- needs to be removed. replaced with new reliability guide -->
         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

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

@@ -0,0 +1,53 @@
+---
+title: Disable disaster recovery in IoT Hub
+titleSuffix: Azure IoT Hub
+description: How to send cloud-to-device messages from a back-end app and receive them on a device app using the Azure IoT SDKs for C#, Python, Java, and Node.js.
+author: kgremban
+ms.author: kgremban
+ms.service: azure-iot-hub
+ms.topic: how-to
+ms.date: 04/09/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/).
+* An Azure IoT Hub. If you don't have an IoT hub, create one using the [Azure portal](https://portal.azure.com/).
+* The following regions support disabling disaster recovery:
+  * **Brazil South**; paired region, South Central US.
+  * **Southeast Asia (Singapore)**; paired region, East Asia (Hong Kong SAR).
+
+## Disable disaster recovery for new IoT hubs
+
+To disable disaster recovery in the Azure portal, follow these steps:
+
+1. Log on 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 existing IoT hubs
+
+To configure your existing IoT hub to disable disaster recovery:
+
+1. [Create a new IoT hub with disaster recovery disabled](#disable-disaster-recovery-for-new-iot-hubs).
+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)

articles/iot-hub/iot-hub-ha-dr.md

@@ -12,6 +12,8 @@ ms.custom: references_regions
 
 # IoT Hub high availability and disaster recovery
 
+<!-- The content in this document fits within the reliability guide, and we've moved it across to that. It would be best to deprecate this document and redirect to the reliability guide. -->
+
 As a first step towards implementing a resilient IoT solution, architects, developers, and business owners must define the uptime goals for the solutions they're building. These goals can be defined primarily based on specific business objectives for each scenario. In this context, the article [Azure Business Continuity Technical Guidance](/azure/architecture/framework/resiliency/app-design) describes a general framework to help you think about business continuity and disaster recovery. The [Disaster recovery and high availability for Azure applications](/azure/architecture/reliability/disaster-recovery) paper provides architecture guidance on strategies for Azure applications to achieve high availability (HA) and disaster recovery (DR).
 
 Depending on the uptime goals you define for your IoT solutions, you should determine which of the options outlined in this article best suit your business objectives. Incorporating any of these HA/DR alternatives into your IoT solution requires a careful evaluation of the trade-offs between the:

articles/iot-hub/tutorial-manual-failover.md

@@ -26,7 +26,7 @@ In this tutorial, you perform the following tasks:
 > * Perform a failback to return the IoT hub's operations to the primary location. 
 > * Confirm the hub is running correctly in the right location.
 
-For more information about manual failover and Microsoft-initiated failover with IoT Hub, see [Cross region disaster recovery](iot-hub-ha-dr.md#cross-region-dr).
+For more information about manual failover and Microsoft-initiated failover with IoT Hub, see [Reliability in Azure IoT Hub](../reliability/reliability-iot-hub.md).
 
 ## Prerequisites
 

articles/reliability/regions-multi-region-nonpaired.md

@@ -62,7 +62,7 @@ For geo-replication of Event Grid topics in nonpaired regions, you can implement
 
 ## Azure IoT Hub 
 
-For geo-replication in nonpaired regions, use the [concierge pattern](/azure/iot-hub/iot-hub-ha-dr#achieve-cross-region-ha) for routing to a secondary IoT Hub. 
+To learn about how to create multi-region solutions using Azure IoT Hub, see [Reliability in Azure IoT Hub](./reliability-iot-hub.md).
 
 ## Azure Kubernetes Service (AKS)