docs: Update TroubleshootingSteps.md file with latest errors #340
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 updates the troubleshooting documentation to cover additional Azure deployment errors, providing more detailed guidance and resolution steps for common issues. The changes expand coverage for quotas, networking, authentication, and resource provisioning failures, making it easier to diagnose and resolve deployment blockers.
New and Expanded Error Troubleshooting Coverage:
Quota and API Version Errors:
ServiceQuotaExceedederror when exceeding the free tier quota for Azure AI Search, including steps to identify, delete, or upgrade services, and links to official documentation.NoRegisteredProviderFounderror for unsupported API versions, with instructions on updating API versions in templates and checking supported versions.Networking and Subnet Configuration:
VMSizeIsNotPermittedToEnableAcceleratedNetworking, including how to check supported VM sizes and alternatives.NetworkSecurityGroupNotCompliantForAzureBastionSubnetandSecurityRuleParameterContainsUnsupportedValuefor NSG rules blocking required ports.RouteTableCannotBeAttachedForAzureBastionSubnetfor attempts to attach route tables to Bastion subnets, with clear remediation steps.Authentication and Immutable Properties:
Conflict - Local authentication is disablederror in Azure App Configuration, including how to use Managed Identity and re-enable local auth if necessary.PropertyChangeNotAllowederror for immutable VM properties, explaining the cause and necessary redeployment steps.Resource Provisioning and Parent/Child Dependencies:
FailedIdentityOperation / ManagedEnvironmentScheduledForDeleteerrors in Azure Container Apps, including how to handle pending deletes and resource conflicts.BadRequest - Parent account does not provision correctlyerror for Cognitive Services, with steps to check, delete, or restore parent accounts and resolve soft-delete issues.Does this introduce a breaking change?
Golden Path Validation
Deployment Validation
What to Check
Verify that the following are valid
Other Information