Правила страниц

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

Перейдите в CDN → CDN-домены, откройте домен и выберите Правила страниц. URL в консоли: /cdn/domains/<domain>/rules.

#Состав правила

#Сопоставление URL

Правила страниц используют тот же механизм условий, что и правила межсетевого экрана. Для описания URL чаще всего используются следующие поля и операторы:

Доступные операторы: равно, не равно, содержит, не содержит, начинается с, заканчивается на, регулярное выражение, в списке, не в списке, больше/меньше (или равно), существует и не существует.

#Действия, которые применяются

Следующие настройки пока не действуют. Задавайте их на соответствующих страницах домена:

• На панели «Кеш»: режим времени кеширования, обработка строки запроса, режим хоста кеша, варианты кеша по устройству, стране или языку и выдача устаревшего содержимого. Настройте их на странице Кэш.
• Панель Кеш браузера, которая ещё внедряется. Настройте кеширование в браузере на странице Кеш.
• Панель Оптимизация (Gzip, Brotli и минификация). Настройте их на странице Оптимизация.

#Создание правила

1. На странице Правила страниц нажмите Добавить правило.
2. Введите имя, при необходимости измените приоритет и оставьте Включено активным.
3. В разделе Условия сопоставления добавьте условия и выберите «Все совпадают» или «Любое совпадает».
4. В разделе Выполнить действие нажмите Включить на каждой нужной панели действий и заполните настройки. Нажмите Удалить, чтобы убрать панель.
5. Нажмите OK для сохранения. Правило начнёт действовать на пограничных узлах за время от нескольких секунд до минуты.

Для сохранения правила требуется хотя бы одно условие и одно действие.

#Пример: кеширование статических ресурсов на 7 дней

• Условие: расширение файла в списке jpg, png, css, js
• Действие: кеш, режим Включено, время кеширования 604800

#Пример: отключение кеширования панели администрирования

• Условие: путь начинается с /admin
• Действие: кеш, режим Отключено

#Совпадение нескольких правил

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

#Квота правил

Тариф может ограничивать количество правил страниц. В этом случае в верхней части страницы отображается баннер с использованием квоты, например «Квота правил: 3/5». При достижении лимита удалите ненужные правила или перейдите на более высокий тариф.

#API

Конечные точки правил страниц находятся в /api/user/cdn/rules:

curl -X POST "https://api.yeap.cloud/api/user/cdn/rules/create" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "domain_id": 123,
    "name": "Static assets 7d",
    "priority": 100,
    "enabled": true,
    "settings": {
      "matcher": {"op": "and", "conditions": [
        {"collection": "EXTENSION", "op": "in", "var": ["jpg", "png", "css", "js"]}
      ]},
      "action": {"cache": {"enabled": "on", "ttl": 604800}}
    }
  }'

Другие конечные точки:

• Список правил: GET /api/user/cdn/rules?domain_id=123
• Обновление правила: POST /api/user/cdn/rules/update, с id в теле запроса
• Удаление правила: DELETE /api/user/cdn/rules/delete?id=<id>

#См. также

• WAF и безопасность
• Кеширование и очистка кеша
• SSL/TLS