Merge pull request #196383 from kgremban/apr27-dpsazregions

Recommend availability zone regions for DPS

articles/iot-dps/about-iot-dps.md

@@ -106,7 +106,9 @@ DPS only supports HTTPS connections for service operations.
 
 ## Regions
 
-DPS is available in many regions. The updated list of existing and newly announced regions for all services is at [Azure Regions](https://azure.microsoft.com/regions/). You can check availability of the Device Provisioning Service on the [Azure Status](https://azure.microsoft.com/status/) page.
+DPS is available in many regions. The list supported regions for all services is available at [Azure Regions](https://azure.microsoft.com/regions/). You can check availability of the Device Provisioning Service on the [Azure Status](https://azure.microsoft.com/status/) page.
+
+For resiliency and reliability, we recommend deploying to one of the regions that support [Availability Zones](iot-dps-ha-dr.md).
 
 ### Data residency consideration
 

articles/iot-dps/quick-setup-auto-provision-cli.md

@@ -22,14 +22,13 @@ The Azure CLI is used to create and manage Azure resources from the command line
 
 [!INCLUDE [azure-cli-prepare-your-environment.md](../../includes/azure-cli-prepare-your-environment.md)]
 
-
 ## Create a resource group
 
-Create a resource group with the [az group create](/cli/azure/group#az-group-create) command. An Azure resource group is a logical container into which Azure resources are deployed and managed. 
+Create a resource group with the [az group create](/cli/azure/group#az-group-create) command. An Azure resource group is a logical container into which Azure resources are deployed and managed.
 
 The following example creates a resource group named *my-sample-resource-group* in the *westus* location.
 
-```azurecli-interactive 
+```azurecli-interactive
 az group create --name my-sample-resource-group --location westus
 ```
 
@@ -42,25 +41,26 @@ az group create --name my-sample-resource-group --location westus
 
 Create an IoT hub with the [az iot hub create](/cli/azure/iot/hub#az-iot-hub-create) command.
 
-The following example creates an IoT hub named *my-sample-hub* in the *westus* location. An IoT hub name must be globally unique in Azure, so you may want to add a unique prefix or suffix to the example name, or choose a new name altogether. Make sure your name follows proper naming conventions for an IoT hub: it should be 3-50 characters in length, and can contain only upper or lower case alphanumeric characters or hyphens ('-'). 
+The following example creates an IoT hub named *my-sample-hub* in the *westus* location. An IoT hub name must be globally unique in Azure, so you may want to add a unique prefix or suffix to the example name, or choose a new name altogether. Make sure your name follows proper naming conventions for an IoT hub: it should be 3-50 characters in length, and can contain only upper or lower case alphanumeric characters or hyphens ('-').
 
 ```azurecli-interactive 
 az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus
 ```
 
 ## Create a Device Provisioning Service
 
-Create a Device Provisioning Service with the [az iot dps create](/cli/azure/iot/dps#az-iot-dps-create) command. 
+Create a Device Provisioning Service with the [az iot dps create](/cli/azure/iot/dps#az-iot-dps-create) command.
 
 The following example creates a provisioning service named *my-sample-dps* in the *westus* location. You will also need to choose a globally unique name for your own provisioning service. Make sure it follows proper naming conventions for an IoT Hub Device Provisioning Service: it should be 3-64 characters in length and can contain only upper or lower case alphanumeric characters or hyphens ('-').
 
-```azurecli-interactive 
+```azurecli-interactive
 az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus
 ```
 
 > [!TIP]
 > The example creates the provisioning service in the West US location. You can view a list of available locations by running the command `az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table` or by going to the [Azure Status](https://azure.microsoft.com/status/) page and searching for "Device Provisioning Service". In commands, locations can be specified either in one word or multi-word format; for example: westus, West US, WEST US, etc. The value is not case sensitive. If you use multi-word format to specify location, enclose the value in quotes; for example, `--location "West US"`.
 >
+> For resiliency and reliability, we recommend deploying to one of the regions that support [Availability Zones](iot-dps-ha-dr.md).
 
 ## Get the connection string for the IoT hub
 

articles/iot-dps/quick-setup-auto-provision-rm.md

@@ -26,7 +26,6 @@ If your environment meets the prerequisites, and you're already familiar with us
 
 [!INCLUDE [azure-cli-prepare-your-environment.md](../../includes/azure-cli-prepare-your-environment.md)]
 
-
 ## Review the template
 
 The template used in this quickstart is from [Azure Quickstart Templates](https://azure.microsoft.com/resources/templates/iothub-device-provisioning/).
@@ -41,7 +40,6 @@ Two Azure resources are defined in the template above:
 * [**Microsoft.Devices/iothubs**](/azure/templates/microsoft.devices/iothubs): Creates a new Azure IoT Hub.
 * [**Microsoft.Devices/provisioningservices**](/azure/templates/microsoft.devices/provisioningservices): Creates a new Azure IoT Hub Device Provisioning Service with the new IoT Hub already linked to it.
 
-
 ## Deploy the template
 
 #### Deploy with the Portal
@@ -60,10 +58,10 @@ Two Azure resources are defined in the template above:
     | :---- | :---------- |
     | **Subscription** | Select your Azure subscription. |
     | **Resource group** | Click **Create new**, and enter a unique name for the resource group, and then click **OK**. |
-    | **Region** | Select a region for your resources. For example, **East US**. |
+    | **Region** | Select a region for your resources. For example, **East US**.  For resiliency and reliability, we recommend deploying to one of the regions that support [Availability Zones](iot-dps-ha-dr.md). |
     | **Iot Hub Name** | Enter a name for the IoT Hub that must be globally unique within the *.azure-devices.net* namespace. You need the hub name in the next section when you validate the deployment. |
     | **Provisioning Service Name** | Enter a name for the new Device Provisioning Service (DPS) resource. The name must be globally unique within the *.azure-devices-provisioning.net* namespace. You need the DPS name in the next section when you validate the deployment. |
-    
+
 3. On the next screen, read the terms. If you agree to all terms, click **Create**. 
 
     The deployment will take a few moments to complete. 

articles/iot-dps/quick-setup-auto-provision.md

@@ -35,7 +35,7 @@ You'll need an Azure subscription to begin with this article. You can create a [
 
 1. In the Azure portal, select **+ Create a resource** .
 
-1. From the **Categories** menu, select **Internet of Things** then **IoT Hub Device Provisioning Service**.
+2. From the **Categories** menu, select **Internet of Things** then **IoT Hub Device Provisioning Service**.
 
 3. Select **Create**.
 
@@ -44,7 +44,7 @@ You'll need an Azure subscription to begin with this article. You can create a [
     * **Name:** Provide a unique name for your new Device Provisioning Service instance. If the name you enter is available, a green check mark appears.
     * **Subscription:** Choose the subscription that you want to use to create this Device Provisioning Service instance.
     * **Resource group:** This field allows you to create a new resource group, or choose an existing one to contain the new instance. Choose the same resource group that contains the Iot hub you created in the previous steps. By putting all related resources in a group together, you can manage them together. For example, deleting the resource group deletes all resources contained in that group. For more information, see [Manage Azure Resource Manager resource groups](../azure-resource-manager/management/manage-resource-groups-portal.md).
-    * **Location:** Select the location that's closest to your devices.
+    * **Location:** Select a location that's close to your devices. For resiliency and reliability, we recommend deploying to one of the regions that support [Availability Zones](iot-dps-ha-dr.md).
 
         :::image type="content" source="./media/quick-setup-auto-provision/create-iot-dps-portal.png" alt-text="Enter basic information about your Device Provisioning Service instance in the portal blade":::
 

articles/iot-dps/tutorial-set-up-cloud.md

@@ -43,7 +43,7 @@ Follow these steps to create a new Device Provisioning Service instance.
    | **Name** | Any unique name | -- | 
    | **Subscription** | Your subscription  | For details about your subscriptions, see [Subscriptions](https://account.windowsazure.com/Subscriptions). |
    | **Resource group** | myResourceGroup | For valid resource group names, see [Naming rules and restrictions](/azure/architecture/best-practices/resource-naming). |
-   | **Location** | Any valid location | For information about regions, see [Azure Regions](https://azure.microsoft.com/regions/). |   
+   | **Location** | Any valid location | For information about regions, see [Azure Regions](https://azure.microsoft.com/regions/).  For resiliency and reliability, we recommend deploying to one of the regions that support [Availability Zones](iot-dps-ha-dr.md). |
 
    ![Enter basic information about your Device Provisioning Service in the portal](./media/tutorial-set-up-cloud/create-iot-dps-portal.png)