[ACR] add new acrregionalendpoint extension for private preview of ACR Regional Endpoints feature by lizMSFT · Pull Request #9500 · Azure/azure-cli-extensions

lizMSFT · 2026-01-06T22:09:31Z

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

Related command

az acr create/update/show
az acr show-endpoints
az acr login
az acr import

Description

This PR is NOT READY yet. Still waiting for the finalization of the rest api specs for 2026-01-01-preview.

Changes Introduced:

Initial preview release for Azure Container Registry regional endpoints support.
Add: --regional-endpoints parameter to az acr create and az acr update commands to enable regional endpoint functionality.
Add: --endpoint parameter to az acr login command to authenticate against a specific regional endpoint.
Add: Enhanced az acr show command to display regionalEndpoints and regionalEndpointHostNames properties in registry information.
Add: Enhanced az acr show-endpoints command to display comprehensive endpoint information including registry login server, data endpoints, and regional endpoints.
Add: Enhanced az acr import command to automatically detect and handle regional endpoint URIs in source image specifications.

Testing

az acr create:

az acr update:

az acr show:

az acr show-endpoints:

az acr login:

az acr import:

General Guidelines

Have you run azdev style <YOUR_EXT> locally? (pip install azdev required)
Have you run python scripts/ci/test_index.py -q locally? (pip install wheel==0.30.0 required)
My extension version conforms to the Extension version schema

For new extensions:

My extension description/summary conforms to the Extension Summary Guidelines.

About Extension Publish

There is a pipeline to automatically build, upload and publish extension wheels.
Once your pull request is merged into main branch, a new pull request will be created to update src/index.json automatically.
You only need to update the version information in file setup.py and historical information in file HISTORY.rst in your PR but do not modify src/index.json.

…R Regional Endpoints feature

azure-client-tools-bot-prd · 2026-01-06T22:09:37Z

Validation for Breaking Change Starting...

Thanks for your contribution!

azure-client-tools-bot-prd · 2026-01-06T22:09:40Z

Hi @lizMSFT,
Please write the description of changes which can be perceived by customers into HISTORY.rst.
If you want to release a new extension version, please update the version in setup.py as well.

yonzhan · 2026-01-06T22:09:43Z

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

github-actions · 2026-01-06T22:09:45Z

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>

github-actions · 2026-01-06T22:13:04Z

For more info about extension versioning, please refer to Extension version schema

Copilot

Pull request overview

This pull request adds a new Azure CLI extension called "acrregionalendpoint" for the private preview of the ACR Regional Endpoints feature. The extension provides management capabilities for Azure Container Registry regional endpoints.

Key changes:

New extension scaffolding with version 1.0.0
Vendored Azure Container Registry Management SDK
Support for API version 2025-12-01-preview

Reviewed changes

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

Show a summary per file

File	Description
setup.py	Extension metadata, dependencies, and packaging configuration
azext_metadata.json	Extension configuration marking it as preview with minimum CLI version 2.80.0
vendored_sdks/containerregistry/	Auto-generated Container Registry Management SDK code
_configuration.py (sync/async)	SDK configuration with API version 2025-12-01-preview
models/	Auto-generated model classes and enums for the SDK
operations/	Auto-generated operation classes for SDK functionality
tests/	Test structure setup (placeholder files)

lizMSFT · 2026-01-07T04:06:09Z

src/acrregionalendpoint/azext_acrregionalendpoint/custom.py

@@ -0,0 +1,401 @@
+# --------------------------------------------------------------------------------------------


Reference: https://github.com/Azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/acr/custom.py

lizMSFT · 2026-01-07T04:06:53Z

src/acrregionalendpoint/azext_acrregionalendpoint/import.py

@@ -0,0 +1,184 @@
+# --------------------------------------------------------------------------------------------


Reference: https://github.com/Azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/acr/import.py

src/acrregionalendpoint/azext_acrregionalendpoint/_params.py

Copilot

Pull request overview

Copilot reviewed 38 out of 43 changed files in this pull request and generated 8 comments.

src/acrregionalendpoint/azext_acrregionalendpoint/_params.py

...regionalendpoint/azext_acrregionalendpoint/vendored_sdks/containerregistry/_configuration.py

...onalendpoint/azext_acrregionalendpoint/vendored_sdks/containerregistry/aio/_configuration.py

src/acrregionalendpoint/azext_acrregionalendpoint/tests/latest/recordings/test_acr_login.yaml

...egionalendpoint/tests/latest/recordings/test_acr_create_with_regional_endpoint_disabled.yaml

...regionalendpoint/tests/latest/recordings/test_acr_create_with_regional_endpoint_enabled.yaml

src/acrregionalendpoint/azext_acrregionalendpoint/custom.py

Copilot

Pull request overview

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

src/acrregionalendpoint/azext_acrregionalendpoint/import.py

...egionalendpoint/azext_acrregionalendpoint/tests/latest/test_acr_regionalendpoint_scenario.py

lizMSFT · 2026-02-02T20:49:54Z

src/acrregionalendpoint/azext_acrregionalendpoint/custom.py

+
+    return info
+
+


Copied the functions below from azure.cli.command_modules.acr.custom due to potential upcoming changes on the CLI side.

More details in: Azure/azure-sdk-for-python#44775 (comment)

…ands test

[ACR] add new acrregionalendpoint extension for private preview of AC…

b11500c

…R Regional Endpoints feature

Copilot AI review requested due to automatic review settings January 6, 2026 22:09

azure-client-tools-bot-prd bot added this to the February 2026 (2026-02-03) milestone Jan 6, 2026

Copilot started reviewing on behalf of lizMSFT January 6, 2026 22:10 View session

github-actions bot added the release-version-block Updates do not qualify release version rules. NOTE: please do not edit it manually. label Jan 6, 2026

Copilot AI reviewed Jan 6, 2026

View reviewed changes

yonzhan requested review from yanzhudd and zhoxing-ms January 6, 2026 23:47

yonzhan assigned zhoxing-ms Jan 6, 2026

fix option_length_too_long

cc477d9

github-actions bot removed the release-version-block Updates do not qualify release version rules. NOTE: please do not edit it manually. label Jan 7, 2026

Update HISTORY.rst

ad85d9d

lizMSFT commented Jan 7, 2026

View reviewed changes

lizMSFT commented Jan 12, 2026

View reviewed changes

src/acrregionalendpoint/azext_acrregionalendpoint/_params.py Outdated Show resolved Hide resolved

lizMSFT requested a review from savaradh January 12, 2026 20:21

lizMSFT added 3 commits January 22, 2026 15:53

update parameter name and update to use 2026-01-01-preview api version

d421ef1

fix

40f8029

fix

48a4350

lizMSFT requested a review from Copilot January 29, 2026 00:01

Copilot started reviewing on behalf of lizMSFT January 29, 2026 00:02 View session

Copilot AI reviewed Jan 29, 2026

View reviewed changes

fix

01b3c16

lizMSFT requested a review from Copilot January 29, 2026 01:51

Copilot started reviewing on behalf of lizMSFT January 29, 2026 01:51 View session

Copilot AI reviewed Jan 29, 2026

View reviewed changes

src/acrregionalendpoint/azext_acrregionalendpoint/import.py Show resolved Hide resolved

...egionalendpoint/azext_acrregionalendpoint/tests/latest/test_acr_regionalendpoint_scenario.py Show resolved Hide resolved

lizMSFT added 2 commits February 2, 2026 14:40

update az acr login flags

1219d21

update sdk

70af5c8

lizMSFT commented Feb 2, 2026

View reviewed changes

update the test to use prod region instead of euap; add test_acr_comm…

76c0b14

…ands test

		@@ -0,0 +1,401 @@
		# --------------------------------------------------------------------------------------------

		@@ -0,0 +1,184 @@
		# --------------------------------------------------------------------------------------------

Conversation

lizMSFT commented Jan 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Related command

Description

Testing

General Guidelines

About Extension Publish

Uh oh!

azure-client-tools-bot-prd bot commented Jan 6, 2026

Uh oh!

azure-client-tools-bot-prd bot commented Jan 6, 2026

Uh oh!

yonzhan commented Jan 6, 2026

Uh oh!

github-actions bot commented Jan 6, 2026

Uh oh!

github-actions bot commented Jan 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

lizMSFT Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

lizMSFT Jan 7, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Uh oh!

Uh oh!

Uh oh!

lizMSFT Feb 2, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

lizMSFT commented Jan 6, 2026 •

edited

Loading

github-actions bot commented Jan 6, 2026 •

edited

Loading