feat: add warning about availability only on the InfluxDB Cloud

Author: bednar

influxdb_client/client/warnings.py

@@ -29,3 +29,25 @@ def print_warning(query: str):
     - https://docs.influxdata.com/flux/latest/stdlib/influxdata/influxdb/schema/fieldsascols/
 """
         warnings.warn(message, MissingPivotFunction)
+
+
+class CloudOnlyWarning(UserWarning):
+    """User warning about availability only on the InfluxDB Cloud."""
+
+    @staticmethod
+    def print_warning(api_name: str, doc_url: str):
+        """Print warning about availability only on the InfluxDB Cloud."""
+
+        message = f"""The '{api_name}' API is available only on the InfluxDB Cloud.
+
+For more info see:
+    - {doc_url}
+    - https://docs.influxdata.com/influxdb/cloud/
+
+You can disable this warning by:
+    import warnings
+    from influxdb_client.client.warnings import CloudOnlyWarning
+
+    warnings.simplefilter("ignore", CloudOnlyWarning)
+"""
+        warnings.warn(message, CloudOnlyWarning)

influxdb_client/service/bucket_schemas_service.py

@@ -31,6 +31,10 @@ def __init__(self, api_client=None):  # noqa: E501,D401,D403
             raise ValueError("Invalid value for `api_client`, must be defined.")
         self.api_client = api_client
 
+        from influxdb_client.client.warnings import CloudOnlyWarning
+        CloudOnlyWarning.print_warning('BucketSchemasService',
+                                       'https://docs.influxdata.com/influxdb/cloud/organizations/buckets/bucket-schema/')
+
     def create_measurement_schema(self, bucket_id, **kwargs):  # noqa: E501,D401,D403
         """Create a measurement schema for a bucket.
 

influxdb_client/service/invokable_scripts_service.py

@@ -31,6 +31,10 @@ def __init__(self, api_client=None):  # noqa: E501,D401,D403
             raise ValueError("Invalid value for `api_client`, must be defined.")
         self.api_client = api_client
 
+        from influxdb_client.client.warnings import CloudOnlyWarning
+        CloudOnlyWarning.print_warning('InvokableScriptsService',
+                                       'https://docs.influxdata.com/influxdb/cloud/api-guide/api-invokable-scripts/')
+
     def delete_scripts_id(self, script_id, **kwargs):  # noqa: E501,D401,D403
         """Delete a script.