Merge pull request #283640 from mumian/0801-spread-intellisense

spread operator override

Author: rmca14

articles/azure-resource-manager/bicep/media/quickstart-create-bicep-use-visual-studio-code/bicep-visual-studio-code-add-properties.png

@@ -3,7 +3,7 @@ title: Bicep spread operator
 description: Describes Bicep spread operator.
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 05/21/2024
+ms.date: 08/07/2024
 ---
 
 # Bicep spread operator
@@ -21,15 +21,15 @@ The spread operator is used to copy properties from one object to another or to
 The following example shows the spread operator used in an object: 
 
 ```bicep
-var objA = { bar: 'bar' }
-output objB object = { foo: 'foo', ...objA } 
+var objA = { color: 'white' }
+output objB object = { shape: 'circle', ...objA } 
 ```
 
 Output from the example:
 
 | Name | Type | Value |
 |------|------|-------|
-| `objB` | object | { foo: 'foo', bar: 'bar' } |
+| `objB` | object | { shape: 'circle', color: 'white' } |
 
 The following example shows the spread operator used in an array: 
 
@@ -60,10 +60,10 @@ Output from the example:
 The following example shows spread used in a multi-line operation:
 
 ```bicep
-var objA = { foo: 'foo' }
-var objB = { bar: 'bar' }
-output combined object = { 
-  ...objA
+var objA = { color: 'white' }
+var objB = { shape: 'circle'}
+output objCombined object = { 
+  ...objA 
   ...objB
 } 
 ```
@@ -72,39 +72,70 @@ In this usage, comma isn't used between the two lines.  Output from the example:
 
 | Name | Type | Value |
 |------|------|-------|
-| `combined` | object | { foo: 'foo', bar: 'bar' } |
+| `objCombined` | object | { color: 'white', shape: 'circle' } |
 
-The spread operation can be used to avoid setting an optional property. For example:
+The spread operation can be used to avoid setting an optional property. In the following example, _accessTier_ is set only if the parameter _tier_ isn't an empty string.
 
 ```bicep
-param vmImageResourceId string = ''
-
-var bar = vmImageResourceId != '' ? {
-  id: vmImageResourceId
-} : {}
-
-output foo object = {
-  ...bar
-  alwaysSet: 'value'
+param location string = resourceGroup().location
+param tier string = 'Hot'
+
+var storageAccountName = uniqueString(resourceGroup().id)
+var accessTier = tier != '' ? {accessTier: tier} : {}
+
+resource mystorage 'Microsoft.Storage/storageAccounts@2023-05-01' = {
+  name: storageAccountName
+  location: location
+  sku: {
+    name: 'Standard_LRS'
+  }
+  kind: 'StorageV2'
+  properties: {
+    ...accessTier
+  } 
 }
 ```
 
-Output from the example:
+The preceding example can also be written as:
 
-| Name | Type | Value |
-|------|------|-------|
-| `foo` | object | {"alwaysSet":"value"} |
+```bicep
+param location string = resourceGroup().location
+param tier string = 'Hot'
+
+var storageAccountName = uniqueString(resourceGroup().id)
+
+resource mystorage 'Microsoft.Storage/storageAccounts@2023-05-01' = {
+  name: storageAccountName
+  location: location
+  sku: {
+    name: 'Standard_LRS'
+  }
+  kind: 'StorageV2'
+  properties: {
+    ...(tier != '' ? {accesssTier: tier} : {})
+  } 
+}
+```
 
-The preceding example can also be written as:
+The spread operator can be used to override existing properties. 
 
 ```bicep
-param vmImageResourceId string = ''
+param location string = resourceGroup().location
+param storageProperties {
+  accessTier: string?
+}
 
-output foo object = {
-  ...(vmImageResourceId != '' ? {
-    id: vmImageResourceId
-  } : {})
-  alwaysSet: 'value'
+resource mystorage 'Microsoft.Storage/storageAccounts@2023-05-01' = {
+  name: uniqueString(resourceGroup().id)
+  location: location
+  sku: {
+    name: 'Standard_LRS'
+  }
+  kind: 'StorageV2'
+  properties: {
+    accessTier: 'Cold'
+    ...storageProperties
+  }
 }
 ```
 

articles/azure-resource-manager/bicep/operator-spread.md

@@ -1,7 +1,7 @@
 ---
 title: Create Bicep files - Visual Studio Code
 description: Use Visual Studio Code and the Bicep extension to Bicep files for deploy Azure resources
-ms.date: 03/20/2024
+ms.date: 08/05/2024
 ms.topic: quickstart
 ms.custom: mode-ui, devx-track-bicep
 #Customer intent: As a developer new to Azure deployment, I want to learn how to use Visual Studio Code to create and edit Bicep files, so I can use them to deploy Azure resources.
@@ -172,6 +172,10 @@ You're almost done. Just provide values for those properties.
 
 Again, intellisense helps you. Set `name` to `storageAccountName`, which is the parameter that contains a name for the storage account. For `location`, set it to `location`, which is a parameter you created earlier. When adding `sku.name` and `kind`, intellisense presents the valid options.
 
+To add optional properties alongside the required properties, place the cursor at the desired location and press <kbd>Ctrl</kbd>+<kbd>Space</kbd>. Intellisense suggests unused properties as shown in the following screenshot.
+
+:::image type="content" source="./media/quickstart-create-bicep-use-visual-studio-code/bicep-visual-studio-code-add-properties.png" alt-text="Screenshot of adding additional properties.":::
+
 When finished, you have:
 
 ```bicep