Значительные изменения рабочих пространств, часть 2 (март 2025 г.)

ПРИМЕНЯЕТСЯ ДЛЯ: Premium

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

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

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

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

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

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

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

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

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

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

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

Используйте тариф "Премиум" для вашего экземпляра управления API.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

• Обзор рабочих областей
• Критические изменения рабочих областей (июнь 2024 г.)

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

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