Uprade from storage account from v1 to v2

Question

Uprade from storage account from v1 to v2

Tony Wetzler 40

I have to upgrade a storage account from v1 to v2. What are the steps involved to migrate it

0 comments

Answer accepted by question author

Jose Benjamin Solis Nolasco 12,201 Volunteer Moderator

Welcome to Microsoft Q&A

Hello @Tony Wetzler , I hope you are doing well.

If the storage account is General-purpose v1 (GPv1), you can upgrade it directly to General-purpose v2 (GPv2). The upgrade is performed in place, so you don't need to migrate the data to a new storage account.

Azure portal

Open the Storage account in the Azure portal.

Go to Settings > Configuration.

Under Account kind, select Upgrade.

Review the upgrade information.

Select the default blob access tier, Hot or Cool.

Enter the storage account name to confirm.

Select Upgrade.

The upgrade is permanent, so the account cannot be downgraded back to GPv1.

Azure CLI

You can also perform the upgrade with:

az storage account update \
  --resource-group <resource-group> \
  --name <storage-account> \
  --set kind=StorageV2 \
  --access-tier Hot

Replace Hot with Cool if that is the appropriate default access tier for your workload.

Microsoft has announced the retirement of GPv1, so it is recommended to complete the upgrade before the applicable retirement deadline.

Reference:

https://learn.microsoft.com/azure/storage/common/storage-account-upgrade

If my answer helped you, please consider marking it as accepted. This helps others in the community find similar solutions.

Harshavardhan Sriramula 0 Reputation points Microsoft External Staff Moderator

2026-08-02T20:12:05.0966667+00:00

Hello @Tony Wetzler ,

Following up to see if you had a chance to check the above response and if it was helpful. Please let me know if you have any questions.

If these answer your question, click "Upvote" which may be beneficial to other community members reading this thread.
Jose Benjamin Solis Nolasco 12,201 Reputation points Volunteer Moderator

2026-08-03T13:01:00.6666667+00:00

@Tony Wetzler Just following up, Do you need more guidance or assistance ?
Harshavardhan Sriramula 0 Reputation points Microsoft External Staff Moderator

2026-08-03T22:08:13.4233333+00:00

Hello @Tony Wetzler

Following up to see if you had a chance to check the above response and if it was helpful. Please let me know if you have any questions.

If these answer your question, click "Upvote" which may be beneficial to other community members reading this thread.

1 additional answer

Your answer

Harshavardhan Sriramula 0 Reputation points Microsoft External Staff Moderator

2026-08-02T20:12:05.0966667+00:00

Hello @Tony Wetzler ,

Following up to see if you had a chance to check the above response and if it was helpful. Please let me know if you have any questions.

If these answer your question, click "Upvote" which may be beneficial to other community members reading this thread.
Jose Benjamin Solis Nolasco 12,201 Reputation points Volunteer Moderator

2026-08-03T13:01:00.6666667+00:00

@Tony Wetzler Just following up, Do you need more guidance or assistance ?
Harshavardhan Sriramula 0 Reputation points Microsoft External Staff Moderator

2026-08-03T22:08:13.4233333+00:00

Hello @Tony Wetzler

Following up to see if you had a chance to check the above response and if it was helpful. Please let me know if you have any questions.

If these answer your question, click "Upvote" which may be beneficial to other community members reading this thread.

Answer 1

To upgrade an Azure Storage account from general-purpose v1 (GPv1) or Blob storage to general-purpose v2 (GPv2):

Review the impact before upgrading
- The upgrade is in-place, non-disruptive, and has no downtime or data loss.
- The upgrade is permanent. A GPv1 account cannot be downgraded back to GPv1, and a Blob storage account cannot be downgraded back to Blob storage.
- GPv2 uses a different pricing model, so review expected billing impact before upgrading.
- Choose the default blob access tier during upgrade: Hot or Cool. If not specified, the account is upgraded to Hot by default.
Upgrade in the Azure portal
- Sign in to the Azure portal.
- Open the storage account.
- Go to Settings > Configuration.
- Under Account kind, select Upgrade.
- In Confirm upgrade, enter the storage account name.
- Select Upgrade.

Upgrade with Azure PowerShell

Use the latest Az.Storage module.
Run:

   Set-AzStorageAccount -ResourceGroupName <resource-group> -Name <storage-account> -UpgradeToStorageV2 -AccessTier <Hot/Cool>

Upgrade with Azure CLI

Use the latest Azure CLI.
Run:

   az storage account update -g <resource-group> -n <storage-account> --set kind=StorageV2 --access-tier=<Hot/Cool>

Validate after upgrade
- Confirm the account kind is now StorageV2.
- Validate application behavior, especially anything that depends on account kind or pricing/tier behavior.
- Test in a staging environment before upgrading production if the storage account is used by applications.

Important notes:

Upgrading a v1 storage account to GPv2 is free.
Changing the access tier after the upgrade can affect billing, so setting the intended tier during the upgrade is recommended.
GPv1 accounts retire on October 13, 2026. Existing GPv1 accounts must be upgraded by then to avoid service disruption.

References: