Server IP : 85.214.239.14 / Your IP : 3.135.202.252 Web Server : Apache/2.4.62 (Debian) System : Linux h2886529.stratoserver.net 4.9.0 #1 SMP Tue Jan 9 19:45:01 MSK 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.18 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : OFF | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /usr/lib/python3/dist-packages/ansible_collections/cisco/dnac/plugins/action/ |
Upload File : |
#!/usr/bin/env python # -*- coding: utf-8 -*- # Copyright (c) 2021, Cisco Systems # GNU General Public License v3.0+ (see LICENSE or https://www.gnu.org/licenses/gpl-3.0.txt) from __future__ import (absolute_import, division, print_function) __metaclass__ = type from ansible.plugins.action import ActionBase try: from ansible_collections.ansible.utils.plugins.module_utils.common.argspec_validate import ( AnsibleArgSpecValidator, ) except ImportError: ANSIBLE_UTILS_IS_INSTALLED = False else: ANSIBLE_UTILS_IS_INSTALLED = True from ansible.errors import AnsibleActionFail from ansible_collections.cisco.dnac.plugins.plugin_utils.dnac import ( DNACSDK, dnac_argument_spec, dnac_compare_equality, get_dict_result, ) from ansible_collections.cisco.dnac.plugins.plugin_utils.exceptions import ( InconsistentParameters, ) # Get common arguments specification argument_spec = dnac_argument_spec() # Add arguments specific for this module argument_spec.update(dict( state=dict(type="str", default="present", choices=["present", "absent"]), tags=dict(type="list"), author=dict(type="str"), composite=dict(type="bool"), containingTemplates=dict(type="list"), createTime=dict(type="int"), customParamsOrder=dict(type="bool"), description=dict(type="str"), deviceTypes=dict(type="list"), failurePolicy=dict(type="str"), id=dict(type="str"), language=dict(type="str"), lastUpdateTime=dict(type="int"), latestVersionTime=dict(type="int"), name=dict(type="str"), parentTemplateId=dict(type="str"), projectId=dict(type="str"), projectName=dict(type="str"), rollbackTemplateContent=dict(type="str"), rollbackTemplateParams=dict(type="list"), softwareType=dict(type="str"), softwareVariant=dict(type="str"), softwareVersion=dict(type="str"), templateContent=dict(type="str"), templateParams=dict(type="list"), validationErrors=dict(type="dict"), version=dict(type="str"), templateId=dict(type="str"), )) required_if = [ ("state", "present", ["name", "templateId"], True), ("state", "absent", ["name", "templateId"], True), ] required_one_of = [] mutually_exclusive = [] required_together = [] class ConfigurationTemplate(object): def __init__(self, params, dnac): self.dnac = dnac self.new_object = dict( tags=params.get("tags"), author=params.get("author"), composite=params.get("composite"), containingTemplates=params.get("containingTemplates"), createTime=params.get("createTime"), customParamsOrder=params.get("customParamsOrder"), description=params.get("description"), deviceTypes=params.get("deviceTypes"), failurePolicy=params.get("failurePolicy"), id=params.get("id"), language=params.get("language"), lastUpdateTime=params.get("lastUpdateTime"), latestVersionTime=params.get("latestVersionTime"), name=params.get("name"), parentTemplateId=params.get("parentTemplateId"), projectId=params.get("projectId"), projectName=params.get("projectName"), rollbackTemplateContent=params.get("rollbackTemplateContent"), rollbackTemplateParams=params.get("rollbackTemplateParams"), softwareType=params.get("softwareType"), softwareVariant=params.get("softwareVariant"), softwareVersion=params.get("softwareVersion"), templateContent=params.get("templateContent"), templateParams=params.get("templateParams"), validationErrors=params.get("validationErrors"), version=params.get("version"), template_id=params.get("templateId"), ) def get_all_params(self, name=None, id=None): new_object_params = {} new_object_params['project_id'] = self.new_object.get('projectId') or \ self.new_object.get('project_id') new_object_params['software_type'] = self.new_object.get('softwareType') or \ self.new_object.get('software_type') new_object_params['software_version'] = self.new_object.get('softwareVersion') or \ self.new_object.get('software_version') new_object_params['product_family'] = self.new_object.get('productFamily') or \ self.new_object.get('product_family') new_object_params['product_series'] = self.new_object.get('productSeries') or \ self.new_object.get('product_series') new_object_params['product_type'] = self.new_object.get('productType') or \ self.new_object.get('product_type') new_object_params['filter_conflicting_templates'] = self.new_object.get('filterConflictingTemplates') or \ self.new_object.get('filter_conflicting_templates') new_object_params['tags'] = self.new_object.get('tags') new_object_params['project_names'] = self.new_object.get('projectName') or self.new_object.get('projectNames') or \ self.new_object.get('project_names') new_object_params['un_committed'] = self.new_object.get('unCommitted') or \ self.new_object.get('un_committed') new_object_params['sort_order'] = self.new_object.get('sortOrder') or \ self.new_object.get('sort_order') return new_object_params def delete_by_id_params(self): new_object_params = {} new_object_params['template_id'] = self.new_object.get('template_id') return new_object_params def update_all_params(self): new_object_params = {} new_object_params['tags'] = self.new_object.get('tags') new_object_params['author'] = self.new_object.get('author') new_object_params['composite'] = self.new_object.get('composite') new_object_params['containingTemplates'] = self.new_object.get('containingTemplates') new_object_params['createTime'] = self.new_object.get('createTime') new_object_params['customParamsOrder'] = self.new_object.get('customParamsOrder') new_object_params['description'] = self.new_object.get('description') new_object_params['deviceTypes'] = self.new_object.get('deviceTypes') new_object_params['failurePolicy'] = self.new_object.get('failurePolicy') new_object_params['id'] = self.new_object.get('id') new_object_params['language'] = self.new_object.get('language') new_object_params['lastUpdateTime'] = self.new_object.get('lastUpdateTime') new_object_params['latestVersionTime'] = self.new_object.get('latestVersionTime') new_object_params['name'] = self.new_object.get('name') new_object_params['parentTemplateId'] = self.new_object.get('parentTemplateId') new_object_params['projectId'] = self.new_object.get('projectId') new_object_params['projectName'] = self.new_object.get('projectName') new_object_params['rollbackTemplateContent'] = self.new_object.get('rollbackTemplateContent') new_object_params['rollbackTemplateParams'] = self.new_object.get('rollbackTemplateParams') new_object_params['softwareType'] = self.new_object.get('softwareType') new_object_params['softwareVariant'] = self.new_object.get('softwareVariant') new_object_params['softwareVersion'] = self.new_object.get('softwareVersion') new_object_params['templateContent'] = self.new_object.get('templateContent') new_object_params['templateParams'] = self.new_object.get('templateParams') new_object_params['validationErrors'] = self.new_object.get('validationErrors') new_object_params['version'] = self.new_object.get('version') return new_object_params def get_object_by_name(self, name): result = None # NOTE: Does not have a get by name method, using get all try: items = self.dnac.exec( family="configuration_templates", function="gets_the_templates_available", params=self.get_all_params(name=name), ) if isinstance(items, dict): if 'response' in items: items = items.get('response') result = get_dict_result(items, 'name', name) except Exception: result = None return result def get_object_by_id(self, id): result = None try: items = self.dnac.exec( family="configuration_templates", function="get_template_details", params={"template_id": id} ) if isinstance(items, dict): if 'response' in items: items = items.get('response') result = get_dict_result(items, 'id', id) except Exception: result = None return result def exists(self): prev_obj = None id_exists = False name_exists = False o_id = self.new_object.get("id") o_id = o_id or self.new_object.get("template_id") name = self.new_object.get("name") if o_id: prev_obj = self.get_object_by_id(o_id) id_exists = prev_obj is not None and isinstance(prev_obj, dict) if not id_exists and name: prev_obj = self.get_object_by_name(name) name_exists = prev_obj is not None and isinstance(prev_obj, dict) if name_exists: _id = prev_obj.get("id") _id = _id or prev_obj.get("templateId") if id_exists and name_exists and o_id != _id: raise InconsistentParameters("The 'id' and 'name' params don't refer to the same object") if _id: self.new_object.update(dict(id=_id)) self.new_object.update(dict(template_id=_id)) if _id: prev_obj = self.get_object_by_id(_id) it_exists = prev_obj is not None and isinstance(prev_obj, dict) return (it_exists, prev_obj) def requires_update(self, current_obj): requested_obj = self.new_object obj_params = [ ("tags", "tags"), ("author", "author"), ("composite", "composite"), ("containingTemplates", "containingTemplates"), ("createTime", "createTime"), ("customParamsOrder", "customParamsOrder"), ("description", "description"), ("deviceTypes", "deviceTypes"), ("failurePolicy", "failurePolicy"), ("id", "id"), ("language", "language"), ("lastUpdateTime", "lastUpdateTime"), ("latestVersionTime", "latestVersionTime"), ("name", "name"), ("parentTemplateId", "parentTemplateId"), ("projectId", "projectId"), ("projectName", "projectName"), ("rollbackTemplateContent", "rollbackTemplateContent"), ("rollbackTemplateParams", "rollbackTemplateParams"), ("softwareType", "softwareType"), ("softwareVariant", "softwareVariant"), ("softwareVersion", "softwareVersion"), ("templateContent", "templateContent"), ("templateParams", "templateParams"), ("validationErrors", "validationErrors"), ("version", "version"), ("templateId", "template_id"), ] # Method 1. Params present in request (Ansible) obj are the same as the current (ISE) params # If any does not have eq params, it requires update return any(not dnac_compare_equality(current_obj.get(dnac_param), requested_obj.get(ansible_param)) for (dnac_param, ansible_param) in obj_params) def update(self): id = self.new_object.get("id") name = self.new_object.get("name") result = None result = self.dnac.exec( family="configuration_templates", function="update_template", params=self.update_all_params(), op_modifies=True, ) return result def delete(self): id = self.new_object.get("id") id = id or self.new_object.get("template_id") name = self.new_object.get("name") result = None if not id: prev_obj_name = self.get_object_by_name(name) id_ = None if prev_obj_name: id_ = prev_obj_name.get("id") id_ = id_ or prev_obj_name.get("templateId") if id_: self.new_object.update(dict(template_id=id_)) result = self.dnac.exec( family="configuration_templates", function="deletes_the_template", params=self.delete_by_id_params(), ) return result class ActionModule(ActionBase): def __init__(self, *args, **kwargs): if not ANSIBLE_UTILS_IS_INSTALLED: raise AnsibleActionFail("ansible.utils is not installed. Execute 'ansible-galaxy collection install ansible.utils'") super(ActionModule, self).__init__(*args, **kwargs) self._supports_async = False self._supports_check_mode = False self._result = None # Checks the supplied parameters against the argument spec for this module def _check_argspec(self): aav = AnsibleArgSpecValidator( data=self._task.args, schema=dict(argument_spec=argument_spec), schema_format="argspec", schema_conditionals=dict( required_if=required_if, required_one_of=required_one_of, mutually_exclusive=mutually_exclusive, required_together=required_together, ), name=self._task.action, ) valid, errors, self._task.args = aav.validate() if not valid: raise AnsibleActionFail(errors) def run(self, tmp=None, task_vars=None): self._task.diff = False self._result = super(ActionModule, self).run(tmp, task_vars) self._result["changed"] = False self._check_argspec() dnac = DNACSDK(self._task.args) obj = ConfigurationTemplate(self._task.args, dnac) state = self._task.args.get("state") response = None if state == "present": (obj_exists, prev_obj) = obj.exists() if obj_exists: if obj.requires_update(prev_obj): response = obj.update() dnac.object_updated() else: response = prev_obj dnac.object_already_present() else: dnac.fail_json("Object does not exists, plugin only has update") elif state == "absent": (obj_exists, prev_obj) = obj.exists() if obj_exists: response = obj.delete() dnac.object_deleted() else: dnac.object_already_absent() self._result.update(dict(dnac_response=response)) self._result.update(dnac.exit_json()) return self._result