Updated with API release 1.20.0

Author: TKIPisalegacycipher

meraki/__init__.py

@@ -43,7 +43,7 @@
     USE_ITERATOR_FOR_GET_PAGES,
 )
 
-__version__ = '1.19.0'
+__version__ = '1.20.0'
 
 
 class DashboardAPI(object):

meraki/aio/api/appliance.py

@@ -41,6 +41,24 @@ def getDeviceAppliancePerformance(self, serial: str):
 
 
 
+    def createDeviceApplianceVmxAuthenticationToken(self, serial: str):
+        """
+        **Generate a new vMX authentication token**
+        https://developer.cisco.com/meraki/api-v1/#!create-device-appliance-vmx-authentication-token
+
+        - serial (string): (required)
+        """
+
+        metadata = {
+            'tags': ['appliance', 'configure', 'vmx', 'authenticationToken'],
+            'operation': 'createDeviceApplianceVmxAuthenticationToken'
+        }
+        resource = f'/devices/{serial}/appliance/vmx/authenticationToken'
+
+        return self._session.post(metadata, resource)
+        
+
+
     def getNetworkApplianceClientSecurityEvents(self, networkId: str, clientId: str, total_pages=1, direction='next', **kwargs):
         """
         **List the security events for a client**

meraki/aio/api/camera.py

@@ -133,6 +133,50 @@ def getDeviceCameraAnalyticsZoneHistory(self, serial: str, zoneId: str, **kwargs
 
 
 
+    def getDeviceCameraCustomAnalytics(self, serial: str):
+        """
+        **Return custom analytics settings for a camera**
+        https://developer.cisco.com/meraki/api-v1/#!get-device-camera-custom-analytics
+
+        - serial (string): (required)
+        """
+
+        metadata = {
+            'tags': ['camera', 'configure', 'customAnalytics'],
+            'operation': 'getDeviceCameraCustomAnalytics'
+        }
+        resource = f'/devices/{serial}/camera/customAnalytics'
+
+        return self._session.get(metadata, resource)
+        
+
+
+    def updateDeviceCameraCustomAnalytics(self, serial: str, **kwargs):
+        """
+        **Update custom analytics settings for a camera**
+        https://developer.cisco.com/meraki/api-v1/#!update-device-camera-custom-analytics
+
+        - serial (string): (required)
+        - enabled (boolean): Enable custom analytics
+        - artifactId (string): The ID of the custom analytics artifact
+        - parameters (array): Parameters for the custom analytics workload
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['camera', 'configure', 'customAnalytics'],
+            'operation': 'updateDeviceCameraCustomAnalytics'
+        }
+        resource = f'/devices/{serial}/camera/customAnalytics'
+
+        body_params = ['enabled', 'artifactId', 'parameters', ]
+        payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
+
+        return self._session.put(metadata, resource, payload)
+        
+
+
     def generateDeviceCameraSnapshot(self, serial: str, **kwargs):
         """
         **Generate a snapshot of what the camera sees at the specified time and return a link to that image.**
@@ -635,6 +679,86 @@ def deleteNetworkCameraWirelessProfile(self, networkId: str, wirelessProfileId:
 
 
 
+    def getOrganizationCameraCustomAnalyticsArtifacts(self, organizationId: str):
+        """
+        **List Custom Analytics Artifacts**
+        https://developer.cisco.com/meraki/api-v1/#!get-organization-camera-custom-analytics-artifacts
+
+        - organizationId (string): (required)
+        """
+
+        metadata = {
+            'tags': ['camera', 'configure', 'customAnalytics', 'artifacts'],
+            'operation': 'getOrganizationCameraCustomAnalyticsArtifacts'
+        }
+        resource = f'/organizations/{organizationId}/camera/customAnalytics/artifacts'
+
+        return self._session.get(metadata, resource)
+        
+
+
+    def createOrganizationCameraCustomAnalyticsArtifact(self, organizationId: str, **kwargs):
+        """
+        **Create custom analytics artifact**
+        https://developer.cisco.com/meraki/api-v1/#!create-organization-camera-custom-analytics-artifact
+
+        - organizationId (string): (required)
+        - name (string): Unique name of the artifact
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['camera', 'configure', 'customAnalytics', 'artifacts'],
+            'operation': 'createOrganizationCameraCustomAnalyticsArtifact'
+        }
+        resource = f'/organizations/{organizationId}/camera/customAnalytics/artifacts'
+
+        body_params = ['name', ]
+        payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
+
+        return self._session.post(metadata, resource, payload)
+        
+
+
+    def getOrganizationCameraCustomAnalyticsArtifact(self, organizationId: str, artifactId: str):
+        """
+        **Get Custom Analytics Artifact**
+        https://developer.cisco.com/meraki/api-v1/#!get-organization-camera-custom-analytics-artifact
+
+        - organizationId (string): (required)
+        - artifactId (string): (required)
+        """
+
+        metadata = {
+            'tags': ['camera', 'configure', 'customAnalytics', 'artifacts'],
+            'operation': 'getOrganizationCameraCustomAnalyticsArtifact'
+        }
+        resource = f'/organizations/{organizationId}/camera/customAnalytics/artifacts/{artifactId}'
+
+        return self._session.get(metadata, resource)
+        
+
+
+    def deleteOrganizationCameraCustomAnalyticsArtifact(self, organizationId: str, artifactId: str):
+        """
+        **Delete Custom Analytics Artifact**
+        https://developer.cisco.com/meraki/api-v1/#!delete-organization-camera-custom-analytics-artifact
+
+        - organizationId (string): (required)
+        - artifactId (string): (required)
+        """
+
+        metadata = {
+            'tags': ['camera', 'configure', 'customAnalytics', 'artifacts'],
+            'operation': 'deleteOrganizationCameraCustomAnalyticsArtifact'
+        }
+        resource = f'/organizations/{organizationId}/camera/customAnalytics/artifacts/{artifactId}'
+
+        return self._session.delete(metadata, resource)
+        
+
+
     def getOrganizationCameraOnboardingStatuses(self, organizationId: str, **kwargs):
         """
         **Fetch onboarding status of cameras**

meraki/aio/api/organizations.py

@@ -1344,7 +1344,6 @@ def getOrganizationConfigurationChanges(self, organizationId: str, total_pages=1
 
 
 
-
     def getOrganizationDevices(self, organizationId: str, total_pages=1, direction='next', **kwargs):
         """
         **List the devices in an organization**

meraki/aio/api/sensor.py

@@ -21,7 +21,7 @@ def getOrganizationSensorReadingsHistory(self, organizationId: str, total_pages=
         - 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.
         - networkIds (array): Optional parameter to filter readings by network.
         - serials (array): Optional parameter to filter readings by sensor.
-        - metrics (array): Types of sensor readings to retrieve. If no metrics are supplied, all available types of readings will be retrieved. Allowed values are temperature, humidity, water, door, and battery.
+        - metrics (array): Types of sensor readings to retrieve. If no metrics are supplied, all available types of readings will be retrieved. Allowed values are temperature, humidity, water, door, tvoc, pm25, noise, indoorAirQuality, button, and battery.
         """
 
         kwargs.update(locals())
@@ -58,7 +58,7 @@ def getOrganizationSensorReadingsLatest(self, organizationId: str, total_pages=1
         - endingBefore (string): A token used by the server to indicate the end of the page. Often this is a timestamp or an ID but it is not limited to those. This parameter should not be defined by client applications. The link for the first, last, prev, or next page in the HTTP Link header should define it.
         - networkIds (array): Optional parameter to filter readings by network.
         - serials (array): Optional parameter to filter readings by sensor.
-        - metrics (array): Types of sensor readings to retrieve. If no metrics are supplied, all available types of readings will be retrieved. Allowed values are temperature, humidity, water, door, and battery.
+        - metrics (array): Types of sensor readings to retrieve. If no metrics are supplied, all available types of readings will be retrieved. Allowed values are temperature, humidity, water, door, tvoc, pm25, noise, indoorAirQuality, button, and battery.
         """
 
         kwargs.update(locals())

meraki/aio/api/switch.py

@@ -761,7 +761,7 @@ def updateNetworkSwitchAlternateManagementInterface(self, networkId: str, **kwar
 
     def getNetworkSwitchDhcpServerPolicy(self, networkId: str):
         """
-        **Return the DHCP server policy**
+        **Return the DHCP server settings**
         https://developer.cisco.com/meraki/api-v1/#!get-network-switch-dhcp-server-policy
 
         - networkId (string): (required)
@@ -779,13 +779,13 @@ def getNetworkSwitchDhcpServerPolicy(self, networkId: str):
 
     def updateNetworkSwitchDhcpServerPolicy(self, networkId: str, **kwargs):
         """
-        **Update the DHCP server policy**
+        **Update the DHCP server settings**
         https://developer.cisco.com/meraki/api-v1/#!update-network-switch-dhcp-server-policy
 
         - networkId (string): (required)
         - defaultPolicy (string): 'allow' or 'block' new DHCP servers. Default value is 'allow'.
-        - allowedServers (array): List the MAC addresses of DHCP servers to permit on the network. Applicable only if defaultPolicy is set to block. An empty array will clear the entries.
-        - blockedServers (array): List the MAC addresses of DHCP servers to block on the network. Applicable only if defaultPolicy is set to allow. An empty array will clear the entries.
+        - allowedServers (array): List the MAC addresses of DHCP servers to permit on the network when defaultPolicy is set to block. An empty array will clear the entries.
+        - blockedServers (array): List the MAC addresses of DHCP servers to block on the network when defaultPolicy is set to allow. An empty array will clear the entries.
         """
 
         kwargs.update(locals())

meraki/aio/api/wireless.py

@@ -1863,6 +1863,7 @@ def updateNetworkWirelessSsidVpn(self, networkId: str, number: str, **kwargs):
 
         - networkId (string): (required)
         - number (string): (required)
+        - concentrator (object): The VPN concentrator settings for this SSID.
         - splitTunnel (object): The VPN split tunnel settings for this SSID.
         - failover (object): Secondary VPN concentrator settings. This is only used when two VPN concentrators are configured on the SSID.
         """
@@ -1875,7 +1876,7 @@ def updateNetworkWirelessSsidVpn(self, networkId: str, number: str, **kwargs):
         }
         resource = f'/networks/{networkId}/wireless/ssids/{number}/vpn'
 
-        body_params = ['splitTunnel', 'failover', ]
+        body_params = ['concentrator', 'splitTunnel', 'failover', ]
         payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
 
         return self._session.put(metadata, resource, payload)

meraki/api/appliance.py

@@ -41,6 +41,24 @@ def getDeviceAppliancePerformance(self, serial: str):
 
 
 
+    def createDeviceApplianceVmxAuthenticationToken(self, serial: str):
+        """
+        **Generate a new vMX authentication token**
+        https://developer.cisco.com/meraki/api-v1/#!create-device-appliance-vmx-authentication-token
+
+        - serial (string): (required)
+        """
+
+        metadata = {
+            'tags': ['appliance', 'configure', 'vmx', 'authenticationToken'],
+            'operation': 'createDeviceApplianceVmxAuthenticationToken'
+        }
+        resource = f'/devices/{serial}/appliance/vmx/authenticationToken'
+
+        return self._session.post(metadata, resource)
+        
+
+
     def getNetworkApplianceClientSecurityEvents(self, networkId: str, clientId: str, total_pages=1, direction='next', **kwargs):
         """
         **List the security events for a client**

meraki/api/batch/appliance.py

@@ -4,6 +4,32 @@ def __init__(self):
 
 
 
+    def createDeviceApplianceVmxAuthenticationToken(self, serial: str):
+        """
+        **Generate a new vMX authentication token**
+        https://developer.cisco.com/meraki/api-v1/#!create-device-appliance-vmx-authentication-token
+
+        - serial (string): (required)
+        """
+
+        metadata = {
+            'tags': ['appliance', 'configure', 'vmx', 'authenticationToken'],
+            'operation': 'createDeviceApplianceVmxAuthenticationToken'
+        }
+        resource = f'/devices/{serial}/appliance/vmx/authenticationToken'
+
+        action = {
+            "resource": resource,
+            "operation": "create",
+            "body": payload
+        }
+        return action
+        
+
+
+
+
+
     def updateNetworkApplianceConnectivityMonitoringDestinations(self, networkId: str, **kwargs):
         """
         **Update the connectivity testing destinations for an MX network**

meraki/api/batch/camera.py

@@ -4,6 +4,39 @@ def __init__(self):
 
 
 
+    def updateDeviceCameraCustomAnalytics(self, serial: str, **kwargs):
+        """
+        **Update custom analytics settings for a camera**
+        https://developer.cisco.com/meraki/api-v1/#!update-device-camera-custom-analytics
+
+        - serial (string): (required)
+        - enabled (boolean): Enable custom analytics
+        - artifactId (string): The ID of the custom analytics artifact
+        - parameters (array): Parameters for the custom analytics workload
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['camera', 'configure', 'customAnalytics'],
+            'operation': 'updateDeviceCameraCustomAnalytics'
+        }
+        resource = f'/devices/{serial}/camera/customAnalytics'
+
+        body_params = ['enabled', 'artifactId', 'parameters', ]
+        payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
+        action = {
+            "resource": resource,
+            "operation": "update",
+            "body": payload
+        }
+        return action
+        
+
+
+
+
+
     def updateDeviceCameraQualityAndRetention(self, serial: str, **kwargs):
         """
         **Update quality and retention settings for the given camera**