Различия между Apigee Edge и Apigee X

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

В этом разделе описывается, чем Apigee X (иногда называемый просто «Apigee») отличается от Apigee Edge. Эта информация предназначена для существующих клиентов Apigee Edge, которые рассматривают возможность перехода на Apigee X.

Дополнительную информацию о функциях Apigee X см. в кратком описании функций Apigee X.

В следующей таблице перечислены продукты управления API Apigee, сравниваемые в этом разделе:

Продукт Где размещено Управляется
Apigee Edge для публичного облака Облако Апигея Апигей
Apigee Edge для частного облака Частный дата-центр клиента. Клиент
Апигей Икс Google Облако Апигей
Апигей гибридный И Google Cloud, и частный центр обработки данных клиента. Apigee управляет плоскостью управления, а клиент управляет плоскостью среды выполнения.

Сравнение функций Apigee Edge и Apigee X

В следующих разделах сравниваются функции публичного/частного облака Apigee Edge с доступностью функций в Apigee X и гибридной версии.

Обратите внимание, что ограничения Apigee X также отличаются от ограничений Apigee Edge .

Краткое изложение текущих различий в функциях

В следующей таблице описаны различия на уровне функций между Apigee X (и гибридом) и Apigee Edge для платформ публичного и частного облака.

Функция Apigee Edge Поддержка Apigee X и гибрида
Изменения API-прокси

Неизменяемый при развертывании

Активные проверки работоспособности Поддерживается для внешних MIG (которые используют виртуальные машины). Не поддерживается при использовании Private Service Connect. Информацию о типах маршрутизации см. в разделе Настройка маршрутизации .
Адаптер Apigee для Istio Устарело: вместо этого мы рекомендуем использовать адаптер Apigee для Envoy .
Компании и девелоперы

Существует похожее, но не идентичное решение. См. Использование групп приложений для организации владения приложениями .

CwC (код с конфигурацией)

Планируется

Развертывания
  • Асинхронные развертывания
  • Получение статуса развертывания зависит от того, когда в последний раз плоскость выполнения «регистрировалась» на плоскости управления.
Окружающая среда
  • Поддержка групп окружения
  • Самообслуживание через пользовательский интерфейс и API Apigee.
  • Больше гибкости в топологии обслуживания
  • Модуль MP может обслуживать только одну среду.

Дополнительные сведения см. в разделе О средах и группах сред .

Размещенные цели

Пожалуйста, используйте Cloud Run или Cloud Functions.

Обработка имени поля заголовка HTTP/1.1 Преобразует имена полей заголовка HTTP/1.1 в нижний регистр при пересылке на серверную часть. В Apigee Edge регистр имен полей заголовка сохраняется.
Роли IAM для детального управления доступом на основе ролей.

Планируется

JSONPath с использованием [@.length-x]

Использование [@.length-x] в выражениях JSONPath не поддерживается в Apigee X. В спецификации JSONPath указано, что выражения зависят от базового языка сценариев. length-x — это конструкция JavaScript, а не Java, и [@.length-x] не был реализован как часть спецификации. В Apigee X выражение [@.length-x] заменяется схемой индексации ( [-x] ).

Для этого примера:

{
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}

Ввод: $.books[@.length-1] возвращает {“name”: “B”} в Apigee Edge и возвращает [{“name”: “B”}] в Apigee X.

Хранилища ключей/доверенные хранилища

Northbound управляется как секреты Kubernetes

КВМ
  • Вы можете создавать зашифрованные KVM с ограниченной областью действия в пользовательском интерфейсе Apigee. KVM всегда зашифрованы. Вы не можете добавлять, обновлять или просматривать записи KVM в пользовательском интерфейсе.
  • Используйте private. атрибут со всеми переменными при доступе к KVM с помощью команды GET , чтобы скрыть информацию KVM в сеансе отладки (трассировки). Если private. атрибут не используется, KVM по-прежнему зашифрован; однако информация KVM будет отображаться в расшифрованном сеансе трассировки отладки, и никаких исключений не будет.
  • Управлять записями KVM можно с помощью API keyvaluemaps.entries или политики KeyValueMapOperations .
  • Вы можете использовать наборы свойств для тех же случаев, что и KVM. См. Использование наборов свойств .
  • Элемент <MapName> позволяет политике KeyValueMapOperations определять, какой KVM использовать динамически во время выполнения.

Дополнительные сведения о создании KVM в пользовательском интерфейсе см. в разделе Использование карт значений ключа . См. также Доступ к данным конфигурации для получения информации о том, как выбрать правильный механизм сохранения данных.

Микрошлюз Вместо этого мы рекомендуем использовать адаптер Apigee для Envoy .
Монетизация См. раздел «Различия с монетизацией».
Node.js
  • Прокси-серверы API Node.js не поддерживаются.
  • Apigee рекомендует размещать приложения Node.js в отдельных контейнерах в Kubernetes (тот же или другой кластер).
mTLS на север Поддерживается через балансировщики нагрузки Google Cloud. См. раздел Apigee X Northbound Mutual TLS с использованием балансировщика нагрузки внешнего приложения .
OAuth Новая политика RevokeOAuthv2 отзывается по идентификатору конечного пользователя, идентификатору приложения или по тому и другому. Эта политика заменяет API Apigee Edge для отзыва токенов OAuth2.
Политика
  • Новые правила:
    • Политика AssertCondition : оценивает условный оператор во время выполнения в потоках запросов или ответов.
    • Политика CORS : позволяет вызовам JavaScript XMLHttpRequest (XHR), выполняемым на веб-странице, взаимодействовать с ресурсами из доменов, не являющихся источниками.
    • Политика DataCapture : заменяет политику СтатистикаКоллектор.
    • Политика ExternalCallout : отправляет запросы gRPC на ваш сервер gRPC для реализации пользовательского поведения, которое не поддерживается политиками Apigee.
    • Политика GraphQL : анализирует полезные данные GraphQL в переменных потока сообщений, проверяет запросы GraphQL на соответствие схеме или и то, и другое.
    • Политика PublishMessages : публикует информацию о потоке прокси-сервера API в теме Google Cloud Pub/Sub.
    • Политика RevokeOAuthv2 : отзывается по идентификатору пользователя, идентификатору приложения или по тому и другому.
    • Политика TraceCapture : добавляет дополнительные переменные в данные трассировки среды выполнения Apigee.
  • Политика не поддерживается:
    • Политика СтатистикаКоллектор (заменена новой политикой DataCapture)
  • Измененная политика:
причинаФраза Не поддерживается.
Ресурсы Невозможно использовать ресурсы уровня организации.
Роли и разрешения
  • Управляется через службу IAM консоли Google Cloud.
  • Доступны некоторые курируемые готовые роли.
  • Вы можете создавать собственные роли, которые могут включать в себя другие разрешения Google Cloud.

Дополнительные сведения см. в разделе Пользователи и роли .

Смысл Используйте расширенную безопасность API .
Службы SOAP в мастере создания прокси-сервера Не поддерживается. См. wsdl2apigee — проект с открытым исходным кодом, который предоставляет утилиты SOAP для использования с Apigee.
Сеансы трассировки/отладки См. Различия с трассировкой .
Виртуальные хосты

Для гибрида Apigee:

  • Вход осуществляется через входной шлюз Apigee.
  • Ключи и сертификаты развертываются непосредственно в Kubernetes.

Для Апиджи X:

  • Каждый экземпляр предоставляет конечную точку HTTPS через самозаверяющий сертификат. Центр сертификации для сертификата можно загрузить, отправив запрос в org.

Различия с трассировкой

В следующей таблице сравниваются различия в работе Trace в Apigee X и гибридном и Apigee Edge Cloud:

Особенность Облако Apigee Edge Apigee X и гибрид
Своевременность Реальное время; синхронный Небольшая задержка; асинхронный
Имя/идентификатор сеанса Принимает имя сеанса от пользователя Не принимает имя сеанса от пользователя
Фильтры Поддержка базовых фильтров, таких как фильтрация заголовков и параметров запроса. Поддержка сложной логики фильтрации, включая логические операции И и ИЛИ. Доступ к любой переменной потока, упомянутой в справочнике по переменным потока . Синтаксис тот же, что и для условных операторов, как показано в ссылке на условия .
Тайм-аут сеанса

Определяет продолжительность сеанса отладки, а также время хранения данных.

Значение по умолчанию — 20 минут при инициировании через вызовы API и 10 минут при инициировании в пользовательском интерфейсе.

Определяет только продолжительность сеанса отладки. Отправной точкой является получение процессором сообщений запроса на работу в режиме отладки.

Значение по умолчанию — 5 минут, если сеанс был инициирован с помощью API, и 10 минут, если он был инициирован через пользовательский интерфейс.

Данные сохраняются в течение 24 часов, после чего гибридная система автоматически удаляет их.

Срок действия сеанса

Продолжительность времени, в течение которого действителен запрос на создание сеанса. Если сеанс отладки не запускается в течение этого времени, синхронизаторы могут игнорировать запрос на создание сеанса. Обязательно синхронизируйте часы ваших синхронизаторов, как описано в разделе «Предварительные условия» .
Количество запросов трассировки Максимум 20 на процессор сообщений По умолчанию — 10 на процессор сообщений; максимум 15.
API Облако Apigee Edge Апигей Икс
Apigee X предоставляет API сеанса отладки и API данных сеанса отладки , но не поддерживает через API Apigee X следующее:
Остановить сеанс отладки

Удаление определенных транзакций

Различия с монетизацией

В следующей таблице представлено сравнение ключевых функций Apigee Edge Monetization и Apigee X Monetization.

Монетизация Apigee Edge Apigee X/гибридная монетизация
Тарифные планы связаны с пакетами продуктов API, которые можно прикрепить к нескольким продуктам API. Тарифные планы связаны с продуктами API (отношения один к одному).
Тарифные планы для разработчиков приложений Разработчики приложений приобретают продукты API
Квоты управляются на уровне прокси-сервера API. Квоты управляются на уровне продукта API (бизнес-уровень).
Опубликованные тарифные планы могут иметь только истекший срок действия; их нельзя редактировать или удалять Опубликованные тарифные планы могут быть просрочены, отредактированы, перемещены в черновик или удалены.
Сложная конфигурация (без мастера или инструмента предварительного просмотра) Упрощенная настройка тарифных планов с помощью мастера и инструмента предварительного просмотра.
Политика MonetizationLimitsCheck блокирует доступ после обработки первого вызова API, если разработчик приложения не приобрел подписку. Политика MonetizationLimitsCheck немедленно блокирует доступ, если разработчик приложения не приобрел подписку или превысил квоту.
Данные о монетизации транзакций можно собирать с помощью пользовательских переменных в политике записи транзакций. Apigee автоматически собирает данные монетизации, а данные монетизации транзакций можно переопределить с помощью политики DataCapture. Дополнительную информацию см. в разделе «Сбор данных о монетизации» .
Предоплаченные и постоплатные счета можно настроить как для разработчиков, так и для тарифных планов. Учетные записи с предоплатой и постоплатой можно настроить только для разработчиков.

Какие функции Apigee Edge не поддерживаются в Apigee X?

Google не планирует поддерживать следующие функции:

  • Расширения Apigee Edge
  • Магазин спецификаций OpenAPI
  • API для поиска или отзыва токенов доступа OAuth (поскольку токены хешируются)
  • Политика OAuth v1 или OAuth OAuthv1.0a
  • Трирема (прекращение действия 10.10.2019)
  • Заголовки с префиксом «X-Apigee-» не поддерживаются в Apigee X и удаляются из запросов и ответов перед отправкой целевым объектам и клиентам.
  • Свойство Apigee Edge proxy_read_timeout не поддерживается в Apigee X. См. раздел Настройка io.timeout.millis и api.timeout для получения информации о соответствующих настройках тайм-аута Apigee X.

Сравнение API

В целом, большинство API Apigee Edge имеют эквиваленты Apigee API. В этом разделе представлены:

Сводка изменений с использованием API

Ниже перечислены изменения в поведении всех API Apigee X по сравнению с API Apigee Edge.

Поведение API-интерфейсы Apigee Edge API-интерфейсы Apigee X
Базовый домен api.enterprise.apigee.com apigee.googleapis.com
Типы носителей application/json
application/xml		 application/json
Аутентификация OAuth2, SAML, базовый ОАут2
Временные метки в ключах формат int64 
{
  "createdAt": 1234,
  "lastModifiedAt": 5678
}
String формат 
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
Структура параметра expand=false 
[
        "helloworld",
        "weather"
      ]
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
Параметры запроса с префиксом подчеркивания Поддерживается ( _optimal=true ) Не поддерживается ( optimal=true )
Свойства в полезных нагрузках:
  • created_by
  • modified_by
  • self
 Поддерживается Не поддерживается
Значения по умолчанию в полезных нагрузках Включено Не включено
Структура обработки ошибок 
{
        "code": "...",
        "message": "..",
        "contexts": []
      }
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
Ответ на удаление кэша Возвращает: 200 OK и сведения о кэше. Возврат: 204 No Content
Операции API кэша Список , создание , получение , обновление , удаление , очистка всех и очистка параметров. Только список и удаление . Кратковременный кеш L1 автоматически создается при развертывании прокси-сервера API. Дополнительные сведения см. в разделе Внутреннее устройство кэша .

Различия между API метрик Apigee Edge и Apigee X

В сводке изменений с использованием API перечислены общие различия между API Apigee Edge и Apigee X API. В следующей таблице перечислены конкретные различия между API метрик:

Особенность API-интерфейсы Apigee Edge API-интерфейсы Apigee X
конечная точка API api.enterprise.apigee.com apigee.googleapis.com
Ежедневные аналитические письма API не поддерживаются
API списка асинхронных запросов Получить список запросов асинхронной аналитики Свойство userId опущено в ответе. См. метод: организации.environments.queries.list .
API пользовательских отчетов API отчетов Свойства createdBy и lastModifiedBy были удалены из ответа. См. API отчетов .

Неподдерживаемые API Apigee Edge

В следующей таблице перечислены неподдерживаемые API Apigee Edge (которые не имеют эквивалентов API Apigee X).

Категория API Неподдерживаемые API Apigee Edge
API-мониторинг API не поддерживаются
API-прокси
  • Принудительно отменить развертывание прокси-сервера API
  • Получить зависимости npm
  • Управление модулями npm
Аудиты Используйте API ведения журнала Stackdriver
Кэшированные журналы API не поддерживаются
Компании API не поддерживаются
Приложения компании API не поддерживаются
Семейство корпоративных приложений API не поддерживаются
Ключи приложения компании API не поддерживаются
Сеансы отладки
  • Невозможно остановить сеансы трассировки
  • Невозможно удалить отдельные транзакции

Дополнительные сведения см. в разделе Различия с Trace .

Приложение для разработчиков Получить количество ресурсов API
Семейство приложений для разработчиков API не поддерживаются
Расширения API не поддерживаются
Хранилище ключей: хранилище доверенных сертификатов Проверка хранилища ключей или хранилища доверенных сертификатов
ЛДАП API не поддерживаются
Монетизация API не поддерживаются
ОАутентификация 2. API не поддерживаются
Политика API не поддерживаются
Файлы ресурсов
  • Область изменения прокси-сервера API
  • Объем организации
Смысл API не поддерживаются
Пользователи и роли пользователей Используйте API-интерфейсы Google Identity and Access Management (IAM), как описано в разделе «Управление пользователями, ролями и разрешениями с помощью API».
Виртуальные хосты API не поддерживаются

Apigee Edge для частного облака и гибрид Apigee

В следующей таблице сравниваются Apigee Edge для частного облака и гибрид Apigee:

Услуга Продукт или область функций Apigee
Apigee Edge для частного облака Апигей гибридный
Аналитика Серверы Qpid и Postgres Модуль сбора данных в плоскости выполнения использует Fluentd и UDCA (универсальный агент сбора данных) для сбора аналитики и передачи данных в UAP (унифицированную аналитическую платформу) в плоскости управления.
API-прокси-шлюз Процессор сообщений Процессор сообщений (MP) обрабатывает входящие запросы. MP реализуются как одно или несколько контейнерных приложений в плоскости выполнения.
Упорство Узел или кольцо Кассандры Cassandra обеспечивает постоянство функций KMS, KVM, квот и кэша.
Развертывание смотритель зоопарка Синхронизатор обеспечивает актуальность конфигураций прокси-сервера API, информации о среде и других данных между плоскостью управления и плоскостью среды выполнения.
Административный пользовательский интерфейс Пользовательский интерфейс Apigee Edge размещается на сервере управления. Пользовательский интерфейс Apigee размещается на плоскости управления.
Балансировка нагрузки Маршрутизатор Контроллер Istio Ingress передает запросы контейнерному приложению процессора сообщений (MP) в плоскости выполнения.
API Сервер управления Доступ к API Apigee X осуществляется через Management Server и MART . MART взаимодействует с локальным хранилищем данных Cassandra и служит поставщиком API для API Apigee X для доступа к объектам данных времени выполнения и управления ими.
Метрики Каждый компонент настроен с помощью JMX Управляется одним сервером Prometheus на кластер для всех служб.
,

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

В этом разделе описывается, чем Apigee X (иногда называемый просто «Apigee») отличается от Apigee Edge. Эта информация предназначена для существующих клиентов Apigee Edge, которые рассматривают возможность перехода на Apigee X.

Дополнительную информацию о функциях Apigee X см. в кратком описании функций Apigee X.

В следующей таблице перечислены продукты управления API Apigee, сравниваемые в этом разделе:

Продукт Где размещено Управляется
Apigee Edge для публичного облака Облако Апигея Апигей
Apigee Edge для частного облака Частный дата-центр клиента. Клиент
Апигей Икс Google Облако Апигей
Апигей гибридный И Google Cloud, и частный центр обработки данных клиента. Apigee управляет плоскостью управления, а клиент управляет плоскостью среды выполнения.

Сравнение функций Apigee Edge и Apigee X

В следующих разделах сравниваются функции публичного/частного облака Apigee Edge с доступностью функций в Apigee X и гибридной версии.

Обратите внимание, что ограничения Apigee X также отличаются от ограничений Apigee Edge .

Краткое изложение текущих различий в функциях

В следующей таблице описаны различия на уровне функций между Apigee X (и гибридом) и Apigee Edge для платформ публичного и частного облака.

Функция Apigee Edge Поддержка Apigee X и гибрида
Изменения API-прокси

Неизменяемый при развертывании

Активные проверки работоспособности Поддерживается для внешних MIG (которые используют виртуальные машины). Не поддерживается при использовании Private Service Connect. Информацию о типах маршрутизации см. в разделе Настройка маршрутизации .
Адаптер Apigee для Istio Устарело: вместо этого мы рекомендуем использовать адаптер Apigee для Envoy .
Компании и девелоперы

Существует похожее, но не идентичное решение. См. Использование групп приложений для организации владения приложениями .

CwC (код с конфигурацией)

Планируется

Развертывания
  • Асинхронные развертывания
  • Получение статуса развертывания зависит от того, когда в последний раз плоскость выполнения «регистрировалась» на плоскости управления.
Окружающая среда
  • Поддержка групп окружения
  • Самообслуживание через пользовательский интерфейс и API Apigee.
  • Больше гибкости в топологии обслуживания
  • Модуль MP может обслуживать только одну среду.

Дополнительные сведения см. в разделе О средах и группах сред .

Размещенные цели

Пожалуйста, используйте Cloud Run или Cloud Functions.

Обработка имени поля заголовка HTTP/1.1 Преобразует имена полей заголовка HTTP/1.1 в нижний регистр при пересылке на серверную часть. В Apigee Edge регистр имен полей заголовка сохраняется.
Роли IAM для детального управления доступом на основе ролей.

Планируется

JSONPath с использованием [@.length-x]

Использование [@.length-x] в выражениях JSONPath не поддерживается в Apigee X. В спецификации JSONPath указано, что выражения зависят от базового языка сценариев. length-x — это конструкция JavaScript, а не Java, и [@.length-x] не был реализован как часть спецификации. В Apigee X выражение [@.length-x] заменяется схемой индексации ( [-x] ).

Для этого примера:

{
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}

Ввод: $.books[@.length-1] возвращает {“name”: “B”} в Apigee Edge и возвращает [{“name”: “B”}] в Apigee X.

Хранилища ключей/доверенные хранилища

Northbound управляется как секреты Kubernetes

КВМ
  • Вы можете создавать зашифрованные KVM с ограниченной областью действия в пользовательском интерфейсе Apigee. KVM всегда зашифрованы. Вы не можете добавлять, обновлять или просматривать записи KVM в пользовательском интерфейсе.
  • Используйте private. атрибут со всеми переменными при доступе к KVM с помощью команды GET , чтобы скрыть информацию KVM в сеансе отладки (трассировки). Если private. атрибут не используется, KVM по-прежнему зашифрован; однако информация KVM будет отображаться в расшифрованном сеансе трассировки отладки, и никаких исключений не будет.
  • Управлять записями KVM можно с помощью API keyvaluemaps.entries или политики KeyValueMapOperations .
  • Вы можете использовать наборы свойств для тех же случаев, что и KVM. См. Использование наборов свойств .
  • Элемент <MapName> позволяет политике KeyValueMapOperations определять, какой KVM использовать динамически во время выполнения.

Дополнительные сведения о создании KVM в пользовательском интерфейсе см. в разделе Использование карт значений ключа . См. также Доступ к данным конфигурации для получения информации о том, как выбрать правильный механизм сохранения данных.

Микрошлюз Вместо этого мы рекомендуем использовать адаптер Apigee для Envoy .
Монетизация См. раздел «Различия с монетизацией».
Node.js
  • Прокси-серверы API Node.js не поддерживаются.
  • Apigee рекомендует размещать приложения Node.js в отдельных контейнерах в Kubernetes (тот же или другой кластер).
mTLS на север Поддерживается через балансировщики нагрузки Google Cloud. См. раздел Apigee X Northbound Mutual TLS с использованием балансировщика нагрузки внешнего приложения .
OAuth Новая политика RevokeOAuthv2 отзывается по идентификатору конечного пользователя, идентификатору приложения или по тому и другому. Эта политика заменяет API Apigee Edge для отзыва токенов OAuth2.
Политика
  • Новые политики:
    • Политика AssertCondition : оценивает условный оператор во время выполнения в потоках запросов или ответов.
    • Политика CORS : позволяет вызовам JavaScript XMLHttpRequest (XHR), выполняемым на веб-странице, взаимодействовать с ресурсами из доменов, не являющихся источниками.
    • Политика DataCapture : заменяет политику СтатистикаКоллектор.
    • Политика ExternalCallout : отправляет запросы gRPC на ваш сервер gRPC для реализации пользовательского поведения, которое не поддерживается политиками Apigee.
    • Политика GraphQL : анализирует полезные данные GraphQL в переменных потока сообщений, проверяет запросы GraphQL на соответствие схеме или и то, и другое.
    • Политика PublishMessages : публикует информацию о потоке прокси-сервера API в теме Google Cloud Pub/Sub.
    • Политика RevokeOAuthv2 : отзывается по идентификатору пользователя, идентификатору приложения или по тому и другому.
    • Политика TraceCapture : добавляет дополнительные переменные в данные трассировки среды выполнения Apigee.
  • Политика не поддерживается:
    • Политика СтатистикаКоллектор (заменена новой политикой DataCapture)
  • Измененная политика:
причинаФраза Не поддерживается.
Ресурсы Невозможно использовать ресурсы уровня организации.
Роли и разрешения
  • Управляется через службу IAM консоли Google Cloud.
  • Доступны некоторые курируемые готовые роли.
  • Вы можете создавать собственные роли, которые могут включать в себя другие разрешения Google Cloud.

Дополнительные сведения см. в разделе Пользователи и роли .

Смысл Используйте расширенную безопасность API .
Службы SOAP в мастере создания прокси-сервера Не поддерживается. См. wsdl2apigee — проект с открытым исходным кодом, который предоставляет утилиты SOAP для использования с Apigee.
Сеансы трассировки/отладки См. Различия с трассировкой .
Виртуальные хосты

Для гибрида Apigee:

  • Вход осуществляется через входной шлюз Apigee.
  • Ключи и сертификаты развертываются непосредственно в Kubernetes.

Для Апиджи X:

  • Каждый экземпляр предоставляет конечную точку HTTPS через самозаверяющий сертификат. Центр сертификации для сертификата можно загрузить, отправив запрос в org.

Различия с трассировкой

В следующей таблице сравниваются различия в работе Trace в Apigee X и гибридном и Apigee Edge Cloud:

Особенность Облако Apigee Edge Apigee X и гибрид
Своевременность Реальное время; синхронный Небольшая задержка; асинхронный
Имя/идентификатор сеанса Принимает имя сеанса от пользователя Не принимает имя сеанса от пользователя
Фильтры Поддержка базовых фильтров, таких как фильтрация заголовков и параметров запроса. Поддержка сложной логики фильтрации, включая логические операции И и ИЛИ. Доступ к любой переменной потока, упомянутой в справочнике по переменным потока . Синтаксис тот же, что и для условных операторов, как показано в ссылке на условия .
Тайм-аут сеанса

Определяет продолжительность сеанса отладки, а также время хранения данных.

Значение по умолчанию — 20 минут при инициировании через вызовы API и 10 минут при инициировании в пользовательском интерфейсе.

Определяет только продолжительность сеанса отладки. Отправной точкой является получение процессором сообщений запроса на работу в режиме отладки.

Значение по умолчанию — 5 минут, если сеанс был инициирован с помощью API, и 10 минут, если он был инициирован через пользовательский интерфейс.

Данные сохраняются в течение 24 часов, после чего гибридная система автоматически удаляет их.

Срок действия сеанса

Продолжительность времени, в течение которого действителен запрос на создание сеанса. Если сеанс отладки не запускается в течение этого времени, синхронизаторы могут игнорировать запрос на создание сеанса. Обязательно синхронизируйте часы ваших синхронизаторов, как описано в разделе «Предварительные условия» .
Количество запросов трассировки Максимум 20 на процессор сообщений По умолчанию — 10 на процессор сообщений; максимум 15.
API Облако Apigee Edge Апигей Икс
Apigee X предоставляет API сеанса отладки и API данных сеанса отладки , но не поддерживает через API Apigee X следующее:
Остановить сеанс отладки

Удаление определенных транзакций

Различия с монетизацией

В следующей таблице представлено сравнение ключевых функций Apigee Edge Monetization и Apigee X Monetization.

Монетизация Apigee Edge Apigee X/гибридная монетизация
Тарифные планы связаны с пакетами продуктов API, которые можно прикрепить к нескольким продуктам API. Тарифные планы связаны с продуктами API (отношения один к одному).
Тарифные планы для разработчиков приложений Разработчики приложений приобретают продукты API
Квоты управляются на уровне прокси-сервера API. Квоты управляются на уровне продукта API (бизнес-уровень).
Опубликованные тарифные планы могут иметь только истекший срок действия; их нельзя редактировать или удалять Опубликованные тарифные планы могут быть просрочены, отредактированы, перемещены в черновик или удалены.
Сложная конфигурация (без мастера или инструмента предварительного просмотра) Упрощенная настройка тарифных планов с помощью мастера и инструмента предварительного просмотра.
Политика MonetizationLimitsCheck блокирует доступ после обработки первого вызова API, если разработчик приложения не приобрел подписку. Политика MonetizationLimitsCheck немедленно блокирует доступ, если разработчик приложения не приобрел подписку или превысил квоту.
Данные о монетизации транзакций можно собирать с помощью пользовательских переменных в политике записи транзакций. Apigee автоматически собирает данные монетизации, а данные монетизации транзакций можно переопределить с помощью политики DataCapture. Дополнительную информацию см. в разделе «Сбор данных о монетизации» .
Предоплаченные и постоплатные счета можно настроить как для разработчиков, так и для тарифных планов. Учетные записи с предоплатой и постоплатой можно настроить только для разработчиков.

Какие функции Apigee Edge не поддерживаются в Apigee X?

Google не планирует поддерживать следующие функции:

  • Расширения Apigee Edge
  • Магазин спецификаций OpenAPI
  • API для поиска или отзыва токенов доступа OAuth (поскольку токены хешируются)
  • Политика OAuth v1 или OAuth OAuthv1.0a
  • Трирема (прекращение действия 10.10.2019)
  • Заголовки с префиксом «X-Apigee-» не поддерживаются в Apigee X и удаляются из запросов и ответов перед отправкой целевым объектам и клиентам.
  • Свойство Apigee Edge proxy_read_timeout не поддерживается в Apigee X. См. раздел Настройка io.timeout.millis и api.timeout для получения информации о соответствующих настройках тайм-аута Apigee X.

Сравнение API

В целом, большинство API Apigee Edge имеют эквиваленты Apigee API. В этом разделе представлены:

Сводка изменений с использованием API

Ниже перечислены изменения в поведении всех API Apigee X по сравнению с API Apigee Edge.

Поведение API-интерфейсы Apigee Edge API-интерфейсы Apigee X
Базовый домен api.enterprise.apigee.com apigee.googleapis.com
Типы носителей application/json
application/xml		 application/json
Аутентификация OAuth2, SAML, базовый ОАут2
Временные метки в ключах формат int64 
{
  "createdAt": 1234,
  "lastModifiedAt": 5678
}
String формат 
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
Структура параметра expand=false 
[
        "helloworld",
        "weather"
      ]
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
Параметры запроса с префиксом подчеркивания Поддерживается ( _optimal=true ) Не поддерживается ( optimal=true )
Свойства в полезных нагрузках:
  • created_by
  • modified_by
  • self
 Поддерживается Не поддерживается
Значения по умолчанию в полезных нагрузках Включено Не включено
Структура обработки ошибок 
{
        "code": "...",
        "message": "..",
        "contexts": []
      }
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
Ответ на удаление кэша Возвращает: 200 OK и сведения о кэше. Возврат: 204 No Content
Операции API кэша Список , создание , получение , обновление , удаление , очистка всех и очистка параметров. Только список и удаление . Кратковременный кеш L1 автоматически создается при развертывании прокси-сервера API. Дополнительные сведения см. в разделе Внутреннее устройство кэша .

Различия между API метрик Apigee Edge и Apigee X

В сводке изменений с использованием API перечислены общие различия между API Apigee Edge и Apigee X API. В следующей таблице перечислены конкретные различия между API метрик:

Особенность API-интерфейсы Apigee Edge API-интерфейсы Apigee X
конечная точка API api.enterprise.apigee.com apigee.googleapis.com
Ежедневные аналитические письма API не поддерживаются
API списка асинхронных запросов Получить список запросов асинхронной аналитики Свойство userId опущено в ответе. См. метод: организации.environments.queries.list .
API пользовательских отчетов API отчетов Свойства createdBy и lastModifiedBy были удалены из ответа. См. API отчетов .

Неподдерживаемые API Apigee Edge

В следующей таблице перечислены неподдерживаемые API Apigee Edge (которые не имеют эквивалентов API Apigee X).

Категория API Неподдерживаемые API Apigee Edge
API-мониторинг API не поддерживаются
API-прокси
  • Принудительно отменить развертывание прокси-сервера API
  • Получить зависимости npm
  • Управление модулями npm
Аудиты Используйте API ведения журнала Stackdriver
Кэшированные журналы API не поддерживаются
Компании API не поддерживаются
Приложения компании API не поддерживаются
Семейство корпоративных приложений API не поддерживаются
Ключи приложения компании API не поддерживаются
Сеансы отладки
  • Невозможно остановить сеансы трассировки
  • Невозможно удалить отдельные транзакции

Дополнительные сведения см. в разделе Различия с Trace .

Приложение для разработчиков Получить количество ресурсов API
Семейство приложений для разработчиков API не поддерживаются
Расширения API не поддерживаются
Хранилище ключей: хранилище доверенных сертификатов Проверка хранилища ключей или хранилища доверенных сертификатов
ЛДАП API не поддерживаются
Монетизация API не поддерживаются
ОАутентификация 2. API не поддерживаются
Политика API не поддерживаются
Файлы ресурсов
  • Область изменения прокси-сервера API
  • Объем организации
Смысл API не поддерживаются
Пользователи и роли пользователей Используйте API-интерфейсы Google Identity and Access Management (IAM), как описано в разделе «Управление пользователями, ролями и разрешениями с помощью API».
Виртуальные хосты API не поддерживаются

Apigee Edge для частного облака и гибрид Apigee

В следующей таблице сравниваются Apigee Edge для частного облака и гибрид Apigee:

Услуга Продукт или область функций Apigee
Apigee Edge для частного облака Апигей гибридный
Аналитика Серверы Qpid и Postgres Модуль сбора данных в плоскости выполнения использует Fluentd и UDCA (универсальный агент сбора данных) для сбора аналитики и передачи данных в UAP (унифицированную аналитическую платформу) в плоскости управления.
API-прокси-шлюз Процессор сообщений Процессор сообщений (MP) обрабатывает входящие запросы. MP реализуются как одно или несколько контейнерных приложений в плоскости выполнения.
Упорство Узел или кольцо Кассандры Cassandra обеспечивает постоянство функций KMS, KVM, квот и кэша.
Развертывание смотритель зоопарка Синхронизатор обеспечивает актуальность конфигураций прокси-сервера API, информации о среде и других данных между плоскостью управления и плоскостью среды выполнения.
Административный пользовательский интерфейс Пользовательский интерфейс Apigee Edge размещается на сервере управления. Пользовательский интерфейс Apigee размещается на плоскости управления.
Балансировка нагрузки Маршрутизатор Контроллер Istio Ingress передает запросы контейнерному приложению процессора сообщений (MP) в плоскости выполнения.
API Сервер управления Доступ к API Apigee X осуществляется через Management Server и MART . MART взаимодействует с локальным хранилищем данных Cassandra и служит поставщиком API для API Apigee X для доступа к объектам данных времени выполнения и управления ими.
Метрики Каждый компонент настроен с помощью JMX Управляется одним сервером Prometheus на кластер для всех служб.
,

Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация

В этом разделе описывается, чем Apigee X (иногда называемый просто «Apigee») отличается от Apigee Edge. Эта информация предназначена для существующих клиентов Apigee Edge, которые рассматривают возможность перехода на Apigee X.

Дополнительную информацию о функциях Apigee X см. в кратком описании функций Apigee X.

В следующей таблице перечислены продукты управления API Apigee, сравниваемые в этом разделе:

Продукт Где размещено Управляется
Apigee Edge для публичного облака Облако Апигея Апигей
Apigee Edge для частного облака Частный дата-центр клиента. Клиент
Апигей Икс Google Облако Апигей
Апигей гибридный И Google Cloud, и частный центр обработки данных клиента. Apigee управляет плоскостью управления, а клиент управляет плоскостью среды выполнения.

Сравнение функций Apigee Edge и Apigee X

В следующих разделах сравниваются функции публичного/частного облака Apigee Edge с доступностью функций в Apigee X и гибридной версии.

Обратите внимание, что ограничения Apigee X также отличаются от ограничений Apigee Edge .

Краткое изложение текущих различий в функциях

В следующей таблице описаны различия на уровне функций между Apigee X (и гибридом) и Apigee Edge для платформ публичного и частного облака.

Функция Apigee Edge Поддержка Apigee X и гибрида
Изменения API-прокси

Неизменяемый при развертывании

Активные проверки работоспособности Поддерживается для внешних MIG (которые используют виртуальные машины). Не поддерживается при использовании Private Service Connect. Информацию о типах маршрутизации см. в разделе Настройка маршрутизации .
Адаптер Apigee для Istio Устарело: вместо этого мы рекомендуем использовать адаптер Apigee для Envoy .
Компании и девелоперы

Существует похожее, но не идентичное решение. См. Использование групп приложений для организации владения приложениями .

CwC (код с конфигурацией)

Планируется

Развертывания
  • Асинхронные развертывания
  • Получение статуса развертывания зависит от того, когда в последний раз плоскость выполнения «регистрировалась» на плоскости управления.
Окружающая среда
  • Поддержка групп окружения
  • Самообслуживание через пользовательский интерфейс и API Apigee.
  • Больше гибкости в топологии обслуживания
  • Модуль MP может обслуживать только одну среду.

Для получения дополнительной информации см. Об окружающей среде и группах окружающей среды .

Размещенные цели

Пожалуйста, используйте функции Cloud Run или Cloud

HTTP/1.1 обработка имени заголовка Преобразует HTTP/1.1 Заголовок имен в нижний регистр при пересылке в бэкэнд. В Apigee Edge корпус имена поля заголовка сохраняется.
IAM Роли для мелкозернистого контроля доступа на основе ролей

Планируется

Jsonpath с использованием [@.length-x]

Использование [@.length-x] в экспрессии jsonpath не поддерживается в Apigee X. Спецификация jsonpath гласит, что выражения зависят от базового языка сценариев. length-x -это конструкция JavaScript, а не Java, и [@.length-x] не была реализована как часть спецификации. В Apigee X выражение [@.length-x] заменяется схемой индексации ( [-x] ).

Для этого примера:

{
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}

Ввод: $.books[@.length-1] возвращает {“name”: “B”} в Apigee Edge и возвращает [{“name”: “B”}] в Apigee x.

Ключевые магазины/доверительные магазины

На север управляется секретами Kubernetes

KVMS
  • Вы можете создать зашифрованные KVM с окружающей средой в пользовательском интерфейсе Apigee. KVM всегда зашифрованы. Вы не можете добавить, обновить или просматривать записи KVM в пользовательском интерфейсе.
  • Используйте private. Атрибут со всеми переменными при доступе к KVM с командой GET , чтобы скрыть информацию KVM в сеансе отладки (трассировки). Если private. Атрибут не используется, KVM все еще зашифрован; Тем не менее, информация KVM появится расшифрованная в сессии отладки), и никаких исключений не будет брошено.
  • Вы можете управлять записями KVM, используя API keyvaluemaps.entries или политику KeyValueMapoperations .
  • Вы можете использовать наборы свойств для некоторых из тех же вариантов использования, что и KVM. Смотрите, используя наборы свойств .
  • Элемент <MapName> позволяет политике KeyValueMapoperations определить, какую KVM использовать динамически, во время выполнения.

Для получения дополнительной информации о создании KVM в пользовательском интерфейсе см. Использование карт значений ключей . См. Также доступ к данным конфигурации для получения информации о том, как выбрать правильный механизм постоянства данных.

Microgateway Вместо этого мы рекомендуем использовать адаптер Apigee для Envoy .
Монетизация См. Различия с монетизацией
Node.js
  • Прокси API Node.js не поддерживаются.
  • Apigee рекомендует вам размещать приложения Node.js в качестве отдельных контейнеров в Kubernetes (тот же или другой кластер)
MTLS на север Поддерживается через Google Cloud Load Balancers. См. Apigee x Mutual TLS на север с использованием балансировщика нагрузки внешнего приложения .
Оаут Новая политика RevoekeoAuthv2 отозвана идентификатором конечного пользователя, идентификатором приложения или обоими. Эта политика заменяет API Apigee Edge, чтобы отозвать токены OAuth2.
Политики
  • Новая политика:
    • Политика AssertCondition : оценивает условное утверждение во время выполнения в потоках запроса или ответа.
    • Политика CORS : позволяет javaScript xmlhttprequest (XHR) вызовы, выполняемые на веб-странице, взаимодействовать с ресурсами из доменов неоригенов.
    • Политика DataCapture : заменяет политику StatisticsCollector.
    • Политика ExternalCallout : отправляет запросы GRPC на ваш сервер GRPC для реализации пользовательского поведения, которое не поддерживается политиками APIGEE.
    • Политика GraphQL : Parses GraphQL полезные нагрузки в переменные потока сообщений, проверяет запросы GraphQL по схеме или обоим.
    • PublishMessages Policy : публикует информацию о прокси -посте API Proxy в пабе Google Cloud Pub/Sub Topic.
    • Политика RevokeoAuthv2 : отозваны по идентификатору пользователя, идентификатором приложения или обоим.
    • Политика Tracecapture : добавляет дополнительные переменные в данные трассировки вашего времени выполнения Apigee.
  • Политика не поддерживается:
    • Политика статистических данных (заменена новой политикой обработки данных)
  • Измененные политики:
Причинафраза Не поддерживается.
Ресурсы Не может использовать ресурсы на уровне организации
Роли и разрешения
  • Управляется службой IAM Console Google Cloud Console
  • Доступны некоторые кураторские роли.
  • Вы можете создавать пользовательские роли, которые могут включать другие разрешения Google Cloud

Для получения дополнительной информации см. Пользователи и роли .

Смысл Используйте расширенную безопасность API .
SOAP Services в The Build A Proxy Wizard Не поддерживается. См. WSDL2apigee , проект с открытым исходным кодом, который предоставляет утилиты для мыла для использования с Apigee.
Сессии трассировки/отладки Смотрите различия с трассировкой .
Виртуальные хосты

Для гибрида Apigee:

  • Вход реализуется через Apigee Ingress Gateway.
  • Ключи и СЕРТ развернуты непосредственно в Kubernetes.

Для Apigee x:

  • Каждый экземпляр раскрывает конечную точку HTTPS через самореагированный сертификат. CA для сертификата может быть загружена, запросив орг.

Различия с трассировкой

В следующей таблице сравниваются различия в том, как работает Trace в Apigee X и Hybrid и Apigee Edge Cloud:

Особенность Apigee Edge Cloud Apigee X и гибрид
Своевременность В реальном времени; синхронный Небольшая задержка; асинхронный
Имя сеанса/идентификатор Принимает имя сеанса от пользователя Не принимает имя сеанса от пользователя
Фильтры Основная поддержка фильтра, такая как фильтрация параметров заголовка и запроса Поддержка сложной логики фильтрации, включая как, так и или логические операции. Доступ к любой переменной потока, упомянутой в ссылке переменных потока . Синтаксис такой же, как и в условиях, как показано в эталонном эталоне .
Тайм -аут сессии

Определяет длину сеанса отладки, а также как долго сохраняются данные.

Значение по умолчанию составляет 20 минут при начале вызовов API и 10 минут при начале пользовательского интерфейса.

Определяет только длину сеанса отладки. Начальная точка - это когда процессор сообщений получает запрос на работу в режиме отладки.

Значение по умолчанию составляет 5 минут, если сеанс был инициирован с API и 10 минут, если он был инициирован в пользовательском интерфейсе.

Данные сохраняются в течение 24 часов, прежде чем гибрид автоматически удаляет их.

Достоверность сеанса

Продолжительность времени, в течение которого запрос на создание сеанса действителен. Если сеанс отладки не начинается в течение этого количества времени, синхронизаторы могут игнорировать запрос на создание сеанса. Обязательно сохраните синхронизацию ваших синхронизаторов, как описано в предпосылке .
Счет запросов трассировки Максимум 20 на процессор сообщений По умолчанию 10 за процессор сообщений; Максимум - 15.
API Apigee Edge Cloud Апигей x
APIGEE X обнажает API API сеанса и отладки DENAGE API , но не поддерживает следующее через API APIS APIGEE:
Прекратите сессию отладки

Удалить конкретные транзакции

Различия с монетизацией

В следующей таблице содержится сравнение ключевых особенностей между монетизацией края апигей и монетизацией Apigee X.

Монетизация Apigee Edge Apigee x/гибридная монетизация
Планы тарифов связаны с пучками продукта API, которые могут быть прикреплены к нескольким продуктам API Планы тарифов связаны с продуктами API (отношения один на один)
Планы закупок разработчиков приложений Разработчики приложений приобретают продукты API
Квоты управляются на уровне прокси API Квоты управляются на уровне продукта API (бизнес -уровень)
Опубликованные планы ставок могут быть истекли только истек; они не могут быть отредактированы или удалены Опубликованные планы ставок могут быть истекли, отредактированы, перенесены на проект или удалены
Комплексная конфигурация (без мастера или инструмента предварительного просмотра) Упрощенная конфигурация планов тарифов с использованием мастера и инструмента предварительного просмотра
MonetizationLimitsCheck Blocs Blocs Access после обработки первого вызова API, если разработчик приложений не приобрел подписку MonetizationLimitsCheck политики блокирует доступ немедленно, если разработчик приложений не приобрел подписку или превышает квоту
Данные монетизации для транзакций могут быть получены с использованием пользовательских переменных в политике записи транзакций. Apigee автоматически захватывает данные монетизации, и данные монетизации для транзакций могут быть переопределены с использованием политики обработки данных. См. Данные монетизации захвата для информации.
Учетные записи предоплаты и постоплаты могут быть настроены как для разработчиков, так и для планов ставок. Учетные записи предоплаты и постоплаты могут быть настроены только для разработчиков.

Какие функции Apigee Edge не поддерживаются в Apigee X?

Google не планирует поддерживать следующие функции:

  • Экстраральные наращивания Apigee Edge
  • Specification Stepication Store
  • API для поиска или отмены токенов доступа OAuth (потому что токены хэшируются)
  • OAuth v1 или Oauth oauthv1.0a Политика
  • Trireme (Eol'd 10/10/2019)
  • Заголовки, префиксированные "x-apigee-", не поддерживаются в Apigee X и лишены запросов и ответов перед отправкой на цели и клиентов.
  • Свойство Apigee Edge proxy_read_timeout не поддерживается в Apigee X. См. Настройка io.timeout.millis и Api.Timeout для соответствующих настроек тайм -аута Apigee X.

Сравнение API

В целом, большинство API Apigee Edge имеют эквиваленты API API. В этом разделе предусмотрена:

Сводка изменений с использованием API

В следующем перечислены изменения в поведении во всех API APIS APIGEE по сравнению с API APIGEE EDGE.

Поведение Apigee Edge Apis Apigee x apis
Базовый домен api.enterprise.apigee.com apigee.googleapis.com
Типы мультимедиа application/json
application/xml		 application/json
Аутентификация OAuth2, Saml, Basic OAuth2
Временные метки в ключах int64 Формат 
{
  "createdAt": 1234,
  "lastModifiedAt": 5678
}
String формат 
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
Структура expand=false параметр запроса 
[
        "helloworld",
        "weather"
      ]
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
Параметры запроса, префиксированные подчеркиванием Поддерживается ( _optimal=true ) Не поддерживается ( optimal=true )
Свойства в полезных нагрузках:
  • created_by
  • modified_by
  • self
 Поддерживается Не поддерживается
Значения по умолчанию в полезных нагрузках Включено Не включено
Структура обработки ошибок 
{
        "code": "...",
        "message": "..",
        "contexts": []
      }
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
Ответ по удалению кэша Возврат: 200 OK и детали кеша Возврат: 204 No Content
Кэш -операции API Список , создавать , получить , обновить , удалять , очистить все и очистить параметры. Список и удалить только. Долговечный кэш L1 автоматически создается при развертывании прокси API. Для получения дополнительной информации см. Кэш Внутренства .

Различия между API -интерфейсом Apigee Edge и Apigee x Metrics

Сводка изменений с использованием API перечисляет общие различия между API API APIGEE и API API APIGEE. В следующей таблице приведены конкретные различия для API -интерфейсов метрик:

Особенность Apigee Edge Apis Apigee x apis
API конечная точка api.enterprise.apigee.com apigee.googleapis.com
Ежедневные аналитические электронные письма Не поддерживается API
Асинхронный список запросов API Получите список асинхронных аналитических запросов Свойство userId опущено из ответа. См. Метод: Organizations.Environments.Queries.List .
Пользовательский отчет API Отчеты API Свойства createdBy и lastModifiedBy были удалены из ответа. См. Отчеты API .

Неподдерживаемые API APIGEE EDGE

В следующей таблице приведены неподдерживаемые API Apigee Edge (которые не имеют эквивалентов API API APIGEE).

Категория API Неподдерживаемые API APIGEE EDGE
Мониторинг API Не поддерживается API
API -прокси
  • Force indploy API -прокси
  • Получить NPM -зависимости
  • Управление модулями NPM
Аудиты Используйте API журналирования StackDriver
Кэшированные журналы Не поддерживается API
Компании Не поддерживается API
Приложения компании Не поддерживается API
Семья приложений компании Не поддерживается API
Ключи приложения компании Не поддерживается API
Отладки
  • Не могу остановить сеансы трассировки
  • Не удается удалить отдельные транзакции

Для получения дополнительной информации см. Различия с трассировкой .

Приложение разработчика Получите подсчет ресурсов API
Семья приложений для разработчиков Не поддерживается API
Расширения Не поддерживается API
Ключевой магазин: TrustStore Протестируйте магазин ключей или Truststore
LDAP Не поддерживается API
Монетизация Не поддерживается API
OAuth v2 Не поддерживается API
Политики Не поддерживается API
Файлы ресурсов
  • API Proxy Revision Scope
  • Организация
Смысл Не поддерживается API
Пользователи и пользовательские роли Используйте API-интерфейсы Google Identity and Management (IAM), как описано в управлении пользователями, ролями и разрешениями с использованием APIS
Виртуальные хосты Не поддерживается API

Apigee Edge для частного облака против гибрида Apigee

Следующая таблица сравнивает Edge Apigee для частного облака и гибрида Apigee:

Услуга Продукт или область функции Apigee
Apigee Edge для частного облака Апигей гибрид
Аналитика QPID и Postgres Servers POD сбора данных в плоскости времени выполнения использует FluentD и UDCA (универсальный агент сбора данных) для сбора аналитики и подачи данных в UAP (Unified Analytics Platform) в плоскости управления.
API Proxy Gateway Процессор сообщений Процессор сообщений (MP) процесс входящих запросов. Депутаты реализованы в виде одного или нескольких приложений для контейнеров в плоскости времени выполнения.
Упорство Узел или кольцо Cassandra Кассандра обеспечивает постоянство для функций KMS, KVM, квоты и кеша.
Развертывание Зокепер Синхронизатор гарантирует, что конфигурации прокси API, информация об окружающей среде и другие данные сохраняются в курсе плоскости управления и плоскостью управления.
Административный пользовательский интерфейс Пользовательский интерфейс Apigee Edge размещен на сервере управления Пользовательский интерфейс Apigee размещен на самолете управления.
Балансировка нагрузки Маршрутизатор Истио -входной контроллер запрашивает запросы в контейнерное приложение процессора сообщений (MP) в плоскости времени выполнения.
Апис Управление сервер API API APIGE доступны через сервер управления и Mart . Март взаимодействует с местным данных Cassandra Datastore и служит поставщиком API для API APIS APIGE для доступа и управления объектами данных времени выполнения.
Метрики Каждый компонент настроен с JMX Управляется одним сервером Prometheus на кластер для всех служб.
,

Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee x . информация

Эта тема описывает, как Apigee x (иногда также называется просто «апигей») отличается от Apigee Edge. Эта информация предназначена для существующих клиентов Apigee Edge, которые рассматривают вопрос о переходе в Apigee X.

Для получения дополнительной информации о функциях Apigee x см. Резюме функции Apigee x .

В следующей таблице перечислены продукты управления API API, которые сравниваются в этой теме:

Продукт Где размещено Управляется
Apigee Edge для общественного облака Облако Апиги Апигей
Apigee Edge для частного облака Частный центр обработки данных клиента. Клиент
Апигей x Google Cloud Апигей
Апигей гибрид И Google Cloud, и частный центр обработки данных клиента Apigee управляет самолетом управления, и клиент управляет самолетом времени выполнения.

Apigee Edge с Apigee x Сравнение функций

Следующие разделы сравнивают функции Apigee Edge Public/Private Cloud с доступностью функций в Apigee X и Hybrid.

Обратите внимание, что ограничения Apigee X также отличаются от пределов края Apigee .

Сводка текущих различий в функциях

В следующей таблице описываются различия на уровне функций между Apigee X (и Hybrid) и Edge Apigee для общественных и частных облачных платформ.

Функция Apigee Edge Поддержка в Apigee X и Hybrid
API -прокси -ревизии

Неизменно при развертывании

Активные проверки здоровья Поддерживается для внешних MIG (которые используют виртуальные машины). Не поддерживается при использовании частного обслуживания Connect. Для получения информации о типах маршрутизации см. Настройку маршрутизации .
Адаптер Apigee для iStio Установилось: мы рекомендуем вам использовать адаптер Apigee для посланника .
Компании и разработчики

Подобное, но не идентичное решение доступно. См. Использование AppGroups для организации владения приложениями .

CWC (код с конфигурацией)

Планируется

Развертывания
  • Асинхронные развертывания
  • Получение статуса развертывания основано на последнем случае, когда плоскость выполнения «проверка» с плоскостью управления
Среда
  • Поддержка групп окружающей среды
  • Самообслуживание через пользовательский интерфейс и APIS Apigee
  • Больше гибкости в топологии служить топологии
  • POD MP может обслуживать только одну среду

Для получения дополнительной информации см. Об окружающей среде и группах окружающей среды .

Размещенные цели

Пожалуйста, используйте функции Cloud Run или Cloud

HTTP/1.1 обработка имени заголовка Преобразует HTTP/1.1 Заголовок имен в нижний регистр при пересылке в бэкэнд. В Apigee Edge корпус имена поля заголовка сохраняется.
IAM Роли для мелкозернистого контроля доступа на основе ролей

Планируется

Jsonpath с использованием [@.length-x]

Использование [@.length-x] в экспрессии jsonpath не поддерживается в Apigee X. Спецификация jsonpath гласит, что выражения зависят от базового языка сценариев. length-x -это конструкция JavaScript, а не Java, и [@.length-x] не была реализована как часть спецификации. В Apigee X выражение [@.length-x] заменяется схемой индексации ( [-x] ).

Для этого примера:

{
    "books": [
      {
        "name": "A",
      },
      {
        "name": "B",
      }
    ]
}

Ввод: $.books[@.length-1] возвращает {“name”: “B”} в Apigee Edge и возвращает [{“name”: “B”}] в Apigee x.

Ключевые магазины/доверительные магазины

На север управляется секретами Kubernetes

KVMS
  • Вы можете создать зашифрованные KVM с окружающей средой в пользовательском интерфейсе Apigee. KVM всегда зашифрованы. Вы не можете добавить, обновить или просматривать записи KVM в пользовательском интерфейсе.
  • Используйте private. Атрибут со всеми переменными при доступе к KVM с командой GET , чтобы скрыть информацию KVM в сеансе отладки (трассировки). Если private. Атрибут не используется, KVM все еще зашифрован; Тем не менее, информация KVM появится расшифрованная в сессии отладки), и никаких исключений не будет брошено.
  • Вы можете управлять записями KVM, используя API keyvaluemaps.entries или политику KeyValueMapoperations .
  • Вы можете использовать наборы свойств для некоторых из тех же вариантов использования, что и KVM. Смотрите, используя наборы свойств .
  • Элемент <MapName> позволяет политике KeyValueMapoperations определить, какую KVM использовать динамически, во время выполнения.

Для получения дополнительной информации о создании KVM в пользовательском интерфейсе см. Использование карт значений ключей . См. Также доступ к данным конфигурации для получения информации о том, как выбрать правильный механизм постоянства данных.

Microgateway Вместо этого мы рекомендуем использовать адаптер Apigee для Envoy .
Монетизация См. Различия с монетизацией
Node.js
  • Прокси API Node.js не поддерживаются.
  • Apigee рекомендует вам размещать приложения Node.js в качестве отдельных контейнеров в Kubernetes (тот же или другой кластер)
MTLS на север Поддерживается через Google Cloud Load Balancers. См. Apigee x Mutual TLS на север с использованием балансировщика нагрузки внешнего приложения .
Оаут Новая политика RevoekeoAuthv2 отозвана идентификатором конечного пользователя, идентификатором приложения или обоими. Эта политика заменяет API Apigee Edge, чтобы отозвать токены OAuth2.
Политики
  • Новая политика:
    • Политика AssertCondition : оценивает условное утверждение во время выполнения в потоках запроса или ответа.
    • Политика CORS : позволяет javaScript xmlhttprequest (XHR) вызовы, выполняемые на веб-странице, взаимодействовать с ресурсами из доменов неоригенов.
    • Политика DataCapture : заменяет политику StatisticsCollector.
    • Политика ExternalCallout : отправляет запросы GRPC на ваш сервер GRPC для реализации пользовательского поведения, которое не поддерживается политиками APIGEE.
    • Политика GraphQL : Parses GraphQL полезные нагрузки в переменные потока сообщений, проверяет запросы GraphQL по схеме или обоим.
    • PublishMessages Policy : публикует информацию о прокси -посте API Proxy в пабе Google Cloud Pub/Sub Topic.
    • Политика RevokeoAuthv2 : отозваны по идентификатору пользователя, идентификатором приложения или обоим.
    • Политика Tracecapture : добавляет дополнительные переменные в данные трассировки вашего времени выполнения Apigee.
  • Политика не поддерживается:
    • Политика статистических данных (заменена новой политикой обработки данных)
  • Измененные политики:
Причинафраза Не поддерживается.
Ресурсы Не может использовать ресурсы на уровне организации
Роли и разрешения
  • Управляется службой IAM Console Google Cloud Console
  • Доступны некоторые кураторские роли.
  • Вы можете создавать пользовательские роли, которые могут включать другие разрешения Google Cloud

Для получения дополнительной информации см. Пользователи и роли .

Смысл Используйте расширенную безопасность API .
SOAP Services в The Build A Proxy Wizard Не поддерживается. См. WSDL2apigee , проект с открытым исходным кодом, который предоставляет утилиты для мыла для использования с Apigee.
Сессии трассировки/отладки Смотрите различия с трассировкой .
Виртуальные хосты

Для гибрида Apigee:

  • Вход реализуется через Apigee Ingress Gateway.
  • Ключи и СЕРТ развернуты непосредственно в Kubernetes.

Для Apigee x:

  • Каждый экземпляр раскрывает конечную точку HTTPS через самореагированный сертификат. CA для сертификата может быть загружена, запросив орг.

Различия с трассировкой

В следующей таблице сравниваются различия в том, как работает Trace в Apigee X и Hybrid и Apigee Edge Cloud:

Особенность Apigee Edge Cloud Apigee X и гибрид
Своевременность В реальном времени; синхронный Небольшая задержка; асинхронный
Имя сеанса/идентификатор Принимает имя сеанса от пользователя Не принимает имя сеанса от пользователя
Фильтры Основная поддержка фильтра, такая как фильтрация параметров заголовка и запроса Поддержка сложной логики фильтрации, включая как, так и или логические операции. Доступ к любой переменной потока, упомянутой в ссылке переменных потока . Синтаксис такой же, как и в условиях, как показано в эталонном эталоне .
Тайм -аут сессии

Определяет длину сеанса отладки, а также как долго сохраняются данные.

Значение по умолчанию составляет 20 минут при начале вызовов API и 10 минут при начале пользовательского интерфейса.

Определяет только длину сеанса отладки. Начальная точка - это когда процессор сообщений получает запрос на работу в режиме отладки.

Значение по умолчанию составляет 5 минут, если сеанс был инициирован с API и 10 минут, если он был инициирован в пользовательском интерфейсе.

Данные сохраняются в течение 24 часов, прежде чем гибрид автоматически удаляет их.

Достоверность сеанса

Продолжительность времени, в течение которого запрос на создание сеанса действителен. Если сеанс отладки не начинается в течение этого количества времени, синхронизаторы могут игнорировать запрос на создание сеанса. Обязательно сохраните синхронизацию ваших синхронизаторов, как описано в предпосылке .
Счет запросов трассировки Максимум 20 на процессор сообщений По умолчанию 10 за процессор сообщений; Максимум - 15.
API Apigee Edge Cloud Апигей x
APIGEE X обнажает API API сеанса и отладки DENAGE API , но не поддерживает следующее через API APIS APIGEE:
Прекратите сессию отладки

Удалить конкретные транзакции

Различия с монетизацией

В следующей таблице содержится сравнение ключевых особенностей между монетизацией края апигей и монетизацией Apigee X.

Монетизация Apigee Edge Apigee x/гибридная монетизация
Планы тарифов связаны с пучками продукта API, которые могут быть прикреплены к нескольким продуктам API Планы тарифов связаны с продуктами API (отношения один на один)
Планы закупок разработчиков приложений Разработчики приложений приобретают продукты API
Квоты управляются на уровне прокси API Квоты управляются на уровне продукта API (бизнес -уровень)
Опубликованные планы ставок могут быть истекли только истек; они не могут быть отредактированы или удалены Опубликованные планы ставок могут быть истекли, отредактированы, перенесены на проект или удалены
Комплексная конфигурация (без мастера или инструмента предварительного просмотра) Упрощенная конфигурация планов тарифов с использованием мастера и инструмента предварительного просмотра
MonetizationLimitsCheck Blocs Blocs Access после обработки первого вызова API, если разработчик приложений не приобрел подписку MonetizationLimitsCheck политики блокирует доступ немедленно, если разработчик приложений не приобрел подписку или превышает квоту
Данные монетизации для транзакций могут быть получены с использованием пользовательских переменных в политике записи транзакций. Apigee автоматически захватывает данные монетизации, и данные монетизации для транзакций могут быть переопределены с использованием политики обработки данных. См. Данные монетизации захвата для информации.
Учетные записи предоплаты и постоплаты могут быть настроены как для разработчиков, так и для планов ставок. Учетные записи предоплаты и постоплаты могут быть настроены только для разработчиков.

Какие функции Apigee Edge не поддерживаются в Apigee X?

Google не планирует поддерживать следующие функции:

  • Экстраральные наращивания Apigee Edge
  • Specification Stepication Store
  • API для поиска или отмены токенов доступа OAuth (потому что токены хэшируются)
  • OAuth v1 или Oauth oauthv1.0a Политика
  • Trireme (Eol'd 10/10/2019)
  • Заголовки, префиксированные "x-apigee-", не поддерживаются в Apigee X и лишены запросов и ответов перед отправкой на цели и клиентов.
  • Свойство Apigee Edge proxy_read_timeout не поддерживается в Apigee X. См. Настройка io.timeout.millis и Api.Timeout для соответствующих настроек тайм -аута Apigee X.

Сравнение API

В целом, большинство API Apigee Edge имеют эквиваленты API API. В этом разделе предусмотрена:

Сводка изменений с использованием API

В следующем перечислены изменения в поведении во всех API APIS APIGEE по сравнению с API APIGEE EDGE.

Поведение Apigee Edge Apis Apigee x apis
Базовый домен api.enterprise.apigee.com apigee.googleapis.com
Типы мультимедиа application/json
application/xml		 application/json
Аутентификация OAuth2, Saml, Basic OAuth2
Временные метки в ключах int64 Формат 
{
  "createdAt": 1234,
  "lastModifiedAt": 5678
}
String формат 
{
  "createdAt": "1234",
  "lastModifiedAt": "5678"
}
Структура expand=false параметр запроса 
[
        "helloworld",
        "weather"
      ]
{
  "proxies": [
    {
      "name": "helloworld"
    },
    {
      "name": "weather"
    }
  ]
}
Параметры запроса, префиксированные подчеркиванием Поддерживается ( _optimal=true ) Не поддерживается ( optimal=true )
Свойства в полезных нагрузках:
  • created_by
  • modified_by
  • self
 Поддерживается Не поддерживается
Значения по умолчанию в полезных нагрузках Включен Не включено
Структура обработки ошибок 
{
        "code": "...",
        "message": "..",
        "contexts": []
      }
{
  "error": {
    "code": 409,
    "message": "...",
    "status": "ABORTED",
    "details": [...]
  }
}
Ответ по удалению кэша Возврат: 200 OK и детали кеша Возврат: 204 No Content
Кэш -операции API Список , создавать , получить , обновить , удалять , очистить все и очистить параметры. Список и удалить только. Долговечный кэш L1 автоматически создается при развертывании прокси API. Для получения дополнительной информации см. Кэш Внутренства .

Различия между API -интерфейсом Apigee Edge и Apigee x Metrics

Сводка изменений с использованием API перечисляет общие различия между API API APIGEE и API API APIGEE. В следующей таблице приведены конкретные различия для API -интерфейсов метрик:

Особенность Apigee Edge Apis Apigee x apis
API конечная точка api.enterprise.apigee.com apigee.googleapis.com
Ежедневные аналитические электронные письма Не поддерживается API
Асинхронный список запросов API Получите список асинхронных аналитических запросов Свойство userId опущено из ответа. См. Метод: Organizations.Environments.Queries.List .
Пользовательский отчет API Отчеты API Свойства createdBy и lastModifiedBy были удалены из ответа. См. Отчеты API .

Неподдерживаемые API APIGEE EDGE

В следующей таблице приведены неподдерживаемые API Apigee Edge (которые не имеют эквивалентов API API APIGEE).

Категория API Неподдерживаемые API APIGEE EDGE
Мониторинг API Не поддерживается API
API -прокси
  • Force indploy API -прокси
  • Получить NPM -зависимости
  • Управление модулями NPM
Аудиты Используйте API журналирования StackDriver
Кэшированные журналы Не поддерживается API
Компании Не поддерживается API
Приложения компании Не поддерживается API
Семья приложений компании Не поддерживается API
Ключи приложения компании Не поддерживается API
Отладки
  • Не могу остановить сеансы трассировки
  • Не удается удалить отдельные транзакции

Для получения дополнительной информации см. Различия с трассировкой .

Приложение разработчика Получите подсчет ресурсов API
Семья приложений для разработчиков Не поддерживается API
Расширения Не поддерживается API
Ключевой магазин: TrustStore Протестируйте магазин ключей или Truststore
LDAP Не поддерживается API
Монетизация Не поддерживается API
OAuth v2 Не поддерживается API
Политики Не поддерживается API
Файлы ресурсов
  • API Proxy Revision Scope
  • Организация
Смысл Не поддерживается API
Пользователи и пользовательские роли Используйте API-интерфейсы Google Identity and Management (IAM), как описано в управлении пользователями, ролями и разрешениями с использованием APIS
Виртуальные хосты Не поддерживается API

Apigee Edge для частного облака против гибрида Apigee

Следующая таблица сравнивает Edge Apigee для частного облака и гибрида Apigee:

Услуга Продукт или область функции Apigee
Apigee Edge для частного облака Апигей гибрид
Аналитика QPID и Postgres Servers POD сбора данных в плоскости времени выполнения использует FluentD и UDCA (универсальный агент сбора данных) для сбора аналитики и подачи данных в UAP (Unified Analytics Platform) в плоскости управления.
API Proxy Gateway Процессор сообщений Процессор сообщений (MP) процесс входящих запросов. Депутаты реализованы в виде одного или нескольких приложений для контейнеров в плоскости времени выполнения.
Упорство Узел или кольцо Cassandra Кассандра обеспечивает постоянство для функций KMS, KVM, квоты и кеша.
Развертывание Зокепер Синхронизатор гарантирует, что конфигурации прокси API, информация об окружающей среде и другие данные сохраняются в курсе плоскости управления и плоскостью управления.
Административный пользовательский интерфейс Пользовательский интерфейс Apigee Edge размещен на сервере управления Пользовательский интерфейс Apigee размещен на самолете управления.
Балансировка нагрузки Маршрутизатор Истио -входной контроллер запрашивает запросы в контейнерное приложение процессора сообщений (MP) в плоскости времени выполнения.
Апис Управление сервер API API APIGE доступны через сервер управления и Mart . Март взаимодействует с местным данных Cassandra Datastore и служит поставщиком API для API APIS APIGE для доступа и управления объектами данных времени выполнения.
Метрики Каждый компонент настроен с JMX Управляется одним сервером Prometheus на кластер для всех служб.