Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X. Информация
Расширения позволяют интегрировать внешние ресурсы в прокси API. Например, вы можете интегрировать сервисы Google Cloud Platform, такие как Google Cloud Storage. Во время выполнения прокси-сервер API использует расширение для обмена запросами и ответами с внешним ресурсом.
Фреймворк среды выполнения расширений
Во время выполнения расширение выступает в качестве посредника, обрабатывая запросы и ответы между прокси-сервером API и внешним ресурсом.
Ниже описано, как расширение обрабатывает данные во время выполнения.
- Клиентский запрос поступает в прокси-сервер API, и его поток запросов проходит через правила прокси.
- Поток запросов достигает правила для уточнения в прокси-сервере, который настроен на передачу данных расширению, развернутому в среде. Данные содержат значения, необходимые для отправки запроса к внешнему ресурсу, который представляет расширение.
- Расширение отправляет запрос на внешний ресурс и получает ответ.
- Расширение передает свой ответ обратно в правило Extension Callout, где он обрабатывается кодом прокси-сервера.
- Запрос проходит через прокси-сервер, пока не будет получен ответ от клиента.
Как работать с расширениями
Каждое расширение разрабатывается и настраивается с учетом определенного внешнего ресурса. Чтобы использовать расширение, администратор Apigee Edge и разработчик прокси-сервера API выполняют следующие действия:
- Администратор организации Apigee Edge настраивает и развертывает расширение. Они настраивают его с учетом потребностей компании. Эта конфигурация создает экземпляр расширения, предназначенный для разработчика прокси-сервера API. Например, они могут настроить расширение для доступа к определенному сегменту в Google Cloud Storage, включая необходимые учетные данные для аутентификации.
- Разработчик прокси-сервера API использует настроенное расширение в прокси-сервере API, добавляя в прокси-сервер правило вызова расширения. В конфигурации правила указано:
- какое из настроенных расширений использовать.
- действия расширения (их можно рассматривать как вызовы функций расширения).
- параметры действия, которые будут передаваться при вызове действия. Во время выполнения правил расширение используется для доступа к внешнему ресурсу в рамках потока прокси-сервера.
Документация о расширениях
Ниже приведены ссылки на статьи, в которых рассказывается о расширениях:
- Чтобы узнать, как работать с расширениями, ознакомьтесь с руководством по добавлению и использованию расширений.
- Справочную информацию о расширениях, включенных в Apigee Edge, можно найти в разделе Обзор справочной информации о расширениях.
- Справочную информацию об API управления, с помощью которого можно добавлять, удалять и развертывать расширения, можно найти в разделе Extensions API.