Вы просматриваете документацию Apigee Edge .
Перейдите к документации Apigee X. информация
Как текущий клиент Apigee Edge, вы можете перенести свою установку на Apigee X , чтобы воспользоваться новыми возможностями или доступностью в других регионах.
На этой странице описаны антишаблоны в вашей конфигурации, которые вам необходимо устранить перед переходом на Apigee X, а также другие изменения в поведении, о которых вам следует знать перед переходом.
Более широкий список антипаттернов Apigee Edge описывает методы использования, которых следует избегать в любом случае. На этой странице описаны конкретные нерекомендуемые методы использования, которые блокируют миграцию. Решите их сейчас, чтобы предотвратить проблемы при переходе на Apigee X.
Приложения без продуктов API | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
Существуют приложения без продуктов API. Разница между Apigee Edge и Apigee X:
| Нет. | Решение: приложения без продуктов API.Свяжите все учетные данные приложения хотя бы с одним продуктом API. Дополнительные сведения о том, как это сделать, см. в разделе Регистрация приложений и управление ключами API . Самый простой способ — назначить каждому приложению доступ ко всем продуктам API. Это будет эквивалент того, что возможно в Apigee Edge. Задача будет заключаться в том, что если вы хотите использовать подход с «наименьшими привилегиями», вам нужно будет определить минимальный список продуктов API, к которым должны иметь доступ все учетные данные приложения. Вы можете проанализировать это с помощью отчетов Apigee Edge Analytics на основе идентификатора клиента. | ||||||||||||||||||||||
Кэш без срока действия | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
Кэш(ы) не имеют срока годности. Разница между Apigee Edge и Apigee X:
| Нет | Решение: Кэш без срока действия.Установите срок действия для всех кешей. | ||||||||||||||||||||||
Выражения фильтра JSONPath для неопределенных путей | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
Для неопределенных путей запрос результата выражений фильтра не является частью спецификации JSONPath. См. https://goessner.net/articles/JsonPath/ . Разница между Apigee Edge и Apigee X: При навигации по этому примеру структуры { "books": [ { "name": "A", }, { "name": "B", } ] } С выражением
С выражением
| Да | Решение: выражения фильтра JSONPath для неопределенных путей.Найдите и замените затронутые запросы. | ||||||||||||||||||||||
Выражения JSONPath для отсутствующих индексов | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
Выражения JSONPath с отсутствующим индексом ведут себя по-разному в Apigee X и Apigee Edge. Apigee X возвращает ошибку Разница между Apigee Edge и Apigee X: При навигации по этому примеру структуры { "books": [ { "name": "A", }, { "name": "B", } ] } С помощью выражения
| Да | Решение: выражения JSONPath для индексов, которые отсутствуют.Найдите и замените затронутые запросы. | ||||||||||||||||||||||
Выражения JSONPath с индексом массива, не возвращающие объект массива | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
Выражения JSONPath с индексом массива или срезами возвращают объект массива в Apigee X. Разница между Apigee Edge и Apigee X: При навигации по этому примеру структуры { "books": [ { "name": "A", }, { "name": "B", } ] } С помощью выражения
С помощью выражения
С помощью выражения
| Да | Решение: выражения JSONPath с индексом массива не возвращают объект массива.Найдите и замените выражения, которые могут возвращать другие результаты после обновления. | ||||||||||||||||||||||
Ограничения на имя хранилища ключей | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
Имена хранилищ ключей Apigee X могут содержать только буквы, цифры и дефисы. Имена хранилищ ключей Edge не налагают этих ограничений. | Нет | Решение: ограничения на имя хранилища ключей.Проверьте имена хранилищ ключей и при необходимости обновите имена, удалив неподдерживаемые символы. | ||||||||||||||||||||||
Для прокси API развернуто несколько базовых путей. | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
В среде развертывается несколько версий прокси-сервера API, и каждая версия имеет свой базовый путь. Разница между Apigee Edge и Apigee X:
| Нет | Решение: для прокси-сервера API развернуто несколько базовых путей.Обновите все пакеты, чтобы в среде была развернута только одна версия пакета, независимо от базового пути. | ||||||||||||||||||||||
Несовместимые HTTP-сообщения | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
Клиенты или прокси-сервер API отправляют сообщения (запросы или ответы), не соответствующие стандарту HTTP. Например, недопустимые имена заголовков, дублирование в некоторых запрещенных заголовках и т. д. Вы не можете перейти на Apigee X, если при выполнении вашего API имеется одна или несколько из следующих ошибок:
| Да, возможно. | Решение: несовместимые HTTP-сообщения.Вы должны исправить все ошибки в протоколах HTTP перед переходом на Apigee X. Если ошибка возникает в клиентском приложении, вы должны попросить разработчика клиентского приложения исправить проблему. | ||||||||||||||||||||||
Недопустимый срок действия токена OAuth 2.0. | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
Срок действия токена OAuth 2.0 выходит за пределы установленного диапазона. Разница между Apigee Edge и Apigee X:
| Нет | Решение: срок действия токена OAuth 2.0 недействителен. Используйте политику OAuthV2 и укажите время истечения срока действия в | ||||||||||||||||||||||
Превышен лимит продукта | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
Конфигурация Apigee Edge не соответствует определенным ограничениям продукта . Некоторые ограничения продукта, которые задокументированы, но не применяются в Apigee Edge, применяются и в Apigee X. | Нет | Решение: превышены ограничения продукта.Исправьте любое использование, превышающее ограничения продукта , перед переходом на Apigee X. | ||||||||||||||||||||||
Политики ServiceCallout со спецификаторами соединения конечной точки и целевого пути. | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
В политике ServiceCallout элемент Apigee Edge документирует это требование, но не обеспечивает его соблюдение. Apigee X прекращает обработку, если обнаруживает | Нет | Решение: политики ServiceCallout со спецификаторами подключения как к конечной точке, так и к целевому пути. Проверьте конфигурации политики ServiceCallout и удалите все конфигурации | ||||||||||||||||||||||
Ограничения на имя целевого сервера | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
Имена целевых серверов Apigee X могут содержать только буквы, цифры, дефисы и точки. Имена пограничных целевых серверов не налагают этих ограничений. | Нет | Решение: ограничения на имя целевого сервера.Проверьте имена целевых серверов и при необходимости обновите имена, удалив неподдерживаемые символы. | ||||||||||||||||||||||
Пробный сертификат на виртуальном хосте | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
Один или несколько виртуальных хостов используют сертификат «бесплатной пробной версии», предоставленный Apigee. Это заставляет виртуальный хост отвечать на запросы в таких доменах, как Разница между Apigee Edge и Apigee X:
| Да | Решение: пробный сертификат на виртуальном хосте.Вы должны настроить свой собственный домен и соответствующим образом предоставить сертификаты. Любое клиентское приложение, которое зависит от устаревшего имени домена в форме | ||||||||||||||||||||||
Неразрешенный DNS | ||||||||||||||||||||||||
Краткое содержание | Требуются изменения на стороне клиента? | Разрешение | ||||||||||||||||||||||
Целевые конечные точки имеют неразрешенные доменные имена. Разница между Apigee Edge и Apigee X:
| Нет | Решение: неразрешенный DNS.Обновите целевую конечную точку, указав допустимое имя домена. |