check_point.mgmt.cp_mgmt_delete_rules_batch 模块 – 批量删除同一层中的规则。使用此 API 可在删除多个规则时实现最佳性能。

注意

此模块是 check_point.mgmt 集合 (版本 6.2.1) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install check_point.mgmt。

要在 playbook 中使用它，请指定： check_point.mgmt.cp_mgmt_delete_rules_batch。

check_point.mgmt 3.0.0 中的新增功能

概要

  • 批量删除同一层中的规则。使用此 API 可在删除多个规则时实现最佳性能。

  • 使用此 API 时会忽略警告，操作将应用更改同时忽略警告。

  • 支持的规则类型包括访问规则、NAT 规则、HTTPS 规则和威胁例外。

  • 此模块不是幂等的。

  • 所有操作均通过 Web 服务 API 执行。

参数

参数

注释

auto_publish_session

布尔值

如果在任务完成后执行了更改，则发布当前会话。

选项

  • false ← (默认)

  • true

objects

列表 / 元素=字典

按类型分开的规则批次。

layer

字符串

层名称或 UID。

list

列表 / 元素=字典

要删除的相同类型规则的列表。
使用单个规则命令的“删除”API 参考文档查找请求的预期字段。
例如，要删除访问规则，请使用 API 参考文档（在访问控制和 NAT 下）中找到的“删除访问规则”命令。
注意，删除对象批次时不支持“忽略错误”、“忽略警告”和“详细信息级别”选项。

type

字符串

要删除的规则类型。
仅支持上述类型。

version

字符串

Check Point 版本。如果未指定，则采用最新版本。

wait_for_task

布尔值

等待任务结束。例如发布任务。

选项

  • false

  • true ← (默认)

wait_for_task_timeout

整数

在抛出超时错误之前等待多少分钟。

默认值： 30

示例

- 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

字典

Check Point delete-rules-batch 输出。

返回：始终返回。

作者

  • Eden Brillant (@chkp-edenbr)