Skip to content

[Announcement] Key Vault: control plane API versions before 2026-02-01 retire on Feb 27, 2027 β€” action requiredΒ #34020

Description

@Alex-AZPS

πŸ“Œ 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.
  • 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.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Auto-AssignAuto assign by botAzure CLI TeamThe command of the issue is owned by Azure CLI teamKeyVaultaz keyvaultUpgradeaz upgradeact-identity-squadact-platform-engineering-squadcustomer-reportedIssues that are reported by GitHub users external to the Azure organization.questionThe issue doesn't require a change to the product in order to be resolved. Most issues start as that

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions