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

Примечание

Этот плагин является частью коллекции community.general (версия 2.0.1).

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

Чтобы использовать его в книге задач, укажите: community.general.utm_network_interface_address.

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

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
address строка / обязательно		IP-адрес IPv4 объекта сетевого/интерфейсного адреса.
address6 строка		IP-адрес IPv6 объекта сетевого/интерфейсного адреса.
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 строка	успех	IP-адрес IPv4 объекта сетевого/интерфейсного адреса.
	address6 строка	успех	IP-адрес IPv6 объекта сетевого/интерфейсного адреса.
	comment строка	успех	Строка комментария.
	name строка	успех	Имя объекта.
	resolved логическое значение	успех	Указание того, разрешен ли объект.
	resolved6 логическое значение	успех	Указание того, разрешен ли объект.

Авторы

Juergen Wiebe (@steamx)

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