Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X. Информация
Вы можете создавать и изменять правила локально, используя любой текстовый редактор или IDE с поддержкой XML. В этой статье на примере правил квоты показано, как создавать, настраивать, прикреплять, развертывать и тестировать правила.
Большинство прокси API применяют квоту. Квоты позволяют контролировать, как часто клиентское приложение может вызывать API в течение определенного периода времени. В примере ниже правило квоты настроено так, чтобы ограничить количество запросов от приложений до одного в минуту. (Хотя это может быть нереалистично, такой подход позволяет легко увидеть последствия применения правил.)
В конфигурации прокси-сервера API файлы правил хранятся в виде XML-файлов в каталоге /apiproxy/policies.
Например, правило типа Quota с названием QuotaPolicy можно создать в файле QuotaPolicy.xml со следующим содержимым:
<Quota enabled="true" continueOnError="false" name="QuotaPolicy">
<Allow count="1"/>
<Interval>1</Interval>
<TimeUnit>minute</TimeUnit>
</Quota>Вы можете создать текстовый файл вручную или сгенерировать правила на основе схемы XML. У всех правил есть настройки, которые относятся только к определенному типу правил, и настройки, которые являются общими для всех правил.
Во всех правилах определены следующие атрибуты:
enabled– указывает, включено или отключено правило. Правила можно включать и отключать во время выполнения, изменяя этот параметр. Правило, в котором для параметраenabledзадано значениеfalse, не применяется.continueOnError– определяет, должен ли конвейер продолжать обработку сообщения, если правило не выполняется. При применении правил квоты ошибки, скорее всего, указывают на то, что квота превышена, поэтому для этого атрибута следует задать значение false.name– название правила. Это название уникально для экземпляра правила и используется для прикрепления правила к потоку в качестве шага обработки.
В приведенном выше примере элементы Allow, Interval и TimeUnit относятся к правилам в отношении квот. Эти элементы содержат настройки, которые сервисы API применяют от имени API. Другие типы правил определяют собственные настройки, с которыми можно ознакомиться в Справочнике по правилам.