[ACR] az acr replication create|update: Add --global-endpoint-routing flag and deprecate --region-endpoint-enabled flag

[lizMSFT]

Related command
az acr replication create
az acr replication update

Description
Customers have been confusing --region-endpoint-enabled (per-geo-replica, controls global endpoint routing) with the registry-level --regional-endpoints flag (az acr create|update, enables regional endpoint URLs)

This PR introduces --global-endpoint-routing as the new flag for az acr replication create|update and deprecates --region-endpoint-enabled with a hidden alias and breaking change announcement, to resolve customer confusion with the registry-level --regional-endpoints flag.

This PR does not remove --region-endpoint-enabled. A follow-up PR will be created before the breaking change window to complete the rename by removing the deprecated flag.

Testing Guide

History Notes
[ACR] az acr replication create|update: Add --global-endpoint-routing flag and deprecate --region-endpoint-enabled to avoid confusion with registry-level --regional-endpoints

---

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]

Validation for Azure CLI Full Test Starting...

Thanks for your contribution!

[azure-client-tools-bot-prd]

Validation for Breaking Change Starting...

Thanks for your contribution!

[yonzhan]

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

[github-actions]

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>

[Copilot]

Pull request overview

Renames the ACR replication routing flag to reduce confusion with registry-level regional endpoints by introducing --global-endpoint-routing on az acr replication create|update, while keeping --region-endpoint-enabled as a deprecated alias and announcing the deprecation via breaking-change infrastructure.

Changes:

• Add --global-endpoint-routing option (aliasing the existing region_endpoint_enabled argument) for acr replication create|update.
• Deprecate --region-endpoint-enabled via argument option deprecation and register upcoming breaking-change notices.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File	Description
src/azure-cli/azure/cli/command_modules/acr/_params.py	Introduces --global-endpoint-routing option and defines the deprecated alias behavior for the old flag.
src/azure-cli/azure/cli/command_modules/acr/_breaking_change.py	Registers breaking-change deprecation notices for --region-endpoint-enabled on replication create/update.

---

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