次の方法で共有

AKS プレビュー API のライフ サイクル

Azure Kubernetes Service (AKS) プレビュー API (-preview で終わる API) の有効期間は、リリース日から約 1 年です。 つまり、2024 年 1 月 1 日頃に 2023-01-02-preview API が非推奨になることが予想されます。

プレビュー機能を試された皆さまからのフィードバックをお待ちしています。したがって、プレビュー API とその上に構築されたツール (AKS プレビュー CLI 拡張機能など) を使用することをお勧めします。

API バージョンは非推奨になると、機能しなくなります。 定期的に次のことを行うことをお勧めします。

  • 最新バージョンのプレビュー API を使用するために、プレビュー API バージョンを使って ARM/BICEP テンプレートを更新する。
  • 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 upgrade と az extension update --name "aks-preview" を実行して、CLI 自体と aks-preview 拡張機能 (使用している場合) を最新バージョンに更新します。
  • Terraform の場合: AzureRM Terraform モジュールの最新バージョンに更新します。 特定の Terraform リリースで使用されている API のバージョンを確認するには、Terraform リリース ノートを確認するか、このファイルに対して git log を実行します。
  • その他のツールの場合: ツールを最新バージョンに更新します。

今後非推奨となるもの

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 日