omapi_host – Настройка хостов OMAPI.
Новое в версии 2.3.
Обзор
- Создание, обновление и удаление хостов OMAPI в совместимых серверах DHCPd.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- pypureomapi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| ddns boolean |
| Включить динамическое обновление DNS для данного хоста. |
| host - | По умолчанию: "localhost" | Устанавливает хост сервера OMAPI для взаимодействия. |
| ip - | Устанавливает IP-адрес хоста аренды. | |
| key - / обязательно | Устанавливает содержимое ключа TSIG для аутентификации на сервере OMAPI. | |
| key_name - / обязательно | Устанавливает имя ключа TSIG для аутентификации на сервере OMAPI. | |
| macaddr - / обязательно | Устанавливает MAC-адрес хоста аренды. | |
| name - | Устанавливает имя хоста аренды (обязательно, если 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-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.7/modules/omapi_host_module.html