Поделиться через


Жизненный цикл API предварительной версии AKS

Предварительные версии API Службы Azure Kubernetes (AKS) (API, которые заканчиваются-preview) действуют около одного года с момента их выпуска. Это означает, что вы можете ожидать, что API 2023-01-02-preview будет устаревшим где-то около 1 января 2024 года.

Мы ценим, когда пользователи тестируют наши функции предварительной версии и дают нам обратную связь, поэтому мы рекомендуем вам использовать API предварительной версии и инструменты, разработанные на их основе (например, расширение предварительной версии AKS CLI).

После устаревания версии API она больше не будет функционировать! Мы рекомендуем вам регулярно:

  • Обновите шаблоны ARM/BICEP с помощью версий API предварительной версии, чтобы использовать последнюю версию API предварительной версии.
  • Обновите расширение CLI предварительной версии AKS до последней версии.
  • Обновите все предварительные пакеты SDK или другие средства, созданные на основе API предварительной версии, до последней версии.

Эти обновления следует выполнять как минимум каждые 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

  • Для пакетов SDK Azure используйте более новую версию API, обновив её до более новой версии пакета SDK.
  • Для Azure CLI: обновите сам интерфейс командной строки и расширение aks-preview (если используется) до последней версии, выполнив az upgrade и az extension update --name "aks-preview".
  • Для Terraform: обновите последнюю версию модуля Terraform AzureRM. Чтобы узнать, какая версия API использует конкретный выпуск Terraform, проверьте заметки о выпуске Terraform или журнал git в этом файле.
  • Для других средств: обновите средство до последней версии.

Предстоящие устаревания

Версия API Дата объявления Дата устаревания
2022-09-02-preview 27 марта 2024 г. 20 июня 2024 г.
2022-10-02-preview 27 марта 2024 г. 20 июня 2024 г.
02.01.2023-предварительный просмотр 27 марта 2024 г. 20 июня 2024 г.
2023-02-02-предварительная версия 27 марта 2024 г. 20 июня 2024 г.
2023-03-02-preview 21 октября 2024 г. 3 февраля 2025 г.
2023-04-02-предварительный просмотр 21 октября 2024 г. 10 февраля 2025 г.
2023-05-02-preview 21 октября 2024 г. 17 февраля 2025 г.
2023-06-02-preview 21 октября 2024 г. 24 февраля 2025 г.
2023-07-02-предварительный просмотр 21 октября 2024 г. 3 марта 2025 г.
2023-08-02-предварительный просмотр 21 октября 2024 г. 10 марта 2025 г.

Завершённые устаревания

Версия API Дата объявления Дата устаревания
2018-08-01-preview 7 марта 2023 г. 1 июня 2023 г.
2021-11-01-preview 23 марта 2023 г. 1 июля 2023 г.
2022-02-02-предварительный просмотр 27 апреля 2023 г. 1 августа 2023 г.
2022-01-02-предварительный просмотр 3 мая 2023 г. 1 сентября 2023 г.
2022-03-02-preview 3 мая 2023 г. 1 сентября 2023 г.
2022-04-02-preview 3 мая 2023 г. 1 сентября 2023 г.
2022-05-02-preview 3 мая 2023 г. 1 сентября 2023 г.
2022-06-02-превью 3 мая 2023 г. 1 сентября 2023 г.
2022-07-02-предварительный просмотр 20 ноября 2023 г. 14 февраля 2024 г.
2022-08-02-preview 27 марта 2024 г. 20 июня 2024 г.
2022-08-03-preview 27 марта 2024 г. 20 июня 2024 г.
2022-11-02-preview 27 марта 2024 г. 20 июня 2024 г.