community.general.utm_network_interface_address – Создание, обновление или удаление объекта сетевого/интерфейсного адреса

Примечание

Этот плагин входит в состав коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general

Для использования в плейбуке укажите: community.general.utm_network_interface_address

Описание
Параметры
Примеры
Возвращаемые значения

Описание

Создание, обновление или удаление объекта сетевого/интерфейсного адреса в SOPHOS UTM.
Для работы с этим модулем необходимо активировать возможность REST-API в UTM.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
address строка / обязательно		IP-адрес объекта сетевого/интерфейсного адреса.
address6 строка		IP6-адрес объекта сетевого/интерфейсного адреса.
comment строка		Дополнительный комментарий к объекту (необязательно)
headers словарь		Словарь дополнительных заголовков, отправляемых в запросах POST и PUT. Необходим для некоторых модулей
name строка / обязательно		Имя объекта. Используется для идентификации записи
resolved логическое значение	Варианты: no yes	Указание на то, разрешён ли объект
resolved6 логическое значение	Варианты: no yes	Указание на то, разрешён ли объект
state строка	Варианты: absent present ←	Желаемое состояние объекта. `present` создаст или обновит объект `absent` удалит объект, если он был присутствует
utm_host строка / обязательно		REST-точек конечного пункта Sophos UTM.
utm_port целое число	Значение по умолчанию: 4444	Порт REST-интерфейса.
utm_protocol строка	Варианты: http https ←	Протокол 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 логическое значение	Варианты: no yes ←	Указывает, следует ли проверять сертификат SSL REST-интерфейса.

Примеры

- name: Create a network interface address
  utm_proxy_backend:
    utm_host: sophos.host.name
    utm_token: abcdefghijklmno1234
    name: TestNetworkInterfaceAddress
    address: 0.0.0.0
    state: present

- name: Remove a network interface address
  network_interface_address:
    utm_host: sophos.host.name
    utm_token: abcdefghijklmno1234
    name: TestNetworkInterfaceAddress
    address: 0.0.0.0
    state: absent

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ		Возвращаемое значение	Описание
result сложный тип		успех	Объект UTM, который был создан
	_locked логическое значение	успех	Указание на то, заблокирован ли объект в данный момент
	_ref строка	успех	Идентификатор ссылки объекта
	_type строка	успех	Тип объекта
	address строка	успех	IP4-адрес объекта сетевого/интерфейсного адреса
	address6 строка	успех	IP6-адрес объекта сетевого/интерфейсного адреса
	comment строка	успех	Строка комментария
	name строка	успех	Имя объекта
	resolved логическое значение	успех	Указание на то, разрешён ли объект
	resolved6 логическое значение	успех	Указание на то, разрешён ли объект

Авторы

Juergen Wiebe (@steamx)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/general/utm_network_interface_address_module.html