Merge pull request #171 from cisco-en-programmability/develop

Develop

README.md

@@ -19,7 +19,7 @@ The following table shows the supported versions.
 | 2.2.3.3                  | 6.4.0                        |  2.4.11                       |
 | 2.3.3.0                  | 6.6.4                        |  2.5.5                        |
 | 2.3.5.3                  | 6.13.3                       |  2.6.11                       |
-| 2.3.7.6                  | ^6.14.0                      |  ^2.7.1                       |
+| 2.3.7.6                  | ^6.15.0                      |  ^2.7.1                       |
 
 If your Ansible collection is older please consider updating it first.
 

changelogs/changelog.yaml

@@ -909,3 +909,9 @@ releases:
           - network_device_user_defined_field_delete - new module
           - users_external_authentication - new module
           - users_external_servers_aaa_attribute - new module
+  6.15.0:
+      release_date: "2024-06-03"
+      changes:
+        release_summary: Fix module name.
+        minor_changes:
+          - Fix module name from network_device_config__info to configuration_archive_details_info.

galaxy.yml

@@ -1,7 +1,7 @@
 ---
 namespace: cisco
 name: dnac
-version: 6.14.0
+version: 6.15.0
 readme: README.md
 authors:
   - Rafael Campos <rcampos@altus.cr>

plugins/action/configuration_archive_details_info.py

@@ -0,0 +1,99 @@
+#!/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,
+)
+
+# Get common arguments specification
+argument_spec = dnac_argument_spec()
+# Add arguments specific for this module
+argument_spec.update(dict(
+    deviceId=dict(type="str"),
+    fileType=dict(type="str"),
+    createdTime=dict(type="str"),
+    createdBy=dict(type="str"),
+    offset=dict(type="float"),
+    limit=dict(type="float"),
+    headers=dict(type="dict"),
+))
+
+required_if = []
+required_one_of = []
+mutually_exclusive = []
+required_together = []
+
+
+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 = True
+        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 get_object(self, params):
+        new_object = dict(
+            device_id=params.get("deviceId"),
+            file_type=params.get("fileType"),
+            created_time=params.get("createdTime"),
+            created_by=params.get("createdBy"),
+            offset=params.get("offset"),
+            limit=params.get("limit"),
+            headers=params.get("headers"),
+        )
+        return new_object
+
+    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()
+
+        self._result.update(dict(dnac_response={}))
+
+        dnac = DNACSDK(params=self._task.args)
+
+        response = dnac.exec(
+            family="configuration_archive",
+            function='get_configuration_archive_details',
+            params=self.get_object(self._task.args),
+        )
+        self._result.update(dict(dnac_response=response))
+        self._result.update(dnac.exit_json())
+        return self._result

plugins/modules/accesspoint_configuration_details_by_task_id_info.py

@@ -24,7 +24,7 @@
     - Task_id path parameter. Task id information of ap config.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Wireless GetAccessPointConfigurationTaskResult

plugins/modules/app_policy_default_info.py

@@ -20,7 +20,7 @@
     description: Additional headers.
     type: dict
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationPolicyDefault

plugins/modules/app_policy_info.py

@@ -24,7 +24,7 @@
     - PolicyScope query parameter. Policy scope name.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationPolicy

plugins/modules/app_policy_intent_create.py

@@ -228,7 +228,7 @@
         type: dict
     type: list
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy ApplicationPolicyIntent

plugins/modules/app_policy_queuing_profile.py

@@ -89,7 +89,7 @@
         type: str
     type: list
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy CreateApplicationPolicyQueuingProfile

plugins/modules/app_policy_queuing_profile_count_info.py

@@ -20,7 +20,7 @@
     description: Additional headers.
     type: dict
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationPolicyQueuingProfileCount

plugins/modules/app_policy_queuing_profile_info.py

@@ -24,7 +24,7 @@
     - Name query parameter. Queuing profile name.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationPolicyQueuingProfile

plugins/modules/application_policy_application_set.py

@@ -48,7 +48,7 @@
         type: str
     type: list
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy CreateApplicationSets

plugins/modules/application_policy_application_set_count_info.py

@@ -24,7 +24,7 @@
     - ScalableGroupType query parameter. Scalable group type to retrieve, valid value APPLICATION_GROUP.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationSetCount

plugins/modules/application_policy_application_set_info.py

@@ -38,7 +38,7 @@
       results, max value 500.
     type: float
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationSets2

plugins/modules/application_sets.py

@@ -29,7 +29,7 @@
         type: str
     type: list
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy CreateApplicationSet

plugins/modules/application_sets_count_info.py

@@ -20,7 +20,7 @@
     description: Additional headers.
     type: dict
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationSetsCount

plugins/modules/application_sets_info.py

@@ -32,7 +32,7 @@
     - Name query parameter.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationSets

plugins/modules/applications.py

@@ -110,7 +110,7 @@
         type: list
     type: list
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy CreateApplication

plugins/modules/applications_count_info.py

@@ -20,7 +20,7 @@
     description: Additional headers.
     type: dict
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationsCount

plugins/modules/applications_count_v2_info.py

@@ -24,7 +24,7 @@
     - ScalableGroupType query parameter. Scalable group type to retrieve, valid value APPLICATION.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationCount

plugins/modules/applications_health_info.py

@@ -64,7 +64,7 @@
     - ApplicationName query parameter. The name of the application to get information on.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Applications Applications

plugins/modules/applications_info.py

@@ -32,7 +32,7 @@
     - Name query parameter. Application's name.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplications2

plugins/modules/applications_v2.py

@@ -180,7 +180,7 @@
         type: str
     type: list
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy CreateApplications

plugins/modules/applications_v2_info.py

@@ -38,7 +38,7 @@
       results, max value 500.
     type: float
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplications

plugins/modules/assign_device_to_site.py

@@ -32,7 +32,7 @@
     description: SiteId path parameter. Site Id where device(s) needs to be assigned.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Sites AssignDevicesToSite

plugins/modules/associate_site_to_network_profile.py

@@ -23,7 +23,7 @@
     description: SiteId path parameter. Site Id to be associated.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Site Design Associate

plugins/modules/auth_token_create.py

@@ -19,7 +19,7 @@
 author: Rafael Campos (@racampos)
 options: {}
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Authentication AuthenticationAPI

plugins/modules/authentication_import_certificate.py

@@ -30,7 +30,7 @@
     description: PkPassword query parameter. Private Key Passsword.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Authentication Management ImportCertificate

plugins/modules/authentication_import_certificate_p12.py

@@ -30,7 +30,7 @@
     description: PkPassword query parameter. Private Key Passsword.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Authentication Management ImportCertificateP12

plugins/modules/authentication_policy_servers.py

@@ -126,7 +126,7 @@
     description: Value true to use DNAC certificate for Pxgrid. Default value is false.
     type: bool
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for System Settings AddAuthenticationAndPolicyServerAccessConfiguration

plugins/modules/authentication_policy_servers_info.py

@@ -32,7 +32,7 @@
     - Role query parameter. Authentication and Policy Server Role (Example primary, secondary).
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for System Settings GetAuthenticationAndPolicyServers

plugins/modules/buildings_planned_access_points_info.py

@@ -36,7 +36,7 @@
     - Radios query parameter. Inlcude planned radio details.
     type: bool
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Devices GetPlannedAccessPointsForBuilding

plugins/modules/business_sda_hostonboarding_ssid_ippool.py

@@ -35,7 +35,7 @@
     description: VLAN Name.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Fabric Wireless AddSSIDToIPPoolMapping

plugins/modules/business_sda_hostonboarding_ssid_ippool_info.py

@@ -28,7 +28,7 @@
     - SiteNameHierarchy query parameter. Site Name Heirarchy.
     type: str
 requirements:
-- dnacentersdk >= 2.4.9
+- dnacentersdk >= 2.7.1
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Fabric Wireless GetSSIDToIPPoolMapping