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。您需要进一步的要求才能使用此模块，有关详细信息，请参阅要求。

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

infoblox.nios_modules 1.0.0 中的新功能

概要 

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

要求 

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

infoblox_client

参数 

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