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

Примечание

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

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

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

В версии 2.9: коллекции check_point.mgmt

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

Обзор

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

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
auto_publish_session boolean		Варианты: нет да	Опубликовать текущую сессию, если изменения были внесены после завершения задачи.
color string		Варианты: аквамарин черный синий кремниево-голубой коричневато-бежевый голубой темно-зеленый хаки орхидея темно-оранжевый темно-морской зеленый розовый туркуаз темно-синий кирпично-красный коричневый темно-зеленый золотой темно-золотой серый темно-серый светло-зеленый лимонно-бежевый коралл морской зеленый небесно-голубой пурпурный фиолетовый серо-голубой фиолетово-красный темно-синий оливковый оранжевый красный сиена желтый	Цвет объекта. Должен быть одним из существующих цветов.
comments string			Строка комментариев.
details_level string		Варианты: uid стандартный полный	Уровень детализации для некоторых полей в ответе может варьироваться от отображения только значения UID объекта до полного представления объекта.
groups list / elements=string			Коллекция идентификаторов групп.
ignore_errors boolean		Варианты: нет да	Применять изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings не был указан, будут также игнорироваться предупреждения.
ignore_warnings boolean		Варианты: нет да	Применять изменения, игнорируя предупреждения.
ip_address_first string			Первый IP-адрес в диапазоне. Если требуются как IPv4, так и IPv6 диапазоны адресов, используйте поля ipv4-address-first и ipv6-address-first.
ip_address_last string			Последний IP-адрес в диапазоне. Если требуются как IPv4, так и IPv6 диапазоны адресов, используйте поля ipv4-address-first и ipv6-address-first.
ipv4_address_first string			Первый IPv4-адрес в диапазоне.
ipv4_address_last string			Последний IPv4-адрес в диапазоне.
ipv6_address_first string			Первый IPv6-адрес в диапазоне.
ipv6_address_last string			Последний IPv6-адрес в диапазоне.
name string / обязательно			Имя объекта.
nat_settings dictionary			Настройки NAT.
	auto_rule boolean	Варианты: нет да	Добавлять ли автоматические правила трансляции адресов.
	hide_behind string	Варианты: шлюз ip-адрес	Метод скрытия. Этот параметр не требуется, если параметр "method" равен "static".
	install_on string		Какой шлюз должен применять трансляцию NAT.
	ip_address string		IPv4 или IPv6 адрес. Если требуются оба адреса, используйте поля ipv4-address и ipv6-address явно. Этот параметр не требуется, если параметр "method" равен "hide", а параметр "hide-behind" равен "шлюз".
	ipv4_address string		IPv4 адрес.
	ipv6_address string		IPv6 адрес.
	method string	Варианты: hide static	Метод трансляции NAT.
state string		Варианты: присутствует ← отсутствует	Состояние правила доступа (присутствует или отсутствует). По умолчанию — присутствует.
tags list / elements=string			Коллекция идентификаторов тегов.
version string			Версия checkpoint. Если не указана, используется последняя.
wait_for_task boolean		Варианты: нет да ←	Ожидать завершения задачи. Например, задачи публикации.
wait_for_task_timeout integer		По умолчанию: 30	Сколько минут ждать до выброса ошибки тайм-аута.

Примеры

- name: add-address-range
  cp_mgmt_address_range:
    ip_address_first: 192.0.2.1
    ip_address_last: 192.0.2.10
    name: New Address Range 1
    state: present

- name: set-address-range
  cp_mgmt_address_range:
    color: green
    ip_address_first: 192.0.2.1
    ip_address_last: 192.0.2.1
    name: New Address Range 1
    new_name: New Address Range 2
    state: present

- name: delete-address-range
  cp_mgmt_address_range:
    name: New Address Range 2
    state: absent

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

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

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

Авторы

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_address_range_module.html