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

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

В понедельник, 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, определенных в политиках Assign Message и Raise Fault, улучшения преобразования XML в JSON, улучшенную проверку ресурсов, возможность устанавливать тайм-ауты для отдельных прокси API, обновленные создание прокси-серверов SOAP в мастере прокси-серверов API и высокопроизводительный объект Crypto для JavaScript.

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

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

Устарело

API-сервисы

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

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

Монетизация

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

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

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

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

(ДЕВРТ-2742)

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

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

Дополнительные сведения и инструкции см. в документации Edge для частного облака.

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

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

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

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

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

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

API БааС

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

• Как настроить API BaaS для использования TLS. Дополнительные сведения см. в разделе Настройка TLS для API BaaS .
• Как настроить все узлы API BaaS Stack для использования общего хранилища, чтобы все ресурсы были доступны всем узлам API BaaS Stack. Дополнительную информацию см. в разделе Загрузка ресурсов .
• Как зашифровать пароль Cassandra при настройке узлов стека BaaS. Дополнительные сведения см. в разделе Сброс паролей 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 для частного облака может использовать эту утилиту для получения и передачи данных о трафике в 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> в справочных документах по политике назначения сообщений и политике Raise Fault . (АПИРТ-1160)

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

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

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

Дополнительные сведения см. в разделе Политика преобразования XML в JSON . (АПИРТ-1144)

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

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

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

(МГМТ-3273)

Криптофункции в JavaScript (Облако 16.08.17)

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

Проверка версии JAR Java Callout (Облако 16.08.17)

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

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

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

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

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

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 секунд.

Вы не можете заполнить значение переменной. Это свойство описано в справочнике по свойствам конечной точки . (АПИРТ-1778)

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

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

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

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

Сквозное мыло

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

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

ОТ ОТДЫХ к МЫЛУ к ОТДЫХУ

• WSDL 2.0 не поддерживается.
• Новое поведение не тестировалось с помощью WS-Policy.
• Прокси позволяет отправлять данные POST JSON вместо FormParams.
• Когда вы добавите поддержку 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 считывает любые сложные типы, определенные в WSDL как абстрактные, и правильно распознает любые типы экземпляров, основанные на абстрактных типах.

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

Apigee также предоставляет утилиту командной строки с открытым исходным кодом для создания прокси-серверов API passthrough или rest-to-soap из WSDL. См. https://github.com/apigee/wsdl2apigee .

(ЭДГЕУИ-614)

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

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

Монетизация

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

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

Уведомления Webhook для планов с регулируемой скоростью уведомлений (монетизация Cloud 16.04.27)

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

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

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

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

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

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

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

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

Монетизация предоставляет набор API-интерфейсов, которые вы можете использовать для проверки выполнения веб-перехватчиков, чтобы гарантировать отправку уведомлений. Подробности см. в разделе Настройка тестового уведомления . (ДЕВРТ-2625)

Миграция разработчиков на монетизацию (монетизация Cloud 16.05.11)

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

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

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

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

Монетизация предоставляет набор API-интерфейсов, которые можно использовать для возобновления работы разработчика, действие которого было ранее приостановлено. Разработчик может быть отстранен от работы, если будет достигнут настроенный предел. Например, количество транзакций достигло максимального предела или баланс предоплаченного счета исчерпан. Дополнительную информацию см. в разделе Отмена приостановки разработчиков . (ДЕВРТ-2641)

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

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

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

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

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

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

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

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

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

16.08.17

16.07.27 (УИ)

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

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

16.07.13 (УИ)

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

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

16.06.29 (УИ)

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

Никто

16.06.15 (УИ)

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

Никто

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

16.05.18 (УИ)

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

16.05.11 (УИ)

16.05.04 (УИ)

16.04.27 (УИ)

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

Никто

16.04.20 (УИ)

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

Никто

16.04.13 (УИ)

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

В этом выпуске имеются следующие известные проблемы:

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

В понедельник, 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, определенных в политиках Assign Message и Raise Fault, улучшения преобразования XML в JSON, улучшенную проверку ресурсов, возможность устанавливать тайм-ауты для отдельных прокси API, обновленные создание прокси-серверов SOAP в мастере прокси-серверов API и высокопроизводительный объект Crypto для JavaScript.

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

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

Устарело

API-сервисы

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

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

Монетизация

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

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

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

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

(ДЕВРТ-2742)

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

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

Дополнительные сведения и инструкции см. в документации Edge для частного облака.

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

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

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

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

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

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

API БааС

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

• Как настроить API BaaS для использования TLS. Дополнительные сведения см. в разделе Настройка TLS для API BaaS .
• Как настроить все узлы API BaaS Stack для использования общего хранилища, чтобы все ресурсы были доступны всем узлам API BaaS Stack. Дополнительную информацию см. в разделе Загрузка ресурсов .
• Как зашифровать пароль Cassandra при настройке узлов стека BaaS. Дополнительные сведения см. в разделе Сброс паролей 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 для частного облака может использовать эту утилиту для получения и передачи данных о трафике в 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> в справочных документах по политике назначения сообщений и политике Raise Fault . (АПИРТ-1160)

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

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

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

Дополнительные сведения см. в разделе Политика преобразования XML в JSON . (АПИРТ-1144)

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

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

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

(МГМТ-3273)

Криптофункции в JavaScript (Облако 16.08.17)

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

Проверка версии JAR Java Callout (Облако 16.08.17)

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

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

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

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

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

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 секунд.

Вы не можете заполнить значение переменной. Это свойство описано в справочнике по свойствам конечной точки . (АПИРТ-1778)

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

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

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

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

Сквозное мыло

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

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

ОТ ОТДЫХ к МЫЛУ к ОТДЫХУ

• WSDL 2.0 не поддерживается.
• Новое поведение не тестировалось с помощью WS-Policy.
• Прокси позволяет отправлять данные POST JSON вместо FormParams.
• Когда вы добавите поддержку 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 считывает любые сложные типы, определенные в WSDL как абстрактные, и правильно распознает любые типы экземпляров, основанные на абстрактных типах.

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

Apigee также предоставляет утилиту командной строки с открытым исходным кодом для создания прокси-серверов API passthrough или rest-to-soap из WSDL. См. https://github.com/apigee/wsdl2apigee .

(ЭДГЕУИ-614)

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

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

Монетизация

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

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

Уведомления Webhook для планов с регулируемой скоростью уведомлений (монетизация Cloud 16.04.27)

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

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

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

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

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

Посмотреть и переукачать уведомления (Облако 16.06.08 Монетизация)

В рамках пакета тестов монетизации вы можете просмотреть и перерабатывать уведомления, ранее отправленные с использованием API управления. Для получения дополнительной информации см. Уведомления о просмотре и переработке . (Devrt-2643)

Тестирование монетизации (облако 16.05.25 Монетизация)

Монетизация предоставляет набор API, которые вы можете использовать для проверки выполнения веб -крючков для обеспечения отправки уведомлений. Для получения подробной информации см. Настройку уведомлений о тесте . (Devrt-2625)

Мигрирующие разработчики в монетизацию (Облако 16.05.11 Монетизация)

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

Планы государственных и частных ставок для портала разработчиков (Облако 16.04.27 Монетизация)

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

Разработчики Monsusdend (Облако 16.06.08 Монетизация)

Монетизация обеспечивает набор API, которые вы можете использовать, чтобы не воспитывать разработчика, который был ранее приостановлен. Разработчик может быть отстранен от работы, если будет достигнут настроенный предел. Например, количество транзакций достигло максимального предела или баланс предоплаченного счета исчерпан. Для получения информации см. Unraspend Developers . (Devrt-2641)

Просмотреть статус транзакций (облако 16.06.08 Монетизация)

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

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

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

Политика записи транзакций и согласованность ресурса продукта API (облако 16.05.18 UI)

Если пути ресурсов в политике записи транзакций монетизации не соответствуют пути ресурсов, определенным в его продукте 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 (пользовательский интерфейс)

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

Никто

16.06.15 (UI)

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

Никто

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

16.05.18 (UI)

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

16.05.11 (пользовательский интерфейс)

16.05.04 (UI)

16.04.27 (UI)

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

Никто

16.04.20 (пользовательский интерфейс)

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

Никто

16.04.13 (UI)

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

Этот релиз имеет следующие известные проблемы: