omapi_host – Настройка хостов OMAPI
Новое в версии 2.3.
Обзор
- Управление хостами OMAPI в совместимых серверах DHCPd
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- pypureomapi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ddns boolean |
| Включить динамическое обновление DNS для данного хоста. |
| host строка | Значение по умолчанию: "localhost" | Устанавливает хост OMAPI-сервера для взаимодействия. |
| hostname строка | Устанавливает имя хоста аренды (обязательно, если state=present). псевдонимы: name | |
| ip строка | Устанавливает IP-адрес хоста аренды. | |
| key строка / обязательно | Устанавливает содержимое ключа TSIG для аутентификации с OMAPI-сервером. | |
| key_name строка / обязательно | Устанавливает имя ключа TSIG для аутентификации с OMAPI-сервером. | |
| macaddr строка / обязательно | Устанавливает MAC-адрес хоста аренды. | |
| port целое число | Значение по умолчанию: 7911 | Устанавливает порт OMAPI-сервера для взаимодействия. |
| state строка / обязательно |
| Создание или удаление хоста OMAPI. |
| statements список | Значение по умолчанию: [] | Присоединить список утверждений OMAPI DHCP с арендой хоста (без завершающей точки с запятой). |
Примеры
- name: Add a host using OMAPI
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
omapi_host:
key_name: defomapi
key: +bFQtBCta6j2vWkjPkNFtgA==
host: 10.1.1.1
macaddr: 00:66:ab:dd:11:44
state: absent
Возвращаемые значения
Общие возвращаемые значения документированы здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое | Описание | |
|---|---|---|---|
| аренда сложный тип | успех | словарь, содержащий информацию о хосте | |
| hardware-address строка | успех | MAC-адрес Пример: 00:11:22:33:44:55 | |
| hardware-type целое число | успех | тип оборудования, обычно '1' Пример: 1 | |
| ip-address строка | успех | IP-адрес, если он есть. Пример: 192.168.1.5 | |
| name строка | успех | имя хоста Пример: mydesktop | |
Статус
- Гарантируется обратная совместимость интерфейса этого модуля. [превью]
- Этот модуль поддерживается сообществом Ansible. [сообщество]
Авторы
- 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.8/modules/omapi_host_module.html
