Skip to content

{ACR} az acr replication create/update: Add --global-endpoint-routing flag and deprecate --region-endpoint-enabled flag#32954

Merged
wangzelin007 merged 4 commits intoAzure:devfrom
lizMSFT:zoeyli/acr/replication_region_endpoint
Mar 24, 2026
Merged

{ACR} az acr replication create/update: Add --global-endpoint-routing flag and deprecate --region-endpoint-enabled flag#32954
wangzelin007 merged 4 commits intoAzure:devfrom
lizMSFT:zoeyli/acr/replication_region_endpoint

Conversation

@lizMSFT
Copy link
Copy Markdown
Member

@lizMSFT lizMSFT commented Mar 11, 2026

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
image
image

History Notes
[ACR] az acr replication create/update: Add --global-endpoint-routing parameter and redirect --region-endpoint-enabled to it to avoid confusion with registry-level --regional-endpoints


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

@lizMSFT lizMSFT requested review from jsntcy and yanzhudd as code owners March 11, 2026 03:42
Copilot AI review requested due to automatic review settings March 11, 2026 03:42
@azure-client-tools-bot-prd
Copy link
Copy Markdown

azure-client-tools-bot-prd bot commented Mar 11, 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 Mar 11, 2026

⚠️AzureCLI-BreakingChangeTest
⚠️acr
rule cmd_name rule_message suggest_message
⚠️ 1006 - ParaAdd acr replication create cmd acr replication create added parameter global_endpoint_routing
⚠️ 1006 - ParaAdd acr replication update cmd acr replication update added parameter global_endpoint_routing

@yonzhan
Copy link
Copy Markdown
Collaborator

yonzhan commented Mar 11, 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

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.

@lizMSFT lizMSFT requested a review from kairu-ms as a code owner March 11, 2026 04:04
@lizMSFT lizMSFT requested a review from johnsonshi March 12, 2026 02:21
@yanzhudd
Copy link
Copy Markdown
Contributor

/azp run

@azure-pipelines
Copy link
Copy Markdown

Azure Pipelines successfully started running 3 pipeline(s).

@yanzhudd yanzhudd changed the title [ACR] az acr replication create|update: Add --global-endpoint-routing flag and deprecate --region-endpoint-enabled flag [ACR] az acr replication create|update: Add --global-endpoint-routing flag and deprecate --region-endpoint-enabled flag Mar 19, 2026
@yanzhudd
Copy link
Copy Markdown
Contributor

/azp run

@azure-pipelines
Copy link
Copy Markdown

Azure Pipelines successfully started running 3 pipeline(s).

@yanzhudd
Copy link
Copy Markdown
Contributor

Hi @lizMSFT
please pull the latest code from the dev branch and push again, and the ci issue should be resolved

@lizMSFT lizMSFT force-pushed the zoeyli/acr/replication_region_endpoint branch from ce4b830 to e6b12f0 Compare March 20, 2026 02:43
@yanzhudd
Copy link
Copy Markdown
Contributor

/azp run

@azure-pipelines
Copy link
Copy Markdown

Azure Pipelines successfully started running 3 pipeline(s).

@yanzhudd yanzhudd changed the title [ACR] az acr replication create|update: Add --global-endpoint-routing flag and deprecate --region-endpoint-enabled flag {ACR} az acr replication create/update: Add --global-endpoint-routing flag and deprecate --region-endpoint-enabled flag Mar 20, 2026
@wangzelin007 wangzelin007 merged commit 99533ed into Azure:dev Mar 24, 2026
48 checks passed
nddq pushed a commit to nddq/azure-cli that referenced this pull request Mar 25, 2026
…ing` flag and deprecate `--region-endpoint-enabled` flag (Azure#32954)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants