AKS Preview API life cycle

The Azure Kubernetes Service (AKS) preview APIs (APIs that end in -preview) have a lifespan of ~one year from their release date. This means that you can expect the 2023-01-02-preview API to be deprecated somewhere around January 1st, 2024.

We love when people try our preview features and give us feedback, so we encourage you to use the preview APIs and the tools built on them (such as the AKS Preview CLI Extension).

After an API version is deprecated, it will no longer function! We recommend you routinely:

  • Update your ARM/BICEP templates using preview API versions to use the latest version of the preview API.
  • Update your AKS preview CLI extension to the latest version.
  • Update any preview SDKs or other tools built on the preview API to the latest version.

You should perform these updates at a minimum every 6-9 months. If you fail to do so, you will be notified that you are using a soon-to-be deprecated API version as deprecation approaches.

How to check what API versions you're using

If you're unsure what client or tool is using this API version, check the activity logs using the following command:

Bash
API_VERSION=<impacted API version, such as 2022-04-01-preview>
az monitor activity-log list --offset 30d --max-events 10000 --namespace microsoft.containerservice --query "[?eventName.value == 'EndRequest' && contains(not_null(httpRequest.uri,''), '${API_VERSION}')]"

How to update to a newer version of the API

  • For Azure SDKs: use a newer API version by updating to a newer version of the SDK.
  • For Azure CLI: Update the CLI itself and the aks-preview extension (if used) to the latest version by running az upgrade and az extension update --name "aks-preview".
  • For Terraform: Update to the latest version of the AzureRM Terraform module. To find out what version of the API a particular Terraform release is using, check the Terraform release notes or git log this file.
  • For other tools: Update the tool to the latest version.

Upcoming deprecations

API version Announce Date Deprecation Date
2022-09-02-preview March 27, 2024 June 20, 2024
2022-10-02-preview March 27, 2024 June 20, 2024
2023-01-02-preview March 27, 2024 June 20, 2024
2023-02-02-preview March 27, 2024 June 20, 2024
2023-03-02-preview Oct 21, 2024 February 3, 2025
2023-04-02-preview Oct 21, 2024 February 10, 2025
2023-05-02-preview Oct 21, 2024 February 17, 2025
2023-06-02-preview Oct 21, 2024 February 24, 2025
2023-07-02-preview Oct 21, 2024 March 3, 2025
2023-08-02-preview Oct 21, 2024 March 10, 2025

Completed deprecations

API version Announce Date Deprecation Date
2018-08-01-preview March 7, 2023 June 1, 2023
2021-11-01-preview March 23, 2023 July 1, 2023
2022-02-02-preview April 27, 2023 August 1, 2023
2022-01-02-preview May 3, 2023 Sept 1, 2023
2022-03-02-preview May 3, 2023 Sept 1, 2023
2022-04-02-preview May 3, 2023 Sept 1, 2023
2022-05-02-preview May 3, 2023 Sept 1, 2023
2022-06-02-preview May 3, 2023 Sept 1, 2023
2022-07-02-preview November 20, 2023 February 14, 2024
2022-08-02-preview March 27, 2024 June 20, 2024
2022-08-03-preview March 27, 2024 June 20, 2024
2022-11-02-preview March 27, 2024 June 20, 2024