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

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

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

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

• 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 и высокопроизводительный объект Crypto для JavaScript.

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

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

Устаревший

API-сервисы

Удален классический редактор прокси (Cloud 16.04.20 UI)

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

Монетизация

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

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

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

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

(DEVRT-2742)

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

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

Дополнительную информацию и инструкции см. в документации Edge for Private Cloud.

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

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

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

Поддержка GeoMap в Edge UI

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

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

API BaaS

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

• Как настроить API BaaS для использования TLS. Подробнее см. в разделе «Настройка TLS для API BaaS» .
• Как настроить все узлы стека API BaaS для использования общего хранилища, чтобы все ресурсы были доступны всем узлам стека API BaaS. Подробнее см. в разделе Загрузка ресурсов .
• Как зашифровать пароль 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 для частного облака может использовать эту утилиту для получения данных о трафике и передачи их в Apigee.

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

API-сервисы

Полезные данные JSON в назначении сообщения и вызове ошибки (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

(МГМТ-3273)

Криптофункции в JavaScript (Cloud 16.08.17)

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

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

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

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

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

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

Вы можете настроить прокси 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).

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

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

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

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

Сквозной SOAP

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

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

REST в SOAP в REST

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

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

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

(EDGEUI-614)

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

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

Монетизация

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

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

Уведомления Webhook для тарифных планов с регулируемой ставкой (монетизация 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)

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

Миграция разработчиков на монетизацию (монетизация Cloud 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 UI)

Если пути к ресурсам в политике записи транзакций для монетизации не соответствуют путям к ресурсам, определенным в API-продукте (например, при изменении путей к ресурсам API-продукта), значок политики записи транзакций на странице «Продукты» отображает предупреждающий символ. При щелчке по значку для просмотра политики записи транзакций в верхней части страницы появляется предупреждение. После исправления путей к ресурсам в политике записи транзакций предупреждающие индикаторы исчезают. (DEVRT-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 (УИ)

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

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