Модуль check_point.mgmt.cp_mgmt_add_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_add_rules_batch.

Новое в check_point.mgmt 3.0.0

Краткое описание
Параметры
Примеры
Возвращаемые значения

Краткое описание

Создаёт правила пакетно. Используйте этот API для оптимальной производительности при добавлении нескольких правил.
Добавляет несколько правил на уровень в заданную позицию, увеличивая позицию на единицу для каждого правила.
При использовании этого API ошибки и предупреждения игнорируются: операция применяет изменения, не учитывая ошибки. Нельзя опубликовать изменения, содержащие ошибки проверки. Используйте API «show-validations», чтобы просмотреть ошибки проверки и предупреждения, возникшие при пакетном создании. Поддерживаются следующие типы правил: access-rule, nat-rule, https-rule и threat-exception.
Этот модуль не является идемпотентным.
Все операции выполняются через API веб-служб.
Доступно начиная с версии управления R81.10 JHF.

Параметры

Параметр	Комментарии
auto_publish_session логическое значение	Опубликовать текущий сеанс после выполнения задачи, если были внесены изменения. Варианты: `false` ← (по умолчанию) `true`
objects список / элементы=словарь	Пакет правил, сгруппированных по типам.
first_position строка	Позиция первого правила.
layer строка	Имя или UID уровня.
list список / элементы=словарь	Список правил одного типа для создания на одном уровне. <br>Чтобы узнать ожидаемые поля запроса, обратитесь к документации API для команды добавления одного правила. <br>Например, чтобы добавить правила доступа, используйте команду «add-access-rule» из документации API (раздел Access Control & NAT). <br>Обратите внимание: параметры «set-if-exists», «ignore-errors», «ignore-warnings» и «details-level» не поддерживаются при пакетном добавлении правил.
type строка	Тип создаваемых правил. <br>Поддерживаются только перечисленные выше типы.
version строка	Версия Check Point. Если не указана, используется последняя версия.
wait_for_task логическое значение	Ожидать завершения задачи, например задачи публикации. Варианты: `false` `true` ← (по умолчанию)
wait_for_task_timeout целое число	Количество минут ожидания до возникновения ошибки тайм-аута. По умолчанию: `30`

Примеры

- name: add-rules-batch
  cp_mgmt_add_rules_batch:
    objects:
      - first_position: top
        layer: Network
        list:
          - action: accept
            name: access rule 1
          - action: accept
            name: access rule 2
        type: access-rule
      - first_position: top
        layer: Standard
        list:
          - name: nat rule 1
          - name: nat rule 2
        type: nat-rule
      - first_position: top
        layer: Default Layer
        list:
          - name: https rule 1
          - name: https rule 2
        type: https-rule

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

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

Ключ	Описание
cp_mgmt_add_rules_batch словарь	Результат выполнения команды Check Point add-rules-batch. Возвращается: всегда.

Авторы

Eden Brillant (@chkp-edenbr)

Ссылки на коллекцию

© 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_add_rules_batch_module.html