Back to Ansible Reference

$ ansible-doc -t module cisco.sccfm.delete_access_rule

> MODULE cisco.sccfm.delete_access_rule (sccfm-ansible/plugins/modules/delete_access_rule.py)

  Delete an ASA access rule from your SCC Firewall Manager tenant.
  The rule is identified by `uid'.
  Idempotent. Returns `changed=False' if the rule does not exist.

OPTIONS (= indicates it is required):

- config_path  Optional path to the canonical SCCFM profile
                configuration file.
        default: null
        type: path

- profile  Named SCCFM profile configured by `sccfm-cli configure'.
        default: default
        type: str

= uid     Unique identifier (UID) of the access rule to delete.
        type: str

AUTHOR: Cisco SCCFM Team (@CiscoDevNet)

EXAMPLES:
# Example 1: Delete an access rule by UID
- name: Delete access rule
  cisco.sccfm.delete_access_rule:
    uid: "ac981dcd-9860-401e-a51d-c615c946b72f"
    profile: default

# Example 2: Delete using module_defaults
- name: Delete access rules
  hosts: localhost
  gather_facts: false
  module_defaults:
    group/cisco.sccfm.all:
      profile: default
  tasks:
    - name: Delete old rule
      cisco.sccfm.delete_access_rule:
        uid: "{{ rule_uid }}"

RETURN VALUES:

- deleted_uid  The UID of the deleted access rule, or null if already
                absent.
        returned: always
        sample: ac981dcd-9860-401e-a51d-c615c946b72f
        type: str