You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: articles/azure-resource-manager/resource-manager-templates-parameters.md
+11-11
Original file line number
Diff line number
Diff line change
@@ -12,14 +12,14 @@ ms.devlang: na
12
12
ms.topic: conceptual
13
13
ms.tgt_pltfrm: na
14
14
ms.workload: na
15
-
ms.date: 05/18/2018
15
+
ms.date: 10/30/2018
16
16
ms.author: tomfitz
17
17
18
18
---
19
19
# Parameters section of Azure Resource Manager templates
20
-
In the parameters section of the template, you specify which values you can input when deploying the resources. These parameter values enable you to customize the deployment by providing values that are tailored for a particular environment (such as dev, test, and production). You do not have to provide parameters in your template, but without parameters your template would always deploy the same resources with the same names, locations, and properties.
20
+
In the parameters section of the template, you specify which values you can input when deploying the resources. These parameter values enable you to customize the deployment by providing values that are tailored for a particular environment (such as dev, test, and production). You don't have to provide parameters in your template, but without parameters your template would always deploy the same resources with the same names, locations, and properties.
21
21
22
-
You are limited to 255 parameters in a template. You can reduce the number of parameters by using objects that contain multiple properties, as shown in this article.
22
+
You're limited to 256 parameters in a template. You can reduce the number of parameters by using objects that contain multiple properties, as shown in this article.
23
23
24
24
## Define and use a parameter
25
25
@@ -93,7 +93,7 @@ The preceding example showed only some of the properties you can use in the para
93
93
94
94
## Template functions with parameters
95
95
96
-
When providing the default value for a parameter, you can use most template functions. You can use another parameter value to build a default value. The following template demonstrates the use of functions in the default value:
96
+
When specifying the default value for a parameter, you can use most template functions. You can use another parameter value to build a default value. The following template demonstrates the use of functions in the default value:
97
97
98
98
```json
99
99
"parameters": {
@@ -114,7 +114,7 @@ When providing the default value for a parameter, you can use most template func
114
114
}
115
115
```
116
116
117
-
You cannot use the `reference` function in the parameters section. Parameters are evaluated before deployment so the `reference` function cannot obtain the runtime state of a resource.
117
+
You can't use the `reference` function in the parameters section. Parameters are evaluated before deployment so the `reference` function can't get the runtime state of a resource.
118
118
119
119
## Objects as parameters
120
120
@@ -193,7 +193,7 @@ The following information can be helpful when you work with parameters:
193
193
* Resource names that you want to specify for easy identification.
194
194
* Values that you use frequently to complete other tasks (such as an admin user name).
195
195
* Secrets (such as passwords).
196
-
* The number or array of values to use when you create multiple instances of a resource type.
196
+
* The number or array of values to use when you create more than one instance of a resource type.
197
197
* Use camel case for parameter names.
198
198
* Provide a description of every parameter in the metadata:
199
199
@@ -208,7 +208,7 @@ The following information can be helpful when you work with parameters:
208
208
}
209
209
```
210
210
211
-
* Define default values for parameters (except for passwords and SSH keys). By providing a default value, the parameter becomes optional during deployment. The default value can be an empty string.
211
+
* Define default values for parameters (except for passwords and SSH keys). By specifying a default value, the parameter becomes optional during deployment. The default value can be an empty string.
212
212
213
213
```json
214
214
"parameters": {
@@ -222,7 +222,7 @@ The following information can be helpful when you work with parameters:
222
222
}
223
223
```
224
224
225
-
* Use **securestring** for all passwords and secrets. If you pass sensitive data in a JSON object, use the **secureObject** type. Template parameters with securestring or secureObject types cannot be read after resource deployment.
225
+
* Use **securestring** for all passwords and secrets. If you pass sensitive data in a JSON object, use the **secureObject** type. Template parameters with securestring or secureObject types can't be read after resource deployment.
226
226
227
227
```json
228
228
"parameters": {
@@ -235,7 +235,7 @@ The following information can be helpful when you work with parameters:
235
235
}
236
236
```
237
237
238
-
* Use a parameter to specify location, and share that parameter value as much as possible with resources that are likely to be in the same location. This approach minimizes the number of times users are asked to provide location information. If a resource type is supported in only a limited number of locations, you might want to specify a valid location directly in the template, or add another location parameter. When an organization limits the allowed regions for its users, the **resourceGroup().location** expression might prevent a user from being able to deploy the template. For example, one user creates a resource group in a region. A second user must deploy to that resource group but does not have access to the region.
238
+
* Use a parameter to specify location, and share that parameter value as much as possible with resources that are likely to be in the same location. This approach minimizes the number of times users are asked to provide location information. If a resource type is supported in only a limited number of locations, you might want to specify a valid location directly in the template, or add another location parameter. When an organization limits the allowed regions for its users, the **resourceGroup().location** expression might prevent a user from deploying the template. For example, one user creates a resource group in a region. A second user must deploy to that resource group but does not have access to the region.
239
239
240
240
```json
241
241
"resources": [
@@ -258,8 +258,8 @@ These example templates demonstrate some scenarios for using parameters. Deploy
258
258
259
259
|Template |Description |
260
260
|---------|---------|
261
-
|[parameters with functions for default values](https://github.com/Azure/azure-docs-json-samples/blob/master/azure-resource-manager/parameterswithfunctions.json)| Demonstrates how to use template functions when defining default values for parameters. The template does not deploy any resources. It constructs parameter values and returns those values. |
262
-
|[parameter object](https://github.com/Azure/azure-docs-json-samples/blob/master/azure-resource-manager/parameterobject.json)| Demonstrates using an object for a parameter. The template does not deploy any resources. It constructs parameter values and returns those values. |
261
+
|[parameters with functions for default values](https://github.com/Azure/azure-docs-json-samples/blob/master/azure-resource-manager/parameterswithfunctions.json)| Demonstrates how to use template functions when defining default values for parameters. The template doesn't deploy any resources. It constructs parameter values and returns those values. |
262
+
|[parameter object](https://github.com/Azure/azure-docs-json-samples/blob/master/azure-resource-manager/parameterobject.json)| Demonstrates using an object for a parameter. The template doesn't deploy any resources. It constructs parameter values and returns those values. |
0 commit comments