infoblox.nios_modules.nios_range 模块 – 配置 Infoblox NIOS 网络范围对象

注意

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

infoblox.nios_modules 1.5.0 中的新增功能

概要 

从 Infoblox NIOS 服务器添加和/或删除范围对象的实例。此模块使用 Infoblox WAPI 接口通过 REST 管理 NIOS DHCP 范围对象。
支持 IPV4 和 IPV6 互联网协议。

要求 

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

infoblox-client

参数 

参数	注释
评论字符串	配置要与此对象的实例关联的文本字符串注释。提供的文本字符串将在对象实例上配置。
禁用布尔值	确定是否禁用范围。当此设置为 False 时，将启用该范围。选项 `false` ← (默认) `true`
end_addr 别名：end、last_addr、last 字符串 / 必选	配置此对象实例结束时的 IP 地址。如果在创建操作期间定义了“new_end_addr”，则此值将被“new_end_addr”的值覆盖。
extattrs 字典	允许在对象的实例上配置可扩展属性。此参数接受一组用于配置的键/值对。
failover_association 字符串	将配置为为此对象实例提供服务的 DHCP 故障转移关联的名称。可以配置 MS 或 Nios 成员的故障转移。配置“ms_server”或“member”时无法配置。
成员字符串	将配置为为此对象实例提供服务的 Nios 成员的主机名。配置“ms_server”或“failover_association”时无法配置。
ms_server 字符串	将配置为为此对象实例提供服务的 MS 成员的主机名。配置“member”或“failover_association”时无法配置。
名称字符串	在 NIOS 服务器上配置对象实例的 Microsoft 范围的名称。
网络别名：cidr 字符串 / 必选	指定要向其添加或从中删除 DHCP 范围的网络。该值应使用 CIDR 表示法。
network_view 字符串	配置要与此配置的实例关联的网络视图的名称。默认值： `"default"`
new_end_addr 别名：new_end、new_last_addr、new_last 字符串	配置要将此对象实例更新为结束的 IP 地址。
new_start_addr 别名：new_start、new_first_addr、new_first 字符串	配置要从此对象实例开始的 IP 地址。
选项列表 / 元素=字典	配置要作为配置的网络实例一部分包含的 DHCP 选项集。此参数接受值列表（请参阅子选项）。配置子选项时，必须至少指定 `name` 或 `num` 之一。默认值： `[]`
名称字符串	要配置的 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` ← (默认)
值字符串 / 必选	由 `name` 指定的 DHCP 选项的值
vendor_class 字符串	此 DHCP 选项关联的空间的名称默认值： `"DHCP"`
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"`
server_association_type 字符串	配置将分配给此对象实例的服务类型的服务器关联。此值不是必需的，将在模块执行期间根据需要自动设置。选项 `"NONE"` `"FAILOVER"` `"MEMBER"` `"FAILOVER_MS"` `"MS_SERVER"`
start_addr 别名：start, first_addr, first 字符串 / 必选	配置此对象实例开始的 IP 地址。如果在创建操作期间定义了“new_start_addr”，则此值将被“new_start_addr”的值覆盖。
state 字符串	配置 NIOS 服务器上对象实例的预期状态。当此值设置为 `present` 时，将在设备上配置该对象；当此值设置为 `absent` 时，将从设备中删除该值（如果必要）。选项 `"present"` ← (默认) `"absent"`

注释 

注意

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

示例 

- name: Configure a ipv4 reserved range
  infoblox.nios_modules.nios_range:
    network: 192.168.10.0/24
    start: 192.168.10.10
    end: 192.168.10.20
    name: Test Range 1
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Upadtes a ipv4 reserved range
  infoblox.nios_modules.nios_range:
    network: 192.168.10.0/24
    start: 192.168.10.10
    new_start: 192.168.10.5
    end: 192.168.10.20
    new_end: 192.168.10.50
    name: Test Range 1
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Configure a ipv4 range served by a member
  infoblox.nios_modules.nios_range:
    network: 192.168.10.0/24
    start: 192.168.10.10
    end: 192.168.10.20
    name: Test Range 1
    member: infoblox1.localdomain
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Configure a ipv4 range served by a failover association
  infoblox.nios_modules.nios_range:
    network: 192.168.10.0/24
    start: 192.168.10.10
    end: 192.168.10.20
    name: Test Range 1
    failover_association: fo_association_01
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Configure a ipv4 range with options
  infoblox.nios_modules.nios_range:
    network: 18.10.0.0/24
    network_view: custom
    start_addr: 18.10.0.12
    end_addr: 18.10.0.14
    options:
      - name: domain-name
        value: zone1.com
    comment: Created with Ansible
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Configure a ipv4 range served by a MS Server
  infoblox.nios_modules.nios_range:
    network: 192.168.10.0/24
    start: 192.168.10.10
    end: 192.168.10.20
    name: Test Range 1
    ms_server: dc01.ad.localdomain
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

作者

Matthew Dennett (@matthewdennett)