Модуль infoblox.nios_modules.nios_range — настройка объекта диапазона сети Infoblox NIOS

Примечание

Этот модуль входит в коллекцию infoblox.nios_modules (версия 1.9.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install infoblox.nios_modules. Для использования этого модуля могут потребоваться дополнительные компоненты. Подробнее см. в разделе Требования.

Чтобы использовать его в плейбуке, укажите: infoblox.nios_modules.nios_range.

Добавлено в infoblox.nios_modules 1.5.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

Добавляет и/или удаляет экземпляры объектов диапазонов на серверах Infoblox NIOS. Этот модуль управляет объектами DHCP-диапазонов NIOS через интерфейс Infoblox WAPI с использованием REST.
Поддерживаются интернет-протоколы IPv4 и IPv6.

Требования

На узле, на котором выполняется этот модуль, необходимы следующие компоненты.

infoblox-client

Параметры

Параметр	Комментарии
comment string	Задаёт текстовый комментарий, связанный с экземпляром этого объекта. Указанный текст будет сохранён в экземпляре объекта.
disable boolean	Определяет, отключён ли диапазон. Если установлено значение False, диапазон включён. Варианты: `false` ← (по умолчанию) `true`
end_addr псевдонимы: end, last_addr, last string / обязательный	Задаёт конечный IP-адрес экземпляра объекта. Если при создании задан параметр ‘new_end_addr’, это значение заменяется значением ‘new_end_addr’.
extattrs dictionary	Позволяет настраивать расширяемые атрибуты экземпляра объекта. Этот аргумент принимает набор пар «ключ — значение» для настройки.
failover_association string	Имя ассоциации отказоустойчивости DHCP, которая будет настроена для обслуживания этого экземпляра объекта. Можно настроить отказоустойчивость для участников MS или NIOS. Нельзя задавать одновременно с параметрами ‘ms_server’ или ‘member’.
member string	Имя узла участника NIOS, который будет настроен для обслуживания этого экземпляра объекта. Нельзя задавать одновременно с параметрами ‘ms_server’ или ‘failover_association’.
ms_server string	Имя узла участника MS, который будет настроен для обслуживания этого экземпляра объекта. Нельзя задавать одновременно с параметрами ‘member’ или ‘failover_association’.
name string	Задаёт имя области Microsoft для экземпляра объекта на сервере NIOS.
network псевдонимы: cidr string / обязательный	Указывает сеть, в которую нужно добавить или из которой нужно удалить DHCP-диапазон. Значение следует указывать в нотации CIDR.
network_view string	Задаёт имя сетевого представления, с которым будет связан настраиваемый экземпляр. По умолчанию: `"default"`
new_end_addr псевдонимы: new_end, new_last_addr, new_last string	Задаёт новый конечный IP-адрес экземпляра объекта.
new_start_addr псевдонимы: new_start, new_first_addr, new_first string	Задаёт новый начальный IP-адрес экземпляра объекта.
options list / элементы=dictionary	Задаёт набор параметров DHCP, включаемых в настроенный экземпляр сети. Этот аргумент принимает список значений (см. вложенные параметры). При настройке вложенных параметров необходимо указать хотя бы один из параметров `name` или `num`. По умолчанию: `[]`
name string	Имя настраиваемого параметра DHCP. Стандартные параметры: `router`, `router-templates`, `domain-name-servers`, `domain-name`, `broadcast-address`, `broadcast-address-offset`, `dhcp-lease-time` и `dhcp6.name-servers`.
num integer	Номер настраиваемого параметра DHCP.
use_option boolean	Применяется только к некоторым параметрам (см. документацию API NIOS). Варианты: `false` `true` ← (по умолчанию)
value string / обязательный	Значение параметра DHCP, указанного в `name`.
vendor_class string	Имя пространства, с которым связан этот параметр DHCP. По умолчанию: `"DHCP"`
provider dictionary	Словарь с параметрами подключения.
cert string	Указывает файл сертификата клиента с дайджестом конфигурации x509 для дополнительной защиты соединения с удалённым экземпляром NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_CERT`.
host string	Указывает DNS-имя узла или адрес для подключения к удалённому экземпляру NIOS WAPI через REST. Значение также можно указать с помощью переменной среды `INFOBLOX_HOST`.
http_pool_connections integer	Вставьте описание здесь. По умолчанию: `10`
http_pool_maxsize integer	Вставьте описание здесь. По умолчанию: `10`
http_request_timeout integer	Время ожидания ответа. Значение также можно указать с помощью переменной среды `INFOBLOX_HTTP_REQUEST_TIMEOUT`. По умолчанию: `10`
key string	Указывает файл закрытого ключа для шифрования с помощью сертификата при подключении к удалённому экземпляру NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_KEY`.
max_results integer	Указывает максимальное количество возвращаемых объектов. Если задано отрицательное число, устройство вернёт ошибку, когда количество возвращаемых объектов превысит указанное значение. Значение также можно указать с помощью переменной среды `INFOBLOX_MAX_RESULTS`. По умолчанию: `1000`
max_retries integer	Задаёт количество повторных попыток до признания соединения работоспособным. Значение также можно указать с помощью переменной среды `INFOBLOX_MAX_RETRIES`. По умолчанию: `3`
password string	Указывает пароль для аутентификации при подключении к удалённому экземпляру NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_PASSWORD`.
silent_ssl_warnings boolean	Вставьте описание здесь. Варианты: `false` `true` ← (по умолчанию)
username string	Задаёт имя пользователя для аутентификации при подключении к удалённому экземпляру NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_USERNAME`.
validate_certs псевдонимы: ssl_verify boolean	Логическое значение, включающее или отключающее проверку SSL-сертификатов. Значение также можно указать с помощью переменной среды `INFOBLOX_SSL_VERIFY`. Варианты: `false` ← (по умолчанию) `true`
wapi_version string	Указывает версию WAPI. Значение также можно указать с помощью переменной среды `INFOBLOX_WAPI_VERSION`. До Ansible 2.8 версия WAPI по умолчанию была 1.4. По умолчанию: `"2.12.3"`
server_association_type string	Задаёт тип ассоциации с сервером, назначаемой для обслуживания этого экземпляра объекта. Указывать это значение не обязательно: оно будет автоматически задано при выполнении модуля, если потребуется. Варианты: `"NONE"` `"FAILOVER"` `"MEMBER"` `"FAILOVER_MS"` `"MS_SERVER"`
start_addr псевдонимы: start, first_addr, first string / обязательный	Задаёт начальный IP-адрес экземпляра объекта. Если при создании задан параметр ‘new_start_addr’, это значение заменяется значением ‘new_start_addr’.
state string	Задаёт требуемое состояние экземпляра объекта на сервере NIOS. Если указано значение `present`, объект настраивается на устройстве; если указано значение `absent`, объект удаляется с устройства (если это необходимо). Варианты: `"present"` ← (по умолчанию) `"absent"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль необходимо запускать локально. Для этого можно указать connection: local.
Дополнительные сведения об использовании Infoblox с Ansible см. в руководстве :ref:`nios_guide`.

Примеры

- 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)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/infoblox/nios_modules/nios_range_module.html