Прекращение использования версий API (июнь 2024 г.)

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: Потребление | Разработчик | Базовый | Стандартный | Премиум

Управление API Azure использует Azure Resource Manager (ARM) для настройки экземпляров Управления API. Версия API встроена в использование шаблонов, которые описывают вашу инфраструктуру, средства, которые вы используете для настройки службы, и программы, которые вы пишете для управления службами Управления Azure API.

Начиная с 1 июня 2024 г. все версии API для службы Azure Управление API до 2021-08-01 удаляются (отключены). Ранее сообщаемая дата выхода на пенсию была 30 сентября 2023 года. В любое время после 1 июня 2024 г. вызовы API с использованием версии API до 2021-08-01 могут завершиться ошибкой без дальнейшего уведомления. Вы больше не сможете создавать или управлять службами Управление API с существующими шаблонами, инструментами, скриптами и программами с использованием устаревшей версии API до тех пор, пока они не будут обновлены для использования API версии 2021-08-01 или более поздней. Операции плоскости данных (например, запросы API мультимедиа в шлюзе) не будут затронуты этим обновлением, в том числе после 1 июня 2024 года.

Повлияет ли это на мою службу?

Хотя служба не влияет на это изменение, любое средство, скрипт или программа, использующая Azure Resource Manager (например, Azure CLI, Azure PowerShell, Набор ресурсов Azure Управление API DevOps или Terraform) для взаимодействия со службой Управление API и вызывает версию API Управление API до 2021-08-01, влияет на это изменение. После выхода версии API вы не сможете успешно запустить какие-либо затронутые инструменты, если не обновите средства.

Каков крайний срок внесения изменения?

Затронутые версии API будут постепенно прекращены с 1 июня 2024 года.

После прекращения работы версии API, если вы предпочитаете не обновлять затронутые инструменты, скрипты и программы, службы будут продолжать работать. Однако вы не сможете добавлять или удалять API, изменять политику API или настраивать службу Управление API с затронутыми инструментами.

Необходимые действия

Обновите средства, скрипты и программы, используя подробные сведения в следующем разделе.

Мы также рекомендуем задать минимальную версию API в вашем экземпляре Управление API.

Обновление средств, скриптов и программ

  • Шаблоны ARM, Bicep или Terraform — обновите шаблон для использования API версии 2021-08-01 или выше.

  • Azure CLI — выполните az version, чтобы проверить вашу версию. Если вы используете версию 2.42.0 или более позднюю, действие не требуется. При необходимости выполните команду az upgrade для обновления Azure CLI. Дополнительные сведения см. в статье Как обновить Azure CLI.

  • Azure PowerShell — выполните Get-Module -ListAvailable -Name Az, чтобы проверить вашу версию. Если вы используете версию 8.1.0 или выше, никаких действий не требуется. При необходимости выполните команду Update-Module -Name Az -Repository PSGallery, чтобы обновить модуль. Дополнительные сведения см. в статье Установка модуля Azure Az PowerShell.

  • Другие средства — используйте следующие версии (или более поздние версии):

    • Набор ресурсов DevOps Управления API: 1.0.0
    • Поставщик Terraform AzureRM: 3.0.0

  • Пакеты SDK Azure— обновите пакеты SDK для Azure Управление API до последних версий или по крайней мере следующих версий:

    • .NET: 8.0.0
    • Go: 1.0.0
    • Python: 3.0.0
    • JavaScript: 8.0.1
    • Java: 1.0.0-beta3

Обновление параметра минимальной версии API в экземпляре Управление API

Рекомендуется задать минимальную версию API для экземпляра Управление API с помощью портал Azure. Этот параметр ограничивает вызовы API уровня управления к экземпляру версии API, равной или более новой, чем это значение. Задав это значение в значение 2021-08-01, вы можете оценить влияние выхода версии API на средства.

Чтобы задать минимальную версию API на портале, выполните следующие действия.

  1. Перейдите к экземпляру Управления API на портале Azure.
  2. В меню слева в разделе "Развертывание и инфраструктура" выберите API управления.
  3. Перейдите на вкладку параметров API управления.
  4. В разделе "Принудительное применение минимальной версии API" выберите "Да". Появится минимальная версия API.
  5. Выберите Сохранить.

Дополнительные сведения

Связанный контент

Просмотрите все предстоящие критические изменения и события прекращения поддержки функций.