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”下）中找到的“delete-access-rule”命令。
注意，在删除一批对象时，不支持“ignore-errors”、“ignore-warnings”和“details-level”选项。

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)