Automatically regenerated library to version 1.51.0. (#268)

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

meraki/__init__.py

@@ -43,7 +43,7 @@
 )
 from meraki.rest_session import *
 
-__version__ = '1.50.0'
+__version__ = '1.51.0'
 
 
 class DashboardAPI(object):

meraki/aio/api/licensing.py

@@ -53,6 +53,7 @@ def getAdministeredLicensingSubscriptionSubscriptions(self, total_pages=1, direc
         - endDate (string): Filter subscriptions by end date, ISO 8601 format. To filter with a range of dates, use 'endDate[<option>]=?' in the request. Accepted options include lt, gt, lte, gte.
         - statuses (array): List of statuses that returned subscriptions can have
         - productTypes (array): List of product types that returned subscriptions need to have entitlements for.
+        - name (string): Search for subscription name
         """
 
         kwargs.update(locals())
@@ -63,7 +64,7 @@ def getAdministeredLicensingSubscriptionSubscriptions(self, total_pages=1, direc
         }
         resource = f'/administered/licensing/subscription/subscriptions'
 
-        query_params = ['perPage', 'startingAfter', 'endingBefore', 'subscriptionIds', 'organizationIds', 'startDate', 'endDate', 'statuses', 'productTypes', ]
+        query_params = ['perPage', 'startingAfter', 'endingBefore', 'subscriptionIds', 'organizationIds', 'startDate', 'endDate', 'statuses', 'productTypes', 'name', ]
         params = {k.strip(): v for k, v in kwargs.items() if k.strip() in query_params}
 
         array_params = ['subscriptionIds', 'organizationIds', 'statuses', 'productTypes', ]

meraki/aio/api/sensor.py

@@ -167,10 +167,10 @@ def getNetworkSensorAlertsOverviewByMetric(self, networkId: str, **kwargs):
         https://developer.cisco.com/meraki/api-v1/#!get-network-sensor-alerts-overview-by-metric
 
         - networkId (string): Network 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 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 7 days.
-        - interval (integer): The time interval in seconds for returned data. The valid intervals are: 86400, 604800. The default is 604800.
+        - t0 (string): The beginning of the timespan for the data. The maximum lookback period is 731 days from today.
+        - t1 (string): The end of the timespan for the data. t1 can be a maximum of 366 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 366 days. The default is 7 days. If interval is provided, the timespan will be autocalculated.
+        - interval (integer): The time interval in seconds for returned data. The valid intervals are: 900, 3600, 86400, 604800, 2592000. The default is 604800. Interval is calculated if time params are provided.
         """
 
         kwargs.update(locals())

meraki/aio/api/switch.py

@@ -2275,6 +2275,7 @@ def updateNetworkSwitchStormControl(self, networkId: str, **kwargs):
         - broadcastThreshold (integer): Percentage (1 to 99) of total available port bandwidth for broadcast traffic type. Default value 100 percent rate is to clear the configuration.
         - multicastThreshold (integer): Percentage (1 to 99) of total available port bandwidth for multicast traffic type. Default value 100 percent rate is to clear the configuration.
         - unknownUnicastThreshold (integer): Percentage (1 to 99) of total available port bandwidth for unknown unicast (dlf-destination lookup failure) traffic type. Default value 100 percent rate is to clear the configuration.
+        - treatTheseTrafficTypesAsOneThreshold (array): Grouped traffic types
         """
 
         kwargs.update(locals())
@@ -2286,7 +2287,7 @@ def updateNetworkSwitchStormControl(self, networkId: str, **kwargs):
         networkId = urllib.parse.quote(str(networkId), safe='')
         resource = f'/networks/{networkId}/switch/stormControl'
 
-        body_params = ['broadcastThreshold', 'multicastThreshold', 'unknownUnicastThreshold', ]
+        body_params = ['broadcastThreshold', 'multicastThreshold', 'unknownUnicastThreshold', 'treatTheseTrafficTypesAsOneThreshold', ]
         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/wireless.py

@@ -2534,6 +2534,44 @@ def getOrganizationWirelessAirMarshalSettingsByNetwork(self, organizationId: str
 
 
 
+    def getOrganizationWirelessClientsOverviewByDevice(self, organizationId: str, total_pages=1, direction='next', **kwargs):
+        """
+        **List access point client count at the moment in an organization**
+        https://developer.cisco.com/meraki/api-v1/#!get-organization-wireless-clients-overview-by-device
+
+        - 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
+        - networkIds (array): Optional parameter to filter access points client counts by network ID. This filter uses multiple exact matches.
+        - serials (array): Optional parameter to filter access points client counts by its serial numbers. This filter uses multiple exact matches.
+        - campusGatewayClusterIds (array): Optional parameter to filter access points client counts by MCG cluster IDs. This filter uses multiple exact matches.
+        - perPage (integer): The number of entries per page returned. Acceptable range is 3 - 1000. Default is 1000.
+        - 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.
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['wireless', 'configure', 'clients', 'overview', 'byDevice'],
+            'operation': 'getOrganizationWirelessClientsOverviewByDevice'
+        }
+        organizationId = urllib.parse.quote(str(organizationId), safe='')
+        resource = f'/organizations/{organizationId}/wireless/clients/overview/byDevice'
+
+        query_params = ['networkIds', 'serials', 'campusGatewayClusterIds', 'perPage', 'startingAfter', 'endingBefore', ]
+        params = {k.strip(): v for k, v in kwargs.items() if k.strip() in query_params}
+
+        array_params = ['networkIds', 'serials', 'campusGatewayClusterIds', ]
+        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_pages(metadata, resource, params, total_pages, direction)
+
+
+
     def getOrganizationWirelessDevicesChannelUtilizationByDevice(self, organizationId: str, total_pages=1, direction='next', **kwargs):
         """
         **Get average channel utilization for all bands in a network, split by AP**
@@ -2860,6 +2898,44 @@ def getOrganizationWirelessDevicesPacketLossByNetwork(self, organizationId: str,
 
 
 
+    def getOrganizationWirelessDevicesWirelessControllersByDevice(self, organizationId: str, total_pages=1, direction='next', **kwargs):
+        """
+        **List of Catalyst access points information**
+        https://developer.cisco.com/meraki/api-v1/#!get-organization-wireless-devices-wireless-controllers-by-device
+
+        - 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
+        - networkIds (array): Optional parameter to filter access points by network ID. This filter uses multiple exact matches.
+        - serials (array): Optional parameter to filter access points by its cloud ID. This filter uses multiple exact matches.
+        - controllerSerials (array): Optional parameter to filter access points by its wireless LAN controller cloud ID. This filter uses multiple exact matches.
+        - perPage (integer): The number of entries per page returned. Acceptable range is 3 - 1000. Default is 100.
+        - 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.
+        """
+
+        kwargs.update(locals())
+
+        metadata = {
+            'tags': ['wireless', 'configure', 'devices', 'wirelessControllers', 'byDevice'],
+            'operation': 'getOrganizationWirelessDevicesWirelessControllersByDevice'
+        }
+        organizationId = urllib.parse.quote(str(organizationId), safe='')
+        resource = f'/organizations/{organizationId}/wireless/devices/wirelessControllers/byDevice'
+
+        query_params = ['networkIds', 'serials', 'controllerSerials', 'perPage', 'startingAfter', 'endingBefore', ]
+        params = {k.strip(): v for k, v in kwargs.items() if k.strip() in query_params}
+
+        array_params = ['networkIds', 'serials', 'controllerSerials', ]
+        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_pages(metadata, resource, params, total_pages, direction)
+
+
+
     def getOrganizationWirelessRfProfilesAssignmentsByDevice(self, organizationId: str, total_pages=1, direction='next', **kwargs):
         """
         **List the RF profiles of an organization by device**