Azure Kubernetes Fleet Manager 預覽版 Azure Resource Manager（ARM）REST API（以 -preview 結尾的 API）從其發行日期起計算，壽命約為一年。 這表示您可以預期 2024-05-02-preview API 會在 2025 年 5 月 3 日左右被棄用。
我們很喜歡當人們嘗試預覽功能並提供意見反應，因此我們鼓勵您使用預覽 API 和建置在這些功能上的工具。
API 版本已被取代之後，它將無法再運作。 我們建議您定期：
- 使用預覽 API 版本更新 ARM/Bicep/Terraform 範本，以使用最新相容的 API 版本。
- 將預覽 API 上建置的任何預覽 SDK 或其他工具更新為最新版本。
您應該至少每 6-9 個月執行這些更新。 如果您無法這樣做，系統將通知您正在使用即將棄用的 API 版本作為棄用方法。
本文介紹 Azure Kubernetes 機群管理員 API 的棄用。 如需了解 Azure Kubernetes Service (AKS) API 的淘汰規劃，請參閱 AKS 預覽 API 生命週期。
即將進行的 API 棄用
| API 版本 | 公告日期 | 淘汰日期 |
|---|---|---|
| 2024-05-02-預覽版本 | 待定 | 待定 |
| 2024-02-02-預覽 | 待定 | 待定 |
已完成的 API 棄用
| API 版本 | 公告日期 | 淘汰日期 |
|---|---|---|
| 2023年8月15日預覽 | 2024 年 12 月 16 日 | 2025 年 4 月 14 日 |
| 2023-06-15-預覽 | 2024 年 12 月 16 日 | 2025 年 4 月 14 日 |
| 2023-03-15-預覽 | 2024 年 12 月 16 日 | 2025 年 4 月 14 日 |
| 2022-09-02-preview | 2024 年 12 月 16 日 | 2025 年 4 月 14 日 |
| 2022-07-02-預覽 | 2024 年 12 月 16 日 | 2025 年 4 月 14 日 |
| 2022-06-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' = {
...
}
如何更新工具和 SDK
這很重要
Azure CLI 和擴充功能必須使用fleet 和az upgrade更新為最新版本。
- 針對 Azure SDK：藉由更新為 較新版本的 SDK，使用較新的 API 版本。
- Terraform 使用者請更新至最新版本的 AzureRM Terraform 模組。 若要瞭解特定 Terraform 版本所使用的 API 版本為何，請檢查 Terraform 版本資訊 或 git 記錄 此檔案。
- 若為其他工具：將工具更新為最新版本。
