xautomata-hive 3.19.1__tar.gz → 3.20.1__tar.gz

{xautomata_hive-3.19.1/xautomata_hive.egg-info → xautomata_hive-3.20.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: xautomata-hive
-Version: 3.19.1
+Version: 3.20.1
 Home-page: https://github.com/sherlogic/xautomata-hive.git
 Author: Enrico Ferro - Andrea Jacassi
 Author-email: 

{xautomata_hive-3.19.1 → xautomata_hive-3.20.1}/hive/api.py

@@ -140,7 +140,7 @@ class ApiManager:
 
             # il controllo qui impedisce di fare chiamate se in modalita POST DELETE PUT se in modalita test,
             # con l'eccezione della presenza della parola read nel path che indica una bulk in lettura
-            if self._get_only and not(read and bulk) and not query:
+            if self._get_only and not (read and bulk) and not query:
                 raise ValueError('you are trying to access a not get_only API')
 
             # tutto quello che non è bulk e query gli viene impedito di paginare
@@ -489,6 +489,7 @@ from hive.cookbook.dispatchers import Dispatchers
 from hive.cookbook.downtimes import Downtimes
 from hive.cookbook.external_tickets import ExternalTickets
 from hive.cookbook.features import Features
+from hive.cookbook.files import Files
 from hive.cookbook.firmware_updates import FirmwareUpdates
 from hive.cookbook.groups import Groups
 from hive.cookbook.automata_ingest import AutomataIngest
@@ -508,17 +509,21 @@ from hive.cookbook.opening_reasons import OpeningReasons
 from hive.cookbook.probes import Probes
 from hive.cookbook.probe_types import ProbeTypes
 from hive.cookbook.profile_topics import ProfileTopics
+from hive.cookbook.questions import Questions
 from hive.cookbook.reason_for_closure import ReasonForClosure
 from hive.cookbook.retention_rules import RetentionRules
 from hive.cookbook.schedules import Schedules
 from hive.cookbook.services import Services
 from hive.cookbook.sites import Sites
 from hive.cookbook.last_status import LastStatus
+from hive.cookbook.last_status_v2 import LastStatusV2
 from hive.cookbook.terms_and_conditions import TermsAndConditions
 from hive.cookbook.tree_hierarchy import TreeHierarchy
+from hive.cookbook.tree_hierarchy_v2 import TreeHierarchyV2
 from hive.cookbook.ts_automata_state import TsAutomataState
 from hive.cookbook.ts_cost_azure_raw import TsCostAzureRaw
 from hive.cookbook.ts_cost_management import TsCostManagement
+from hive.cookbook.ts_cost_management_v2 import TsCostManagementV2
 from hive.cookbook.ts_metric_status import TsMetricStatus
 from hive.cookbook.ts_metric_value import TsMetricValue
 from hive.cookbook.ts_ntop_flows import TsNtopFlows
@@ -533,7 +538,7 @@ from hive.cookbook.widget_groups import WidgetGroups
 # hive imports stop
 
 
-class XautomataApi(AclDocs, AclOverrides, Analytics, Anomalies, Calendars, CostTagging, CostTags, CostViews, CostTreeNodes, CostTreeResources, Contacts, Customers, Dashboards, Dispatchers, Downtimes, ExternalTickets, Features, FirmwareUpdates, Groups, AutomataIngest, MetricIngest, Microsoft, Google, Login, Jobs, Messages, Metrics, ProbesLogIngest, MetricTypes, NotificationProviders, NotificationProviderTypes, Objects, OpeningReasons, Probes, ProbeTypes, ProfileTopics, ReasonForClosure, RetentionRules, Schedules, Services, Sites, LastStatus, TermsAndConditions, TreeHierarchy, TsAutomataState, TsCostAzureRaw, TsCostManagement, TsMetricStatus, TsMetricValue, TsNtopFlows, TsServiceStatus, TsServiceValue, Users, UsersNotifications, VirtualDomains, Widgets, Webhooks, WidgetGroups):
+class XautomataApi(AclDocs, AclOverrides, Analytics, Anomalies, Calendars, CostTagging, CostTags, CostViews, CostTreeNodes, CostTreeResources, Contacts, Customers, Dashboards, Dispatchers, Downtimes, ExternalTickets, Features, Files, FirmwareUpdates, Groups, AutomataIngest, MetricIngest, Microsoft, Google, Login, Jobs, Messages, Metrics, ProbesLogIngest, MetricTypes, NotificationProviders, NotificationProviderTypes, Objects, OpeningReasons, Probes, ProbeTypes, ProfileTopics, Questions, ReasonForClosure, RetentionRules, Schedules, Services, Sites, LastStatus, LastStatusV2, TermsAndConditions, TreeHierarchy, TreeHierarchyV2, TsAutomataState, TsCostAzureRaw, TsCostManagement, TsCostManagementV2, TsMetricStatus, TsMetricValue, TsNtopFlows, TsServiceStatus, TsServiceValue, Users, UsersNotifications, VirtualDomains, Widgets, Webhooks, WidgetGroups):
     """
     Class with each specific API, based on the ApiManager Class created for a more general interaction with Xautomata API
     """

{xautomata_hive-3.19.1 → xautomata_hive-3.20.1}/hive/cookbook/calendars.py

@@ -20,6 +20,7 @@ class Calendars(ApiManager):
             null_fields (string optional): additional filter - parameter
             name (string optional): additional filter - parameter
             local_public_holidays (boolean optional): additional filter - parameter
+            timezone (string optional): additional filter - parameter
             mon_int1_start (string optional): additional filter - parameter
             mon_int1_end (string optional): additional filter - parameter
             mon_int2_start (string optional): additional filter - parameter
@@ -58,35 +59,35 @@ class Calendars(ApiManager):
         if kwargs is None:
             kwargs = dict()
         official_params_list = ['sort_by', 'null_fields', 'name',
-            'local_public_holidays', 'mon_int1_start', 'mon_int1_end',
-            'mon_int2_start', 'mon_int2_end', 'tue_int1_start',
-            'tue_int1_end', 'tue_int2_start', 'tue_int2_end',
-            'wed_int1_start', 'wed_int1_end', 'wed_int2_start',
-            'wed_int2_end', 'thu_int1_start', 'thu_int1_end',
-            'thu_int2_start', 'thu_int2_end', 'fri_int1_start',
-            'fri_int1_end', 'fri_int2_start', 'fri_int2_end',
-            'sat_int1_start', 'sat_int1_end', 'sat_int2_start',
-            'sat_int2_end', 'sun_int1_start', 'sun_int1_end',
-            'sun_int2_start', 'sun_int2_end', 'skip', 'limit', 'like',
-            'join', 'count']
+            'local_public_holidays', 'timezone', 'mon_int1_start',
+            'mon_int1_end', 'mon_int2_start', 'mon_int2_end',
+            'tue_int1_start', 'tue_int1_end', 'tue_int2_start',
+            'tue_int2_end', 'wed_int1_start', 'wed_int1_end',
+            'wed_int2_start', 'wed_int2_end', 'thu_int1_start',
+            'thu_int1_end', 'thu_int2_start', 'thu_int2_end',
+            'fri_int1_start', 'fri_int1_end', 'fri_int2_start',
+            'fri_int2_end', 'sat_int1_start', 'sat_int1_end',
+            'sat_int2_start', 'sat_int2_end', 'sun_int1_start',
+            'sun_int1_end', 'sun_int2_start', 'sun_int2_end', 'skip',
+            'limit', 'like', 'join', 'count']
         params.get('sort_by'), params.get('null_fields'), params.get('name'
-            ), params.get('local_public_holidays'), params.get('mon_int1_start'
-            ), params.get('mon_int1_end'), params.get('mon_int2_start'
-            ), params.get('mon_int2_end'), params.get('tue_int1_start'
-            ), params.get('tue_int1_end'), params.get('tue_int2_start'
-            ), params.get('tue_int2_end'), params.get('wed_int1_start'
-            ), params.get('wed_int1_end'), params.get('wed_int2_start'
-            ), params.get('wed_int2_end'), params.get('thu_int1_start'
-            ), params.get('thu_int1_end'), params.get('thu_int2_start'
-            ), params.get('thu_int2_end'), params.get('fri_int1_start'
-            ), params.get('fri_int1_end'), params.get('fri_int2_start'
-            ), params.get('fri_int2_end'), params.get('sat_int1_start'
-            ), params.get('sat_int1_end'), params.get('sat_int2_start'
-            ), params.get('sat_int2_end'), params.get('sun_int1_start'
-            ), params.get('sun_int1_end'), params.get('sun_int2_start'
-            ), params.get('sun_int2_end'), params.get('skip'), params.get(
-            'limit'), params.get('like'), params.get('join'), params.get(
-            'count')
+            ), params.get('local_public_holidays'), params.get('timezone'
+            ), params.get('mon_int1_start'), params.get('mon_int1_end'
+            ), params.get('mon_int2_start'), params.get('mon_int2_end'
+            ), params.get('tue_int1_start'), params.get('tue_int1_end'
+            ), params.get('tue_int2_start'), params.get('tue_int2_end'
+            ), params.get('wed_int1_start'), params.get('wed_int1_end'
+            ), params.get('wed_int2_start'), params.get('wed_int2_end'
+            ), params.get('thu_int1_start'), params.get('thu_int1_end'
+            ), params.get('thu_int2_start'), params.get('thu_int2_end'
+            ), params.get('fri_int1_start'), params.get('fri_int1_end'
+            ), params.get('fri_int2_start'), params.get('fri_int2_end'
+            ), params.get('sat_int1_start'), params.get('sat_int1_end'
+            ), params.get('sat_int2_start'), params.get('sat_int2_end'
+            ), params.get('sun_int1_start'), params.get('sun_int1_end'
+            ), params.get('sun_int2_start'), params.get('sun_int2_end'
+            ), params.get('skip'), params.get('limit'), params.get('like'
+            ), params.get('join'), params.get('count')
         if not self._silence_warning:
             warning_wrong_parameters(self.calendars.__name__, params,
                 official_params_list)
@@ -104,6 +105,7 @@ class Calendars(ApiManager):
 
         Keyword Args:
             name (string required): additional filter - payload
+            timezone (string required): additional filter - payload
             local_public_holidays (boolean required): additional filter - payload
             mon_int1_start (string optional): additional filter - payload
             mon_int1_end (string optional): additional filter - payload
@@ -137,31 +139,33 @@ class Calendars(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
-        official_payload_list = ['name', 'local_public_holidays',
-            'mon_int1_start', 'mon_int1_end', 'mon_int2_start',
-            'mon_int2_end', 'tue_int1_start', 'tue_int1_end',
-            'tue_int2_start', 'tue_int2_end', 'wed_int1_start',
-            'wed_int1_end', 'wed_int2_start', 'wed_int2_end',
-            'thu_int1_start', 'thu_int1_end', 'thu_int2_start',
-            'thu_int2_end', 'fri_int1_start', 'fri_int1_end',
-            'fri_int2_start', 'fri_int2_end', 'sat_int1_start',
-            'sat_int1_end', 'sat_int2_start', 'sat_int2_end',
-            'sun_int1_start', 'sun_int1_end', 'sun_int2_start', 'sun_int2_end']
-        payload.get('name'), payload.get('local_public_holidays'), payload.get(
-            'mon_int1_start'), payload.get('mon_int1_end'), payload.get(
-            'mon_int2_start'), payload.get('mon_int2_end'), payload.get(
-            'tue_int1_start'), payload.get('tue_int1_end'), payload.get(
-            'tue_int2_start'), payload.get('tue_int2_end'), payload.get(
-            'wed_int1_start'), payload.get('wed_int1_end'), payload.get(
-            'wed_int2_start'), payload.get('wed_int2_end'), payload.get(
-            'thu_int1_start'), payload.get('thu_int1_end'), payload.get(
-            'thu_int2_start'), payload.get('thu_int2_end'), payload.get(
-            'fri_int1_start'), payload.get('fri_int1_end'), payload.get(
-            'fri_int2_start'), payload.get('fri_int2_end'), payload.get(
-            'sat_int1_start'), payload.get('sat_int1_end'), payload.get(
-            'sat_int2_start'), payload.get('sat_int2_end'), payload.get(
-            'sun_int1_start'), payload.get('sun_int1_end'), payload.get(
-            'sun_int2_start'), payload.get('sun_int2_end')
+        official_payload_list = ['name', 'timezone',
+            'local_public_holidays', 'mon_int1_start', 'mon_int1_end',
+            'mon_int2_start', 'mon_int2_end', 'tue_int1_start',
+            'tue_int1_end', 'tue_int2_start', 'tue_int2_end',
+            'wed_int1_start', 'wed_int1_end', 'wed_int2_start',
+            'wed_int2_end', 'thu_int1_start', 'thu_int1_end',
+            'thu_int2_start', 'thu_int2_end', 'fri_int1_start',
+            'fri_int1_end', 'fri_int2_start', 'fri_int2_end',
+            'sat_int1_start', 'sat_int1_end', 'sat_int2_start',
+            'sat_int2_end', 'sun_int1_start', 'sun_int1_end',
+            'sun_int2_start', 'sun_int2_end']
+        payload.get('name'), payload.get('timezone'), payload.get(
+            'local_public_holidays'), payload.get('mon_int1_start'
+            ), payload.get('mon_int1_end'), payload.get('mon_int2_start'
+            ), payload.get('mon_int2_end'), payload.get('tue_int1_start'
+            ), payload.get('tue_int1_end'), payload.get('tue_int2_start'
+            ), payload.get('tue_int2_end'), payload.get('wed_int1_start'
+            ), payload.get('wed_int1_end'), payload.get('wed_int2_start'
+            ), payload.get('wed_int2_end'), payload.get('thu_int1_start'
+            ), payload.get('thu_int1_end'), payload.get('thu_int2_start'
+            ), payload.get('thu_int2_end'), payload.get('fri_int1_start'
+            ), payload.get('fri_int1_end'), payload.get('fri_int2_start'
+            ), payload.get('fri_int2_end'), payload.get('sat_int1_start'
+            ), payload.get('sat_int1_end'), payload.get('sat_int2_start'
+            ), payload.get('sat_int2_end'), payload.get('sun_int1_start'
+            ), payload.get('sun_int1_end'), payload.get('sun_int2_start'
+            ), payload.get('sun_int2_end')
         if not self._silence_warning:
             warning_wrong_parameters(self.calendars_create.__name__,
                 payload, official_payload_list)
@@ -195,6 +199,7 @@ class Calendars(ApiManager):
 
         Keyword Args:
             name (string optional): additional filter - payload
+            timezone (string optional): additional filter - payload
             local_public_holidays (boolean optional): additional filter - payload
             mon_int1_start (string optional): additional filter - payload
             mon_int1_end (string optional): additional filter - payload
@@ -228,31 +233,33 @@ class Calendars(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
-        official_payload_list = ['name', 'local_public_holidays',
-            'mon_int1_start', 'mon_int1_end', 'mon_int2_start',
-            'mon_int2_end', 'tue_int1_start', 'tue_int1_end',
-            'tue_int2_start', 'tue_int2_end', 'wed_int1_start',
-            'wed_int1_end', 'wed_int2_start', 'wed_int2_end',
-            'thu_int1_start', 'thu_int1_end', 'thu_int2_start',
-            'thu_int2_end', 'fri_int1_start', 'fri_int1_end',
-            'fri_int2_start', 'fri_int2_end', 'sat_int1_start',
-            'sat_int1_end', 'sat_int2_start', 'sat_int2_end',
-            'sun_int1_start', 'sun_int1_end', 'sun_int2_start', 'sun_int2_end']
-        payload.get('name'), payload.get('local_public_holidays'), payload.get(
-            'mon_int1_start'), payload.get('mon_int1_end'), payload.get(
-            'mon_int2_start'), payload.get('mon_int2_end'), payload.get(
-            'tue_int1_start'), payload.get('tue_int1_end'), payload.get(
-            'tue_int2_start'), payload.get('tue_int2_end'), payload.get(
-            'wed_int1_start'), payload.get('wed_int1_end'), payload.get(
-            'wed_int2_start'), payload.get('wed_int2_end'), payload.get(
-            'thu_int1_start'), payload.get('thu_int1_end'), payload.get(
-            'thu_int2_start'), payload.get('thu_int2_end'), payload.get(
-            'fri_int1_start'), payload.get('fri_int1_end'), payload.get(
-            'fri_int2_start'), payload.get('fri_int2_end'), payload.get(
-            'sat_int1_start'), payload.get('sat_int1_end'), payload.get(
-            'sat_int2_start'), payload.get('sat_int2_end'), payload.get(
-            'sun_int1_start'), payload.get('sun_int1_end'), payload.get(
-            'sun_int2_start'), payload.get('sun_int2_end')
+        official_payload_list = ['name', 'timezone',
+            'local_public_holidays', 'mon_int1_start', 'mon_int1_end',
+            'mon_int2_start', 'mon_int2_end', 'tue_int1_start',
+            'tue_int1_end', 'tue_int2_start', 'tue_int2_end',
+            'wed_int1_start', 'wed_int1_end', 'wed_int2_start',
+            'wed_int2_end', 'thu_int1_start', 'thu_int1_end',
+            'thu_int2_start', 'thu_int2_end', 'fri_int1_start',
+            'fri_int1_end', 'fri_int2_start', 'fri_int2_end',
+            'sat_int1_start', 'sat_int1_end', 'sat_int2_start',
+            'sat_int2_end', 'sun_int1_start', 'sun_int1_end',
+            'sun_int2_start', 'sun_int2_end']
+        payload.get('name'), payload.get('timezone'), payload.get(
+            'local_public_holidays'), payload.get('mon_int1_start'
+            ), payload.get('mon_int1_end'), payload.get('mon_int2_start'
+            ), payload.get('mon_int2_end'), payload.get('tue_int1_start'
+            ), payload.get('tue_int1_end'), payload.get('tue_int2_start'
+            ), payload.get('tue_int2_end'), payload.get('wed_int1_start'
+            ), payload.get('wed_int1_end'), payload.get('wed_int2_start'
+            ), payload.get('wed_int2_end'), payload.get('thu_int1_start'
+            ), payload.get('thu_int1_end'), payload.get('thu_int2_start'
+            ), payload.get('thu_int2_end'), payload.get('fri_int1_start'
+            ), payload.get('fri_int1_end'), payload.get('fri_int2_start'
+            ), payload.get('fri_int2_end'), payload.get('sat_int1_start'
+            ), payload.get('sat_int1_end'), payload.get('sat_int2_start'
+            ), payload.get('sat_int2_end'), payload.get('sun_int1_start'
+            ), payload.get('sun_int1_end'), payload.get('sun_int2_start'
+            ), payload.get('sun_int2_end')
         if not self._silence_warning:
             warning_wrong_parameters(self.calendars_put.__name__, payload,
                 official_payload_list)
@@ -328,6 +335,7 @@ class Calendars(ApiManager):
           [
            {
             "name": "string", required
+            "timezone": "string", required
             "local_public_holidays": "boolean", required
             "mon_int1_start": "string", optional
             "mon_int1_end": "string", optional

{xautomata_hive-3.19.1 → xautomata_hive-3.20.1}/hive/cookbook/cost_tree_nodes.py

@@ -140,18 +140,28 @@ class CostTreeNodes(ApiManager):
             payload=payload, **kwargs)
         return response
 
-    def cost_tree_nodes_delete(self, uuid: str, kwargs: dict = None) -> list:
+    def cost_tree_nodes_delete(self, uuid: str, kwargs: dict = None, **params
+        ) -> list:
         """Delete Cost Tree Node
 
         Args:
             uuid (str, required): uuid
             kwargs (dict, optional): additional parameters for execute. Default to None.
+            **params: additional parameters for the API.
+
+        Keyword Args:
+            delete_resources (boolean optional): additional filter - parameter
 
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        official_params_list = ['delete_resources']
+        params.get('delete_resources')
+        if not self._silence_warning:
+            warning_wrong_parameters(self.cost_tree_nodes_delete.__name__,
+                params, official_params_list)
         response = self.execute('DELETE', path=f'/cost_tree_nodes/{uuid}',
-            **kwargs)
+            params=params, **kwargs)
         return response
 
     def cost_tree_nodes_navigate_tree(self, uuid: str,

{xautomata_hive-3.19.1 → xautomata_hive-3.20.1}/hive/cookbook/cost_tree_resources.py

@@ -156,12 +156,15 @@ class CostTreeResources(ApiManager):
         return response
 
     def cost_tree_resources_unfully_assigned_resources(self, uuid_view: str,
-        warm_start: bool = False, kwargs: dict = None, **params) -> list:
+        warm_start: bool = False, single_page: bool = False,
+        page_size: int = 5000, kwargs: dict = None, **params) -> list:
         """Get Unfully Assigned Resources
 
         Args:
             uuid_view (str, required): uuid_view
             warm_start (bool, optional): salva la risposta in un file e se viene richiamata la stessa funzione con gli stessi argomenti restituisce il contenuto del file. Default to False.
+            single_page (bool, optional): se False la risposta viene ottenuta a step per non appesantire le API. Default to False.
+            page_size (int, optional): Numero di oggetti per pagina se single_page == False. Default to 5000.
             kwargs (dict, optional): additional parameters for execute. Default to None.
             **params: additional parameters for the API.
 
@@ -169,25 +172,27 @@ class CostTreeResources(ApiManager):
             date_start (string required): additional filter - parameter
             date_end (string required): additional filter - parameter
             resource_id (string optional): additional filter - parameter
+            skip (integer optional): numero di oggetti che si vogliono saltare nella risposta. Default to 0. - parameter
             limit (integer optional): numero di oggetti massimi che si vogliono ottenere. Default to 1_000_000. - parameter
+            count (boolean optional): Se True nel header della risposta e' presente la dimensione massima a db della chiamata fatta, sconsigliabile perche raddoppia il tempo per chiamata. Default to False. - parameter
             sort_by (string optional): Stringa separata da virgole di campi su cui ordinare. Si indica uno o piu campi della risposta e si puo chiedere di ottenere i valori di quei campi in ordine ascendente o discendente. Esempio "Customer:Desc". Default to "". - parameter
 
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
-        kwargs, params = handling_single_page_methods(kwargs=kwargs, params
-            =params)
         official_params_list = ['date_start', 'date_end', 'resource_id',
-            'limit', 'sort_by']
+            'skip', 'limit', 'count', 'sort_by']
         params.get('date_start'), params.get('date_end'), params.get(
-            'resource_id'), params.get('limit'), params.get('sort_by')
+            'resource_id'), params.get('skip'), params.get('limit'
+            ), params.get('count'), params.get('sort_by')
         if not self._silence_warning:
             warning_wrong_parameters(self.
                 cost_tree_resources_unfully_assigned_resources.__name__,
                 params, official_params_list)
         response = self.execute('GET', path=
             f'/cost_tree_resources/{uuid_view}/unfully_assigned_resources/',
-            warm_start=warm_start, params=params, **kwargs)
+            single_page=single_page, page_size=page_size, warm_start=
+            warm_start, params=params, **kwargs)
         return response
 
     def cost_tree_resources_delete_bulk(self, payload: list,

{xautomata_hive-3.19.1 → xautomata_hive-3.20.1}/hive/cookbook/customers.py

@@ -309,6 +309,57 @@ class Customers(ApiManager):
             warm_start, params=params, **kwargs)
         return response
 
+    def customers_groups_v2(self, uuid: str, warm_start: bool = False,
+        single_page: bool = False, page_size: int = 5000,
+        kwargs: dict = None, **params) -> list:
+        """List Groups V2
+
+        Args:
+            uuid (str, required): uuid
+            warm_start (bool, optional): salva la risposta in un file e se viene richiamata la stessa funzione con gli stessi argomenti restituisce il contenuto del file. Default to False.
+            single_page (bool, optional): se False la risposta viene ottenuta a step per non appesantire le API. Default to False.
+            page_size (int, optional): Numero di oggetti per pagina se single_page == False. Default to 5000.
+            kwargs (dict, optional): additional parameters for execute. Default to None.
+            **params: additional parameters for the API.
+
+        Keyword Args:
+            sort_by (string optional): Stringa separata da virgole di campi su cui ordinare. Si indica uno o piu campi della risposta e si puo chiedere di ottenere i valori di quei campi in ordine ascendente o discendente. Esempio "Customer:Desc". Default to "". - parameter
+            null_fields (string optional): additional filter - parameter
+            uuid_parent (string optional): additional filter - parameter
+            uuid_site (string optional): additional filter - parameter
+            uuid_virtual_domain (string optional): additional filter - parameter
+            object_profile (string optional): additional filter - parameter
+            type (string optional): additional filter - parameter
+            name (string optional): additional filter - parameter
+            description (string optional): additional filter - parameter
+            status (string optional): additional filter - parameter
+            skip (integer optional): numero di oggetti che si vogliono saltare nella risposta. Default to 0. - parameter
+            limit (integer optional): numero di oggetti massimi che si vogliono ottenere. Default to 1_000_000. - parameter
+            like (boolean optional): Se True, eventuali filtri richiesti dalla API vengono presi come porzioni di testo, se False il matching sul campo dei filtri deve essere esatto. Default to True. - parameter
+            join (boolean optional): Se join = true, ogni riga restituita conterra' chiavi aggiuntive che fanno riferimento ad altre entita', con cui la riga ha relazioni 1:1. Default to False - parameter
+            count (boolean optional): Se True nel header della risposta e' presente la dimensione massima a db della chiamata fatta, sconsigliabile perche raddoppia il tempo per chiamata. Default to False. - parameter
+
+        Returns: list"""
+        if kwargs is None:
+            kwargs = dict()
+        official_params_list = ['sort_by', 'null_fields', 'uuid_parent',
+            'uuid_site', 'uuid_virtual_domain', 'object_profile', 'type',
+            'name', 'description', 'status', 'skip', 'limit', 'like',
+            'join', 'count']
+        params.get('sort_by'), params.get('null_fields'), params.get(
+            'uuid_parent'), params.get('uuid_site'), params.get(
+            'uuid_virtual_domain'), params.get('object_profile'), params.get(
+            'type'), params.get('name'), params.get('description'), params.get(
+            'status'), params.get('skip'), params.get('limit'), params.get(
+            'like'), params.get('join'), params.get('count')
+        if not self._silence_warning:
+            warning_wrong_parameters(self.customers_groups_v2.__name__,
+                params, official_params_list)
+        response = self.execute('GET', path=f'/customers/{uuid}/groups/v2/',
+            single_page=single_page, page_size=page_size, warm_start=
+            warm_start, params=params, **kwargs)
+        return response
+
     def customers_image(self, uuid: str, warm_start: bool = False,
         kwargs: dict = None) -> list:
         """Get Customer Image

{xautomata_hive-3.19.1 → xautomata_hive-3.20.1}/hive/cookbook/features.py

@@ -4,16 +4,28 @@ from hive.api import ApiManager, handling_single_page_methods, warning_wrong_par
 class Features(ApiManager):
     """Class that handles all the XAutomata features APIs"""
 
-    def features(self, warm_start: bool = False, kwargs: dict = None) -> list:
+    def features(self, warm_start: bool = False, kwargs: dict = None, **params
+        ) -> list:
         """Get Api Features Settings
 
         Args:
             warm_start (bool, optional): salva la risposta in un file e se viene richiamata la stessa funzione con gli stessi argomenti restituisce il contenuto del file. Default to False.
             kwargs (dict, optional): additional parameters for execute. Default to None.
+            **params: additional parameters for the API.
+
+        Keyword Args:
+            user-agent (string optional): additional filter - parameter
 
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        kwargs, params = handling_single_page_methods(kwargs=kwargs, params
+            =params)
+        official_params_list = ['user-agent']
+        params.get('user-agent')
+        if not self._silence_warning:
+            warning_wrong_parameters(self.features.__name__, params,
+                official_params_list)
         response = self.execute('GET', path=f'/features/', warm_start=
-            warm_start, **kwargs)
+            warm_start, params=params, **kwargs)
         return response

xautomata_hive-3.20.1/hive/cookbook/files.py

@@ -0,0 +1,87 @@
+from hive.api import ApiManager, handling_single_page_methods, warning_wrong_parameters
+
+
+class Files(ApiManager):
+    """Class that handles all the XAutomata files APIs"""
+
+    def files(self, warm_start: bool = False, single_page: bool = False,
+        page_size: int = 5000, kwargs: dict = None, **params) -> list:
+        """List User Files
+
+        Args:
+            warm_start (bool, optional): salva la risposta in un file e se viene richiamata la stessa funzione con gli stessi argomenti restituisce il contenuto del file. Default to False.
+            single_page (bool, optional): se False la risposta viene ottenuta a step per non appesantire le API. Default to False.
+            page_size (int, optional): Numero di oggetti per pagina se single_page == False. Default to 5000.
+            kwargs (dict, optional): additional parameters for execute. Default to None.
+            **params: additional parameters for the API.
+
+        Keyword Args:
+            name (string optional): additional filter - parameter
+            username (string optional): additional filter - parameter
+            uuid_service (string optional): additional filter - parameter
+            type (string optional): additional filter - parameter
+            start_ts (string optional): additional filter - parameter
+            end_ts (string optional): additional filter - parameter
+            skip (integer optional): numero di oggetti che si vogliono saltare nella risposta. Default to 0. - parameter
+            limit (integer optional): numero di oggetti massimi che si vogliono ottenere. Default to 1_000_000. - parameter
+            like (boolean optional): Se True, eventuali filtri richiesti dalla API vengono presi come porzioni di testo, se False il matching sul campo dei filtri deve essere esatto. Default to True. - parameter
+            join (boolean optional): Se join = true, ogni riga restituita conterra' chiavi aggiuntive che fanno riferimento ad altre entita', con cui la riga ha relazioni 1:1. Default to False - parameter
+            count (boolean optional): Se True nel header della risposta e' presente la dimensione massima a db della chiamata fatta, sconsigliabile perche raddoppia il tempo per chiamata. Default to False. - parameter
+
+        Returns: list"""
+        if kwargs is None:
+            kwargs = dict()
+        official_params_list = ['name', 'username', 'uuid_service', 'type',
+            'start_ts', 'end_ts', 'skip', 'limit', 'like', 'join', 'count']
+        params.get('name'), params.get('username'), params.get('uuid_service'
+            ), params.get('type'), params.get('start_ts'), params.get('end_ts'
+            ), params.get('skip'), params.get('limit'), params.get('like'
+            ), params.get('join'), params.get('count')
+        if not self._silence_warning:
+            warning_wrong_parameters(self.files.__name__, params,
+                official_params_list)
+        response = self.execute('GET', path=f'/files/', single_page=
+            single_page, page_size=page_size, warm_start=warm_start, params
+            =params, **kwargs)
+        return response
+
+    def files_create(self, params: dict = False, kwargs: dict = None, **payload
+        ) -> list:
+        """Post User File
+
+        Args:
+            params (dict, optional): additional parameters for the API.
+            kwargs (dict, optional): additional parameters for execute. Default to None.
+            **payload: additional parameters for the API.
+
+        Keyword Args:
+            uuid_service (string optional): additional filter - parameter
+            file (string required): additional filter - payload
+
+        Returns: list"""
+        if kwargs is None:
+            kwargs = dict()
+        official_payload_list = ['file']
+        payload.get('file')
+        if not self._silence_warning:
+            warning_wrong_parameters(self.files_create.__name__, payload,
+                official_payload_list)
+        response = self.execute('POST', path=f'/files/', params=params,
+            payload=payload, **kwargs)
+        return response
+
+    def files_download(self, uuid: str, warm_start: bool = False,
+        kwargs: dict = None) -> list:
+        """Download User File
+
+        Args:
+            uuid (str, required): uuid
+            warm_start (bool, optional): salva la risposta in un file e se viene richiamata la stessa funzione con gli stessi argomenti restituisce il contenuto del file. Default to False.
+            kwargs (dict, optional): additional parameters for execute. Default to None.
+
+        Returns: list"""
+        if kwargs is None:
+            kwargs = dict()
+        response = self.execute('GET', path=f'/files/{uuid}/download',
+            warm_start=warm_start, **kwargs)
+        return response