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 记录对象的实例。此模块使用 Infoblox WAPI 接口通过 REST 管理 NIOS record:naptr 对象。

要求 

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

infoblox_client

参数 

参数	注释
comment 字符串	配置要与此对象的实例关联的文本字符串注释。提供的文本字符串将配置在对象实例上。
extattrs 字典	允许在对象的实例上配置可扩展属性。此参数接受一组键/值对进行配置。
flags 字符串	配置此 NAPTR 记录的标志字段。这些控制 NAPTR 记录对象的字段的解释。标志字段支持的值为“U”、“S”、“P”和“A”。
name 字符串 / 必需	指定要从系统中添加或删除的完全限定主机名。
order 整数	配置此 NAPTR 记录的顺序 (0-65535)。此参数指定当存在多个规则时应用 NAPTR 规则的顺序。
preference 整数	配置此 NAPTR 记录的优先级 (0-65535)。当存在具有相同顺序参数的多个记录时，优先级字段确定处理 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 记录的 services 字段（最多 128 个字符）。services 字段包含协议和服务标识符，例如 “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)