Merge pull request #313205 from willmarkley/docs-editor/access-tiers-smart-1773685343

Update access-tiers-smart.md

Author: JamesJBarnett

articles/storage/blobs/access-tiers-online-manage.md

@@ -20,7 +20,7 @@ You can set a blob's access tier in any of the following ways:
 
 - By setting the account default access tier setting for the storage account. Blobs in the account inherit this access tier unless you explicitly override the setting for an individual blob.
 
-- By explicitly setting a blob's tier on upload. You can create a blob in the hot, cool, cold, or archive tier.
+- By explicitly setting a blob's tier on upload. You can create a blob in the hot, cool, cold, smart, or archive tier.
 - By changing an existing blob's tier with a Set Blob Tier operation. Typically, you would use this operation to move from a hotter tier to a cooler one.
 - By copying a blob with a Copy Blob operation. Typically, you would use this operation to move from a cooler tier to a hotter one.
 
@@ -64,7 +64,7 @@ To update the default access tier for an existing storage account in the Azure p
 
 To change the default access tier setting for a storage account with PowerShell, call the [Set-AzStorageAccount](/powershell/module/az.storage/set-azstorageaccount) command, specifying the new default access tier.
 
-```azurepowershell
+```azurepowershell-interactive
 $rgName = <resource-group>
 $accountName = <storage-account>
 
@@ -74,9 +74,9 @@ Set-AzStorageAccount -ResourceGroupName $rgName -Name $accountName -AccessTier C
 
 #### [Azure CLI](#tab/azure-cli)
 
-To change the default access tier setting for a storage account with PowerShell, call the [Set-AzStorageAccount](/powershell/module/az.storage/set-azstorageaccount) command, specifying the new default access tier.
+To change the default access tier setting for a storage account with Azure CLI, call the [az storage account update](/cli/azure/storage/account#az-storage-account-update) command, specifying the new default access tier.
 
-```azurecli
+```azurecli-interactive
 # Change the storage account tier to cool
 az storage account update \
     --resource-group <resource-group> \
@@ -94,7 +94,7 @@ N/A
 
 When you upload a blob to Azure Storage, you have two options for setting the blob's tier on upload:
 
-- You can explicitly specify the tier in which the blob will be created. This setting overrides the default access tier for the storage account. You can set the tier for a blob or set of blobs on upload to hot, cool, cold or archive.
+- You can explicitly specify the tier in which the blob will be created. This setting overrides the default access tier for the storage account. You can set the tier for a blob or set of blobs on upload to hot, cool, cold, smart or archive.
 - You can upload a blob without specifying a tier. In this case, the blob will be created in the default access tier specified for the storage account (either hot or cool).
 
 If you are uploading a new blob that uses an encryption scope, you cannot change the access tier for that blob.
@@ -125,11 +125,11 @@ To upload a blob or set of blobs to a specific tier from the Azure portal, follo
 
 To upload a blob or set of blobs to a specific tier with PowerShell, call the [Set-AzStorageBlobContent](/powershell/module/az.storage/set-azstorageblobcontent) command, as shown in the following example. Remember to replace the placeholder values in brackets with your own values:
 
-```azurepowershell
+```azurepowershell-interactive
 $rgName = <resource-group>
 $storageAccount = <storage-account>
 $containerName = <container>
-# tier can be hot, cool, cold, or archive
+# tier can be hot, cool, cold, smart, or archive
 $tier = <tier>
 
 # Get context object
@@ -154,9 +154,9 @@ Get-ChildItem -Path "C:\sample-blobs" -File -Recurse |
 
 ### [Azure CLI](#tab/azure-cli)
 
-To upload a blob to a specific tier with Azure CLI, call the [az storage blob upload](/cli/azure/storage/blob#az-storage-blob-upload) command, as shown in the following example. Remember to replace the placeholder values in brackets with your own values. Replace the `<tier>` placeholder with `hot`, `cool`, `cold`, or `archive`.
+To upload a blob to a specific tier with Azure CLI, call the [az storage blob upload](/cli/azure/storage/blob#az-storage-blob-upload) command, as shown in the following example. Remember to replace the placeholder values in brackets with your own values. Replace the `<tier>` placeholder with `hot`, `cool`, `cold`, `smart`, or `archive`.
 
-```azurecli
+```azurecli-interactive
 az storage blob upload \
     --account-name <storage-account> \
     --container-name <container> \
@@ -166,9 +166,9 @@ az storage blob upload \
     --auth-mode login
 ```
 
-To upload a set of blobs to a specific tier with Azure CLI, call the [az storage blob upload-batch](/cli/azure/storage/blob#az-storage-blob-upload-batch) command, as shown in the following example. Remember to replace the placeholder values in brackets with your own values. Replace the `<tier>` placeholder with `hot`, `cool`, `cold`, or `archive`.
+To upload a set of blobs to a specific tier with Azure CLI, call the [az storage blob upload-batch](/cli/azure/storage/blob#az-storage-blob-upload-batch) command, as shown in the following example. Remember to replace the placeholder values in brackets with your own values. Replace the `<tier>` placeholder with `hot`, `cool`, `cold`, `smart`, or `archive`.
 
-```azurecli
+```azurecli-interactive
 az storage blob upload-batch \
     --destination <container> \
     --source <source-directory> \
@@ -229,7 +229,7 @@ If a blob's access tier is inferred from the default account access tier setting
 
 To determine a blob's access tier and whether it's inferred from Azure PowerShell, retrieve the blob, then check its **AccessTier** and **AccessTierInferred** properties.
 
-```azurepowershell
+```azurepowershell-interactive
 $rgName = "<resource-group>"
 $storageAccount = "<storage-account>"
 $containerName = "<container>"
@@ -251,7 +251,7 @@ $blob.BlobProperties.AccessTierInferred
 
 To determine a blob's access tier and whether it's inferred from Azure CLI, retrieve the blob, then check its **blobTier** and **blobTierInferred** properties.
 
-```azurecli
+```azurecli-interactive
 az storage blob show \
     --container-name <container> \
     --name <blob> \
@@ -300,7 +300,7 @@ To change a blob's tier to a cooler tier in the Azure portal, follow these steps
 
 To change a blob's tier to a cooler tier with PowerShell, use the blob's **BlobClient** property to return a .NET reference to the blob, then call the **SetAccessTier** method on that reference. Remember to replace placeholders in angle brackets with your own values:
 
-```azurepowershell
+```azurepowershell-interactive
 # Initialize these variables with your values.
 $rgName = "<resource-group>"
 $accountName = "<storage-account>"
@@ -322,7 +322,7 @@ $blob.BlobClient.SetAccessTier($tier, $null, "Standard")
 
 To change a blob's tier to a cooler tier with Azure CLI, call the [az storage blob set-tier](/cli/azure/storage/blob#az-storage-blob-set-tier) command. Remember to replace placeholders in angle brackets with your own values:
 
-```azurecli
+```azurecli-interactive
 az storage blob set-tier \
     --account-name <storage-account> \
     --container-name <container> \
@@ -368,7 +368,7 @@ N/A
 
 To copy a blob to from cool to hot with PowerShell, call the [Start-AzStorageBlobCopy](/powershell/module/az.storage/start-azstorageblobcopy) command and specify the target tier. Remember to replace placeholders in angle brackets with your own values:
 
-```azurepowershell
+```azurepowershell-interactive
 # Initialize these variables with your values.
 $rgName = "<resource-group>"
 $accountName = "<storage-account>"
@@ -395,7 +395,7 @@ Start-AzStorageBlobCopy -SrcContainer $srcContainerName `
 
 To copy a blob to a warmer tier with Azure CLI, call the [az storage blob copy start](/cli/azure/storage/blob/copy#az-storage-blob-copy-start) command and specify the target tier. Remember to replace placeholders in angle brackets with your own values:
 
-```azurecli
+```azurecli-interactive
 az storage blob copy start \
     --source-container <source-container> \
     --source-blob <source-blob> \
@@ -436,7 +436,7 @@ N/A
 
 #### [PowerShell](#tab/azure-powershell)
 
-```azurepowershell
+```azurepowershell-interactive
 # Initialize these variables with your values.
     $rgName = "<resource-group>"
     $accountName = "<storage-account>"
@@ -475,7 +475,7 @@ N/A
 
 #### [Azure CLI](#tab/azure-cli)
 
-```azurecli
+```azurecli-interactive
 az storage blob list --account-name $accountName --account-key $key \
     --container-name $containerName --prefix $folderName \
     --query "[?properties.blobTier == 'Cool'].name" --output tsv \

articles/storage/blobs/access-tiers-overview.md

@@ -124,7 +124,7 @@ Changing a blob's tier from a warmer tier to a cooler one is instantaneous, as i
 
 Keep in mind the following points when changing a blob's tier:
 
-- You can't use **Set Blob Tier** to archive a a blob that uses an encryption scope. You can only use **Set Blob Tier** to move between online access tiers. For more information about encryption scopes, see [Encryption scopes for Blob storage](encryption-scope-overview.md).
+- You can't use **Set Blob Tier** to archive a blob that uses an encryption scope. You can only use **Set Blob Tier** to move between online access tiers. For more information about encryption scopes, see [Encryption scopes for Blob storage](encryption-scope-overview.md).
 
 - If a blob is explicitly moved to the cool or cold tier and then moved to the archive tier, the early deletion charge applies.
 
@@ -211,12 +211,12 @@ The cold tier requires the following minimum versions of REST, SDKs, and tools
 | Environment | Minimum version |
 |---|---|
 | [REST API](/rest/api/storageservices/blob-service-rest-api)| 2021-12-02 |
-| [.NET](/dotnet/api/azure.storage.blobs) | 12.15.0 |
-| [Java](/java/api/overview/azure/storage-blob-readme) | 12.21.0 |
-| [Python](/python/api/azure-storage-blob/) | 12.15.0 |
-| [JavaScript](/javascript/api/preview-docs/@azure/storage-blob/) | 12.13.0 |
-| [PowerShell (Az.Storage)](/powershell/azure/install-azure-powershell) | 5.8.0 |
-| [Azure CLI](/cli/azure/install-azure-cli) | 2.50.0 |
+| [.NET](/dotnet/api/overview/azure/storage) | 12.15.0 |
+| [Java](/java/api/overview/azure/storage) | 12.21.0 |
+| [Python](/python/api/overview/azure/storage) | 12.15.0 |
+| [JavaScript](/javascript/api/overview/azure/storage) | 12.13.0 |
+| [PowerShell (Az.Storage)](/powershell/module/az.storage) | 5.8.0 |
+| [Azure CLI](/cli/azure/storage) | 2.50.0 |
 | [AzCopy](../common/storage-use-azcopy-v10.md) | 10.18.1 |
 | [Azure Storage Explorer](quickstart-storage-explorer.md) | 1.29.0 |
 

articles/storage/blobs/access-tiers-smart.md

@@ -37,6 +37,56 @@ Smart tier is configured on the [default account access tier](access-tiers-overv
 You can move objects out of smart tier by setting a different online tier or changing the default account access tier to another tier. Once moved to an explicit tier, objects can't be tiered back to smart tier.
 To set the default access tier setting for a storage account, see [Set a blob's access tier](access-tiers-online-manage.md)
 
+#### [Portal](#tab/azure-portal)
+
+To set the default access tier to *Smart* for a storage account at create time in the Azure portal, follow these steps:
+
+1. Navigate to the **Storage accounts** page, and select the **Create** button.
+
+2. Fill out the **Basics** tab.
+
+3. On the **Advanced** tab, under **Blob storage**, set the **Access tier** to *Smart*.
+
+4. Select **Review + Create** to validate your settings and create your storage account.
+
+    :::image type="content" source="media/access-tiers-online-manage/set-default-access-tier-create-portal-smart.png" alt-text="Screenshot showing how to set the default access tier to Smart when creating a storage account.":::
+
+To update the default access tier to *Smart* for an existing storage account in the Azure portal, follow these steps:
+
+1. Navigate to the storage account in the Azure portal.
+
+2. Under **Settings**, select **Configuration**.
+
+3. Locate the **Blob access tier (default)** setting, and select *Smart*. The default setting is *Hot*, if you have not previously set this property.
+
+4. Save your changes.
+
+#### [PowerShell](#tab/azure-powershell)
+
+To configure `Smart` as the default access tier setting for a storage account with PowerShell, call the Azure REST API directly.
+
+```azurepowershell-interactive
+# Set variables
+$SubscriptionId = <subscription-id>
+$ResourceGroup = <resource-group>
+$StorageAccountName = <storage-account-name>
+
+# Update the storage account access tier to Smart
+$Path = "/subscriptions/$SubscriptionId/resourceGroups/$ResourceGroup/providers/Microsoft.Storage/storageAccounts/${StorageAccountName}?api-version=2025-08-01"
+$Payload = @{ properties = @{ accessTier = "Smart" } } | ConvertTo-Json -Depth 3
+
+Invoke-AzRestMethod -Method PATCH -Path $Path -Payload $Payload
+```
+
+#### [Azure CLI](#tab/azure-cli)
+
+To configure `Smart` as the default access tier setting for a storage account with Azure CLI, call the Azure REST API directly.
+
+```azurecli-interactive
+az rest --method patch --url "https://management.azure.com/subscriptions/<subscription-id>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account-name>?api-version=2025-08-01" --body '{"properties":{"accessTier":"Smart"}}'
+```
+
+---
 
 ## Working with smart tier
 All smart tiered objects are automatically managed across the underlying capacity tiers - hot, cool, and cold. Smart tier leverages the regular hot, cool, and cold access tiers in the background. These tiers are called the capacity tier. Smart tier doesn't support the archive tier or premium storage accounts. It works only on block blobs, page blobs aren't supported.