infoblox.nios_modules.nios_naptr_record 模块 – 配置 Infoblox NIOS NAPTR 记录

注意

此模块是 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_naptr_record。

infoblox.nios_modules 1.0.0 中的新增功能

概要 

添加和/或删除 Infoblox NIOS 服务器上的 NAPTR 记录对象实例。此模块使用通过 REST 的 Infoblox WAPI 接口管理 NIOS record:naptr 对象。

需求 

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

infoblox_client

参数 

参数	注释
comment 字符串	配置要与该对象实例关联的文本字符串注释。提供的文本字符串将在对象实例上进行配置。
extattrs 字典	允许在对象实例上配置可扩展属性。此参数接受一组键/值对进行配置。
flags 字符串	配置此 NAPTR 记录的 flags 字段。这些控制 NAPTR 记录对象的字段解释。flags 字段支持的值为“U”、“S”、“P”和“A”。
name 字符串 / 必需	指定要添加到系统或从中移除的完全限定主机名。
order 整数	配置此 NAPTR 记录的顺序 (0-65535)。此参数指定存在多个规则时应用 NAPTR 规则的顺序。
preference 整数	配置此 NAPTR 记录的首选值 (0-65535)。当存在多个具有相同 order 参数的记录时，preference 字段决定处理 NAPTR 记录的顺序。
provider 字典	包含连接详细信息的字典对象。
cert 字符串	指定客户端证书文件，其中包含 x509 配置摘要，用于为与 NIOS 远程实例的安全连接提供额外保护。值也可以使用 `INFOBLOX_CERT` 环境变量指定。
host 字符串	指定用于通过 REST 连接到 NIOS WAPI 远程实例的 DNS 主机名或地址。值也可以使用 `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"`
regexp 字符串	配置此 NAPTR 记录的 regexp 字段。这是 NAPTR 记录的基于正则表达式的重写规则。这应该是一个符合 POSIX 标准的正则表达式，包括替换规则和标志。有关字段语法详细信息，请参阅 RFC 2915。
replacement 字符串	配置此 NAPTR 记录的替换字段。对于非终端 NAPTR 记录，此字段指定要查找的下一个域名。
services 字符串	配置此 NAPTR 记录的服务字段（最大 128 个字符）。服务字段包含协议和服务标识符，例如“http+E2U”或“SIPS+D2T”。
state 字符串	配置 NIOS 服务器上对象实例的预期状态。当此值设置为 `present` 时，对象在设备上进行配置；当此值设置为 `absent` 时，该值将从设备中移除（如有必要）。选项 `"present"` ← (默认) `"absent"`
ttl 整数	配置与此 NAPTR 记录关联的 TTL。
view 别名：dns_view 字符串	设置将此记录与之关联的 DNS 视图。DNS 视图必须已在系统上配置。默认值： `"default"`

备注 

注意

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

示例 

- name: Configure an NAPTR record
  infoblox.nios_modules.nios_naptr_record:
    name: '*.subscriber-100.ansiblezone.com'
    order: 1000
    preference: 10
    replacement: replacement1.network.ansiblezone.com
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Add a comment to an existing NAPTR record
  infoblox.nios_modules.nios_naptr_record:
    name: '*.subscriber-100.ansiblezone.com'
    order: 1000
    preference: 10
    replacement: replacement1.network.ansiblezone.com
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove an NAPTR record from the system
  infoblox.nios_modules.nios_naptr_record:
    name: '*.subscriber-100.ansiblezone.com'
    order: 1000
    preference: 10
    replacement: replacement1.network.ansiblezone.com
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

作者

Blair Rampling (@brampling)