Vh pdZddlmZmZmZeZdZdZdZ ddl m Z ddl m Z ddlmZd Zed k(rey y ) z The module file for nxos_lacp )absolute_importdivisionprint_functiona module: nxos_lacp short_description: LACP resource module description: This module manages Global Link Aggregation Control Protocol (LACP) on NX-OS devices. version_added: 1.0.0 author: Trishna Guha (@trishnaguha) notes: - Tested against NXOS 7.3.(0)D1(1) on VIRL. - Unsupported for Cisco MDS - Feature lacp should be enabled for this module. options: running_config: description: - This option is used only with state I(parsed). - The value of this option should be the output received from the NX-OS device by executing the command B(show running-config | include lacp). - The state I(parsed) reads the configuration from C(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 I(parsed) key within the result. type: str config: description: LACP global options. type: dict suboptions: system: description: - LACP system options type: dict suboptions: priority: description: - The system priority to use in LACP negotiations. type: int mac: description: - MAC address to be used for the LACP Protocol exchanges type: dict suboptions: address: description: - MAC-address (FORMAT :xxxx.xxxx.xxxx). type: str role: description: - The role for the Switch. type: str choices: - primary - secondary state: description: - The state of the configuration after module completion. - States C(replaced) and C(overridden) have the same behaviour for this module. type: str choices: - merged - replaced - overridden - deleted - gathered - rendered - parsed default: merged a # Using merged # Before state: # ------------- # - name: Merge provided configuration with device configuration. cisco.nxos.nxos_lacp: config: system: priority: 10 mac: address: 00c1.4c00.bd15 state: merged # After state: # ------------ # # lacp system-priority 10 # lacp system-mac 00c1.4c00.bd15 # Using replaced # Before state: # ------------- # # lacp system-priority 10 - name: Replace device global lacp configuration with the given configuration. cisco.nxos.nxos_lacp: config: system: mac: address: 00c1.4c00.bd15 state: replaced # After state: # ------------ # # lacp system-mac 00c1.4c00.bd15 # Using deleted # Before state: # ------------- # # lacp system-priority 10 - name: Delete global LACP configurations. cisco.nxos.nxos_lacp: state: deleted # After state: # ------------ # # Using rendered - name: Render platform specific configuration lines (without connecting to the device) cisco.nxos.nxos_lacp: config: system: priority: 10 mac: address: 00c1.4c00.bd15 role: secondary state: rendered # Task Output (redacted) # ----------------------- # rendered: # - "lacp system-priority 10" # - "lacp system-mac 00c1.4c00.bd15 role secondary" # Using parsed # parsed.cfg # ------------ # lacp system-priority 10 # lacp system-mac 00c1.4c00.bd15 role secondary - name: Use parsed state to convert externally supplied config to structured format cisco.nxos.nxos_lacp: running_config: "{{ lookup('file', 'parsed.cfg') }}" state: parsed # Task output (redacted) # ----------------------- # parsed: # system: # priority: 10 # mac: # address: 00c1.4c00.bd15 # role: secondary # Using gathered # Existing device config state # ------------------------------- # Nexus9000v# show running-config | include lacp # lacp system-priority 11 # lacp system-mac 00c1.4c00.bd15 role primary - name: Gather lacp facts from the device using nxos_lacp cisco.nxos.nxos_lacp: state: gathered # Task output (redacted) # ----------------------- # gathered: # system: # priority: 11 # mac: # address: 00c1.4c00.bd15 # role: primary a before: description: The configuration as structured data prior to module invocation. returned: always type: dict sample: > The configuration returned will always be in the same format of the parameters above. after: description: The configuration as structured data after module completion. returned: when changed type: dict sample: > The configuration returned will always be in the same format of the parameters above. commands: description: The set of commands pushed to the remote device. returned: always type: list sample: ['lacp system-priority 15', 'lacp system-mac 00c1.4c00.bd15 role primary'] ) AnsibleModule)LacpArgs)Lacpcgd}dg}ttj||d}t|j }|j di|y)z` Main entry point for module execution :returns: the result form module invocation ))statemergedconfig)r replacedr )r renderedr )r parsed)running_config)r rT) argument_spec required_ifmutually_exclusivesupports_check_modeN)rrrrexecute_module exit_json)rrmoduleresults h/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/cisco/nxos/plugins/modules/nxos_lacp.pymainrsW K 77 ,,- F&\ ( ( *FFv__main__N)__doc__ __future__rrrtype __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrRansible_collections.cisco.nxos.plugins.module_utils.network.nxos.argspec.lacp.lacprQansible_collections.cisco.nxos.plugins.module_utils.network.nxos.config.lacp.lacprr__name__rrrr*s\2A@ A Dw p .5c2 zFr