community.general.omapi_host – Настройка узлов OMAPI.
Примечание
Этот плагин является частью коллекции community.general (версия 1.3.2).
Для его установки используйте: ansible-galaxy collection install community.general.
Для использования в книге задач укажите: community.general.omapi_host.
Обзор
- Управление узлами OMAPI в совместимых серверах DHCPd
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- pypureomapi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ddns boolean |
| Включить динамическое обновление DNS для этого хоста. |
| host string | Значение по умолчанию: "localhost" | Устанавливает хост сервера OMAPI для взаимодействия. |
| hostname string | Устанавливает имя хоста аренды (обязательно, если state=present). псевдонимы: name | |
| ip string | Устанавливает IP-адрес хоста аренды. | |
| key string / обязательно | Устанавливает содержимое ключа TSIG для аутентификации с сервером OMAPI. | |
| key_name string / обязательно | Устанавливает имя ключа TSIG для аутентификации с сервером OMAPI. | |
| macaddr string / обязательно | Устанавливает MAC-адрес хоста аренды. | |
| port integer | Значение по умолчанию: 7911 | Устанавливает порт сервера OMAPI для взаимодействия. |
| state string / обязательно |
| Создать или удалить хост OMAPI. |
| statements list / элементы=string | Значение по умолчанию: [] | Присоединить список инструкций OMAPI DHCP с арендой хоста (без завершающей точки с запятой). |
Примеры
- name: Add a host using OMAPI
community.general.omapi_host:
key_name: defomapi
key: +bFQtBCta6j2vWkjPkNFtgA==
host: 10.98.4.55
macaddr: 44:dd:ab:dd:11:44
name: server01
ip: 192.168.88.99
ddns: yes
statements:
- filename "pxelinux.0"
- next-server 1.1.1.1
state: present
- name: Remove a host using OMAPI
community.general.omapi_host:
key_name: defomapi
key: +bFQtBCta6j2vWkjPkNFtgA==
host: 10.1.1.1
macaddr: 00:66:ab:dd:11:44
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие являются полями, уникальными для данного модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| аренда complex | успех | словарь, содержащий информацию о хосте | |
| hardware-address string | успех | MAC-адрес Пример: 00:11:22:33:44:55 | |
| hardware-type integer | успех | тип оборудования, обычно '1' Пример: 1 | |
| ip-address string | успех | IP-адрес, если есть. Пример: 192.168.1.5 | |
| name string | успех | имя хоста Пример: mydesktop | |
Авторы
- Loic Blot (@nerzhul)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/omapi_host_module.html
