Automatically regenerated library. (#221)

Co-authored-by: GitHub Action <support@meraki.com>

meraki/__init__.py

@@ -45,7 +45,7 @@
     USE_ITERATOR_FOR_GET_PAGES,
 )
 
-__version__ = '1.34.3'
+__version__ = '1.36.0'
 
 
 class DashboardAPI(object):

meraki/aio/api/camera.py

@@ -244,7 +244,7 @@ def updateDeviceCameraQualityAndRetention(self, serial: str, **kwargs):
         - audioRecordingEnabled (boolean): Boolean indicating if audio recording is enabled(true) or disabled(false) on the camera
         - restrictedBandwidthModeEnabled (boolean): Boolean indicating if restricted bandwidth is enabled(true) or disabled(false) on the camera. This setting does not apply to MV2 cameras.
         - quality (string): Quality of the camera. Can be one of 'Standard', 'High' or 'Enhanced'. Not all qualities are supported by every camera model.
-        - resolution (string): Resolution of the camera. Can be one of '1280x720', '1920x1080', '1080x1080', '2058x2058', '2112x2112', '2880x2880', '2688x1512' or '3840x2160'.Not all resolutions are supported by every camera model.
+        - resolution (string): Resolution of the camera. Can be one of '1280x720', '1920x1080', '1080x1080', '2112x2112', '2880x2880', '2688x1512' or '3840x2160'.Not all resolutions are supported by every camera model.
         - motionDetectorVersion (integer): The version of the motion detector that will be used by the camera. Only applies to Gen 2 cameras. Defaults to v2.
         """
 
@@ -254,7 +254,7 @@ def updateDeviceCameraQualityAndRetention(self, serial: str, **kwargs):
             options = ['Enhanced', 'High', 'Standard']
             assert kwargs['quality'] in options, f'''"quality" cannot be "{kwargs['quality']}", & must be set to one of: {options}'''
         if 'resolution' in kwargs:
-            options = ['1080x1080', '1280x720', '1920x1080', '2058x2058', '2112x2112', '2688x1512', '2880x2880', '3840x2160']
+            options = ['1080x1080', '1280x720', '1920x1080', '2112x2112', '2688x1512', '2880x2880', '3840x2160']
             assert kwargs['resolution'] in options, f'''"resolution" cannot be "{kwargs['resolution']}", & must be set to one of: {options}'''
         if 'motionDetectorVersion' in kwargs:
             options = [1, 2]

meraki/aio/api/networks.py

@@ -1506,15 +1506,18 @@ def getNetworkMerakiAuthUser(self, networkId: str, merakiAuthUserId: str):
 
 
 
-    def deleteNetworkMerakiAuthUser(self, networkId: str, merakiAuthUserId: str):
+    def deleteNetworkMerakiAuthUser(self, networkId: str, merakiAuthUserId: str, **kwargs):
         """
-        **Deauthorize a user**
+        **Delete an 802.1X RADIUS user, or deauthorize and optionally delete a splash guest or client VPN user.**
         https://developer.cisco.com/meraki/api-v1/#!delete-network-meraki-auth-user
 
         - networkId (string): Network ID
         - merakiAuthUserId (string): Meraki auth user ID
+        - delete (boolean): If the ID supplied is for a splash guest or client VPN user, and that user is not authorized for any other networks in the organization, then also delete the user. 802.1X RADIUS users are always deleted regardless of this optional attribute.
         """
 
+        kwargs.update(locals())
+
         metadata = {
             'tags': ['networks', 'configure', 'merakiAuthUsers'],
             'operation': 'deleteNetworkMerakiAuthUser'

meraki/aio/api/organizations.py

@@ -2005,7 +2005,7 @@ def getOrganizationFirmwareUpgrades(self, organizationId: str, **kwargs):
 
         - organizationId (string): Organization ID
         - status (array): The status of an upgrade 
-        - productType (array): The product type in a given upgrade ID
+        - productTypes (array): The product type in a given upgrade ID
         """
 
         kwargs.update(locals())
@@ -2017,10 +2017,10 @@ def getOrganizationFirmwareUpgrades(self, organizationId: str, **kwargs):
         organizationId = urllib.parse.quote(str(organizationId), safe='')
         resource = f'/organizations/{organizationId}/firmware/upgrades'
 
-        query_params = ['status', 'productType', ]
+        query_params = ['status', 'productTypes', ]
         params = {k.strip(): v for k, v in kwargs.items() if k.strip() in query_params}
 
-        array_params = ['status', 'productType', ]
+        array_params = ['status', 'productTypes', ]
         for k, v in kwargs.items():
             if k.strip() in array_params:
                 params[f'{k.strip()}[]'] = kwargs[f'{k}']
@@ -2038,14 +2038,14 @@ def getOrganizationFirmwareUpgradesByDevice(self, organizationId: str, total_pag
         - organizationId (string): Organization ID
         - total_pages (integer or string): use with perPage to get total results up to total_pages*perPage; -1 or "all" for all pages
         - direction (string): direction to paginate, either "next" (default) or "prev" page
-        - perPage (integer): The number of entries per page returned. Acceptable range is 3 - 50. Default is 50.
+        - perPage (integer): The number of entries per page returned. Acceptable range is 3 - 1000. Default is 50.
         - startingAfter (string): A token used by the server to indicate the start 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.
         - 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 by network
         - serials (array): Optional parameter to filter by serial number.  All returned devices will have a serial number that is an exact match.
         - macs (array): Optional parameter to filter by one or more MAC addresses belonging to devices. All devices returned belong to MAC addresses that are an exact match.
-        - firmwareUpgradeIds (array): Optional parameter to filter by firmware upgrade ids.
         - firmwareUpgradeBatchIds (array): Optional parameter to filter by firmware upgrade batch ids.
+        - upgradeStatuses (array): Optional parameter to filter by firmware upgrade statuses.
         """
 
         kwargs.update(locals())
@@ -2057,10 +2057,10 @@ def getOrganizationFirmwareUpgradesByDevice(self, organizationId: str, total_pag
         organizationId = urllib.parse.quote(str(organizationId), safe='')
         resource = f'/organizations/{organizationId}/firmware/upgrades/byDevice'
 
-        query_params = ['perPage', 'startingAfter', 'endingBefore', 'networkIds', 'serials', 'macs', 'firmwareUpgradeIds', 'firmwareUpgradeBatchIds', ]
+        query_params = ['perPage', 'startingAfter', 'endingBefore', 'networkIds', 'serials', 'macs', 'firmwareUpgradeBatchIds', 'upgradeStatuses', ]
         params = {k.strip(): v for k, v in kwargs.items() if k.strip() in query_params}
 
-        array_params = ['networkIds', 'serials', 'macs', 'firmwareUpgradeIds', 'firmwareUpgradeBatchIds', ]
+        array_params = ['networkIds', 'serials', 'macs', 'firmwareUpgradeBatchIds', 'upgradeStatuses', ]
         for k, v in kwargs.items():
             if k.strip() in array_params:
                 params[f'{k.strip()}[]'] = kwargs[f'{k}']
@@ -3344,7 +3344,7 @@ def getOrganizationSummaryTopAppliancesByUtilization(self, organizationId: str,
         - organizationId (string): Organization ID
         - t0 (string): The beginning of the timespan for the data.
         - 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.
+        - 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 greater than or equal to 25 minutes and be less than or equal to 31 days. The default is 1 day.
         """
 
         kwargs.update(locals())
@@ -3371,7 +3371,7 @@ def getOrganizationSummaryTopClientsByUsage(self, organizationId: str, **kwargs)
         - organizationId (string): Organization ID
         - t0 (string): The beginning of the timespan for the data.
         - 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.
+        - 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 greater than or equal to 8 hours and be less than or equal to 31 days. The default is 1 day.
         """
 
         kwargs.update(locals())
@@ -3425,7 +3425,7 @@ def getOrganizationSummaryTopDevicesByUsage(self, organizationId: str, **kwargs)
         - organizationId (string): Organization ID
         - t0 (string): The beginning of the timespan for the data.
         - 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.
+        - 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 greater than or equal to 8 hours and be less than or equal to 31 days. The default is 1 day.
         """
 
         kwargs.update(locals())
@@ -3452,7 +3452,7 @@ def getOrganizationSummaryTopDevicesModelsByUsage(self, organizationId: str, **k
         - organizationId (string): Organization ID
         - t0 (string): The beginning of the timespan for the data.
         - 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.
+        - 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 greater than or equal to 8 hours and be less than or equal to 31 days. The default is 1 day.
         """
 
         kwargs.update(locals())
@@ -3479,7 +3479,7 @@ def getOrganizationSummaryTopSsidsByUsage(self, organizationId: str, **kwargs):
         - organizationId (string): Organization ID
         - t0 (string): The beginning of the timespan for the data.
         - 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.
+        - 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 greater than or equal to 8 hours and be less than or equal to 31 days. The default is 1 day.
         """
 
         kwargs.update(locals())
@@ -3506,7 +3506,7 @@ def getOrganizationSummaryTopSwitchesByEnergyUsage(self, organizationId: str, **
         - organizationId (string): Organization ID
         - t0 (string): The beginning of the timespan for the data.
         - 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.
+        - 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 greater than or equal to 25 minutes and be less than or equal to 31 days. The default is 1 day.
         """
 
         kwargs.update(locals())

meraki/aio/api/sm.py

@@ -608,7 +608,7 @@ def getNetworkSmDeviceWlanLists(self, networkId: str, deviceId: str):
 
     def getNetworkSmProfiles(self, networkId: str):
         """
-        **List all profiles in a network**
+        **List all the profiles in the network**
         https://developer.cisco.com/meraki/api-v1/#!get-network-sm-profiles
 
         - networkId (string): Network ID

meraki/aio/api/wireless.py

@@ -2202,7 +2202,7 @@ def getOrganizationWirelessDevicesChannelUtilizationHistoryByNetworkByInterval(s
 
     def getOrganizationWirelessDevicesEthernetStatuses(self, organizationId: str, total_pages=1, direction='next', **kwargs):
         """
-        **Endpoint to see power status for wireless devices**
+        **List the most recent Ethernet link speed, duplex, aggregation and power mode and status information for wireless devices.**
         https://developer.cisco.com/meraki/api-v1/#!get-organization-wireless-devices-ethernet-statuses
 
         - organizationId (string): Organization ID

meraki/api/batch/camera.py

@@ -51,7 +51,7 @@ def updateDeviceCameraQualityAndRetention(self, serial: str, **kwargs):
         - audioRecordingEnabled (boolean): Boolean indicating if audio recording is enabled(true) or disabled(false) on the camera
         - restrictedBandwidthModeEnabled (boolean): Boolean indicating if restricted bandwidth is enabled(true) or disabled(false) on the camera. This setting does not apply to MV2 cameras.
         - quality (string): Quality of the camera. Can be one of 'Standard', 'High' or 'Enhanced'. Not all qualities are supported by every camera model.
-        - resolution (string): Resolution of the camera. Can be one of '1280x720', '1920x1080', '1080x1080', '2058x2058', '2112x2112', '2880x2880', '2688x1512' or '3840x2160'.Not all resolutions are supported by every camera model.
+        - resolution (string): Resolution of the camera. Can be one of '1280x720', '1920x1080', '1080x1080', '2112x2112', '2880x2880', '2688x1512' or '3840x2160'.Not all resolutions are supported by every camera model.
         - motionDetectorVersion (integer): The version of the motion detector that will be used by the camera. Only applies to Gen 2 cameras. Defaults to v2.
         """
 
@@ -61,7 +61,7 @@ def updateDeviceCameraQualityAndRetention(self, serial: str, **kwargs):
             options = ['Enhanced', 'High', 'Standard']
             assert kwargs['quality'] in options, f'''"quality" cannot be "{kwargs['quality']}", & must be set to one of: {options}'''
         if 'resolution' in kwargs:
-            options = ['1080x1080', '1280x720', '1920x1080', '2058x2058', '2112x2112', '2688x1512', '2880x2880', '3840x2160']
+            options = ['1080x1080', '1280x720', '1920x1080', '2112x2112', '2688x1512', '2880x2880', '3840x2160']
             assert kwargs['resolution'] in options, f'''"resolution" cannot be "{kwargs['resolution']}", & must be set to one of: {options}'''
         if 'motionDetectorVersion' in kwargs:
             options = [1, 2]

meraki/api/batch/networks.py

@@ -588,15 +588,18 @@ def createNetworkMerakiAuthUser(self, networkId: str, email: str, authorizations
 
 
 
-    def deleteNetworkMerakiAuthUser(self, networkId: str, merakiAuthUserId: str):
+    def deleteNetworkMerakiAuthUser(self, networkId: str, merakiAuthUserId: str, **kwargs):
         """
-        **Deauthorize a user**
+        **Delete an 802.1X RADIUS user, or deauthorize and optionally delete a splash guest or client VPN user.**
         https://developer.cisco.com/meraki/api-v1/#!delete-network-meraki-auth-user
 
         - networkId (string): Network ID
         - merakiAuthUserId (string): Meraki auth user ID
+        - delete (boolean): If the ID supplied is for a splash guest or client VPN user, and that user is not authorized for any other networks in the organization, then also delete the user. 802.1X RADIUS users are always deleted regardless of this optional attribute.
         """
 
+        kwargs.update(locals())
+
         metadata = {
             'tags': ['networks', 'configure', 'merakiAuthUsers'],
             'operation': 'deleteNetworkMerakiAuthUser'

meraki/api/camera.py

@@ -244,7 +244,7 @@ def updateDeviceCameraQualityAndRetention(self, serial: str, **kwargs):
         - audioRecordingEnabled (boolean): Boolean indicating if audio recording is enabled(true) or disabled(false) on the camera
         - restrictedBandwidthModeEnabled (boolean): Boolean indicating if restricted bandwidth is enabled(true) or disabled(false) on the camera. This setting does not apply to MV2 cameras.
         - quality (string): Quality of the camera. Can be one of 'Standard', 'High' or 'Enhanced'. Not all qualities are supported by every camera model.
-        - resolution (string): Resolution of the camera. Can be one of '1280x720', '1920x1080', '1080x1080', '2058x2058', '2112x2112', '2880x2880', '2688x1512' or '3840x2160'.Not all resolutions are supported by every camera model.
+        - resolution (string): Resolution of the camera. Can be one of '1280x720', '1920x1080', '1080x1080', '2112x2112', '2880x2880', '2688x1512' or '3840x2160'.Not all resolutions are supported by every camera model.
         - motionDetectorVersion (integer): The version of the motion detector that will be used by the camera. Only applies to Gen 2 cameras. Defaults to v2.
         """
 
@@ -254,7 +254,7 @@ def updateDeviceCameraQualityAndRetention(self, serial: str, **kwargs):
             options = ['Enhanced', 'High', 'Standard']
             assert kwargs['quality'] in options, f'''"quality" cannot be "{kwargs['quality']}", & must be set to one of: {options}'''
         if 'resolution' in kwargs:
-            options = ['1080x1080', '1280x720', '1920x1080', '2058x2058', '2112x2112', '2688x1512', '2880x2880', '3840x2160']
+            options = ['1080x1080', '1280x720', '1920x1080', '2112x2112', '2688x1512', '2880x2880', '3840x2160']
             assert kwargs['resolution'] in options, f'''"resolution" cannot be "{kwargs['resolution']}", & must be set to one of: {options}'''
         if 'motionDetectorVersion' in kwargs:
             options = [1, 2]

meraki/api/networks.py

@@ -1506,15 +1506,18 @@ def getNetworkMerakiAuthUser(self, networkId: str, merakiAuthUserId: str):
 
 
 
-    def deleteNetworkMerakiAuthUser(self, networkId: str, merakiAuthUserId: str):
+    def deleteNetworkMerakiAuthUser(self, networkId: str, merakiAuthUserId: str, **kwargs):
         """
-        **Deauthorize a user**
+        **Delete an 802.1X RADIUS user, or deauthorize and optionally delete a splash guest or client VPN user.**
         https://developer.cisco.com/meraki/api-v1/#!delete-network-meraki-auth-user
 
         - networkId (string): Network ID
         - merakiAuthUserId (string): Meraki auth user ID
+        - delete (boolean): If the ID supplied is for a splash guest or client VPN user, and that user is not authorized for any other networks in the organization, then also delete the user. 802.1X RADIUS users are always deleted regardless of this optional attribute.
         """
 
+        kwargs.update(locals())
+
         metadata = {
             'tags': ['networks', 'configure', 'merakiAuthUsers'],
             'operation': 'deleteNetworkMerakiAuthUser'