Share via

Migrate from Azure Container Registry 2017-03-01-(GA) API

Nischay 125 Reputation points
2026-03-24T00:23:50.3766667+00:00

Got this notification from Azure:-

Screenshot 2026-03-24 at 1.21.23 PM

However, we don't see any Azure Container Registry in our account:-
Screenshot 2026-03-24 at 1.23.02 PM

Please help.

Azure Container Registry
Azure Container Registry

An Azure service that provides a registry of Docker and Open Container Initiative images.

0 comments No comments

Answer accepted by question author

Siva shunmugam Nadessin 10,820 Reputation points Microsoft External Staff Moderator
2026-03-24T01:44:16.05+00:00

Hello Nischay,

Thank you for reaching out to the Microsoft Q&A forum.

What this email is saying (in simple terms)

  • Microsoft is retiring an old Azure Container Registry (ACR) API version: 2017-03-01 (GA)
  • End of support date: September 2026
  • After that date, anything using this old API will stop working.

You received this email because something in your environment is still calling this old API.

You have time until September 2026, but Microsoft recommends fixing it early.

Kindly follow below actions to resolve.

1. Move to a newer ACR API version

Microsoft is asking you to update to a supported API version of Azure Container Registry.

This usually means you don’t update ACR itself, but:

  • Update SDKs
  • Update CLI / PowerShell
  • Update IaC templates (ARM/Bicep/Terraform)
  • Update applications or pipelines that talk to ACR

2. Check where the old API is being used

Common places this comes from:

  • Old Azure SDKs (Java, .NET, Python, Node)
  • Old Azure CLI versions

·         ARM templates with:·        

 "apiVersion": "2017-03-01"
  • Third-party tools integrated with ACR
  • ·Legacy CI/CD pipelines
  • What usually fixes it, In most cases, just updating tooling is enough:
Update Azure CLI

Update Azure PowerShell:

Update-Module Az
  • Update SDKs to latest versions.
  • Replace old ARM API versions with newer ones (example):
"apiVersion": "2023-01-01-preview"

After updates, New deployments should no longer trigger this email, existing workloads continue normally &       ACR continues working without disruption.

Let us know if you have further questions?

Was this answer helpful?


0 additional answers

Sort by: Most helpful

Your answer

Answers can be marked as 'Accepted' by the question author and 'Recommended' by moderators, which helps users know the answer solved the author's problem.