[App Service] az webapp create: Add enriched failure logs for quicker resolution

[Shi1810]

🤖 PR Validation — ⚠️ Review suggested

Breaking Changes	Tests
⚠️ None	️✔️ 130/130

⚠️AzureCLI-BreakingChangeTest

⚠️appservice

rule	cmd_name	rule_message	suggest_message
⚠️ 1006 - ParaAdd	webapp create	cmd webapp create added parameter enriched_errors

Related command
az webapp create

Description
Currently, only raw error messages are logged in the event of webapp create command failures.

With this update, customers will have access to the --enriched-error feature flag, allowing them to view detailed failure logs and resolve errors more efficiently.

Note: these changes do not impact functions and windows app service.

Testing Guide
az webapp create -g $env:CREATE_TEST_RG -n "cli-create-cipher-$env:CREATE_TEST_SUFFIX" -p $env:CREATE_TEST_PLAN --container-image-name nginx:latest --min-tls-cipher-suite INVALID_CIPHER --enriched-errors true

az webapp create -g $env:ENRICHED_RUNTIME_RG -n "cli-runtime-on-1787211286" -p $env:ENRICHED_RUNTIME_PLAN --runtime PYTHON:99.99 --enriched-errors true

History Notes

[App Service] az webapp create: Add --enriched-errors parameter to see detailed failure log

---

This checklist is used to make sure that common guidelines for a pull request are followed.

• The PR title and description has followed the guideline in Submitting Pull Requests.

• I adhere to the Command Guidelines.

• I adhere to the Error Handling Guidelines.

[azure-client-tools-bot-prd]

Hi Shi1810,
Since the current milestone time is less than 7 days, this pr may not catch up with this release.

[azure-pipelines]

Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

[Aditya Pujara (a0x1ab)]

/azp run

[azure-pipelines]

Azure Pipelines:
Successfully started running 3 pipeline(s).

[azure-pipelines]

Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

[Copilot]

Pull request overview

This PR adds an opt-in --enriched-errors flag to az webapp create (Linux-only) so that common creation failures are rethrown as context-enriched diagnostics (error code + stage + suggested fixes + Copilot prompt) instead of only raw ARM/SDK errors.

Changes:

• Adds --enriched-errors to az webapp create and wires it into create_webapp to enrich Linux runtime validation and ARM create failures.
• Introduces webapp-create-specific failure patterns and matching logic, plus context/message builders and a raiser API in the deployment context engine.
• Adds unit tests covering pattern matching, context/message formatting, and end-to-end behavior for enriched vs non-enriched paths.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
src/azure-cli/azure/cli/command_modules/appservice/custom.py	Adds enriched_errors handling to create_webapp, enriching Linux runtime validation and control-plane create failures.
src/azure-cli/azure/cli/command_modules/appservice/_params.py	Exposes --enriched-errors on az webapp create (Linux-only behavior).
src/azure-cli/azure/cli/command_modules/appservice/_deployment_failure_patterns.py	Adds webapp-create failure patterns and matching helper for common create-time failures.
src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py	Adds context/message/raise helpers for enriched webapp-create errors.
src/azure-cli/azure/cli/command_modules/appservice/tests/latest/test_deployment_context_engine.py	Adds unit tests for webapp-create enrichment (match/build/format/raise).
src/azure-cli/azure/cli/command_modules/appservice/tests/latest/test_webapp_commands_thru_mock.py	Adds mocked tests validating enriched vs preserved exceptions for Linux/Windows create flows.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Aditya Pujara (a0x1ab)]

/azp run

[azure-pipelines]

Azure Pipelines:
Successfully started running 3 pipeline(s).