Azure / Azure/azure-powershell
[Announcement] Key Vault: control plane API versions before 2026-02-01 retire on Feb 27, 2027 — action required
- Dominant language
- C#
- Stars
- 4.8k
- Forks
- 4.3k
- Avg merge
- 3d 14h
- Merged PRs (30d)
- 54
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 (`Get-AzKeyVaultSecret`, `Get-AzKeyVaultKey`, `Get-AzKeyVaultCertificate`, etc.) is **not impacted** — only vault management (control plane) operations are affected by this retirement.
### What you need to do
- **Upgrade the `Az.KeyVault` module to 6.6.0 or later**: `Update-Module Az -Force`. If you don't have Azure PowerShell installed yet, or need install instructions, see [Install Azure PowerShell](https://learn.microsoft.com/powershell/azure/install-azure-powershell).
- 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 `-DisableRbacAuthorization` 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
Research direction
No repository file, test, or documentation entry point is identified. Start by reviewing the migration guidance at https://aka.ms/keyvault-api-update and the Azure PowerShell/API version references in the issue; the work is complete only when a specific repository documentation target and requested change are defined.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- azure, powershell
- Domain
- cloud, documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Active
- Clarity
- Needs clarification
- Newbie friendliness
- 20/100