AKS-Vorschau-API-Lebenszyklus

Die AKS-Vorschau-APIs (Azure Kubernetes Service) (APIs, die in -previewenden) haben eine Lebensdauer von ca. einem Jahr ab dem Veröffentlichungsdatum. Dies bedeutet, dass Sie erwarten können, dass die 2023-01-02-preview-API ungefähr am 1. Januar 2024 veraltet sein wird.

Wir freuen uns, wenn Benutzer unsere Previewfunktionen ausprobieren und uns Feedback geben, daher empfehlen wir Ihnen, die Vorschau-APIs und die darauf basierenden Tools zu verwenden (z. B. die AKS Preview CLI-Erweiterung).

Sobald eine API-Version veraltet ist, funktioniert sie nicht mehr! Es wird empfohlen, routinemäßig Folgendes durchzuführen:

  • Aktualisieren Sie Ihre ARM/BICEP-Vorlagen mithilfe von Vorschau-API-Versionen, um die neueste Version der Vorschau-API zu verwenden.
  • Aktualisieren Sie Ihre AKS Preview CLI-Erweiterung auf die neueste Version.
  • Aktualisieren Sie alle Vorschau-SDKs oder andere Tools, die auf der Vorschau-API basieren, auf die neueste Version.

Sie sollten diese Updates mindestens alle 6 bis 9 Monate ausführen. Wenn Sie dies nicht tun, werden Sie benachrichtigt, dass Sie eine bald veraltete API-Version verwenden.

Überprüfen, welche API-Versionen Sie verwenden

Wenn Sie nicht sicher sind, welcher Client oder welches Tool diese API-Version verwendet, überprüfen Sie die Aktivitätsprotokolle mit dem folgenden Befehl:

Legen Sie die API-Version fest, die Sie auf die aktuelle Verwendung im Aktivitätsprotokoll überprüfen möchten. In diesem Beispiel wird nach der 2022-04-01-preview API-Version gesucht.

export API_VERSION="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')]"

Wie aktualisiert man auf eine neuere Version der API?

  • Für Azure-SDKs: Verwenden Sie eine neuere API-Version, indem Sie auf eine neuere Version des SDK aktualisieren.
  • Für die Azure CLI: Aktualisieren Sie die CLI selbst und die Erweiterung „aks-preview“ (sofern verwendet) auf die neueste Version, indem Sie az upgrade und az extension update --name "aks-preview" ausführen.
  • Für Terraform: Aktualisieren Sie auf die neueste Version des AzureRM Terraform-Moduls. Um herauszufinden, welche Version der API eine bestimmte Terraform-Version verwendet, lesen Sie die Terraform-Versionshinweise, oder rufen Sie diese Datei per git log ab.
  • Für andere Tools: Aktualisieren Sie das Tool auf die neueste Version.

Bevorstehende Einstellungen

API-Version Datum der Ankündigung Datum der Außerkraftsetzung
2023-10-02-preview 24. März 2026 1. Juli 2026
2023-11-02-preview 24. März 2026 1. Juli 2026
2024-01-02-preview 24. März 2026 1. Juli 2026
2024-02-02-preview 24. März 2026 1. Juli 2026
2024-03-02-preview 24. März 2026 1. Juli 2026
2024-04-02-preview 24. März 2026 1. Juli 2026
2024-05-02-preview 24. März 2026 1. Juli 2026
2024-06-02-preview 24. März 2026 1. Juli 2026
2024-07-02-preview 24. März 2026 1. Juli 2026
2024-08-02-preview 24. März 2026 1. Juli 2026
2024-09-02-preview 24. März 2026 1. Juli 2026