Skip to content

Commit 933cf77

Browse files
updated troubleshoting file
1 parent 9481484 commit 933cf77

1 file changed

Lines changed: 52 additions & 0 deletions

File tree

docs/TroubleShootingSteps.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -297,6 +297,58 @@ The subscription 'xxxx-xxxx' cannot have more than 1 Container App Environments
297297

298298
</details>
299299

300+
<details>
301+
<summary><b>Unauthorized - Operation cannot be completed without additional quota</b> </summary>
302+
303+
- You can check your quota usage using `az vm list-usage`.
304+
305+
```
306+
az vm list-usage --location "<Location>" -o table
307+
```
308+
- To Request more quota refer [VM Quota Request](https://techcommunity.microsoft.com/blog/startupsatmicrosoftblog/how-to-increase-quota-for-specific-types-of-azure-virtual-machines/3792394).
309+
310+
</details>
311+
312+
<details><summary><b>ParentResourceNotfound</b>
313+
</summary>
314+
315+
- You can refer to the [Parent Resource Not found](https://learn.microsoft.com/en-us/azure/azure-resource-manager/troubleshooting/error-parent-resource?tabs=bicep) documentation if you encounter this error.
316+
317+
</details>
318+
319+
<details><summary><b>ResourceProviderError</b></summary>
320+
321+
- This error occurs when the resource provider is not registered in your subscription.
322+
- To register it, refer to [Register Resource Provider](https://learn.microsoft.com/en-us/azure/azure-resource-manager/management/resource-providers-and-types) documentation.
323+
324+
</details>
325+
326+
<details><summary><b>Conflict - Cannot use the SKU Basic with File Change Audit for site.</b></summary>
327+
328+
- This error happens because File Change Audit logs aren’t supported on Basic SKU App Service Plans.
329+
330+
- Upgrading to Premium/Isolated SKU (supports File Change Audit), or
331+
332+
- Disabling File Change Audit in Diagnostic Settings if you must stay on Basic.
333+
- Always cross-check the [supported log types](https://aka.ms/supported-log-types)
334+
before adding diagnostic logs to your Bicep templates.
335+
336+
</details>
337+
338+
<details>
339+
340+
<summary><b>AccountPropertyCannotBeUpdated</b></summary>
341+
342+
- The property **`isHnsEnabled`** (Hierarchical Namespace for Data Lake Gen2) is **read-only** and can only be set during **storage account creation**.
343+
- Once a storage account is created, this property **cannot be updated**.
344+
- Trying to update it via ARM template, Bicep, CLI, or Portal will fail.
345+
346+
- **Resolution**
347+
- Create a **new storage account** with `isHnsEnabled=true` if you require hierarchical namespace.
348+
- Migration may be needed if you already have data.
349+
- Refer to [Storage Account Update Restrictions](https://aka.ms/storageaccountupdate) for more details.
350+
351+
</details>
300352

301353
💡 Note: If you encounter any other issues, you can refer to the [Common Deployment Errors](https://learn.microsoft.com/en-us/azure/azure-resource-manager/troubleshooting/common-deployment-errors) documentation.
302354
If the problem persists, you can also raise an bug in our [MACAE Github Issues](https://github.com/microsoft/Multi-Agent-Custom-Automation-Engine-Solution-Accelerator/issues) for further support.

0 commit comments

Comments
 (0)