Merge pull request #212885 from mumian/0928-multi-instances

Refresh the multi-instance tutorial

Author: v-stsavell

articles/azure-resource-manager/templates/media/template-tutorial-create-multiple-instances/resource-manager-template-create-multiple-instances.png

@@ -2,7 +2,7 @@
 title: Create multiple resource instances
 description: Learn how to create an Azure Resource Manager template (ARM template) to create multiple Azure resource instances.
 author: mumian
-ms.date: 04/23/2020
+ms.date: 09/28/2022
 ms.topic: tutorial
 ms.author: jgao
 ms.custom: devx-track-azurepowershell
@@ -43,7 +43,7 @@ To complete this article, you need:
     ```
 
 1. Select **Open** to open the file.
-1. There is a `Microsoft.Storage/storageAccounts` resource defined in the template. Compare the template to the [template reference](/azure/templates/Microsoft.Storage/storageAccounts). It's helpful to get some basic understanding of the template before customizing it.
+1. There's a `Microsoft.Storage/storageAccounts` resource defined in the template. Compare the template to the [template reference](/azure/templates/Microsoft.Storage/storageAccounts). It's helpful to get some basic understanding of the template before customizing it.
 1. Select **File** > **Save As** to save the file as _azuredeploy.json_ to your local computer.
 
 ## Edit the template
@@ -55,9 +55,25 @@ From Visual Studio Code, make the following four changes:
 ![Azure Resource Manager creates multiple instances](./media/template-tutorial-create-multiple-instances/resource-manager-template-create-multiple-instances.png)
 
 1. Add a `copy` element to the storage account resource definition. In the `copy` element, you specify the number of iterations and a variable for this loop. The count value must be a positive integer and can't exceed 800.
-2. The `copyIndex()` function returns the current iteration in the loop. You use the index as the name prefix. `copyIndex()` is zero-based. To offset the index value, you can pass a value in the `copyIndex()` function. For example, `copyIndex(1)`.
-3. Delete the `variables` element, because it's not used anymore.
-4. Delete the `outputs` element. It's no longer needed.
+
+    ```json
+    "copy": {
+      "name": "storageCopy",
+      "count": 3
+    },
+    ```
+
+1. The `copyIndex()` function returns the current iteration in the loop. You use the index as the name prefix. `copyIndex()` is zero-based. To offset the index value, you can pass a value in the `copyIndex()` function. For example, `copyIndex(1)`.
+
+    ```json
+    "name": "[format('{0}storage{1}', copyIndex(), uniqueString(resourceGroup().id))]",
+    ```
+
+    ```
+
+1. Delete the `storageAccountName` parameter definition, because it's not used anymore.
+1. Delete the `outputs` element. It's no longer needed.
+1. Delete the `metadata` element.
 
 The completed template looks like:
 
@@ -70,10 +86,14 @@ The completed template looks like:
       "type": "string",
       "defaultValue": "Standard_LRS",
       "allowedValues": [
-        "Standard_LRS",
+        "Premium_LRS",
+        "Premium_ZRS",
         "Standard_GRS",
-        "Standard_ZRS",
-        "Premium_LRS"
+        "Standard_GZRS",
+        "Standard_LRS",
+        "Standard_RAGRS",
+        "Standard_RAGZRS",
+        "Standard_ZRS"
       ],
       "metadata": {
         "description": "Storage Account type"
@@ -83,22 +103,22 @@ The completed template looks like:
       "type": "string",
       "defaultValue": "[resourceGroup().location]",
       "metadata": {
-        "description": "Location for all resources."
+        "description": "Location for the storage account."
       }
     }
   },
   "resources": [
     {
       "type": "Microsoft.Storage/storageAccounts",
-      "apiVersion": "2019-04-01",
-      "name": "[concat(copyIndex(),'storage', uniqueString(resourceGroup().id))]",
+      "apiVersion": "2021-06-01",
+      "name": "[format('{0}storage{1}', copyIndex(), uniqueString(resourceGroup().id))]",
       "location": "[parameters('location')]",
       "sku": {
         "name": "[parameters('storageAccountType')]"
       },
       "kind": "StorageV2",
       "copy": {
-        "name": "storagecopy",
+        "name": "storageCopy",
         "count": 3
       },
       "properties": {}
@@ -107,6 +127,8 @@ The completed template looks like:
 }
 ```
 
+Save the changes.
+
 For more information about creating multiple instances, see [Resource iteration in ARM templates](./copy-resources.md)
 
 ## Deploy the template
@@ -146,7 +168,7 @@ For more information about creating multiple instances, see [Resource iteration
 
     ---
 
-After a successful template deployment you can display the three storage accounts created in the specified resource group. Compare the storage account names with the name definition in the template.
+After a successful template deployment, you can display the three storage accounts created in the specified resource group. Compare the storage account names with the name definition in the template.
 
 # [CLI](#tab/azure-cli)