Merge pull request #276661 from matthchr/matthchr/aks-api-docs

Add document on AKS preview API life cycle.

Author: denrea

articles/aks/TOC.yml

@@ -158,6 +158,8 @@
       href: servicemesh-about.md
     - name: Sustainable software engineering
       href: concepts-sustainable-software-engineering.md
+    - name: Preview API life cycle
+      href: concepts-preview-api-life-cycle.md
     - name: Dapr
       href: dapr-overview.md
     - name: GitOps

articles/aks/concepts-preview-api-life-cycle.md

@@ -0,0 +1,53 @@
+---
+title: AKS Preview API life cycle
+description: Learn about the AKS preview API life cycle.
+ms.custom: azure-kubernetes-service
+ms.topic: article
+ms.date: 05/29/2024
+author: matthchr
+ms.author: matthchr
+
+---
+
+# 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](https://github.com/Azure/azure-cli-extensions/tree/main/src/aks-preview)).
+
+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.
+
+## 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      |
+
+## Upcoming deprecations
+
+| API version        | Announce Date     | Deprecation Date  |
+|--------------------|-------------------|-------------------|
+| 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-09-02-preview | March 27, 2024    | June 20, 2024     |
+| 2022-10-02-preview | March 27, 2024    | June 20, 2024     |
+| 2022-11-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     |
+