infoblox.nios_modules.nios_dtc_topology 模块 – 配置 Infoblox NIOS DTC 拓扑

注意

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

infoblox.nios_modules 1.6.0 中的新功能

概要 

从 Infoblox NIOS 拓扑添加和/或删除 DTC 拓扑对象的实例。此模块使用 REST over Infoblox WAPI 接口管理 NIOS dtc:topology 对象。

要求 

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

infoblox-client

参数 

参数	注释
comment 字符串	配置与此对象实例关联的文本字符串注释。提供的文本字符串将配置在对象实例上。
extattrs 字典	允许在对象的实例上配置可扩展属性。此参数接受一组用于配置的键/值对。
name 字符串 / 必需	指定 DTC 拓扑显示名称。
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"`
rules 列表 / 元素=字典	配置拓扑规则
dest_type 字符串 / 必需	配置此 DTC 拓扑规则的目标类型。选项 `"POOL"` `"SERVER"`
destination_link 字符串	配置目标 DTC 池或 DTC 服务器的名称。
return_type 字符串	配置规则的 DNS 响应类型。选项 `"NOERR"` `"NXDOMAIN"` `"REGULAR"` ← （默认）
sources 列表 / 元素=字典	配置匹配源的条件。应为空以将规则设置为默认目标。
source_op 字符串	配置用于匹配值的操作。选项 `"IS"` `"IS_NOT"`
source_type 字符串 / 必需	配置源类型。选项 `"CITY"` `"CONTINENT"` `"COUNTRY"` `"EA0"` `"EA1"` `"EA2"` `"EA3"` `"SUBDIVISION"` `"SUBNET"`
source_value 字符串 / 必需	配置源值。
state 字符串	配置 NIOS 拓扑上对象实例的预期状态。当此值设置为 `present` 时，将在设备上配置对象；当此值设置为 `absent` 时，将（如果必要）从设备中删除该值。选项 `"present"` ← （默认） `"absent"`

注释 

注意

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

示例 

- name: Configure a DTC Topology
  infoblox.nios_modules.nios_dtc_topology:
    name: a_topology
    rules:
      - dest_type: POOL
        destination_link: web_pool1
        return_type: REGULAR
        sources:
          - source_op: IS
            source_type: EA0
            source_value: DC1
      - dest_type: POOL
        destination_link: web_pool2
        return_type: REGULAR
        sources:
          - source_op: IS
            source_type: EA0
            source_value: DC2
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Add a comment to a DTC topology
  infoblox.nios_modules.nios_dtc_topology:
    name: a_topology
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove a DTC Topology from the system
  infoblox.nios_modules.nios_dtc_topology:
    name: a_topology
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

作者

Joachim Buyse (@jbisabel)