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

Примечание

Этот модуль входит в коллекцию infoblox.nios_modules (версия 1.7.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 строка	Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Указанная строка будет настроена в экземпляре объекта.
disable логическое	Определяет, отключен ли диапазон. При значении 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’.
member строка	Имя хоста члена Nios, который будет настроен для обслуживания этого экземпляра объекта. Не может быть настроено, когда настроены ‘ms_server’ или ‘failover_association’.
ms_server строка	Имя хоста члена MS, который будет настроен для обслуживания этого экземпляра объекта. Не может быть настроено, когда настроены ‘member’ или ‘failover_association’.
name строка	Настраивается имя Microsoft-диапазона для экземпляра объекта на сервере NIOS.
network псевдонимы: 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-адрес для обновления этого экземпляра объекта.
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 логическое	Применимо только к подмножеству опций (см. документацию API NIOS) Варианты: `false` `true` ← (по умолчанию)
value строка / обязательно	Значение DHCP-опции, указанной `name`
vendor_class строка	Имя пространства, к которому связана эта DHCP-опция По умолчанию: `"DHCP"`
provider словарь	Объект словаря, содержащий данные подключения.
cert строка	Указывает файл клиента с хешем 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 aliases: 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 aliases: 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/infoblox/nios_modules/nios_range_module.html