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

Примечание

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

Для его установки используйте: 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			Коллекция объектов слоя доступа, которые нужно добавить, идентифицированные по имени или UID.
		name string		Имя или UID слоя.
		position integer		Позиция слоя.
	remove list / elements=string			Коллекция объектов слоя доступа, которые нужно удалить, идентифицированные по имени или UID.
	value list / elements=string			Коллекция объектов слоя доступа, которые нужно установить, идентифицированные по имени или UID. Заменяет существующие слои доступа.
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				Какие шлюзы, идентифицированные по имени или UID, будут использоваться для установки политики.
name string / required				Имя объекта.
qos boolean			Варианты: no yes	True - включает, False - отключает политику QoS, пустое значение - ничего не изменяется.
qos_policy_type string			Варианты: рекомендуемый экспресс	Тип политики QoS.
state string			Варианты: present ← absent	Состояние правила доступа (present или absent). По умолчанию present.
tags list / elements=string				Коллекция идентификаторов тегов.
threat_layers dictionary				Слои политики угроз.
	add list / elements=string			Коллекция объектов слоя угроз, которые нужно добавить, идентифицированные по имени или UID.
		name string		Имя или UID слоя.
		position integer		Позиция слоя.
	remove list / elements=string			Коллекция объектов слоя угроз, которые нужно удалить, идентифицированные по имени или UID.
	value list / elements=string			Коллекция объектов слоя угроз, которые нужно установить, идентифицированные по имени или UID. Заменяет существующие слои угроз.
threat_prevention boolean			Варианты: no yes	True - включает, False - отключает политику угроз, пустое значение - ничего не изменяется.
version string				Версия checkpoint. Если не указана, используется последняя версия.
vpn_traditional_mode boolean			Варианты: no yes	True - включает, False - отключает традиционный режим VPN, пустое значение - ничего не изменяется.
wait_for_task boolean			Варианты: no yes ←	Ожидать завершения задачи, например, задачи публикации.

Примеры

- 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/check_point/mgmt/cp_mgmt_package_module.html