Критические изменения рабочих областей, часть 2 (март 2025 г.)

ОБЛАСТЬ ПРИМЕНЕНИЯ: Premium

Внимание

Эти критические изменения применяются только к рабочим областям предварительной версии в Azure Управление API. Если вы создали рабочие области после общедоступного выпуска в августе 2024 г. и используете рабочие области с шлюзами рабочих областей, ваши рабочие области не должны влиять на эти изменения.

Рабочие области Azure Управление API теперь общедоступны, и мы представили несколько обновлений компонентов с этим выпуском. В рамках продолжающейся разработки рабочих областей мы удаляем поддержку рабочих областей предварительной версии (создано до августа 2024 г.). Если вы создали рабочие области предварительной версии в Azure Управление API и хотите продолжить их использование, необходимо перенести рабочие области в общедоступную версию.

После 31 марта 2025 г. рабочие области предварительной версии и API, управляемые в них, могут перестать работать, если вы не перешли на последние возможности рабочей области. API и ресурсы, управляемые за пределами рабочих областей, не влияют на это изменение.

Влияет ли моя служба на эти изменения?

Служба может повлиять на эти изменения, если вы создали рабочие области предварительной версии в Управление API экземпляре, прежде чем общедоступный выпуск рабочих областей в августе 2024 года. Рабочие области, созданные после общедоступной даты выпуска, которая использует шлюзы рабочих областей для среды выполнения API, не влияют на критические изменения.

Критические изменения

Ниже приведены критические изменения, требующие принятия мер для переноса рабочих областей предварительной версии в общедоступную версию:

  • Требуется шлюз API рабочей области. Каждая рабочая область должна быть связана с шлюзом API рабочей области, который изолирует трафик среды выполнения рабочей области. В предварительной версии рабочие области совместно используют шлюз со службой.
  • Управляемые удостоверения на уровне обслуживания не поддерживаются . Чтобы повысить безопасность рабочих областей, назначаемые системой и назначаемые пользователем управляемые удостоверения на уровне обслуживания не могут использоваться в рабочих областях. В настоящее время связанные Управление API функции, зависящие от управляемых удостоверений, таких как хранение именованных значений и сертификатов в Azure Key Vault и использование authentication-managed-identity политики, не поддерживаются в рабочих областях.

Примечание.

Эти критические изменения в дополнение к критическим изменениям в июне 2024 года для рабочих областей предварительной версии, которые были объявлены ранее.

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

Критические изменения будут применяться в рабочих областях предварительной версии после 31 марта 2025 г. Настоятельно рекомендуется внести все необходимые изменения в конфигурацию рабочих областей предварительной версии до этой даты.

Что нужно сделать?

Если ваши рабочие области затронуты этими изменениями, необходимо перенести рабочие области, чтобы выровняться с общедоступными возможностями. В следующих разделах содержатся рекомендации по переносу рабочих областей.

Использование уровня "Премиум" для экземпляра Управление API

Убедитесь, что экземпляр Управление API запущен на уровне "Премиум", чтобы продолжить использование рабочих областей. Как было объявлено ранее, если экземпляр находится на уровне "Стандартный " или "Разработчик" , необходимо перейти на уровень "Премиум ".

Подтверждение региона для экземпляра

Добавление шлюза рабочей области в рабочую область требует, чтобы шлюз был в том же регионе, что и экземпляр. В настоящее время шлюзы рабочих областей поддерживаются в подмножестве регионов, в которых Управление API доступны. Регионы с поддержкой шлюзов рабочих областей будут обновляться со временем.

Чтобы определить, находится ли рабочая область предварительной версии в поддерживаемом регионе:

  1. Перейдите к экземпляру Управления API на портале Azure.
  2. В меню слева в разделе API выберите рабочие области и выберите рабочую область.
  3. Если рабочая область находится в регионе, который не поддерживает шлюзы рабочих областей, вы увидите сообщение на портале, аналогичное "Рабочие области в настоящее время недоступны в регионе службы Управление API".
    • Если вы видите это сообщение, вы можете переместить экземпляр Управление API в поддерживаемый регион.
    • Если вы не видите это сообщение, рабочая область находится в поддерживаемом регионе, и вы можете перейти к добавлению шлюза рабочей области.

Добавление шлюза рабочей области в рабочую область

Ниже приведены сокращенные шаги по добавлению шлюза рабочей области в рабочую область. Параметры сети шлюза, предварительные требования и подробные инструкции см. в статье "Создание рабочей области" и управление ими.

Примечание.

  • Шлюз рабочей области взимает дополнительные расходы. Дополнительные сведения см. в статье о ценах службы "Управление API".
  • Управление API в настоящее время поддерживает только выделенный шлюз для каждой рабочей области. Если это влияет на планы миграции, ознакомьтесь с схемой развития рабочих областей в объявлении общедоступной версии рабочих областей.
  1. Перейдите к экземпляру Управления API на портале Azure.
  2. В меню слева в разделе API выберите рабочие области.
  3. Выберите рабочую область.
  4. В меню слева в разделе "Развертывание и инфраструктура" выберите "Шлюзы>+ Добавить".
  5. Завершите работу мастера, чтобы создать шлюз. В настоящее время подготовка шлюза может занять от нескольких минут до 3 часов или более.
  6. После подготовки шлюза перейдите на страницу обзора шлюза. Обратите внимание на значение имени узла среды выполнения. Используйте это значение для обновления клиентских приложений, которые вызывают API рабочей области.
  7. Повторите предыдущие шаги для оставшихся рабочих областей.

Обновление клиентских приложений для использования нового имени узла шлюза

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

Примечание.

Чтобы помочь перенести рабочие области, API-интерфейсы в рабочих областях по-прежнему могут быть доступны во время выполнения до октября 2024 года с использованием имени узла шлюза экземпляра Управление API, даже если шлюз рабочей области связан с рабочей областью. Настоятельно рекомендуется завершить миграцию до этой даты. Если шлюзы рабочей области настроены с частным входящего доступа и частным исходящим доступом, убедитесь, что подключение к встроенному шлюзу Управление API экземпляра также безопасно.

Обновление зависимостей от управляемых удостоверений на уровне обслуживания

Если вы используете управляемые удостоверения уровня обслуживания в конфигурации сущностей рабочей области (например, именованные значения или сертификаты), необходимо обновить конфигурации. Рекомендуемые шаги зависят от сущности. Пример. Обновите именованные значения, чтобы использовать значения секретов вместо секретов, хранящихся в Azure Key Vault.

Справка и поддержка

Если у вас есть вопросы, вы сможете получить ответы от экспертов сообщества в Microsoft Q&A. Если у вас есть план поддержки и вам нужна техническая помощь, создайте запрос на поддержку:

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

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