Cykl życia API wersji zapoznawczej AKS

Wdrażanie i eksplorowanie

Interfejsy API w wersji zapoznawczej usługi Azure Kubernetes Service (AKS), które kończą się na -preview, mają okres życia wynoszący około jednego roku od daty wydania. Oznacza to, że interfejs API 2023-01-02-preview będzie przestarzały gdzieś około 1 stycznia 2024 r.

Uwielbiamy, gdy ludzie wypróbują nasze funkcje w wersji zapoznawczej i przekażą nam swoją opinię, dlatego zachęcamy do korzystania z interfejsów API w wersji zapoznawczej i narzędzi utworzonych na nich (takich jak rozszerzenie interfejsu wiersza polecenia usługi AKS w wersji zapoznawczej).

Po wycofaniu wersji interfejsu API nie będzie już działać. Zalecamy regularnie:

• Zaktualizuj szablony ARM/BICEP, używając wersji zapoznawczych API, aby korzystać z najnowszej wersji API w wersji zapoznawczej.
• Zaktualizuj rozszerzenie interfejsu wiersza polecenia usługi AKS w wersji zapoznawczej do najnowszej wersji.
• Zaktualizuj wszystkie wersje SDK oraz inne narzędzia zbudowane na bazie preview API do najnowszej wersji.

Należy przeprowadzać te aktualizacje co najmniej co 6-9 miesięcy. Jeśli tego nie zrobisz, otrzymasz powiadomienie, że używasz wkrótce przestarzałej wersji interfejsu API w miarę zbliżania się terminu wycofania.

Jak sprawdzić używane wersje interfejsu API

Jeśli nie masz pewności, jaki klient lub narzędzie korzysta z tej wersji interfejsu API, sprawdź dzienniki aktywności przy użyciu następującego polecenia:

Ustaw wersję interfejsu API, którą chcesz sprawdzić pod kątem ostatniego użycia w dzienniku aktywności. W tym przykładzie sprawdzamy wersję interfejsu 2022-04-01-preview API.

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

Jak zaktualizować do nowszej wersji interfejsu API

• W przypadku zestawów SDK platformy Azure: użyj nowszej wersji interfejsu API, aktualizując zestaw SDK do nowszej wersji.
• W przypadku interfejsu wiersza polecenia platformy Azure: zaktualizuj sam interfejs wiersza polecenia i rozszerzenie aks-preview (jeśli jest używane) do najnowszej wersji, uruchamiając polecenia az upgrade i az extension update --name "aks-preview".
• Dla Terraform: Zaktualizuj do najnowszej wersji modułu AzureRM Terraform. Aby dowiedzieć się, jakiej wersji API używa dana wersja Terraform, sprawdź informacje o wydaniu Terraform lub git log dla tego pliku.
• Dla innych narzędzi: Uaktualnij narzędzie do najnowszej wersji.

Nadchodzące wycofania

wersja API	Data ogłoszenia	Data wycofania
2023-10-02-preview	24 marca 2026 r.	1 lipca 2026 r.
2023-11-02-preview	24 marca 2026 r.	1 lipca 2026 r.
2024-01-02-preview	24 marca 2026 r.	1 lipca 2026 r.
2024-02-02-preview	24 marca 2026 r.	1 lipca 2026 r.
2024-03-02-preview	24 marca 2026 r.	1 lipca 2026 r.
2024-04-02-preview	24 marca 2026 r.	1 lipca 2026 r.
2024-05-02-preview	24 marca 2026 r.	1 lipca 2026 r.
2024-06-02-preview	24 marca 2026 r.	1 lipca 2026 r.
2024-07-02-preview	24 marca 2026 r.	1 lipca 2026 r.
2024-08-02-preview	24 marca 2026 r.	1 lipca 2026 r.
2024-09-02-preview	24 marca 2026 r.	1 lipca 2026 r.