你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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

2025-04-23

Azure Kubernetes Fleet Manager 预览版的 Azure 资源管理器（ARM）REST API（以 -preview 结尾的 API）的有效期从其发布日期起约为一年。这意味着可以在 2025 年 5 月 3 日左右弃用 2024-05-02 预览版 API。

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

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

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

应至少每 6-9 个月执行一次这些更新。如果无法执行此操作，则会在弃用临近时收到通知，提示你使用的是即将弃用的 API 版本。

本文介绍 Azure Kubernetes 舰队管理器 API 弃用情况。有关 Azure Kubernetes 服务（AKS）API 弃用的信息，请参阅 AKS 预览 API 生命周期。

即将推出的 API 弃用

API 版本	公布日期	弃用日期
2024-05-02-preview	2025 年 6 月	2025 年 9 月
2024-02-02-preview	2025 年 6 月	2025 年 9 月

已完成的 API 弃用

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

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

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

API_VERSION="2024-05-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 模板中，查看显示在资源类型末尾的资源版本 (@2024-05-02-preview)。

resource symbolicname 'Microsoft.ContainerService/fleets@2024-05-02-preview' = {
    ...
}

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

{
  "type": "Microsoft.ContainerService/fleets",
  "apiVersion": "2024-05-02-preview",
  ...
}

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/fleets@2024-05-02-preview"
  ...
}

如何更新到较新的 API 版本

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

通过