Skip to content

{ACR} az acr replication create/update: Remove --region-endpoint-enabled flag#33173

Open
lizMSFT wants to merge 3 commits into
Azure:devfrom
lizMSFT:zoeyli/acr/remove_deprecated_flag
Open

{ACR} az acr replication create/update: Remove --region-endpoint-enabled flag#33173
lizMSFT wants to merge 3 commits into
Azure:devfrom
lizMSFT:zoeyli/acr/remove_deprecated_flag

Conversation

@lizMSFT
Copy link
Copy Markdown
Member

@lizMSFT lizMSFT commented Apr 10, 2026

Related command
az acr replication create
az acr replication update

Description
This is the follow-up PR to #32954 which introduced --global-endpoint-routing and deprecated --region-endpoint-enabled.

This PR completes the breaking change by removing the deprecated --region-endpoint-enabled flag.

Testing Guide
image

History Notes
[ACR] BREAKING CHANGE: az acr replication create/update: Remove deprecated --region-endpoint-enabled flag and use --global-endpoint-routing instead.


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

@lizMSFT lizMSFT requested review from NoriZC and yanzhudd as code owners April 10, 2026 21:52
Copilot AI review requested due to automatic review settings April 10, 2026 21:52
@azure-client-tools-bot-prd
Copy link
Copy Markdown

azure-client-tools-bot-prd Bot commented Apr 10, 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
Copy Markdown

azure-client-tools-bot-prd Bot commented Apr 10, 2026

❌AzureCLI-BreakingChangeTest
❌acr
rule cmd_name rule_message suggest_message
1007 - ParaRemove acr replication create cmd acr replication create removed parameter region_endpoint_enabled please add back parameter region_endpoint_enabled for cmd acr replication create
1007 - ParaRemove acr replication update cmd acr replication update removed parameter region_endpoint_enabled please add back parameter region_endpoint_enabled for cmd acr replication update
1007 - ParaRemove acr update cmd acr update removed parameter endpoint_protocol please add back parameter endpoint_protocol for cmd acr update

Please submit your Breaking Change Pre-announcement ASAP if you haven't already. Please note:

  • Breaking changes can only be merged during the designated breaking change window
  • A pre-announcement must be released at least one month in advance

For more details on how to introduce breaking changes, refer to the documentation: azure-cli/doc/how_to_introduce_breaking_changes.md

@yonzhan
Copy link
Copy Markdown
Collaborator

yonzhan commented Apr 10, 2026

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

@github-actions
Copy link
Copy Markdown

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
Copy Markdown
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

Removes the deprecated --region-endpoint-enabled flag from az acr replication create/update, completing the rename to the clearer --global-endpoint-routing option in the ACR command module.

Changes:

  • Update ACR replication create/update implementation to only accept global_endpoint_routing and map it to the SDK’s region_endpoint_enabled property.
  • Remove the region_endpoint_enabled CLI argument definition and its associated linter exclusions.
  • Update ACR replication scenario tests to use --global-endpoint-routing.

Reviewed changes

Copilot reviewed 4 out of 5 changed files in this pull request and generated 1 comment.

File Description
src/azure-cli/azure/cli/command_modules/acr/tests/latest/test_acr_commands.py Updates scenario tests to use --global-endpoint-routing instead of the removed flag.
src/azure-cli/azure/cli/command_modules/acr/replication.py Removes deprecated parameter plumbing and uses global_endpoint_routing to set region_endpoint_enabled.
src/azure-cli/azure/cli/command_modules/acr/_params.py Removes the region_endpoint_enabled argument and keeps global_endpoint_routing as the sole flag.
linter_exclusions.yml Removes linter exclusions for the deleted parameter.

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

Comment thread src/azure-cli/azure/cli/command_modules/acr/_params.py
@yanzhudd
Copy link
Copy Markdown
Contributor

Please note that we release breaking changes only in the breaking change windows (Build and Ignite), so we need wait until that time to merge this PR.
Before the actual breaking change being released, please refer to this document to pre-announce it: https://eng.ms/docs/cloud-ai-platform/azure-core/azure-experiences-and-ecosystems/azure-portal-and-client-tools-ruhim/azure-cli-tools-azure-cli-powershell-and-terraform/azure-cli-tools/teams_docs/azcli_docs/breaking_changes

@lizMSFT lizMSFT force-pushed the zoeyli/acr/remove_deprecated_flag branch from 23cd41c to 1ef2d12 Compare April 20, 2026 18:49
@lizMSFT
Copy link
Copy Markdown
Member Author

lizMSFT commented Apr 20, 2026

Thank you @yanzhudd for the comments. We've already announced this breaking change in the https://learn.microsoft.com/en-us/cli/azure/upcoming-breaking-changes?view=azure-cli-latest#acr via the previous PR.

This PR removes the breaking change announcement as well. I couldn't find clear guidance on whether the announcement should be removed after the release, but I went ahead and did so here; please let me know if we should keep it instead.

Additionally, the breaking change message from the previous PR still indicates the next breaking change release is 2.86.0, so I raised this PR accordingly. Please let me know if there's anything else we need to address. Thanks.

@microsoft-github-policy-service
Copy link
Copy Markdown
Contributor

🔔 Routing this PR to @act-observability-squad.

@yanzhudd yanzhudd changed the title [ACR] az acr replication create/update: Remove --region-endpoint-enabled flag {ACR} az acr replication create/update: Remove --region-endpoint-enabled flag May 15, 2026
@yanzhudd
Copy link
Copy Markdown
Contributor

/azp run

@azure-pipelines
Copy link
Copy Markdown

Azure Pipelines successfully started running 3 pipeline(s).

@lizMSFT lizMSFT force-pushed the zoeyli/acr/remove_deprecated_flag branch from 6c03b00 to bf88c58 Compare May 15, 2026 21:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants