infoblox.nios_modules.nios_dtc_monitor_http 模块 – 配置 Infoblox NIOS DTC HTTP 监控器

注意

此模块是 infoblox.nios_modules 集合（版本 1.7.1）的一部分。

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

要安装它，请使用：ansible-galaxy collection install infoblox.nios_modules。您需要进一步的要求才能使用此模块，有关详细信息，请参阅要求。

要在 playbook 中使用它，请指定：infoblox.nios_modules.nios_dtc_monitor_http。

infoblox.nios_modules 1.6.0 中的新增功能

概要 

从 Infoblox NIOS 服务器添加和/或删除 DTC HTTP 监控器对象的实例。此模块使用 REST 上的 Infoblox WAPI 接口管理 dtc:monitor:http 对象。

要求 

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

infoblox-client

参数 

参数	注释
ciphers 字符串	为安全的 HTTP/S 连接配置一个可选的密码列表。
client_cert 字符串	如果存在，则在安全的 HTTP/S 模式下配置可选的客户端证书。
comment 字符串	配置一个文本字符串注释，与此对象的实例关联。提供的文本字符串将在对象实例上配置。
content_check 字符串	配置内容检查类型选项 `"EXTRACT"` `"MATCH"` `"NONE"` ← (默认)
content_check_input 字符串	配置响应中用作内容检查输入的部分。选项 `"ALL"` ← (默认) `"BODY"` `"HEADERS"`
content_check_op 字符串	配置内容检查成功条件运算符。选项 `"EQ"` `"GEQ"` `"LEQ"` `"NEQ"`
content_check_regex 字符串	配置内容检查正则表达式。带有前导或尾随空格的值对此字段无效。
content_extract_group 整数	配置要提取的内容提取子表达式。默认值: `0`
content_extract_type 字符串	配置提取数据的预期内容提取类型。选项 `"INTEGER"` `"STRING"` ← (默认)
content_extract_value 字符串	配置要与提取结果比较的内容提取值。带有前导或尾随空格的值对此字段无效。
enable_sni 布尔值	配置是否启用 HTTPS 监控器的服务器名称指示 (SNI)。选项 `false` ← (默认) `true`
extattrs 字典	允许在对象的实例上配置可扩展属性。此参数接受一组用于配置的键/值对。
interval 整数	配置 HTTP 健康检查的间隔。默认值: `5`
name 字符串 / 必需	配置此 DTC 监控器的显示名称。带有前导或尾随空格的值对此字段无效。
port 整数	配置 HTTP 请求的端口值。默认值: `80`
provider 字典	一个包含连接详细信息的字典对象。
cert 字符串	指定客户端证书文件，其中包含 x509 配置的摘要，以便为 NIOS 的远程实例提供额外的安全连接层。也可以使用 `INFOBLOX_CERT` 环境变量指定值。
host 字符串	指定 DNS 主机名或地址，用于通过 REST 连接到 NIOS WAPI 的远程实例也可以使用 `INFOBLOX_HOST` 环境变量指定值。
http_pool_connections 整数	在此处插入说明默认值: `10`
http_pool_maxsize 整数	在此处插入描述默认值: `10`
http_request_timeout 整数	等待接收响应的时间也可以使用 `INFOBLOX_HTTP_REQUEST_TIMEOUT` 环境变量指定值。默认值: `10`
key 字符串	指定私钥文件，用于使用证书加密，以便连接 NIOS 的远程实例。也可以使用 `INFOBLOX_KEY` 环境变量指定值。
max_results 整数	指定要返回的最大对象数，如果设置为负数，则当返回的对象数超过设置时，设备将返回错误。也可以使用 `INFOBLOX_MAX_RESULTS` 环境变量指定值。默认值: `1000`
max_retries 整数	配置在声明连接可用之前尝试的重试次数也可以使用 `INFOBLOX_MAX_RETRIES` 环境变量指定值。默认值: `3`
密码字符串	指定用于验证与 NIOS 远程实例连接的密码。也可以使用 `INFOBLOX_PASSWORD` 环境变量指定该值。
静默 SSL 警告布尔值	在此处插入描述选项 `false` `true` ←（默认）
用户名字符串	配置用于验证与 NIOS 远程实例连接的用户名。也可以使用 `INFOBLOX_USERNAME` 环境变量指定该值。
validate_certs 别名：ssl_verify 布尔值	启用或禁用验证 SSL 证书的布尔值也可以使用 `INFOBLOX_SSL_VERIFY` 环境变量指定该值。选项 `false` ← (默认) `true`
wapi_version 字符串	指定要使用的 WAPI 版本也可以使用 `INFOBLOX_WAPI_VERSION` 环境变量指定该值。在 Ansible 2.8 之前，默认的 WAPI 是 1.4 默认值： `"2.12.3"`
请求字符串	配置要发送的 HTTP 请求默认值： `"GET /"`
结果字符串	配置预期结果的类型选项 `"ANY"` ←（默认） `"CODE_IS"` `"CODE_IS_NOT"`
result_code 整数	配置预期的返回代码默认值： `200`
retry_down 整数	配置服务器在被视为已恢复后，应被视为关闭的次数。默认值： `1`
retry_up 整数	配置服务器在被视为关闭后，应被视为已恢复的次数。默认值： `1`
安全布尔值	配置连接的安全状态。选项 `false` ← (默认) `true`
状态字符串	配置 NIOS 服务器上对象实例的预期状态。当此值设置为 `present` 时，会在设备上配置该对象，当此值设置为 `absent` 时，会从设备中删除该值（如果需要）。选项 `"present"` ←（默认） `"absent"`
超时整数	配置 HTTP 健康检查的超时时间（以秒为单位）。默认值： `15`
validate_cert 布尔值	配置是否启用远程服务器证书的验证。选项 `false` `true` ←（默认）

注释 

注意

此模块支持 check_mode。
此模块必须在本地运行，可以通过指定 connection: local 来实现。
请阅读 :ref:`nios_guide` 以获取有关如何在 Ansible 中使用 Infoblox 的更多详细信息。

示例 

- name: Configure a DTC HTTPS monitor
  infoblox.nios_modules.nios_dtc_monitor_http:
    name: https_monitor
    port: 443
    secure: true
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Add a comment to an existing DTC HTTPS monitor
  infoblox.nios_modules.nios_dtc_monitor_http:
    name: https_monitor
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove a DTC HTTPS monitor from the system
  infoblox.nios_modules.nios_dtc_monitor_http:
    name: https_monitor
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

作者

Joachim Buyse (@jbisabel)