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
password 字符串	指定用于连接到 NIOS 远程实例进行身份验证的密码。 也可以使用 INFOBLOX_PASSWORD 环境变量指定该值。
silent_ssl_warnings 布尔值	在此处插入描述 选择 false true ← (默认)
username 字符串	配置用于连接到 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"
request 字符串	配置要发送的 HTTP 请求 默认值： "GET /"
result 字符串	配置期望的结果类型 选择 "ANY" ← (默认) "CODE_IS" "CODE_IS_NOT"
result_code 整数	配置期望的返回代码 默认值： 200
retry_down 整数	配置服务器在处于活动状态后，被视为失效的次数。 默认值： 1
retry_up 整数	配置服务器在处于失效状态后，被视为活动的次数。 默认值： 1
secure 布尔值	配置连接的安全状态。 选择 false ←（默认） true
state 字符串	配置 NIOS 服务器上对象实例的预期状态。当此值设置为 present 时，将在设备上配置对象；当此值设置为 absent 时，将从设备中删除该值（如果需要）。 选择 "present" ← (默认) "absent"
timeout 整数	配置 HTTP 健康检查的超时时间（以秒为单位）。 默认值： 15
validate_cert 布尔值	配置是否启用远程服务器证书的验证。 选择 false true ← (默认)

说明

注意

• 此模块支持 check_mode。

• 此模块必须在本地运行，可以通过指定 connection: local 来实现。

• 请阅读 :ref:`nios_guide` 以获取有关如何使用 Infoblox 和 Ansible 的更多详细信息。

示例

- 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)

集合链接

• 问题跟踪器
• 主页
• 存储库 (源代码)