Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X. Информация
2 июня 2015 г. мы выпустили новую облачную версию Apigee Edge.
Если у вас возникли вопросы, обратитесь в службу поддержки Apigee Edge.
Список всех примечаний к выпуску Apigee Edge приведен на странице Примечания к выпуску Apigee.
Новые функции и улучшения
Ниже перечислены новые функции и улучшения в этом выпуске.
Общая доступность SmartDocs
Функция SmartDocs переходит из бета-версии в общую доступность. Обновления и новые функции:
- Поддержка Swagger 2.0, в том числе импорт по файлу или URL, а также поддержка объектов безопасности с пользовательскими названиями.
- Улучшения визуального дизайна в шаблонах, на основе которых создаются умные документы.
- Улучшения удобства использования и рабочего процесса на портале для разработчиков, доступные через меню "Контент > SmartDocs" в Drupal.
- Аутентификация с помощью специального токена теперь называется аутентификацией с помощью ключа API.
- Объекты аутентификации "security", определенные на уровне версии.
- Настройка аутентификации клиента на уровне шаблона. Новые версии больше не сбрасывают предварительно настроенные учетные данные клиента SmartDocs.
Подробнее о функциях рассказывается в записи в блоге.
Документацию по SmartDocs можно найти в статье Как использовать SmartDocs для документирования API.
Новый бета-редактор прокси-серверов API
Доступна новая бета-версия редактора прокси-сервера API. Чтобы получить доступ к бета-версии, нажмите на ссылку "Доступ к бета-версии" при редактировании существующего прокси-сервера API. Вы можете переключаться между классическим и бета-редакторами.
Новые правила OAuthV2
Новые правила DeleteOAuthV2Info позволяют удалять коды авторизации и токены доступа. Подробнее о правилах удаления информации OAuthV2…
Новые объекты в правилах доступа к объектам
Правило "Объект доступа" предоставляет доступ к следующим новым объектам: consumerkey-scopes, authorizationcode, requesttoken и verifier. Подробнее о правилах в отношении объектов доступа…
Показывает сертификаты SSL, срок действия которых скоро истечет
На странице "Сертификаты SSL" в интерфейсе управления (Администратор > Сертификаты SSL) указывается, когда срок действия сертификатов SSL истекает в течение 10, 15, 30 или 90 дней в зависимости от того, что вы выберете в новом раскрывающемся списке.
Название приложения разработчика, которое показывается в интерфейсе управления.
У приложений разработчика в Edge есть внутреннее название, которое нельзя изменить, и отображаемое название, которое можно изменить. На странице приложения разработчика в интерфейсе управления (Publish > Developer Apps > [название приложения]) внутреннее название приложения отображается вместе с названием, которое видят пользователи. Это позволяет легко находить приложения по внутренним названиям при устранении неполадок и управлении API.
Удаление классической версии специальных отчетов из интерфейса управления
В интерфейсе управления больше не доступна классическая версия пользовательских отчетов.
Процесс обновления SmartDocs
Если вы уже использовали SmartDocs в бета-версии, то для доступа к новым функциям и возможностям версии с общей доступностью вам нужно обновить SmartDocs на портале разработчика.
Все страницы SmartDocs, которые уже опубликованы на вашем портале для разработчиков, будут работать и дальше, но перед тем как редактировать или публиковать изменения на существующих или новых страницах, необходимо выполнить описанные ниже действия.
Обратите внимание, что, хотя вы можете отрисовывать и публиковать SmartDocs на своем портале для разработчиков, они генерируются на основе модели API, которая находится в сервисах управления API Apigee Edge. Все изменения, внесенные в модель API в Edge, будут одинаковыми во всех средах Pantheon (по аналогии с тем, как разработчики существуют в средах Pantheon).
Как перейти с бета-версии SmartDocs на общую доступность
- Обновите и протестируйте версию 15.05.27 в разработочной или тестовой среде на платформе Pantheon.
- Создайте новую модель, чтобы заменить существующую модель API.
- Если вы импортировали документы Swagger или WADL, импортируйте их снова в новую версию.
- Если вы поддерживали модель API с помощью модуля SmartDocs, экспортируйте ее как JSON SmartDocs и импортируйте в новую модель, используя прикрепленный файл.
- Задайте свойства безопасности для версии модели. На странице Контент > SmartDocs > модель выберите Настройки безопасности.
- Проверьте предварительно настроенную аутентификацию на странице настроек модели (Контент > SmartDocs), нажав Настройки в столбце "Операции".
- Обновите все собственные шаблоны, чтобы в них использовались объекты CSS и JS версии 6, а также внесите изменения, связанные с новыми названиями объектов, например authSchemes и apiSchema. Информацию о том, как обновить шаблоны SmartDocs, можно найти в статье Как использовать SmartDocs для документирования API.
- Заново отрисуйте и опубликуйте измененную модель.
- После проверки новой документации обновите рабочий портал до версии 15.05.27.
Если вы корпоративный клиент Edge и у вас есть вопросы или проблемы, связанные с процессом обновления, отправьте электронное письмо на адрес marsh@apigee.com и cnovak@apigee.com. В остальных случаях рекомендуем обратиться к сообществу Apigee.
Исправлены ошибки
В этой версии исправлены следующие ошибки:
| Идентификатор проблемы | Описание |
|---|---|
| TBD-72 | Проблема с правилами ведения журналов сообщений |
| MGMT-2124 | При сохранении разрешений в интерфейсе сбрасываются разрешения роли клиента |
| MGMT-2048 | Пользователь со специальной ролью, которая ограничивает разрешения на развертывание одной средой, может выполнять развертывание в других средах |
| MGMT-2041 | Удаление элемента FaultRules из шаблона прикрепления по умолчанию Элемент FaultRules, который не используется в правилах или шагах прокси-сервера API, больше не добавляется автоматически при создании прокси-серверов API или добавлении правил. |
| MGMT-2034 | При получении WSDL возникает ошибка "Fetch WSDL Error: Error processing WSDL." |
| MGMT-1812 | Добавление проверки TargetEndpoint во время импорта Как и в случае с ProxyEndpoint, TargetEndpoint будет проверяться на соответствие схеме и выражениям, используемым в условиях во время импорта прокси-сервера API. |
| MGMT-1345 | Импорт WSDL с несколькими пространствами имен приводит к неправильному созданию шага SOAP |
| MGMT-800 | Создание ресурса с названием "default" приводит к сбоям в работе интерфейса |
| MGMT-602 | Представление разработки прокси API: добавление правила кеширования ответов, когда у конечной точки нет PreFlow/PostFlow, приводит к ошибке |
| MGMT-460 | Переименование правил приводит к сбоям и дублированию правил, которые нельзя удалить |
| DEVRT-1565 | Интервалы в 15 минут для параметра "ПЛАТЕЖИ" |
| AXAPP-1728 | Как игнорировать переменные монетизации в аналитике |
| AXAPP-1690 | Ошибка"Недействительный API" в специальных отчетах |
| AXAPP-1533 | Геокарта Аналитики возвращает ошибку "Недопустимый вызов API" |
| APIRT-52 | Специальные отчеты: код статуса ответа для многих API имеет значение NULL |