databricks-sdk 0.69.0__py3-none-any.whl → 0.71.0__py3-none-any.whl

databricks/sdk/service/jobs.py

@@ -449,42 +449,6 @@ class BaseRun:
         )
 
 
-@dataclass
-class CancelAllRunsResponse:
-    def as_dict(self) -> dict:
-        """Serializes the CancelAllRunsResponse into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the CancelAllRunsResponse into a shallow dictionary of its immediate attributes."""
-        body = {}
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> CancelAllRunsResponse:
-        """Deserializes the CancelAllRunsResponse from a dictionary."""
-        return cls()
-
-
-@dataclass
-class CancelRunResponse:
-    def as_dict(self) -> dict:
-        """Serializes the CancelRunResponse into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the CancelRunResponse into a shallow dictionary of its immediate attributes."""
-        body = {}
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> CancelRunResponse:
-        """Deserializes the CancelRunResponse from a dictionary."""
-        return cls()
-
-
 class CleanRoomTaskRunLifeCycleState(Enum):
     """Copied from elastic-spark-common/api/messages/runs.proto. Using the original definition to
     remove coupling with jobs API definition"""
@@ -561,6 +525,9 @@ class CleanRoomTaskRunState:
 
 @dataclass
 class CleanRoomsNotebookTask:
+    """Clean Rooms notebook task for V1 Clean Room service (GA). Replaces the deprecated
+    CleanRoomNotebookTask (defined above) which was for V0 service."""
+
     clean_room_name: str
     """The clean room that the notebook belongs to."""
 
@@ -1512,42 +1479,6 @@ class DbtTask:
         )
 
 
-@dataclass
-class DeleteResponse:
-    def as_dict(self) -> dict:
-        """Serializes the DeleteResponse into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the DeleteResponse into a shallow dictionary of its immediate attributes."""
-        body = {}
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> DeleteResponse:
-        """Deserializes the DeleteResponse from a dictionary."""
-        return cls()
-
-
-@dataclass
-class DeleteRunResponse:
-    def as_dict(self) -> dict:
-        """Serializes the DeleteRunResponse into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the DeleteRunResponse into a shallow dictionary of its immediate attributes."""
-        body = {}
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> DeleteRunResponse:
-        """Deserializes the DeleteRunResponse from a dictionary."""
-        return cls()
-
-
 @dataclass
 class EnforcePolicyComplianceForJobResponseJobClusterSettingsChange:
     """Represents a change to the job cluster's settings that would be required for the job clusters to
@@ -4209,24 +4140,6 @@ class RepairRunResponse:
         return cls(repair_id=d.get("repair_id", None))
 
 
-@dataclass
-class ResetResponse:
-    def as_dict(self) -> dict:
-        """Serializes the ResetResponse into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the ResetResponse into a shallow dictionary of its immediate attributes."""
-        body = {}
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> ResetResponse:
-        """Deserializes the ResetResponse from a dictionary."""
-        return cls()
-
-
 @dataclass
 class ResolvedConditionTaskValues:
     left: Optional[str] = None
@@ -5016,7 +4929,11 @@ class RunJobTask:
 
     dbt_commands: Optional[List[str]] = None
     """An array of commands to execute for jobs with the dbt task, for example `"dbt_commands": ["dbt
-    deps", "dbt seed", "dbt deps", "dbt seed", "dbt run"]`"""
+    deps", "dbt seed", "dbt deps", "dbt seed", "dbt run"]`
+    
+    ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
+    
+    [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown"""
 
     jar_params: Optional[List[str]] = None
     """A list of parameters for jobs with Spark JAR tasks, for example `"jar_params": ["john doe",
@@ -5025,9 +4942,9 @@ class RunJobTask:
     be specified in conjunction with notebook_params. The JSON representation of this field (for
     example `{"jar_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown"""
 
     job_parameters: Optional[Dict[str, str]] = None
     """Job-level parameters used to trigger the job."""
@@ -5041,13 +4958,13 @@ class RunJobTask:
     
     notebook_params cannot be specified in conjunction with jar_params.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
     
     The JSON representation of this field (for example `{"notebook_params":{"name":"john
     doe","age":"35"}}`) cannot exceed 10,000 bytes.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
-    [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html"""
+    [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html
+    [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown"""
 
     pipeline_params: Optional[PipelineParams] = None
     """Controls whether the pipeline should perform a full refresh"""
@@ -5060,7 +4977,7 @@ class RunJobTask:
     `run-now`, it would overwrite the parameters specified in job setting. The JSON representation
     of this field (for example `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
     
     Important
     
@@ -5068,7 +4985,7 @@ class RunJobTask:
     returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
     emojis.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown"""
 
     spark_submit_params: Optional[List[str]] = None
     """A list of parameters for jobs with spark submit task, for example `"spark_submit_params":
@@ -5077,7 +4994,7 @@ class RunJobTask:
     parameters specified in job setting. The JSON representation of this field (for example
     `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables] to set parameters containing information about job runs
+    ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
     
     Important
     
@@ -5085,11 +5002,15 @@ class RunJobTask:
     returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
     emojis.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown"""
 
     sql_params: Optional[Dict[str, str]] = None
     """A map from keys to values for jobs with SQL task, for example `"sql_params": {"name": "john
-    doe", "age": "35"}`. The SQL alert task does not support custom parameters."""
+    doe", "age": "35"}`. The SQL alert task does not support custom parameters.
+    
+    ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
+    
+    [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown"""
 
     def as_dict(self) -> dict:
         """Serializes the RunJobTask into a dictionary suitable for use as a JSON request body."""
@@ -5377,7 +5298,11 @@ class RunOutput:
 class RunParameters:
     dbt_commands: Optional[List[str]] = None
     """An array of commands to execute for jobs with the dbt task, for example `"dbt_commands": ["dbt
-    deps", "dbt seed", "dbt deps", "dbt seed", "dbt run"]`"""
+    deps", "dbt seed", "dbt deps", "dbt seed", "dbt run"]`
+    
+    ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
+    
+    [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown"""
 
     jar_params: Optional[List[str]] = None
     """A list of parameters for jobs with Spark JAR tasks, for example `"jar_params": ["john doe",
@@ -5386,9 +5311,9 @@ class RunParameters:
     be specified in conjunction with notebook_params. The JSON representation of this field (for
     example `{"jar_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown"""
 
     notebook_params: Optional[Dict[str, str]] = None
     """A map from keys to values for jobs with notebook task, for example `"notebook_params": {"name":
@@ -5399,13 +5324,13 @@ class RunParameters:
     
     notebook_params cannot be specified in conjunction with jar_params.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
     
     The JSON representation of this field (for example `{"notebook_params":{"name":"john
     doe","age":"35"}}`) cannot exceed 10,000 bytes.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
-    [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html"""
+    [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html
+    [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown"""
 
     pipeline_params: Optional[PipelineParams] = None
     """Controls whether the pipeline should perform a full refresh"""
@@ -5418,7 +5343,7 @@ class RunParameters:
     `run-now`, it would overwrite the parameters specified in job setting. The JSON representation
     of this field (for example `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables] to set parameters containing information about job runs.
+    ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
     
     Important
     
@@ -5426,7 +5351,7 @@ class RunParameters:
     returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
     emojis.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown"""
 
     spark_submit_params: Optional[List[str]] = None
     """A list of parameters for jobs with spark submit task, for example `"spark_submit_params":
@@ -5435,7 +5360,7 @@ class RunParameters:
     parameters specified in job setting. The JSON representation of this field (for example
     `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
     
-    Use [Task parameter variables] to set parameters containing information about job runs
+    ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
     
     Important
     
@@ -5443,11 +5368,15 @@ class RunParameters:
     returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
     emojis.
     
-    [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables"""
+    [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown"""
 
     sql_params: Optional[Dict[str, str]] = None
     """A map from keys to values for jobs with SQL task, for example `"sql_params": {"name": "john
-    doe", "age": "35"}`. The SQL alert task does not support custom parameters."""
+    doe", "age": "35"}`. The SQL alert task does not support custom parameters.
+    
+    ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
+    
+    [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown"""
 
     def as_dict(self) -> dict:
         """Serializes the RunParameters into a dictionary suitable for use as a JSON request body."""
@@ -8037,9 +7966,6 @@ class TriggerSettings:
     periodic: Optional[PeriodicTriggerConfiguration] = None
     """Periodic trigger settings."""
 
-    table: Optional[TableUpdateTriggerConfiguration] = None
-    """Old table trigger settings name. Deprecated in favor of `table_update`."""
-
     table_update: Optional[TableUpdateTriggerConfiguration] = None
 
     def as_dict(self) -> dict:
@@ -8051,8 +7977,6 @@ class TriggerSettings:
             body["pause_status"] = self.pause_status.value
         if self.periodic:
             body["periodic"] = self.periodic.as_dict()
-        if self.table:
-            body["table"] = self.table.as_dict()
         if self.table_update:
             body["table_update"] = self.table_update.as_dict()
         return body
@@ -8066,8 +7990,6 @@ class TriggerSettings:
             body["pause_status"] = self.pause_status
         if self.periodic:
             body["periodic"] = self.periodic
-        if self.table:
-            body["table"] = self.table
         if self.table_update:
             body["table_update"] = self.table_update
         return body
@@ -8079,7 +8001,6 @@ class TriggerSettings:
             file_arrival=_from_dict(d, "file_arrival", FileArrivalTriggerConfiguration),
             pause_status=_enum(d, "pause_status", PauseStatus),
             periodic=_from_dict(d, "periodic", PeriodicTriggerConfiguration),
-            table=_from_dict(d, "table", TableUpdateTriggerConfiguration),
             table_update=_from_dict(d, "table_update", TableUpdateTriggerConfiguration),
         )
 
@@ -8140,24 +8061,6 @@ class TriggerType(Enum):
     TABLE = "TABLE"
 
 
-@dataclass
-class UpdateResponse:
-    def as_dict(self) -> dict:
-        """Serializes the UpdateResponse into a dictionary suitable for use as a JSON request body."""
-        body = {}
-        return body
-
-    def as_shallow_dict(self) -> dict:
-        """Serializes the UpdateResponse into a shallow dictionary of its immediate attributes."""
-        body = {}
-        return body
-
-    @classmethod
-    def from_dict(cls, d: Dict[str, Any]) -> UpdateResponse:
-        """Deserializes the UpdateResponse from a dictionary."""
-        return cls()
-
-
 @dataclass
 class ViewItem:
     content: Optional[str] = None
@@ -8399,6 +8302,7 @@ class JobsAPI:
 
 
         """
+
         body = {}
         if all_queued_runs is not None:
             body["all_queued_runs"] = all_queued_runs
@@ -8421,6 +8325,7 @@ class JobsAPI:
           Long-running operation waiter for :class:`Run`.
           See :method:wait_get_run_job_terminated_or_skipped for more details.
         """
+
         body = {}
         if run_id is not None:
             body["run_id"] = run_id
@@ -8565,6 +8470,7 @@ class JobsAPI:
 
         :returns: :class:`CreateResponse`
         """
+
         body = {}
         if access_control_list is not None:
             body["access_control_list"] = [v.as_dict() for v in access_control_list]
@@ -8634,6 +8540,7 @@ class JobsAPI:
 
 
         """
+
         body = {}
         if job_id is not None:
             body["job_id"] = job_id
@@ -8651,6 +8558,7 @@ class JobsAPI:
 
 
         """
+
         body = {}
         if run_id is not None:
             body["run_id"] = run_id
@@ -8981,6 +8889,10 @@ class JobsAPI:
         :param dbt_commands: List[str] (optional)
           An array of commands to execute for jobs with the dbt task, for example `"dbt_commands": ["dbt
           deps", "dbt seed", "dbt deps", "dbt seed", "dbt run"]`
+
+          ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
+
+          [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown
         :param jar_params: List[str] (optional)
           A list of parameters for jobs with Spark JAR tasks, for example `"jar_params": ["john doe", "35"]`.
           The parameters are used to invoke the main function of the main class specified in the Spark JAR
@@ -8988,9 +8900,9 @@ class JobsAPI:
           in conjunction with notebook_params. The JSON representation of this field (for example
           `{"jar_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
 
-          Use [Task parameter variables] to set parameters containing information about job runs.
+          ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
 
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
+          [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown
         :param job_parameters: Dict[str,str] (optional)
           Job-level parameters used in the run. for example `"param": "overriding_val"`
         :param latest_repair_id: int (optional)
@@ -9005,13 +8917,13 @@ class JobsAPI:
 
           notebook_params cannot be specified in conjunction with jar_params.
 
-          Use [Task parameter variables] to set parameters containing information about job runs.
+          ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
 
           The JSON representation of this field (for example `{"notebook_params":{"name":"john
           doe","age":"35"}}`) cannot exceed 10,000 bytes.
 
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
           [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html
+          [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown
         :param performance_target: :class:`PerformanceTarget` (optional)
           The performance mode on a serverless job. The performance target determines the level of compute
           performance or cost-efficiency for the run. This field overrides the performance target defined on
@@ -9029,7 +8941,7 @@ class JobsAPI:
           would overwrite the parameters specified in job setting. The JSON representation of this field (for
           example `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
 
-          Use [Task parameter variables] to set parameters containing information about job runs.
+          ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
 
           Important
 
@@ -9037,7 +8949,7 @@ class JobsAPI:
           returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
           emojis.
 
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
+          [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown
         :param rerun_all_failed_tasks: bool (optional)
           If true, repair all failed tasks. Only one of `rerun_tasks` or `rerun_all_failed_tasks` can be used.
         :param rerun_dependent_tasks: bool (optional)
@@ -9052,7 +8964,7 @@ class JobsAPI:
           in job setting. The JSON representation of this field (for example `{"python_params":["john
           doe","35"]}`) cannot exceed 10,000 bytes.
 
-          Use [Task parameter variables] to set parameters containing information about job runs
+          ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
 
           Important
 
@@ -9060,15 +8972,20 @@ class JobsAPI:
           returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
           emojis.
 
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
+          [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown
         :param sql_params: Dict[str,str] (optional)
           A map from keys to values for jobs with SQL task, for example `"sql_params": {"name": "john doe",
           "age": "35"}`. The SQL alert task does not support custom parameters.
 
+          ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
+
+          [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown
+
         :returns:
           Long-running operation waiter for :class:`Run`.
           See :method:wait_get_run_job_terminated_or_skipped for more details.
         """
+
         body = {}
         if dbt_commands is not None:
             body["dbt_commands"] = [v for v in dbt_commands]
@@ -9164,6 +9081,7 @@ class JobsAPI:
 
 
         """
+
         body = {}
         if job_id is not None:
             body["job_id"] = job_id
@@ -9200,6 +9118,10 @@ class JobsAPI:
         :param dbt_commands: List[str] (optional)
           An array of commands to execute for jobs with the dbt task, for example `"dbt_commands": ["dbt
           deps", "dbt seed", "dbt deps", "dbt seed", "dbt run"]`
+
+          ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
+
+          [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown
         :param idempotency_token: str (optional)
           An optional token to guarantee the idempotency of job run requests. If a run with the provided token
           already exists, the request does not create a new run but returns the ID of the existing run
@@ -9220,9 +9142,9 @@ class JobsAPI:
           in conjunction with notebook_params. The JSON representation of this field (for example
           `{"jar_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
 
-          Use [Task parameter variables] to set parameters containing information about job runs.
+          ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
 
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
+          [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown
         :param job_parameters: Dict[str,str] (optional)
           Job-level parameters used in the run. for example `"param": "overriding_val"`
         :param notebook_params: Dict[str,str] (optional)
@@ -9234,13 +9156,13 @@ class JobsAPI:
 
           notebook_params cannot be specified in conjunction with jar_params.
 
-          Use [Task parameter variables] to set parameters containing information about job runs.
+          ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
 
           The JSON representation of this field (for example `{"notebook_params":{"name":"john
           doe","age":"35"}}`) cannot exceed 10,000 bytes.
 
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
           [dbutils.widgets.get]: https://docs.databricks.com/dev-tools/databricks-utils.html
+          [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown
         :param only: List[str] (optional)
           A list of task keys to run inside of the job. If this field is not provided, all tasks in the job
           will be run.
@@ -9261,7 +9183,7 @@ class JobsAPI:
           would overwrite the parameters specified in job setting. The JSON representation of this field (for
           example `{"python_params":["john doe","35"]}`) cannot exceed 10,000 bytes.
 
-          Use [Task parameter variables] to set parameters containing information about job runs.
+          ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
 
           Important
 
@@ -9269,7 +9191,7 @@ class JobsAPI:
           returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
           emojis.
 
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
+          [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown
         :param queue: :class:`QueueSettings` (optional)
           The queue settings of the run.
         :param spark_submit_params: List[str] (optional)
@@ -9279,7 +9201,7 @@ class JobsAPI:
           in job setting. The JSON representation of this field (for example `{"python_params":["john
           doe","35"]}`) cannot exceed 10,000 bytes.
 
-          Use [Task parameter variables] to set parameters containing information about job runs
+          ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
 
           Important
 
@@ -9287,15 +9209,20 @@ class JobsAPI:
           returns an error. Examples of invalid, non-ASCII characters are Chinese, Japanese kanjis, and
           emojis.
 
-          [Task parameter variables]: https://docs.databricks.com/jobs.html#parameter-variables
+          [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown
         :param sql_params: Dict[str,str] (optional)
           A map from keys to values for jobs with SQL task, for example `"sql_params": {"name": "john doe",
           "age": "35"}`. The SQL alert task does not support custom parameters.
 
+          ⚠ **Deprecation note** Use [job parameters] to pass information down to tasks.
+
+          [job parameters]: https://docs.databricks.com/jobs/job-parameters.html#job-parameter-pushdown
+
         :returns:
           Long-running operation waiter for :class:`Run`.
           See :method:wait_get_run_job_terminated_or_skipped for more details.
         """
+
         body = {}
         if dbt_commands is not None:
             body["dbt_commands"] = [v for v in dbt_commands]
@@ -9385,6 +9312,7 @@ class JobsAPI:
 
         :returns: :class:`JobPermissions`
         """
+
         body = {}
         if access_control_list is not None:
             body["access_control_list"] = [v.as_dict() for v in access_control_list]
@@ -9474,6 +9402,7 @@ class JobsAPI:
           Long-running operation waiter for :class:`Run`.
           See :method:wait_get_run_job_terminated_or_skipped for more details.
         """
+
         body = {}
         if access_control_list is not None:
             body["access_control_list"] = [v.as_dict() for v in access_control_list]
@@ -9580,6 +9509,7 @@ class JobsAPI:
 
 
         """
+
         body = {}
         if fields_to_remove is not None:
             body["fields_to_remove"] = [v for v in fields_to_remove]
@@ -9604,6 +9534,7 @@ class JobsAPI:
 
         :returns: :class:`JobPermissions`
         """
+
         body = {}
         if access_control_list is not None:
             body["access_control_list"] = [v.as_dict() for v in access_control_list]
@@ -9645,6 +9576,7 @@ class PolicyComplianceForJobsAPI:
 
         :returns: :class:`EnforcePolicyComplianceResponse`
         """
+
         body = {}
         if job_id is not None:
             body["job_id"] = job_id