omapi_host - Настройка хостов OMAPI.
Новое в версии 2.3.
Обзор
- Создание, обновление и удаление хостов OMAPI в совместимых серверах DHCP.
Требования
Ниже приведены требования к хосту, на котором будет выполняться этот модуль.
- pypureomapi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ddns | Значение по умолчанию: нет | Включить динамические обновления DNS для этого хоста. |
| host | Значение по умолчанию: localhost | Устанавливает хост сервера OMAPI для взаимодействия. |
| ip | Значение по умолчанию: None | Устанавливает IP-адрес арендованного хоста. |
| key обязательно | Устанавливает содержимое ключа TSIG для аутентификации на сервере OMAPI. | |
| key_name обязательно | Устанавливает имя ключа TSIG для аутентификации на сервере OMAPI. | |
| macaddr обязательно | Устанавливает MAC-адрес арендованного хоста. | |
| name | Значение по умолчанию: None | Устанавливает имя хоста (обязательно, если state=present). |
| port | Значение по умолчанию: 7911 | Устанавливает порт сервера OMAPI для взаимодействия. |
| state обязательно |
| Создать или удалить хост OMAPI. |
| statements | Значение по умолчанию: [] | Прикрепить список операторов OMAPI DHCP с арендованным хостом (без заключительной точки с запятой). |
Примеры
- 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
- 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
Возвращаемые значения
Общие возвращаемые значения описаны здесь, а следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| changed строка | успех | Если модуль изменил хост | |
| lease сложный | успех | Словарь, содержащий информацию о хосте | |
| hardware-type целое число | успех | тип оборудования, обычно '1' Пример: 1 | |
| name строка | успех | имя хоста Пример: mydesktop | |
| ip-address строка | успех | IP-адрес, если есть. Пример: 192.168.1.5 | |
| hardware-address строка | успех | MAC-адрес Пример: 00:11:22:33:44:55 | |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет совместим со старыми версиями.
Автор
- 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.5/modules/omapi_host_module.html
