update the two quickstarts

Author: mumian

articles/azure-resource-manager/bicep/deployment-stacks.md

@@ -6,7 +6,7 @@ ms.custom: devx-track-azurecli, devx-track-azurepowershell, devx-track-bicep
 ms.date: 05/15/2024
 ---
 
-# Deployment stacks (Preview)
+# Deployment stacks
 
 An Azure deployment stack is a type of Azure resource that enables the management of a group of Azure resources as an atomic unit. When a Bicep file or an ARM JSON template is submitted to a deployment stack, it defines the resources that are managed by the stack. If a resource that was previously included in the template is removed, it will either be detached or deleted based on the specified _actionOnUnmanage_ behavior of the deployment stack. Similar to other Azure resources, access to the deployment stack can be restricted using Azure role-based access control (Azure RBAC).
 

articles/azure-resource-manager/bicep/media/quickstart-create-deployment-stacks/deployment-stack-portal.png

@@ -7,7 +7,7 @@ ms.custom: mode-api, devx-track-azurecli, devx-track-azurepowershell, devx-track
 # Customer intent: As a developer I want to use Bicep to create a deployment stack from a template spec.
 ---
 
-# Quickstart: Create and deploy a deployment stack with Bicep from template specs (Preview)
+# Quickstart: Create and deploy a deployment stack with Bicep from template specs
 
 This quickstart describes how to create a [deployment stack](deployment-stacks.md) from a template spec.
 
@@ -26,7 +26,7 @@ param resourceGroupLocation string = resourceGroup().location
 param storageAccountName string = 'store${uniqueString(resourceGroup().id)}'
 param vnetName string = 'vnet${uniqueString(resourceGroup().id)}'
 
-resource storageAccount 'Microsoft.Storage/storageAccounts@2022-09-01' = {
+resource storageAccount 'Microsoft.Storage/storageAccounts@2023-04-01' = {
   name: storageAccountName
   location: resourceGroupLocation
   kind: 'StorageV2'
@@ -35,7 +35,7 @@ resource storageAccount 'Microsoft.Storage/storageAccounts@2022-09-01' = {
   }
 }
 
-resource virtualNetwork 'Microsoft.Network/virtualNetworks@2022-11-01' = {
+resource virtualNetwork 'Microsoft.Network/virtualNetworks@2023-11-01' = {
   name: vnetName
   location: resourceGroupLocation
   properties: {
@@ -113,7 +113,7 @@ az group create \
   --name 'demoRg' \
   --location 'centralus'
 
-id=$(az ts show --name stackSpec --resource-group templateSpecRG --version "1.0" --query "id")
+id=$(az ts show --name 'stackSpec' --resource-group 'templateSpecRG' --version '1.0' --query 'id')
 
 az stack group create \
   --name demoStack \
@@ -130,14 +130,14 @@ New-AzResourceGroup `
   -Name "demoRg" `
   -Location "eastus"
 
-$id = (Get-AzTemplateSpec -ResourceGroupName templateSpecRG -Name stackSpec -Version "1.0").Versions.Id
+$id = (Get-AzTemplateSpec -ResourceGroupName "templateSpecRG" -Name "stackSpec" -Version "1.0").Versions.Id
 
 New-AzResourceGroupDeploymentStack `
-  -Name 'demoStack' `
-  -ResourceGroupName 'demoRg' `
+  -Name "demoStack" `
+  -ResourceGroupName "demoRg" `
   -TemplateSpecId $id `
   -ActionOnUnmanage "detachAll" `
-  -DenySettingsMode none
+  -DenySettingsMode "none"
 ```
 
 ---
@@ -171,14 +171,14 @@ The output shows two managed resources - one storage account and one virtual net
     "excludedPrincipals": null,
     "mode": "none"
   },
-  "deploymentId": "/subscriptions/00000000-0000-0000-0000-000000000000/demoRg/providers/Microsoft.Resources/deployments/demoStack-2023-06-08-14-58-28-fd6bb",
+  "deploymentId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Resources/deployments/demoStack-240517162aqmf",
   "deploymentScope": null,
   "description": null,
   "detachedResources": [],
-  "duration": "PT30.1685405S",
+  "duration": "PT30.5642429S",
   "error": null,
   "failedResources": [],
-  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/demoRg/providers/Microsoft.Resources/deploymentStacks/demoStack",
+  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Resources/deploymentStacks/demoStack",
   "location": null,
   "name": "demoStack",
   "outputs": null,
@@ -189,51 +189,62 @@ The output shows two managed resources - one storage account and one virtual net
   "resources": [
     {
       "denyStatus": "none",
-      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/demoRg/providers/Microsoft.Network/virtualNetworks/vnetthmimleef5fwk",
+      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetthmimleef5fwk",
       "resourceGroup": "demoRg",
       "status": "managed"
     },
     {
       "denyStatus": "none",
-      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/demoRg/providers/Microsoft.Storage/storageAccounts/storethmimleef5fwk",
+      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Storage/storageAccounts/storethmimleef5fwk",
       "resourceGroup": "demoRg",
       "status": "managed"
     }
   ],
   "systemData": {
-    "createdAt": "2023-06-08T14:58:28.377564+00:00",
-    "createdBy": "johndole@contoso.com",
+    "createdAt": "2024-05-17T16:07:51.172012+00:00",
+    "createdBy": "jgao@microsoft.com",
     "createdByType": "User",
-    "lastModifiedAt": "2023-06-08T14:58:28.377564+00:00",
-    "lastModifiedBy": "johndole@contoso.com",
+    "lastModifiedAt": "2024-05-17T16:07:51.172012+00:00",
+    "lastModifiedBy": "jgao@microsoft.com",
     "lastModifiedByType": "User"
   },
-  "tags": null,
+  "tags": {},
   "template": null,
-  "templateLink": null,
+  "templateLink": {
+    "contentVersion": null,
+    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/stackSpec/versions/1.0",
+    "queryString": null,
+    "relativePath": null,
+    "resourceGroup": "templateSpecRG",
+    "uri": null
+  },
   "type": "Microsoft.Resources/deploymentStacks"
 }
 ```
 
 # [PowerShell](#tab/azure-powershell)
 
 ```azurepowershell
-Get-AzResourceGroupDeploymentStack -ResourceGroupName demoRg -Name demoStack
+Get-AzResourceGroupDeploymentStack `
+  -ResourceGroupName "demoRg" `
+  -Name "demoStack"
 ```
 
 The output shows two managed resources - one virtual network, and one storage account:
 
 ```output
-Id                          : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Resources/deploymentStacks/demoStack
-Name                        : demoStack
-ProvisioningState           : succeeded
-ResourcesCleanupAction      : detach
-ResourceGroupsCleanupAction : detach
-DenySettingsMode            : none
-CreationTime(UTC)           : 6/5/2023 8:55:48 PM
-DeploymentId                : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Resources/deployments/demoStack-2023-06-05-20-55-48-38d09
-Resources                   : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetzu6pnx54hqubm
-                              /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Storage/storageAccounts/storezu6pnx54hqubm
+Id                            : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Resources/deploymentStacks/demoStack
+Name                          : demoStack
+ProvisioningState             : succeeded
+resourcesCleanupAction        : detach
+resourceGroupsCleanupAction   : detach
+managementGroupsCleanupAction : detach
+CorrelationId                 : e91d07b8-90f0-48f4-b876-07fcadcc4c66
+DenySettingsMode              : none
+CreationTime(UTC)             : 5/17/2024 3:53:52 PM
+DeploymentId                  : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Resources/deployments/demoStack-24051715frp6o
+Resources                     : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetthmimleef5fwk
+                                /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Storage/storageAccounts/storethmimleef5fwk
 ```
 
 ---
@@ -244,8 +255,8 @@ You can also verify the deployment by list the managed resources in the deployme
 
 ```azurecli
 az stack group show \
-  --name 'demoStack'
-  --resource-group 'demoRg'
+  --name 'demoStack' \
+  --resource-group 'demoRg' \
   --output 'json'
 ```
 
@@ -266,11 +277,11 @@ The output is similar to:
     "excludedPrincipals": null,
     "mode": "none"
   },
-  "deploymentId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Resources/deployments/demoStack-2023-06-05-20-55-48-38d09",
+  "deploymentId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Resources/deployments/demoStack-240517162aqmf",
   "deploymentScope": null,
   "description": null,
   "detachedResources": [],
-  "duration": "PT29.006353S",
+  "duration": "PT30.5642429S",
   "error": null,
   "failedResources": [],
   "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Resources/deploymentStacks/demoStack",
@@ -284,28 +295,35 @@ The output is similar to:
   "resources": [
     {
       "denyStatus": "none",
-      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetzu6pnx54hqubm",
+      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetthmimleef5fwk",
       "resourceGroup": "demoRg",
       "status": "managed"
     },
     {
       "denyStatus": "none",
-      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Storage/storageAccounts/storezu6pnx54hqubm",
+      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Storage/storageAccounts/storethmimleef5fwk",
       "resourceGroup": "demoRg",
       "status": "managed"
     }
   ],
   "systemData": {
-    "createdAt": "2023-06-05T20:55:48.006789+00:00",
-    "createdBy": "johndole@contoso.com",
+    "createdAt": "2024-05-17T16:07:51.172012+00:00",
+    "createdBy": "jgao@microsoft.com",
     "createdByType": "User",
-    "lastModifiedAt": "2023-06-05T20:55:48.006789+00:00",
-    "lastModifiedBy": "johndole@contoso.com",
+    "lastModifiedAt": "2024-05-17T16:07:51.172012+00:00",
+    "lastModifiedBy": "jgao@microsoft.com",
     "lastModifiedByType": "User"
   },
-  "tags": null,
+  "tags": {},
   "template": null,
-  "templateLink": null,
+  "templateLink": {
+    "contentVersion": null,
+    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/templateSpecRG/providers/Microsoft.Resources/templateSpecs/stackSpec/versions/1.0",
+    "queryString": null,
+    "relativePath": null,
+    "resourceGroup": "templateSpecRG",
+    "uri": null
+  },
   "type": "Microsoft.Resources/deploymentStacks"
 }
 ```
@@ -321,8 +339,8 @@ The output is similar to:
 ```output
 Status  DenyStatus Id
 ------  ---------- --
-managed none       /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetzu6pnx54hqubm
-managed none       /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Storage/storageAccounts/storezu6pnx54hqubm
+managed none       /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Network/virtualNetworks/vnetthmimleef5fwk
+managed none       /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/demoRg/providers/Microsoft.Storage/storageAccounts/storethmimleef5fwk
 ```
 
 ---
@@ -355,8 +373,8 @@ For more information, see [Delete deployment stacks](./deployment-stacks.md#dele
 
 ```azurepowershell
 Remove-AzResourceGroupDeploymentStack `
-  -Name demoStack `
-  -ResourceGroupName demoRg `
+  -Name "demoStack" `
+  -ResourceGroupName "demoRg" `
   -ActionOnUnmanage "deleteAll"
 ```
 
@@ -383,20 +401,36 @@ For more information, see [Delete deployment stacks](./deployment-stacks.md#dele
 
 The remove command only remove the managed resources and managed resource groups. You still need to delete the resource group.
 
-# [CLI](#tab/CLI)
+# [CLI](#tab/azure-cli)
 
 ```azurecli
 az group delete --name 'demoRg'
 ```
 
-# [PowerShell](#tab/PowerShell)
+# [PowerShell](#tab/azure-powershell)
 
 ```azurepowershell
 Remove-AzResourceGroup -Name "demoRg"
 ```
 
 ---
 
+To delete the template spec and the resource group:
+
+# [CLI](#tab/azure-cli)
+
+```azurecli
+az group delete --name 'templateSpecRG'
+```
+
+# [PowerShell](#tab/azure-powershell)
+
+```azurepowershell
+Remove-AzResourceGroup -Name "templateSpecRG"
+```
+
+---
+
 ## Next steps
 
 > [!div class="nextstepaction"]