ansible.netcommon.network_resource_module.rst

ansible.netcommon.network_resource

Manage resource modules

Version added: 2.4.0

• Synopsis
• Parameters
• Notes
• Examples
• Return Values
• Status

Synopsis

• Get list of available resource modules for given os name
• Retrieve given resource module configuration facts
• Push given resource module configuration

Parameters

Parameter	Choices/Defaults	Comments
config raw		The resource module configuration. For details on the type and structure of this option refer the individual resource module platform documentation.
name string		The name of the resource module to manage. The resource module should be supported for given os_name, if not supported it will result in error.
os_name string		The name of the os to manage the resource modules. The name should be fully qualified collection name format, that is <namespace>.<collection-name>.<plugin-name>. If value of this option is not set the os value will be read from ansible_network_os variable. If value of both os_name and ansible_network_os is not set it will result in error.
running_config -		This option is used only with state parsed. The value of this option should be the output received from the host device by executing the cli command to get the resource configuration on host. The state parsed reads the configuration from running_config option and transforms it into Ansible structured data as per the resource module's argspec and the value is then returned in the parsed key within the result.
state -		The state the configuration should be left in. For supported values refer the individual resource module platform documentation.

Notes

Note

• Refer the individual module documentation for the valid inputs of state and config modules.

Examples

- name: get list of resource modules for given network_os
  ansible.netcommon.network_resource:
  register: result

- name: fetch acl config for
  ansible.netcommon.network_resource:
    os_name: cisco.ios.ios
    name: acls
    state: gathered

- name: manage acl config for cisco.ios.ios network os.
  ansible.netcommon.network_resource:
    name: acls
    config:
      - afi: ipv4
        acls:
          - name: test_acl
            acl_type: extended
            aces:
              - grant: deny
                protocol_options:
                  tcp:
                    fin: true
                source:
                  address: 192.0.2.0
                  wildcard_bits: 0.0.0.255
                destination:
                  address: 192.0.3.0
                  wildcard_bits: 0.0.0.255
                  port_protocol:
                    eq: www
                option:
                  traceroute: true
                ttl:
                  eq: 10
    state: merged

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
after list	when changed and when state and/or config option is set	The configuration as structured data after module completion. Sample: The configuration returned will always be in the same format of the parameters above.
before list	When state and/or config option is set	The configuration as structured data prior to module invocation. Sample: The configuration returned will always be in the same format of the parameters above.
commands list	When state and/or config option is set	The set of commands pushed to the remote device Sample: ['ip access-list extended 110']
modules list	When only os_name or ansible_network_os is set	List of resource modules supported for given OS. Sample: ['acl_interfaces', 'acls', 'bgp_global']

Status

Authors

• Ganesh B. Nalawade (@ganeshrn)