16.08.17 - Apigee Edge для общедоступного облака: примечания к выпуску

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

30 августа 2016 г. мы выпустили новую версию Apigee Edge для общедоступного облака.

Новые функции и обновления

Ниже перечислены новые функции и изменения в этом выпуске.

Полезные нагрузки JSON в сообщениях Assign Message и Raise Fault

Благодаря этому улучшению вам не придется использовать обходные пути, чтобы обеспечить правильное форматирование сообщений JSON, а переменные можно будет указывать в фигурных скобках, не создавая недопустимый JSON. Например, следующий код вставляет значение message.content в сообщение JSON:

<Payload contentType="application/json">{"message" : "{message.content}"}</Payload>

Если вы использовали обходной путь, ваш код продолжит работать как есть. Вы также можете использовать variablePrefix и variableSuffix вместо фигурных скобок, чтобы указать переменные.

Ознакомьтесь с элементом <Set><Payload> в справочной документации по правилу Assign Message и правилу Raise Fault. (APIRT-1160)

Улучшения правил преобразования XML в JSON

Правила преобразования XML в JSON были улучшены и теперь поддерживают следующие возможности: Вы можете настроить правило так, чтобы:

• Некоторые элементы XML при преобразовании будут рассматриваться как массивы, и их значения в документе JSON будут заключены в квадратные скобки [ ].
• Удалять уровни иерархии XML-документа в конечном документе JSON.

Подробнее о правилах преобразования XML в JSON… (APIRT-1144)

Несколько подстановочных знаков в путях ресурсов API Product

При определении путей к ресурсам в продукте API можно использовать подстановочные знаки в нескольких местах пути к ресурсу. Например, /team/*/invoices/** позволяет вызывать API с любым значением после /team и любыми путями к ресурсам после invoices/. Разрешенный URI в вызове API будет выглядеть как proxyBasePath/team/finance/invoices/company/a.

Если после этого выпуска пути к ресурсам существующих продуктов API перестанут работать должным образом, задайте для организации следующее свойство, чтобы вернуться к предыдущему поведению: features.enableStandardWildCardMatchForAPIProductResources = true

(MGMT-3273)

Функции шифрования в JavaScript

Для создания, получения и обновления следующих хеш-объектов доступны новые высокопроизводительные функции JavaScript crypto: MD5, SHA-1, SHA256, SHA512. Объект crypto также позволяет получить дату в разных форматах. Подробнее об объектной модели JavaScript… (APIRT-2886)

Проверка версии JAR-файла уточнения Java

При загрузке ресурса JAR Java в прокси-сервер API возвращается код статуса HTTP 400 (вместо 500), если версия ресурса Java несовместима с поддерживаемой Edge версией Java, указанной в разделе Поддерживаемое ПО и версии. (MGMT-3420)

Проверка ресурсов прокси-сервера API

Если файлы ресурсов прокси API (например, JAR-файлы JavaScript или Java) хранятся на уровне среды или организации, то для прохождения проверки фреймворк больше не требует, чтобы вы также включали эти ресурсы на уровне прокси API в пакет прокси для импорта. Проверка ресурсов теперь выполняется во время развертывания, а не импорта. (MGMT-1430)

Как настроить время ожидания для отдельных прокси API

Вы можете настроить прокси API так, чтобы по истечении определенного времени происходил тайм-аут (со статусом 504 Gateway Timeout). Основной вариант использования – для клиентов частного облака, у которых есть прокси API, выполнение которых занимает больше времени. Например, вам нужно, чтобы определенные прокси-серверы отключались через три минуты. Вы можете использовать новое свойство api.timeout в конфигурации прокси-сервера API. Вот как это сделать на примере трехминутного видео:

1. Сначала настройте балансировщик нагрузки, маршрутизатор и процессор сообщений так, чтобы время ожидания истекало через три минуты.
2. Затем настройте соответствующие прокси-серверы так, чтобы время ожидания составляло три минуты. Укажите значение в миллисекундах. Пример:

   <ProxyEndpoint name="default">
     <HTTPProxyConnection>
       <BasePath>/v1/weather</BasePath>
       <Properties>
         <!-- api.timeout is in milliseconeds -->
         <Property name="api.timeout">180000</Property>
       </Properties>
       ...

3. Однако обратите внимание, что увеличение системных тайм-аутов может привести к проблемам с производительностью, поскольку все прокси-серверы без настройки api.timeout используют новые, более высокие тайм-ауты балансировщика нагрузки, маршрутизатора и процессора сообщений. Поэтому настройте другие прокси API, которым не требуется более длительное время ожидания, на использование более низких значений. Например, следующий код задает для прокси-сервера API время ожидания в одну минуту:
   <Property name="api.timeout">60000</Property>

Клиенты облачной версии, которые не могут изменять время ожидания Edge, также могут настроить время ожидания прокси-сервера API, если оно будет меньше стандартного времени ожидания обработчика сообщений Edge, равного 57 секундам.

Значение нельзя заполнить с помощью переменной. Это свойство описано в разделе Справочник по свойствам конечных точек. (APIRT-1778)

TLS/SSL для ведения журнала сообщений Правила

<KeyStore> и <TrustStore> можно задать в конфигурации SSLInfo в правиле ведения журнала сообщений, что позволяет использовать одно- и двусторонние подключения TLS/SSL с сервисом ведения журнала. Вы настраиваете SSLInfo в правиле ведения журнала сообщений так же, как и в TargetEndpoint прокси. Однако TLS/SSL для регистрации сообщений поддерживает только протокол TCP. (APIRT-1858)

Исправлены ошибки

В этой версии исправлены следующие ошибки: Этот список предназначен в основном для пользователей, которые хотят узнать, решены ли их проблемы. Он не предназначен для предоставления подробной информации всем пользователям.