check_point.mgmt.cp_mgmt_network – Управляет сетевыми объектами Check Point через API веб-служб

Примечание

Этот плагин является частью коллекции check_point.mgmt (версия 2.0.0).

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

Для использования в playbook укажите: check_point.mgmt.cp_mgmt_network.

Новое в версии 2.9: модуля check_point.mgmt

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

Обзор

Управляет сетевыми объектами на устройствах Check Point, включая создание, обновление и удаление объектов.
Все операции выполняются через API веб-служб.

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
auto_publish_session boolean		Варианты: no yes	Опубликовать текущую сессию, если после выполнения задачи были внесены изменения.
broadcast string		Варианты: disallow allow	Разрешить включение широковещательного адреса.
color string		Варианты: аквамарин черный синий светло-голубой коричневато-желтый голубой темно-зеленый хаки фиолетовый темно-оранжевый темно-морской зеленый розовый бирюзовый темно-синий огненно-красный коричневый темно-зеленый золотистый темно-золотистый серый темно-серый светло-зеленый лимонно-желтый коралловый морской зеленый небесно-голубой пурпурный фиолетовый серо-голубой фиолетово-красный темно-синий оливковый оранжевый красный серо-коричневый желтый	Цвет объекта. Должен быть одним из существующих цветов.
comments string			Строка комментариев.
details_level string		Варианты: uid стандартный полный	Уровень детализации для некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полностью подробного представления объекта.
groups list / elements=string			Коллекция идентификаторов групп.
ignore_errors boolean		Варианты: no yes	Применять изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings не был указан, будут проигнорированы и предупреждения.
ignore_warnings boolean		Варианты: no yes	Применять изменения, игнорируя предупреждения.
mask_length integer			Длина маски сети IPv4 или IPv6. Если обе маски необходимы, используйте явно поля mask-length4 и mask-length6. Вместо длины маски IPv4 можно указать саму маску IPv4 в поле subnet-mask.
mask_length4 integer			Длина маски сети IPv4.
mask_length6 integer			Длина маски сети IPv6.
name string / required			Имя объекта.
nat_settings dictionary			Настройки NAT.
	auto_rule boolean	Варианты: no yes	Добавлять ли автоматические правила трансляции адресов.
	hide_behind string	Варианты: шлюз ip-адрес	Метод скрытия. Этот параметр не требуется, если параметр "method" равен "static".
	install_on string		Какой шлюз должен применять трансляцию NAT.
	ip_address string		Адрес IPv4 или IPv6. Если оба адреса необходимы, используйте явно поля ipv4-address и ipv6-address. Этот параметр не требуется, если параметр "method" равен "hide", а "hide-behind" равен "gateway".
	ipv4_address string		Адрес IPv4.
	ipv6_address string		Адрес IPv6.
	method string	Варианты: hide static	Метод трансляции NAT.
state string		Варианты: present ← absent	Состояние правила доступа (present или absent). По умолчанию present.
subnet string			Сеть IPv4 или IPv6. Если оба адреса необходимы, используйте явно поля subnet4 и subnet6.
subnet4 string			Адрес сети IPv4.
subnet6 string			Адрес сети IPv6.
subnet_mask string			Маска сети IPv4.
tags list / elements=string			Коллекция идентификаторов тегов.
version string			Версия checkpoint. Если не указана, используется последняя версия.
wait_for_task boolean		Варианты: no yes ←	Ожидать завершения задачи, например, задачи публикации.
wait_for_task_timeout integer		Значение по умолчанию: 30	Сколько минут ждать, прежде чем сгенерировать ошибку таймаута.

Примеры

- name: add-network
  cp_mgmt_network:
    name: New Network 1
    state: present
    subnet: 192.0.2.0
    subnet_mask: 255.255.255.0

- name: set-network
  cp_mgmt_network:
    color: green
    mask_length: 16
    name: New Network 1
    new_name: New Network 2
    state: present
    subnet: 192.0.0.0

- name: delete-network
  cp_mgmt_network:
    name: New Network 2
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
cp_mgmt_network dictionary	всегда, кроме удаления объекта.	Созданный или обновленный объект checkpoint.

Авторы

Or Soffer (@chkp-orso)

© 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/check_point/mgmt/cp_mgmt_network_module.html