Vh]ddlmZmZmZeZdZdZdZdZ ddl m Z ddl m Z mZmZdd d d d d ZGdde ZdZedk(reyy))absolute_importdivisionprint_functionz?Madhan Sankaranarayanan, Rishita Chowdhary, Abhishek Maheshwaria --- module: site_intent short_description: Resource module for Site operations description: - Manage operation create, update and delete of the resource Sites. - Creates site with area/building/floor with specified hierarchy. - Updates site with area/building/floor with specified hierarchy. - Deletes site with area/building/floor with specified hierarchy. version_added: '6.6.0' extends_documentation_fragment: - cisco.dnac.intent_params author: Madhan Sankaranarayanan (@madhansansel) Rishita Chowdhary (@rishitachowdhary) Abhishek Maheshwari (@abhishekmaheshwari) 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, deleted] default: merged config: description: It represents a list of details for creating/managing/deleting sites, including areas, buildings, and floors. type: list elements: dict required: true suboptions: site_type: description: Type of site to create/update/delete (eg area, building, floor). type: str site: description: Contains details about the site being managed including areas, buildings and floors. type: dict suboptions: area: description: Configuration details for creating or managing an area within a site. type: dict suboptions: name: description: Name of the area to be created or managed (e.g., "Area1"). type: str parent_name: description: The full name of the parent under which the area will be created/managed/deleted (e.g., "Global/USA"). type: str building: description: Configuration details required for creating or managing a building within a site. type: dict suboptions: address: description: Physical address of the building that is to be created or managed. type: str latitude: description: Geographical latitude coordinate of the building. For example, use 37.338 for a location in San Jose, California. Valid values range from -90.0 to +90.0 degrees. type: float longitude: description: Geographical longitude coordinate of the building. For example, use -121.832 for a location in San Jose, California. Valid values range from -180.0 to +180.0 degrees. type: float name: description: Name of the building (e.g., "Building1"). type: str parent_name: description: Hierarchical parent path of the building, indicating its location within the site (e.g., "Global/USA/San Francisco"). type: str floor: description: Configuration details required for creating or managing a floor within a site. type: dict suboptions: height: description: Height of the floor in feet (e.g., 15.23). type: float length: description: Length of the floor in feet (e.g., 100.11). type: float name: description: Name of the floor (e.g., "Floor-1"). type: str parent_name: description: Hierarchical parent path of the floor, indicating its location within the site (e.g., "Global/USA/San Francisco/BGL_18"). type: str rf_model: description: The RF (Radio Frequency) model type for the floor, which is essential for simulating and optimizing wireless network coverage. Select from the following allowed values, which describe different environmental signal propagation characteristics. Type of floor (allowed values are 'Cubes And Walled Offices', 'Drywall Office Only', 'Indoor High Ceiling', 'Outdoor Open Space'). Cubes And Walled Offices - This RF model typically represents indoor areas with cubicles or walled offices, where radio signals may experience attenuation due to walls and obstacles. Drywall Office Only - This RF model indicates an environment with drywall partitions, commonly found in office spaces, which may have moderate signal attenuation. Indoor High Ceiling - This RF model is suitable for indoor spaces with high ceilings, such as auditoriums or atriums, where signal propagation may differ due to the height of the ceiling. Outdoor Open Space - This RF model is used for outdoor areas with open spaces, where signal propagation is less obstructed and may follow different patterns compared to indoor environments. type: str width: description: Width of the floor in feet (e.g., 100.22). type: float floor_number: description: Floor number within the building site (e.g., 5). This value can only be specified during the creation of the floor and cannot be modified afterward. type: int requirements: - dnacentersdk == 2.4.5 - python >= 3.9 notes: - SDK Method used are sites.Sites.create_site, sites.Sites.update_site, sites.Sites.delete_site - Paths used are post /dna/intent/api/v1/site, put dna/intent/api/v1/site/{siteId}, delete dna/intent/api/v1/site/{siteId} a - name: Create a new area site cisco.dnac.site_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: "{{dnac_log}}" state: merged config: - site: area: name: Test parent_name: Global/India site_type: area - name: Create a new building site cisco.dnac.site_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: "{{dnac_log}}" state: merged config: - site: building: name: Building_1 parent_name: Global/India address: Bengaluru, Karnataka, India latitude: 24.12 longitude: 23.45 site_type: building - name: Create a Floor site under the building cisco.dnac.site_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: "{{dnac_log}}" state: merged config: - site: floor: name: Floor_1 parent_name: Global/India/Building_1 length: 75.76 width: 35.54 height: 30.12 rf_model: Cubes And Walled Offices floor_number: 2 site_type: floor - name: Updating the Floor details under the building cisco.dnac.site_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: "{{dnac_log}}" state: merged config: - site: floor: name: Floor_1 parent_name: Global/India/Building_1 length: 75.76 width: 35.54 height: 30.12 site_type: floor - name: Deleting any site you need site name and parent name cisco.dnac.site_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: "{{dnac_log}}" state: deleted config: - site: floor: name: Floor_1 parent_name: Global/India/Building_1 site_type: floor a^ #Case_1: Site is successfully created/updated/deleted response_1: description: A dictionary with API execution details as returned by the Cisco Catalyst Center Python SDK returned: always type: dict sample: > { "response": { "bapiExecutionId": String, "bapiKey": String, "bapiName": String, "endTime": String, "endTimeEpoch": 0, "runtimeInstanceId": String, "siteId": String, "startTime": String, "startTimeEpoch": 0, "status": String, "timeDuration": 0 }, "msg": "string" } #Case_2: Site exits and does not need an update response_2: description: A dictionary with existing site details. returned: always type: dict sample: > { "response": { "site": {}, "siteId": String, "type": String }, "msg": String } #Case_3: Error while creating/updating/deleting site response_3: description: A dictionary with API execution details as returned by the Cisco Catalyst Center Python SDK returned: always type: dict sample: > { "response": { "bapiError": String, "bapiExecutionId": String, "bapiKey": String, "bapiName": String, "endTime": String, "endTimeEpoch": 0, "runtimeInstanceId": String, "startTime": String, "startTimeEpoch": 0, "status": String, "timeDuration": 0 }, "msg": "string" } #Case_4: Site not found when atempting to delete site response_4: description: A list with the response returned by the Cisco Catalyst Center Python returned: always type: list sample: > { "response": [], "msg": String } ) AnsibleModule)DnacBasevalidate_list_of_dictsget_dict_resultzCubes And Walled OfficeszDrywall Office Onlyz Free SpacezIndoor High CeilingzOutdoor Open Space)101101101102101105101104101103ceZdZdZfdZdZdZdZdZdZ ddZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZxZS)DnacSitez9Class containing member attributes for site intent modulect||ddg|_gggc|_|_|_ggc|_|_y)Nmergeddeleted)super__init__supported_statescreated_site_listupdated_site_listupdate_not_neeeded_sitesdeleted_site_listsite_absent_list)selfmodule __class__s j/home/dcms/DCMS/lib/python3.12/site-packages/ansible_collections/cisco/dnac/plugins/modules/site_intent.pyrzDnacSite.__init__OsJ  !)9 5XZ\^`bU 68U8:B5 5c|js,d|_d|_|j|jd|St t ddt dd }|j |j|_|j |j|_t|j|\}}|rJd jd j||_|j|jdd |_|S||_ d jt||_|j|jdd|_|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 (object): An instance of a class used for interacting with Cisco Catalyst Center. 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 the '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', and 'self.msg' will describe the validation issues. successz=Configuration is not available in the playbook for validationERRORFstrrequiredtypeTdictr'sitez#Invalid parameters in playbook: {0} failedz2Successfully validated playbook config params: {0}INFO) configstatusmsglogr(camel_to_snake_caseupdate_site_type_keyrformatjoinvalidated_configr$)r temp_spec valid_tempinvalid_paramss rvalidate_inputzDnacSite.validate_inputUs&{{#DKVDH HHTXXw 'Ku51t&1 ..t{{; // < &< KK& " N <CC .)DH HHTXXw '"DKK *GNNsS]_ 6"  r c di}t|djddd}|jdjd}|dk(rdtt|djd|djd jd |djdzd  }n;|d k(rtt|djd|djd jd |djdzd|jdjd|jdjd|jdjd|jdjd}nV|dk(rPt|djddd}t|djddd}|jdjd}tt|djd|djd jd |djdzdtj||jdjd|jdjd|jdjd|jdjd}t|||djd}|j d j t|d!|S)"a Get the current site information. Parameters: self (object): An instance of a class used for interacting with Cisco Catalyst Center. - site (list): A list containing information about the site. Returns: - dict: A dictionary containing the extracted site information. Description: This method extracts information about the current site based on the provided 'site' list. It determines the type of the site (area, building, or floor) and retrieves specific details accordingly. The resulting dictionary includes the type, site details, and the site ID. radditionalInfo nameSpaceLocation attributesr'areanamesiteNameHierarchy/rA parentName)r@buildingaddresslatitude longitudecountry)rArErGrHrIrJ)rFfloor mapGeometry mapsSummaryrfModelwidthlengthheight floorIndex)rArErf_modelrOrPrQ floorNumber)rKid)r'r*siteIdzCurrent site details: {0}r-)r getr(split floor_planr1r4r$) rr* site_infolocationtypeinfo map_geometry map_summaryrS current_sites rget_current_sitezDnacSite.get_current_sites  "47;;/?#@+zZ<< -11&9 v aV,#Aw{{+>?EEcDQRGKKX^L_F_`abcI #aV,#Aw{{+>?EEcDQRGKKX^L_F_`abc$LL6::9E%\\,7;;JG&ll<8<<[I$LL6::9E  I *47;;7G+H+WdeL)$q'++6F*GVcdK"|488CHaV,#Aw{{+>?EEcDQRGKKX^L_F_`abc'^^H5&**<8<+// : %Ij !#JJv.227;M%))&1+// >'++H5&**73'++H5,00D "Ig  }0=0A0A*0M '"9-  '..s;/?@'J }NUUVcVgVghnVopr{|| }sH I0IIcL|jd}|jdj|jd}|jdj|jd}dj||g}|jdj|d|S)a Get and Return the site name. Parameters: - self (object): An instance of a class used for interacting with Cisco Catalyst Center. - site (dict): A dictionary containing information about the site. Returns: - str: The constructed site name. Description: This method takes a dictionary 'site' containing information about the site and constructs the site name by combining the parent name and site name. r'r*rtrArCzSite name: {0}r-)rWr5r1r4)rr* site_typertrArds r get_site_namezDnacSite.get_site_name9sHHV$ hhv&**9599-H xx##I.226:HHk401  !((3V<r cXtt||tt||k(S)a| Compare two floating-point values with a specified precision. Args: - self (object): An instance of a class used for interacting with Cisco Catalyst Center. - ele1 (float): The first floating-point value to be compared. - ele2 (float): The second floating-point value to be compared. - precision (int, optional): The number of decimal places to consider in the comparison, Defaults to 2. Return: bool: True if the rounded values are equal within the specified precision, False otherwise. Description: This method compares two floating-point values, ele1 and ele2, by rounding them to the specified precision and checking if the rounded values are equal. It returns True if the rounded values are equal within the specified precision, and False otherwise. )roundfloat)rele1ele2 precisions rcompare_float_valueszDnacSite.compare_float_valuesOs% U4[),eDk90MMMr c2|d|dk(xr |d|dk(S)a Check if the area site details have been updated. Args: - self (object): An instance of a class used for interacting with Cisco Catalyst Center. - updated_site (dict): The site details after the update. - requested_site (dict): The site details as requested for the update. Return: bool: True if the area details (name and parent name) have been updated, False otherwise. Description: This method compares the area details (name and parent name) of the updated site with the requested site and returns True if they are equal, indicating that the area details have been updated. Returns False if there is a mismatch in the area site details. rArEr updated_siterequested_sites ris_area_updatedzDnacSite.is_area_updatedas3  N6$: : G  &.*F F r c|d|dk(xrg|d|dk(xrZ|j|d|dxr@|j|d|dxr&d|vxr |dduxs|jd|dk(S)a% Check if the building details in a site have been updated. Args: - self (object): An instance of a class used for interacting with Cisco Catalyst Center. - updated_site (dict): The site details after the update. - requested_site (dict): The site details as requested for the update. Return: bool: True if the building details have been updated, False otherwise. Description: This method compares the building details of the updated site with the requested site. It checks if the name, parent_name, latitude, longitude, and address (if provided) are equal, indicating that the building details have been updated. Returns True if the details match, and False otherwise. rArErHrIrGN)rrWrs ris_building_updatedzDnacSite.is_building_updatedus"  N6$: : N  &.*F F N  % %l:&>z@Z [ N  % %l;&?P[A\ ] N. (MnY.G4.O/LS_ScScdmSnsABKsLTL  r cgd}|d|dk7s#|jd|jdk7ry|D]}|j||||ryy)a Check if the floor details in a site have been updated. Args: - self (object): An instance of a class used for interacting with Cisco Catalyst Center. - updated_site (dict): The site details after the update. - requested_site (dict): The site details as requested for the update. Return: bool: True if the floor details have been updated, False otherwise. Description: This method compares the floor details of the updated site with the requested site. It checks if the name, rf_model, length, width, and height are equal, indicating that the floor details have been updated. Returns True if the details match, and False otherwise. )rPrOrQrArSrNFT)rWr)rrrkeys_to_comparekeys ris_floor_updatedzDnacSite.is_floor_updatedsn 8  > 9\=M=Mj=Y]k]o]opy]z=z" C,,\#->s@ST r c|jdd}|jdd|}|jdd|}|jdjt |d|jdjt |d|dk(r|j || S|d k(r|j || S|j|| S) aF Check if the site requires updates. Parameters: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Returns: bool: True if the site requires updates, False otherwise. Description: This method compares the site parameters of the current site ('current_site') and the requested site parameters ('requested_site') stored in the 'want' attribute. It checks for differences in specified parameters, such as the site type and site details. r_r'r*r{zCurrent Site type: {0}r-zRequested Site type: {0}rFrK)haveror1r4r$rrr)rr'rrs rsite_requires_updatezDnacSite.site_requires_updatesyy(0yy08> =1&9$? )00\1BCVL +223~3FGP : // nMM M W_,,\>JJ J'' nEEEr cBd}d}i}|j\}}|jdjt|d|r|j d|d<||d<||d<||_|jd jt|j d |S) a Get the site details from Cisco Catalyst Center Parameters: - self (object): An instance of a class used for interacting with Cisco Catalyst Center. - config (dict): A dictionary containing the configuration details. Returns: - self (object): An instance of a class used for interacting with Cisco Catalyst Center. Description: This method queries Cisco Catalyst Center to check if a specified site exists. If the site exists, it retrieves details about the current site, including the site ID and other relevant information. The results are stored in the 'have' attribute for later reference. FNz Current Site details (have): {0}rlrVsite_idrqr_Current State (have): {0}r-)rqr1r4r$rWr)rr.rqr_rs rget_havezDnacSite.get_haves  '+&6&6&8#l 3::3|;LMwW *..x8DO"-D #/D   ,33C NCVL r ci}t|j||j|}||_|j dj t |jd|S)a  Get all site-related information from the playbook needed for creation/updation/deletion of site in Cisco Catalyst Center. Parameters: self (object): An instance of a class used for interacting with Cisco Catalyst Center. config (dict): A dictionary containing configuration information. Returns: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Description: Retrieves all site-related information from playbook that is required for creating a site in Cisco Catalyst Center. It includes parameters such as 'site_params' and 'site_name.' The gathered information is stored in the 'want' attribute for later reference. )r{rdDesired State (want): {0}r-)r(r|rror1r4r$)rr.ros rget_wantzDnacSite.get_wants_,,V4((0   ,33C NCVL r cNd}d}|jjd}|jjdr|jr|jjd}|jjd|d<|jj ddd| }|j d jt|d d}n|jj||j d j|d |S|jjd} |ddr0i}|ddjD] \}} |  | ||<||dd<|jj ddd| }|j djt|d d}|s|r+|r(t|tr|jd} |j| }|jddk(rd|j d<n?|jdr-|j"j%|jd|nt|r>|j&j||j dj|d |S|j)\}}|r<|j*j||j dj|d |S#t$r<} |d} |d| d} |j dj| d Yd} ~ d} ~ wwxYw)a Update/Create site information in Cisco Catalyst Center with fields provided in the playbook. Parameters: self (object): An instance of a class used for interacting with Cisco Catalyst Center. config (dict): A dictionary containing configuration information. Returns: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Description: This method determines whether to update or create a site in Cisco Catalyst Center based on the provided configuration information. If the specified site exists, the method checks if it requires an update by calling the 'site_requires_update' method. If an update is required, it calls the 'update_site' function from the 'sites' family of the Cisco Catalyst Center API. If the site does not require an update, the method exits, indicating that the site is up to date. Frdrqr{rrb update_siteTrez-Received API response from 'update_site': {0}rlz#Site - {0} does not need any updater-r*rFNr'rAzThe site '{0}' is not categorized as a building; hence, there is no need to filter out 'None' values from the 'site_params' dictionary. create_sitez-Received API response from 'create_site': {0} executionIdr/SUCCESSchanged bapiErrorr0rkzSite - {0} Updated SuccessfullyzSite '{0}' created successfully)rorWrrrmrnr1r4r$rappenditemsrp isinstancer(get_execution_detailsresultr fail_jsonrrqr)rr. site_updated site_createdrdr{rkryrvaluerrr~rA executionidexecution_detailsrqr_s rget_diff_mergedzDnacSite.get_diff_mergeds!"  IIMM+.  99== '((*"iimmM: )-y)A I&99??"* $& + HOOPST\P]^`gh# --44Y?>EEiPRXY ))-- 6K _v&z2')$&1&&9*&E&K&K&M: U ,49,S1:7GK' 3yy& " 'H HHDKKCPXMZ\c dL <Jx6&ll=9 (,(B(B;(O%(,,X6)C15 I.*..{; --2C2G2G 2T7H.J **11)<HH>EEiPRXY 372B2B2D/[,"..55i@!B!I!I)!TV\] Q _'/ "6*95f=IIOPTW]__ _s*(KK L$(1LL$cV |jjdddd|i}|r)t|tr|j dj t |d|jd} |j|}|jd d k(rFd |_ |jj||j d j |d  |S|jdr_|j dj |jdd|jj|jd| |S|S#t$rN}d|_ dj |t ||_|j |jdYd}~|Sd}~wwxYw)a;" Delete a single site in the Cisco Catalyst Center. Parameters: self (object): An instance of a class used for interacting with Cisco Catalyst Center. site_id (str): The ID of the site to be deleted. site_name (str): The name of the site to be deleted. Returns: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Description: This function initiates the deletion of a site in the Cisco Catalyst Center by calling the delete API. If the deletion is successful, the result is marked as changed, and the status is set to "success." If an error occurs during the deletion process, the status is set to "failed," and the log contains details about the error. rb delete_siteTrrez-Received API response from 'delete_site': {0}rlrr/rr"zSite '{0}' deleted successfullyr-rz/Error response for 'delete_site' execution: {0}r#rr,z8Exception occurred while deleting site '{0}' due to: {1}N)rmrnrr(r1r4r$rWrr/rrrrrpr0)rrrdrkrrrrs rdelete_single_sitezDnacSite.delete_single_site]s  (yy& !7+ 'HJx6HOOPST\P]^`gh&ll=9 (,(B(B;(O%(,,X6)C&/ ..55i@!B!I!I)!TV\] +..{;!R!Y!YZkZoZop{Z|!}@GH --2C2G2G 2T_p-q #"  ("DKQXXYbdghidjkDH HHTXXw ' '  (s&CEA-EE F(AF##F(ch|jjd}|jjd}|sEd|_|jj ||j dj|d|S|jjd}|jjddd d|i }|j d jt|d |jd jd}|j dj|t|d t|dk(r|j|||St|dd }|D]}|j|d|d|j|||j dj|d|S)a Call Cisco Catalyst Center API to delete sites with provided inputs. Parameters: - self (object): An instance of a class used for interacting with Cisco Catalyst Center. - config (dict): Dictionary containing information for site deletion. Returns: - self: The result dictionary includes the following keys: - 'changed' (bool): Indicates whether changes were made during the deletion process. - 'response' (dict): Contains details about the execution and the deleted site ID. - 'msg' (str): A message indicating the status of the deletion operation. Description: This method initiates the deletion of a site by calling the 'delete_site' function in the 'sites' family of the Cisco Catalyst Center API. It uses the site ID obtained from the 'have' attribute. rqrdr"zFUnable to delete site '{0}' as it's not found in Cisco Catalyst Centerr-rrbget_membershipTrez0Received API response from 'get_membership': {0}rlr*rkz2Site {0} response along with it's child sites: {1}rc$|jdS)NgroupHierarchy)rW)xs rz+DnacSite.get_diff_deleted..squuEU?Vr )rreverserUrAzAThe site '{0}' and its child sites have been deleted successfully)rrWror/rrr1r4rmrnr$lenrsorted) rr.rqrdr mem_response site_responsesorted_site_respitems rget_diff_deletedzDnacSite.get_diff_deleteds$iimmM2 IIMM+. #DK  ! ! ( ( 3 HH]ddenoqw xK))-- *yy%w' ' CJJ3|K\]_fg$((044Z@  ELLYX[\iXjkmtu }  "  # #GY 7K"-5V`de% >D  # #DJV = > 3 T[[\efhno r c|j||jdjt|jd|jdjt|j d|jj d}|j j d}|r9d|_dj||_|j|jd|j}|s*|jdj|dd|_|S|jd j|d|S) a Verify the merged status(Creation/Updation) of site configuration 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 site exists in the Catalyst Center configuration. rr-rrqrdr"zdThe requested site '{0}' is present in the Cisco Catalyst Center and its creation has been verified.z9The update for site '{0}' has been successfully verified.zThe playbook input for site '{0}' does not align with the Cisco Catalyst Center, indicating that the merge task may not have executed successfully.) rr1r4r$rrorWr/r0r)rr. site_existrdrequire_updates rverify_diff_mergedzDnacSite.verify_diff_mergeds f ,33C NCVL ,33C NCVLYY]]=1 IIMM+. #DK}EEFOPDH HHTXXv &224 HHPWWXabdj k$DLK 88>y8I6 S r c0|j||jdjt|jd|jdjt|j d|jj d}|sEd|_dj|j j d}|j|d|S|jdj|j j dd|S) aa Verify the deletion status of site configuration 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 deletion status of a configuration in Cisco Catalyst Center. It validates whether the specified site exists in the Catalyst Center configuration. rr-rrqr"zThe requested site '{0}' has already been deleted from the Cisco Catalyst Center and this has been successfully verified.rdzMismatch between the playbook input for site '{0}' and the Cisco Catalyst Center indicates that the deletion was not executed successfully.)rr1r4r$rrorWr/)rr.rr0s rverify_diff_deletedzDnacSite.verify_diff_deleteds f ,33C NCVL ,33C NCVLYY]]=1 #DK**0&{1K*L  HHS& !K @@Ftyy}}U`Ga@bdj l r c|jr|jrd|jd<|jrUd}|j t |jt |jt |j|_ndj t |jt |j|_nI|jrd|jd<|jr?dj t |jt |j|_ndj t |j|_n|jrd|jd<|jr?dj t |jt |j|_nRdj t |j|_n'|jr9d |jd<d j t |j|_n|jrY|jrMd|jd<d j t |jt |j|_n}|jr9d|jd<d j t |j|_n8d |jd<d j t |j|_d|_ |j |jd<|j |jd<|S)a4 Update site messages based on the status of created, updated, and deleted sites. Args: self (object): An instance of a class used for interacting with Cisco Catalyst Center. Returns: self (object): An instance of a class representing the status of the operation, including whether it was successful or failed, any error messages encountered during operation. Description: This method updates the messages related to site creation, updating, and deletion in the Cisco Catalyst Center. It evaluates the status of created sites, updated sites, and sites that are no longer needed for update to determine the appropriate message to be set. The messages are then stored in the 'msg' attribute of the object. TrzSite(s) '{0}' created successfully as well as Site(s) '{1}' updated successully and the some site(s) '{2}' needs no update in Cisco Catalyst CenterzSite(s) '{0}' created successfully in Cisco Catalyst Center as well as Site(s) '{1}' updated successully in Cisco Catalyst CenterzSite(s) '{0}' created successfully and some site(s) '{1}' not needs any update in Cisco Catalyst Center.z7r rciddddddddddd d gd d ddd ddddddddddddddddddddddddddddddddddddddddd dd!dd"dd#d$d%d&d'd'd(gd)}t|d*}t|}|jjd&}||jvr-d+|_d,j ||_|j|jj|jjd}|jD]}|j|j|j|j|j|j||j|sw|j||j|j!j|j"d.i|j$y-)/z+ main entry point for module execution dnac_hostTr$r% dnac_port443)r'default dnac_usernameadminuser)r'raliases dnac_password)r'no_log dnac_verifyboolTrue dnac_versionz2.2.3.3 dnac_debugFdnac_log_levelrjdnac_log_file_pathzdnac.logdnac_log_appenddnac_logvalidate_response_schema config_verifydnac_api_task_timeoutintidnac_task_poll_intervalrr.listr()r&r'elementsstaterr)rchoices) argument_specsupports_check_modeinvalidzState {0} is invalidNr)rrrirWrr/r4r0rwr:r6 reset_valuesrrget_diff_state_applyverify_diff_state_applyr exit_jsonr) element_specr dnac_siterrr.s rmainrDsKdE!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 x>ST!L&/46F I     )E I...$ .55e< %%' 224$$((9M,,S 6"6686"668- &&u-f5IIK  4I - -e 4V < P P R S""$88:F(y''(r __main__N) __future__rrrr' __metaclass__ __author__ DOCUMENTATIONEXAMPLESRETURNansible.module_utils.basicr8ansible_collections.cisco.dnac.plugins.module_utils.dnacrrr rYrrrrr rrs A@ O B Ff NH T5)##"  u xu p0)f zFr