Модуль check_point.mgmt.cp_mgmt_override_categorization — управление объектами переопределения категорий на Checkpoint через API веб-служб
Примечание
Этот модуль входит в коллекцию check_point.mgmt (версия 6.9.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install check_point.mgmt.
Чтобы использовать её в плейбуке, укажите: check_point.mgmt.cp_mgmt_override_categorization.
Добавлено в check_point.mgmt 6.0.0
Краткое описание
- Управляет объектами переопределения категорий на устройствах Checkpoint, в том числе создаёт, обновляет и удаляет объекты.
- Все операции выполняются через API веб-служб.
- Доступно начиная с версии R82 Management.
Параметры
Параметр | Описание |
|---|---|
additional_categories list / элементы=string | UID или имя категорий, которые нужно переопределить в Application and URL Filtering или Threat Prevention. |
auto_publish_session boolean | Опубликовать текущую сессию после завершения задачи, если в неё были внесены изменения. Варианты:
|
color string | Цвет объекта. Должен быть одним из существующих цветов. Варианты:
|
comments string | Строка комментария. |
details_level string | Уровень детализации некоторых полей ответа может варьироваться от отображения только значения UID объекта до полностью подробного представления объекта. Варианты:
|
ignore_errors boolean | Применить изменения, игнорируя ошибки. Опубликовать такие изменения не удастся. Если флаг ignore-warnings не указан, предупреждения также будут игнорироваться. Варианты:
|
ignore_warnings boolean | Применить изменения, игнорируя предупреждения. Варианты:
|
new_primary_category string | UID или имя основной категории, определяемой по наиболее характерному признаку. |
new_url string | Новое имя объекта. |
risk string | Указывает уровень риска переопределённой категории. Варианты:
|
state string | Состояние правила доступа (присутствует или отсутствует). Варианты:
|
tags list / элементы=string | Набор идентификаторов тегов. |
url string / обязательный | URL, для которого нужно обновить определения категории и риска. Для переопределения категории URL и имя объекта совпадают. |
url_defined_as_regular_expression boolean | Указывает, задан ли URL как регулярное выражение. Варианты:
|
version string | Версия Checkpoint. Если не указана, используется последняя версия. |
wait_for_task boolean | Дождаться завершения задачи, например задачи публикации. Варианты:
|
wait_for_task_timeout integer | Сколько минут ждать до возникновения ошибки превышения времени ожидания. По умолчанию: |
Примеры
- name: add-override-categorization
cp_mgmt_override_categorization:
new_primary_category: Botnets
risk: low
state: present
url: newOverride
- name: set-override-categorization
cp_mgmt_override_categorization:
risk: high
state: present
url: newOverride
- name: delete-override-categorization
cp_mgmt_override_categorization:
state: absent
url: newOverride
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
cp_mgmt_override_categorization dictionary | Созданный или обновлённый объект Checkpoint. Возвращается: всегда, кроме случаев удаления объекта. |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/check_point/mgmt/cp_mgmt_override_categorization_module.html