VhpdZddlmZmZmZeZdZdZdZ ddl m Z ddl m Z ddlmZd Zed k(rey y ) z# The module file for nxos_hostname )absolute_importdivisionprint_functionas module: nxos_hostname short_description: Hostname resource module. description: - This module manages hostname configuration on devices running Cisco NX-OS. version_added: 2.9.0 notes: - Tested against NX-OS 9.3.6. - This module works with connection C(network_cli) and C(httpapi). author: Nilashish Chakraborty (@NilashishC) 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 | section hostname). - 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: A dictionary of hostname configuration. type: dict suboptions: hostname: description: Hostname of the device. type: str state: description: - The state the configuration should be left in. - The states I(merged), I(replaced) and I(overridden) have identical behaviour for this module. - Refer to examples for more details. type: str choices: - merged - replaced - overridden - deleted - parsed - gathered - rendered default: merged ad # Using merged (replaced, overridden has the same behaviour) # Before state: # ------------- # nxos-9k-rdo# show running-config | section ^hostname # nxos-9k-rdo# - name: Merge the provided configuration with the existing running configuration cisco.nxos.nxos_hostname: config: hostname: NXOSv-9k # Task output # ------------- # before: {} # # commands: # - hostname NXOSv-9k # # after: # hostname: NXOSv-9k # After state: # ------------ # nxos-9k-rdo# show running-config | section ^hostname # hostname NXOSv-9k # # Using deleted # Before state: # ------------ # nxos-9k-rdo# show running-config | section ^hostname # hostname NXOSv-9k - name: Delete hostname from running-config cisco.nxos.nxos_hostname: state: deleted # Task output # ------------- # before: # hostname: NXOSv-9k # # commands: # - no hostname NXOSv-9k # # after: {} # Using gathered - name: Gather hostname facts using gathered cisco.nxos.nxos_hostname: state: gathered # Task output (redacted) # ----------------------- # gathered: # hostname: NXOSv-9k # Using rendered - name: Render platform specific configuration lines (without connecting to the device) cisco.nxos.nxos_hostname: config: hostname: NXOSv-9k # Task Output (redacted) # ----------------------- # rendered: # - hostname NXOSv-9k # Using parsed # parsed.cfg # ------------ # hostname NXOSv-9k - name: Parse externally provided hostname config cisco.nxos.nxos_hostname: running_config: "{{ lookup('file', 'parsed.cfg') }}" state: parsed # Task output (redacted) # ----------------------- # parsed: # hostname: NXOSv-9k a before: description: The configuration prior to the module execution. returned: when I(state) is C(merged), C(replaced), C(overridden), C(deleted) or C(purged) type: dict sample: > This output will always be in the same format as the module argspec. after: description: The resulting configuration after module execution. returned: when changed type: dict sample: > This output will always be in the same format as the module argspec. commands: description: The set of commands pushed to the remote device. returned: when I(state) is C(merged), C(replaced), C(overridden), C(deleted) or C(purged) type: list sample: - hostname switch01 rendered: description: The provided configuration in the task rendered in device-native format (offline). returned: when I(state) is C(rendered) type: list sample: - hostname switch01 gathered: description: Facts about the network resource gathered from the remote device as structured data. returned: when I(state) is C(gathered) type: list sample: > This output will always be in the same format as the module argspec. parsed: description: The device native config provided in I(running_config) option parsed into structured data as per module argspec. returned: when I(state) is C(parsed) type: list sample: > This output will always be in the same format as the module argspec. ) AnsibleModule) HostnameArgs)Hostnamec ttjddggdddggdddggdddggdddggdddgggd }t|j }|j d i|y ) z` Main entry point for module execution :returns: the result form module invocation configrunning_configstatemergedreplaced overriddenrenderedparsedT) argument_specmutually_exclusive required_ifsupports_check_modeN)rrrrexecute_module exit_json)moduleresults l/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/cisco/nxos/plugins/modules/nxos_hostname.pymainrs "00%'789 h + j8* - lXJ / j8* - h!1 2 3  ! Ff  , , .FFv__main__N)__doc__ __future__rrrtype __metaclass__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicrZansible_collections.cisco.nxos.plugins.module_utils.network.nxos.argspec.hostname.hostnamerYansible_collections.cisco.nxos.plugins.module_utils.network.nxos.config.hostname.hostnamerr__name__rrrr*s[A@ + ZX t) V5 . zFr