Auto-update library to release version 1.34.0.

Author: GitHub Action on behalf of TKIPisalegacycipher

meraki/__init__.py

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

meraki/aio/api/appliance.py

@@ -84,6 +84,52 @@ def getDeviceAppliancePrefixesDelegatedVlanAssignments(self, serial: str):
 
 
 
+    def getDeviceApplianceRadioSettings(self, serial: str):
+        """
+        **Return the radio settings of an appliance**
+        https://developer.cisco.com/meraki/api-v1/#!get-device-appliance-radio-settings
+
+        - serial (string): Serial
+        """
+
+        metadata = {
+            'tags': ['appliance', 'configure', 'radio', 'settings'],
+            'operation': 'getDeviceApplianceRadioSettings'
+        }
+        serial = urllib.parse.quote(str(serial), safe='')
+        resource = f'/devices/{serial}/appliance/radio/settings'
+
+        return self._session.get(metadata, resource)
+        
+
+
+    def updateDeviceApplianceRadioSettings(self, serial: str, **kwargs):
+        """
+        **Update the radio settings of an appliance**
+        https://developer.cisco.com/meraki/api-v1/#!update-device-appliance-radio-settings
+
+        - serial (string): Serial
+        - rfProfileId (string): The ID of an RF profile to assign to the device. If the value of this parameter is null, the appropriate basic RF profile (indoor or outdoor) will be assigned to the device. Assigning an RF profile will clear ALL manually configured overrides on the device (channel width, channel, power).
+        - twoFourGhzSettings (object): Manual radio settings for 2.4 GHz.
+        - fiveGhzSettings (object): Manual radio settings for 5 GHz.
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['appliance', 'configure', 'radio', 'settings'],
+            'operation': 'updateDeviceApplianceRadioSettings'
+        }
+        serial = urllib.parse.quote(str(serial), safe='')
+        resource = f'/devices/{serial}/appliance/radio/settings'
+
+        body_params = ['rfProfileId', 'twoFourGhzSettings', 'fiveGhzSettings', ]
+        payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
+
+        return self._session.put(metadata, resource, payload)
+        
+
+
     def getDeviceApplianceUplinksSettings(self, serial: str):
         """
         **Return the uplink settings for an MX appliance**
@@ -978,6 +1024,125 @@ def deleteNetworkAppliancePrefixesDelegatedStatic(self, networkId: str, staticDe
 
 
 
+    def getNetworkApplianceRfProfiles(self, networkId: str):
+        """
+        **List the RF profiles for this network**
+        https://developer.cisco.com/meraki/api-v1/#!get-network-appliance-rf-profiles
+
+        - networkId (string): Network ID
+        """
+
+        metadata = {
+            'tags': ['appliance', 'configure', 'rfProfiles'],
+            'operation': 'getNetworkApplianceRfProfiles'
+        }
+        networkId = urllib.parse.quote(str(networkId), safe='')
+        resource = f'/networks/{networkId}/appliance/rfProfiles'
+
+        return self._session.get(metadata, resource)
+        
+
+
+    def createNetworkApplianceRfProfile(self, networkId: str, name: str, **kwargs):
+        """
+        **Creates new RF profile for this network**
+        https://developer.cisco.com/meraki/api-v1/#!create-network-appliance-rf-profile
+
+        - networkId (string): Network ID
+        - name (string): The name of the new profile. Must be unique. This param is required on creation.
+        - twoFourGhzSettings (object): Settings related to 2.4Ghz band
+        - fiveGhzSettings (object): Settings related to 5Ghz band
+        - perSsidSettings (object): Per-SSID radio settings by number.
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['appliance', 'configure', 'rfProfiles'],
+            'operation': 'createNetworkApplianceRfProfile'
+        }
+        networkId = urllib.parse.quote(str(networkId), safe='')
+        resource = f'/networks/{networkId}/appliance/rfProfiles'
+
+        body_params = ['name', 'twoFourGhzSettings', 'fiveGhzSettings', 'perSsidSettings', ]
+        payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
+
+        return self._session.post(metadata, resource, payload)
+        
+
+
+    def updateNetworkApplianceRfProfile(self, networkId: str, rfProfileId: str, **kwargs):
+        """
+        **Updates specified RF profile for this network**
+        https://developer.cisco.com/meraki/api-v1/#!update-network-appliance-rf-profile
+
+        - networkId (string): Network ID
+        - rfProfileId (string): Rf profile ID
+        - name (string): The name of the new profile. Must be unique.
+        - twoFourGhzSettings (object): Settings related to 2.4Ghz band
+        - fiveGhzSettings (object): Settings related to 5Ghz band
+        - perSsidSettings (object): Per-SSID radio settings by number.
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['appliance', 'configure', 'rfProfiles'],
+            'operation': 'updateNetworkApplianceRfProfile'
+        }
+        networkId = urllib.parse.quote(str(networkId), safe='')
+        rfProfileId = urllib.parse.quote(str(rfProfileId), safe='')
+        resource = f'/networks/{networkId}/appliance/rfProfiles/{rfProfileId}'
+
+        body_params = ['name', 'twoFourGhzSettings', 'fiveGhzSettings', 'perSsidSettings', ]
+        payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
+
+        return self._session.put(metadata, resource, payload)
+        
+
+
+    def deleteNetworkApplianceRfProfile(self, networkId: str, rfProfileId: str):
+        """
+        **Delete a RF Profile**
+        https://developer.cisco.com/meraki/api-v1/#!delete-network-appliance-rf-profile
+
+        - networkId (string): Network ID
+        - rfProfileId (string): Rf profile ID
+        """
+
+        metadata = {
+            'tags': ['appliance', 'configure', 'rfProfiles'],
+            'operation': 'deleteNetworkApplianceRfProfile'
+        }
+        networkId = urllib.parse.quote(str(networkId), safe='')
+        rfProfileId = urllib.parse.quote(str(rfProfileId), safe='')
+        resource = f'/networks/{networkId}/appliance/rfProfiles/{rfProfileId}'
+
+        return self._session.delete(metadata, resource)
+        
+
+
+    def getNetworkApplianceRfProfile(self, networkId: str, rfProfileId: str):
+        """
+        **Return a RF profile**
+        https://developer.cisco.com/meraki/api-v1/#!get-network-appliance-rf-profile
+
+        - networkId (string): Network ID
+        - rfProfileId (string): Rf profile ID
+        """
+
+        metadata = {
+            'tags': ['appliance', 'configure', 'rfProfiles'],
+            'operation': 'getNetworkApplianceRfProfile'
+        }
+        networkId = urllib.parse.quote(str(networkId), safe='')
+        rfProfileId = urllib.parse.quote(str(rfProfileId), safe='')
+        resource = f'/networks/{networkId}/appliance/rfProfiles/{rfProfileId}'
+
+        return self._session.get(metadata, resource)
+        
+
+
     def getNetworkApplianceSecurityEvents(self, networkId: str, total_pages=1, direction='next', **kwargs):
         """
         **List the security events for a network**
@@ -1275,6 +1440,7 @@ def updateNetworkApplianceSsid(self, networkId: str, number: str, **kwargs):
         - wpaEncryptionMode (string): The types of WPA encryption. ('WPA1 and WPA2', 'WPA2 only', 'WPA3 Transition Mode' or 'WPA3 only'). This param is only valid if (1) the authMode is 'psk' & the encryptionMode is 'wpa' OR (2) the authMode is '8021x-meraki' OR (3) the authMode is '8021x-radius'
         - visible (boolean): Boolean indicating whether the MX should advertise or hide this SSID.
         - dhcpEnforcedDeauthentication (object): DHCP Enforced Deauthentication enables the disassociation of wireless clients in addition to Mandatory DHCP. This param is only valid on firmware versions >= MX 17.0 where the associated LAN has Mandatory DHCP Enabled 
+        - dot11w (object): The current setting for Protected Management Frames (802.11w).
         """
 
         kwargs.update(locals())
@@ -1297,7 +1463,7 @@ def updateNetworkApplianceSsid(self, networkId: str, number: str, **kwargs):
         number = urllib.parse.quote(str(number), safe='')
         resource = f'/networks/{networkId}/appliance/ssids/{number}'
 
-        body_params = ['name', 'enabled', 'defaultVlanId', 'authMode', 'psk', 'radiusServers', 'encryptionMode', 'wpaEncryptionMode', 'visible', 'dhcpEnforcedDeauthentication', ]
+        body_params = ['name', 'enabled', 'defaultVlanId', 'authMode', 'psk', 'radiusServers', 'encryptionMode', 'wpaEncryptionMode', 'visible', 'dhcpEnforcedDeauthentication', 'dot11w', ]
         payload = {k.strip(): v for k, v in kwargs.items() if k.strip() in body_params}
 
         return self._session.put(metadata, resource, payload)
@@ -2244,6 +2410,33 @@ def getOrganizationApplianceUplinkStatuses(self, organizationId: str, total_page
 
 
 
+    def getOrganizationApplianceUplinksUsageByNetwork(self, organizationId: str, **kwargs):
+        """
+        **Get the sent and received bytes for each uplink of all wired networks within an organization**
+        https://developer.cisco.com/meraki/api-v1/#!get-organization-appliance-uplinks-usage-by-network
+
+        - organizationId (string): Organization ID
+        - t0 (string): The beginning of the timespan for the data. The maximum lookback period is 365 days from today.
+        - t1 (string): The end of the timespan for the data. t1 can be a maximum of 14 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 14 days. The default is 1 day.
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['appliance', 'monitor', 'uplinks', 'usage', 'byNetwork'],
+            'operation': 'getOrganizationApplianceUplinksUsageByNetwork'
+        }
+        organizationId = urllib.parse.quote(str(organizationId), safe='')
+        resource = f'/organizations/{organizationId}/appliance/uplinks/usage/byNetwork'
+
+        query_params = ['t0', 't1', 'timespan', ]
+        params = {k.strip(): v for k, v in kwargs.items() if k.strip() in query_params}
+
+        return self._session.get(metadata, resource, params)
+        
+
+
     def getOrganizationApplianceVpnStats(self, organizationId: str, total_pages=1, direction='next', **kwargs):
         """
         **Show VPN history stat for networks in an organization**

meraki/aio/api/camera.py

@@ -505,27 +505,6 @@ def createNetworkCameraQualityRetentionProfile(self, networkId: str, name: str,
 
 
 
-    def getNetworkCameraQualityRetentionProfile(self, networkId: str, qualityRetentionProfileId: str):
-        """
-        **Retrieve a single quality retention profile**
-        https://developer.cisco.com/meraki/api-v1/#!get-network-camera-quality-retention-profile
-
-        - networkId (string): Network ID
-        - qualityRetentionProfileId (string): Quality retention profile ID
-        """
-
-        metadata = {
-            'tags': ['camera', 'configure', 'qualityRetentionProfiles'],
-            'operation': 'getNetworkCameraQualityRetentionProfile'
-        }
-        networkId = urllib.parse.quote(str(networkId), safe='')
-        qualityRetentionProfileId = urllib.parse.quote(str(qualityRetentionProfileId), safe='')
-        resource = f'/networks/{networkId}/camera/qualityRetentionProfiles/{qualityRetentionProfileId}'
-
-        return self._session.get(metadata, resource)
-        
-
-
     def updateNetworkCameraQualityRetentionProfile(self, networkId: str, qualityRetentionProfileId: str, **kwargs):
         """
         **Update an existing quality retention profile for this network.**
@@ -582,6 +561,27 @@ def deleteNetworkCameraQualityRetentionProfile(self, networkId: str, qualityRete
 
 
 
+    def getNetworkCameraQualityRetentionProfile(self, networkId: str, qualityRetentionProfileId: str):
+        """
+        **Retrieve a single quality retention profile**
+        https://developer.cisco.com/meraki/api-v1/#!get-network-camera-quality-retention-profile
+
+        - networkId (string): Network ID
+        - qualityRetentionProfileId (string): Quality retention profile ID
+        """
+
+        metadata = {
+            'tags': ['camera', 'configure', 'qualityRetentionProfiles'],
+            'operation': 'getNetworkCameraQualityRetentionProfile'
+        }
+        networkId = urllib.parse.quote(str(networkId), safe='')
+        qualityRetentionProfileId = urllib.parse.quote(str(qualityRetentionProfileId), safe='')
+        resource = f'/networks/{networkId}/camera/qualityRetentionProfiles/{qualityRetentionProfileId}'
+
+        return self._session.get(metadata, resource)
+        
+
+
     def getNetworkCameraSchedules(self, networkId: str):
         """
         **Returns a list of all camera recording schedules.**

meraki/aio/api/devices.py

@@ -40,7 +40,7 @@ def updateDevice(self, serial: str, **kwargs):
         - address (string): The address of a device
         - notes (string): The notes for the device. String. Limited to 255 characters.
         - moveMapMarker (boolean): Whether or not to set the latitude and longitude of a device based on the new address. Only applies when lat and lng are not specified.
-        - switchProfileId (string): The ID of a switch profile to bind to the device (for available switch profiles, see the 'Switch Profiles' endpoint). Use null to unbind the switch device from the current profile. For a device to be bindable to a switch profile, it must (1) be a switch, and (2) belong to a network that is bound to a configuration template.
+        - switchProfileId (string): The ID of a switch template to bind to the device (for available switch templates, see the 'Switch Templates' endpoint). Use null to unbind the switch device from the current profile. For a device to be bindable to a switch template, it must (1) be a switch, and (2) belong to a network that is bound to a configuration template.
         - floorPlanId (string): The floor plan to associate to this device. null disassociates the device from the floorplan.
         """
 
@@ -190,7 +190,7 @@ def getDeviceLiveToolsPing(self, serial: str, id: str):
         https://developer.cisco.com/meraki/api-v1/#!get-device-live-tools-ping
 
         - serial (string): Serial
-        - id (string): Id
+        - id (string): ID
         """
 
         metadata = {
@@ -236,7 +236,7 @@ def getDeviceLiveToolsPingDevice(self, serial: str, id: str):
         https://developer.cisco.com/meraki/api-v1/#!get-device-live-tools-ping-device
 
         - serial (string): Serial
-        - id (string): Id
+        - id (string): ID
         """
 
         metadata = {
@@ -281,13 +281,13 @@ def getDeviceLossAndLatencyHistory(self, serial: str, ip: str, **kwargs):
         - 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: 60, 600, 3600, 86400. The default is 60.
-        - uplink (string): The WAN uplink used to obtain the requested stats. Valid uplinks are wan1, wan2, cellular. The default is wan1.
+        - uplink (string): The WAN uplink used to obtain the requested stats. Valid uplinks are wan1, wan2, wan3, cellular. The default is wan1.
         """
 
         kwargs.update(locals())
 
         if 'uplink' in kwargs:
-            options = ['cellular', 'wan1', 'wan2']
+            options = ['cellular', 'wan1', 'wan2', 'wan3']
             assert kwargs['uplink'] in options, f'''"uplink" cannot be "{kwargs['uplink']}", & must be set to one of: {options}'''
 
         metadata = {