AKS 预览版 API 生命周期

Azure Kubernetes 服务 (AKS) 预览 API(在 -preview 结束的 API)自发布日期的有效期大约为一年。 这意味着可以在 2024 年 1 月 1 日左右弃用 2023-01-02-preview API。

我们非常高兴看到人们尝试预览功能并提供反馈,因此我们鼓励大家使用预览版 API 和利用这些 API 构建的工具(如 AKS 预览版 CLI 扩展)。

API 版本弃用后,它将不再正常运行! 我们建议你定期:

  • 使用预览版 API 更新 ARM/BICEP 模板,以使用最新版本的预览版 API。
  • 将 AKS 预览版 CLI 扩展更新到最新版本。
  • 将基于预览版 API 构建的任何预览版 SDK 或其他工具更新到最新版本。

应至少每 6-9 个月执行一次这些更新。 如果不更新,系统会通知你正在使用即将弃用的 API 版本作为弃用方法。

如何检查正在使用的 API 版本

如果不确定哪个客户端或工具正在使用此 API 版本,请使用以下命令检查活动日志

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}')]"

如何更新到较新版本的 API

  • 对于 Azure SDK:通过更新到较新版本的 SDK 来使用较新的 API 版本。
  • 对于 Azure CLI:通过运行 az upgradeaz extension update --name "aks-preview" 将 CLI 本身和 aks-preview 扩展(如有)更新到最新版本。
  • 对于 Terraform:更新到最新版本的 AzureRM Terraform 模块。 若要了解特定 Terraform 版本使用的 API 版本,请查看 Terraform 发行说明或 git 日志(此文件)。
  • 对于其他工具:将该工具更新为最新版本。

即将弃用

API 版本 公布日期 弃用日期
2022-07-02-preview 2023 年 11 月 20 日 2024 年 2 月 14 日
2022-08-02-preview 2024 年 3 月 27 日 2024 年 6 月 20 日
2022-08-03-preview 2024 年 3 月 27 日 2024 年 6 月 20 日
2022-09-02-preview 2024 年 3 月 27 日 2024 年 6 月 20 日
2022-10-02-preview 2024 年 3 月 27 日 2024 年 6 月 20 日
2022-11-02-preview 2024 年 3 月 27 日 2024 年 6 月 20 日
2023-01-02-preview 2024 年 3 月 27 日 2024 年 6 月 20 日
2023-02-02-preview 2024 年 3 月 27 日 2024 年 6 月 20 日
2023-03-02-preview 2024 年 10 月 21 日 2025 年 2 月 3 日
2023-04-02-preview 2024 年 10 月 21 日 2025 年 2 月 10 日
2023-05-02-preview 2024 年 10 月 21 日 2025 年 2 月 17 日
2023-06-02-preview 2024 年 10 月 21 日 2025 年 2 月 24 日
2023-07-02-preview 2024 年 10 月 21 日 2025 年 3 月 3 日
2023-08-02-preview 2024 年 10 月 21 日 2025 年 3 月 10 日

已完成的弃用

API 版本 公布日期 弃用日期
2018-08-01-preview 2023 年 3 月 7 日 2023 年 6 月 1 日
2021-11-01-preview 2023 年 3 月 23 日 2023 年 7 月 1 日
2022-02-02-preview 2023 年 4 月 27 日 2023 年 8 月 1 日
2022-01-02-preview 2023 年 5 月 3 日 2023 年 9 月 1 日
2022-03-02-preview 2023 年 5 月 3 日 2023 年 9 月 1 日
2022-04-02-preview 2023 年 5 月 3 日 2023 年 9 月 1 日
2022-05-02-preview 2023 年 5 月 3 日 2023 年 9 月 1 日
2022-06-02-preview 2023 年 5 月 3 日 2023 年 9 月 1 日