Merge pull request #212537 from mumian/0923-function-samples-array

0923 function samples array

Author: prmerger-automator[bot]

articles/azure-resource-manager/bicep/bicep-functions-array.md

@@ -4,9 +4,9 @@ description: Describes the functions to use in a Bicep file for working with arr
 author: mumian
 ms.topic: conceptual
 ms.author: jgao
-ms.date: 04/12/2022
-
+ms.date: 09/26/2022
 ---
+
 # Array functions for Bicep
 
 This article describes the Bicep functions for working with arrays. The lambda functions for working with arrays can be found [here](./bicep-functions-lambda.md).
@@ -195,6 +195,34 @@ The output from the preceding example with the default values is:
 | objectEmpty | Bool | True |
 | stringEmpty | Bool | True |
 
+### Quickstart examples
+
+The following example is extracted from a quickstart template, [SQL Server VM with performance optimized storage settings
+](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.attestation/attestation-provider-create/main.bicep):
+
+```bicep
+@description('Array containing DNS Servers')
+param dnsServers array = []
+
+...
+
+resource vnet 'Microsoft.Network/virtualNetworks@2021-02-01' = {
+  name: vnetName
+  location: location
+  properties: {
+    addressSpace: {
+      addressPrefixes: vnetAddressSpace
+    }
+    dhcpOptions: empty(dnsServers) ? null : {
+      dnsServers: dnsServers
+    }
+    ...
+  }
+}
+```
+
+In the [conditional expression](./operators-logical.md#conditional-expression--), the empty function is used to check whether the **dnsServers** array is an empty array.
+
 ## first
 
 `first(arg1)`
@@ -239,15 +267,15 @@ The output from the preceding example with the default values is:
 
 `flatten(arrayToFlatten)`
 
-Takes an array of arrays, and returns an array of sub-array elements, in the original order. Sub-arrays are only flattened once, not recursively.
+Takes an array of arrays, and returns an array of subarray elements, in the original order. Subarrays are only flattened once, not recursively.
 
 Namespace: [sys](bicep-functions.md#namespaces-for-functions).
 
 ### Parameters
 
 | Parameter | Required | Type | Description |
 |:--- |:--- |:--- |:--- |
-| arrayToFlattern |Yes |array |The array of sub-arrays to flatten.|
+| arrayToFlattern |Yes |array |The array of subarrays to flatten.|
 
 ### Return value
 
@@ -609,6 +637,39 @@ The output from the preceding example with the default values is:
 | stringLength | Int | 13 |
 | objectLength | Int | 4 |
 
+### Quickstart examples
+
+The following example is extracted from a quickstart template, [Deploy API Management in external VNet with public IP
+](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.apimanagement/api-management-create-with-external-vnet-publicip):
+
+```bicep
+@description('Numbers for availability zones, for example, 1,2,3.')
+param availabilityZones array = [
+  '1'
+  '2'
+]
+
+resource exampleApim 'Microsoft.ApiManagement/service@2021-08-01' = {
+  name: apiManagementName
+  location: location
+  sku: {
+    name: sku
+    capacity: skuCount
+  }
+  zones: ((length(availabilityZones) == 0) ? null : availabilityZones)
+  ...
+}
+```
+
+In the [conditional expression](./operators-logical.md#conditional-expression--), the `length` function check the length of the **availabilityZones** array.
+
+More examples can be found in these quickstart Bicep files:
+- [Backup Resource Manager VMs using Recovery Services vault
+](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.recoveryservices/recovery-services-backup-vms/)
+- [Deploy API Management into Availability Zones](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.apimanagement/api-management-simple-zones)
+- [Create a Firewall and FirewallPolicy with Rules and Ipgroups](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.network/azurefirewall-create-with-firewallpolicy-apprule-netrule-ipgroups)
+- [Create a sandbox setup of Azure Firewall with Zones](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.network/azurefirewall-with-zones-sandbox)
+
 ## max
 
 `max(arg1)`
@@ -729,6 +790,49 @@ The output from the preceding example with the default values is:
 | ---- | ---- | ----- |
 | rangeOutput | Array | [5, 6, 7] |
 
+### Quickstart examples
+
+The following example is extracted from a quickstart template, [Two VMs in VNET - Internal Load Balancer and LB rules
+](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.compute/2-vms-internal-load-balancer):
+
+```bicep
+...
+var numberOfInstances = 2
+
+resource networkInterface 'Microsoft.Network/networkInterfaces@2021-05-01' = [for i in range(0, numberOfInstances): {
+  name: '${networkInterfaceName}${i}'
+  location: location
+  properties: {
+    ...
+  }
+}]
+
+resource vm 'Microsoft.Compute/virtualMachines@2021-11-01' = [for i in range(0, numberOfInstances): {
+  name: '${vmNamePrefix}${i}'
+  location: location
+  properties: {
+    ...
+  }
+}]
+```
+
+The Bicep file creates two networkInterface and two virtualMachine resources.
+
+More examples can be found in these quickstart Bicep files:
+
+- [Multi VM Template with Managed Disk](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.compute/vm-copy-managed-disks)
+- [Create a VM with multiple empty StandardSSD_LRS Data Disks](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.compute/vm-with-standardssd-disk)
+- [Create a Firewall and FirewallPolicy with Rules and Ipgroups](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.network/azurefirewall-create-with-firewallpolicy-apprule-netrule-ipgroups)
+- [Create an Azure Firewall with IpGroups](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.network/azurefirewall-create-with-ipgroups-and-linux-jumpbox)
+- [Create a sandbox setup of Azure Firewall with Zones](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.network/azurefirewall-with-zones-sandbox)
+- [Create an Azure Firewall with multiple IP public addresses](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.network/fw-docs-qs)
+- [Create a standard load-balancer](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.network/load-balancer-standard-create)
+- [Azure Traffic Manager VM example](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.network/traffic-manager-vm)
+- [Create A Security Automation for specific Alerts](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.security/securitycenter-create-automation-for-alertnamecontains)
+- [SQL Server VM with performance optimized storage settings](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.sqlvirtualmachine/sql-vm-new-storage)
+- [Create a storage account with multiple Blob containers](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.storage/storage-multi-blob-container)
+- [Create a storage account with multiple file shares](https://github.com/Azure/azure-quickstart-templates/tree/master/quickstarts/microsoft.storage/storage-multi-file-share)
+
 ## skip
 
 `skip(originalValue, numberToSkip)`