An Azure service that provides a registry of Docker and Open Container Initiative images.
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?