Skip to content

Commit 73feee1

Browse files
msmbaldwinCopilot
andcommitted
Add supported AKV control plane API versions list
Add supported control plane API versions section to whats-new.md with stable and preview versions (excluding retired 2026-03-01-preview), linked to azure-rest-api-specs. Cross-link from access-control-default.md. Co-authored-by: Copilot <[email protected]>
1 parent 8ee1ef2 commit 73feee1

2 files changed

Lines changed: 31 additions & 1 deletion

File tree

articles/key-vault/general/access-control-default.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Azure Key Vault API version 2026-02-01 and later change the default access contr
2323
> [!IMPORTANT]
2424
> All Key Vault Control Plane API versions before 2026-02-01 retire on February 27, 2027. Data Plane APIs are not affected.
2525
26-
Preview API versions (except 2026-04-01-preview) are being deprecated with a 90-day notice period. Azure Cloud Shell always uses the latest API version. If you have scripts that run in Cloud Shell, ensure they're compatible with API version 2026-02-01 or later. For SDK package details, see [What's new for Azure Key Vault](whats-new.md#control-plane-sdk-releases).
26+
Preview API versions (except 2026-04-01-preview) are being deprecated with a 90-day notice period. Azure Cloud Shell always uses the latest API version. If you have scripts that run in Cloud Shell, ensure they're compatible with API version 2026-02-01 or later. For a list of supported API versions, see [Supported control plane API versions](whats-new.md#supported-control-plane-api-versions). For SDK package details, see [What's new for Azure Key Vault](whats-new.md#control-plane-sdk-releases).
2727

2828
We encourage you to migrate key vaults that currently use access policies (legacy) to Azure RBAC for improved security. For more information on why Azure RBAC is recommended, see [Azure role-based access control (Azure RBAC) vs. access policies](rbac-access-policy.md).
2929

articles/key-vault/general/whats-new.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,36 @@ New Azure Key Vault control plane API versions (2026-02-01 and 2026-03-01-previe
2727

2828
Azure Key Vault is deprecating older preview control plane API versions in accordance with Azure guidelines. All preview API versions except 2026-04-01-preview will be deprecated with a 90-day notice period. Customers using preview API versions should plan to migrate to the latest stable API version (2026-02-01) or the upcoming 2026-04-01-preview version.
2929

30+
### Supported control plane API versions
31+
32+
The following Azure Key Vault control plane API versions are currently supported.
33+
34+
#### Stable
35+
36+
- [2026-02-01](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/stable/2026-02-01) (recommended)
37+
- [2025-05-01](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/stable/2025-05-01)
38+
- [2024-11-01](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/stable/2024-11-01)
39+
- [2023-07-01](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/stable/2023-07-01)
40+
- [2023-02-01](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/stable/2023-02-01)
41+
- [2022-11-01](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/stable/2022-11-01)
42+
- [2022-07-01](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/stable/2022-07-01)
43+
- [2021-10-01](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/stable/2021-10-01)
44+
- [2019-09-01](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/stable/2019-09-01)
45+
- [2018-02-14](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/stable/2018-02-14)
46+
- [2016-10-01](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/stable/2016-10-01)
47+
- [2015-06-01](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/stable/2015-06-01)
48+
49+
#### Preview
50+
51+
- [2024-12-01-preview](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/preview/2024-12-01-preview) (recommended)
52+
- [2024-04-01-preview](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/preview/2024-04-01-preview)
53+
- [2022-02-01-preview](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/preview/2022-02-01-preview)
54+
- [2021-11-01-preview](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/preview/2021-11-01-preview)
55+
- [2021-06-01-preview](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/preview/2021-06-01-preview)
56+
- [2021-04-01-preview](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/preview/2021-04-01-preview)
57+
- [2020-04-01-preview](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/preview/2020-04-01-preview)
58+
- [2018-02-14-preview](https://github.com/Azure/azure-rest-api-specs/tree/main/specification/keyvault/resource-manager/Microsoft.KeyVault/KeyVault/preview/2018-02-14-preview)
59+
3060
### Control plane SDK releases
3161

3262
All five Azure Key Vault control plane management SDKs supporting API version 2026-02-01 are now released. Control plane management SDKs that use older API versions will stop working when those API versions retire on February 27, 2027. Upgrade to the following SDK versions or later:

0 commit comments

Comments
 (0)