docs: Update TroubleshootingSteps.md file with latest errors #418
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Purpose
This pull request expands and updates the troubleshooting documentation in
docs/TroubleShootingSteps.mdby adding several new Azure deployment error scenarios, their causes, and detailed resolution steps. The new entries cover quota limits, unsupported configurations, API version issues, authentication problems, and deployment conflicts, providing actionable guidance and references for each case.Major additions and updates:
Quota and API Version Errors:
ServiceQuotaExceededwhen hitting the free tier limit for Azure AI Search, including how to list, delete, or upgrade services, and how to request a quota increase.NoRegisteredProviderFounderror, explaining causes related to unsupported API versions and providing steps to update templates and check supported versions.Networking and Bastion Subnet Issues:
VMSizeIsNotPermittedToEnableAcceleratedNetworking, with instructions to select supported VM sizes or disable the feature.NetworkSecurityGroupNotCompliantForAzureBastionSubnetandSecurityRuleParameterContainsUnsupportedValue, detailing required NSG rules for Azure Bastion.RouteTableCannotBeAttachedForAzureBastionSubnet, clarifying that route tables cannot be associated with the Bastion subnet.Authentication and Resource Immutability:
Conflict - Local authentication is disabledin Azure App Configuration, explaining how to switch to Managed Identity or re-enable local authentication.PropertyChangeNotAllowedto explain immutable VM properties (like admin username) and how to redeploy with new credentials.Deployment and Provisioning Conflicts:
FailedIdentityOperation / ManagedEnvironmentScheduledForDeletein Azure Container Apps, with steps to handle pending deletes and naming conflicts.BadRequest - Parent account does not provision correctly, covering issues with Cognitive Services parent/child resource provisioning and soft-delete restores.Does this introduce a breaking change?
Golden Path Validation
Deployment Validation
What to Check
Verify that the following are valid
Other Information