Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into rolyon-rbac-resource-provider-cognitiveservices

Author: rolyon

articles/azure-resource-manager/bicep/best-practices.md

@@ -5,7 +5,7 @@ author: johndowns
 ms.author: jodowns
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 05/16/2022
+ms.date: 06/23/2023
 ---
 # Best practices for Bicep
 
@@ -68,13 +68,13 @@ For more information about Bicep variables, see [Variables in Bicep](variables.m
 * Avoid using `name` in a symbolic name. The symbolic name represents the resource, not the resource's name. For example, instead of the following syntax:
 
   ```bicep
-  resource cosmosDBAccountName 'Microsoft.DocumentDB/databaseAccounts@2021-04-15' = {
+  resource cosmosDBAccountName 'Microsoft.DocumentDB/databaseAccounts@2023-04-15' = {
   ```
 
   Use:
 
   ```bicep
-  resource cosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2021-04-15' = {
+  resource cosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2023-04-15' = {
   ```
 
 * Avoid distinguishing variables and parameters by the use of suffixes.

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

@@ -3,7 +3,7 @@ title: Bicep functions - any
 description: Describes the any function that is available in Bicep to convert types.
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 09/09/2021
+ms.date: 06/23/2023
 ---
 
 # Any function for Bicep
@@ -38,7 +38,7 @@ The value in a form that is compatible with any data type.
 The following example shows how to use the `any()` function to provide numeric values as strings.
 
 ```bicep
-resource wpAci 'microsoft.containerInstance/containerGroups@2019-12-01' = {
+resource wpAci 'Microsoft.ContainerInstance/containerGroups@2023-05-01' = {
   name: 'wordpress-containerinstance'
   location: location
   properties: {

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

@@ -1,11 +1,9 @@
 ---
 title: Bicep functions - date
 description: Describes the functions to use in a Bicep file to work with dates.
-author: mumian
-ms.author: jgao
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 05/03/2022
+ms.date: 06/23/2023
 ---
 
 # Date functions for Bicep
@@ -67,7 +65,7 @@ var startTime = dateTimeAdd(baseTime, 'PT1H')
 
 ...
 
-resource scheduler 'Microsoft.Automation/automationAccounts/schedules@2015-10-31' = {
+resource scheduler 'Microsoft.Automation/automationAccounts/schedules@2022-08-08' = {
   name: concat(omsAutomationAccountName, '/', scheduleName)
   properties: {
     description: 'Demo Scheduler'
@@ -220,7 +218,7 @@ The next example shows how to use a value from the function when setting a tag v
 param utcShort string = utcNow('d')
 param rgName string
 
-resource myRg 'Microsoft.Resources/resourceGroups@2020-10-01' = {
+resource myRg 'Microsoft.Resources/resourceGroups@2022-09-01' = {
   name: rgName
   location: 'westeurope'
   tags: {

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

@@ -1,11 +1,9 @@
 ---
 title: Bicep functions - numeric
 description: Describes the functions to use in a Bicep file to work with numbers.
-author: mumian
-ms.author: jgao
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 09/30/2021
+ms.date: 06/23/2023
 ---
 
 # Numeric functions for Bicep

articles/azure-resource-manager/bicep/child-resource-name-type.md

@@ -1,11 +1,9 @@
 ---
 title: Child resources in Bicep
 description: Describes how to set the name and type for child resources in Bicep.
-author: mumian
-ms.author: jgao
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 09/13/2021
+ms.date: 06/23/2023
 ---
 
 # Set name and type for child resources in Bicep
@@ -84,7 +82,7 @@ output childAddressPrefix string = VNet1::VNet1_Subnet1.properties.addressPrefix
 
 ## Outside parent resource
 
-The following example shows the child resource outside of the parent resource. You might use this approach if the parent resource isn't deployed in the same template, or if want to use [a loop](loops.md) to create more than one child resource. Specify the parent property on the child with the value set to the symbolic name of the parent. With this syntax you still need to declare the full resource type, but the name of the child resource is only the name of the child.
+The following example shows the child resource outside of the parent resource. You might use this approach if the parent resource isn't deployed in the same template, or if you want to use [a loop](loops.md) to create more than one child resource. Specify the parent property on the child with the value set to the symbolic name of the parent. With this syntax you still need to declare the full resource type, but the name of the child resource is only the name of the child.
 
 ```bicep
 resource <parent-resource-symbolic-name> '<resource-type>@<api-version>' = {

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

@@ -1,12 +1,11 @@
 ---
 title: Compare syntax for Azure Resource Manager templates in JSON and Bicep
 description: Compares Azure Resource Manager templates developed with JSON and Bicep, and shows how to convert between the languages.
-author: mumian
-ms.author: jgao
 ms.topic: conceptual
 ms.custom: devx-track-bicep, devx-track-arm-template
-ms.date: 04/26/2022
+ms.date: 06/23/2023
 ---
+
 # Comparing JSON and Bicep for templates
 
 This article compares Bicep syntax with JSON syntax for Azure Resource Manager templates (ARM templates). In most cases, Bicep provides syntax that is less verbose than the equivalent in JSON.
@@ -135,7 +134,7 @@ targetScope = 'subscription'
 To declare a resource:
 
 ```bicep
-resource virtualMachine 'Microsoft.Compute/virtualMachines@2020-06-01' = {
+resource virtualMachine 'Microsoft.Compute/virtualMachines@2023-03-01' = {
   ...
 }
 ```
@@ -153,7 +152,7 @@ resource virtualMachine 'Microsoft.Compute/virtualMachines@2020-06-01' = {
 To conditionally deploy a resource:
 
 ```bicep
-resource virtualMachine 'Microsoft.Compute/virtualMachines@2020-06-01' = if(deployVM) {
+resource virtualMachine 'Microsoft.Compute/virtualMachines@2023-03-01' = if(deployVM) {
   ...
 }
 ```
@@ -163,7 +162,7 @@ resource virtualMachine 'Microsoft.Compute/virtualMachines@2020-06-01' = if(depl
   {
     "condition": "[parameters('deployVM')]",
     "type": "Microsoft.Compute/virtualMachines",
-    "apiVersion": "2020-06-01",
+    "apiVersion": "2023-03-01",
     ...
   }
 ]
@@ -214,11 +213,11 @@ 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 `netSecurityGroup.id`.
 
 ```bicep
-resource netSecurityGroup 'Microsoft.Network/networkSecurityGroups@2020-06-01' = {
+resource netSecurityGroup 'Microsoft.Network/networkSecurityGroups@2022-11-01' = {
   ...
 }
 
-resource nic1 'Microsoft.Network/networkInterfaces@2020-06-01' = {
+resource nic1 'Microsoft.Network/networkInterfaces@2022-11-01' = {
   name: nic1Name
   location: location
   properties: {
@@ -255,7 +254,7 @@ storageAccount.properties.primaryEndpoints.blob
 To get a property from an existing resource that isn't deployed in the template:
 
 ```bicep
-resource storageAccount 'Microsoft.Storage/storageAccounts@2019-06-01' existing = {
+resource storageAccount 'Microsoft.Storage/storageAccounts@2022-09-01' existing = {
   name: storageAccountName
 }
 

articles/azure-resource-manager/bicep/contribute.md

@@ -6,7 +6,7 @@ author: johndowns
 ms.author: jodowns
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 03/27/2022
+ms.date: 06/23/2023
 ---
 
 # Contribute to Bicep

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

@@ -1,11 +1,9 @@
 ---
 title: Deploy Bicep files with Cloud Shell
 description: Use Azure Resource Manager and Azure Cloud Shell to deploy resources to Azure. The resources are defined in a Bicep file.
-author: mumian
-ms.author: jgao
 ms.topic: conceptual
 ms.custom: devx-track-bicep, devx-track-arm-template
-ms.date: 06/01/2021
+ms.date: 06/23/2023
 ---
 
 # Deploy Bicep files from Azure Cloud Shell

articles/azure-resource-manager/bicep/deploy-to-management-group.md

@@ -3,7 +3,7 @@ title: Use Bicep to deploy resources to management group
 description: Describes how to create a Bicep file that deploys resources at the management group scope.
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 11/22/2021
+ms.date: 06/23/2023
 ---
 
 # Management group deployments with Bicep files
@@ -128,7 +128,7 @@ To deploy resources to the target management group, add those resources with the
 targetScope = 'managementGroup'
 
 // policy definition created in the management group
-resource policyDefinition 'Microsoft.Authorization/policyDefinitions@2019-09-01' = {
+resource policyDefinition 'Microsoft.Authorization/policyDefinitions@2021-06-01' = {
   ...
 }
 ```
@@ -211,7 +211,7 @@ targetScope = 'managementGroup'
 
 param mgName string = 'mg-${uniqueString(newGuid())}'
 
-resource newMG 'Microsoft.Management/managementGroups@2020-05-01' = {
+resource newMG 'Microsoft.Management/managementGroups@2021-04-01' = {
   scope: tenant()
   name: mgName
   properties: {}
@@ -227,7 +227,7 @@ targetScope = 'managementGroup'
 
 param mgName string = 'mg-${uniqueString(newGuid())}'
 
-resource newMG 'Microsoft.Management/managementGroups@2020-05-01' = {
+resource newMG 'Microsoft.Management/managementGroups@2021-04-01' = {
   scope: tenant()
   name: mgName
   properties: {
@@ -268,7 +268,7 @@ param allowedLocations array = [
   'australiacentral'
 ]
 
-resource policyDefinition 'Microsoft.Authorization/policyDefinitions@2020-09-01' = {
+resource policyDefinition 'Microsoft.Authorization/policyDefinitions@2021-06-01' = {
   name: 'locationRestriction'
   properties: {
     policyType: 'Custom'
@@ -288,7 +288,7 @@ resource policyDefinition 'Microsoft.Authorization/policyDefinitions@2020-09-01'
   }
 }
 
-resource policyAssignment 'Microsoft.Authorization/policyAssignments@2020-09-01' = {
+resource policyAssignment 'Microsoft.Authorization/policyAssignments@2022-06-01' = {
   name: 'locationAssignment'
   properties: {
     policyDefinitionId: policyDefinition.id

articles/azure-resource-manager/bicep/deploy-to-subscription.md

@@ -3,7 +3,7 @@ title: Use Bicep to deploy resources to subscription
 description: Describes how to create a Bicep file that deploys resources to the Azure subscription scope. It shows how to create a resource group.
 ms.topic: conceptual
 ms.custom: devx-track-bicep
-ms.date: 11/22/2021
+ms.date: 06/23/2023
 ---
 
 # Subscription deployments with Bicep files
@@ -165,7 +165,7 @@ To deploy resources to the target subscription, add those resources with the `re
 targetScope = 'subscription'
 
 // resource group created in target subscription
-resource exampleResource 'Microsoft.Resources/resourceGroups@2020-10-01' = {
+resource exampleResource 'Microsoft.Resources/resourceGroups@2022-09-01' = {
   ...
 }
 ```
@@ -229,7 +229,7 @@ targetScope = 'subscription'
 param mgName string = 'mg-${uniqueString(newGuid())}'
 
 // management group created at tenant
-resource managementGroup 'Microsoft.Management/managementGroups@2020-05-01' = {
+resource managementGroup 'Microsoft.Management/managementGroups@2021-04-01' = {
   scope: tenant()
   name: mgName
   properties: {}
@@ -254,7 +254,7 @@ targetScope='subscription'
 param resourceGroupName string
 param resourceGroupLocation string
 
-resource newRG 'Microsoft.Resources/resourceGroups@2021-01-01' = {
+resource newRG 'Microsoft.Resources/resourceGroups@2022-09-01' = {
   name: resourceGroupName
   location: resourceGroupLocation
 }
@@ -274,7 +274,7 @@ param resourceGroupLocation string
 param storageName string
 param storageLocation string
 
-resource newRG 'Microsoft.Resources/resourceGroups@2021-01-01' = {
+resource newRG 'Microsoft.Resources/resourceGroups@2022-09-01' = {
   name: resourceGroupName
   location: resourceGroupLocation
 }
@@ -295,7 +295,7 @@ The module uses a Bicep file named **storage.bicep** with the following contents
 param storageLocation string
 param storageName string
 
-resource storageAcct 'Microsoft.Storage/storageAccounts@2019-06-01' = {
+resource storageAcct 'Microsoft.Storage/storageAccounts@2022-09-01' = {
   name: storageName
   location: storageLocation
   sku: {
@@ -319,7 +319,7 @@ param policyDefinitionID string
 param policyName string
 param policyParameters object = {}
 
-resource policyAssign 'Microsoft.Authorization/policyAssignments@2020-09-01' = {
+resource policyAssign 'Microsoft.Authorization/policyAssignments@2022-06-01' = {
   name: policyName
   properties: {
     policyDefinitionId: policyDefinitionID
@@ -335,7 +335,7 @@ You can [define](../../governance/policy/concepts/definition-structure.md) and a
 ```bicep
 targetScope = 'subscription'
 
-resource locationPolicy 'Microsoft.Authorization/policyDefinitions@2020-09-01' = {
+resource locationPolicy 'Microsoft.Authorization/policyDefinitions@2021-06-01' = {
   name: 'locationpolicy'
   properties: {
     policyType: 'Custom'
@@ -352,7 +352,7 @@ resource locationPolicy 'Microsoft.Authorization/policyDefinitions@2020-09-01' =
   }
 }
 
-resource locationRestrict 'Microsoft.Authorization/policyAssignments@2020-09-01' = {
+resource locationRestrict 'Microsoft.Authorization/policyAssignments@2022-06-01' = {
   name: 'allowedLocation'
   properties: {
     policyDefinitionId: locationPolicy.id
@@ -386,7 +386,7 @@ param roleAssignmentName string = guid(principalId, roleDefinitionId, resourceGr
 
 var roleID = '/subscriptions/${subscription().subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/${roleDefinitionId}'
 
-resource newResourceGroup 'Microsoft.Resources/resourceGroups@2019-10-01' = {
+resource newResourceGroup 'Microsoft.Resources/resourceGroups@2022-09-01' = {
   name: resourceGroupName
   location: resourceGroupLocation
   properties: {}
@@ -411,7 +411,7 @@ module assignRole 'role.bicep' = {
 The following example shows the module to apply the lock:
 
 ```bicep
-resource createRgLock 'Microsoft.Authorization/locks@2016-09-01' = {
+resource createRgLock 'Microsoft.Authorization/locks@2020-05-01' = {
   name: 'rgLock'
   properties: {
     level: 'CanNotDelete'
@@ -431,7 +431,7 @@ param roleNameGuid string = newGuid()
 
 param roleDefinitionId string
 
-resource roleNameGuid_resource 'Microsoft.Authorization/roleAssignments@2020-04-01-preview' = {
+resource roleNameGuid_resource 'Microsoft.Authorization/roleAssignments@2022-04-01' = {
   name: roleNameGuid
   properties: {
     roleDefinitionId: roleDefinitionId