Merge pull request #231237 from tamram/tamram23-0316

classic account migration docs

Author: v-stsavell

articles/storage/.openpublishing.redirection.storage.json

@@ -470,6 +470,11 @@
             "redirect_url": "/azure/storage/blobs/authorize-managed-identity",
             "redirect_document_id": false
         },
+        {
+            "source_path_from_root": "/articles/storage/common/storage-account-migrate-classic.md",
+            "redirect_url": "/azure/storage/common/classic-account-migrate",
+            "redirect_document_id": false
+        },
         {
             "source_path_from_root": "/articles/storage/blobs/authorize-managed-identity.md",
             "redirect_url": "/azure/storage/blobs/authorize-access-azure-active-directory",

articles/storage/blobs/TOC.yml

@@ -128,7 +128,7 @@ items:
       items:
       - name: Overview
         href: ../common/storage-account-overview.md?toc=/azure/storage/blobs/toc.json&bc=/azure/storage/blobs/breadcrumb/toc.json
-      - name: Premium performance
+      - name: Premium block blob
         href: storage-blob-block-blob-premium.md
     - name: Authorization
       items:
@@ -329,8 +329,14 @@ items:
           href: ../common/storage-account-move.md?toc=/azure/storage/blobs/toc.json&bc=/azure/storage/blobs/breadcrumb/toc.json
         - name: Upgrade to Data Lake Storage Gen2
           href: upgrade-to-data-lake-storage-gen2-how-to.md
-        - name: Migrate a classic account to Azure Resource Manager
-          href: ../common/storage-account-migrate-classic.md?toc=/azure/storage/blobs/toc.json&bc=/azure/storage/blobs/breadcrumb/toc.json
+        - name: Migrate to Azure Resource Manager
+          items:
+          - name: Overview
+            href: ../common/classic-account-migration-overview.md?toc=/azure/storage/blobs/toc.json&bc=/azure/storage/blobs/breadcrumb/toc.json
+          - name: Understand the migration process
+            href: ../common/classic-account-migration-process.md?toc=/azure/storage/blobs/toc.json&bc=/azure/storage/blobs/breadcrumb/toc.json
+          - name: Migrate a classic storage account to Resource Manager
+            href: ../common/classic-account-migrate.md?toc=/azure/storage/blobs/toc.json&bc=/azure/storage/blobs/breadcrumb/toc.json
       - name: Create and manage containers
         items:
         - name: Manage containers (Azure portal)

articles/storage/common/classic-account-migrate.md

@@ -0,0 +1,93 @@
+---
+title: How to migrate your classic storage accounts to Azure Resource Manager
+titleSuffix: Azure Storage
+description: Learn how to migrate your classic storage accounts to the Azure Resource Manager deployment model. All classic accounts must be migrated by August 31, 2024.
+services: storage
+author: tamram
+
+ms.service: storage
+ms.topic: how-to
+ms.date: 03/27/2023
+ms.author: tamram
+ms.subservice: common
+---
+
+# How to migrate your classic storage accounts to Azure Resource Manager
+
+Microsoft will retire classic storage accounts on August 31, 2024. To preserve the data in any classic storage accounts, you must migrate them to the Azure Resource Manager deployment model by that date. After you migrate your account, all of the benefits of the Azure Resource Manager deployment model will be available for that account. For more information about the deployment models, see [Resource Manager and classic deployment](../../azure-resource-manager/management/deployment-models.md).
+
+This article describes how to migrate your classic storage accounts to the Azure Resource Manager deployment model. For more information, see [Migrate your classic storage accounts to Azure Resource Manager by August 31, 2024](classic-account-migration-overview.md).
+
+## Identify classic storage accounts in your subscription
+
+# [Portal](#tab/azure-portal)
+
+To list classic storage accounts in your subscription with the Azure portal:
+
+1. Navigate to the list of your storage accounts in the Azure portal.
+1. Select **Add filter**. In the **Filter** dialog, set the **Filter** field to **Type** and the **Operator** field to **Equals**. Then set the **Value** field to **microsoft.classicstorage/storageaccounts**.
+
+    :::image type="content" source="media/classic-account-migrate/classic-accounts-list-portal.png" alt-text="Screenshot showing how to list classic storage accounts in Azure portal." lightbox="media/classic-account-migrate/classic-accounts-list-portal.png":::
+
+# [PowerShell](#tab/azure-powershell)
+
+To list classic storage accounts in your subscription with PowerShell, run the following command:
+
+```azurepowershell
+Get-AzResource -ResourceType Microsoft.ClassicStorage/storageAccounts
+```
+
+# [Azure CLI](#tab/azure-cli)
+
+To list classic storage accounts in your subscription with Azure CLI, run the following command:
+
+```azurecli
+$ az resource list \
+  --resource-type Microsoft.ClassicStorage/storageAccounts \
+  --query "[].{resource_type:type, name:name}" \
+  --output table 
+```
+
+---
+
+## Migrate a classic storage account
+
+To migrate a classic storage account to the Azure Resource Manager deployment model with the Azure portal:
+
+1. Navigate to your classic storage account in the Azure portal.
+1. In the **Settings** section, click **Migrate to ARM**.
+1. Click on **Validate** to determine migration feasibility.
+
+   :::image type="content" source="./media/classic-account-migrate/validate-storage-account.png" alt-text="Screenshot showing how to migrate your classic storage account to Azure Resource Manager." lightbox="./media/classic-account-migrate/validate-storage-account.png":::
+
+1. After a successful validation, click on **Prepare** button to simulate the migration.
+
+  > [!IMPORTANT]
+  > There may be a delay of a few minutes after validation is complete before the Prepare button is enabled.
+
+1. If the Prepare step completes successfully, you'll see a link to the new resource group. Select that link to navigate to the new resource group. The migrated storage account appears under the **Resources** tab in the **Overview** page for the new resource group.
+
+    At this point you can compare the configuration and data in the classic storage account to the newly migrated storage account. You'll see both in the list of storage accounts in the portal. Both the classic account and the migrated account have the same name.
+
+    :::image type="content" source="media/classic-account-migrate/compare-classic-migrated-accounts.png" alt-text="Screenshot showing the results of the Prepare step in the Azure portal." lightbox="media/classic-account-migrate/compare-classic-migrated-accounts.png":::
+
+1. If you're not satisfied with the results of the migration, select **Abort** to delete the new storage account and resource group. You can then address any problems and try again.
+1. When you're ready to commit, type **yes** to confirm, then select **Commit** to complete the migration.
+
+### Locate and delete disk artifacts in a classic account
+
+Classic storage accounts may contain classic (unmanaged) disks, virtual machine images, and operating system (OS) images. To migrate the account, you may need to delete these artifacts first.
+
+To delete disk artifacts from the Azure portal, follow these steps:
+
+1. Navigate to the Azure portal.
+1. In the **Search** bar at the top, search for **Disks (classic)**, **OS Images (classic)**, or **VM Images (classic)** to display classic disk artifacts.
+1. Locate the classic disk artifact to delete, and select it to view its properties.
+1. Select the **Delete** button to delete the disk artifact.
+
+    :::image type="content" source="media/classic-account-migrate/delete-disk-artifacts-portal.png" alt-text="Screenshot showing how to delete classic disk artifacts in Azure portal." lightbox="media/classic-account-migrate/delete-disk-artifacts-portal.png":::
+
+## See also
+
+- [Migrate your classic storage accounts to Azure Resource Manager by August 31, 2024](classic-account-migration-overview.md)
+- [Understand storage account migration from the classic deployment model to Azure Resource Manager](classic-account-migration-process.md)

articles/storage/common/classic-account-migration-overview.md

@@ -0,0 +1,63 @@
+---
+title: We're retiring classic storage accounts on August 31, 2024
+titleSuffix: Azure Storage
+description: Overview of migration of classic storage accounts to the Azure Resource Manager deployment model. All classic accounts must be migrated by August 31, 2024.
+services: storage
+author: tamram
+
+ms.service: storage
+ms.topic: conceptual
+ms.date: 03/27/2023
+ms.author: tamram
+ms.subservice: common
+---
+
+# Migrate your classic storage accounts to Azure Resource Manager by August 31, 2024
+
+The [Azure Resource Manager](../../azure-resource-manager/management/overview.md) deployment model now offers extensive functionality for Azure Storage accounts. For this reason, we deprecated the management of classic storage accounts through Azure Service Manager (ASM) on August 31, 2021. Classic storage accounts will be fully retired on August 31, 2024. All data in classic storage accounts must be migrated to Azure Resource Manager storage accounts by that date.
+
+If you have classic storage accounts, start planning your migration now. Complete it by August 31, 2024, to take advantage of Azure Resource Manager. To learn more about the benefits of Azure Resource Manager, see [The benefits of using Resource Manager](../../azure-resource-manager/management/overview.md#the-benefits-of-using-resource-manager).
+
+Storage accounts created using the classic deployment model will follow the [Modern Lifecycle Policy](https://support.microsoft.com/help/30881/modern-lifecycle-policy) for retirement.
+
+## How does this affect me?
+
+- Subscriptions created after August 31, 2022 can no longer create classic storage accounts.
+- Subscriptions created before September 1, 2022 will be able to create classic storage accounts until September 1, 2023.
+- On September 1, 2024, customers will no longer be able to connect to classic storage accounts by using Azure Service Manager. Any data still contained in these accounts will no longer be accessible through Azure Service Manager.
+
+> [!WARNING]
+> If you do not migrate your classic storage accounts to Azure Resource Manager by August 31, 2024, you will permanently lose access to the data in those accounts.
+
+## What resources are available for this migration?
+
+- If you have questions, get answers from community experts in [Microsoft Q&A](/answers/tags/98/azure-storage-accounts).
+- If your organization or company has partnered with Microsoft or works with Microsoft representatives, such as cloud solution architects (CSAs) or customer success account managers (CSAMs), contact them for additional resources for migration.
+- If you have a support plan and you need technical help, create a support request in the Azure portal:
+
+    1. Search for **Help + support** in the [Azure portal](https://portal.azure.com#view/Microsoft_Azure_Support/HelpAndSupportBlade/~/overview).
+    1. Select **Create a support request**.
+    1. Under **Summary**, type a description of your issue.
+    1. Under **Issue type**, select **Technical**.
+    1. Under **Subscription**, select your subscription.
+    1. Under **Service**, select **My services**.
+    1. Under **Service type**, select **Storage Account Management**.
+    1. Under **Resource**, select the resource you want to migrate.
+    1. Under **Problem type**, select **Data Migration**.
+    1. Under **Problem subtype**, select **Migrate account to new resource group/subscription/region/tenant**.
+    1. Select **Next**, then follow the instructions to submit your support request.
+
+## What actions should I take?
+
+To migrate your classic storage accounts, you should:
+
+1. Identify all classic storage accounts in your subscription.
+1. Migrate any classic storage accounts to Azure Resource Manager.
+1. Check your applications and logs to determine whether you are dynamically creating, updating, or deleting classic storage accounts from your code, scripts, or templates. If you are, then you need to update your applications to use Azure Resource Manager accounts instead.
+
+For step-by-step instructions, see [How to migrate your classic storage accounts to Azure Resource Manager](classic-account-migrate.md).
+
+## See also
+
+- [How to migrate your classic storage accounts to Azure Resource Manager](classic-account-migrate.md)
+- [Understand storage account migration from the classic deployment model to Azure Resource Manager](classic-account-migration-process.md)