Merge pull request #291840 from andrewbrownmsft/docs-editor/troubleshoot-storage-1733949631

Create article troubleshoot-storage

Author: v-dirichards

articles/iot-hub-device-update/toc.yml

@@ -115,6 +115,9 @@ items:
     href: migration-public-preview-refresh-to-ga.md
   - name: Troubleshoot
     items:
+    - name: Troubleshoot storage-related errors when importing updates
+      href: troubleshoot-storage.md
+      displayName: update, import, storage
     - name: Troubleshoot device updates
       href: troubleshoot-device-update.md
     - name: Troubleshoot proxy updates

articles/iot-hub-device-update/troubleshoot-storage.md

@@ -0,0 +1,40 @@
+---
+# Required metadata
+# For more information, see https://review.learn.microsoft.com/en-us/help/platform/learn-editor-add-metadata?branch=main
+# For valid values of ms.service, ms.prod, and ms.topic, see https://review.learn.microsoft.com/en-us/help/platform/metadata-taxonomies?branch=main
+
+title: Troubleshoot storage-related errors when importing updates in Device Update for IoT Hub
+description: How to troubleshoot storage-related errors when importing updates
+author:      andrewbrownmsft # GitHub alias
+ms.author: andbrown
+ms.service: azure-iot
+ms.topic: error-reference
+ms.date:     12/11/2024
+---
+
+# Troubleshoot storage-related errors when importing updates in Device Update for IoT Hub
+
+When importing an update to Device Update for IoT Hub, you may see this error:
+
+*“The permissions on this storage container prevent access to your files. Add the Storage Blob Data Contributor role to your user account. Learn more.”*
+
+To resolve the error, follow these steps:
+
+1. In the Azure portal, search for the "Storage accounts" service in the search bar at the top of the page. Select the "Storage accounts" service.
+
+1. In the Storage accounts view, locate the Storage account that you’re using with Device Update for IoT Hub. Select that account.
+
+1. In the selected Storage account, select the "Containers" option under the "Data storage" header. Locate the container that you’re using with Device Update for IoT Hub. Select that container.
+
+1. In the Container view, select "Access Control (IAM)" from the left-hand navigation menu. Select "Add" -> "Add role assignment" from the top menu.
+
+1. In the Role tab, search for the "Storage Blob Data Contributor" role and select it, then select the "Next" button.
+
+1. In the Members tab, keep the default selection of "User, group or service principal" and select the "Select members" link. In the right-hand flyout menu, search for your user account, select it, and choose the "Select" button. Then select the "Next" button.
+
+1. In the Conditions tab, make no changes and select the "Next" button.
+
+1. In the Review + assign tab, select the "Review + assign" button.
+
+After completing these steps, wait a few minutes for the change to propagate, and then try the Device Update for IoT Hub import experience again from the beginning.
+