Модуль check_point.mgmt.cp_mgmt_delete_rules_batch — пакетное удаление правил одного слоя. Используйте этот 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_delete_rules_batch.
Добавлено в check_point.mgmt 3.0.0
Краткое описание
- Пакетное удаление правил одного слоя. Используйте этот API для оптимальной производительности при удалении нескольких правил.
- При использовании этого API предупреждения игнорируются: операция применяет изменения, не учитывая предупреждения.
- Поддерживаются следующие типы правил: access-rule, nat-rule, https-rule и threat-exception.
- Этот модуль не является идемпотентным.
- Все операции выполняются через API веб-служб.
- Доступно начиная с версии управления R81.10 JHF.
Параметры
Параметр | Комментарии |
|---|---|
auto_publish_session boolean | Опубликовать текущий сеанс, если после завершения задачи были внесены изменения. Варианты:
|
objects list / elements=dictionary | Пакет правил, сгруппированных по типам. |
|
layer string |
Имя или UID слоя. |
|
list list / elements=dictionary |
Список правил одного типа для удаления. <br>Чтобы узнать ожидаемые поля запроса, обратитесь к справочной документации API для команды удаления одного правила.<br>Например, чтобы удалить access-rule, используйте команду “delete-access-rule” из справочной документации API (раздел Access Control & NAT). <br>Обратите внимание: параметры “ignore-errors”, “ignore-warnings” и “details-level” не поддерживаются при пакетном удалении объектов. |
|
type string |
Тип удаляемых правил. <br>Поддерживаются только перечисленные выше типы. |
version string | Версия Check Point. Если не указана, используется последняя версия. |
wait_for_task boolean | Ожидать завершения задачи, например задачи публикации. Варианты:
|
wait_for_task_timeout integer | Количество минут ожидания до возникновения ошибки тайм-аута. По умолчанию: |
Примеры
- name: delete-rules-batch
cp_mgmt_delete_rules_batch:
objects:
- layer: Network
list:
- rule_number: 1
- rule_number: 2
type: access-rule
- layer: Standard
list:
- rule_number: 1
- rule_number: 2
type: nat-rule
- layer: Default Layer
list:
- rule_number: 1
- rule_number: 2
type: https-rule
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
cp_mgmt_delete_rules_batch dictionary | Результат выполнения команды Check Point delete-rules-batch. Возвращается: всегда. |
Ссылки на коллекцию
© 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_delete_rules_batch_module.html