Skip to content

[ACR] az acr update: Add --endpoint-protocol parameter to support specifying the endpoint protocol for the registry - #33089

Merged
Julie Zhu (yanzhudd) merged 3 commits into
Azure:devfrom
avtakkar:add-ds-endpoints
May 15, 2026
Merged

Julie Zhu (yanzhudd) merged 3 commits into
Azure:devfrom
avtakkar:add-ds-endpoints

Conversation

@avtakkar

Copy link
Copy Markdown
Contributor

Add support for configuring the endpoint protocol (IPv4 and/or IPv6) on Azure Container Registries via az acr update.

Changes:

  • Add --endpoint-protocol parameter with enum values IPv4, IPv4AndIPv6
  • Set instance.endpoint_protocol in acr_update_custom() when provided
  • Add help text example for updating endpoint protocol
  • Add test_acr_with_dual_stack_endpoints scenario test

Requires azure-mgmt-containerregistry >= 15.1.0b1 with API version 2026-01-01-preview which includes the EndpointProtocol property on the Registry model.

Validated on dogfood registry srcregistryaue (Australia East):

  • az acr update --endpoint-protocol IPv4AndIPv6 → success
  • az acr update --endpoint-protocol IPv4 → success

Related command

Description

Testing Guide

History Notes

[Component Name 1] BREAKING CHANGE: az command a: Make some customer-facing breaking change
[Component Name 2] az command b: Add some customer-facing feature


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

@azure-client-tools-bot-prd

azure-client-tools-bot-prd Bot commented Mar 27, 2026

Copy link
Copy Markdown
️✔️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

Hi Aviral Takkar (@avtakkar),
Since the current milestone time is less than 7 days, this pr will be reviewed in the next milestone.

@yonzhan

Copy link
Copy Markdown
Collaborator

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

@azure-client-tools-bot-prd

azure-client-tools-bot-prd Bot commented Mar 27, 2026

Copy link
Copy Markdown
⚠️AzureCLI-BreakingChangeTest
⚠️acr
rule cmd_name rule_message suggest_message
⚠️ 1006 - ParaAdd acr update cmd acr update added parameter endpoint_protocol

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

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Adds support in the ACR command module for configuring an Azure Container Registry’s endpoint protocol (IPv4 vs dual-stack) via az acr update.

Changes:

  • Introduces --endpoint-protocol (IPv4 / IPv4AndIPv6) to az acr update.
  • Wires the new argument through acr_update_custom() to set instance.endpoint_protocol.
  • Adds CLI help example and a new scenario test for dual-stack endpoints.

Reviewed changes

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

File Description
src/azure-cli/azure/cli/command_modules/acr/custom.py Sets endpoint_protocol on the update parameters when provided.
src/azure-cli/azure/cli/command_modules/acr/_params.py Adds the --endpoint-protocol argument to acr update.
src/azure-cli/azure/cli/command_modules/acr/_help.py Documents an example usage of --endpoint-protocol.
src/azure-cli/azure/cli/command_modules/acr/tests/latest/test_acr_commands.py Adds a scenario test covering IPv4 ↔ dual-stack updates.

💡 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 Outdated
@avtakkar Aviral Takkar (avtakkar) changed the title feat(acr): add --endpoint-protocol parameter to az acr update {ACR} Add --endpoint-protocol parameter to az acr update Mar 30, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

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


💡 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 Outdated
@yanzhudd Julie Zhu (yanzhudd) changed the title {ACR} Add --endpoint-protocol parameter to az acr update [ACR] az acr update: Add --endpoint-protocol parameter Apr 7, 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

please follow the guideline of naming the titles when submitting future PRs:
https://github.com/Azure/azure-cli/tree/dev/doc/authoring_command_modules#submitting-pull-requests

@yanzhudd

Copy link
Copy Markdown
Contributor

Please note that we are in a release process and cannot merge any PRs at the moment. We'll review it once get a chance.

BTW, the failing tests are known issue and we're fixing them.

@yanzhudd

Julie Zhu (yanzhudd) commented May 6, 2026

Copy link
Copy Markdown
Contributor

Hi Aviral Takkar (@avtakkar)
please pull the latest code from dev branch to apply the fix, and the CI issues should have been resolved.

Add support for configuring the endpoint protocol (IPv4 and/or IPv6)
on Azure Container Registries via az acr update.

Changes:
- Add --endpoint-protocol parameter with enum values IPv4, IPv4AndIPv6
- Set instance.endpoint_protocol in acr_update_custom() when provided
- Add help text example for updating endpoint protocol
- Add test_acr_with_dual_stack_endpoints scenario test

Requires azure-mgmt-containerregistry >= 15.1.0b1 with API version
2026-01-01-preview which includes the EndpointProtocol property on
the Registry model.

Validated on dogfood registry srcregistryaue (Australia East):
- az acr update --endpoint-protocol IPv4AndIPv6 → success
- az acr update --endpoint-protocol IPv4 → success

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Aviral Takkar (avtakkar) and others added 2 commits May 7, 2026 22:24
…st as live_only

- Add is_preview=True to --endpoint-protocol parameter since the
  underlying API version (2026-01-01-preview) is in preview
- Mark test_acr_with_dual_stack_endpoints as @live_only() since it
  requires live Azure credentials for registry creation

Addresses review comments from Copilot and CI test failures.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

@northtyphoon Bin Du (northtyphoon) left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

@northtyphoon Bin Du (northtyphoon) left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

@yanzhudd

Copy link
Copy Markdown
Contributor

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines successfully started running 3 pipeline(s).

@yanzhudd Julie Zhu (yanzhudd) changed the title [ACR] az acr update: Add --endpoint-protocol parameter [ACR] az acr update: Add --endpoint-protocol parameter to support specifying the endpoint protocol for the registry May 15, 2026
@yanzhudd
Julie Zhu (yanzhudd) merged commit 70fcc11 into Azure:dev May 15, 2026
50 checks passed
@microsoft-github-policy-service

Copy link
Copy Markdown
Contributor

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

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