xautomata-hive 3.0.3__py3-none-any.whl → 3.2.0__py3-none-any.whl

hive/api.py

@@ -289,6 +289,8 @@ class ApiManager:
         url_put = '/' + url_put.lstrip('/').rstrip('/') + '/'
 
         method = url_get.split('/')[1]
+        if method not in ['customers', 'virtual_domains', 'sites', 'groups', 'objects', 'metric_types', 'metrics', 'services']:
+            raise NotImplementedError(f'the {method} has not been implemented')
 
         get_count, post_count, put_count = 0, 0, 0
 
@@ -439,6 +441,13 @@ def handling_single_page_methods(kwargs, params):
     return kwargs, params
 
 
+def warning_wrong_parameters(func_name: str, params_from_user: dict, ufficial_params_list: list = None):
+    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.')
+
+
 # gli import vengono messi qui per evitare una parziale import di api.py
 # hive imports start
 from hive.cookbook.acl_docs import AclDocs
@@ -455,8 +464,6 @@ from hive.cookbook.external_tickets import ExternalTickets
 from hive.cookbook.firmware_updates import FirmwareUpdates
 from hive.cookbook.groups import Groups
 from hive.cookbook.metric_ingest import MetricIngest
-from hive.cookbook.last_status import LastStatus
-from hive.cookbook.tree_hierarchy import TreeHierarchy
 from hive.cookbook.login import Login
 from hive.cookbook.messages import Messages
 from hive.cookbook.metrics import Metrics
@@ -474,6 +481,8 @@ 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.tree_hierarchy import TreeHierarchy
 from hive.cookbook.ts_cost_azure_raw import TsCostAzureRaw
 from hive.cookbook.ts_cost_management import TsCostManagement
 from hive.cookbook.ts_metric_status import TsMetricStatus
@@ -482,6 +491,7 @@ from hive.cookbook.ts_ntop_flows import TsNtopFlows
 from hive.cookbook.ts_service_status import TsServiceStatus
 from hive.cookbook.ts_service_value import TsServiceValue
 from hive.cookbook.users import Users
+from hive.cookbook.users_notifications import UsersNotifications
 from hive.cookbook.virtual_domains import VirtualDomains
 from hive.cookbook.widgets import Widgets
 from hive.cookbook.webhooks import Webhooks
@@ -489,7 +499,7 @@ from hive.cookbook.widget_groups import WidgetGroups
 # hive imports stop
 
 
-class XautomataApi(AclDocs, AclOverrides, Analytics, Anomalies, Calendars, Contacts, Customers, Dashboards, Dispatchers, Downtimes, ExternalTickets, FirmwareUpdates, Groups, MetricIngest, LastStatus, TreeHierarchy, Login, Messages, Metrics, ProbesLogIngest, MetricTypes, NotificationProviders, NotificationProviderTypes, Objects, OpeningReasons, Probes, ProbeTypes, ProfileTopics, ReasonForClosure, RetentionRules, Schedules, Services, Sites, TsCostAzureRaw, TsCostManagement, TsMetricStatus, TsMetricValue, TsNtopFlows, TsServiceStatus, TsServiceValue, Users, VirtualDomains, Widgets, Webhooks, WidgetGroups):
+class XautomataApi(AclDocs, AclOverrides, Analytics, Anomalies, Calendars, Contacts, Customers, Dashboards, Dispatchers, Downtimes, ExternalTickets, FirmwareUpdates, Groups, MetricIngest, Login, Messages, Metrics, ProbesLogIngest, MetricTypes, NotificationProviders, NotificationProviderTypes, Objects, OpeningReasons, Probes, ProbeTypes, ProfileTopics, ReasonForClosure, RetentionRules, Schedules, Services, Sites, LastStatus, TreeHierarchy, TsCostAzureRaw, TsCostManagement, 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
     """
@@ -577,59 +587,130 @@ class XautomataApi(AclDocs, AclOverrides, Analytics, Anomalies, Calendars, Conta
 
         return response
 
-####
-    def dispatecher(self, uuids, types='metric'):
-        code = ''
-        app_name = ''
-        name_caledar = ''
+    def dispatecher(self, uuids: list, types: Literal['services', 'metrics', 'metric_types', 'objects', 'groups'], notification_provider_types: dict,
+                    notification_providers: dict, messages: dict, calendar: dict, dispatcher: dict):
+        """
+        create a dispatcher with the entire chain of elements to be used on a specific metric
+
+        Args:
+            uuids (list): list of uuid for the element to be linked with a dispatcher
+            types (Literal['services', 'metrics', 'metric_types', 'objects', 'groups']): type of uuids in the uuid list
+            notification_provider_types (dict): set of parameters to get or create a notification_provider_types
+            notification_providers (dict): set of parameters to get or create a notification_providers
+            messages (dict): set of parameters to get or create a messages
+            calendar (dict): set of parameters to get or create a calendar
+            dispatcher (dict): set of parameters to get or create a dispatcher
+
+        Examples:
+            notification_provider_types = {
+                "code": code,
+                "json_schema": {}
+            }
+
+            notification_providers = {
+                "uuid_notification_provider_type": uuid_npt,
+                "app_name": app_name,
+                "endpoint": {}
+            }
+
+            messages = {
+                "code": "string",
+                "description": "string",
+                "mask": "string",
+                "mask_mime_type": "string",
+                "additional_mask": "string",
+                "additional_mask_mime_type": "string"
+            }
+
+            calendar = {
+                "name": name_caledar,
+                "local_public_holidays": True,
+                "mon_int1_start": "string",
+                "mon_int1_end": "string",
+                "mon_int2_start": "string",
+                "mon_int2_end": "string",
+                "tue_int1_start": "string",
+                "tue_int1_end": "string",
+                "tue_int2_start": "string",
+                "tue_int2_end": "string",
+                "wed_int1_start": "string",
+                "wed_int1_end": "string",
+                "wed_int2_start": "string",
+                "wed_int2_end": "string",
+                "thu_int1_start": "string",
+                "thu_int1_end": "string",
+                "thu_int2_start": "string",
+                "thu_int2_end": "string",
+                "fri_int1_start": "string",
+                "fri_int1_end": "string",
+                "fri_int2_start": "string",
+                "fri_int2_end": "string",
+                "sat_int1_start": "string",
+                "sat_int1_end": "string",
+                "sat_int2_start": "string",
+                "sat_int2_end": "string",
+                "sun_int1_start": "string",
+                "sun_int1_end": "string",
+                "sun_int2_start": "string",
+                "sun_int2_end": "string",
+            }
+
+            dispatcher = {
+              "uuid_notification_provider": uuid_np,
+              "uuid_calendar": uuid_calendar,
+              "uuid_message": uuid_m,
+              "uuid_opening_reason": "string",
+              "uuid_reason_for_closure": "string",
+              "code": "string",
+              "description": "string",
+              "delay": 0,
+              "status": "s",
+              "country": "st",
+              "state_province": "string",
+              "data_profile": [
+                "string"
+              ],
+                "remember_it": True
+            }
+        """
+
+        def select_get_params(_params: dict, get_keys: tuple):
+            return dict((k, _params[k]) for k in get_keys)
 
         # notification provider types
-        params = {'code': code, 'json_schema': {}}
-        uuid_npt, _, _, _ = self.get_post(url_get='/notification_provider_types/', get_params=params, post_params=params)
+        uuid_npt, _, _, _ = self.get_post(url_get='/notification_provider_types/',
+                                          get_params=select_get_params(notification_provider_types, ('code',)),
+                                          post_params=notification_provider_types)
+        print(f'notification provider type has been set ({uuid_npt})')
 
         # notification providers
-        params = {
-            "uuid_notification_provider_type": uuid_npt,
-            "app_name": app_name,
-            "endpoint": {}
-        }
-        uuid_np, _, _, _ = self.get_post(url_get='/notification_providers/', get_params=params, post_params=params)
+        uuid_np, _, _, _ = self.get_post(url_get='/notification_providers/',
+                                         get_params=select_get_params(notification_providers, ('uuid_notification_provider_type', 'app_name')),
+                                         post_params=notification_providers)
+        print(f'notification provider has been set ({uuid_np})')
 
         # messages
-        params = {
-            "code": "string",
-            "description": "string",
-            "mask": "string",
-            "mask_mime_type": "string"
-        }
-        uuid_m, _, _, _ = self.get_post(url_get='/messages/', get_params=params, post_params=params)
+        uuid_m, _, _, _ = self.get_post(url_get='/messages/',
+                                        get_params=select_get_params(messages, ('code', 'description', 'mask')),
+                                        post_params=messages)
+        print(f'message has been set ({uuid_m})')
 
         # calendar
         # chiedi un calendar per nome
         # se passi un json post_put del calender in json
-        uuid_calendar = self.execute(mode='GET', path='/calendar/', params={'name': name_caledar, 'limit': 1})[0]
+        uuid_calendar, _, _, _ = self.get_post(url_get='/calendar/',
+                                        get_params=select_get_params(calendar, ('name', 'local_public_holidays')),
+                                        post_params=calendar)
+        print(f'calendar has been set ({uuid_calendar})')
 
         # dispatcher
-        params = {
-          "uuid_notification_provider": uuid_npt,
-          "uuid_calendar": uuid_calendar,
-          "uuid_message": uuid_m,
-          "code": "string",
-          "description": "string",
-          "delay": 0,
-          "status": "s",
-          "country": "st",
-          "state_province": "string",
-          "data_profile": [
-            "string"
-          ]
-        }
-        uuid_d, _, _, _ = self.get_post(url_get='/dispatcehrs/', get_params=params, post_params=params)
+        uuid_d, _, _, _ = self.get_post(url_get='/dispatcher/',
+                                        get_params=select_get_params(dispatcher, ('tuple_required', 'uuid_message', 'code', 'status',)),
+                                        post_params=dispatcher)
+        print(f'dispatcher has been set ({uuid_d})')
 
         # COLLEGAMENTO
         # lista degli uuid degli oggetti da legare a questo dispacter
         for uuid in uuids:
-            if types == 'metric':
-                self.execute(mode='POST', path=f'/dispatcehrs/{uuid_d}/metrics{uuid}')
-            else:
-                raise NotImplementedError
+            self.execute(mode='POST', path=f'/dispatcher/{uuid_d}/{types}/{uuid}')
+        print(f'all the {types} have been linked with the selected dispatcher')

hive/cookbook/acl_docs.py

@@ -1,4 +1,4 @@
-from hive.api import ApiManager, handling_single_page_methods
+from hive.api import ApiManager, handling_single_page_methods, warning_wrong_parameters
 
 
 class AclDocs(ApiManager):

hive/cookbook/acl_overrides.py

@@ -1,4 +1,4 @@
-from hive.api import ApiManager, handling_single_page_methods
+from hive.api import ApiManager, handling_single_page_methods, warning_wrong_parameters
 
 
 class AclOverrides(ApiManager):
@@ -27,6 +27,14 @@ class AclOverrides(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        official_params_list = ['sort_by', 'null_fields', 'code',
+            'json_schema', 'skip', 'limit', 'like', 'join', 'count']
+        params.get('sort_by'), params.get('null_fields'), params.get('code'
+            ), params.get('json_schema'), params.get('skip'), params.get(
+            'limit'), params.get('like'), params.get('join'), params.get(
+            'count')
+        warning_wrong_parameters(self.acl_overrides.__name__, params,
+            official_params_list)
         response = self.execute('GET', path=f'/acl_overrides/', single_page
             =single_page, page_size=page_size, warm_start=warm_start,
             params=params, **kwargs)
@@ -43,6 +51,10 @@ class AclOverrides(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        official_payload_list = ['code', 'acl_override']
+        payload.get('code'), payload.get('acl_override')
+        warning_wrong_parameters(self.acl_overrides_create.__name__,
+            payload, official_payload_list)
         response = self.execute('POST', path=f'/acl_overrides/', payload=
             payload, **kwargs)
         return response
@@ -74,6 +86,10 @@ class AclOverrides(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        official_payload_list = ['code', 'acl_override']
+        payload.get('code'), payload.get('acl_override')
+        warning_wrong_parameters(self.acl_overrides_put.__name__, payload,
+            official_payload_list)
         response = self.execute('PUT', path=f'/acl_overrides/{uuid}',
             payload=payload, **kwargs)
         return response
@@ -110,6 +126,11 @@ class AclOverrides(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        official_params_list = ['skip', 'limit', 'like', 'join', 'count']
+        params.get('skip'), params.get('limit'), params.get('like'
+            ), params.get('join'), params.get('count')
+        warning_wrong_parameters(self.acl_overrides_users.__name__, params,
+            official_params_list)
         response = self.execute('GET', path=f'/acl_overrides/{uuid}/users',
             single_page=single_page, page_size=page_size, warm_start=
             warm_start, params=params, **kwargs)

hive/cookbook/analytics.py

@@ -1,4 +1,4 @@
-from hive.api import ApiManager, handling_single_page_methods
+from hive.api import ApiManager, handling_single_page_methods, warning_wrong_parameters
 
 
 class Analytics(ApiManager):
@@ -30,6 +30,16 @@ class Analytics(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        official_params_list = ['sort_by', 'null_fields', 'date_start',
+            'date_end', 'metric_profile', 'metric_name', 'skip', 'limit',
+            'like', 'join', 'count']
+        params.get('sort_by'), params.get('null_fields'), params.get(
+            'date_start'), params.get('date_end'), params.get('metric_profile'
+            ), params.get('metric_name'), params.get('skip'), params.get(
+            'limit'), params.get('like'), params.get('join'), params.get(
+            'count')
+        warning_wrong_parameters(self.analytic.__name__, params,
+            official_params_list)
         response = self.execute('GET', path=f'/analytics/{uuid_customer}',
             single_page=single_page, page_size=page_size, warm_start=
             warm_start, params=params, **kwargs)

hive/cookbook/anomalies.py

@@ -1,4 +1,4 @@
-from hive.api import ApiManager, handling_single_page_methods
+from hive.api import ApiManager, handling_single_page_methods, warning_wrong_parameters
 
 
 class Anomalies(ApiManager):
@@ -30,6 +30,16 @@ class Anomalies(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        official_params_list = ['sort_by', 'null_fields', 'date_start',
+            'date_end', 'uuid_customer', 'type', 'value', 'sampling',
+            'skip', 'limit', 'like', 'join', 'count']
+        params.get('sort_by'), params.get('null_fields'), params.get(
+            'date_start'), params.get('date_end'), params.get('uuid_customer'
+            ), params.get('type'), params.get('value'), params.get('sampling'
+            ), params.get('skip'), params.get('limit'), params.get('like'
+            ), params.get('join'), params.get('count')
+        warning_wrong_parameters(self.anomalies.__name__, params,
+            official_params_list)
         response = self.execute('GET', path=f'/anomalies/', single_page=
             single_page, page_size=page_size, warm_start=warm_start, params
             =params, **kwargs)
@@ -51,6 +61,13 @@ class Anomalies(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        official_payload_list = ['date_anomaly_start', 'date_anomaly',
+            'uuid_customer', 'type', 'value', 'sampling', 'parameters']
+        payload.get('date_anomaly_start'), payload.get('date_anomaly'
+            ), payload.get('uuid_customer'), payload.get('type'), payload.get(
+            'value'), payload.get('sampling'), payload.get('parameters')
+        warning_wrong_parameters(self.anomalies_create.__name__, payload,
+            official_payload_list)
         response = self.execute('POST', path=f'/anomalies/', payload=
             payload, **kwargs)
         return response
@@ -70,6 +87,10 @@ class Anomalies(ApiManager):
             kwargs = dict()
         kwargs, params = handling_single_page_methods(kwargs=kwargs, params
             =params)
+        official_params_list = ['join']
+        params.get('join')
+        warning_wrong_parameters(self.anomalie.__name__, params,
+            official_params_list)
         response = self.execute('GET', path=f'/anomalies/{uuid}',
             warm_start=warm_start, params=params, **kwargs)
         return response
@@ -109,6 +130,10 @@ class Anomalies(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        official_params_list = ['join']
+        params.get('join')
+        warning_wrong_parameters(self.anomalies_bulk.__name__, params,
+            official_params_list)
         response = self.execute('POST', path=f'/anomalies/bulk/read/',
             single_page=single_page, page_size=page_size, warm_start=
             warm_start, params=params, payload=payload, **kwargs)
@@ -144,6 +169,10 @@ class Anomalies(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        official_params_list = ['best_effort']
+        params.get('best_effort')
+        warning_wrong_parameters(self.anomalies_create_bulk.__name__,
+            params, official_params_list)
         response = self.execute('POST', path=f'/anomalies/bulk/create/',
             single_page=single_page, page_size=page_size, params=params,
             payload=payload, **kwargs)

hive/cookbook/calendars.py

@@ -1,4 +1,4 @@
-from hive.api import ApiManager, handling_single_page_methods
+from hive.api import ApiManager, handling_single_page_methods, warning_wrong_parameters
 
 
 class Calendars(ApiManager):
@@ -54,6 +54,38 @@ class Calendars(ApiManager):
         Returns: list"""
         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']
+        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')
+        warning_wrong_parameters(self.calendars.__name__, params,
+            official_params_list)
         response = self.execute('GET', path=f'/calendars/', single_page=
             single_page, page_size=page_size, warm_start=warm_start, params
             =params, **kwargs)
@@ -98,6 +130,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')
+        warning_wrong_parameters(self.calendars_create.__name__, payload,
+            official_payload_list)
         response = self.execute('POST', path=f'/calendars/', payload=
             payload, **kwargs)
         return response
@@ -156,6 +215,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')
+        warning_wrong_parameters(self.calendars_put.__name__, payload,
+            official_payload_list)
         response = self.execute('PUT', path=f'/calendars/{uuid}', payload=
             payload, **kwargs)
         return response
@@ -195,6 +281,10 @@ class Calendars(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        official_params_list = ['join']
+        params.get('join')
+        warning_wrong_parameters(self.calendars_bulk.__name__, params,
+            official_params_list)
         response = self.execute('POST', path=f'/calendars/bulk/read/',
             single_page=single_page, page_size=page_size, warm_start=
             warm_start, params=params, payload=payload, **kwargs)
@@ -253,6 +343,10 @@ class Calendars(ApiManager):
         Returns: list"""
         if kwargs is None:
             kwargs = dict()
+        official_params_list = ['best_effort']
+        params.get('best_effort')
+        warning_wrong_parameters(self.calendars_create_bulk.__name__,
+            params, official_params_list)
         response = self.execute('POST', path=f'/calendars/bulk/create/',
             single_page=single_page, page_size=page_size, params=params,
             payload=payload, **kwargs)