xautomata-hive 3.19.0__tar.gz → 3.20.0__tar.gz

{xautomata_hive-3.19.0/xautomata_hive.egg-info → xautomata_hive-3.20.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: xautomata-hive
-Version: 3.19.0
+Version: 3.20.0
 Home-page: https://github.com/sherlogic/xautomata-hive.git
 Author: Enrico Ferro - Andrea Jacassi
 Author-email: 
@@ -8,9 +8,9 @@ License: MIT
 Requires-Python: >=3.8.0
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: requests==2.31.0
 Requires-Dist: tqdm==4.64.1
 Requires-Dist: urllib3==2.0.4
+Requires-Dist: requests==2.31.0
 
 # Xautomata API
 Pacchetto che fornisca una interfaccia semplice per usare le API di Xautomata in python

{xautomata_hive-3.19.0 → xautomata_hive-3.20.0}/hive/api.py

@@ -9,7 +9,6 @@ from requests import HTTPError
 from hive.decorators import ratelimiter, refresh, paginate, warmstart, timeout_retry
 from hive.exceptions import UnauthorizedException
 from hive.infrastrucure_keys import Keys
-import warnings
 import gc
 import functools
 import logging
@@ -56,7 +55,7 @@ class ApiManager:
 
     def __init__(self, root, user, password, ssl_verify: bool = True):
 
-        if 'api/v' not in root: warnings.warn(f'{root} does not have the api/v* in the root, mandatory to point at the API')
+        if 'api/v' not in root: logger.warning(f'{root} does not have the api/v* in the root, mandatory to point at the API')
 
         self._SSL_verify = ssl_verify
         self.root = root.rstrip('/')
@@ -141,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
@@ -411,7 +410,7 @@ class ApiManager:
                 uuid_res.append(val['uuid'])
 
         if none_count > 0:
-            warnings.warn(f'{none_count} elements have not been matched with a uuid and can be found as None in the resutl list')
+            logger.warning(f'{none_count} elements have not been matched with a uuid and can be found as None in the resutl list')
 
         return uuid_res, get_count, post_count, put_count
 
@@ -468,7 +467,7 @@ def warning_wrong_parameters(func_name: str, params_from_user: dict, ufficial_pa
     if ufficial_params_list is None: ufficial_params_list = []
     for par in params_from_user:
         if par not in ufficial_params_list:
-            print(f'WARNING: from {func_name}, {par} is not in the official list of params.')
+            logger.warning(f'from {func_name}, {par} is not in the official list of params.')
 
 
 # gli import vengono messi qui per evitare una parziale import di api.py
@@ -509,17 +508,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
@@ -534,7 +537,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, 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.0 → xautomata_hive-3.20.0}/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.0 → xautomata_hive-3.20.0}/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.0 → xautomata_hive-3.20.0}/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.0 → xautomata_hive-3.20.0}/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.19.0 → xautomata_hive-3.20.0}/hive/cookbook/groups.py

@@ -87,6 +87,55 @@ class Groups(ApiManager):
             **kwargs)
         return response
 
+    def groups_v2(self, warm_start: bool = False, single_page: bool = False,
+        page_size: int = 5000, kwargs: dict = None, **params) -> list:
+        """Read Groups V2
+
+        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:
+            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
+            type (string optional): additional filter - parameter
+            name (string optional): additional filter - parameter
+            description (string optional): additional filter - parameter
+            status (string optional): additional filter - parameter
+            extract_severity (boolean optional): Se True nella risposta e' anche presente la severita, Default to False. - 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', 'type', 'name',
+            'description', 'status', 'extract_severity', '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('type'), params.get('name'
+            ), params.get('description'), params.get('status'), params.get(
+            'extract_severity'), params.get('skip'), params.get('limit'
+            ), params.get('like'), params.get('join'), params.get('count')
+        if not self._silence_warning:
+            warning_wrong_parameters(self.groups_v2.__name__, params,
+                official_params_list)
+        response = self.execute('GET', path=f'/groups/v2/', single_page=
+            single_page, page_size=page_size, warm_start=warm_start, params
+            =params, **kwargs)
+        return response
+
     def group(self, uuid: str, warm_start: bool = False,
         kwargs: dict = None, **params) -> list:
         """Read Group
@@ -207,6 +256,51 @@ class Groups(ApiManager):
             warm_start, params=params, **kwargs)
         return response
 
+    def groups_objects_v2(self, uuid: str, warm_start: bool = False,
+        single_page: bool = False, page_size: int = 5000,
+        kwargs: dict = None, **params) -> list:
+        """List Objects
+
+        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
+            not_in (boolean optional): additional filter - parameter
+            name (string optional): additional filter - parameter
+            profile (string optional): additional filter - parameter
+            extract_severity (boolean optional): Se True nella risposta e' anche presente la severita, Default to False. - parameter
+            object_profile (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', 'not_in', 'name', 'profile',
+            'extract_severity', 'object_profile', 'skip', 'limit', 'like',
+            'join', 'count']
+        params.get('sort_by'), params.get('not_in'), params.get('name'
+            ), params.get('profile'), params.get('extract_severity'
+            ), params.get('object_profile'), params.get('skip'), params.get(
+            'limit'), params.get('like'), params.get('join'), params.get(
+            'count')
+        if not self._silence_warning:
+            warning_wrong_parameters(self.groups_objects_v2.__name__,
+                params, official_params_list)
+        response = self.execute('GET', path=f'/groups/{uuid}/objects/v2/',
+            single_page=single_page, page_size=page_size, warm_start=
+            warm_start, params=params, **kwargs)
+        return response
+
     def groups_objects_create(self, uuid: str, uuid_object: str,
         kwargs: dict = None) -> list:
         """Add Object
@@ -328,6 +422,7 @@ class Groups(ApiManager):
             status (string optional): additional filter - parameter
             active_at_timestamp (string optional): additional filter - parameter
             active_after_timestamp (string optional): additional filter - parameter
+            active_at_or_after_timestamp (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
@@ -338,12 +433,15 @@ class Groups(ApiManager):
         if kwargs is None:
             kwargs = dict()
         official_params_list = ['not_in', 'code', 'status',
-            'active_at_timestamp', 'active_after_timestamp', 'skip',
-            'limit', 'like', 'join', 'count']
+            'active_at_timestamp', 'active_after_timestamp',
+            'active_at_or_after_timestamp', 'skip', 'limit', 'like', 'join',
+            'count']
         params.get('not_in'), params.get('code'), params.get('status'
             ), params.get('active_at_timestamp'), params.get(
-            'active_after_timestamp'), params.get('skip'), params.get('limit'
-            ), params.get('like'), params.get('join'), params.get('count')
+            'active_after_timestamp'), params.get(
+            'active_at_or_after_timestamp'), params.get('skip'), params.get(
+            'limit'), params.get('like'), params.get('join'), params.get(
+            'count')
         if not self._silence_warning:
             warning_wrong_parameters(self.groups_downtimes.__name__, params,
                 official_params_list)
@@ -669,6 +767,7 @@ class Groups(ApiManager):
         Keyword Args:
             active_at_timestamp (string optional): additional filter - parameter
             active_after_timestamp (string optional): additional filter - parameter
+            active_at_or_after_timestamp (string optional): additional filter - 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
 
         Examples:
@@ -681,9 +780,9 @@ class Groups(ApiManager):
         if kwargs is None:
             kwargs = dict()
         official_params_list = ['active_at_timestamp',
-            'active_after_timestamp', 'join']
+            'active_after_timestamp', 'active_at_or_after_timestamp', 'join']
         params.get('active_at_timestamp'), params.get('active_after_timestamp'
-            ), params.get('join')
+            ), params.get('active_at_or_after_timestamp'), params.get('join')
         if not self._silence_warning:
             warning_wrong_parameters(self.groups_downtimes_bulk.__name__,
                 params, official_params_list)

xautomata_hive-3.20.0/hive/cookbook/last_status_v2.py

@@ -0,0 +1,196 @@
+from hive.api import ApiManager, handling_single_page_methods, warning_wrong_parameters
+
+
+class LastStatusV2(ApiManager):
+    """Class that handles all the XAutomata last_status_v2 APIs"""
+
+    def last_status_v2(self, warm_start: bool = False,
+        single_page: bool = False, page_size: int = 5000,
+        kwargs: dict = None, **params) -> list:
+        """Read Last Admin Status
+
+        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:
+            extract_valueless_metrics (boolean optional): additional filter - parameter
+            extract_automata_domain (None optional): additional filter - 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
+            null_fields (string optional): additional filter - parameter
+            uuid_customer (string optional): additional filter - parameter
+            customer_code (string optional): additional filter - parameter
+            customer_status (string optional): additional filter - parameter
+            uuid_site (string optional): additional filter - parameter
+            site_code (string optional): additional filter - parameter
+            site_description (string optional): additional filter - parameter
+            site_address (string optional): additional filter - parameter
+            site_zip_code (string optional): additional filter - parameter
+            site_city (string optional): additional filter - parameter
+            site_country (string optional): additional filter - parameter
+            site_state_province (string optional): additional filter - parameter
+            site_status (string optional): additional filter - parameter
+            uuid_group (string optional): additional filter - parameter
+            group_name (string optional): additional filter - parameter
+            group_status (string optional): additional filter - parameter
+            group_type (string optional): additional filter - parameter
+            uuid_object (string optional): additional filter - parameter
+            object_name (string optional): additional filter - parameter
+            object_status (string optional): additional filter - parameter
+            object_profile (string optional): additional filter - parameter
+            uuid_metric_type (string optional): additional filter - parameter
+            metric_type_name (string optional): additional filter - parameter
+            metric_type_status (string optional): additional filter - parameter
+            uuid_metric (string optional): additional filter - parameter
+            metric_name (string optional): additional filter - parameter
+            metric_status (string optional): additional filter - parameter
+            metric_profile (string optional): additional filter - parameter
+            topic (string optional): additional filter - parameter
+            last_value_uuid_probe (string optional): additional filter - parameter
+            last_value_timestamp_start (string optional): additional filter - parameter
+            last_value_timestamp_end (string optional): additional filter - parameter
+            last_value_object_type (string optional): additional filter - parameter
+            last_value_name (string optional): additional filter - parameter
+            last_value_value (string optional): additional filter - parameter
+            last_value_unit (string optional): additional filter - parameter
+            last_value_description (string optional): additional filter - parameter
+            last_value_status (None optional): additional filter - parameter
+            last_value_ranking (integer 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 = ['extract_valueless_metrics',
+            'extract_automata_domain', 'sort_by', 'null_fields',
+            'uuid_customer', 'customer_code', 'customer_status',
+            'uuid_site', 'site_code', 'site_description', 'site_address',
+            'site_zip_code', 'site_city', 'site_country',
+            'site_state_province', 'site_status', 'uuid_group',
+            'group_name', 'group_status', 'group_type', 'uuid_object',
+            'object_name', 'object_status', 'object_profile',
+            'uuid_metric_type', 'metric_type_name', 'metric_type_status',
+            'uuid_metric', 'metric_name', 'metric_status', 'metric_profile',
+            'topic', 'last_value_uuid_probe', 'last_value_timestamp_start',
+            'last_value_timestamp_end', 'last_value_object_type',
+            'last_value_name', 'last_value_value', 'last_value_unit',
+            'last_value_description', 'last_value_status',
+            'last_value_ranking', 'skip', 'limit', 'like', 'join', 'count']
+        params.get('extract_valueless_metrics'), params.get(
+            'extract_automata_domain'), params.get('sort_by'), params.get(
+            'null_fields'), params.get('uuid_customer'), params.get(
+            'customer_code'), params.get('customer_status'), params.get(
+            'uuid_site'), params.get('site_code'), params.get(
+            'site_description'), params.get('site_address'), params.get(
+            'site_zip_code'), params.get('site_city'), params.get(
+            'site_country'), params.get('site_state_province'), params.get(
+            'site_status'), params.get('uuid_group'), params.get('group_name'
+            ), params.get('group_status'), params.get('group_type'
+            ), params.get('uuid_object'), params.get('object_name'
+            ), params.get('object_status'), params.get('object_profile'
+            ), params.get('uuid_metric_type'), params.get('metric_type_name'
+            ), params.get('metric_type_status'), params.get('uuid_metric'
+            ), params.get('metric_name'), params.get('metric_status'
+            ), params.get('metric_profile'), params.get('topic'), params.get(
+            'last_value_uuid_probe'), params.get('last_value_timestamp_start'
+            ), params.get('last_value_timestamp_end'), params.get(
+            'last_value_object_type'), params.get('last_value_name'
+            ), params.get('last_value_value'), params.get('last_value_unit'
+            ), params.get('last_value_description'), params.get(
+            'last_value_status'), params.get('last_value_ranking'), params.get(
+            'skip'), params.get('limit'), params.get('like'), params.get('join'
+            ), params.get('count')
+        if not self._silence_warning:
+            warning_wrong_parameters(self.last_status_v2.__name__, params,
+                official_params_list)
+        response = self.execute('GET', path=f'/last_status_v2/',
+            single_page=single_page, page_size=page_size, warm_start=
+            warm_start, params=params, **kwargs)
+        return response
+
+    def last_status_bulk(self, payload: dict = False,
+        warm_start: bool = False, single_page: bool = False,
+        page_size: int = 5000, kwargs: dict = None, **params) -> list:
+        """Read Last Admin Status Lists
+
+        Args:
+            payload (dict, optional): additional parameters for the API.
+            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
+            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
+
+        Examples:
+            payload = 
+           {
+            "uuid_customer": "array", optional
+            "customer_code": "array", optional
+            "customer_status": "array", optional
+            "uuid_site": "array", optional
+            "site_code": "array", optional
+            "site_description": "array", optional
+            "site_address": "array", optional
+            "site_zip_code": "array", optional
+            "site_city": "array", optional
+            "site_country": "array", optional
+            "site_state_province": "array", optional
+            "site_status": "array", optional
+            "uuid_group": "array", optional
+            "group_name": "array", optional
+            "group_status": "array", optional
+            "group_type": "array", optional
+            "uuid_object": "array", optional
+            "object_name": "array", optional
+            "object_status": "array", optional
+            "object_profile": "array", optional
+            "uuid_metric_type": "array", optional
+            "metric_type_name": "array", optional
+            "metric_type_status": "array", optional
+            "uuid_metric": "array", optional
+            "metric_name": "array", optional
+            "metric_status": "array", optional
+            "metric_profile": "array", optional
+            "topic": "array", optional
+            "last_value_uuid_probe": "array", optional
+            "last_value_timestamp": "array", optional
+            "last_value_object_type": "array", optional
+            "last_value_name": "array", optional
+            "last_value_value": "array", optional
+            "last_value_unit": "array", optional
+            "last_value_description": "array", optional
+            "last_value_status": "array", optional
+            "last_value_ranking": "array", optional
+           }
+
+        Returns: list"""
+        if kwargs is None:
+            kwargs = dict()
+        official_params_list = ['sort_by', 'null_fields', 'skip', 'limit',
+            'like', 'join', 'count']
+        params.get('sort_by'), params.get('null_fields'), params.get('skip'
+            ), params.get('limit'), params.get('like'), params.get('join'
+            ), params.get('count')
+        if not self._silence_warning:
+            warning_wrong_parameters(self.last_status_bulk.__name__, params,
+                official_params_list)
+        response = self.execute('POST', path=f'/last_status_v2/',
+            single_page=single_page, page_size=page_size, warm_start=
+            warm_start, params=params, payload=payload, **kwargs)
+        return response