infoblox.nios_modules.nios_nsgroup_forwardingmember 模块 – 配置 Infoblox DNS 名称服务器转发成员组

注意

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

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

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

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

infoblox.nios_modules 1.7.0 中的新增功能

概要 

从 Infoblox NIOS 服务器添加和/或删除类型为“转发成员”的名称服务器组。此模块使用 Infoblox. WAPI 接口通过 REST 管理 NIOS nsgroup:forwardstubserver 对象。

要求 

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

infoblox_client

参数 

参数	注释
comment 字符串	配置与此对象的实例关联的文本字符串注释。提供的文本字符串将在对象实例上配置。
extattrs 字典	允许在对象的实例上配置可扩展属性。此参数接受一组键/值对以进行配置。
forwarding_servers 列表 / 元素=字典 / 必需	指定要使用的转发成员服务器列表
forward_to 列表 / 元素=字典	您希望 Infoblox 设备将对指定域名的查询转发到的远程名称服务器的信息。默认值： `[]`
address 字符串 / 必需	提供服务器的 IP 地址
name 字符串 / 必需	提供服务器的名称
forwarders_only 布尔值	确定设备是否仅将查询发送给转发器，而不发送给其他内部或 Internet 根服务器。选项 `false` ←（默认） `true`
name 字符串 / 必需	转发网格成员的名称，采用 FQDN 格式
use_override_forwarders 布尔值	使用 c(forward_to) 选项时，如果将其设置为 `True`，则仅使用定义的自定义转发器（不递归到根名称服务器）。选项 `false` ←（默认） `true`
name 字符串 / 必需	指定要管理的 NIOS 名称服务器组的名称。
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"`
state 字符串	配置 NIOS 服务器上对象实例的预期状态。当此值设置为 `present` 时，将在设备上配置该对象；当此值设置为 `absent` 时，将从设备中删除该值（如果需要）。选项 `"present"` ← (默认) `"absent"`

备注 

注意

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

示例 

- name: create infoblox nameserver forwarding member group
  infoblox.nios_modules.nios_nsgroup_forwardingmember:
    name: my-forwardingmember-group
    comment: "this is a forwarding member nameserver group"
    forwarding_servers:
      - name: member.localdomain
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: create infoblox nameserver forwarding member group with external forwarders
  infoblox.nios_modules.nios_nsgroup_forwardingmember:
    name: my-forwardingmember-group
    comment: "this is a forwarding member nameserver group with external forwarders"
    forwarding_servers:
      - name: member.localdomain
        use_override_forwarders: true
        forward_to:
          - name: ns1
            address: 192.168.10.1
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

作者

Mauricio Teixeira (@badnetmask)