16.4.09 — Примечания к выпуску Edge для частного облака

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

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

С момента выхода предыдущего выпуска функционала Edge for Private Cloud произошли следующие релизы, которые включены в данный релиз:

• Облако: 16.04.13 (UI) , 16.04.13 (монетизация) , 16.04.20 (UI) , 16.04.27 (монетизация) , 16.04.27 (UI) , 16.05.04 (UI) , 16.05.11 (UI) , 16.05.11 (монетизация) , 16.05.18 (UI) , 16.05.25 (монетизация) , 16.06.08 (монетизация) , 16.06.15 (UI) , 16.06.22 (монетизация) , 16.06.29 (UI) , 16.07.06 (монетизация) , 16.07.06.02 (монетизация) . 16.07.13 (UI) , 16.07.20.01 (монетизация) , 16.07.27 (UI) , 16.08.17

См. раздел «О нумерации выпусков» , чтобы понять, как определить, включен ли конкретный облачный выпуск в вашу версию Edge для частного облака.

Обзор релиза

В этом выпуске классический редактор прокси API был удален и заменен новым редактором прокси, который ранее был доступен для использования вместе с классическим редактором. Среди других важных улучшений — улучшенное поведение путей к ресурсам продуктов API, улучшенная обработка JSON-данных, определенных в политиках «Назначить сообщение» и «Вызвать ошибку», улучшения преобразования XML в JSON, улучшенная проверка ресурсов, возможность установки тайм-аутов для отдельных прокси API, обновленная генерация SOAP-прокси в мастере прокси API и высокопроизводительный криптографический объект для JavaScript.

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

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

Устаревший

API-сервисы

Классический редактор прокси удален (пользовательский интерфейс Cloud 16.04.20)

Теперь поддерживается только новая версия редактора API-прокси. Классическая версия больше недоступна, и ссылка «Получить доступ к классической версии редактора прокси» удалена. Если вы использовали классическую версию, ваши API-прокси будут автоматически загружены в новом редакторе. (EDGEUI-498)

Монетизация

Следующие устаревшие функции были удалены и больше не поддерживаются:

• Установление лимитов
• Отправка уведомлений об ограничении

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

• Настройка уведомлений о событиях
• Создать уведомление об ограничении для тарифного плана

(DEVRT-2742)

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

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

Для получения более подробной информации и инструкций см. документацию Edge for Private Cloud.

Частное облако

Обновление Postres до версии 9.4

В этом выпуске представлено обновление до Postgres 9.4. Инструкции по обновлению системы см. в разделе «Обновление Apigee Edge до версии 4.16.09» .

Поддержка геокарт в пользовательском интерфейсе Edge

Геоагрегация позволяет собирать аналитические данные для вызовов API на основе географических атрибутов, таких как регион, континент, страна и город. На основе этих аналитических данных вы можете просмотреть Геокарту в пользовательском интерфейсе Edge, которая показывает местоположение запросов API.

Для получения более подробной информации см. раздел «Включение агрегации географических данных и географических карт» .

API BaaS

Добавлена ​​документация по:

• Как настроить API BaaS для использования TLS. Дополнительную информацию см. в разделе «Настройка TLS для API BaaS» .
• Как настроить все узлы API BaaS Stack для использования общего хранилища, чтобы все ресурсы были доступны всем узлам API BaaS Stack. Дополнительную информацию см. в разделе «Загрузка ресурсов» .
• Как зашифровать пароль Cassandra при настройке узлов BaaS Stack. Дополнительную информацию см. в разделе «Сброс паролей Edge» .

Бета-версия инструмента мониторинга и панели мониторинга.

В этот релиз включена бета-версия нового инструмента мониторинга и панели мониторинга для Edge. Этот инструмент позволяет отслеживать состояние различных компонентов (маршрутизаторов, обработчиков сообщений, ZooKeeper, Cassandra), а также коды ошибок HTTP для различных организаций и сред в вашей системе. Вы также можете сделать снимок данных с панели мониторинга и поделиться им с Apigee для решения проблем в службе поддержки.

Документация, включая инструкции по установке, включена в документацию Edge 4.16.09 в версии 4.18.01 .

Однако, прежде чем вы сможете установить и использовать панель управления, вам необходимо заполнить ознакомительное соглашение Apigee, которое также доступно в версии 4.18.01 , и отправить его в Apigee по электронной почте на адрес orders@apigee.com.

Бета-версия инструмента сбора аналитических данных.

Все клиенты Edge for Private Cloud обязаны предоставлять Apigee статистику по трафику API-прокси. Apigee рекомендует клиентам загружать эту информацию один раз в день, возможно, с помощью задания cron.

Для упрощения загрузки этих данных Apigee предоставляет бета-версию утилиты командной строки apigee-analytics-collector . Эта утилита отправляет отчет об объеме вызовов API обратно в Apigee. Каждая установка Edge for the Private Cloud может использовать эту утилиту для получения и отправки данных о трафике в Apigee.

Для получения дополнительной информации см. раздел «Загрузка данных о трафике API в Apigee — бета-версия» .

API-сервисы

JSON-данные в функциях Assign Message и Raise Fault (Cloud 16.08.17)

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

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

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

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

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

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

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

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

Использование нескольких символов подстановки в путях к ресурсам API-продуктов (Cloud 16.08.17)

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

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

(MGMT-3273)

Криптографические функции в JavaScript (Cloud 16.08.17)

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

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

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

Проверка ресурсов API-прокси (Cloud 16.08.17)

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

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

Вы можете настроить API-прокси таким образом, чтобы они завершали работу по истечении указанного времени (со статусом 504 Gateway Timeout). Основной вариант использования — для клиентов частного облака, у которых 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).

Поведение SOAP-прокси при использовании мастера настройки прокси (пользовательский интерфейс Cloud 16.07.27)

При создании SOAP-прокси из WSDL с помощью мастера создания прокси доступны два варианта:

• Технология Pass-Through SOAP , при которой прокси-сервер просто передает полезную нагрузку SOAP-запроса в неизмененном виде.
• REST в SOAP в REST , где прокси-сервер преобразует входящие данные, такие как JSON, в SOAP-данные, а затем преобразует SOAP-ответ обратно в формат, ожидаемый вызывающей стороной.

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

Проходной SOAP

• Теперь все операции WSDL отправляются по базовому пути прокси-сервера "/", а не к ресурсам прокси (например, "/cityforecastbyzip"). Имена операций передаются в целевой SOAP-сервис. Такое поведение соответствует спецификации SOAP.

• Сгенерированный прокси-сервер больше не поддерживает JSON в запросе. Он поддерживает только XML. Прокси-сервер гарантирует, что SOAP-запросы будут иметь Envelope, Body и пространство имен.

ОТДЫХ К МЫЛЬНОМУ ОТДЫХУ

• Поддержка WSDL 2.0 отсутствует.
• Новое поведение не было протестировано с WS-Policy.
• Прокси позволяет отправлять данные в формате JSON методом POST вместо параметров формы.
• При добавлении поддержки CORS (совместного использования ресурсов между источниками) в прокси-сервер с помощью конструктора прокси вы увидите следующие улучшения:
  • Заголовок Access-Control-Allow-Headers : Помимо заголовков Origin , x-requested-with и Accept , заголовок Access-Control-Allow-Headers также включает Content-Type , Accept-Encoding , Accept-Language , Host , Pragma , Referrer , User-Agent и Cache-Control .
  • Заголовок Access-Control-Allow-Methods : Помимо GET , PUT , POST , DELETE , этот заголовок также включает глаголы PATCH и OPTIONS .
• При генерации API-прокси для WSDL, Edge считывает все ComplexTypes, определенные как абстрактные в WSDL, и корректно распознает любые типы экземпляров, основанные на этих абстрактных типах.

wsdl2apigee — утилита командной строки с открытым исходным кодом

Apigee также предоставляет утилиту командной строки с открытым исходным кодом для генерации прокси-серверов REST-SOAP API из WSDL-файлов. См. https://github.com/apigee/wsdl2apigee .

(EDGEUI-614)

Значение по умолчанию для истечения срока действия/обновления в политике операций сопоставления ключей и значений (пользовательский интерфейс Cloud 16.06.15)

Политика Key Value Map Operations позволяет определить, как долго значения сохраняются до обновления. Интервал обновления задается элементом <ExpiryTimeInSecs> . Если выполняется операция GET и интервал истечения срока действия превышен, значение обновляется, и политика получает обновленное значение. При добавлении этой политики к API-прокси время истечения срока действия по умолчанию теперь составляет 300 секунд. (Предыдущее значение по умолчанию было -1, что означает, что значения никогда не обновляются.) (EDGEUI-579)

Монетизация

Настраиваемый тарифный план для уведомлений (пользовательский интерфейс Cloud 16.04.20, монетизация Cloud 16.04.13)

В модуле монетизации Edge появилась новая функция настраиваемой частоты уведомлений, позволяющая поставщику API корректировать целевое количество транзакций для каждого разработчика приложения. Вы можете настроить отправку уведомлений в зависимости от того, какой процент от целевого числа достигнут, например, 90%, 100% или 150%. Эта функция доступна через пользовательский интерфейс управления, а также через API управления (который был доступен в предыдущей версии). Для получения дополнительной информации см. раздел «Указание параметров настраиваемого плана уведомлений» . (DEVRT-2375, DEVRT-2370)

Веб-хуки для настраиваемых тарифных планов с частотой уведомлений (монетизация Cloud 16.04.27)

Для планов с регулируемой частотой уведомлений вы можете создавать веб-хуки, которые отправляют уведомления на указанный вами URL-адрес. Вы также можете управлять отправкой уведомлений с определенными интервалами (в процентах) до достижения лимита транзакций. Веб-хуки предоставляют гибкую альтернативу использованию существующих шаблонов уведомлений. См. раздел «Настройка уведомлений с помощью веб-хуков» (DEVRT-2393, DEVRT-2394).

Настраиваемые уведомления с возможностью выбора пользовательских атрибутов тарифного плана (пользовательский интерфейс Cloud 16.05.18)

В системе монетизации Edge появился новый тарифный план «Настраиваемые уведомления с пользовательским атрибутом», позволяющий увеличивать счетчик транзакций разработчика с помощью значения пользовательского атрибута. В стандартном тарифном плане «Настраиваемые уведомления» каждый успешный вызов API добавляет 1 к счетчику транзакций разработчика. Но в тарифном плане «Настраиваемые уведомления с пользовательским атрибутом» значение пользовательского атрибута добавляется к счетчику транзакций разработчика. Например, если пользовательский атрибут «small» имеет значение 0,1 в ответе, счетчик транзакций увеличивается на 0,1; или если пользовательский атрибут «addressTotal» имеет значение 50, счетчик увеличивается на 50. Для получения дополнительной информации см. раздел «Указание тарифного плана с пользовательским атрибутом» . (DEVRT-2504)

Настройте уведомления на основе суммарных транзакций компании и ее разработчиков (монетизация в Cloud 16.06.22).

Как правило, общая сумма транзакций автоматически отслеживается для всех разработчиков в компании, когда они используют корпоративное приложение для доступа к API. Что делать, если у вас есть разработчики, которые активно используют свои собственные приложения для доступа к API, и вам нужно отслеживать их общую сумму транзакций без нарушения трафика? Вы можете добавить разработчиков в компанию и настроить уведомления, которые будут отправляться при достижении пороговых значений, основанных на общей сумме транзакций компании и ее разработчиков. Для получения дополнительной информации см. раздел «Настройка уведомлений на основе общей суммы транзакций для компании и ее разработчиков » (DEVRT-2643).

Просмотр и повторная обработка уведомлений (монетизация Cloud 16.06.08)

В рамках набора тестов монетизации вы можете просматривать и повторно обрабатывать ранее отправленные уведомления с помощью API управления. Для получения дополнительной информации см. раздел «Просмотр и повторная обработка уведомлений » (DEVRT-2643).

Тестовая монетизация (монетизация Cloud 16.05.25)

Монетизация предоставляет набор API, которые можно использовать для тестирования выполнения веб-хуков, чтобы убедиться в отправке уведомлений. Подробнее см. раздел «Тестирование настройки уведомлений» . (DEVRT-2625)

Перевод разработчиков на монетизацию (монетизация в облачной версии 16.05.11)

Для упрощения перехода разработчиков на монетизацию доступен новый API. Вы можете перенести использование транзакций и устанавливать индивидуальные тарифные планы и регулярные платежи. Кроме того, при принятии опубликованного тарифного плана вы можете отменить плату за настройку, если она уже была начислена. Для получения дополнительной информации см. раздел «Переход разработчиков на монетизацию » (DEVRT-2446).

Тарифные планы для публичного и частного доступа к порталу для разработчиков (монетизация Cloud 16.04.27)

Вы можете установить тарифные планы как «Общедоступные» или «Частные». Общедоступные тарифные планы отображаются на портале разработчика; частные — нет. По умолчанию тарифный план имеет значение «Общедоступный». Для получения дополнительной информации см. http://docs.apigee.com/monetization/content/create-rate-plans#public-versus-private-rate-plans . (DEVRT-2445)

Разблокировать разработчиков (монетизация Cloud 16.06.08)

Монетизация предоставляет набор API, которые можно использовать для снятия блокировки с разработчика, ранее заблокированного. Блокировка разработчика может быть вызвана достижением установленного лимита. Например, если количество транзакций достигло максимального предела или баланс предоплаченного счета исчерпан. Дополнительную информацию см. в разделе «Снятие блокировки разработчиков» . (DEVRT-2641)

Просмотр статуса транзакций (монетизация Cloud 16.06.08)

В рамках набора тестов монетизации вы можете просмотреть статус транзакций, произошедших в указанном временном диапазоне, используя API управления. Для получения дополнительной информации см. раздел «Просмотр статуса транзакций ». (DEVRT-2640)

Включение пользовательских атрибутов разработчиков в отчеты о доходах (монетизация Cloud 16.05.25)

В отчеты о доходах можно включать пользовательские атрибуты, если они определены для разработчика. Дополнительную информацию см. в разделе «Включение пользовательских атрибутов разработчика в отчеты о доходах с помощью API» (DEVRT-2447).

Согласованность политики записи транзакций и ресурсов API-продукта (пользовательский интерфейс Cloud 16.05.18)

Если пути к ресурсам в политике записи транзакций монетизации не совпадают с путями к ресурсам, определенными в его API-продукте (например, если вы изменили пути к ресурсам API-продукта), на странице «Продукты» значок политики записи транзакций отображает предупреждающий символ. При нажатии на значок для просмотра политики записи транзакций в верхней части страницы появляется предупреждение. После исправления путей к ресурсам в политике записи транзакций предупреждающие индикаторы исчезают. (DEVRT-2240)

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

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

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

16.08.17

16.07.27 (UI)

16.07.20.01 (монетизация)

В этом релизе внесены незначительные изменения в схему базы данных. Других обновлений программного обеспечения в этом релизе нет.

16.07.13 (UI)

16.07.06.02 (монетизация)

16.07.06 (монетизация)

16.06.29 (UI)

16.06.22 (монетизация)

Никто

16.06.15 (UI)

16.06.08 (монетизация)

Никто

16.05.25 (монетизация)

16.05.18 (UI)

16.05.11 (монетизация)

16.05.11 (UI)

16.05.04 (UI)

16.04.27 (UI)

16.04.27 (монетизация)

Никто

16.04.20 (UI)

16.04.13 (монетизация)

Никто

16.04.13 (UI)

Известные проблемы

В данной версии обнаружены следующие известные проблемы: