Модуль fortinet.fortios.fortios_wanopt_webcache — настройка глобальных параметров веб-кэша в Fortinet FortiOS и FortiGate.
Примечание
Этот модуль входит в коллекцию fortinet.fortios (версия 2.5.1).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install fortinet.fortios. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: fortinet.fortios.fortios_wanopt_webcache.
Добавлено в fortinet.fortios 2.0.0
Краткое описание
- Этот модуль позволяет настраивать устройство FortiGate или FortiOS (FOS), задавая и изменяя параметры функций wanopt и категории webcache. В примерах приведены все параметры и значения, которые необходимо скорректировать с учетом источников данных перед использованием. Проверено на FOS v6.0.0
Требования
На узле, где выполняется этот модуль, должны быть установлены перечисленные ниже компоненты.
- ansible>=2.16
Параметры
Параметр | Описание |
|---|---|
access_token string | Аутентификация на основе токена. Токен создается в графическом интерфейсе FortiGate. |
enable_log boolean | Включить или отключить ведение журнала для задачи. Варианты:
|
member_path string | Путь к атрибуту элемента, с которым выполняется операция. Если атрибутов несколько, они разделяются косой чертой. Параметр с пометкой member_path можно использовать для выполнения операций с элементами. |
member_state string | Добавить или удалить элемент по указанному пути атрибута. Если задан параметр member_state, параметр state игнорируется. Варианты:
|
vdom string | Виртуальный домен из числа ранее определенных. VDOM — это виртуальный экземпляр FortiGate, который можно настроить и использовать как отдельное устройство. По умолчанию: |
wanopt_webcache dictionary | Настройка глобальных параметров веб-кэша. |
|
always_revalidate string |
Включить или отключить повторную проверку запрошенных кэшированных объектов, содержимое которых есть на сервере, перед отправкой клиенту. Варианты:
|
|
cache_by_default string |
Включить или отключить кэширование содержимого, для которого сервер не задает явные политики кэширования. Варианты:
|
|
cache_cookie string |
Включить или отключить кэширование файлов cookie. Поскольку файлы cookie содержат информацию о пользователях или для них, обычно их не кэшируют. Варианты:
|
|
cache_expired string |
Включить или отключить кэширование объектов типа 1, срок действия которых уже истек при получении. Варианты:
|
|
default_ttl integer |
Срок действия объекта по умолчанию. Применяется только к объектам, для которых веб-сервер не задал срок действия. |
|
external string |
Включить или отключить внешнее кэширование веб-содержимого. Варианты:
|
|
fresh_factor integer |
Частота проверки сервера на наличие объектов с истекшим сроком действия (1–100). Чем выше значение fresh_factor, тем реже выполняются проверки. |
|
host_validate string |
Включить или отключить проверку заголовка «Host:» по IP-адресу исходного сервера. Варианты:
|
|
ignore_conditional string |
Включить или отключить управление поведением, связанным со значениями заголовка Cache-Control в HTTP 1.1. Варианты:
|
|
ignore_ie_reload string |
Включить или отключить игнорирование интерпретации PNC заголовка Accept: / браузером Internet Explorer. Варианты:
|
|
ignore_ims string |
Включить или отключить игнорирование заголовка If-Modified-Since (IMS). Варианты:
|
|
ignore_pnc string |
Включить или отключить игнорирование заголовка Pragma: no-cache (PNC). Варианты:
|
|
max_object_size integer |
Максимальный размер объекта, который можно кэшировать, в кБ (1–2147483 кБ (2 ГБ)). Объекты большего размера передаются клиенту, но не сохраняются в веб-кэше. |
|
max_ttl integer | Максимальное время хранения объекта в веб-кэше без проверки истечения срока его действия на сервере. |
|
min_ttl integer | Минимальное время хранения объекта в веб-кэше без проверки истечения срока его действия на сервере. |
|
neg_resp_time integer |
Время кэширования отрицательных ответов или ошибок в минутах (0–4294967295). |
|
reval_pnc string |
Включить или отключить повторную проверку заголовка Pragma: no-cache (PNC) для решения проблем с пропускной способностью. Варианты:
|
Примечания
Примечание
- Устаревшая библиотека fortiosapi объявлена устаревшей; для выполнения плейбуков рекомендуется использовать httpapi.
- Модуль поддерживает check_mode.
Примеры
- name: Configure global Web cache settings.
fortinet.fortios.fortios_wanopt_webcache:
vdom: "{{ vdom }}"
wanopt_webcache:
always_revalidate: "enable"
cache_by_default: "enable"
cache_cookie: "enable"
cache_expired: "enable"
default_ttl: "1440"
external: "enable"
fresh_factor: "100"
host_validate: "enable"
ignore_conditional: "enable"
ignore_ie_reload: "enable"
ignore_ims: "enable"
ignore_pnc: "enable"
max_object_size: "512000"
max_ttl: "7200"
min_ttl: "5"
neg_resp_time: "0"
reval_pnc: "enable"
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
build string | Номер сборки образа FortiGate Возвращается: всегда Пример: |
http_method string | Последний метод, использованный для передачи содержимого в FortiGate Возвращается: всегда Пример: |
http_status string | Последний результат, возвращенный FortiGate при последней выполненной операции Возвращается: всегда Пример: |
mkey string | Мастер-ключ (идентификатор), использованный при последнем обращении к FortiGate Возвращается: при успехе Пример: |
name string | Имя таблицы, использованной для выполнения запроса Возвращается: всегда Пример: |
path string | Путь к таблице, использованной для выполнения запроса Возвращается: всегда Пример: |
revision string | Внутренний номер ревизии Возвращается: всегда Пример: |
serial string | Серийный номер устройства Возвращается: всегда Пример: |
status string | Результат операции Возвращается: всегда Пример: |
vdom string | Использованный виртуальный домен Возвращается: всегда Пример: |
version string | Версия FortiGate Возвращается: всегда Пример: |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/fortinet/fortios/fortios_wanopt_webcache_module.html