Skip to content

Commit 41c4335

Browse files
committed
resolve conflicts
2 parents 57905c8 + 15b2ee5 commit 41c4335

File tree

282 files changed

+127
-1078
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

282 files changed

+127
-1078
lines changed

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -144,7 +144,7 @@ If you use a [reference](template-functions-resource.md#reference) or [list](tem
144144

145145
Use the [if](template-functions-logical.md#if) function to make sure the function is only evaluated for conditions when the resource is deployed. See the [if function](template-functions-logical.md#if) for a sample template that uses `if` and `reference` with a conditionally deployed resource.
146146

147-
You set a [resource as dependent](define-resource-dependency.md) on a conditional resource exactly as you would any other resource. When a conditional resource isn't deployed, Azure Resource Manager automatically removes it from the required dependencies.
147+
You set a [resource as dependent](./resource-dependency.md) on a conditional resource exactly as you would any other resource. When a conditional resource isn't deployed, Azure Resource Manager automatically removes it from the required dependencies.
148148

149149
## Complete mode
150150

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

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -370,7 +370,7 @@ The following examples show common scenarios for creating more than one instance
370370

371371
## Next steps
372372

373-
- To set dependencies on resources that are created in a copy loop, see [Define the order for deploying resources in ARM templates](define-resource-dependency.md).
373+
- 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).
374374
- To go through a tutorial, see [Tutorial: Create multiple resource instances with ARM templates](../templates/template-tutorial-create-multiple-instances.md).
375375
- For a Microsoft Learn module that covers resource copy, see [Manage complex cloud deployments by using advanced ARM template features](/learn/modules/manage-deployments-advanced-arm-template-features/).
376376
- For other uses of the copy loop, see:
Lines changed: 12 additions & 134 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,20 @@
11
---
2-
title: Data types in templates (Bicep)
3-
description: Describes the data types that are available in Azure Resource Manager templates. (Bicep)
2+
title: Data types in Bicep
3+
description: Describes the data types that are available in Bicep
44
ms.topic: conceptual
55
author: mumian
66
ms.author: jgao
77

8-
ms.date: 03/04/2021
8+
ms.date: 05/05/2021
99
---
1010

11-
# Data types in ARM templates (Bicep)
11+
# Data types in Bicep
1212

13-
This article describes the data types supported in Azure Resource Manager templates (ARM templates). It covers both JSON and Bicep data types.
13+
This article describes the data types supported in [Bicep](./overview.md).
1414

1515
## Supported types
1616

17-
Within an ARM template, you can use these data types:
17+
Within a Bicep, you can use these data types:
1818

1919
* array
2020
* bool
@@ -26,28 +26,7 @@ Within an ARM template, you can use these data types:
2626

2727
## Arrays
2828

29-
Arrays start with a left bracket (`[`) and end with a right bracket (`]`).
30-
31-
In JSON, an array can be declared in a single line or multiple lines. Each element is separated by a comma.
32-
33-
In Bicep, an array must be declared in multiple lines. Don't use commas between values.
34-
35-
# [JSON](#tab/json)
36-
37-
```json
38-
"parameters": {
39-
"exampleArray": {
40-
"type": "array",
41-
"defaultValue": [
42-
1,
43-
2,
44-
3
45-
]
46-
}
47-
},
48-
```
49-
50-
# [Bicep](#tab/bicep)
29+
Arrays start with a left bracket (`[`) and end with a right bracket (`]`). In Bicep, an array must be declared in multiple lines. Don't use commas between values.
5130

5231
```bicep
5332
param exampleArray array = [
@@ -57,25 +36,8 @@ param exampleArray array = [
5736
]
5837
```
5938

60-
---
61-
6239
The elements of an array can be the same type or different types.
6340

64-
# [JSON](#tab/json)
65-
66-
```json
67-
"variables": {
68-
"mixedArray": [
69-
"[resourceGroup().name]",
70-
1,
71-
true,
72-
"example string"
73-
]
74-
}
75-
```
76-
77-
# [Bicep](#tab/bicep)
78-
7941
```bicep
8042
var mixedArray = [
8143
resourceGroup().name
@@ -85,80 +47,28 @@ var mixedArray = [
8547
]
8648
```
8749

88-
---
89-
9050
## Booleans
9151

9252
When specifying boolean values, use `true` or `false`. Don't surround the value with quotation marks.
9353

94-
# [JSON](#tab/json)
95-
96-
```json
97-
"parameters": {
98-
"exampleBool": {
99-
"type": "bool",
100-
"defaultValue": true
101-
}
102-
},
103-
```
104-
105-
# [Bicep](#tab/bicep)
106-
10754
```bicep
10855
param exampleBool bool = true
10956
```
11057

111-
---
112-
11358
## Integers
11459

11560
When specifying integer values, don't use quotation marks.
11661

117-
# [JSON](#tab/json)
118-
119-
```json
120-
"parameters": {
121-
"exampleInt": {
122-
"type": "int",
123-
"defaultValue": 1
124-
}
125-
}
126-
```
127-
128-
# [Bicep](#tab/bicep)
129-
13062
```bicep
13163
param exampleInt int = 1
13264
```
13365

134-
---
135-
136-
For integers passed as inline parameters, the range of values may be limited by the SDK or command-line tool you use for deployment. For example, when using PowerShell to deploy a template, integer types can range from -2147483648 to 2147483647. To avoid this limitation, specify large integer values in a [parameter file](parameter-files.md). Resource types apply their own limits for integer properties.
66+
For integers passed as inline parameters, the range of values may be limited by the SDK or command-line tool you use for deployment. For example, when using PowerShell to deploy a Bicep, integer types can range from -2147483648 to 2147483647. To avoid this limitation, specify large integer values in a [parameter file](parameter-files.md). Resource types apply their own limits for integer properties.
13767

13868
## Objects
13969

14070
Objects start with a left brace (`{`) and end with a right brace (`}`). Each property in an object consists of key and value. The key and value are separated by a colon (`:`).
14171

142-
# [JSON](#tab/json)
143-
144-
In JSON, the key is enclosed in double quotes. Each property is separated by a comma.
145-
146-
```json
147-
"parameters": {
148-
"exampleObject": {
149-
"type": "object",
150-
"defaultValue": {
151-
"name": "test name",
152-
"id": "123-abc",
153-
"isCurrent": true,
154-
"tier": 1
155-
}
156-
}
157-
}
158-
```
159-
160-
# [Bicep](#tab/bicep)
161-
16272
In Bicep, the key isn't enclosed by quotes. Don't use commas to between properties.
16373

16474
```bicep
@@ -186,53 +96,22 @@ Given the previous declaration, the expression x.y.z evaluates to the literal st
18696

18797
Property accessors can be used with any object. This includes parameters and variables of object types and object literals. Using a property accessor on an expression of non-object type is an error.
18898

189-
---
190-
19199
## Strings
192100

193-
In JSON, strings are marked with double quotes. In Bicep, strings are marked with singled quotes.
194-
195-
# [JSON](#tab/json)
196-
197-
```json
198-
"parameters": {
199-
"exampleString": {
200-
"type": "string",
201-
"defaultValue": "test value"
202-
}
203-
},
204-
```
205-
206-
# [Bicep](#tab/bicep)
101+
In Bicep, strings are marked with singled quotes.
207102

208103
```bicep
209104
param exampleString string = 'test value'
210105
```
211-
---
212106

213107
## Secure strings and objects
214108

215-
Secure string uses the same format as string, and secure object uses the same format as object. When you set a parameter to a secure string or secure object, the value of the parameter isn't saved to the deployment history and isn't logged. However, if you set that secure value to a property that isn't expecting a secure value, the value isn't protected. For example, if you set a secure string to a tag, that value is stored as plain text. Use secure strings for passwords and secrets.
109+
Secure string uses the same format as string, and secure object uses the same format as object. With Bicep, you add the `@secure()` modifier to a string or object.
216110

217-
With Bicep, you add the `@secure()` modifier to a string or object.
111+
When you set a parameter to a secure string or secure object, the value of the parameter isn't saved to the deployment history and isn't logged. However, if you set that secure value to a property that isn't expecting a secure value, the value isn't protected. For example, if you set a secure string to a tag, that value is stored as plain text. Use secure strings for passwords and secrets.
218112

219113
The following example shows two secure parameters:
220114

221-
# [JSON](#tab/json)
222-
223-
```json
224-
"parameters": {
225-
"password": {
226-
"type": "secureString"
227-
},
228-
"configValues": {
229-
"type": "secureObject"
230-
}
231-
}
232-
```
233-
234-
# [Bicep](#tab/bicep)
235-
236115
```bicep
237116
@secure()
238117
param password string
@@ -241,8 +120,7 @@ param password string
241120
param configValues object
242121
```
243122

244-
---
245123

246124
## Next steps
247125

248-
To learn about the template syntax, see [Understand the structure and syntax of ARM templates](../templates/template-syntax.md).
126+
To learn about the structure and syntax of Bicep, see [Bicep file structure](./file.md).

articles/azure-resource-manager/bicep/deploy-cli.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -178,7 +178,7 @@ For more information, see [Azure Resource Manager template specs (Preview)](temp
178178

179179
## Preview changes
180180

181-
Before deploying your template, you can preview the changes the template will make to your environment. Use the [what-if operation](template-deploy-what-if.md) to verify that the template makes the changes that you expect. What-if also validates the template for errors.
181+
Before deploying your template, you can preview the changes the template will make to your environment. Use the [what-if operation](./deploy-what-if.md) to verify that the template makes the changes that you expect. What-if also validates the template for errors.
182182

183183
## Parameters
184184

articles/azure-resource-manager/bicep/deploy-cloud-shell.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -115,4 +115,4 @@ To deploy a local template, you must first upload your template to the storage a
115115
## Next steps
116116

117117
- For more information about deployment commands, see [Deploy resources with ARM templates and Azure CLI](deploy-cli.md) and [Deploy resources with ARM templates and Azure PowerShell](deploy-powershell.md).
118-
- To preview changes before deploying a template, see [ARM template deployment what-if operation](template-deploy-what-if.md).
118+
- To preview changes before deploying a template, see [ARM template deployment what-if operation](./deploy-what-if.md).

articles/azure-resource-manager/bicep/deploy-powershell.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -180,7 +180,7 @@ For more information, see [Azure Resource Manager template specs (Preview)](temp
180180

181181
## Preview changes
182182

183-
Before deploying your template, you can preview the changes the template will make to your environment. Use the [what-if operation](template-deploy-what-if.md) to verify that the template makes the changes that you expect. What-if also validates the template for errors.
183+
Before deploying your template, you can preview the changes the template will make to your environment. Use the [what-if operation](./deploy-what-if.md) to verify that the template makes the changes that you expect. What-if also validates the template for errors.
184184

185185
## Pass parameter values
186186

articles/azure-resource-manager/bicep/deploy-rest.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -70,7 +70,7 @@ The examples in this article use resource group deployments.
7070
}
7171
```
7272

73-
1. Before deploying your template, you can preview the changes the template will make to your environment. Use the [what-if operation](template-deploy-what-if.md) to verify that the template makes the changes that you expect. What-if also validates the template for errors.
73+
1. Before deploying your template, you can preview the changes the template will make to your environment. Use the [what-if operation](./deploy-what-if.md) to verify that the template makes the changes that you expect. What-if also validates the template for errors.
7474

7575
1. To deploy a template, provide your subscription ID, the name of the resource group, the name of the deployment in the request URI.
7676

articles/azure-resource-manager/bicep/template-deploy-what-if.md renamed to articles/azure-resource-manager/bicep/deploy-what-if.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@ To use what-if in Azure CLI, you must have Azure CLI 2.14.0 or later. If needed,
3232

3333
When you use what-if in PowerShell or Azure CLI, the output includes color-coded results that help you see the different types of changes.
3434

35-
![Resource Manager template deployment what-if operation fullresourcepayload and change types](./media/template-deploy-what-if/resource-manager-deployment-whatif-change-types.png)
35+
![Resource Manager template deployment what-if operation fullresourcepayload and change types](./media/deploy-what-if/resource-manager-deployment-whatif-change-types.png)
3636

3737
The text output is:
3838

@@ -122,7 +122,7 @@ The what-if operation lists six different types of changes:
122122

123123
- **Create**: The resource doesn't currently exist but is defined in the template. The resource will be created.
124124

125-
- **Delete**: This change type only applies when using [complete mode](deployment-modes.md) for deployment. The resource exists, but isn't defined in the template. With complete mode, the resource will be deleted. Only resources that [support complete mode deletion](complete-mode-deletion.md) are included in this change type.
125+
- **Delete**: This change type only applies when using [complete mode](deployment-modes.md) for deployment. The resource exists, but isn't defined in the template. With complete mode, the resource will be deleted. Only resources that [support complete mode deletion](deployment-complete-mode-deletion.md) are included in this change type.
126126

127127
- **Ignore**: The resource exists, but isn't defined in the template. The resource won't be deployed or modified.
128128

@@ -246,7 +246,7 @@ az deployment group what-if \
246246

247247
The what-if output appears similar to:
248248

249-
![Resource Manager template deployment what-if operation output](./media/template-deploy-what-if/resource-manager-deployment-whatif-change-types.png)
249+
![Resource Manager template deployment what-if operation output](./media/deploy-what-if/resource-manager-deployment-whatif-change-types.png)
250250

251251
The text output is:
252252

@@ -342,7 +342,7 @@ az deployment group create \
342342

343343
Because no resources are defined in the template and the deployment mode is set to complete, the virtual network will be deleted.
344344

345-
![Resource Manager template deployment what-if operation output deployment mode complete](./media/template-deploy-what-if/resource-manager-deployment-whatif-output-mode-complete.png)
345+
![Resource Manager template deployment what-if operation output deployment mode complete](./media/deploy-what-if/resource-manager-deployment-whatif-output-mode-complete.png)
346346

347347
The text output is:
348348

articles/azure-resource-manager/bicep/complete-mode-deletion.md renamed to articles/azure-resource-manager/bicep/deployment-complete-mode-deletion.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ If you deploy to [more than one resource group in a template](./deploy-to-resour
2121
The resources are listed by resource provider namespace. To match a resource provider namespace with its Azure service name, see [Resource providers for Azure services](../management/azure-services-resource-providers.md).
2222

2323
> [!NOTE]
24-
> Always use the [what-if operation](template-deploy-what-if.md) before deploying a template in complete mode. What-if shows you which resources will be created, deleted, or modified. Use what-if to avoid unintentionally deleting resources.
24+
> Always use the [what-if operation](./deploy-what-if.md) before deploying a template in complete mode. What-if shows you which resources will be created, deleted, or modified. Use what-if to avoid unintentionally deleting resources.
2525
2626
Jump to a resource provider namespace:
2727
> [!div class="op_single_selector"]

articles/azure-resource-manager/bicep/deployment-history-deletions.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ Deployments are deleted from your history when you exceed 775 deployments. Azure
2828
>
2929
> If your resource group is already at the 800 limit, your next deployment fails with an error. The automatic deletion process starts immediately. You can try your deployment again after a short wait.
3030
31-
In addition to deployments, you also trigger deletions when you run the [what-if operation](template-deploy-what-if.md) or validate a deployment.
31+
In addition to deployments, you also trigger deletions when you run the [what-if operation](./deploy-what-if.md) or validate a deployment.
3232

3333
When you give a deployment the same name as one in the history, you reset its place in the history. The deployment moves to the most recent place in the history. You also reset a deployment's place when you [roll back to that deployment](../templates/rollback-on-error.md) after an error.
3434

0 commit comments

Comments
 (0)