fortinet.fortios.fortios_wanopt_webcache 模块 – 在 Fortinet 的 FortiOS 和 FortiGate 中配置全局 Web 缓存设置。

注意

此模块是 fortinet.fortios 集合（版本 2.3.8）的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install fortinet.fortios。您需要其他要求才能使用此模块，有关详细信息，请参阅要求。

要在 playbook 中使用它，请指定：fortinet.fortios.fortios_wanopt_webcache。

fortinet.fortios 2.0.0 中的新增功能

概要

  • 此模块能够通过允许用户设置和修改 wanopt 功能和 webcache 类别来配置 FortiGate 或 FortiOS (FOS) 设备。示例包括所有参数和值，需要在使用前调整为数据源。已使用 FOS v6.0.0 进行测试

要求

执行此模块的主机需要满足以下要求。

  • ansible>=2.15

参数

参数

注释

access_token

字符串

基于令牌的身份验证。从 Fortigate 的 GUI 生成。

enable_log

布尔值

启用/禁用任务日志记录。

选择

  • false ←（默认）

  • true

member_path

字符串

要操作的成员属性路径。

如果存在多个属性，则以斜杠字符分隔。

标记有 member_path 的参数对于执行成员操作是合法的。

member_state

字符串

在指定的属性路径下添加或删除成员。

当指定 member_state 时，将忽略 state 选项。

选择

  • "present"

  • "absent"

vdom

字符串

虚拟域，在先前定义的那些域中。vdom 是 FortiGate 的虚拟实例，可以配置并用作不同的单元。

默认值： "root"

wanopt_webcache

字典

配置全局 Web 缓存设置。

always_revalidate

字符串

启用/禁用重新验证所请求的缓存对象，这些对象在服务器上具有内容，然后再将其提供给客户端。

选择

  • "enable"

  • "disable"

cache_by_default

字符串

启用/禁用缓存缺少来自服务器的显式缓存策略的内容。

选择

  • "enable"

  • "disable"

字符串

启用/禁用缓存 cookie。由于 cookie 包含有关或针对个人用户的信息，因此它们通常不被缓存。

选择

  • "enable"

  • "disable"

cache_expired

字符串

启用/禁用缓存到达时已过期的 type-1 对象。

选择

  • "enable"

  • "disable"

default_ttl

整数

默认对象过期时间。这仅适用于那些未由 Web 服务器设置过期时间的对象。

external

字符串

启用/禁用外部 Web 缓存。

选择

  • "enable"

  • "disable"

fresh_factor

整数

检查服务器以查看是否有任何对象过期的频率 (1 - 100)。新鲜度因子越高，检查发生的频率越低。

host_validate

字符串

启用/禁用使用原始服务器 IP 验证“Host:”。

选择

  • "enable"

  • "disable"

ignore_conditional

字符串

启用/禁用控制 cache-control HTTP 1.1 标头值的行为。

选择

  • "enable"

  • "disable"

ignore_ie_reload

字符串

启用/禁用忽略 Internet Explorer 的 Accept: / 标头的 PNC 解释。

选择

  • "enable"

  • "disable"

ignore_ims

字符串

启用/禁用忽略 if-modified-since (IMS) 标头。

选择

  • "enable"

  • "disable"

ignore_pnc

字符串

启用/禁用忽略 pragma no-cache (PNC) 标头。

选择

  • "enable"

  • "disable"

max_object_size

整数

最大可缓存对象大小，单位为 kB (1 - 2147483 kb (2GB))。所有超出此大小的对象都将传递给客户端，但不会存储在 Web 缓存中。

max_ttl

整数

对象可以在 Web 缓存中停留的最大时间，而无需检查它是否已在服务器上过期。

min_ttl

整数

对象可以在 Web 缓存中停留的最小时间，而无需检查它是否已在服务器上过期。

neg_resp_time

整数

缓存否定响应或错误的时间（以分钟为单位）(0 - 4294967295)。

reval_pnc

字符串

启用/禁用重新验证 pragma-no-cache (PNC) 以解决带宽问题。

选择

  • "enable"

  • "disable"

备注

注意

  • 旧版 fortiosapi 已被弃用，httpapi 是运行 playbook 的首选方式

示例

- 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

字符串

fortigate 映像的版本号

已返回： 始终

示例： "1547"

http_method

字符串

上次用于将内容配置到 FortiGate 中的方法

已返回： 始终

示例： "PUT"

http_status

字符串

FortiGate 在上次应用的操作中给出的上次结果

已返回： 始终

示例： "200"

mkey

字符串

上次调用 FortiGate 时使用的主密钥 (id)

返回: 成功

示例: "id"

名称

字符串

用于满足请求的表的名称

已返回： 始终

示例: "urlfilter"

路径

字符串

用于满足请求的表的路径

已返回： 始终

示例: "webfilter"

修订号

字符串

内部修订号

已返回： 始终

示例: "17.0.2.10658"

序列号

字符串

设备的序列号

已返回： 始终

示例: "FGVMEVYYQT3AB5352"

状态

字符串

操作结果的指示

已返回： 始终

示例: "success"

vdom

字符串

使用的虚拟域

已返回： 始终

示例: "root"

版本

字符串

FortiGate 的版本

已返回： 始终

示例: "v5.6.3"

作者

  • Link Zheng (@chillancezen)

  • Jie Xue (@JieX19)

  • Hongbin Lu (@fgtdev-hblu)

  • Frank Shen (@frankshen01)

  • Miguel Angel Munoz (@mamunozgonzalez)

  • Nicolas Thomas (@thomnico)