Azure Kubernetes 舰队管理器（预览版）API 生命周期

项目
2025/01/14

Azure Kubernetes 舰队管理器（Kubernetes 舰队）预览版 REST API（在 -preview 结束的 API）自发布日期的有效期大约为一年。这意味着可以在 2024 年 1 月 1 日左右弃用 2023-01-02-preview API。

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

API 版本弃用后，它将不再正常运行。我们建议你定期：

使用预览版 API 更新 ARM/Bicep/Terraform 模板，以使用最新兼容版本的 API。
将基于预览版 API 构建的任何预览版 SDK 或其他工具更新到最新版本。

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

本文介绍 Kubernetes 舰队 API 弃用。请参阅 AKS 预览 API 生命周期页，了解 Azure Kubernetes 服务 (AKS) API 弃用。

即将到来的 API 弃用

API 版本	公布日期	弃用日期
2023-08-15-preview	2024 年 12 月 16 日	2025 年 4 月 1 4日
2023-06-15-preview	2024 年 12 月 16 日	2025 年 4 月 1 4日
2023-03-15-preview	2024 年 12 月 16 日	2025 年 4 月 1 4日
2022-09-02-preview	2024 年 12 月 16 日	2025 年 4 月 1 4日
2022-07-02-preview	2024 年 12 月 16 日	2025 年 4 月 1 4日

已完成的 API 弃用

目前没有 Kubernetes 舰队 REST API 弃用。

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

如果不确定哪个客户端或工具正在使用特定 API 版本，请使用以下命令检查活动日志。使用要检查的版本更新 API_VERSION。


API_VERSION="2023-08-02-preview"
az monitor activity-log list \
    --offset 30d \
    --max-events 10000 \
    --namespace microsoft.containerservice.fleets \
    --query "[?eventName.value == 'EndRequest' && contains(not_null(httpRequest.uri,''), '${API_VERSION}')]"

如何检查模板中使用的 API 版本

在 Bicep 模板中，查看显示在资源类型末尾的资源版本 (@2023-08-15-preview)。

resource symbolicname 'Microsoft.ContainerService/fleets@2023-08-15-preview' = {
    ...
}

在 ARM 模板中，检查 apiVersion 属性。

{
  "type": "Microsoft.ContainerService/fleets",
  "apiVersion": "2023-08-15-preview",
  ...
}

在 Terraform 中，检查定义资源类型和 API 版本 (@2023-08-15-preview) 的 type 属性的值。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/fleets@2023-08-15-preview"
  ...
}

如何更新到较新的 API 版本

对于 Azure SDK：通过更新到较新版本的 SDK 来使用较新的 API 版本。
对于 Azure CLI：通过运行 az upgrade 和 az extension update --name fleet 将 CLI 本身和舰队扩展更新到最新版本。
对于 Terraform：更新到最新版本的 AzureRM Terraform 模块。若要了解特定 Terraform 版本使用的 API 版本，请查看 Terraform 发行说明或 git 日志（此文件）。
对于其他工具：将该工具更新为最新版本。

通过