Merge pull request #303839 from MicrosoftDocs/main

Auto Publish – main to live - 2025-08-05 11:00 UTC

Author: learn-build-service-prod[bot]

articles/azure-resource-manager/templates/copy-resources.md

@@ -3,7 +3,7 @@ title: Deploy multiple instances of resources
 description: Use copy operation and arrays in an Azure Resource Manager template (ARM template) to deploy resource type many times.
 ms.topic: how-to
 ms.custom: devx-track-arm-template
-ms.date: 04/28/2025
+ms.date: 08/05/2025
 ---
 
 # Resource iteration in ARM templates
@@ -12,10 +12,10 @@ This article shows you how to create more than one instance of a resource in you
 
 You can also use copy loop with [properties](copy-properties.md), [variables](copy-variables.md), and [outputs](copy-outputs.md).
 
-If you need to specify whether a resource is deployed at all, see [condition element](conditional-resource-deployment.md).
+If you need to specify if a resource is deployed at all, see the [condition](conditional-resource-deployment.md) element.
 
 > [!TIP]
-> We recommend [Bicep](../bicep/overview.md) because it offers the same capabilities as ARM templates and the syntax is easier to use. To learn more, see [loops](../bicep/loops.md).
+> [Bicep](../bicep/overview.md) is recommended since it offers the same capabilities as ARM templates, and the syntax is easier to use. To learn more, see [loops](../bicep/loops.md).
 
 ## Syntax
 
@@ -32,26 +32,24 @@ Add the `copy` element to the resources section of your template to deploy multi
 
 The `name` property is any value that identifies the loop. The `count` property specifies the number of iterations you want for the resource type.
 
-Use the `mode` and `batchSize` properties to specify if the resources are deployed in parallel or in sequence. These properties are described in [Serial or Parallel](#serial-or-parallel).
+Use the `mode` and `batchSize` properties to specify if the resources are deployed in parallel or in sequence. These properties are described in [serial or parallel](#serial-or-parallel).
 
 ## Copy limits
 
-The count can't exceed 800.
+The count can't exceed 800 or be a negative number. It can be zero if you deploy the template with a recent version of the Azure CLI, PowerShell, or REST API. Specifically, you must use:
 
-The count can't be a negative number. It can be zero if you deploy the template with a recent version of Azure CLI, PowerShell, or REST API. Specifically, you must use:
+- Azure PowerShell **2.6** or later.
+- Azure CLI **2.0.74** or later.
+- REST API version **2019-05-10** or later.
+- API version **2019-05-10** or later for the deployment resource type during [linked deployments](linked-templates.md).
 
-- Azure PowerShell **2.6** or later
-- Azure CLI **2.0.74** or later
-- REST API version **2019-05-10** or later
-- [Linked deployments](linked-templates.md) must use API version **2019-05-10** or later for the deployment resource type
+Earlier versions of PowerShell, CLI, and the REST API don't support zero for the count.
 
-Earlier versions of PowerShell, CLI, and the REST API don't support zero for count.
-
-Be careful using [complete mode deployment](deployment-modes.md) with copy loop. If you redeploy with complete mode to a resource group, any resources that aren't specified in the template after resolving the copy loop are deleted.
+Be careful using [complete mode deployment](deployment-modes.md) with the copy loop. If you redeploy with complete mode to a resource group, any resources that aren't specified in the template after resolving the copy loop are deleted.
 
 ## Resource iteration
 
-The following example creates the number of storage accounts specified in the `storageCount` parameter.
+The following example creates the number of storage accounts specified in the `storageCount` parameter:
 
 ```json
 {
@@ -113,7 +111,7 @@ Creates these names:
 
 The copy operation is helpful when working with arrays because you can iterate through each element in the array. Use the `length` function on the array to specify the count for iterations, and `copyIndex` to retrieve the current index in the array.
 
-The following example creates one storage account for each name provided in the parameter.
+The following example creates one storage account for each name provided in the parameter:
 
 ```json
 {
@@ -153,11 +151,11 @@ The following example creates one storage account for each name provided in the
 }
 ```
 
-If you want to return values from the deployed resources, you can use [copy in the outputs section](copy-outputs.md).
+If you want to return values from the deployed resources, you can [use copy in the **outputs** section](copy-outputs.md).
 
 ### Use symbolic name
 
-[Symbolic name](./resource-declaration.md#use-symbolic-name) will be assigned to resource copy loops. The loop index is zero-based. In the following example, `myStorages[1]` references the second resource in the resource loop.
+[Symbolic name](./resource-declaration.md#use-symbolic-name) will be assigned to resource copy loops. The loop index is zero-based. In the following example, `myStorages[1]` references the second resource in the resource loop:
 
 ```json
 {
@@ -200,7 +198,7 @@ If you want to return values from the deployed resources, you can use [copy in t
 }
 ```
 
-If the index is a runtime value, format the reference yourself.  For example
+If the index is a runtime value, format the reference yourself.  For example:
 
 ```json
 "outputs": {
@@ -211,17 +209,17 @@ If the index is a runtime value, format the reference yourself.  For example
 }
 ```
 
-Symbolic names can be used in [dependsOn arrays](./resource-dependency.md#depend-on-resources-in-a-loop). If a symbolic name is for a copy loop, all resources in the loop are added as dependencies. For more information, see [Depends on resources in a loop](./resource-dependency.md#depend-on-resources-in-a-loop).
+Symbolic names can be used in [dependsOn arrays](./resource-dependency.md#depend-on-resources-in-a-loop). If a symbolic name is for a copy loop, all resources in the loop are added as dependencies. For more information, see [depends-on resources in a loop](./resource-dependency.md#depend-on-resources-in-a-loop).
 
-## Serial or Parallel
+## Serial or parallel
 
-By default, Resource Manager creates the resources in parallel. It applies no limit to the number of resources deployed in parallel, other than the total limit of 800 resources in the template. The order in which they're created isn't guaranteed.
+By default, Resource Manager creates the resources in parallel. It applies no limit to the number of resources deployed in parallel other than the total limit of 800 resources in the template. The order in which they're created isn't guaranteed.
 
-However, you may want to specify that the resources are deployed in sequence. For example, when updating a production environment, you may want to stagger the updates so only a certain number are updated at any one time.
+However, you might want to specify that the resources are deployed in sequence. For example, when updating a production environment, you can stagger the updates so that only a certain number update at any one time.
 
-To serially deploy more than one instance of a resource, set `mode` to **serial** and `batchSize` to the number of instances to deploy at a time. With serial mode, Resource Manager creates a dependency on earlier instances in the loop, so it doesn't start one batch until the previous batch completes.
+To serially deploy more than one instance of a resource, set `mode` to **serial** and `batchSize` to the number of instances to deploy at a time. With serial mode, Resource Manager creates a dependency on earlier instances in the loop so that it doesn't start one batch until the previous batch completes.
 
-The value for `batchSize` can't exceed the value for `count` in the copy element.
+The value for `batchSize` can't exceed the value for `count` in the copy element:
 
 ```json
 {
@@ -261,7 +259,7 @@ The `mode` property also accepts **parallel**, which is the default value.
 
 You can't use a copy loop for a child resource. To create more than one instance of a resource that you typically define as nested within another resource, you must instead create that resource as a top-level resource. You define the relationship with the parent resource through the type and name properties.
 
-For example, suppose you typically define a dataset as a child resource within a data factory.
+For example, suppose you typically define a dataset as a child resource within a data factory:
 
 ```json
 {
@@ -286,11 +284,11 @@ For example, suppose you typically define a dataset as a child resource within a
 }
 ```
 
-To create more than one data set, move it outside of the data factory. The dataset must be at the same level as the data factory, but it's still a child resource of the data factory. You preserve the relationship between data set and data factory through the type and name properties. Since type can no longer be inferred from its position in the template, you must provide the fully qualified type in the format: `{resource-provider-namespace}/{parent-resource-type}/{child-resource-type}`.
+To create more than one dataset, move it outside of the data factory. The dataset must be at the same level as the data factory, but it's still a child resource of the data factory. The type and name properties preserve the relationship between the dataset and data factory. Since type can no longer be inferred from its position in the template, you must provide the fully qualified type in this format: `{resource-provider-namespace}/{parent-resource-type}/{child-resource-type}`.
 
-To establish a parent/child relationship with an instance of the data factory, provide a name for the data set that includes the parent resource name. Use the format: `{parent-resource-name}/{child-resource-name}`.
+To establish a parent/child relationship with an instance of the data factory, provide a name for the dataset that includes the parent resource name. Use this format: `{parent-resource-name}/{child-resource-name}`.
 
-The following example shows the implementation.
+The following example shows the implementation:
 
 ```json
 "resources": [
@@ -326,11 +324,11 @@ The following examples show common scenarios for creating more than one instance
 
 ## Next steps
 
-- To set dependencies on resources that are created in a copy loop, see [Define the order for deploying resources in ARM templates](./resource-dependency.md).
-- To go through a tutorial, see [Tutorial: Create multiple resource instances with ARM templates](template-tutorial-create-multiple-instances.md).
-- For a Learn module that covers resource copy, see [Manage complex cloud deployments by using advanced ARM template features](/training/modules/manage-deployments-advanced-arm-template-features/).
+- To set dependencies on resources that are created in a copy loop, see how to [define the order for deploying resources in ARM templates](./resource-dependency.md).
+- To go through a tutorial, see one for how to [create multiple resource instances with ARM templates](template-tutorial-create-multiple-instances.md).
+- For a Microsoft Learn module that covers resource copy, see how to [manage complex cloud deployments by using advanced ARM template features](/training/modules/manage-deployments-advanced-arm-template-features/).
 - For other uses of the copy loop, see:
   - [Property iteration in ARM templates](copy-properties.md)
   - [Variable iteration in ARM templates](copy-variables.md)
   - [Output iteration in ARM templates](copy-outputs.md)
-- For information about using copy with nested templates, see [Using copy](linked-templates.md#using-copy).
+- For information about using copy with nested templates, see how to [use copy](linked-templates.md#use-copy).