Merge pull request #276731 from mumian/0529-bcp033

Bicep warnings and errors - BCP033 & BCP035

Author: v-shils

articles/azure-resource-manager/bicep/bicep-error-bcp033.md

@@ -0,0 +1,41 @@
+---
+title: BCP033
+description: Error - Expected a value of type "{expectedType}" but the provided value is of type "{actualType}".
+ms.topic: reference
+ms.custom: devx-track-bicep
+ms.date: 06/28/2024
+---
+
+# Bicep warning and error code - BCP033
+
+This error occurs when you assign a value of a mismatched data type.
+
+## Error description
+
+`Expected a value of type "{expectedType}" but the provided value is of type "{actualType}".`
+
+## Solution
+
+Use the expected data type.  
+
+## Examples
+
+The following example raises the error because the expected data type is a string. The actual provided value is an integer:
+
+```bicep
+var myValue = 5
+
+output myString string = myValue
+```
+
+You can fix the error by providing a string value:
+
+```bicep
+var myValue = '5'
+
+output myString string = myValue
+```
+
+## Next steps
+
+For more information about Bicep warning and error codes, see [Bicep warnings and errors](./bicep-error-codes.md).

articles/azure-resource-manager/bicep/bicep-error-bcp035.md

@@ -0,0 +1,83 @@
+---
+title: BCP035
+description: Error - The specified <data-type> declaration is missing the following required properties.
+ms.topic: reference
+ms.custom: devx-track-bicep
+ms.date: 06/28/2024
+---
+
+# Bicep warning and error code - BCP035
+
+This warning occurs when your resource definition is missing a required property.
+
+## Warning description
+
+`The specified <date-type> declaration is missing the following required properties: <name-of-the-property.`
+
+## Solution
+
+Add the missing property to the resource definition.
+
+## Examples
+
+The following example raises the warning for **virtualNetworkGateway1** and **virtualNetworkGateway2**:
+
+```bicep
+var networkConnectionName = 'testConnection'
+var location = 'eastus'
+var vnetGwAId = 'gatewayA'
+var vnetGwBId = 'gatewayB'
+
+resource networkConnection 'Microsoft.Network/connections@2023-11-01' = {
+  name: networkConnectionName
+  location: location
+  properties: {
+    virtualNetworkGateway1: {
+      id: vnetGwAId
+    }
+    virtualNetworkGateway2: {
+      id: vnetGwBId
+    }
+
+    connectionType: 'Vnet2Vnet' 
+  }
+}
+```
+
+The warning is:
+
+```warning
+The specified "object" declaration is missing the following required properties: "properties". If this is an inaccuracy in the documentation, please report it to the Bicep Team.
+```
+
+You can verify the missing properties from the [template reference](/azure/templates). If you see the warning from Visual Studio Code, hover the cursor over the resource symbolic name and select **View document** to open the template reference.
+
+You can fix the error by adding the missing properties:
+
+```bicep
+var networkConnectionName = 'testConnection'
+var location = 'eastus'
+var vnetGwAId = 'gatewayA'
+var vnetGwBId = 'gatewayB'
+
+resource networkConnection 'Microsoft.Network/connections@2023-11-01' = {
+  name: networkConnectionName
+  location: location
+  properties: {
+    virtualNetworkGateway1: {
+      id: vnetGwAId
+      properties:{}
+    }
+    virtualNetworkGateway2: {
+      id: vnetGwBId
+      properties:{}
+    }
+
+    connectionType: 'Vnet2Vnet' 
+  }
+}
+```
+
+## Next steps
+
+For more information about Bicep warning and error codes, see [Bicep warnings and errors](./bicep-error-codes.md).

articles/azure-resource-manager/bicep/bicep-error-bcp072.md

@@ -0,0 +1,42 @@
+---
+title: BCP072
+description: Error - This symbol cannot be referenced here. Only other parameters can be referenced in parameter default values.
+ms.topic: reference
+ms.custom: devx-track-bicep
+ms.date: 07/02/2024
+---
+
+# Bicep warning and error code - BCP072
+
+This error occurs when you reference a variable in parameter default values.
+
+## Error description
+
+`This symbol cannot be referenced here. Only other parameters can be referenced in parameter default values.`
+
+## Solution
+
+Reference another parameter instead.  
+
+## Examples
+
+The following example raises the error because the parameter default value references a variable:
+
+```bicep
+param foo string = bar
+
+var bar = 'HelloWorld!'
+```
+
+You can fix the error by referencing another parameter:
+
+```bicep
+param foo string = bar
+param bar string = 'HelloWorld!'
+
+output outValue string = foo
+```
+
+## Next steps
+
+For more information about Bicep warning and error codes, see [Bicep warnings and errors](./bicep-error-codes.md).