Что такое Центр API Azure (предварительная версия)?
Центр API позволяет отслеживать все API-интерфейсы в централизованном расположении для обнаружения, повторного использования и управления. Используйте Центр API для разработки и поддержания структурированной и упорядоченной инвентаризации API вашей организации независимо от их типа, этапа жизненного цикла или расположения развертывания, а также связанных сведений о версии, файлах определения API и общих метаданных.
С помощью Центра API заинтересованные лица в организации, включая руководителей программ API, ИТ-администраторов, разработчиков приложений и разработчиков API, могут обнаруживать, повторно использовать и управлять API.
Внимание
- Центр API находится в предварительной версии. Эта предварительная версия предоставляется без соглашения об уровне обслуживания, поэтому возможны критические изменения на этапе предварительной версии. Изменения в предварительной версии модели данных Центра API могут привести к потере данных. Дополнительные сведения см. в статье Дополнительные условия использования Предварительных версий Microsoft Azure.
- Во время предварительной версии функции запроса, ошибок отчета или предоставления других отзывов в этом репозитории GitHub.
Примечание.
Центр API — это решение для организаций по каталогу и управлению их инвентаризацией API. Azure также предлагает службу Управление API, решение для управления, защиты и публикации серверных компонентов API организации через шлюз API. Узнайте больше о разнице.
Льготы
Создание и обслуживание инвентаризации организации . Организации могут создавать полный список API , доступных в своей организации. Обеспечение взаимодействия и предоставление руководителям программ API и разработчикам совместной работы для повышения производительности API, повышения качества, безопасности, соответствия требованиям и производительности разработчиков.
Управление API вашей организации. Благодаря более полной видимости создаваемых и используемых в организации API менеджеры программ API и ИТ-администраторы могут управлять этим инвентаризацией, чтобы обеспечить соответствие требованиям организационных стандартов путем определения пользовательских метаданных и анализа определений API для обеспечения соответствия рекомендациям по стилю API.
Простое обнаружение API. Организации хотят повысить эффективность использования API для повышения производительности разработчиков и обеспечить, чтобы разработчики использовали правильные API. Центр API помогает руководителям программ и разработчикам обнаруживать инвентаризацию и фильтрацию API с помощью встроенных и настраиваемых свойств метаданных.
Ускорение потребления API. Максимальное производительность разработчика при использовании API и обеспечение безопасного использования их в соответствии со стандартами организации.
Основные возможности
В предварительной версии создайте и используйте центр API в портал Azure для следующих действий:
Управление инвентаризацией API. Зарегистрируйте все API вашей организации для включения в централизованный инвентаризацию.
Представление API реального мира — добавление реальных сведений о каждом API , включая версии и определения, такие как определения OpenAPI. Перечислите развертывания API и свяжите их с средами выполнения, например, представляющей Azure Управление API или другие решения по управлению API.
Управление API — упорядочивание и фильтрация API и связанных ресурсов с помощью встроенных и настраиваемых свойств метаданных для управления API и обнаружения потребителями API. Настройте структуру и анализ для обеспечения качества определения API.
Обнаружение и повторное использование API. Включение разработчиков и руководителей программ API для обнаружения API с помощью портал Azure, портала Центра API и средств разработчиков, включая расширение Visual Studio Code, интегрированное с GitHub Copilot.
Дополнительные сведения о сущностях, которые можно управлять и возможностями в Центре API, см . в основных понятиях.
Доступные регионы
В настоящее время Центр API доступен в следующих регионах Azure:
- Восточная Австралия
- Центральная Индия
- Восточная часть США
- южная часть Соединенного Королевства
- Западная Европа
Центр API и экосистема API
Центр API может служить ключевой ролью в экосистеме API организации. Рассмотрим гипотетическую организацию Contoso, которая приняла стратегию API-первого, подчеркивая важность API в разработке и интеграции программного обеспечения.
Разработчики API Contoso, разработчики приложений, руководители программ API и руководители API совместно работают через Центр API Azure для разработки и использования инвентаризации API организации. См. следующую схему и объяснение.
Экосистема API Contoso включает в себя следующее:
Разработка API— разработчики Компании Contoso регулярно создают ASP.NET веб-API. Они также создают Функции Azure с триггерами HTTP.
Среды развертывания API — Contoso развертывает часть своих API в службе приложение Azure. Другой подмножество api развертывается в приложении-функции Azure.
Управление API— Компания Contoso использует Azure Управление API для управления, публикации и защиты API. Они используют отдельные экземпляры для разработки, тестирования и рабочей среды с отдельным именем: APIM-DEV, APIM-TEST и APIM-PROD.
Центр API — Компания Contoso приняла Центр API Azure в качестве центра централизованного центра обнаружения API, управления и потребления. Центр API служит структурированным и упорядоченным центром API, предоставляющим исчерпывающую информацию обо всех API организации, поддерживая связанные сведения, включая версии и связанные развертывания.
Часто задаваемые вопросы
Вопрос. В чем разница между Azure Управление API и Центром API Azure?
Ответ. Azure Управление API — это полностью управляемая служба Azure, которая помогает организациям безопасно предоставлять свои API внешним и внутренним клиентам. Он предоставляет набор средств и служб для создания, публикации и управления API, а также обеспечения безопасности, масштабирования и мониторинга использования API.
С другой стороны, Центр API Azure помогает организациям создавать каталог API, доступных в организации. Центр API Azure предоставляет основные сведения об API, таких как их имя, описание и версия, но дополнительные сведения можно добавить в эти API с помощью пользовательских метаданных. Центр API Azure помогает различным заинтересованным лицам, таким как руководители API или разработчики API, обнаруживать и повторно использовать существующие API в организации.
Хотя обе службы предоставляют средства управления API, они служат разным целям. Azure Управление API — это платформа для создания, публикации и управления API, а Центр API предоставляет централизованное расположение для обнаружения и повторного использования существующих API в организации.
Вопрос. Разделы справки использовать Центр API с моим решением Управление API?
Ответ. Центр API — это автономная служба Azure, которая дополняет службы Azure Управление API и службы управления API от других поставщиков. Центр API предоставляет единую инвентаризацию API для всех API в организации, включая API, которые не выполняются в шлюзах API (например, те, которые по-прежнему находятся в разработке) и управляемые с различными решениями управления API.
Для API, управляемых с помощью решения для управления API, Центр API может хранить метаданные, такие как среда выполнения и сведения о развертывании.
Вопрос. Зашифрованы ли мои данные в Центре API?
Ответ. Да, все данные в Центре API шифруются неактивных данных.