[Announcement] Key Vault: control plane API versions before 2026-02-01 retire on Feb 27, 2027 — action required
- Dominant language
- Python
- Stars
- 4.6k
- Forks
- 3.5k
- Avg merge
- 3d 2h
- Merged PRs (30d)
- 60
Description
## 📌 Action Required: Azure Key Vault control plane API versions before `2026-02-01` retire on **February 27, 2027**
Azure Key Vault is retiring all control plane (management) API versions released **before `2026-02-01`**, effective **February 27, 2027**. Starting on that date, Key Vault **management** requests (create/update/delete vault, network rules, access-control changes, etc.) made with an older control plane API version will no longer be served.
> **This does not affect the data plane.** Reading/writing secrets, keys, and certificates (`az keyvault secret/key/certificate ...`) is **not impacted** — only vault management (control plane) operations are affected by this retirement.
### What you need to do
- **Upgrade Azure CLI to 2.90.0 or later**: `az upgrade`. If you don't have Azure CLI installed yet, or need install instructions, see [Install Azure CLI](https://learn.microsoft.com/en-us/cli/azure/install-azure-cli?view=azure-cli-latest).
- If you call the Key Vault management REST API directly, or use ARM/Bicep/Terraform templates, update to `api-version=2026-02-01` or later
### Also starting with API version `2026-02-01`
Azure RBAC becomes the **default** access-control model for **newly created** key vaults using this API version (`enableRbacAuthorization = true` by default). This does **not** change any existing vault's access-control model — only the default for new-vault creation. Access policies remain fully supported; pass `--disable-rbac-authorization` at creation time if you want a new vault to keep using access policies.
### Reference
Full details, migration guidance, and FAQ: **https://aka.ms/keyvault-api-update**
---
*This issue is pinned for visibility. Please reach out in this thread or open a new issue if you have questions about upgrading.*
Contributor guide
Assessment
This issue has not been assessed yet.