Docs: clarify that budget might be ignored when creating job

ref: Open-EO/openeo-api#541

Author: soxofaan

openeo/rest/connection.py

@@ -1714,8 +1714,9 @@ def create_job(
             or as local file path or URL
         :param title: job title
         :param description: job description
-        :param plan: billing plan
-        :param budget: maximum cost the request is allowed to produce
+        :param plan: The billing plan to process and charge the job with
+        :param budget: Maximum budget to be spent on executing the job.
+            Note that some backends do not honor this limit.
         :param additional: additional job options to pass to the backend
         :param validate: Optional toggle to enable/prevent validation of the process graphs before execution
             (overruling the connection's ``auto_validate`` setting).

openeo/rest/datacube.py

@@ -2268,8 +2268,9 @@ def create_job(
         :param out_format: output file format.
         :param title: job title
         :param description: job description
-        :param plan: billing plan
-        :param budget: maximum cost the request is allowed to produce
+        :param plan: The billing plan to process and charge the job with
+        :param budget: Maximum budget to be spent on executing the job.
+            Note that some backends do not honor this limit.
         :param job_options: custom job options.
         :param validate: Optional toggle to enable/prevent validation of the process graphs before execution
             (overruling the connection's ``auto_validate`` setting).

openeo/rest/mlmodel.py

@@ -96,8 +96,9 @@ def create_job(
 
         :param title: job title
         :param description: job description
-        :param plan: billing plan
-        :param budget: maximum cost the request is allowed to produce
+        :param plan: The billing plan to process and charge the job with
+        :param budget: Maximum budget to be spent on executing the job.
+            Note that some backends do not honor this limit.
         :param job_options: A dictionary containing (custom) job options
         :param format_options: String Parameters for the job result format
         :return: Created job.

openeo/rest/vectorcube.py

@@ -320,8 +320,9 @@ def create_job(
         :param out_format: String Format of the job result.
         :param title: job title
         :param description: job description
-        :param plan: billing plan
-        :param budget: maximum cost the request is allowed to produce
+        :param plan: The billing plan to process and charge the job with
+        :param budget: Maximum budget to be spent on executing the job.
+            Note that some backends do not honor this limit.
         :param job_options: A dictionary containing (custom) job options
         :param format_options: String Parameters for the job result format
         :param validate: Optional toggle to enable/prevent validation of the process graphs before execution