Skip to content

[App Service] az webapp list-runtimes: Pre-announce breaking changes#32905

Merged
yanzhudd merged 2 commits intoAzure:devfrom
seligj95:list-runtimes-v2-preannounce
Mar 5, 2026
Merged

[App Service] az webapp list-runtimes: Pre-announce breaking changes#32905
yanzhudd merged 2 commits intoAzure:devfrom
seligj95:list-runtimes-v2-preannounce

Conversation

@seligj95
Copy link
Contributor

@seligj95 seligj95 commented Mar 4, 2026

Related command
az webapp list-runtimes

Description

Pre-announce upcoming breaking changes for az webapp list-runtimes targeting the next breaking change window (Build 2026).

This PR adds _breaking_change.py to the appservice module to display warnings when users run az webapp list-runtimes:

  1. Output format change: The output will change from a flat list of strings to a structured list of objects with keys: os, runtime, version, config, support, end_of_life.
  2. --linux removal: Deprecated in favor of --os linux.
  3. --show-runtime-details removal: Will be removed with no replacement (subsumed by new output format).

The actual breaking change implementation is in #32903 (draft, to be merged during the breaking change window).

Testing Guide

# After this PR, running the command should show deprecation warnings:
az webapp list-runtimes
# WARNING: The output will change from a flat list of strings to a structured list of objects...

az webapp list-runtimes --linux
# WARNING: Option '--linux' has been deprecated and will be removed in next breaking change release...

az webapp list-runtimes --show-runtime-details
# WARNING: Option '--show-runtime-details' has been deprecated and will be removed in next breaking change release...

History Notes

This PR is not customer-facing (pre-announcement warnings only).


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

Pre-announce upcoming breaking changes for az webapp list-runtimes:
- Output format changing from flat string list to structured list of dicts
- --linux parameter being removed (use --os linux)
- --show-runtime-details parameter being removed

Targeting the next breaking change window (Build 2026).
@seligj95 seligj95 requested review from jsntcy and yanzhudd as code owners March 4, 2026 22:11
Copilot AI review requested due to automatic review settings March 4, 2026 22:11
@azure-client-tools-bot-prd
Copy link

azure-client-tools-bot-prd bot commented Mar 4, 2026

️✔️AzureCLI-FullTest
️✔️acr
️✔️latest
️✔️3.12
️✔️3.13
️✔️acs
️✔️latest
️✔️3.12
️✔️3.13
️✔️advisor
️✔️latest
️✔️3.12
️✔️3.13
️✔️ams
️✔️latest
️✔️3.12
️✔️3.13
️✔️apim
️✔️latest
️✔️3.12
️✔️3.13
️✔️appconfig
️✔️latest
️✔️3.12
️✔️3.13
️✔️appservice
️✔️latest
️✔️3.12
️✔️3.13
️✔️aro
️✔️latest
️✔️3.12
️✔️3.13
️✔️backup
️✔️latest
️✔️3.12
️✔️3.13
️✔️batch
️✔️latest
️✔️3.12
️✔️3.13
️✔️batchai
️✔️latest
️✔️3.12
️✔️3.13
️✔️billing
️✔️latest
️✔️3.12
️✔️3.13
️✔️botservice
️✔️latest
️✔️3.12
️✔️3.13
️✔️cdn
️✔️latest
️✔️3.12
️✔️3.13
️✔️cloud
️✔️latest
️✔️3.12
️✔️3.13
️✔️cognitiveservices
️✔️latest
️✔️3.12
️✔️3.13
️✔️compute_recommender
️✔️latest
️✔️3.12
️✔️3.13
️✔️computefleet
️✔️latest
️✔️3.12
️✔️3.13
️✔️config
️✔️latest
️✔️3.12
️✔️3.13
️✔️configure
️✔️latest
️✔️3.12
️✔️3.13
️✔️consumption
️✔️latest
️✔️3.12
️✔️3.13
️✔️container
️✔️latest
️✔️3.12
️✔️3.13
️✔️containerapp
️✔️latest
️✔️3.12
️✔️3.13
️✔️core
️✔️latest
️✔️3.12
️✔️3.13
️✔️cosmosdb
️✔️latest
️✔️3.12
️✔️3.13
️✔️databoxedge
️✔️latest
️✔️3.12
️✔️3.13
️✔️dls
️✔️latest
️✔️3.12
️✔️3.13
️✔️dms
️✔️latest
️✔️3.12
️✔️3.13
️✔️eventgrid
️✔️latest
️✔️3.12
️✔️3.13
️✔️eventhubs
️✔️latest
️✔️3.12
️✔️3.13
️✔️feedback
️✔️latest
️✔️3.12
️✔️3.13
️✔️find
️✔️latest
️✔️3.12
️✔️3.13
️✔️hdinsight
️✔️latest
️✔️3.12
️✔️3.13
️✔️identity
️✔️latest
️✔️3.12
️✔️3.13
️✔️iot
️✔️latest
️✔️3.12
️✔️3.13
️✔️keyvault
️✔️latest
️✔️3.12
️✔️3.13
️✔️lab
️✔️latest
️✔️3.12
️✔️3.13
️✔️managedservices
️✔️latest
️✔️3.12
️✔️3.13
️✔️maps
️✔️latest
️✔️3.12
️✔️3.13
️✔️marketplaceordering
️✔️latest
️✔️3.12
️✔️3.13
️✔️monitor
️✔️latest
️✔️3.12
️✔️3.13
️✔️mysql
️✔️latest
️✔️3.12
️✔️3.13
️✔️netappfiles
️✔️latest
️✔️3.12
️✔️3.13
️✔️network
️✔️latest
️✔️3.12
️✔️3.13
️✔️policyinsights
️✔️latest
️✔️3.12
️✔️3.13
️✔️postgresql
️✔️latest
️✔️3.12
️✔️3.13
️✔️privatedns
️✔️latest
️✔️3.12
️✔️3.13
️✔️profile
️✔️latest
️✔️3.12
️✔️3.13
️✔️rdbms
️✔️latest
️✔️3.12
️✔️3.13
️✔️redis
️✔️latest
️✔️3.12
️✔️3.13
️✔️relay
️✔️latest
️✔️3.12
️✔️3.13
️✔️resource
️✔️latest
️✔️3.12
️✔️3.13
️✔️role
️✔️latest
️✔️3.12
️✔️3.13
️✔️search
️✔️latest
️✔️3.12
️✔️3.13
️✔️security
️✔️latest
️✔️3.12
️✔️3.13
️✔️servicebus
️✔️latest
️✔️3.12
️✔️3.13
️✔️serviceconnector
️✔️latest
️✔️3.12
️✔️3.13
️✔️servicefabric
️✔️latest
️✔️3.12
️✔️3.13
️✔️signalr
️✔️latest
️✔️3.12
️✔️3.13
️✔️sql
️✔️latest
️✔️3.12
️✔️3.13
️✔️sqlvm
️✔️latest
️✔️3.12
️✔️3.13
️✔️storage
️✔️latest
️✔️3.12
️✔️3.13
️✔️synapse
️✔️latest
️✔️3.12
️✔️3.13
️✔️telemetry
️✔️latest
️✔️3.12
️✔️3.13
️✔️util
️✔️latest
️✔️3.12
️✔️3.13
️✔️vm
️✔️latest
️✔️3.12
️✔️3.13

@azure-client-tools-bot-prd
Copy link

azure-client-tools-bot-prd bot commented Mar 4, 2026

⚠️AzureCLI-BreakingChangeTest
⚠️appservice
rule cmd_name rule_message suggest_message
⚠️ 1003 - CmdPropAdd webapp list-runtimes cmd webapp list-runtimes added property deprecate_info_target

@yonzhan
Copy link
Collaborator

yonzhan commented Mar 4, 2026

Thank you for your contribution! We will review the pull request and get back to you soon.

@github-actions
Copy link

github-actions bot commented Mar 4, 2026

The git hooks are available for azure-cli and azure-cli-extensions repos. They could help you run required checks before creating the PR.

Please sync the latest code with latest dev branch (for azure-cli) or main branch (for azure-cli-extensions).
After that please run the following commands to enable git hooks:

pip install azdev --upgrade
azdev setup -c <your azure-cli repo path> -r <your azure-cli-extensions repo path>

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds App Service module breaking-change registrations to pre-announce upcoming behavior/parameter removals for az webapp list-runtimes ahead of the next breaking change window.

Changes:

  • Register an output breaking-change warning for webapp list-runtimes describing the upcoming structured output format.
  • Register argument deprecation warnings for --linux (redirect to --os linux) and --show-runtime-details (no replacement).

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@yanzhudd yanzhudd changed the title [App Service] Pre-announce breaking changes for az webapp list-runtimes [App Service] az webapp list-runtimes: Pre-announce breaking changes Mar 5, 2026
@yanzhudd
Copy link
Contributor

yanzhudd commented Mar 5, 2026

please let me know when the PR is ready to review/merge

@seligj95
Copy link
Contributor Author

seligj95 commented Mar 5, 2026

please let me know when the PR is ready to review/merge

@yanzhudd the PR is ready. all checks are passing. thanks! #32903

@yanzhudd yanzhudd merged commit d17504b into Azure:dev Mar 5, 2026
48 checks passed
@seligj95 seligj95 deleted the list-runtimes-v2-preannounce branch March 5, 2026 15:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Auto-Assign Auto assign by bot Web Apps az webapp

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants