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

Develop v6.5.3
cisco-en-programmability · Aug 12, 2022 · 76d1dd4 · 76d1dd4
2 parents 2b95fc8 + a8d6a9e
commit 76d1dd4
Show file tree

Hide file tree

Showing 342 changed files with 405 additions and 350 deletions.
diff --git a/README.md b/README.md
@@ -17,7 +17,7 @@ Other versions of this collection have support for previous Cisco DNA Center ver
 | 2.1.1                    | 3.0.0                        | 2.2.5                         |
 | 2.2.2.3                  | 3.3.1                        | 2.3.3                         |
 | 2.2.3.3                  | 6.4.0                        | 2.4.11                        |
-| 2.3.3.0                  | 6.5.2                        | 2.5.0                         |
+| 2.3.3.0                  | 6.5.3                        | 2.5.4                         |
 
 *Notes*:
 

diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml
@@ -583,4 +583,12 @@ releases:
         - sda_fabric_border_device - delete function fixed.
         - sda_fabric_control_plane_device - delete function fixed.
         - sda_fabric_edge_device - delete function fixed.
-        - sda_virtual_network - delete function fixed.
+        - sda_virtual_network - delete function fixed.
+  6.5.3:
+    release_date: "2022-08-12"
+    changes:
+      release_summary: Added new function and fixed module
+      bugfixes:
+        - Update dnacentersdk requirement from 2.5.0 to 2.5.4
+        - business_sda_hostonboarding_ssid_ippool - create function added.
+        - wireless_profile - create function fixed.
diff --git a/galaxy.yml b/galaxy.yml
@@ -1,7 +1,7 @@
 ---
 namespace: cisco
 name: dnac
-version: 6.5.2
+version: 6.5.3
 readme: README.md
 authors:
   - Rafael Campos <rcampos@altus.cr>

diff --git a/plugins/action/business_sda_hostonboarding_ssid_ippool.py b/plugins/action/business_sda_hostonboarding_ssid_ippool.py
@@ -64,6 +64,14 @@ def get_all_params(self, name=None, id=None):
             self.new_object.get('site_name_hierarchy')
         return new_object_params
 
+    def create_params(self):
+        new_object_params = {}
+        new_object_params['vlanName'] = self.new_object.get('vlanName')
+        new_object_params['scalableGroupName'] = self.new_object.get('scalableGroupName')
+        new_object_params['ssidNames'] = self.new_object.get('ssidNames')
+        new_object_params['siteNameHierarchy'] = self.new_object.get('siteNameHierarchy')
+        return new_object_params
+
     def update_all_params(self):
         new_object_params = {}
         new_object_params['vlanName'] = self.new_object.get('vlanName')
@@ -115,6 +123,15 @@ def requires_update(self, current_obj):
                                              requested_obj.get(ansible_param))
                    for (dnac_param, ansible_param) in obj_params)
 
+    def create(self):
+        result = self.dnac.exec(
+            family="fabric_wireless",
+            function="add_ssid_to_ip_pool_mapping",
+            params=self.create_params(),
+            op_modifies=True,
+        )
+        return result
+
     def update(self):
         id = self.new_object.get("id")
         name = self.new_object.get("name")
@@ -177,7 +194,8 @@ def run(self, tmp=None, task_vars=None):
                     response = prev_obj
                     dnac.object_already_present()
             else:
-                dnac.fail_json("Object does not exists, plugin only has update")
+                response = obj.create()
+                dnac.object_created()
 
         self._result.update(dict(dnac_response=response))
         self._result.update(dnac.exit_json())

diff --git a/plugins/action/wireless_profile.py b/plugins/action/wireless_profile.py
@@ -36,7 +36,7 @@
 ))
 
 required_if = [
-    ("state", "present", ["wirelessProfileName"], True),
+    ("state", "present", ["profileDetails"], True),
     ("state", "absent", ["wirelessProfileName"], True),
 ]
 required_one_of = []
@@ -54,7 +54,7 @@ def __init__(self, params, dnac):
 
     def get_all_params(self, name=None, id=None):
         new_object_params = {}
-        new_object_params['profile_name'] = self.new_object.get('wireless_profile_name')
+        new_object_params['profile_name'] = name or self.new_object.get('wireless_profile_name')
         return new_object_params
 
     def create_params(self):
@@ -104,6 +104,9 @@ def exists(self):
         o_id = self.new_object.get("id")
         name = self.new_object.get("name")
         name = name or self.new_object.get("wireless_profile_name")
+        profile_details = self.new_object.get("profileDetails")
+        if profile_details and profile_details.get("name"):
+            name = name or profile_details.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)

diff --git a/plugins/modules/app_policy_default_info.py b/plugins/modules/app_policy_default_info.py
@@ -20,7 +20,7 @@
     description: Additional headers.
     type: dict
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationPolicyDefault

diff --git a/plugins/modules/app_policy_info.py b/plugins/modules/app_policy_info.py
@@ -24,7 +24,7 @@
     - PolicyScope query parameter. Policy scope name.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationPolicy

diff --git a/plugins/modules/app_policy_intent_create.py b/plugins/modules/app_policy_intent_create.py
@@ -226,7 +226,7 @@
         type: dict
     type: list
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy ApplicationPolicyIntent

diff --git a/plugins/modules/app_policy_queuing_profile.py b/plugins/modules/app_policy_queuing_profile.py
@@ -89,7 +89,7 @@
         type: str
     type: list
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy CreateApplicationPolicyQueuingProfile

diff --git a/plugins/modules/app_policy_queuing_profile_count_info.py b/plugins/modules/app_policy_queuing_profile_count_info.py
@@ -20,7 +20,7 @@
     description: Additional headers.
     type: dict
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationPolicyQueuingProfileCount

diff --git a/plugins/modules/app_policy_queuing_profile_info.py b/plugins/modules/app_policy_queuing_profile_info.py
@@ -24,7 +24,7 @@
     - Name query parameter. Queuing profile name.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationPolicyQueuingProfile

diff --git a/plugins/modules/application_sets.py b/plugins/modules/application_sets.py
@@ -29,7 +29,7 @@
         type: str
     type: list
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy CreateApplicationSet

diff --git a/plugins/modules/application_sets_count_info.py b/plugins/modules/application_sets_count_info.py
@@ -20,7 +20,7 @@
     description: Additional headers.
     type: dict
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationSetsCount

diff --git a/plugins/modules/application_sets_info.py b/plugins/modules/application_sets_info.py
@@ -32,7 +32,7 @@
     - Name query parameter.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationSets

diff --git a/plugins/modules/applications.py b/plugins/modules/applications.py
@@ -133,7 +133,7 @@
         type: list
     type: list
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy CreateApplication

diff --git a/plugins/modules/applications_count_info.py b/plugins/modules/applications_count_info.py
@@ -20,7 +20,7 @@
     description: Additional headers.
     type: dict
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplicationsCount

diff --git a/plugins/modules/applications_health_info.py b/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.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Applications Applications

diff --git a/plugins/modules/applications_info.py b/plugins/modules/applications_info.py
@@ -32,7 +32,7 @@
     - Name query parameter. Application's name.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Application Policy GetApplications

diff --git a/plugins/modules/assign_device_to_site.py b/plugins/modules/assign_device_to_site.py
@@ -31,7 +31,7 @@
     description: SiteId path parameter. Site id to which site the device to assign.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for  AssignDevicesToSite

diff --git a/plugins/modules/associate_site_to_network_profile.py b/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.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Site Design Associate

diff --git a/plugins/modules/authentication_import_certificate.py b/plugins/modules/authentication_import_certificate.py
@@ -30,7 +30,7 @@
     description: PkPassword query parameter. Private Key Passsword.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Authentication Management ImportCertificate

diff --git a/plugins/modules/authentication_import_certificate_p12.py b/plugins/modules/authentication_import_certificate_p12.py
@@ -30,7 +30,7 @@
     description: PkPassword query parameter. Private Key Passsword.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Authentication Management ImportCertificateP12

diff --git a/plugins/modules/buildings_planned_access_points_info.py b/plugins/modules/buildings_planned_access_points_info.py
@@ -36,7 +36,7 @@
     - Radios query parameter. Inlcude planned radio details.
     type: bool
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Devices GetPlannedAccessPointsForBuilding

diff --git a/plugins/modules/business_sda_hostonboarding_ssid_ippool.py b/plugins/modules/business_sda_hostonboarding_ssid_ippool.py
@@ -9,7 +9,8 @@
 module: business_sda_hostonboarding_ssid_ippool
 short_description: Resource module for Business Sda Hostonboarding Ssid Ippool
 description:
-- Manage operation update of the resource Business Sda Hostonboarding Ssid Ippool.
+- Manage operations create and update of the resource Business Sda Hostonboarding Ssid Ippool.
+- Add SSID to IP Pool Mapping.
 - Update SSID to IP Pool Mapping.
 version_added: '4.0.0'
 extends_documentation_fragment:
@@ -30,22 +31,43 @@
     description: VLAN Name.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
+- name: Cisco DNA Center documentation for Fabric Wireless AddSSIDToIPPoolMapping
+  description: Complete reference of the AddSSIDToIPPoolMapping API.
+  link: https://developer.cisco.com/docs/dna-center/#!add-ssid-to-ip-pool-mapping
 - name: Cisco DNA Center documentation for Fabric Wireless UpdateSSIDToIPPoolMapping2
   description: Complete reference of the UpdateSSIDToIPPoolMapping2 API.
   link: https://developer.cisco.com/docs/dna-center/#!update-ssid-to-ip-pool-mapping-2
 notes:
   - SDK Method used are
+    fabric_wireless.FabricWireless.add_ssid_to_ip_pool_mapping,
     fabric_wireless.FabricWireless.update_ssid_to_ip_pool_mapping2,
 
   - Paths used are
+    post /dna/intent/api/v1/business/sda/hostonboarding/ssid-ippool,
     put /dna/intent/api/v1/business/sda/hostonboarding/ssid-ippool,
 
 """
 
 EXAMPLES = r"""
+- name: Create
+  cisco.dnac.business_sda_hostonboarding_ssid_ippool:
+    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}}"
+    state: present
+    scalableGroupName: string
+    siteNameHierarchy: string
+    ssidNames:
+    - string
+    vlanName: string
+
 - name: Update all
   cisco.dnac.business_sda_hostonboarding_ssid_ippool:
     dnac_host: "{{dnac_host}}"
@@ -68,11 +90,13 @@
 dnac_response:
   description: A dictionary or list with the response returned by the Cisco DNAC Python SDK
   returned: always
-  type: dict
+  type: list
   sample: >
-    {
-      "executionId": "string",
-      "executionStatusURL": "string",
-      "message": "string"
-    }
+    [
+      {
+        "executionId": "string",
+        "executionStatusURL": "string",
+        "message": "string"
+      }
+    ]
 """
diff --git a/plugins/modules/business_sda_hostonboarding_ssid_ippool_info.py b/plugins/modules/business_sda_hostonboarding_ssid_ippool_info.py
@@ -28,7 +28,7 @@
     - SiteNameHierarchy query parameter. Site Name Heirarchy.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Fabric Wireless GetSSIDToIPPoolMapping

diff --git a/plugins/modules/business_sda_virtual_network_summary_info.py b/plugins/modules/business_sda_virtual_network_summary_info.py
@@ -24,7 +24,7 @@
     - SiteNameHierarchy query parameter. Complete fabric siteNameHierarchy Path.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for  GetVirtualNetworkSummary

diff --git a/plugins/modules/business_sda_wireless_controller_create.py b/plugins/modules/business_sda_wireless_controller_create.py
@@ -23,7 +23,7 @@
     description: Site Name Hierarchy.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Fabric Wireless AddWLCToFabricDomain

diff --git a/plugins/modules/business_sda_wireless_controller_delete.py b/plugins/modules/business_sda_wireless_controller_delete.py
@@ -20,7 +20,7 @@
     description: DeviceIPAddress query parameter. Device Management IP Address.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Fabric Wireless RemoveWLCFromFabricDomain

diff --git a/plugins/modules/cli_credential.py b/plugins/modules/cli_credential.py
@@ -45,7 +45,7 @@
     description: Cli Credential's username.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Discovery CreateCLICredentials

diff --git a/plugins/modules/client_detail_info.py b/plugins/modules/client_detail_info.py
@@ -28,7 +28,7 @@
     - MacAddress query parameter. MAC Address of the client.
     type: str
 requirements:
-- dnacentersdk >= 2.5.0
+- dnacentersdk >= 2.5.4
 - python >= 3.5
 seealso:
 - name: Cisco DNA Center documentation for Clients GetClientDetail