utm_dns_host – создание, обновление или удаление записи DNS в Sophos UTM
Новое в версии 2.8.
Описание
- Создание, обновление или удаление записи DNS в SOPHOS UTM.
- Для работы с этим модулем необходимо активировать возможность REST API в UTM.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| address - | По умолчанию: "0.0.0.0" | Адрес IPv4 записи. Можно оставить пустым для автоматического разрешения. |
| address6 - | По умолчанию: "::" | Адрес IPv6 записи. Можно оставить пустым для автоматического разрешения. |
| comment - | Необязательный комментарий для объекта DNS-хоста. | |
| headers словарь | Словарь дополнительных заголовков для отправки в запросах POST и PUT. Необходим для некоторых модулей. | |
| hostname - | Имя хоста для объекта DNS-хоста. | |
| interface - | Имя интерфейса для использования. Если не указано, используется интерфейс по умолчанию. | |
| name - / обязательно | Имя объекта. Будет использоваться для идентификации записи. | |
| resolved логическое значение |
| Указывает, разрешен ли IPv4-адрес имени хоста. |
| resolved6 логическое значение |
| Указывает, разрешен ли IPv6-адрес имени хоста. |
| state строка |
| Желаемое состояние объекта. present создаст или обновит объект.absent удалит объект, если он был. |
| timeout - | По умолчанию: 0 | Время ожидания для UTM, чтобы повторно разрешить IP-адрес для имени хоста. |
| utm_host строка / обязательно | REST конечная точка Sophos UTM. | |
| utm_port целое число | По умолчанию: 4444 | Порт REST интерфейса. |
| utm_protocol строка |
| Протокол REST конечной точки. |
| utm_token строка / обязательно | Токен, используемый для идентификации в REST API. См. https://www.sophos.com/en-us/medialibrary/PDFs/documentation/UTMonAWS/Sophos-UTM-RESTful-API.pdf?la=en, Глава 2.4.2. | |
| validate_certs логическое значение |
| Проверять или нет SSL-сертификат REST интерфейса. |
Примеры
- name: Create UTM dns host entry
utm_dns_host:
utm_host: sophos.host.name
utm_token: abcdefghijklmno1234
name: TestDNSEntry
hostname: testentry.some.tld
state: present
- name: Remove UTM dns host entry
utm_dns_host:
utm_host: sophos.host.name
utm_token: abcdefghijklmno1234
name: TestDNSEntry
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое | Описание | |
|---|---|---|---|
| result сложный | успех | Объект UTM, который был создан. | |
| _locked логическое значение | Заблокирован ли объект в данный момент. | ||
| _ref строка | Имя ссылки объекта. | ||
| address строка | IPv4-адрес объекта. | ||
| address6 строка | IPv6-адрес объекта. | ||
| comment строка | Строка комментария. | ||
| hostname строка | Имя хоста объекта. | ||
| interface строка | Имя ссылки интерфейса, к которому связан объект. | ||
| name строка | Имя объекта. | ||
| resolved логическое значение | Разрешен ли IPv4-адрес. | ||
| resolved6 логическое значение | Разрешен ли IPv6-адрес. | ||
| timeout целое число | Время ожидания до следующей попытки разрешения. | ||
Статус
- Этот модуль не гарантирует обратной совместимости интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Johannes Brunswicker (@MatrixCrawler)
Подсказка
Если вы обнаружите проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/utm_dns_host_module.html
