Merge pull request #284884 from kgremban/aug16-dpsfresh

DPS freshness; index and portal qs

Author: denrea

articles/iot-dps/index.yml

@@ -1,15 +1,15 @@
 ### YamlMime:Landing
 
-title: Azure IoT Hub Device Provisioning Service (DPS) Documentation
-summary: The IoT Hub Device Provisioning Service (DPS) is a helper service for IoT Hub that enables zero-touch, just-in-time provisioning to the right IoT hub without requiring human intervention, allowing customers to provision millions of devices in a secure and scalable manner. Learn how to provision devices to your IoT hub(s) with our quickstarts, tutorials, and samples.
+title: Azure IoT Hub Device Provisioning Service Documentation
+summary: The IoT Hub Device Provisioning Service (DPS) is a helper service for IoT Hub that enables zero-touch, just-in-time provisioning to the right IoT hub without requiring human intervention, allowing customers to provision millions of devices in a secure and scalable manner. Learn how to provision devices to your IoT hubs with our quickstarts, tutorials, and samples.
 
 metadata:
-  title: Azure IoT Hub Device Provisioning Service (DPS) Documentation
+  title: Azure IoT Hub Device Provisioning Service Documentation
   description: Azure IoT Hub Device Provisioning Service (DPS) - Tutorials, Quickstarts, HowTos, and API Reference
   author: kgremban
   ms.service: iot-dps
   ms.topic: landing-page
-  ms.date: 04/26/2022
+  ms.date: 08/16/2024
   ms.author: kgremban
 
 # linkListType: architecture | concept | deploy | download | get-started | how-to-guide | learn | overview | quickstart | reference | sample | tutorial | video | whats-new

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

@@ -1,22 +1,22 @@
 ---
-title: Quickstart - Set up Device Provisioning Service in portal
+title: Quickstart - Set up in portal
 titleSuffix: Azure IoT Hub Device Provisioning Service
 description: Quickstart - Set up the Azure IoT Hub Device Provisioning Service (DPS) in the Microsoft Azure portal
 author: kgremban
 ms.author: kgremban
 manager: lizross
-ms.date: 04/06/2023
+ms.date: 08/16/2024
 ms.topic: quickstart
 ms.service: iot-dps
 services: iot-dps
 ms.custom: mvc, mode-ui
 ---
 
-# Quickstart: Set up the IoT Hub Device Provisioning Service with the Azure portal
+# Quickstart: Set up IoT Hub Device Provisioning Service with the Azure portal
 
-In this quickstart, you learn how to set up the IoT Hub Device Provisioning Service in the Azure portal. The IoT Hub Device Provisioning Service enables zero-touch, just-in-time device provisioning to any IoT hub. The Device Provisioning Service enables customers to provision millions of IoT devices in a secure and scalable manner, without requiring human intervention. Azure IoT Hub Device Provisioning Service supports IoT devices with TPM, symmetric key, and X.509 certificate authentications. For more information, please refer to [IoT Hub Device Provisioning Service overview](about-iot-dps.md).
+In this quickstart, you learn how to set up Azure IoT Hub Device Provisioning Service in the Azure portal. Device Provisioning Service enables zero-touch, just-in-time device provisioning to any IoT hub. The Device Provisioning Service enables customers to provision millions of IoT devices in a secure and scalable manner, without requiring human intervention. Azure IoT Hub Device Provisioning Service supports IoT devices with TPM, symmetric key, and X.509 certificate authentications.
 
-To provision your devices, you first perform the following steps:
+Before you can provision your devices, you first perform the following steps:
 
 > [!div class="checklist"]
 > * Use the Azure portal to create an IoT hub
@@ -33,7 +33,7 @@ If you don't have an Azure subscription, create a [free Azure account](https://a
 
 ## Create a new IoT Hub Device Provisioning Service instance
 
-1. In the Azure portal, select the **+ Create a resource** button.
+1. In the Azure portal, select **Create a resource**.
 
 1. From the **Categories** menu, select **Internet of Things**, and then select **IoT Hub Device Provisioning Service**.
 
@@ -42,11 +42,11 @@ If you don't have an Azure subscription, create a [free Azure account](https://a
     | Property | Value |
     | --- | --- |
     | **Subscription** | Select the subscription to use for your 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). |
+    | **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 that you created in the previous steps. By putting all related resources in a group together, you can manage them together. |
     | **Name** | Provide a unique name for your new Device Provisioning Service instance. If the name you enter is available, a green check mark appears. |
     | **Region** | 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="Screenshot showing the Basics tab of the IoT Hub device provisioning service. Enter basic information about your Device Provisioning Service instance in the portal blade.":::
+    :::image type="content" source="./media/quick-setup-auto-provision/create-iot-dps-portal.png" alt-text="Screenshot showing the Basics tab of the IoT Hub device provisioning service. Enter basic information about your Device Provisioning Service instance in the portal.":::
 
 1. Select **Review + create** to validate your provisioning service.
 
@@ -56,11 +56,11 @@ If you don't have an Azure subscription, create a [free Azure account](https://a
 
 ## Link the IoT hub and your Device Provisioning Service instance
 
-In this section, you add a configuration to the Device Provisioning Service instance. This configuration sets the IoT hub for which the instance provisions IoT devices.
+In this section, you add a configuration to the Device Provisioning Service instance. This configuration sets the IoT hub to which the instance provisions IoT devices.
 
-1. In the **Settings** menu, select **Linked IoT hubs**.
+1. In the **Settings** menu of your Device Provisioning Service instance, select **Linked IoT hubs**.
 
-1. Select **+ Add**.
+1. Select **Add**.
 
 1. On the **Add link to IoT hub** panel, provide the following information: 
 
@@ -70,29 +70,23 @@ In this section, you add a configuration to the Device Provisioning Service inst
     | **IoT hub** | Select the IoT hub to link with your new Device Provisioning System instance. |
     | **Access Policy** | Select **iothubowner (RegistryWrite, ServiceConnect, DeviceConnect)** as the credentials for establishing the link with the IoT hub. |
 
-    :::image type="content" source="./media/quick-setup-auto-provision/link-iot-hub-to-dps-portal.png" alt-text="Screenshot showing how to link an IoT hub to the Device Provisioning Service instance in the portal blade."::: 
+    :::image type="content" source="./media/quick-setup-auto-provision/link-iot-hub-to-dps-portal.png" alt-text="Screenshot showing how to link an IoT hub to the Device Provisioning Service instance in the portal."::: 
 
 1. Select **Save**.
 
-1. Select **Refresh**. You should now see the selected hub under the **Linked IoT hubs** blade.
+1. Select **Refresh**. You should now see the selected hub under the list of **Linked IoT hubs**.
 
 ## Clean up resources
 
 The rest of the Device Provisioning Service quickstarts and tutorials use the resources that you created in this quickstart. However, if you don't plan on doing any more quickstarts or tutorials, delete these resources.
 
 To clean up resources in the Azure portal:
 
-1. From the left-hand menu in the Azure portal, select **All resources**.
+1. In the Azure portal, navigate to the resource group that you used in this quickstart.
 
-1. Select your Device Provisioning Service instance.
+1. If you want to delete the resource group and all of the resources it contains, select **Delete resource group**.
 
-1. At the top of the device detail pane, select **Delete**.  
-
-1. From the left-hand menu in the Azure portal, select **All resources**.
-
-1. Select your IoT hub.
-
-1. At the top of the hub detail pane, select **Delete**.  
+   Otherwise, select your Device Provisioning Service instance and your IoT hub from the list of resources, then select **Delete**.  
 
 ## Next steps