SDK updated for Meraki API v1.10 release

Author: TKIPisalegacycipher

meraki/__init__.py

@@ -25,7 +25,7 @@
     SUPPRESS_LOGGING, SIMULATE_API_CALLS, BE_GEO_ID, MERAKI_PYTHON_SDK_CALLER
 )
 
-__version__ = '1.7.2'
+__version__ = '1.10.0'
 
 
 class DashboardAPI(object):

meraki/aio/api/camera.py

@@ -242,6 +242,7 @@ def updateDeviceCameraSense(self, serial: str, **kwargs):
         - serial (string): (required)
         - senseEnabled (boolean): Boolean indicating if sense(license) is enabled(true) or disabled(false) on the camera
         - mqttBrokerId (string): The ID of the MQTT broker to be enabled on the camera. A value of null will disable MQTT on the camera
+        - audioDetection (object): The details of the audio detection config.
         - detectionModelId (string): The ID of the object detection model
         """
 
@@ -253,7 +254,7 @@ def updateDeviceCameraSense(self, serial: str, **kwargs):
         }
         resource = f'/devices/{serial}/camera/sense'
 
-        body_params = ['senseEnabled', 'mqttBrokerId', 'detectionModelId', ]
+        body_params = ['senseEnabled', 'mqttBrokerId', 'audioDetection', 'detectionModelId', ]
         payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
 
         return self._session.put(metadata, resource, payload)
@@ -344,6 +345,48 @@ def getDeviceCameraVideoLink(self, serial: str, **kwargs):
 
 
 
+    def getDeviceCameraWirelessProfiles(self, serial: str):
+        """
+        **Returns wireless profile assigned to the given camera**
+        https://developer.cisco.com/meraki/api-v1/#!get-device-camera-wireless-profiles
+
+        - serial (string): (required)
+        """
+
+        metadata = {
+            'tags': ['camera', 'configure', 'wirelessProfiles'],
+            'operation': 'getDeviceCameraWirelessProfiles'
+        }
+        resource = f'/devices/{serial}/camera/wirelessProfiles'
+
+        return self._session.get(metadata, resource)
+        
+
+
+    def updateDeviceCameraWirelessProfiles(self, serial: str, ids: dict):
+        """
+        **Assign wireless profiles to the given camera**
+        https://developer.cisco.com/meraki/api-v1/#!update-device-camera-wireless-profiles
+
+        - serial (string): (required)
+        - ids (object): The ids of the wireless profile to assign to the given camera
+        """
+
+        kwargs = locals()
+
+        metadata = {
+            'tags': ['camera', 'configure', 'wirelessProfiles'],
+            'operation': 'updateDeviceCameraWirelessProfiles'
+        }
+        resource = f'/devices/{serial}/camera/wirelessProfiles'
+
+        body_params = ['ids', ]
+        payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
+
+        return self._session.put(metadata, resource, payload)
+        
+
+
     def getNetworkCameraQualityRetentionProfiles(self, networkId: str):
         """
         **List the quality retention profiles for this network**
@@ -375,7 +418,7 @@ def createNetworkCameraQualityRetentionProfile(self, networkId: str, name: str,
         - cloudArchiveEnabled (boolean): Create redundant video backup using Cloud Archive. Can be either true or false. Defaults to false.
         - motionDetectorVersion (integer): The version of the motion detector that will be used by the camera. Only applies to Gen 2 cameras. Defaults to v2.
         - scheduleId (string): Schedule for which this camera will record video, or 'null' to always record.
-        - maxRetentionDays (integer): The maximum number of days for which the data will be stored, or 'null' to keep data until storage space runs out. If the former, it can be one of [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 14, 30, 60, 90] days
+        - maxRetentionDays (integer): The maximum number of days for which the data will be stored, or 'null' to keep data until storage space runs out. If the former, it can be one of [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 14, 30, 60, 90] days.
         - videoSettings (object): Video quality and resolution settings for all the camera models.
         """
 
@@ -427,7 +470,7 @@ def updateNetworkCameraQualityRetentionProfile(self, networkId: str, qualityRete
         - cloudArchiveEnabled (boolean): Create redundant video backup using Cloud Archive. Can be either true or false. Defaults to false.
         - motionDetectorVersion (integer): The version of the motion detector that will be used by the camera. Only applies to Gen 2 cameras. Defaults to v2.
         - scheduleId (string): Schedule for which this camera will record video, or 'null' to always record.
-        - maxRetentionDays (integer): The maximum number of days for which the data will be stored, or 'null' to keep data until storage space runs out. If the former, it can be one of [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 14, 30, 60, 90] days
+        - maxRetentionDays (integer): The maximum number of days for which the data will be stored, or 'null' to keep data until storage space runs out. If the former, it can be one of [1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 14, 30, 60, 90] days.
         - videoSettings (object): Video quality and resolution settings for all the camera models.
         """
 
@@ -481,3 +524,168 @@ def getNetworkCameraSchedules(self, networkId: str):
 
         return self._session.get(metadata, resource)
 
+
+
+    def createNetworkCameraWirelessProfile(self, networkId: str, name: str, ssid: dict, **kwargs):
+        """
+        **Creates a new camera wireless profile for this network.**
+        https://developer.cisco.com/meraki/api-v1/#!create-network-camera-wireless-profile
+
+        - networkId (string): (required)
+        - name (string): The name of the camera wireless profile. This parameter is required.
+        - ssid (object): The details of the SSID config.
+        - identity (object): The identity of the wireless profile. Required for creating wireless profiles in 8021x-radius auth mode.
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['camera', 'configure', 'wirelessProfiles'],
+            'operation': 'createNetworkCameraWirelessProfile'
+        }
+        resource = f'/networks/{networkId}/camera/wirelessProfiles'
+
+        body_params = ['name', 'ssid', 'identity', ]
+        payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
+
+        return self._session.post(metadata, resource, payload)
+        
+
+
+    def getNetworkCameraWirelessProfiles(self, networkId: str):
+        """
+        **List the camera wireless profiles for this network.**
+        https://developer.cisco.com/meraki/api-v1/#!get-network-camera-wireless-profiles
+
+        - networkId (string): (required)
+        """
+
+        metadata = {
+            'tags': ['camera', 'configure', 'wirelessProfiles'],
+            'operation': 'getNetworkCameraWirelessProfiles'
+        }
+        resource = f'/networks/{networkId}/camera/wirelessProfiles'
+
+        return self._session.get(metadata, resource)
+        
+
+
+    def getNetworkCameraWirelessProfile(self, networkId: str, wirelessProfileId: str):
+        """
+        **Retrieve a single camera wireless profile.**
+        https://developer.cisco.com/meraki/api-v1/#!get-network-camera-wireless-profile
+
+        - networkId (string): (required)
+        - wirelessProfileId (string): (required)
+        """
+
+        metadata = {
+            'tags': ['camera', 'configure', 'wirelessProfiles'],
+            'operation': 'getNetworkCameraWirelessProfile'
+        }
+        resource = f'/networks/{networkId}/camera/wirelessProfiles/{wirelessProfileId}'
+
+        return self._session.get(metadata, resource)
+        
+
+
+    def updateNetworkCameraWirelessProfile(self, networkId: str, wirelessProfileId: str, **kwargs):
+        """
+        **Update an existing camera wireless profile in this network.**
+        https://developer.cisco.com/meraki/api-v1/#!update-network-camera-wireless-profile
+
+        - networkId (string): (required)
+        - wirelessProfileId (string): (required)
+        - name (string): The name of the camera wireless profile.
+        - ssid (object): The details of the SSID config.
+        - identity (object): The identity of the wireless profile. Required for creating wireless profiles in 8021x-radius auth mode.
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['camera', 'configure', 'wirelessProfiles'],
+            'operation': 'updateNetworkCameraWirelessProfile'
+        }
+        resource = f'/networks/{networkId}/camera/wirelessProfiles/{wirelessProfileId}'
+
+        body_params = ['name', 'ssid', 'identity', ]
+        payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
+
+        return self._session.put(metadata, resource, payload)
+        
+
+
+    def deleteNetworkCameraWirelessProfile(self, networkId: str, wirelessProfileId: str):
+        """
+        **Delete an existing camera wireless profile for this network.**
+        https://developer.cisco.com/meraki/api-v1/#!delete-network-camera-wireless-profile
+
+        - networkId (string): (required)
+        - wirelessProfileId (string): (required)
+        """
+
+        metadata = {
+            'tags': ['camera', 'configure', 'wirelessProfiles'],
+            'operation': 'deleteNetworkCameraWirelessProfile'
+        }
+        resource = f'/networks/{networkId}/camera/wirelessProfiles/{wirelessProfileId}'
+
+        return self._session.delete(metadata, resource)
+        
+
+
+    def getOrganizationCameraOnboardingStatuses(self, organizationId: str, **kwargs):
+        """
+        **Fetch onboarding status of cameras**
+        https://developer.cisco.com/meraki/api-v1/#!get-organization-camera-onboarding-statuses
+
+        - organizationId (string): (required)
+        - serials (array): A list of serial numbers. The returned cameras will be filtered to only include these serials.
+        - networkIds (array): A list of network IDs. The returned cameras will be filtered to only include these networks.
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['camera', 'configure', 'onboarding', 'statuses'],
+            'operation': 'getOrganizationCameraOnboardingStatuses'
+        }
+        resource = f'/organizations/{organizationId}/camera/onboarding/statuses'
+
+        query_params = ['serials', 'networkIds', ]
+        params = {k.strip(): v for k, v in kwargs.items() if k.strip() in query_params}
+
+        array_params = ['serials', 'networkIds', ]
+        for k, v in kwargs.items():
+            if k.strip() in array_params:
+                params[f'{k.strip()}[]'] = kwargs[f'{k}']
+                params.pop(k.strip())
+
+        return self._session.get(metadata, resource, params)
+        
+
+
+    def updateOrganizationCameraOnboardingStatuses(self, organizationId: str, **kwargs):
+        """
+        **Notify that credential handoff to camera has completed**
+        https://developer.cisco.com/meraki/api-v1/#!update-organization-camera-onboarding-statuses
+
+        - organizationId (string): (required)
+        - serial (string): Serial of camera
+        - wirelessCredentialsSent (boolean): Note whether credentials were sent successfully
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['camera', 'configure', 'onboarding', 'statuses'],
+            'operation': 'updateOrganizationCameraOnboardingStatuses'
+        }
+        resource = f'/organizations/{organizationId}/camera/onboarding/statuses'
+
+        body_params = ['serial', 'wirelessCredentialsSent', ]
+        payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
+
+        return self._session.put(metadata, resource, payload)
+        

meraki/aio/api/insight.py

@@ -5,6 +5,34 @@ def __init__(self, session):
 
 
 
+    def getNetworkInsightApplicationHealthByTime(self, network_id: str, application_id: str, **kwargs):
+        """
+        **Get application health by time**
+        https://developer.cisco.com/meraki/api-v1/#!get-network-insight-application-health-by-time
+
+        - network_id (string): (required)
+        - application_id (string): (required)
+        - t0 (string): The beginning of the timespan for the data. The maximum lookback period is 7 days from today.
+        - t1 (string): The end of the timespan for the data. t1 can be a maximum of 7 days after t0.
+        - timespan (number): The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 7 days. The default is 2 hours.
+        - resolution (integer): The time resolution in seconds for returned data. The valid resolutions are: 60, 300, 3600, 86400. The default is 300.
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['insight', 'monitor', 'applications', 'healthByTime'],
+            'operation': 'getNetworkInsightApplicationHealthByTime'
+        }
+        resource = f'/networks/{network_id}/insight/applications/{application_id}/healthByTime'
+
+        query_params = ['t0', 't1', 'timespan', 'resolution', ]
+        params = {k.strip(): v for k, v in kwargs.items() if k.strip() in query_params}
+
+        return self._session.get(metadata, resource, params)
+        
+
+
     def getOrganizationInsightMonitoredMediaServers(self, organizationId: str):
         """
         **List the monitored media servers for this organization**
@@ -112,3 +140,21 @@ def deleteOrganizationInsightMonitoredMediaServer(self, organizationId: str, mon
 
         return self._session.delete(metadata, resource)
 
+
+
+    def getOrganizationInsightApplications(self, organization_id: str):
+        """
+        **List all Insight tracked applications**
+        https://developer.cisco.com/meraki/api-v1/#!get-organization-insight-applications
+
+        - organization_id (string): (required)
+        """
+
+        metadata = {
+            'tags': ['insight', 'configure', 'applications'],
+            'operation': 'getOrganizationInsightApplications'
+        }
+        resource = f'/organizations/{organization_id}/insight/applications'
+
+        return self._session.get(metadata, resource)
+        

meraki/aio/api/networks.py

@@ -261,6 +261,33 @@ def getNetworkClientsApplicationUsage(self, networkId: str, clients: str, total_
 
 
 
+    def getNetworkClientsOverview(self, networkId: str, **kwargs):
+        """
+        **Return overview statistics for network clients**
+        https://developer.cisco.com/meraki/api-v1/#!get-network-clients-overview
+
+        - networkId (string): (required)
+        - t0 (string): The beginning of the timespan for the data. The maximum lookback period is 31 days from today.
+        - t1 (string): The end of the timespan for the data. t1 can be a maximum of 31 days after t0.
+        - timespan (number): The timespan for which the information will be fetched. If specifying timespan, do not specify parameters t0 and t1. The value must be in seconds and be less than or equal to 31 days. The default is 1 day.
+        - resolution (integer): The time resolution in seconds for returned data. The valid resolutions are: 7200, 86400, 604800, 2592000. The default is 604800.
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['networks', 'monitor', 'clients', 'overview'],
+            'operation': 'getNetworkClientsOverview'
+        }
+        resource = f'/networks/{networkId}/clients/overview'
+
+        query_params = ['t0', 't1', 'timespan', 'resolution', ]
+        params = {k.strip(): v for k, v in kwargs.items() if k.strip() in query_params}
+
+        return self._session.get(metadata, resource, params)
+        
+
+
     def provisionNetworkClients(self, networkId: str, clients: list, devicePolicy: str, **kwargs):
         """
         **Provisions a client with a name and policy**