Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
ОБЛАСТЬ ПРИМЕНЕНИЯ: Базовая версия 2 | Standard v2 | Премиум версии 2
Уровни Управление API версии 2 (SKU) основаны на новой, более надежной и масштабируемой платформе и предназначены для того, чтобы сделать Управление API доступными для более широкого набора клиентов и предлагать гибкие варианты для более широкого спектра сценариев. Уровни версии 2 в дополнение к существующим классическим уровням (разработчик, базовый, стандартный и премиум) и уровню потребления. См. подробное сравнение уровней управления API.
Как правило, доступны следующие уровни версии 2.
Базовая версия 2. Уровень "Базовый" версии 2 предназначен для сценариев разработки и тестирования и поддерживается с соглашением об уровне обслуживания.
Стандарт v2 — это уровень, готовый к производственному использованию, с поддержкой серверных служб с сетевой изоляцией.
Следующий уровень версии 2 находится в предварительной версии:
- Premium v2 предлагает корпоративные функции, включая полную изоляцию виртуальной сети, масштабирование для рабочих нагрузок с большим объемом и рабочие пространства.
Ключевые возможности
Быстрое развертывание, настройка и масштабирование. Развертывание готового к работе экземпляра Управление API в минутах. Быстрое применение конфигураций, таких как обновления сертификатов и имен узлов. Быстро масштабируйте экземпляр уровня "Базовый" версии 2 или "Стандартный" до 10 единиц, чтобы удовлетворить потребности рабочих нагрузок управления API. Масштабируйте экземпляр Premium версии 2 до 30 единиц.
Упрощенное сетевое взаимодействие - Уровни "Стандартный" версии 2 и "Премиум" версии 2 предоставляют сетевые опции для изоляции входящего и исходящего трафика системы управления API.
Больше вариантов для производственных нагрузок - Уровни v2 поддерживаются с гарантиями уровня обслуживания.
Параметры портала разработчика - Включите портал разработчика, когда вы будете готовы разрешить потребителям API обнаруживать ваши API.
Features
Версия API
Последние возможности уровней v2 поддерживаются в API Management версии API 2024-05-01 или более поздней.
Сетевые параметры
Стандартная версия 2 и Premium версия 2 поддерживают интеграцию виртуальной сети, чтобы обеспечить доступ экземпляра управления API к серверам API, изолированным в одной подключенной виртуальной сети. Шлюз управления API, управляющая плоскость и портал разработчика остаются общедоступными в Интернете. Виртуальная сеть должна находиться в том же регионе и подписке, что и Управление API. Подробнее.
Стандартная версия 2 также поддерживает входящие подключения частной конечной точки к шлюзу управления API.
Премиум версии 2 также поддерживает упрощенное внедрение виртуальной сети для полной изоляции входящего и исходящего трафика шлюза без необходимости правил группы безопасности сети, таблиц маршрутов или конечных точек службы. Виртуальная сеть должна находиться в том же регионе и подписке, что и Управление API. Подробнее.
Поддерживаемые регионы
Текущий список регионов, где доступны уровни версии 2, см. в разделе "Доступность уровней версии 2" и шлюзов рабочих областей.
Доступность классических функций
Большинство возможностей классических уровней Управление API поддерживаются на уровнях версии 2. Однако следующие возможности не поддерживаются на уровнях версии 2:
- Настройка службы "Управление API" с помощью Git
- Резервное копирование и восстановление экземпляра управления API
- Включение защиты от атак DDoS Azure
- Доступ к API прямого управления
Limitations
Следующие возможности управления API в настоящее время недоступны на уровнях второй версии.
Инфраструктура и сеть
- Развертывание в нескольких регионах
- Поддержка зоны доступности
- Несколько личных доменных имен
- Метрика емкости, замененная процентом ЦП шлюза и процентом памяти метрик шлюза
- Встроенная аналитика— заменена панелью мониторинга на основе Azure Monitor
- Обновление до уровней версии 2 с классических уровней
- Сертификаты ЦС
- Отправка событий в сетку событий
- Метрики событий Event Hubs
Портал разработчика
- Reports
- Настраиваемый виджет HTML-кода и настраиваемый виджет
Gateway
- Локально размещённый шлюз
- Конфигурация шифра
- Повторное согласование сертификата клиента
- Бесплатный управляемый сертификат TLS
- Запросы к шлюзу через localhost
Ограничения ресурсов
Следующие ограничения ресурсов применяются к уровням версии 2.
В разделе «Понимание ограничений службы управления API» представлены сведения об ограничениях и рекомендациях по управлению ими в вашем экземпляре.
Замечание
Ограничения относятся к экземпляру службы, если не указано иное.
При подсчете количества API и ресурсов, связанных с API (таких как операции API, серверные серверы, теги и т. д.), управление API также включает версии и редакции API.
| Resource | Базовая версия 2 | Стандартная версия 2 | Премиум v2 |
|---|---|---|---|
| Единицы масштабирования | 10 | 10 | 30 |
| Размер кэша | 250 МБ | 1 ГБ | 5 ГБ |
| API (включая версии и редакции) | 150 | 500 | 2,500 |
| Операции API | 3,000 | 10,000 | 20,000 |
| Подписки | 500 | 2,000 | 4,000 |
| Products | 50 | 200 | 400 |
| Users | 300 | 2,000 | 4,000 |
| Groups | 20 | 100 | 200 |
| Серверы авторизации | 10 | 500 | 500 |
| Фрагменты политики | 50 | 50 | 100 |
| Поставщики OpenID Connect | 10 | 10 | 20 |
| Сертификаты | 100 | 100 | 100 |
| Backends | 100 | 100 | 100 |
| Caches | 100 | 100 | 100 |
| Именованные значения | 100 | 100 | 100 |
| Регистраторы | 100 | 100 | 100 |
| Schemas | 100 | 100 | 100 |
| Схемы для API | 100 | 100 | 100 |
| Метки | 100,000 | 100,000 | 100,000 |
| Теги для API | 500 | 500 | 500 |
| Наборы версий | 100 | 100 | 100 |
| Выпуски по API | 100 | 100 | 100 |
| Операции по API | 200 | 200 | 200 |
| Сопоставители GraphQL | 100 | 100 | 100 |
| Сопоставители GraphQL для каждого API | 100 | 100 | 100 |
| API для каждого продукта | 100 | 100 | 100 |
| Подписки на API | 100 | 100 | 100 |
| Подписки на продукт | 100 | 100 | 100 |
| Группы на продукт | 100 | 100 | 100 |
| Теги для каждого продукта | 100 | 100 | 100 |
| Одновременные внутренние подключения1 для каждого центра HTTP | 2,048 | 2,048 | 2,048 |
| Размер кэшированного ответа | 2 МиБ | 2 МиБ | 2 МиБ |
| Размер документа политики | 256 КиБ | 256 КиБ | 256 КиБ |
| Размер нагрузочных данных запроса | 1 ГиБ | 1 ГиБ | 1 ГиБ |
| Размер буферизованного полезного груза | 2 МиБ | 2 МиБ | 2 МиБ |
| Размер нагрузки запроса и ответа в журналах диагностики | 8 192 байт | 8 192 байт | 8 192 байт |
| Размер URL-адреса запроса2 | 16 384 байта | 16 384 байта | 16 384 байта |
| Длина сегмента пути URL-адреса | 1024 символов | 1024 символов | 1024 символов |
| Длина текста именованного значения | 4096 символов | 4096 символов | 4096 символов |
| Размер текста запроса или ответа в политике проверки содержимого | 100 КиБ | 100 КиБ | 100 КиБ |
| Размер схемы API, используемой политикой проверки | 4 МБ | 4 МБ | 4 МБ |
| Активные подключения WebSocket на единицу3 | 5,000 | 5,000 | 5,000 |
1 Подключения объединяются в пул и повторно используются, если серверная часть их явно не закрывает.
2 Содержит длинную строку запроса размером до 2048 байт.
До 3 до 60 000 подключений на экземпляр службы.
Ограничения портала разработчика
Следующие ограничения применяются к порталу разработчика на уровнях версии 2.
| Item | Базовая версия 2 | Стандартная версия 2 | Премиум v2 |
|---|---|---|---|
| Количество файлов мультимедиа для отправки | 15 | 15 | 15 |
| Размер файла мультимедиа | 500 КБ | 500 КБ | 500 КБ |
| Количество страниц | 30 | 50 | 50 |
| Количество мини-приложений1 | 30 | 50 | 50 |
| Размер метаданных на страницу | 350 КБ | 350 КБ | 350 КБ |
| Размер метаданных на мини-приложение1 | 350 КБ | 350 КБ | 350 КБ |
| Количество запросов клиента в минуту | 200 | 200 | 200 |
1 Ограничение для встроенных мини-приложений, таких как текст, изображения или список API. В настоящее время пользовательские виджеты и виджеты HTML-кода не поддерживаются в уровнях v2.
Deployment
Разверните экземпляр второго уровня с помощью портала Azure и таких средств, как REST API Azure, Azure Resource Manager, файл Bicep или Terraform.
Часто задаваемые вопросы
Можно ли перенести существующий экземпляр управления API на новый экземпляр уровня v2?
Ответ: Нет. В настоящее время вы не можете перенести существующий экземпляр управления API (на уровне "Потребление", "Разработчик", "Базовый", "Стандартный" или "Премиум") на новый экземпляр уровня версии 2. В настоящее время уровни версии 2 доступны только для только созданных экземпляров служб.
Вопрос. Какова связь между вычислительной платформой stv2 и уровнями версии 2?
Ответ. Они не связаны. stv2 — это версия платформы вычислений для экземпляров служб уровней "Разработчик", "Базовый", "Стандартный" и "Премиум". stv2 является преемником вычислительной платформы stv1, которая прекращена в 2024 году.
Вопрос. Будет ли я по-прежнему иметь возможность подготовить службы уровня "Разработчик", "Базовый", "Стандартный" или "Премиум"?
Ответ. Да, изменения в классических уровнях разработчика, "Базовый", "Стандартный" или "Премиум" отсутствуют.
Вопрос. В чем разница между интеграцией виртуальных сетей на уровне "Стандартный" версии 2 и внедрением виртуальной сети в уровнях "Премиум" и "Премиум" версии 2?
Экземпляр службы Standard v2 можно интегрировать с виртуальной сетью, чтобы обеспечить безопасный доступ к бэкэндам, размещенным там. Экземпляр службы Standard v2, интегрированный с виртуальной сетью, имеет публичный IP-адрес для входящего подключения.
Уровень "Премиум" и "Премиум" версии 2 поддерживают полную сетевую изоляцию путем развертывания (внедрения) в виртуальную сеть без предоставления общедоступного IP-адреса. Дополнительные сведения о параметрах сети см. в Управление API.
Вопрос: Можно ли развернуть экземпляр уровня Basic v2 или Standard v2 полностью в моей виртуальной сети?
Ответ. Нет, такое развертывание поддерживается только на уровнях Premium и Premium версии 2.
Связанный контент
- Сравните уровни Управления API.
- Дополнительные сведения о шлюзах управления API
- Узнайте о ценах на управление API.