community.general.omapi_host – Настройка хостов OMAPI.
Примечание
Этот плагин входит в коллекцию community.general (версия 2.0.1).
Для его установки используйте: 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
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие являются полями, уникальными для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| lease complex | success | словарь, содержащий информацию о хосте | |
| hardware-address string | success | MAC-адрес Пример: 00:11:22:33:44:55 | |
| hardware-type integer | success | тип оборудования, обычно '1' Пример: 1 | |
| ip-address string | success | IP-адрес, если он есть. Пример: 192.168.1.5 | |
| name string | success | имя хоста Пример: mydesktop | |
Авторы
- Loic Blot (@nerzhul)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/omapi_host_module.html
