VhddlmZmZmZeZdZdZdZdZ ddl m Z m Z m Z ddlmZddlZddlZGd d e Zd Zed k(reyy) )absolute_importdivisionprint_functionz?Madhan Sankaranarayanan, Rishita Chowdhary, Abhishek MaheshwariaY --- module: swim_intent short_description: Intent module for SWIM related functions description: - Manage operation related to image importation, distribution, activation and tagging image as golden - API to fetch a software image from remote file system using URL for HTTP/FTP and upload it to Catalyst Center. Supported image files extensions are bin, img, tar, smu, pie, aes, iso, ova, tar_gz and qcow2. - API to fetch a software image from local file system and upload it to Catalyst Center Supported image files extensions are bin, img, tar, smu, pie, aes, iso, ova, tar_gz and qcow2. - API to tag/untag image as golen for a given family of devices - API to distribute a software image on a given device. Software image must be imported successfully into Catalyst Center before it can be distributed. - API to activate a software image on a given device. Software image must be present in the device flash. version_added: '6.6.0' extends_documentation_fragment: - cisco.dnac.intent_params author: Madhan Sankaranarayanan (@madhansansel) Rishita Chowdhary (@rishitachowdhary) Abhishek Maheshwari (@abmahesh) options: config_verify: description: Set to True to verify the Cisco Catalyst Center config after applying the playbook config. type: bool default: false state: description: The state of Catalyst Center after module completion. type: str choices: [merged] default: merged config: description: List of details of SWIM image being managed type: list elements: dict required: true suboptions: import_image_details: description: Details of image being imported type: dict suboptions: type: description: Specifies the import source, supporting local file import (local) or remote url import (remote). type: str local_image_details: description: Details of the local path of the image to be imported. type: dict suboptions: file_path: description: Provide the absolute file path needed to import an image from your local system (Eg "/path/to/your/file"). Accepted files formats are - .gz,.bin,.img,.tar,.smu,.pie,.aes,.iso,.ova,.tar_gz,.qcow2,.nfvispkg,.zip,.spa,.rpm. type: str is_third_party: description: Query parameter to determine if the image is from a third party (optional). type: bool third_party_application_type: description: Specify the ThirdPartyApplicationType query parameter to indicate the type of third-party application. Allowed values include WLC, LINUX, FIREWALL, WINDOWS, LOADBALANCER, THIRDPARTY, etc.(optional). WLC (Wireless LAN Controller) - It's a network device that manages and controls multiple wireless access points (APs) in a centralized manner. LINUX - It's an open-source operating system that provides a complete set of software packages and utilities. FIREWALL - It's a network security device that monitors and controls incoming and outgoing network traffic based on predetermined security rules.It acts as a barrier between a trusted internal network and untrusted external networks (such as the internet), preventing unauthorized access. WINDOWS - It's an operating system known for its graphical user interface (GUI) support, extensive compatibility with hardware and software, and widespread use across various applications. LOADBALANCER - It's a network device or software application that distributes incoming network traffic across multiple servers or resources. THIRDPARTY - It refers to third-party images or applications that are not part of the core system. NAM (Network Access Manager) - It's a network management tool or software application that provides centralized control and monitoring of network access policies, user authentication, and device compliance. WAN Optimization - It refers to techniques and technologies used to improve the performance and efficiency of WANs. It includes various optimization techniques such as data compression, caching, protocol optimization, and traffic prioritization to reduce latency, increase throughput, and improve user experience over WAN connections. Unknown - It refers to an unspecified or unrecognized application type. Router - It's a network device that forwards data packets between computer networks. They are essential for connecting multiple networks together and directing traffic between them. type: str third_party_image_family: description: Provide the ThirdPartyImageFamily query parameter to identify the family of the third-party image. Image Family name like PALOALTO, RIVERBED, FORTINET, CHECKPOINT, SILVERPEAK etc. (optional). type: str third_party_vendor: description: Include the ThirdPartyVendor query parameter to specify the vendor of the third party. type: str url_details: description: URL details for SWIM import type: dict suboptions: payload: description: Swim Import Via Url's payload. type: list elements: dict suboptions: application_type: description: An optional parameter that specifies the type of application. Allowed values include WLC, LINUX, FIREWALL, WINDOWS, LOADBALANCER, THIRDPARTY, etc. This is only applicable for third-party image types(optional). WLC (Wireless LAN Controller) - It's network device that manages and controls multiple wireless access points (APs) in a centralized manner. LINUX - It's an open source which provide complete operating system with a wide range of software packages and utilities. FIREWALL - It's a network security device that monitors and controls incoming and outgoing network traffic based on predetermined security rules.It acts as a barrier between a trusted internal network and untrusted external networks (such as the internet), preventing unauthorized access. WINDOWS - It's an OS which provides GUI support for various applications, and extensive compatibility with hardware and software. LOADBALANCER - It's a network device or software application that distributes incoming network traffic across multiple servers or resources. THIRDPARTY - It refers to third-party images or applications that are not part of the core system. NAM (Network Access Manager) - It's a network management tool or software application that provides centralized control and monitoring of network access policies, user authentication, and device compliance. WAN Optimization - It refers to techniques and technologies used to improve the performance and efficiency of WANs. It includes various optimization techniques such as data compression, caching, protocol optimization, and traffic prioritization to reduce latency, increase throughput, and improve user experience over WAN connections. Unknown - It refers to an unspecified or unrecognized application type. Router - It's a network device that forwards data packets between computer networks. They are essential for connecting multiple networks together and directing traffic between them. type: str image_family: description: Represents the name of the image family and is applicable only when uploading third-party images. Image Family name like PALOALTO, RIVERBED, FORTINET, CHECKPOINT, SILVERPEAK etc. (optional). type: str source_url: description: A mandatory parameter for importing a SWIM image via a remote URL. This parameter is required when using a URL to import an image.(For example, http://{host}/swim/cat9k_isoxe.16.12.10s.SPA.bin, ftp://user:password@{host}/swim/cat9k_isoxe.16.12.10s.SPA.iso) type: str is_third_party: description: Flag indicates whether the image is uploaded from a third party (optional). type: bool vendor: description: The name of the vendor, that applies only to third-party image types when importing via URL (optional). type: str schedule_at: description: ScheduleAt query parameter. Epoch Time (The number of milli-seconds since January 1 1970 UTC) at which the distribution should be scheduled (optional). type: str schedule_desc: description: ScheduleDesc query parameter. Custom Description (optional). type: str schedule_origin: description: ScheduleOrigin query parameter. Originator of this call (optional). type: str tagging_details: description: Details for tagging or untagging an image as golden type: dict suboptions: image_name: description: SWIM image name which will be tagged or untagged as golden. type: str device_role: description: Defines the device role, with permissible values including ALL, UNKNOWN, ACCESS, BORDER ROUTER, DISTRIBUTION, and CORE. ALL - This role typically represents all devices within the network, regardless of their specific roles or functions. UNKNOWN - This role is assigned to devices whose roles or functions have not been identified or classified within Cisco Catalsyt Center. This could happen if the platform is unable to determine the device's role based on available information. ACCESS - This role typically represents switches or access points that serve as access points for end-user devices to connect to the network. These devices are often located at the edge of the network and provide connectivity to end-user devices. BORDER ROUTER - These are devices that connect different network domains or segments together. They often serve as gateways between different networks, such as connecting an enterprise network to the internet or connecting multiple branch offices. DISTRIBUTION - This role represents function as distribution switches or routers in hierarchical network designs. They aggregate traffic from access switches and route it toward the core of the network or toward other distribution switches. CORE - This role typically represents high-capacity switches or routers that form the backbone of the network. They handle large volumes of traffic and provide connectivity between different parts of network, such as connecting distribution switches or providing interconnection between different network segments. type: str device_image_family_name: description: Device Image family name(Eg Cisco Catalyst 9300 Switch) type: str site_name: description: Site name for which SWIM image will be tagged/untagged as golden. If not provided, SWIM image will be mapped to global site. type: str device_series_name: description: This parameter specifies the name of the device series. It is used to identify a specific series of devices, such as Cisco Catalyst 9300 Series Switches, within the Cisco Catalyst Center. type: str version_added: 6.12.0 tagging: description: Booelan value to tag/untag SWIM image as golden If True then the given image will be tagged as golden. If False then the given image will be un-tagged as golden. type: bool image_distribution_details: description: Details for SWIM image distribution. Device on which the image needs to distributed can be speciifed using any of the following parameters - deviceSerialNumber, deviceIPAddress, deviceHostname or deviceMacAddress. type: dict suboptions: device_role: description: Defines the device role, with permissible values including ALL, UNKNOWN, ACCESS, BORDER ROUTER, DISTRIBUTION, and CORE. ALL - This role typically represents all devices within the network, regardless of their specific roles or functions. UNKNOWN - This role is assigned to devices whose roles or functions have not been identified or classified within Cisco Catalsyt Center. This could happen if the platform is unable to determine the device's role based on available information. ACCESS - This role typically represents switches or access points that serve as access points for end-user devices to connect to the network. These devices are often located at the edge of the network and provide connectivity to end-user devices. BORDER ROUTER - These are devices that connect different network domains or segments together. They often serve as gateways between different networks, such as connecting an enterprise network to the internet or connecting multiple branch offices. DISTRIBUTION - This role represents function as distribution switches or routers in hierarchical network designs. They aggregate traffic from access switches and route it toward the core of the network or toward other distribution switches. CORE - This role typically represents high-capacity switches or routers that form the backbone of the network. They handle large volumes of traffic and provide connectivity between different parts of network, such as connecting distribution switches or providing interconnection between different network segments. type: str device_family_name: description: Specify the name of the device family such as Switches and Hubs, etc. type: str site_name: description: Used to get device details associated to this site. type: str device_series_name: description: This parameter specifies the name of the device series. It is used to identify a specific series of devices, such as Cisco Catalyst 9300 Series Switches, within the Cisco Catalyst Center. type: str version_added: 6.12.0 image_name: description: SWIM image's name type: str device_serial_number: description: Device serial number where the image needs to be distributed type: str device_ip_address: description: Device IP address where the image needs to be distributed type: str device_hostname: description: Device hostname where the image needs to be distributed type: str device_mac_address: description: Device MAC address where the image needs to be distributed type: str image_activation_details: description: Details for SWIM image activation. Device on which the image needs to activated can be speciifed using any of the following parameters - deviceSerialNumber, deviceIPAddress, deviceHostname or deviceMacAddress. type: dict suboptions: device_role: description: Defines the device role, with permissible values including ALL, UNKNOWN, ACCESS, BORDER ROUTER, DISTRIBUTION, and CORE. ALL - This role typically represents all devices within the network, regardless of their specific roles or functions. UNKNOWN - This role is assigned to devices whose roles or functions have not been identified or classified within Cisco Catalsyt Center. This could happen if the platform is unable to determine the device's role based on available information. ACCESS - This role typically represents switches or access points that serve as access points for end-user devices to connect to the network. These devices are often located at the edge of the network and provide connectivity to end-user devices. BORDER ROUTER - These are devices that connect different network domains or segments together. They often serve as gateways between different networks, such as connecting an enterprise network to the internet or connecting multiple branch offices. DISTRIBUTION - This role represents function as distribution switches or routers in hierarchical network designs. They aggregate traffic from access switches and route it toward the core of the network or toward other distribution switches. CORE - This role typically represents high-capacity switches or routers that form the backbone of the network. They handle large volumes of traffic and provide connectivity between different parts of network, such as connecting distribution switches or providing interconnection between different network segments. type: str device_family_name: description: Specify the name of the device family such as Switches and Hubs, etc. type: str site_name: description: Used to get device details associated to this site. type: str activate_lower_image_version: description: ActivateLowerImageVersion flag. type: bool device_upgrade_mode: description: It specifies the mode of upgrade to be applied to the devices having the following values - 'install', 'bundle', and 'currentlyExists'. install - This mode instructs Cisco Catalyst Center to perform a clean installation of the new image on the target devices. When this mode is selected, the existing image on the device is completely replaced with the new image during the upgrade process. This ensures that the device runs only the new image version after the upgrade is completed. bundle - This mode instructs Cisco Catalyst Center bundles the new image with the existing image on the device before initiating the upgrade process. This mode allows for a more efficient upgrade process by preserving the existing image on the device while adding the new image as an additional bundle. After the upgrade, the device can run either the existing image or the new bundled image, depending on the configuration. currentlyExists - This mode instructs Cisco Catalyst Center to checks if the target devices already have the desired image version installed. If image already present on devices, no action is taken and upgrade process is skipped for those devices. This mode is useful for avoiding unnecessary upgrades on devices that already have the correct image version installed, thereby saving time. type: str distribute_if_needed: description: Enable the distribute_if_needed option when activating the SWIM image. type: bool image_name: description: SWIM image's name type: str device_serial_number: description: Device serial number where the image needs to be activated type: str device_ip_address: description: Device IP address where the image needs to be activated type: str device_hostname: description: Device hostname where the image needs to be activated type: str device_mac_address: description: Device MAC address where the image needs to be activated type: str schedule_validate: description: ScheduleValidate query parameter. ScheduleValidate, validates data before schedule (optional). type: bool requirements: - dnacentersdk == 2.4.5 - python >= 3.9 notes: - SDK Method used are software_image_management_swim.SoftwareImageManagementSwim.import_software_image_via_url, software_image_management_swim.SoftwareImageManagementSwim.tag_as_golden_image, software_image_management_swim.SoftwareImageManagementSwim.trigger_software_image_distribution, software_image_management_swim.SoftwareImageManagementSwim.trigger_software_image_activation, - Paths used are post /dna/intent/api/v1/image/importation/source/url, post /dna/intent/api/v1/image/importation/golden, post /dna/intent/api/v1/image/distribution, post /dna/intent/api/v1/image/activation/device, - Added the parameter 'dnac_api_task_timeout', 'dnac_task_poll_interval' options in v6.13.2. aR - name: Import an image from a URL, tag it as golden and load it on device cisco.dnac.swim_intent: dnac_host: "{{dnac_host}}" dnac_username: "{{dnac_username}}" dnac_password: "{{dnac_password}}" dnac_verify: "{{dnac_verify}}" dnac_port: "{{dnac_port}}" dnac_version: "{{dnac_version}}" dnac_debug: "{{dnac_debug}}" dnac_log_level: "{{dnac_log_level}}" dnac_log: true config: - import_image_details: type: remote url_details: payload: - source_url: "http://10.10.10.10/stda/cat9k_iosxe.17.12.01.SPA.bin" is_third_party: false tagging_details: image_name: cat9k_iosxe.17.12.01.SPA.bin device_role: ACCESS device_image_family_name: Cisco Catalyst 9300 Switch site_name: Global/USA/San Francisco/BGL_18 tagging: true image_distribution_details: image_name: cat9k_iosxe.17.12.01.SPA.bin device_serial_number: FJC2327U0S2 image_activation_details: image_name: cat9k_iosxe.17.12.01.SPA.bin schedule_validate: false activate_lower_image_version: false distribute_if_needed: true device_serial_number: FJC2327U0S2 - name: Import an image from local, tag it as golden. cisco.dnac.swim_intent: dnac_host: "{{dnac_host}}" dnac_username: "{{dnac_username}}" dnac_password: "{{dnac_password}}" dnac_verify: "{{dnac_verify}}" dnac_port: "{{dnac_port}}" dnac_version: "{{dnac_version}}" dnac_debug: "{{dnac_debug}}" dnac_log_level: "{{dnac_log_level}}" dnac_log: true config: - import_image_details: type: local local_image_details: file_path: /Users/Downloads/cat9k_iosxe.17.12.01.SPA.bin is_third_party: false tagging_details: image_name: cat9k_iosxe.17.12.01.SPA.bin device_role: ACCESS device_image_family_name: Cisco Catalyst 9300 Switch site_name: Global/USA/San Francisco/BGL_18 tagging: true - name: Tag the given image as golden and load it on device cisco.dnac.swim_intent: dnac_host: "{{dnac_host}}" dnac_username: "{{dnac_username}}" dnac_password: "{{dnac_password}}" dnac_verify: "{{dnac_verify}}" dnac_port: "{{dnac_port}}" dnac_version: "{{dnac_version}}" dnac_debug: "{{dnac_debug}}" dnac_log_level: "{{dnac_log_level}}" dnac_log: true config: - tagging_details: image_name: cat9k_iosxe.17.12.01.SPA.bin device_role: ACCESS device_image_family_name: Cisco Catalyst 9300 Switch site_name: Global/USA/San Francisco/BGL_18 tagging: true - name: Un-tagged the given image as golden and load it on device cisco.dnac.swim_intent: dnac_host: "{{dnac_host}}" dnac_username: "{{dnac_username}}" dnac_password: "{{dnac_password}}" dnac_verify: "{{dnac_verify}}" dnac_port: "{{dnac_port}}" dnac_version: "{{dnac_version}}" dnac_debug: "{{dnac_debug}}" dnac_log_level: "{{dnac_log_level}}" dnac_log: true config: - tagging_details: image_name: cat9k_iosxe.17.12.01.SPA.bin device_role: ACCESS device_image_family_name: Cisco Catalyst 9300 Switch site_name: Global/USA/San Francisco/BGL_18 tagging: false - name: Distribute the given image on devices associated to that site with specified role. cisco.dnac.swim_intent: dnac_host: "{{dnac_host}}" dnac_username: "{{dnac_username}}" dnac_password: "{{dnac_password}}" dnac_verify: "{{dnac_verify}}" dnac_port: "{{dnac_port}}" dnac_version: "{{dnac_version}}" dnac_debug: "{{dnac_debug}}" dnac_log_level: "{{dnac_log_level}}" dnac_log: true config: - image_distribution_details: image_name: cat9k_iosxe.17.12.01.SPA.bin site_name: Global/USA/San Francisco/BGL_18 device_role: ALL device_family_name: Switches and Hubs device_series_name: Cisco Catalyst 9300 Series Switches - name: Activate the given image on devices associated to that site with specified role. cisco.dnac.swim_intent: dnac_host: "{{dnac_host}}" dnac_username: "{{dnac_username}}" dnac_password: "{{dnac_password}}" dnac_verify: "{{dnac_verify}}" dnac_port: "{{dnac_port}}" dnac_version: "{{dnac_version}}" dnac_debug: "{{dnac_debug}}" dnac_log_level: "{{dnac_log_level}}" dnac_log: true config: - image_activation_details: image_name: cat9k_iosxe.17.12.01.SPA.bin site_name: Global/USA/San Francisco/BGL_18 device_role: ALL device_family_name: Switches and Hubs device_series_name: Cisco Catalyst 9300 Series Switches scehdule_validate: false activate_lower_image_version: true distribute_if_needed: true aI #Case: SWIM image is successfully imported, tagged as golden, distributed and activated on a device response: description: A dictionary with activation details as returned by the Catalyst Center Python SDK returned: always type: dict sample: > { "response": { "additionalStatusURL": String, "data": String, "endTime": 0, "id": String, "instanceTenantId": String, "isError": bool, "lastUpdate": 0, "progress": String, "rootId": String, "serviceType": String, "startTime": 0, "version": 0 }, "msg": String } )DnacBasevalidate_list_of_dictsget_dict_result) AnsibleModuleNceZdZdZfdZdZdZdZdZdZ dZ dd Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZxZS) DnacSwimsz9Class containing member attributes for Swim intent modulec4t||dg|_y)Nmerged)super__init__supported_states)selfmodule __class__s j/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/cisco/dnac/plugins/modules/swim_intent.pyrzDnacSwims.__init__1s  !) cb|js,d|_d|_|j|jd|St t dt dt dt d}|j |j|_t |j|\}}|r;dj||_|j|jdd|_|S||_d jt||_|j|jd d|_|S) a Validate the fields provided in the playbook. Checks the configuration provided in the playbook against a predefined specification to ensure it adheres to the expected structure and data types. Parameters: - self: The instance of the class containing the 'config' attribute to be validated. Returns: The method returns an instance of the class with updated attributes: - self.msg: A message describing the validation result. - self.status: The status of the validation (either 'success' or 'failed'). - self.validated_config: If successful, a validated version of 'config' parameter. Example: To use this method, create an instance of the class and call 'validate_input' on it. If the validation succeeds, 'self.status' will be 'success' and 'self.validated_config' will contain the validated configuration. If it fails, 'self.status' will be 'failed', 'self.msg' will describe the validation issues. successz=Configuration is not available in the playbook for validationERRORdict)type)import_image_detailstagging_detailsimage_distribution_detailsimage_activation_detailsz#Invalid parameters in playbook: {0}failedz2Successfully validated playbook config params: {0}INFO) configstatusmsglogrcamel_to_snake_caserformatvalidated_configstr)r temp_spec valid_tempinvalid_paramss rvalidate_inputzDnacSwims.validate_input5s&{{#DKVDH HHTXXw 'K!%6!2 f-'+'8%)v%6  ..t{{; &< KK& " N <CCNSDH HHTXXw '"DKK *GNNsS]_ 6"  rcd}d}d} |jjdddd|i}|rQ|j d jt|d |jd }|djd}d}||fS#t$rb}dj||_|j |jd |j j|j Yd}~d}~wwxYw)a Parameters: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Returns: tuple: A tuple containing two values: - site_exists (bool): A boolean indicating whether the site exists (True) or not (False). - site_id (str or None): The ID of the site if it exists, or None if the site is not found. Description: This method checks the existence of a site in the Catalyst Center. If the site is found,it sets 'site_exists' to True, retrieves the site's ID, and returns both values in a tuple. If the site does not exist, 'site_exists' is set to False, and 'site_id' is None. If an exception occurs during the site lookup, an exception is raised. FNsitesget_siteTnamefamilyfunction op_modifiesparamszMAn exception occurred: Site '{0}' does not exist in the Cisco Catalyst Centerrr#z*Received API response from 'get_site': {0}DEBUGresponserid) dnac_exec Exceptionr&r#r$r fail_jsonr(get)r site_name site_existssite_idr8esites rr@zDnacSwims.site_existshs  0yy#  * 'H  HHAHHXWY` a<< +D1gkk$'GKW%% 0fmmnwxDH HHTXXw ' KK ! !dhh ! / / 0s!B C+ AC&&C+c|jjdddd|i}|jdjt |d|j d}t |d k(r8|d j d }|jd j||d |Sdj|}|j|d|jj||S) Retrieve the unique image ID based on the provided image name. Parameters: self (object): An instance of a class used for interacting with Cisco Catalyst Center. name (str): The name of the software image to search for. Returns: str: The unique image ID (UUID) corresponding to the given image name. Raises: AnsibleFailJson: If the image is not found in the response. Description: This function sends a request to Cisco Catalyst Center to retrieve details about a software image based on its name. It extracts and returns the image ID if a single matching image is found. If no image or multiple images are found with the same name, it raises an exception. software_image_management_swimget_software_image_detailsT image_namer1lenrr=)rr0image_response image_listimage_id error_messages r get_image_idzDnacSwims.get_image_ids 31 $' )  OVVWZ[iWjkmtu#'' 3  Oq !!}((5H HH7>>tXNPV W  BHHNM HH]G , KK ! !mn ! Mrc|jjdddd|i}|jdjt |d|j d}t |d k(r7|d j d }|jd j|d |Sdj|}|j|d|jj||S)a% Retrieve the unique image name based on the provided image id. Parameters: self (object): An instance of a class used for interacting with Cisco Catalyst Center. id (str): The unique image ID (UUID) of the software image to search for. Returns: str: The image name corresponding to the given unique image ID (UUID) Raises: AnsibleFailJson: If the image is not found in the response. Description: This function sends a request to Cisco Catalyst Center to retrieve details about a software image based on its id. It extracts and returns the image name if a single matching image is found. If no image or multiple images are found with the same name, it raises an exception. rFrGT image_uuidr1rIr7r8rJrr0zISWIM image '{0}' has been fetched successfully from Cisco Catalyst Centerr zDSWIM image with Id '{0}' could not be found in Cisco Catalyst CenterrrLrM)rrQrOrPrHrRs rget_image_name_from_idz DnacSwims.get_image_name_from_ids 31 (+ )  OVVWZ[iWjkmtu#'' 3  Oq #A**62J HH`gghrsu{ |  ciijrsM HH]G , KK ! !mn ! Mrcd}|jjdddd|i}|jdjt |d|j d }t |d k(rd}|S) rEFrFrGTrHr1rIr7r8rJ)r:r;r$r&r(r>rN)rr0 image_existrOrPs ris_image_existzDnacSwims.is_image_exists|  31 $' )  OVVWZ[iWjkmtu#'' 3  Oq Krcd}|jjddd|}|jdjt |d|j d}t |d k(r@|d j d }|jd jt |d |Sdjt ||_|j|jd|S)a Retrieve the unique device ID based on the provided parameters. Parameters: self (object): An instance of a class used for interacting with Cisco Catalyst Center. params (dict): A dictionary containing parameters to filter devices. Returns: str: The unique device ID corresponding to the filtered device. Description: This function sends a request to Cisco Catalyst Center to retrieve a list of devices based on the provided filtering parameters. If a single matching device is found, it extracts and returns the device ID. If no device or multiple devices match the criteria, it raises an exception. Ndevicesget_device_listTr11Received API response from 'get_device_list': {0}r7r8rJrr9zDevice Id: {0}r zYDevice with params: '{0}' not found in Cisco Catalyst Center so can't fetch the device idWARNING)r:r;r$r&r(r>rNr#)rr5 device_idr8 device_lists r get_device_idzDnacSwims.get_device_ids 99??& #  DKKCPXMZ\cdll:.   !#A**40I HH%,,S^r#set intersection)rr?rd device_roledevice_series_namedevice_uuid_listr@rA site_paramsr8rBsite_response_listitem item_dict device_paramsrkrj initial_execsite_memberships_idsdevice_response_idsdevice_list_responsedevice_responses rget_device_uuidszDnacSwims.get_device_uuidss]" I HHDFL M!%!1!1)!<g HH$$*F9$5v ?# # !,,T27I7R7RSW7XRYYZlmouv%),>%>%E"* $yy) " 'H CJJ3x=Y[bcH% 9DJ!%j!19I&--i89 9    % 'K)# --/ 461, (-2M'*.4unM(++/99??(!2,,;,( $(L+/99??(!2$(, ,;,(  !"6":"::"FHHszz|EFHNO.FD01[@"006ttDY?Z8[]ce'..tN/CDEE^#*> HHkrrs|}@F G# #34AA#FYBZ[a $ HH^eefoqtuvqwx{D E# # $H (qxxy|}~yA7+'' (sD&LB MC!M M,M M M N!rr#rr=haveupdate)r family_namerr8device_family_dbdevice_family_detailsrs rget_device_family_identifierz&DnacSwims.get_device_family_identifiers 99??34#  RYYZ]^fZghjqr#<< 3 $34DnVa$b !$+@+D+DE]+^(3K/09@@E]A^_agh9@@[AQR7+ %%$((dhhZ%H II  T " rc |jjdri}|jjd}|jdr:|jdjdd}|j|}||d<ni|jjdr|jjd|d<n/|j dd|j jdg |jd }|rN|d k7rId }|j|\}}|rH||d <|j dj|t|dnd|d <|j dd|jj||jd}|j||jjdri}|jjd} | jd }|rHd }|j|\}}|r0||d <|j dj|t|d| jdr:| jdjdd}|j|}||d<ni|jjdr|jjd|d<n/|j dd|j jdg t| jd| jd| jd| jd} |j| } | | |d<|jj||jjdri}|jjd} | jdr:| jdjdd}|j|}||d <ni|jjdr|jjd|d <n/|j d!d|j jd!g | jd }|rHd }|j|\}}|r0||d <|j d"j|t|d#t| jd| jd| jd| jd} |j| } | | |d$<|jj||j d%jt|jd#|S)&a Retrieve and store various software image and device details based on user-provided information. Returns: self: The current instance of the class with updated 'have' attributes. Raises: AnsibleFailJson: If required image or device details are not provided. Description: This function populates the 'have' dictionary with details related to software images, site information, device families, distribution devices, and activation devices based on user-provided data in the 'want' dictionary. It validates and retrieves the necessary information from Cisco Catalyst Center to support later actions. rrH/tagging_image_idimported_image_idz&Image details for tagging not providedCRITICALrLr?rcFrAz'Site {0} exists having the site id: {1}r7z-1z/Site Name not given by user. Using global site.r^device_image_family_namedistribution_detailsz*Site '{0}' exists and has the site ID: {1}distribution_image_idz>Image details required for distribution have not been providedrdevice_hostnamedevice_serial_numberdevice_ip_addressdevice_mac_address)hostname serialNumberrn macAddressdistribution_device_idactivation_detailsactivation_image_idzsplitrSrr$rr=r@r&r(rrrra) rrrr0rQr?r@rArrr~r_rs rget_havezDnacSwims.get_haves 99==* +D"iimm,=>O""<0&**<8>>sCBG,,T2+3'(23+/99==9L+M'(A:N %%*R]_%`(++K8IY(2# )-)9)9))D&g&-DOHHFMMiY\]dYefhop#'YJIV II  T ")--.HIK  - -k : 99==/ 0D#'99==1G#H ,00=I# )-)9)9))D&g&-DOHHIPPQZ\_`g\hikrs$'' 5+// =CCCHL,,T208,-2304 >Q0R,-Y[bc %%*juw%x -112CD1556LM$8$<$<=P$Q/334HI M **=9I$1:-. II  T " 99==- .D!%/C!D !%%l3)--l;AA#FrJ,,T2.6*+23.2iimmlowerr$r&rr=rr()rr!rs rget_wantzDnacSwims.get_want2s[  ::, -#'D "(**-C"D"H"H"P"V"V"XD M"h.-3ZZ8N-O-S-STa-b)*m$//5zz:P/Q/U/UVk/l+,ovvw{}JxKLNXY %%*d%e"(**->"? '-zz2N'O #$%+ZZ0J%K !"  ,33C NCVL rc  |jjd}|sTd|_d|_|j|jd<|j |jdd|jd<|S|dk(r=|jjd jd d jd }n*|jjd jd}|j dd}|j|}ddddd}|r|j|}||jd<dj||_|j|jd<|j |jdd|_d|jd<|S|jjddk(ri}|jjd jd d }t|j} |jD]\} } | | vs || } | || <|g} t| |jjd jd|jjd jd|jjd jd}d}n |jjd jd}t|jjd jd|jjd jd|jjd jd |jjd jd!d"tj j#|t%|d#d$fid%&}d'}|j&j)d(|d)|*}|j d+j|t+|d,i}|jd-jd.} |j-|}|j dd}|rd/|jd0j/vrbd)|jd<d|_d1j||_|j|jd<|j |jdn|r|jd2rd3|jd4d5vrbd6j||_|j|jd<|j |jdd|_d|jd<nfd7|_|jd4d8j||_|j |jd|j|jd-<|S|r|n||jd-<|j dd}|j|}||jd<|S#t0$rN}d7|_d9|_|j |jd:|j|jd-<Yd%}~|Sd%}~wwxYw);aU Check the image import type and fetch the image ID for the imported image for further use. Parameters: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Returns: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Description: This function checks the type of image import (URL or local) and proceeds with the import operation accordingly. It then monitors the import task's progress and updates the 'result' dictionary. If the operation is successful, 'changed' is set to True. Additionally, if tagging, distribution, or activation details are provided, it fetches the image ID for the imported image and stores it in the 'have' dictionary for later use. rrz[Error: Details required for importing SWIM image. Please provide the necessary information.r#r^Fchangedrrpayloadr source_urlr file_pathrr sourceURL imageFamilyapplicationType thirdParty)r image_familyapplication_typeis_third_partyrz7Image '{0}' already exists in the Cisco Catalyst Centerr schedule_at schedule_descschedule_origin)r scheduleAt scheduleDescscheduleOriginimport_software_image_via_urlrthird_party_vendorthird_party_image_familythird_party_application_typefilerbzapplication/octet-streamN)rrrrmultipart_fieldsmultipart_monitor_callbackimport_local_software_imagerFTr1z#Received API response from {0}: {1}r7r8taskIdcompleted successfullyprogressz$Swim Image {0} imported successfullyisErrorzalready exists failureReasonz:SWIM Image {0} already exists in the Cisco Catalyst Centerrz"SWIM Image {0} seems to be invalidzError: Import image details are not provided in the playbook, or the Import Image API was not triggered successfully. Please ensure the necessary details are provided and verify the status of the Import Image process.r)rr>r"r#resultr$rrYrSrr&listkeysitemsrospathbasenameopenr:r;r(get_task_detailsrr<)rrrHr0rXimport_key_mappingrQimport_payload_dict temp_payloadkeys_to_changekeyval api_key_nameimport_image_payload import_paramsimport_functionrr8 task_detailstask_idrBs rget_diff_importzDnacSwims.get_diff_importWsx /))-- 6K' x%)XX E"9-). I& h&!YY]]+?@DDYOPQRVVWcd !YY]]+ABFF{S ##C(,D--d3K* -$5". " ,,T219 -.T[[\`a%)XX E"6*' ). I& yy}}]+x7&(##yy}}-ABFFyQRST !%&8&=&=&?!@ , 2 2 4@HCn,'9#'> rVrrrsr:r;r$r&r(r"rr#r) rrtag_image_goldenrH image_paramsr8 image_statusrrfailure_reasonrRs rget_diff_taggingzDnacSwims.get_diff_taggings))--(9:*..y900?Q1RS YY]]#56IIMM),%)YY]]3M%N'++M5AGGI  99??38 #  V]]^abj^klnuv<< + #N3L 0@ @' ). I&ellmwx%)XX E"6* L4D$D' ). I&jqqr|}%)XX E"6*  &89yy}}Y/'+yy}}5O'P*..}eDJJL L HHFMMcR^N_`bh iyy7. # 'H HHLSSTWX`Tabdk l HHIPPQTUaQbcek lyy76 # 'H HHT[[\_`h\ijls t"DKqxxzDEDH HHTXXw '&*hhDKK #K ,,z*..x8009L##I.<r<)rr_r8 device_iprBrRs rget_device_ip_from_idzDnacSwims.get_device_ip_from_id]s" +yy * i( 'H HHHOOPST\P]^`g h||J/2H %:;I  +qxxy|}~yAM HH]G ,M* * +sA1A44 B9=7B44B9c8g}d}|jD]\}}tj}|jjd} tj} | |z |k\r5|j dj |||d|j ||j|} | jdsQd| jdvr>d|jd <d |_ |j d j ||d |d z }| jdrFdj ||} |j | d| |jd<|j |Rtj|jjdK||fS)a# Check the status of the SWIM (Software Image Management) task for each device. Args: self (object): An instance of a class used for interacting with Cisco Catalyst Center. swim_task_dict (dict): A dictionary containing the mapping of device IP address to the respective task ID. swim_task_name (str): The name of the SWIM task being checked which is either Distribution or Activation. Returns: tuple: A tuple containing two elements: - device_ips_list (list): A list of device IP addresses for which the SWIM task failed. - device_count (int): The count of devices for which the SWIM task was successful. Description: This function iterates through the distribution_task_dict, which contains the mapping of device IP address to their respective task ID. It checks the status of the SWIM task for each device by repeatedly querying for task details until the task is either completed successfully or fails. If the task is successful, the device count is incremented. If the task fails, an error message is logged, and the device IP is appended to the device_ips_list and return a tuple containing the device_ips_list and device_count. rdnac_api_task_timeoutTzMax timeout of {0} sec has reached for the task id '{1}' for the device '{2}' and unexpected task status so moving out to next task idr^rrrrrz*Image {0} successfully for the device '{1}r rJz*Image {0} gets failed for the device '{1}'rr8dnac_task_poll_interval) rtimer5r>r$r&rrrrr"sleep) rswim_task_dictswim_task_namedevice_ips_list device_countrr start_time max_timeoutend_timer error_msgs rcheck_swim_task_statusz DnacSwims.check_swim_task_statuss& "0"6"6"8 G IwJ++//*ABK99;z)k9HHNNTfU`biktNuxAB#**95#44W= #'' 21\5E5Ej5QQ-1DKK *"+DKHHIPPQ_ajkmst A%L##I. L S STbdm nIHHY0.:DKK +#**95 4;;??+DEF1  G< ,,rc |jjd}|jd}|jd}|jdd}|jd}|j||||}|jjd}d|_d|_d|_|jjd rtt|jjd | g }|jd jt|d |jjddd|} |jdjt| d| ri} | jdjd} |j| } | jdsQd| jdvr>d|jd<d|_d|_dj||jd< |S| jdrKd|_dj||_|j|j d| |jd< |S| r| n| |jd<|St#|d k(rEd|_d!|_|j |jd<|j|j d"|S|jd#jt|d i} |D]} |j%| }tt| | g }|jd jt|d |jjddd|} |jdjt| d| si} | jdjd} | | |<|j'| d$\}}|d k(rd|_d%j||_n|t#|k(r4d|jd<d|_d|_d&j||_n]d|jd<d|_d|_d'j||_|jd(jt|d)|j |jd<|j|j d |S)*a Get image distribution parameters from the playbook and trigger image distribution. Parameters: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Returns: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Description: This function retrieves image distribution parameters from the playbook's 'distribution_details' and triggers the distribution of the specified software image to the specified device. It monitors the distribution task's progress and updates the 'result' dictionary. If the operation is successful, 'changed' is set to True. rr?device_family_namerwrgrxrFr) deviceUuidrK)rzDistribution Params: {0}r rF#trigger_software_image_distributionTr1zEReceived API response from 'trigger_software_image_distribution': {0}r7r8rrrrrrz*Image with Id {0} Distributed Successfullyr#rz%Image with Id {0} Distribution FailedrrzZThe SWIM image distribution task could not proceed because no eligible devices were found.r^z0Device UUIDs involved in Image Distribution: {0} Distributionz5Image with Id {0} Distribution Failed for all devicesz:Image with Id {0} Distributed Successfully for all devicesz9Image with Id '{0}' Distributed and partially successfullz0For device(s) {0} image Distribution gets failedr)rr>rr complete_successful_distributionpartial_successful_distributionsingle_device_distributionrr$r&r(r:r;rrr"r#rNrr )rrr?rdrwrxryrQdistribution_paramsr8rrdistribution_task_dict device_uuiddevice_management_iprdevice_distribution_counts rget_diff_distributionzDnacSwims.get_diff_distributions $yy}}-CD(,,[9 ,001EF *..}eD 1556JK00M;Xjk99==!8905-/4,*/' 99==1 2"&#yy}}-EF&#  HH/66s;N7OPRX Yyy7> * 'H HH\ccdghpdqrt{ |! ",,z266x@#'#8#8#AL'++I659I9I*9UU15 I.&/ :>7-Y-`-`ai-j E*K$'' 2&. #J#Q#QRZ#[732> J/K?KlPXDKK +%(K  A %#DKsDH!%DKK  HHTXXy )K CJJ3O_K`acij!#+ GK#'#=#=k#J "&*&#  HH/66s;N7OPRX Yyy7> * 'H HH\ccdghpdqrt{ |! ",,z266x@?F&';<) G,6:5P5PQgiw5x22 $ )"DKNUUV^_DH &#.>*? ?%)DKK "#DK48D 1SZZ[cdDH%)DKK "#DK38D 0RYYZbcDH HHGNNsSbOcdfp q!XX E 6" rcz |jjd}|jd}|jd}|jdd}|jd}|j||||}|jjd}d|_d|_d|_|jjd rt|jd |jd |jd |jjd |g g}t|jd|} |jdjt| d|jjddd| } |jdjt| di} | jdjd} |j| } | jds@d| jdvr-d|jd<d|jd<d |_d|_n\| jdrJd!j||_d"|_| |jd<|j|j d#|S| r| n| |jd<|St#|d$k(rEd |_d%|_|j |jd<|j|j d&|S|jd'jt|di} |D] }|j%|}t|jd |jd |jd ||g g}t|jd|} |jdjt| d|jjddd| } |jdjt| d| si} | jdjd} | | |<|j'| d(\}}|d$k(rd"|_d)j||_n|t#|k(r4d|jd<d |_d|_d*j||_n]d|jd<d |_d|_d+j||_|jd,jt|d-|j |jd<|j|j d|S).a Get image activation parameters from the playbook and trigger image activation. Parameters: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Returns: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Description: This function retrieves image activation parameters from the playbook's 'activation_details' and triggers the activation of the specified software image on the specified device. It monitors the activation task's progress and updates the 'result' dictionary. If the operation is successful, 'changed' is set to True. rr?rrwrgrxrFractivate_lower_image_versiondevice_upgrade_modedistribute_if_needed)activateLowerImageVersiondeviceUpgradeModedistributeIfNeededr imageUuidListscehdule_validate)schedule_validaterzActivation Params: {0}r rF!trigger_software_image_activationTr1zCReceived API response from 'trigger_software_image_activation': {0}r7r8rrrrrzImage Activated successfullyr#rz.Activation for Image with Id '{0}' gets failedrrrzXThe SWIM image activation task could not proceed because no eligible devices were found.r^z.Device UUIDs involved in Image Activation: {0} Activationz5Image with Id '{0}' activation failed for all devicesz:Image with Id '{0}' activated successfully for all devicesz7Image with Id '{0}' activated and partially successfullz.For Device(s) {0} Image activation gets Failedr)rr>rrcomplete_successful_activationpartial_successful_activationsingle_device_activationrr$r&r(r:r;rrr"r#rNrr )rrr?rdrwrxryrQractivation_paramsr8rractivation_task_dictrrrdevice_activation_counts rget_diff_activationzDnacSwims.get_diff_activation/s"YY]]+?@&**;7 *../CD (,,]EB /334HI00M;Xjk99==!67.3+-2*(-% 99==/ 0*<*@*@A_*`"4"8"89N"O#5#9#9:P#Q99==)?@'j G!%"4"8"89L"M!  HH-44S9J5KLf Uyy7< ( 'H HHZaabefnbopry zLll:.228rcheck_return_statusrr-)rr!s rget_diff_mergedzDnacSwims.get_diff_mergedso ::' (  ! ! # 7 7 9 ::2 3  & & ( < < > ::0 1  $ $ & : : < rc|dk(r=|jjdjddjd}n*|jjdjd}|jdd }|j|}|r;d |_d j ||_|j|j d |S|jd j |d |S)aA Verify the successful import of a software image into Cisco Catalyst Center. Args: self (object): An instance of a class used for interacting with Cisco Catalyst Center. import_type (str): The type of import, either 'remote' or 'local'. Returns: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Description: This method verifies the successful import of a software image into Cisco Catalyst Center. It checks whether the image exists in Catalyst Center based on the provided import type. If the image exists, the status is set to 'success', and a success message is logged. If the image does not exist, a warning message is logged indicating a potential import failure. rrrrrrrrrrzeThe requested Image '{0}' imported in the Cisco Catalyst Center and Image presence has been verified.r zThe playbook input for SWIM Image '{0}' does not align with the Cisco Catalyst Center, indicating that image may not have imported successfully.)rr>rrYr"r&r#r$)rrrHr0rXs rverify_diff_importedzDnacSwims.verify_diff_importeds ( "';<@@KANRRS_`J'=>BB;OJ$R())$/ #DK~FFGKLDH HHTXXv &   HH??Evd|V U rc |jjd}|jd}|jjd}|j|}t |jjd|jjd|jjd|jddj }|j d jt|d |jjd d d |}|j djt|d|jd}|rt|d}||k(rh|r4dj||_ |j |jd |Sdj||_ |j |jd |S|j dd |S)a Verify the Golden tagging status of a software image in Cisco Catalyst Center. Args: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Returns: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Description: This method verifies the tagging status of a software image in Cisco Catalyst Center. It retrieves tagging details from the input, including the desired tagging status and image ID. Using the provided image ID, it obtains image parameters required for checking the image status. The method then queries Catalyst Center to get the golden tag status of the image. If the image status matches the desired tagging status, a success message is logged. If there is a mismatch between the playbook input and the Catalyst Center, a warning message is logged. rrrrArrwrgrz0Parameters for checking the status of image: {0}r rFrTr1rr7r8rzThe requested image '{0}' has been tagged as golden in the Cisco Catalyst Center and its status has been successfully verified.zThe requested image '{0}' has been un-tagged as golden in the Cisco Catalyst Center and image status has been verified.zMismatch between the playbook input for tagging/un-tagging image as golden and the Cisco Catalyst Center indicates that the tagging/un-tagging task was not executed successfully.) rr>rrVrrsr$r&r(r:r;r#)rrrrQrHrr8rs rverify_diff_taggedzDnacSwims.verify_diff_taggeds ))--(9:*..y999==!3400: YY]]#56IIMM),%)YY]]3M%N'++M5AGGI  CJJ3|K\]_ef99??38 #  V]]^abj^klnuv<< + #N3L//# KKQ6R\K]HHHTXXv.  ??Evj?QHHHTXXv.   HHVW] _ rc*|jjd}|j|}|jjdr|jrNdj ||jjd|_|j |j d|S|j dj |jjdd|S|jr5dj |||_|j |j d|S|jr5dj |||_|j |j d|Sdj |||_|j |j d|S) a Verify the distribution status of a software image in Cisco Catalyst Center. Args: self (object): An instance of a class used for interacting with Cisco Catalyst Center. import_type (str): The type of import, either 'url' or 'local'. Returns: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Description: This method verifies the distribution status of a software image in Cisco Catalyst Center. It retrieves the image ID and name from the input and if distribution device ID is provided, it checks the distribution status for that list of specific device and logs the info message based on distribution status. rrzThe requested image '{0}', associated with the device ID '{1}', has been successfully distributed in the Cisco Catalyst Center and its status has been verified.r a Mismatch between the playbook input for distributing the image to the device with ID '{0}' and the actual state in the Cisco Catalyst Center suggests that the distribution task might not have been executed successfully.zThe requested image '{0}', with ID '{1}', has been successfully distributed to all devices within the specified site in the Cisco Catalyst Center.zT"The requested image '{0}', with ID '{1}', has been partially distributed across some devices in the Cisco Catalyst Center.zThe requested image '{0}', with ID '{1}', failed to be distributed across devices in the Cisco Catalyst Center.) rr>rVrr&r#r$rrrrQrHs rverify_diff_distributedz!DnacSwims.verify_diff_distributed&s]99==!8900: 99==1 2..::@&TYY]][sMt:u6*$ !**0&?W1X*Y[ac   2 2;;A6*h;W H HHTXXv &  1 1 &z8 < H HHTXXv &   &z8 < H HHTXXv & rc,|jjd}|j|}|jjdr|jrNdj ||jjd|_|j |j d|S|j dj ||jjdd|S|jr5dj |||_|j |j d|S|jr5dj |||_|j |j d|Sdj |||_|j |j d|S) a Verify the activation status of a software image in Cisco Catalyst Center. Args: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Returns: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Description: This method verifies the activation status of a software image in Cisco Catalyst Center and retrieves the image ID and name from the input. If activation device ID is provided, it checks the activation status for that specific device. Based on activation status a corresponding message is logged. rrzThe requested image '{0}', associated with the device ID '{1}', has been successfully activated in the Cisco Catalyst Center and its status has been verified.r aMismatch between the playbook's input for activating the image '{0}' on the device with ID '{1}' and the actual state in the Cisco Catalyst Center suggests that the activation task might not have been executed successfully.zThe requested image '{0}', with ID '{1}', has been successfully activated on all devices within the specified site in the Cisco Catalyst Center.z"The requested image '{0}', with ID '{1}', has been partially activated on some devices in the Cisco Catalyst Center.zThe activation of the requested image '{0}', with ID '{1}', failed on devices in the Cisco Catalyst Center.) rr>rVr)r&r#r$r'r(r6s rverify_diff_activatedzDnacSwims.verify_diff_activatedOse99==!6700: 99==/ 0,,EEKVJX\XaXaXeXef|X}E~6*$ !**0&TYY]]Ka=b*cekm   0 0//5vj(/K H HHTXXv &  / /))/ H)E H HHTXXv &  ))/ H)E H HHTXXv & rc|j|jdjt|jd|jdjt|j d|j j d}|r|j|j|j j d}|r|jj|j j d}|r|jj|j j d}|r|jj|S)a Verify the merged status(Importing/Tagging/Distributing/Actiavting) the SWIM Image in devices in Cisco Catalyst Center. Args: - self (object): An instance of a class used for interacting with Cisco Catalyst Center. - config (dict): The configuration details to be verified. Return: - self (object): An instance of a class used for interacting with Cisco Catalyst Center. Description: This method checks the merged status of a configuration in Cisco Catalyst Center by retrieving the current state (have) and desired state (want) of the configuration, logs the states, and validates whether the specified SWIM operation performed or not. rr rrrrr) rr$r&r(rrr>r2r/r4r7r9)rr!rtaggedrrs rverify_diff_mergedzDnacSwims.verify_diff_mergedws  ,33C NCVL ,33C NCVLiimmM2   % %k 2 F F H01   # # % 9 9 ;#yy}}-CD   ( ( * > > @!YY]]+?@   & & ( < < > r)N)__name__ __module__ __qualname____doc__rr,r@rSrVrYrarrrrrrrr rr-r0r2r4r7r9r< __classcell__)rs@rr r .sC+1f#&J!F!F>@~ @##Jyv#JIVyv +D4-lxtCJ4B5n'R&P"rr ciddddddddddd d gd d ddd ddddddddddddddddddddddddddddddddddddddddd dd!dd"dd#d$d%d&d'd'gd(}t|d)}t|}|jjd&}||jvr-d*|_d+j ||_|j|jj|jjd}|jD]}|j|j|j|jj|jj|j||j|s|j ||j|j"d-i|j$y,).z+ main entry point for module execution dnac_hostTr()requiredr dnac_port443)rdefault dnac_usernameadminuser)rrGaliases dnac_password)rno_log dnac_verifyboolTrue dnac_versionz2.2.3.3 dnac_debugFdnac_log_levelr^dnac_log_file_pathzdnac.logdnac_log_appenddnac_logvalidate_response_schema config_verifyrintirr!rr)rDrelementsstater )rGchoices) argument_specsupports_check_modeinvalidzState {0} is invalidN)r r r5r>rr"r&r#r/r,r' reset_valuesrrrget_diff_state_applyverify_diff_state_apply exit_jsonr) element_specr dnac_swimsr\rXr!s rmainrhs}KdE!B%E!B#eU[T\%]$et%D"Fv#F  #Uy$I  !6e"D %u&K)5Z*P&4'HE B/D0Q$f%G,e-M.!/L4VT xjI!L&/46F6"J    ! !' *E J///% /66u= &&(335%%))/:M--T!F#779""$88:113. ''.v6JJL  5J . .u 5f = Q Q STF)z(()r__main__) __future__rrrr __metaclass__ __author__ DOCUMENTATIONEXAMPLESRETURN8ansible_collections.cisco.dnac.plugins.module_utils.dnacrrransible.module_utils.basicr rrr rhr=rarrrrso A@ O z v F N 4 5 kk\+.*b zFr