infoblox.nios_modules.nios_ptr_record 模块 – 配置 Infoblox NIOS PTR 记录

注意

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

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

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

要在剧本中使用它，请指定：infoblox.nios_modules.nios_ptr_record。

infoblox.nios_modules 1.0.0 中的新增功能

概要 

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

要求 

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

infoblox_client

参数 

参数	注释
comment 字符串	配置要与此对象实例关联的文本字符串注释。提供的文本字符串将在对象实例上配置。最多 256 个字符。
extattrs 字典	允许在对象的实例上配置可扩展属性。此参数接受一组用于配置的键/值对。
ipv4addr 别名：ipv4 字符串	记录的 IPv4 地址。与 ipv6addr 互斥。
ipv6addr 别名：ipv6 字符串	记录的 IPv6 地址。与 ipv4addr 互斥。
name 字符串	要从系统中添加或删除的 FQDN 格式的 DNS PTR 记录的名称。该字段仅对于正向映射区域中的 PTR 对象是必需的。
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"`
ptrdname 字符串 / 必需	FQDN 格式的 DNS PTR 记录的域名。
state 字符串	在 NIOS 服务器上配置对象实例的预期状态。当此值设置为 `present` 时，该对象会在设备上进行配置，当此值设置为 `absent` 时，该值将从设备中删除（如果需要）。选项 `"present"` ← (默认) `"absent"`
ttl 整数	记录的生存时间 (TTL) 值。一个 32 位无符号整数，表示记录有效的持续时间（以秒为单位）（缓存时间）。零表示不应缓存该记录。
视图 (view) 别名: dns_view 字符串	设置此 A 记录关联的 DNS 视图。DNS 视图必须已在系统上配置。默认值: `"default"`

注释 

注意

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

示例 

- name: Create a PTR Record
  infoblox.nios_modules.nios_ptr_record:
    ipv4: 192.168.10.1
    ptrdname: host.ansible.com
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Delete a PTR Record
  infoblox.nios_modules.nios_ptr_record:
    ipv4: 192.168.10.1
    ptrdname: host.ansible.com
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

作者

Trebuchet Clement (@clementtrebuchet)