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

Примечание

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

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

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

В версии 2.9: плагин check_point.mgmt

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

Обзор

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

Параметры

Параметр			Варианты/Значения по умолчанию	Комментарии
access boolean			Варианты: no yes	True — разрешает, False — запрещает доступ и политики NAT, пустое значение — ничего не изменяется.
access_layers dictionary				Слои политики доступа.
	add list / elements=string			Коллекция объектов слоя доступа, которые необходимо добавить, идентифицированные по имени или идентификатору.
		name string		Имя или идентификатор слоя.
		position integer		Позиция слоя.
	remove list / elements=string			Коллекция объектов слоя доступа, которые необходимо удалить, идентифицированные по имени или идентификатору.
	value list / elements=string			Коллекция объектов слоя доступа, которые необходимо установить, идентифицированные по имени или идентификатору. Заменяет существующие слои доступа.
auto_publish_session boolean			Варианты: no yes	Опубликовать текущую сессию, если после выполнения задачи были внесены изменения.
color string			Варианты: аквамарин черный синий голубой крет бежевый голубой темно-зеленый хаки фиолетовый темно-оранжевый темно-морской зеленый розовый бирюзовый темно-синий кирпично-красный коричневый темно-зеленый золотистый темно-золотистый серый темно-серый светло-зеленый лимонно-кремовый коралловый морской зеленый небесно-голубой пурпурный фиолетовый серо-голубой фиолетово-красный темно-синий оливковый оранжевый красный сиена желтый	Цвет объекта. Должен быть одним из существующих цветов.
comments string				Строка комментариев.
desktop_security boolean			Варианты: no yes	True — разрешает, False — запрещает политику безопасности рабочего стола, пустое значение — ничего не изменяется.
details_level string			Варианты: uid стандартный полный	Уровень детализации некоторых полей в ответе может варьироваться от отображения только значения идентификатора UID объекта до полного детального представления объекта.
ignore_errors boolean			Варианты: no yes	Применить изменения, игнорируя ошибки. Вы не сможете опубликовать такие изменения. Если флаг ignore-warnings был опущен, то предупреждения также будут проигнорированы.
ignore_warnings boolean			Варианты: no yes	Применить изменения, игнорируя предупреждения.
installation_targets list / elements=string				Какие шлюзы, идентифицированные по имени или идентификатору, должны установить политику.
name string / required				Имя объекта.
qos boolean			Варианты: no yes	True — разрешает, False — запрещает политику QoS, пустое значение — ничего не изменяется.
qos_policy_type string			Варианты: рекомендуемый express	Тип политики QoS.
state string			Варианты: present ← отсутствует	Состояние правила доступа (present или absent). По умолчанию — present.
tags list / elements=string				Коллекция идентификаторов тегов.
threat_layers dictionary				Слои политики угроз.
	add list / elements=string			Коллекция объектов слоя угроз, которые необходимо добавить, идентифицированные по имени или идентификатору.
		name string		Имя или идентификатор слоя.

		позиция целое число		Позиция слоя.
	удалить список / элементы=строка			Коллекция объектов слоя угроз, которые необходимо удалить, идентифицированные по имени или идентификатору.
	значение список / элементы=строка			Коллекция объектов слоя угроз, которые необходимо установить, идентифицированные по имени или идентификатору. Заменяет существующие слои угроз.
предотвращение_угроз булево			Варианты: нет да	Истина - включает, Ложь - отключает политику угроз, пустое значение - ничего не изменяется.
версия строка				Версия контрольной точки. Если не указана, используется последняя версия.
традиционный_режим_vpn булево			Варианты: нет да	Истина - включает, Ложь - отключает традиционный режим VPN, пустое значение - ничего не изменяется.
ждать_завершения_задачи булево			Варианты: нет да ←	Дождаться завершения задачи. Например, задачи публикации.
время_ожидания_задачи целое число			По умолчанию: 30	Сколько минут ждать, прежде чем произойдёт ошибка таймаута.

Примеры

- name: add-package
  cp_mgmt_package:
    access: true
    color: green
    comments: My Comments
    name: New_Standard_Package_1
    state: present
    threat_prevention: false

- name: set-package
  cp_mgmt_package:
    access_layers:
      add:
      - name: New Access Layer 1
        position: 1
    name: Standard
    state: present
    threat_layers:
      add:
      - name: New Layer 1
        position: 2

- name: delete-package
  cp_mgmt_package:
    name: New Standard Package 1
    state: absent

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

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

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

Авторы

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