Skip to content

Conversation

NirajC-Microsoft
Copy link
Contributor

Purpose

This pull request significantly expands and improves the troubleshooting documentation for Azure deployment errors in docs/TroubleShootingSteps.md. It adds detailed guidance for many new error scenarios, clarifies existing sections, and provides links to relevant Microsoft documentation for easier self-service resolution.

Expanded error coverage and improved guidance:

  • Added troubleshooting steps for several new errors, including Unauthorized - Operation cannot be completed without additional quota, ParentResourceNotfound, ResourceProviderError, Conflict - Cannot use the SKU Basic with File Change Audit, AccountPropertyCannotBeUpdated, InvalidRequestContent, ReadOnlyDisabledSubscription, SkuNotAvailable, CrossTenantDeploymentNotPermitted, RequestDisallowedByPolicy, FlagMustBeSetForRestore/NameUnavailable/CustomDomainInUse, PrincipalNotFound, RedundancyConfigurationNotAvailableInRegion, and DeploymentNotFound. Each new section includes practical steps and links to official documentation.

  • Expanded existing error summary groups to cover additional related error codes, such as combining DeploymentModelNotSupported, ServiceModelDeprecated, and InvalidResourceProperties, and adding The language expression property array index is out of bounds to the group with resource ID errors.

Clarifications for resource ID errors:

  • Added a specific note and example for the error The language expression property array index '8' is out of bounds, clarifying that it is caused by incomplete resource IDs and providing guidance on correct formatting.

Links and references for further troubleshooting:

  • Each error section now includes direct links to relevant Microsoft documentation for deeper troubleshooting, making it easier for users to find solutions and official guidance.

These changes make the troubleshooting guide much more comprehensive and user-friendly, helping users resolve a broader range of deployment issues more efficiently.

  • ...

Does this introduce a breaking change?

  • Yes
  • No

How to Test

  • Get the code
git clone [repo-address]
cd [repo-name]
git checkout [branch-name]
npm install
  • Test the code

What to Check

Verify that the following are valid

  • ...

Other Information

Copilot

This comment was marked as resolved.

Copilot

This comment was marked as resolved.

Copy link

@Suicynic Suicynic left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

multi-agent

@Roopan-Microsoft Roopan-Microsoft merged commit 287ef57 into dev Sep 19, 2025
9 checks passed
@github-actions
Copy link

🎉 This PR is included in version 2.2.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants