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

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

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

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

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

Полезные данные JSON в назначении сообщения и вызове ошибки

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

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

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

См. элемент <Set><Payload> в справочных документах по политике назначения сообщений и политике вызова сбоя . (APIRT-1160)

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

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

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

Для получения дополнительной информации см. Политику преобразования XML в JSON (APIRT-1144).

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

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

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

(МГМТ-3273)

Криптофункции в JavaScript

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

Проверка версии JAR-файла Java Callout

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

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

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

Настройте тайм-аут для отдельных API-прокси

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

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

   <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-прокси тайм-аут через 1 минуту:
   <Property name="api.timeout">60000</Property>

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

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

Политика регистрации сообщений TLS/SSL

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

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

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