Merge pull request #232758 from davidsmatlak/ds-ghi-106391

Updates ARM troubleshooting content

Author: prmerger-automator[bot]

articles/azure-resource-manager/troubleshooting/common-deployment-errors.md

@@ -3,7 +3,7 @@ title: Troubleshoot common Azure deployment errors
 description: Troubleshoot common Azure deployment errors for resources that are deployed with Bicep files or Azure Resource Manager templates (ARM templates).
 tags: top-support-issue
 ms.topic: troubleshooting
-ms.date: 02/21/2023
+ms.date: 03/30/2023
 ---
 
 # Troubleshoot common Azure deployment errors
@@ -21,7 +21,7 @@ If your error code isn't listed, submit a GitHub issue. On the right side of the
 | AllocationFailed | The cluster or region doesn't have resources available or can't support the requested VM size. Retry the request at a later time, or request a different VM size. | [Provisioning and allocation issues for Linux](/troubleshoot/azure/virtual-machines/troubleshoot-deployment-new-vm-linux) <br><br> [Provisioning and allocation issues for Windows](/troubleshoot/azure/virtual-machines/troubleshoot-deployment-new-vm-windows) <br><br> [Troubleshoot allocation failures](/troubleshoot/azure/virtual-machines/allocation-failure)|
 | AnotherOperationInProgress | Wait for concurrent operation to complete. | |
 | AuthorizationFailed | Your account or service principal doesn't have sufficient access to complete the deployment. Check the role your account belongs to, and its access for the deployment scope.<br><br>You might receive this error when a required resource provider isn't registered. | [Azure role-based access control (Azure RBAC)](../../role-based-access-control/role-assignments-portal.md)<br><br>[Resolve registration](error-register-resource-provider.md) |
-| BadRequest | You sent deployment values that don't match what is expected by Resource Manager. Check the inner status message for help with troubleshooting. | [Template reference](/azure/templates/) <br><br> [Resource location in ARM template](../templates/resource-location.md) <br><br> [Resource location in Bicep file](../bicep/resource-declaration.md#location) |
+| BadRequest | You sent deployment values that don't match what is expected by Resource Manager. Check the inner status message for help with troubleshooting. <br><br> Validate the template's syntax to resolve deployment errors when using a template that was exported from an existing Azure resource. | [Template reference](/azure/templates/) <br><br> [Resource location in ARM template](../templates/resource-location.md) <br><br> [Resource location in Bicep file](../bicep/resource-declaration.md#location) <br><br> [Resolve invalid template](error-invalid-template.md)|
 | Conflict | You're requesting an operation that isn't allowed in the resource's current state. For example, disk resizing is allowed only when creating a VM or when the VM is deallocated. | |
 | DeploymentActiveAndUneditable | Wait for concurrent deployment to this resource group to complete. | |
 | DeploymentFailedCleanUp | When you deploy in complete mode, any resources that aren't in the template are deleted. You get this error when you don't have adequate permissions to delete all of the resources not in the template. To avoid the error, change the deployment mode to incremental. | [Azure Resource Manager deployment modes](../templates/deployment-modes.md) |

articles/azure-resource-manager/troubleshooting/error-invalid-template.md

@@ -2,7 +2,7 @@
 title: Invalid template errors
 description: Describes how to resolve invalid template errors when deploying Bicep files or Azure Resource Manager templates (ARM templates).
 ms.topic: troubleshooting
-ms.date: 01/03/2023
+ms.date: 03/30/2023
 ---
 
 # Resolve errors for invalid template
@@ -112,3 +112,29 @@ The same approach works for App Service apps. Consider moving configuration valu
 1. webapp2
 1. Configuration for webapp1 depends on webapp1 and webapp2. It contains app settings with values from webapp2.
 1. Configuration for webapp2 depends on webapp1 and webapp2. It contains app settings with values from webapp1.
+
+## Solution 6: Validate syntax for exported templates
+
+After you deploy resources in Azure, you can export the ARM template JSON and modify it for other deployments. You should validate the exported template for correct syntax _before_ you use it to deploy resources.
+
+You can export a template from the [portal](../templates/export-template-portal.md), [Azure CLI](../templates/export-template-cli.md), or [Azure PowerShell](../templates/export-template-powershell.md). There are recommendations whether you exported the template from the resource or resource group, or from deployment history.
+
+# [Bicep](#tab/bicep)
+
+After you export an ARM template, you can decompile the JSON template to Bicep. Then use best practices and the linter to validate your code.
+
+For more information, go to the following articles:
+
+- [Decompiling ARM template JSON to Bicep](../bicep/decompile.md)
+- [Best practices for Bicep](../bicep/best-practices.md)
+- [Add linter settings in the Bicep config file](../bicep/bicep-config-linter.md)
+
+
+# [JSON](#tab/json)
+
+After you export an ARM template, you can learn more about best practices and the toolkit for template validation:
+
+- [ARM template best practices](../templates/best-practices.md)
+- [ARM template test toolkit](../templates/test-toolkit.md)
+
+---