Merge pull request #190215 from tfitzmac/0301accessor

add nested accessor to comparison

Author: PRMerger5

articles/azure-resource-manager/bicep/compare-template-syntax.md

@@ -4,7 +4,7 @@ description: Compares Azure Resource Manager templates developed with JSON and B
 author: mumian
 ms.author: jgao
 ms.topic: conceptual
-ms.date: 01/21/2022
+ms.date: 03/01/2022
 ---
 # Comparing JSON and Bicep for templates
 
@@ -37,62 +37,62 @@ func()
 To declare a parameter with a default value:
 
 ```bicep
-param demoParam string = 'Contoso'
+param orgName string = 'Contoso'
 ```
 
 ```json
 "parameters": {
-  "demoParam": {
+  "orgName": {
     "type": "string",
     "defaultValue": "Contoso"
   }
 }
 ```
 
-To get a parameter value:
+To get a parameter value, use the name you defined:
 
 ```bicep
-demoParam
+name: orgName
 ```
 
 ```json
-[parameters('demoParam'))]
+"name": "[parameters('orgName'))]"
 ```
 
 ## Variables
 
 To declare a variable:
 
 ```bicep
-var demoVar = 'example value'
+var description = 'example value'
 ```
 
 ```json
 "variables": {
-  "demoVar": "example value"
+  "description": "example value"
 },
 ```
 
-To get a variable value:
+To get a variable value, use the name you defined:
 
 ```bicep
-demoVar
+workloadSetting: description
 ```
 
 ```json
-[variables('demoVar'))]
+"workloadSetting": "[variables('demoVar'))]"
 ```
 
 ## Strings
 
 To concatenate strings:
 
 ```bicep
-'${namePrefix}-vm'
+name: '${namePrefix}-vm'
 ```
 
 ```json
-[concat(parameters('namePrefix'), '-vm')]
+"name": "[concat(parameters('namePrefix'), '-vm')]"
 ```
 
 ## Logical operators
@@ -134,7 +134,7 @@ targetScope = 'subscription'
 To declare a resource:
 
 ```bicep
-resource vm 'Microsoft.Compute/virtualMachines@2020-06-01' = {
+resource virtualMachine 'Microsoft.Compute/virtualMachines@2020-06-01' = {
   ...
 }
 ```
@@ -152,7 +152,7 @@ resource vm 'Microsoft.Compute/virtualMachines@2020-06-01' = {
 To conditionally deploy a resource:
 
 ```bicep
-resource vm 'Microsoft.Compute/virtualMachines@2020-06-01' = if(deployVM) {
+resource virtualMachine 'Microsoft.Compute/virtualMachines@2020-06-01' = if(deployVM) {
   ...
 }
 ```
@@ -193,15 +193,15 @@ nic1.id
 To iterate over items in an array or count:
 
 ```bicep
-[for storageName in storageAccounts: {
+[for storageName in storageAccountNames: {
   ...
 }]
 ```
 
 ```json
 "copy": {
   "name": "storagecopy",
-  "count": "[length(parameters('storageAccounts'))]"
+  "count": "[length(parameters('storageAccountNames'))]"
 },
 ...
 ```
@@ -213,7 +213,7 @@ For Bicep, you can set an explicit dependency but this approach isn't recommende
 The following shows a network interface with an implicit dependency on a network security group. It references the network security group with `nsg.id`.
 
 ```bicep
-resource nsg 'Microsoft.Network/networkSecurityGroups@2020-06-01' = {
+resource netSecurityGroup 'Microsoft.Network/networkSecurityGroups@2020-06-01' = {
   ...
 }
 
@@ -232,7 +232,7 @@ resource nic1 'Microsoft.Network/networkInterfaces@2020-06-01' = {
 If you must set an explicit dependence, use:
 
 ```bicep
-dependsOn: [ stg ]
+dependsOn: [ storageAccount ]
 ```
 
 ```json
@@ -244,29 +244,41 @@ dependsOn: [ stg ]
 To get a property from a resource in the template:
 
 ```bicep
-diagsAccount.properties.primaryEndpoints.blob
+storageAccount.properties.primaryEndpoints.blob
 ```
 
 ```json
-[reference(resourceId('Microsoft.Storage/storageAccounts', variables('diagStorageAccountName'))).primaryEndpoints.blob]
+[reference(resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))).primaryEndpoints.blob]
 ```
 
 To get a property from an existing resource that isn't deployed in the template:
 
 ```bicep
-resource stg 'Microsoft.Storage/storageAccounts@2019-06-01' existing = {
+resource storageAccount 'Microsoft.Storage/storageAccounts@2019-06-01' existing = {
   name: storageAccountName
 }
 
 // use later in template as often as needed
-stg.properties.primaryEndpoints.blob
+storageAccount.properties.primaryEndpoints.blob
 ```
 
 ```json
 // required every time the property is needed
 "[reference(resourceId('Microsoft.Storage/storageAccounts/', parameters('storageAccountName')), '2019-06-01').primaryEndpoints.blob]"
 ```
 
+In Bicep, use the [nested accessor](operators-access.md#nested-resource-accessor) (`::`) to get a property on a resource nested within a parent resource:
+
+```bicep
+VNet1::Subnet1.properties.addressPrefix
+```
+
+For JSON, use reference function:
+
+```json
+[reference(resourceId('Microsoft.Network/virtualNetworks/subnets', variables('subnetName'))).properties.addressPrefix]
+```
+
 ## Outputs
 
 To output a property from a resource in the template:
@@ -300,7 +312,7 @@ output hostname string = condition ? publicIP.properties.dnsSettings.fqdn : ''
 }
 ```
 
-The Bicep ternary operator is the equivalent to the [`if` function](../templates/template-functions-logical.md#if) in an ARM template JSON, not the condition property. The ternary syntax has to evaluate to one value or the other. If the condition is false in the preceding samples, Bicep outputs a hostname with an empty string, but JSON outputs no values.
+The Bicep ternary operator is the equivalent to the [if function](../templates/template-functions-logical.md#if) in an ARM template JSON, not the condition property. The ternary syntax has to evaluate to one value or the other. If the condition is false in the preceding samples, Bicep outputs a hostname with an empty string, but JSON outputs no values.
 
 ## Code reuse