infoblox.nios_modules.nios_network 模块 – 配置 Infoblox NIOS 网络对象

注意

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

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

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

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

infoblox.nios_modules 1.0.0 中的新增功能

概要 

添加和/或删除 Infoblox NIOS 服务器上的网络对象实例。此模块使用通过 REST 的 Infoblox WAPI 接口管理 NIOS network 对象。
支持 IPv4 和 IPv6 两种互联网协议。

要求 

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

infoblox-client

参数 

参数	注释
comment 字符串	配置与该对象实例关联的文本字符串注释。提供的文本字符串将在对象实例上配置。
container 布尔值	如果设置为 true，它将创建要添加到或从系统中删除的网络容器。选项 `false` `true`
extattrs 字典	允许在对象实例上配置可扩展属性。此参数接受一组键/值对进行配置。
logic_filter_rules 列表 / 元素=字典	配置要应用于网络对象的逻辑过滤器规则。此参数接受逻辑过滤器规则列表（见子选项）。省略时，使用空列表的默认值。默认值： `[]`
filter 字符串	要应用于网络对象的逻辑过滤器的名称。
type 字符串	要应用于网络对象的逻辑过滤器的类型。
members 列表 / 元素=字典	配置已配置网络实例的 NIOS 成员分配。此参数接受成员名称列表（见子选项）。省略时，使用空列表的默认值。如果字段“container”设置为 true，则忽略此字段。默认值： `[]`
name 字符串	要分配给此网络的 NIOS 成员的名称。
network 别名：name，cidr 字符串 / 必需	指定要添加到或从系统中删除的网络。该值应使用 CIDR 表示法。
network_view 字符串	配置要与此配置实例关联的网络视图的名称。默认值： `"default"`
options 列表 / 元素=字典	配置作为已配置网络实例一部分包含的一组 DHCP 选项。此参数接受值列表（见子选项）。在配置子选项时，必须至少指定 `name` 或 `num` 之一。默认值： `[]`
name 字符串	要配置的 DHCP 选项的名称。标准选项为 `router`、`router-templates`、`domain-name-servers`、`domain-name`、`broadcast-address`、`broadcast-address-offset`、`dhcp-lease-time` 和 `dhcp6.name-servers`。
num 整数	要配置的 DHCP 选项的编号
use_option 布尔值	仅适用于部分选项（见 NIOS API 文档）选项 `false` `true` ← (默认)
value 字符串 / 必需	由 `name` 指定的 DHCP 选项的值
vendor_class 字符串	此 DHCP 选项关联到的空间的名称默认值： `"DHCP"`
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"`
state 字符串	配置 NIOS 服务器上对象实例的预期状态。当此值设置为 `present` 时，对象在设备上配置；当此值设置为 `absent` 时，该值将从设备中删除（如有必要）。选项 `"present"` ← (默认) `"absent"`
template 字符串	如果在创建时设置，则网络将根据所选模板中指定的值创建。
use_logic_filter_rules 布尔值	如果设置为 true，它将覆盖上层应用的逻辑过滤器列表。选项 `false` ← (默认) `true`

备注 

注意

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

示例 

- name: Configure a network ipv4
  infoblox.nios_modules.nios_network:
    network: 192.168.10.0/24
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Configure a network ipv6
  infoblox.nios_modules.nios_network:
    network: fe80::/64
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Create network with member assignment for a network ipv4
  infoblox.nios_modules.nios_network:
    network: 192.168.10.0/24
    comment: This is a test comment
    members:
      - name: member1.infoblox
      - name: member2.infoblox
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove member assignment form ipv4 network
  infoblox.nios_modules.nios_network:
    network: 192.168.10.0/24
    comment: This is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Set dhcp options for a network ipv4
  infoblox.nios_modules.nios_network:
    network: 192.168.10.0/24
    comment: this is a test comment
    options:
      - name: domain-name
        value: ansible.com
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Set filters for a network ipv4
  infoblox.nios_modules.nios_network:
    network: 192.168.10.0/24
    comment: this is a test comment
    use_logic_filter_rules: true
    logic_filter_rules:
      - filter: PXE-UEFI
        type: Option
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove a network ipv4
  infoblox.nios_modules.nios_network:
    network: 192.168.10.0/24
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Configure an ipv4 network container
  infoblox.nios_modules.nios_network:
    network: 192.168.10.0/24
    container: true
    comment: test network container
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Configure an ipv6 network container
  infoblox.nios_modules.nios_network:
    network: fe80::/64
    container: true
    comment: test network container
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove an ipv4 network container
  infoblox.nios_modules.nios_network:
    networkr: 192.168.10.0/24
    container: true
    comment: test network container
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

作者

Peter Sprygada (@privateip)
Matthew Dennett (@matthewdennett)