Merge pull request #311847 from apurbasroy/patch-14

Add troubleshooting for ARM template configuration issue

Author: prmerger-automator[bot]

articles/hdinsight/hdinsight-with-entra-authentication/manage-entra-id-enabled-azure-hdinsight-clusters-with-arm-templates.md

@@ -264,6 +264,27 @@ To create a Microsoft.HDInsight/clusters resource, add the following JSON to you
 				  }
 				}
 ```
+## Troubleshooting
+
+### Issue
+The problem occurs with the restAuthEntraUsers value in the gateway configuration. Azure Resource Manager (ARM) treats any string that starts with [ as an ARM expression. As a result, when ARM encounters the JSON array value, it attempts to interpret it as an ARM function, which causes the deployment to fail.
+
+### Resolution
+To prevent ARM from interpreting the value as an expression, escape the opening bracket by using [[ instead of [. This forces ARM to treat the value as a literal string and pass it through correctly to HDInsight.
+
+### Example
+Before (deployment fails):
+```json
+	"restAuthEntraUsers": "[{\"displayName\":\"John Doe\",\"objectId\":\"<Object ID>\",\"upn\":\"[email protected]\"},{\"displayName\":\"Jane Doe\",\"objectId\":\"<Object ID>\",\"upn\":\"[email protected]\"},{\"displayName\":\"abc\",\"objectId\":\"<Object ID>\",\"upn\":\"[email protected]\"}]"
+```
+
+After (deployment succeeds):
+
+```json
+"restAuthEntraUsers": "[[{\"displayName\":\"John Doe\",\"objectId\":\"<Object ID>\",\"upn\":\"[email protected]\"},{\"displayName\":\"Jane Doe\",\"objectId\":\"<Object ID>\",\"upn\":\"[email protected]\"},{\"displayName\":\"abc\",\"objectId\":\"<Object ID>\",\"upn\":\"[email protected]\"}]"
+```
+> [!NOTE]
+> The only required change is the additional "[" at the beginning of the value.
 
 ## Property Values