infoblox.nios_modules.nios_nsgroup_delegation 模块 – 配置 Infoblox DNS 名称服务器委派组

注意

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

infoblox.nios_modules 1.7.0 中的新功能

概要

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

要求

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

  • infoblox_client

参数

参数

注释

comment

字符串

配置一个文本字符串注释,以与此对象的实例关联。提供的文本字符串将在对象实例上配置。

delegate_to

列表 / 元素=字典 / 必需

指定要使用的名称服务器列表

address

字符串 / 必需

提供服务器的 IP 地址

name

字符串 / 必需

提供服务器的名称

extattrs

字典

允许在对象的实例上配置可扩展属性。此参数接受一组用于配置的键/值对。

name

字符串 / 必需

指定要管理的 NIOS 名称服务器组的名称。

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"

state

字符串

配置 NIOS 服务器上对象的实例的预期状态。当此值设置为 present 时,将在设备上配置对象,当此值设置为 absent 时,将从设备中删除该值(如果需要)。

选择

  • "present" ←(默认)

  • "absent"

注释

注意

  • 此模块必须在本地运行,这可以通过指定 connection: local 来实现。

  • 请阅读 :ref:`nios_guide` 以获取关于如何将 Infoblox 与 Ansible 结合使用的更多详细信息。

示例

- name: create infoblox nameserver delegation group
  infoblox.nios_modules.nios_nsgroup_delegation:
    name: my-delegation-group
    comment: "this is a delegation nameserver group"
    delegate_to:
      - name: first
        address: 192.168.0.10
      - name: second
        address: 192.168.0.20
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

作者

  • Mauricio Teixeira (@badnetmask)