databricks-sdk 0.56.0__py3-none-any.whl → 0.58.0__py3-none-any.whl

databricks/sdk/service/jobs.py

@@ -219,11 +219,6 @@ class BaseRun:
     """The URL to the detail page of the run."""
 
     run_type: Optional[RunType] = None
-    """The type of a run. * `JOB_RUN`: Normal job run. A run created with :method:jobs/runNow. *
-    `WORKFLOW_RUN`: Workflow run. A run created with [dbutils.notebook.run]. * `SUBMIT_RUN`: Submit
-    run. A run created with :method:jobs/submit.
-    
-    [dbutils.notebook.run]: https://docs.databricks.com/dev-tools/databricks-utils.html#dbutils-workflow"""
 
     schedule: Optional[CronSchedule] = None
     """The cron schedule that triggered this run if it was triggered by the periodic scheduler."""
@@ -244,7 +239,6 @@ class BaseRun:
     """Deprecated. Please use the `status` field instead."""
 
     status: Optional[RunStatus] = None
-    """The current status of the run"""
 
     tasks: Optional[List[RunTask]] = None
     """The list of tasks performed by the run. Each task has its own `run_id` which you can use to call
@@ -253,19 +247,8 @@ class BaseRun:
     root to determine if more results are available."""
 
     trigger: Optional[TriggerType] = None
-    """The type of trigger that fired this run.
-    
-    * `PERIODIC`: Schedules that periodically trigger runs, such as a cron scheduler. * `ONE_TIME`:
-    One time triggers that fire a single run. This occurs you triggered a single run on demand
-    through the UI or the API. * `RETRY`: Indicates a run that is triggered as a retry of a
-    previously failed run. This occurs when you request to re-run the job in case of failures. *
-    `RUN_JOB_TASK`: Indicates a run that is triggered using a Run Job task. * `FILE_ARRIVAL`:
-    Indicates a run that is triggered by a file arrival. * `TABLE`: Indicates a run that is
-    triggered by a table update. * `CONTINUOUS_RESTART`: Indicates a run created by user to manually
-    restart a continuous job run."""
 
     trigger_info: Optional[TriggerInfo] = None
-    """Additional details about what triggered the run"""
 
     def as_dict(self) -> dict:
         """Serializes the BaseRun into a dictionary suitable for use as a JSON request body."""
@@ -1004,7 +987,6 @@ class CreateJob:
     are used, `git_source` must be defined on the job."""
 
     health: Optional[JobsHealthRules] = None
-    """An optional set of health rules that can be defined for this job."""
 
     job_clusters: Optional[List[JobCluster]] = None
     """A list of job cluster specifications that can be shared and reused by tasks of this job.
@@ -1043,10 +1025,6 @@ class CreateJob:
     """The queue settings of the job."""
 
     run_as: Optional[JobRunAs] = None
-    """Write-only setting. Specifies the user or service principal that the job runs as. If not
-    specified, the job runs as the user who created the job.
-    
-    Either `user_name` or `service_principal_name` should be specified. If not, an error is thrown."""
 
     schedule: Optional[CronSchedule] = None
     """An optional periodic schedule for this job. The default behavior is that the job only runs when
@@ -1399,7 +1377,8 @@ class DashboardTaskOutput:
 
 @dataclass
 class DbtCloudJobRunStep:
-    """Format of response retrieved from dbt Cloud, for inclusion in output"""
+    """Format of response retrieved from dbt Cloud, for inclusion in output Deprecated in favor of
+    DbtPlatformJobRunStep"""
 
     index: Optional[int] = None
     """Orders the steps in the job"""
@@ -1410,7 +1389,7 @@ class DbtCloudJobRunStep:
     name: Optional[str] = None
     """Name of the step in the job"""
 
-    status: Optional[DbtCloudRunStatus] = None
+    status: Optional[DbtPlatformRunStatus] = None
     """State of the step"""
 
     def as_dict(self) -> dict:
@@ -1446,23 +1425,14 @@ class DbtCloudJobRunStep:
             index=d.get("index", None),
             logs=d.get("logs", None),
             name=d.get("name", None),
-            status=_enum(d, "status", DbtCloudRunStatus),
+            status=_enum(d, "status", DbtPlatformRunStatus),
         )
 
 
-class DbtCloudRunStatus(Enum):
-    """Response enumeration from calling the dbt Cloud API, for inclusion in output"""
-
-    CANCELLED = "CANCELLED"
-    ERROR = "ERROR"
-    QUEUED = "QUEUED"
-    RUNNING = "RUNNING"
-    STARTING = "STARTING"
-    SUCCESS = "SUCCESS"
-
-
 @dataclass
 class DbtCloudTask:
+    """Deprecated in favor of DbtPlatformTask"""
+
     connection_resource_name: Optional[str] = None
     """The resource name of the UC connection that authenticates the dbt Cloud for this task"""
 
@@ -1498,6 +1468,8 @@ class DbtCloudTask:
 
 @dataclass
 class DbtCloudTaskOutput:
+    """Deprecated in favor of DbtPlatformTaskOutput"""
+
     dbt_cloud_job_run_id: Optional[int] = None
     """Id of the job run in dbt Cloud"""
 
@@ -1572,6 +1544,176 @@ class DbtOutput:
         return cls(artifacts_headers=d.get("artifacts_headers", None), artifacts_link=d.get("artifacts_link", None))
 
 
+@dataclass
+class DbtPlatformJobRunStep:
+    """Format of response retrieved from dbt platform, for inclusion in output"""
+
+    index: Optional[int] = None
+    """Orders the steps in the job"""
+
+    logs: Optional[str] = None
+    """Output of the step"""
+
+    logs_truncated: Optional[bool] = None
+    """Whether the logs of this step have been truncated. If true, the logs has been truncated to 10000
+    characters."""
+
+    name: Optional[str] = None
+    """Name of the step in the job"""
+
+    name_truncated: Optional[bool] = None
+    """Whether the name of the job has been truncated. If true, the name has been truncated to 100
+    characters."""
+
+    status: Optional[DbtPlatformRunStatus] = None
+    """State of the step"""
+
+    def as_dict(self) -> dict:
+        """Serializes the DbtPlatformJobRunStep into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.index is not None:
+            body["index"] = self.index
+        if self.logs is not None:
+            body["logs"] = self.logs
+        if self.logs_truncated is not None:
+            body["logs_truncated"] = self.logs_truncated
+        if self.name is not None:
+            body["name"] = self.name
+        if self.name_truncated is not None:
+            body["name_truncated"] = self.name_truncated
+        if self.status is not None:
+            body["status"] = self.status.value
+        return body
+
+    def as_shallow_dict(self) -> dict:
+        """Serializes the DbtPlatformJobRunStep into a shallow dictionary of its immediate attributes."""
+        body = {}
+        if self.index is not None:
+            body["index"] = self.index
+        if self.logs is not None:
+            body["logs"] = self.logs
+        if self.logs_truncated is not None:
+            body["logs_truncated"] = self.logs_truncated
+        if self.name is not None:
+            body["name"] = self.name
+        if self.name_truncated is not None:
+            body["name_truncated"] = self.name_truncated
+        if self.status is not None:
+            body["status"] = self.status
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, Any]) -> DbtPlatformJobRunStep:
+        """Deserializes the DbtPlatformJobRunStep from a dictionary."""
+        return cls(
+            index=d.get("index", None),
+            logs=d.get("logs", None),
+            logs_truncated=d.get("logs_truncated", None),
+            name=d.get("name", None),
+            name_truncated=d.get("name_truncated", None),
+            status=_enum(d, "status", DbtPlatformRunStatus),
+        )
+
+
+class DbtPlatformRunStatus(Enum):
+    """Response enumeration from calling the dbt platform API, for inclusion in output"""
+
+    CANCELLED = "CANCELLED"
+    ERROR = "ERROR"
+    QUEUED = "QUEUED"
+    RUNNING = "RUNNING"
+    STARTING = "STARTING"
+    SUCCESS = "SUCCESS"
+
+
+@dataclass
+class DbtPlatformTask:
+    connection_resource_name: Optional[str] = None
+    """The resource name of the UC connection that authenticates the dbt platform for this task"""
+
+    dbt_platform_job_id: Optional[str] = None
+    """Id of the dbt platform job to be triggered. Specified as a string for maximum compatibility with
+    clients."""
+
+    def as_dict(self) -> dict:
+        """Serializes the DbtPlatformTask into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.connection_resource_name is not None:
+            body["connection_resource_name"] = self.connection_resource_name
+        if self.dbt_platform_job_id is not None:
+            body["dbt_platform_job_id"] = self.dbt_platform_job_id
+        return body
+
+    def as_shallow_dict(self) -> dict:
+        """Serializes the DbtPlatformTask into a shallow dictionary of its immediate attributes."""
+        body = {}
+        if self.connection_resource_name is not None:
+            body["connection_resource_name"] = self.connection_resource_name
+        if self.dbt_platform_job_id is not None:
+            body["dbt_platform_job_id"] = self.dbt_platform_job_id
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, Any]) -> DbtPlatformTask:
+        """Deserializes the DbtPlatformTask from a dictionary."""
+        return cls(
+            connection_resource_name=d.get("connection_resource_name", None),
+            dbt_platform_job_id=d.get("dbt_platform_job_id", None),
+        )
+
+
+@dataclass
+class DbtPlatformTaskOutput:
+    dbt_platform_job_run_id: Optional[str] = None
+    """Id of the job run in dbt platform. Specified as a string for maximum compatibility with clients."""
+
+    dbt_platform_job_run_output: Optional[List[DbtPlatformJobRunStep]] = None
+    """Steps of the job run as received from dbt platform"""
+
+    dbt_platform_job_run_url: Optional[str] = None
+    """Url where full run details can be viewed"""
+
+    steps_truncated: Optional[bool] = None
+    """Whether the number of steps in the output has been truncated. If true, the output will contain
+    the first 20 steps of the output."""
+
+    def as_dict(self) -> dict:
+        """Serializes the DbtPlatformTaskOutput into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.dbt_platform_job_run_id is not None:
+            body["dbt_platform_job_run_id"] = self.dbt_platform_job_run_id
+        if self.dbt_platform_job_run_output:
+            body["dbt_platform_job_run_output"] = [v.as_dict() for v in self.dbt_platform_job_run_output]
+        if self.dbt_platform_job_run_url is not None:
+            body["dbt_platform_job_run_url"] = self.dbt_platform_job_run_url
+        if self.steps_truncated is not None:
+            body["steps_truncated"] = self.steps_truncated
+        return body
+
+    def as_shallow_dict(self) -> dict:
+        """Serializes the DbtPlatformTaskOutput into a shallow dictionary of its immediate attributes."""
+        body = {}
+        if self.dbt_platform_job_run_id is not None:
+            body["dbt_platform_job_run_id"] = self.dbt_platform_job_run_id
+        if self.dbt_platform_job_run_output:
+            body["dbt_platform_job_run_output"] = self.dbt_platform_job_run_output
+        if self.dbt_platform_job_run_url is not None:
+            body["dbt_platform_job_run_url"] = self.dbt_platform_job_run_url
+        if self.steps_truncated is not None:
+            body["steps_truncated"] = self.steps_truncated
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, Any]) -> DbtPlatformTaskOutput:
+        """Deserializes the DbtPlatformTaskOutput from a dictionary."""
+        return cls(
+            dbt_platform_job_run_id=d.get("dbt_platform_job_run_id", None),
+            dbt_platform_job_run_output=_repeated_dict(d, "dbt_platform_job_run_output", DbtPlatformJobRunStep),
+            dbt_platform_job_run_url=d.get("dbt_platform_job_run_url", None),
+            steps_truncated=d.get("steps_truncated", None),
+        )
+
+
 @dataclass
 class DbtTask:
     commands: List[str]
@@ -2393,8 +2535,6 @@ class GitSource:
     with git_branch or git_tag."""
 
     git_snapshot: Optional[GitSnapshot] = None
-    """Read-only state of the remote repository at the time the job was run. This field is only
-    included on job runs."""
 
     git_tag: Optional[str] = None
     """Name of the tag to be checked out and used by this job. This field cannot be specified in
@@ -2567,7 +2707,6 @@ class JobAccessControlRequest:
     """name of the group"""
 
     permission_level: Optional[JobPermissionLevel] = None
-    """Permission level"""
 
     service_principal_name: Optional[str] = None
     """application ID of a service principal"""
@@ -2890,9 +3029,6 @@ class JobEnvironment:
     """The key of an environment. It has to be unique within a job."""
 
     spec: Optional[compute.Environment] = None
-    """The environment entity used to preserve serverless environment side panel, jobs' environment for
-    non-notebook task, and DLT's environment for classic and serverless pipelines. In this minimal
-    environment spec, only pip dependencies are supported."""
 
     def as_dict(self) -> dict:
         """Serializes the JobEnvironment into a dictionary suitable for use as a JSON request body."""
@@ -3033,7 +3169,6 @@ class JobPermission:
     inherited_from_object: Optional[List[str]] = None
 
     permission_level: Optional[JobPermissionLevel] = None
-    """Permission level"""
 
     def as_dict(self) -> dict:
         """Serializes the JobPermission into a dictionary suitable for use as a JSON request body."""
@@ -3121,7 +3256,6 @@ class JobPermissionsDescription:
     description: Optional[str] = None
 
     permission_level: Optional[JobPermissionLevel] = None
-    """Permission level"""
 
     def as_dict(self) -> dict:
         """Serializes the JobPermissionsDescription into a dictionary suitable for use as a JSON request body."""
@@ -3271,7 +3405,6 @@ class JobSettings:
     are used, `git_source` must be defined on the job."""
 
     health: Optional[JobsHealthRules] = None
-    """An optional set of health rules that can be defined for this job."""
 
     job_clusters: Optional[List[JobCluster]] = None
     """A list of job cluster specifications that can be shared and reused by tasks of this job.
@@ -3310,10 +3443,6 @@ class JobSettings:
     """The queue settings of the job."""
 
     run_as: Optional[JobRunAs] = None
-    """Write-only setting. Specifies the user or service principal that the job runs as. If not
-    specified, the job runs as the user who created the job.
-    
-    Either `user_name` or `service_principal_name` should be specified. If not, an error is thrown."""
 
     schedule: Optional[CronSchedule] = None
     """An optional periodic schedule for this job. The default behavior is that the job only runs when
@@ -3572,18 +3701,8 @@ class JobsHealthOperator(Enum):
 @dataclass
 class JobsHealthRule:
     metric: JobsHealthMetric
-    """Specifies the health metric that is being evaluated for a particular health rule.
-    
-    * `RUN_DURATION_SECONDS`: Expected total time for a run in seconds. * `STREAMING_BACKLOG_BYTES`:
-    An estimate of the maximum bytes of data waiting to be consumed across all streams. This metric
-    is in Public Preview. * `STREAMING_BACKLOG_RECORDS`: An estimate of the maximum offset lag
-    across all streams. This metric is in Public Preview. * `STREAMING_BACKLOG_SECONDS`: An estimate
-    of the maximum consumer delay across all streams. This metric is in Public Preview. *
-    `STREAMING_BACKLOG_FILES`: An estimate of the maximum number of outstanding files across all
-    streams. This metric is in Public Preview."""
 
     op: JobsHealthOperator
-    """Specifies the operator used to compare the health metric value with the specified threshold."""
 
     value: int
     """Specifies the threshold value that the health metric should obey to satisfy the health rule."""
@@ -4289,11 +4408,6 @@ class PythonWheelTask:
 @dataclass
 class QueueDetails:
     code: Optional[QueueDetailsCodeCode] = None
-    """The reason for queuing the run. * `ACTIVE_RUNS_LIMIT_REACHED`: The run was queued due to
-    reaching the workspace limit of active task runs. * `MAX_CONCURRENT_RUNS_REACHED`: The run was
-    queued due to reaching the per-job limit of concurrent job runs. *
-    `ACTIVE_RUN_JOB_TASKS_LIMIT_REACHED`: The run was queued due to reaching the workspace limit of
-    active run job tasks."""
 
     message: Optional[str] = None
     """A descriptive message with the queuing details. This field is unstructured, and its exact format
@@ -4384,7 +4498,6 @@ class RepairHistoryItem:
     """Deprecated. Please use the `status` field instead."""
 
     status: Optional[RunStatus] = None
-    """The current status of the run"""
 
     task_run_ids: Optional[List[int]] = None
     """The run IDs of the task runs that ran as part of this repair history item."""
@@ -5128,11 +5241,6 @@ class Run:
     """The URL to the detail page of the run."""
 
     run_type: Optional[RunType] = None
-    """The type of a run. * `JOB_RUN`: Normal job run. A run created with :method:jobs/runNow. *
-    `WORKFLOW_RUN`: Workflow run. A run created with [dbutils.notebook.run]. * `SUBMIT_RUN`: Submit
-    run. A run created with :method:jobs/submit.
-    
-    [dbutils.notebook.run]: https://docs.databricks.com/dev-tools/databricks-utils.html#dbutils-workflow"""
 
     schedule: Optional[CronSchedule] = None
     """The cron schedule that triggered this run if it was triggered by the periodic scheduler."""
@@ -5153,7 +5261,6 @@ class Run:
     """Deprecated. Please use the `status` field instead."""
 
     status: Optional[RunStatus] = None
-    """The current status of the run"""
 
     tasks: Optional[List[RunTask]] = None
     """The list of tasks performed by the run. Each task has its own `run_id` which you can use to call
@@ -5162,19 +5269,8 @@ class Run:
     root to determine if more results are available."""
 
     trigger: Optional[TriggerType] = None
-    """The type of trigger that fired this run.
-    
-    * `PERIODIC`: Schedules that periodically trigger runs, such as a cron scheduler. * `ONE_TIME`:
-    One time triggers that fire a single run. This occurs you triggered a single run on demand
-    through the UI or the API. * `RETRY`: Indicates a run that is triggered as a retry of a
-    previously failed run. This occurs when you request to re-run the job in case of failures. *
-    `RUN_JOB_TASK`: Indicates a run that is triggered using a Run Job task. * `FILE_ARRIVAL`:
-    Indicates a run that is triggered by a file arrival. * `TABLE`: Indicates a run that is
-    triggered by a table update. * `CONTINUOUS_RESTART`: Indicates a run created by user to manually
-    restart a continuous job run."""
 
     trigger_info: Optional[TriggerInfo] = None
-    """Additional details about what triggered the run"""
 
     def as_dict(self) -> dict:
         """Serializes the Run into a dictionary suitable for use as a JSON request body."""
@@ -5955,10 +6051,13 @@ class RunOutput:
     """The output of a dashboard task, if available"""
 
     dbt_cloud_output: Optional[DbtCloudTaskOutput] = None
+    """Deprecated in favor of the new dbt_platform_output"""
 
     dbt_output: Optional[DbtOutput] = None
     """The output of a dbt task, if available."""
 
+    dbt_platform_output: Optional[DbtPlatformTaskOutput] = None
+
     error: Optional[str] = None
     """An error message indicating why a task failed or why output is not available. The message is
     unstructured, and its exact format is subject to change."""
@@ -6008,6 +6107,8 @@ class RunOutput:
             body["dbt_cloud_output"] = self.dbt_cloud_output.as_dict()
         if self.dbt_output:
             body["dbt_output"] = self.dbt_output.as_dict()
+        if self.dbt_platform_output:
+            body["dbt_platform_output"] = self.dbt_platform_output.as_dict()
         if self.error is not None:
             body["error"] = self.error
         if self.error_trace is not None:
@@ -6039,6 +6140,8 @@ class RunOutput:
             body["dbt_cloud_output"] = self.dbt_cloud_output
         if self.dbt_output:
             body["dbt_output"] = self.dbt_output
+        if self.dbt_platform_output:
+            body["dbt_platform_output"] = self.dbt_platform_output
         if self.error is not None:
             body["error"] = self.error
         if self.error_trace is not None:
@@ -6069,6 +6172,7 @@ class RunOutput:
             dashboard_output=_from_dict(d, "dashboard_output", DashboardTaskOutput),
             dbt_cloud_output=_from_dict(d, "dbt_cloud_output", DbtCloudTaskOutput),
             dbt_output=_from_dict(d, "dbt_output", DbtOutput),
+            dbt_platform_output=_from_dict(d, "dbt_platform_output", DbtPlatformTaskOutput),
             error=d.get("error", None),
             error_trace=d.get("error_trace", None),
             info=d.get("info", None),
@@ -6310,7 +6414,6 @@ class RunStatus:
     """If the run was queued, details about the reason for queuing the run."""
 
     state: Optional[RunLifecycleStateV2State] = None
-    """The current state of the run."""
 
     termination_details: Optional[TerminationDetails] = None
     """If the run is in a TERMINATING or TERMINATED state, details about the reason for terminating the
@@ -6388,7 +6491,9 @@ class RunTask:
     """The task refreshes a dashboard and sends a snapshot to subscribers."""
 
     dbt_cloud_task: Optional[DbtCloudTask] = None
-    """Task type for dbt cloud"""
+    """Task type for dbt cloud, deprecated in favor of the new name dbt_platform_task"""
+
+    dbt_platform_task: Optional[DbtPlatformTask] = None
 
     dbt_task: Optional[DbtTask] = None
     """The task runs one or more dbt commands when the `dbt_task` field is present. The dbt task
@@ -6545,7 +6650,6 @@ class RunTask:
     """Deprecated. Please use the `status` field instead."""
 
     status: Optional[RunStatus] = None
-    """The current status of the run"""
 
     timeout_seconds: Optional[int] = None
     """An optional timeout applied to each run of this job task. A value of `0` means no timeout."""
@@ -6572,6 +6676,8 @@ class RunTask:
             body["dashboard_task"] = self.dashboard_task.as_dict()
         if self.dbt_cloud_task:
             body["dbt_cloud_task"] = self.dbt_cloud_task.as_dict()
+        if self.dbt_platform_task:
+            body["dbt_platform_task"] = self.dbt_platform_task.as_dict()
         if self.dbt_task:
             body["dbt_task"] = self.dbt_task.as_dict()
         if self.depends_on:
@@ -6669,6 +6775,8 @@ class RunTask:
             body["dashboard_task"] = self.dashboard_task
         if self.dbt_cloud_task:
             body["dbt_cloud_task"] = self.dbt_cloud_task
+        if self.dbt_platform_task:
+            body["dbt_platform_task"] = self.dbt_platform_task
         if self.dbt_task:
             body["dbt_task"] = self.dbt_task
         if self.depends_on:
@@ -6760,6 +6868,7 @@ class RunTask:
             condition_task=_from_dict(d, "condition_task", RunConditionTask),
             dashboard_task=_from_dict(d, "dashboard_task", DashboardTask),
             dbt_cloud_task=_from_dict(d, "dbt_cloud_task", DbtCloudTask),
+            dbt_platform_task=_from_dict(d, "dbt_platform_task", DbtPlatformTask),
             dbt_task=_from_dict(d, "dbt_task", DbtTask),
             depends_on=_repeated_dict(d, "depends_on", TaskDependency),
             description=d.get("description", None),
@@ -6975,10 +7084,6 @@ class SparkSubmitTask:
 @dataclass
 class SqlAlertOutput:
     alert_state: Optional[SqlAlertState] = None
-    """The state of the SQL alert.
-    
-    * UNKNOWN: alert yet to be evaluated * OK: alert evaluated and did not fulfill trigger
-    conditions * TRIGGERED: alert evaluated and fulfilled trigger conditions"""
 
     output_link: Optional[str] = None
     """The link to find the output results."""
@@ -7611,7 +7716,6 @@ class SubmitRun:
     are used, `git_source` must be defined on the job."""
 
     health: Optional[JobsHealthRules] = None
-    """An optional set of health rules that can be defined for this job."""
 
     idempotency_token: Optional[str] = None
     """An optional token that can be used to guarantee the idempotency of job run requests. If a run
@@ -7784,7 +7888,9 @@ class SubmitTask:
     """The task refreshes a dashboard and sends a snapshot to subscribers."""
 
     dbt_cloud_task: Optional[DbtCloudTask] = None
-    """Task type for dbt cloud"""
+    """Task type for dbt cloud, deprecated in favor of the new name dbt_platform_task"""
+
+    dbt_platform_task: Optional[DbtPlatformTask] = None
 
     dbt_task: Optional[DbtTask] = None
     """The task runs one or more dbt commands when the `dbt_task` field is present. The dbt task
@@ -7818,7 +7924,6 @@ class SubmitTask:
     gen_ai_compute_task: Optional[GenAiComputeTask] = None
 
     health: Optional[JobsHealthRules] = None
-    """An optional set of health rules that can be defined for this job."""
 
     libraries: Optional[List[compute.Library]] = None
     """An optional list of libraries to be installed on the cluster. The default value is an empty
@@ -7898,6 +8003,8 @@ class SubmitTask:
             body["dashboard_task"] = self.dashboard_task.as_dict()
         if self.dbt_cloud_task:
             body["dbt_cloud_task"] = self.dbt_cloud_task.as_dict()
+        if self.dbt_platform_task:
+            body["dbt_platform_task"] = self.dbt_platform_task.as_dict()
         if self.dbt_task:
             body["dbt_task"] = self.dbt_task.as_dict()
         if self.depends_on:
@@ -7961,6 +8068,8 @@ class SubmitTask:
             body["dashboard_task"] = self.dashboard_task
         if self.dbt_cloud_task:
             body["dbt_cloud_task"] = self.dbt_cloud_task
+        if self.dbt_platform_task:
+            body["dbt_platform_task"] = self.dbt_platform_task
         if self.dbt_task:
             body["dbt_task"] = self.dbt_task
         if self.depends_on:
@@ -8021,6 +8130,7 @@ class SubmitTask:
             condition_task=_from_dict(d, "condition_task", ConditionTask),
             dashboard_task=_from_dict(d, "dashboard_task", DashboardTask),
             dbt_cloud_task=_from_dict(d, "dbt_cloud_task", DbtCloudTask),
+            dbt_platform_task=_from_dict(d, "dbt_platform_task", DbtPlatformTask),
             dbt_task=_from_dict(d, "dbt_task", DbtTask),
             depends_on=_repeated_dict(d, "depends_on", TaskDependency),
             description=d.get("description", None),
@@ -8202,7 +8312,9 @@ class Task:
     """The task refreshes a dashboard and sends a snapshot to subscribers."""
 
     dbt_cloud_task: Optional[DbtCloudTask] = None
-    """Task type for dbt cloud"""
+    """Task type for dbt cloud, deprecated in favor of the new name dbt_platform_task"""
+
+    dbt_platform_task: Optional[DbtPlatformTask] = None
 
     dbt_task: Optional[DbtTask] = None
     """The task runs one or more dbt commands when the `dbt_task` field is present. The dbt task
@@ -8240,7 +8352,6 @@ class Task:
     gen_ai_compute_task: Optional[GenAiComputeTask] = None
 
     health: Optional[JobsHealthRules] = None
-    """An optional set of health rules that can be defined for this job."""
 
     job_cluster_key: Optional[str] = None
     """If job_cluster_key, this task is executed reusing the cluster specified in
@@ -8341,6 +8452,8 @@ class Task:
             body["dashboard_task"] = self.dashboard_task.as_dict()
         if self.dbt_cloud_task:
             body["dbt_cloud_task"] = self.dbt_cloud_task.as_dict()
+        if self.dbt_platform_task:
+            body["dbt_platform_task"] = self.dbt_platform_task.as_dict()
         if self.dbt_task:
             body["dbt_task"] = self.dbt_task.as_dict()
         if self.depends_on:
@@ -8414,6 +8527,8 @@ class Task:
             body["dashboard_task"] = self.dashboard_task
         if self.dbt_cloud_task:
             body["dbt_cloud_task"] = self.dbt_cloud_task
+        if self.dbt_platform_task:
+            body["dbt_platform_task"] = self.dbt_platform_task
         if self.dbt_task:
             body["dbt_task"] = self.dbt_task
         if self.depends_on:
@@ -8484,6 +8599,7 @@ class Task:
             condition_task=_from_dict(d, "condition_task", ConditionTask),
             dashboard_task=_from_dict(d, "dashboard_task", DashboardTask),
             dbt_cloud_task=_from_dict(d, "dbt_cloud_task", DbtCloudTask),
+            dbt_platform_task=_from_dict(d, "dbt_platform_task", DbtPlatformTask),
             dbt_task=_from_dict(d, "dbt_task", DbtTask),
             depends_on=_repeated_dict(d, "depends_on", TaskDependency),
             description=d.get("description", None),
@@ -8747,55 +8863,12 @@ class TerminationCodeCode(Enum):
 @dataclass
 class TerminationDetails:
     code: Optional[TerminationCodeCode] = None
-    """The code indicates why the run was terminated. Additional codes might be introduced in future
-    releases. * `SUCCESS`: The run was completed successfully. * `SUCCESS_WITH_FAILURES`: The run
-    was completed successfully but some child runs failed. * `USER_CANCELED`: The run was
-    successfully canceled during execution by a user. * `CANCELED`: The run was canceled during
-    execution by the Databricks platform; for example, if the maximum run duration was exceeded. *
-    `SKIPPED`: Run was never executed, for example, if the upstream task run failed, the dependency
-    type condition was not met, or there were no material tasks to execute. * `INTERNAL_ERROR`: The
-    run encountered an unexpected error. Refer to the state message for further details. *
-    `DRIVER_ERROR`: The run encountered an error while communicating with the Spark Driver. *
-    `CLUSTER_ERROR`: The run failed due to a cluster error. Refer to the state message for further
-    details. * `REPOSITORY_CHECKOUT_FAILED`: Failed to complete the checkout due to an error when
-    communicating with the third party service. * `INVALID_CLUSTER_REQUEST`: The run failed because
-    it issued an invalid request to start the cluster. * `WORKSPACE_RUN_LIMIT_EXCEEDED`: The
-    workspace has reached the quota for the maximum number of concurrent active runs. Consider
-    scheduling the runs over a larger time frame. * `FEATURE_DISABLED`: The run failed because it
-    tried to access a feature unavailable for the workspace. * `CLUSTER_REQUEST_LIMIT_EXCEEDED`: The
-    number of cluster creation, start, and upsize requests have exceeded the allotted rate limit.
-    Consider spreading the run execution over a larger time frame. * `STORAGE_ACCESS_ERROR`: The run
-    failed due to an error when accessing the customer blob storage. Refer to the state message for
-    further details. * `RUN_EXECUTION_ERROR`: The run was completed with task failures. For more
-    details, refer to the state message or run output. * `UNAUTHORIZED_ERROR`: The run failed due to
-    a permission issue while accessing a resource. Refer to the state message for further details. *
-    `LIBRARY_INSTALLATION_ERROR`: The run failed while installing the user-requested library. Refer
-    to the state message for further details. The causes might include, but are not limited to: The
-    provided library is invalid, there are insufficient permissions to install the library, and so
-    forth. * `MAX_CONCURRENT_RUNS_EXCEEDED`: The scheduled run exceeds the limit of maximum
-    concurrent runs set for the job. * `MAX_SPARK_CONTEXTS_EXCEEDED`: The run is scheduled on a
-    cluster that has already reached the maximum number of contexts it is configured to create. See:
-    [Link]. * `RESOURCE_NOT_FOUND`: A resource necessary for run execution does not exist. Refer to
-    the state message for further details. * `INVALID_RUN_CONFIGURATION`: The run failed due to an
-    invalid configuration. Refer to the state message for further details. * `CLOUD_FAILURE`: The
-    run failed due to a cloud provider issue. Refer to the state message for further details. *
-    `MAX_JOB_QUEUE_SIZE_EXCEEDED`: The run was skipped due to reaching the job level queue size
-    limit. * `DISABLED`: The run was never executed because it was disabled explicitly by the user.
-    
-    [Link]: https://kb.databricks.com/en_US/notebooks/too-many-execution-contexts-are-open-right-now"""
 
     message: Optional[str] = None
     """A descriptive message with the termination details. This field is unstructured and the format
     might change."""
 
     type: Optional[TerminationTypeType] = None
-    """* `SUCCESS`: The run terminated without any issues * `INTERNAL_ERROR`: An error occurred in the
-    Databricks platform. Please look at the [status page] or contact support if the issue persists.
-    * `CLIENT_ERROR`: The run was terminated because of an error caused by user input or the job
-    configuration. * `CLOUD_FAILURE`: The run was terminated because of an issue with your cloud
-    provider.
-    
-    [status page]: https://status.databricks.com/"""
 
     def as_dict(self) -> dict:
         """Serializes the TerminationDetails into a dictionary suitable for use as a JSON request body."""
@@ -8961,10 +9034,13 @@ class TriggerType(Enum):
     through the UI or the API. * `RETRY`: Indicates a run that is triggered as a retry of a
     previously failed run. This occurs when you request to re-run the job in case of failures. *
     `RUN_JOB_TASK`: Indicates a run that is triggered using a Run Job task. * `FILE_ARRIVAL`:
-    Indicates a run that is triggered by a file arrival. * `TABLE`: Indicates a run that is
-    triggered by a table update. * `CONTINUOUS_RESTART`: Indicates a run created by user to manually
-    restart a continuous job run."""
+    Indicates a run that is triggered by a file arrival. * `CONTINUOUS`: Indicates a run that is
+    triggered by a continuous job. * `TABLE`: Indicates a run that is triggered by a table update. *
+    `CONTINUOUS_RESTART`: Indicates a run created by user to manually restart a continuous job run.
+    * `MODEL`: Indicates a run that is triggered by a model update."""
 
+    CONTINUOUS = "CONTINUOUS"
+    CONTINUOUS_RESTART = "CONTINUOUS_RESTART"
     FILE_ARRIVAL = "FILE_ARRIVAL"
     ONE_TIME = "ONE_TIME"
     PERIODIC = "PERIODIC"
@@ -9274,9 +9350,7 @@ class JobsAPI:
         raise TimeoutError(f"timed out after {timeout}: {status_message}")
 
     def cancel_all_runs(self, *, all_queued_runs: Optional[bool] = None, job_id: Optional[int] = None):
-        """Cancel all runs of a job.
-
-        Cancels all active runs of a job. The runs are canceled asynchronously, so it doesn't prevent new runs
+        """Cancels all active runs of a job. The runs are canceled asynchronously, so it doesn't prevent new runs
         from being started.
 
         :param all_queued_runs: bool (optional)
@@ -9299,9 +9373,7 @@ class JobsAPI:
         self._api.do("POST", "/api/2.2/jobs/runs/cancel-all", body=body, headers=headers)
 
     def cancel_run(self, run_id: int) -> Wait[Run]:
-        """Cancel a run.
-
-        Cancels a job run or a task run. The run is canceled asynchronously, so it may still be running when
+        """Cancels a job run or a task run. The run is canceled asynchronously, so it may still be running when
         this request completes.
 
         :param run_id: int
@@ -9359,8 +9431,6 @@ class JobsAPI:
     ) -> CreateResponse:
         """Create a new job.
 
-        Create a new job.
-
         :param access_control_list: List[:class:`JobAccessControlRequest`] (optional)
           List of permissions to set on the job.
         :param budget_policy_id: str (optional)
@@ -9400,7 +9470,6 @@ class JobsAPI:
           Note: dbt and SQL File tasks support only version-controlled sources. If dbt or SQL File tasks are
           used, `git_source` must be defined on the job.
         :param health: :class:`JobsHealthRules` (optional)
-          An optional set of health rules that can be defined for this job.
         :param job_clusters: List[:class:`JobCluster`] (optional)
           A list of job cluster specifications that can be shared and reused by tasks of this job. Libraries
           cannot be declared in a shared job cluster. You must declare dependent libraries in task settings.
@@ -9430,10 +9499,6 @@ class JobsAPI:
         :param queue: :class:`QueueSettings` (optional)
           The queue settings of the job.
         :param run_as: :class:`JobRunAs` (optional)
-          Write-only setting. Specifies the user or service principal that the job runs as. If not specified,
-          the job runs as the user who created the job.
-
-          Either `user_name` or `service_principal_name` should be specified. If not, an error is thrown.
         :param schedule: :class:`CronSchedule` (optional)
           An optional periodic schedule for this job. The default behavior is that the job only runs when
           triggered by clicking “Run Now” in the Jobs UI or sending an API request to `runNow`.
@@ -9518,9 +9583,7 @@ class JobsAPI:
         return CreateResponse.from_dict(res)
 
     def delete(self, job_id: int):
-        """Delete a job.
-
-        Deletes a job.
+        """Deletes a job.
 
         :param job_id: int
           The canonical identifier of the job to delete. This field is required.
@@ -9537,9 +9600,7 @@ class JobsAPI:
         self._api.do("POST", "/api/2.2/jobs/delete", body=body, headers=headers)
 
     def delete_run(self, run_id: int):
-        """Delete a job run.
-
-        Deletes a non-active run. Returns an error if the run is active.
+        """Deletes a non-active run. Returns an error if the run is active.
 
         :param run_id: int
           ID of the run to delete.
@@ -9556,9 +9617,7 @@ class JobsAPI:
         self._api.do("POST", "/api/2.2/jobs/runs/delete", body=body, headers=headers)
 
     def export_run(self, run_id: int, *, views_to_export: Optional[ViewsToExport] = None) -> ExportRunOutput:
-        """Export and retrieve a job run.
-
-        Export and retrieve the job run task.
+        """Export and retrieve the job run task.
 
         :param run_id: int
           The canonical identifier for the run. This field is required.
@@ -9581,9 +9640,7 @@ class JobsAPI:
         return ExportRunOutput.from_dict(res)
 
     def get(self, job_id: int, *, page_token: Optional[str] = None) -> Job:
-        """Get a single job.
-
-        Retrieves the details for a single job.
+        """Retrieves the details for a single job.
 
         Large arrays in the results will be paginated when they exceed 100 elements. A request for a single
         job will return all properties for that job, and the first 100 elements of array properties (`tasks`,
@@ -9614,9 +9671,7 @@ class JobsAPI:
         return Job.from_dict(res)
 
     def get_permission_levels(self, job_id: str) -> GetJobPermissionLevelsResponse:
-        """Get job permission levels.
-
-        Gets the permission levels that a user can have on an object.
+        """Gets the permission levels that a user can have on an object.
 
         :param job_id: str
           The job for which to get or manage permissions.
@@ -9632,9 +9687,7 @@ class JobsAPI:
         return GetJobPermissionLevelsResponse.from_dict(res)
 
     def get_permissions(self, job_id: str) -> JobPermissions:
-        """Get job permissions.
-
-        Gets the permissions of a job. Jobs can inherit permissions from their root object.
+        """Gets the permissions of a job. Jobs can inherit permissions from their root object.
 
         :param job_id: str
           The job for which to get or manage permissions.
@@ -9657,9 +9710,7 @@ class JobsAPI:
         include_resolved_values: Optional[bool] = None,
         page_token: Optional[str] = None,
     ) -> Run:
-        """Get a single job run.
-
-        Retrieves the metadata of a run.
+        """Retrieves the metadata of a run.
 
         Large arrays in the results will be paginated when they exceed 100 elements. A request for a single
         run will return all properties for that run, and the first 100 elements of array properties (`tasks`,
@@ -9698,9 +9749,7 @@ class JobsAPI:
         return Run.from_dict(res)
 
     def get_run_output(self, run_id: int) -> RunOutput:
-        """Get the output for a single run.
-
-        Retrieve the output and metadata of a single task run. When a notebook task returns a value through
+        """Retrieve the output and metadata of a single task run. When a notebook task returns a value through
         the `dbutils.notebook.exit()` call, you can use this endpoint to retrieve that value. Databricks
         restricts this API to returning the first 5 MB of the output. To return a larger result, you can store
         job results in a cloud storage service.
@@ -9734,9 +9783,7 @@ class JobsAPI:
         offset: Optional[int] = None,
         page_token: Optional[str] = None,
     ) -> Iterator[BaseJob]:
-        """List jobs.
-
-        Retrieves a list of jobs.
+        """Retrieves a list of jobs.
 
         :param expand_tasks: bool (optional)
           Whether to include task and cluster details in the response. Note that only the first 100 elements
@@ -9794,9 +9841,7 @@ class JobsAPI:
         start_time_from: Optional[int] = None,
         start_time_to: Optional[int] = None,
     ) -> Iterator[BaseRun]:
-        """List job runs.
-
-        List runs in descending order by start time.
+        """List runs in descending order by start time.
 
         :param active_only: bool (optional)
           If active_only is `true`, only active runs are included in the results; otherwise, lists both active
@@ -9884,9 +9929,7 @@ class JobsAPI:
         spark_submit_params: Optional[List[str]] = None,
         sql_params: Optional[Dict[str, str]] = None,
     ) -> Wait[Run]:
-        """Repair a job run.
-
-        Re-run one or more tasks. Tasks are re-run as part of the original job run. They use the current job
+        """Re-run one or more tasks. Tasks are re-run as part of the original job run. They use the current job
         and task settings, and can be viewed in the history for the original job run.
 
         :param run_id: int
@@ -10064,9 +10107,7 @@ class JobsAPI:
         ).result(timeout=timeout)
 
     def reset(self, job_id: int, new_settings: JobSettings):
-        """Update all job settings (reset).
-
-        Overwrite all settings for the given job. Use the [_Update_ endpoint](:method:jobs/update) to update
+        """Overwrite all settings for the given job. Use the [_Update_ endpoint](:method:jobs/update) to update
         job settings partially.
 
         :param job_id: int
@@ -10108,9 +10149,7 @@ class JobsAPI:
         spark_submit_params: Optional[List[str]] = None,
         sql_params: Optional[Dict[str, str]] = None,
     ) -> Wait[Run]:
-        """Trigger a new job run.
-
-        Run a job and return the `run_id` of the triggered run.
+        """Run a job and return the `run_id` of the triggered run.
 
         :param job_id: int
           The ID of the job to be executed
@@ -10293,9 +10332,7 @@ class JobsAPI:
     def set_permissions(
         self, job_id: str, *, access_control_list: Optional[List[JobAccessControlRequest]] = None
     ) -> JobPermissions:
-        """Set job permissions.
-
-        Sets permissions on an object, replacing existing permissions if they exist. Deletes all direct
+        """Sets permissions on an object, replacing existing permissions if they exist. Deletes all direct
         permissions if none are specified. Objects can inherit permissions from their root object.
 
         :param job_id: str
@@ -10333,9 +10370,7 @@ class JobsAPI:
         timeout_seconds: Optional[int] = None,
         webhook_notifications: Optional[WebhookNotifications] = None,
     ) -> Wait[Run]:
-        """Create and trigger a one-time run.
-
-        Submit a one-time run. This endpoint allows you to submit a workload directly without creating a job.
+        """Submit a one-time run. This endpoint allows you to submit a workload directly without creating a job.
         Runs submitted using this endpoint don’t display in the UI. Use the `jobs/runs/get` API to check the
         run state after the job is submitted.
 
@@ -10358,7 +10393,6 @@ class JobsAPI:
           Note: dbt and SQL File tasks support only version-controlled sources. If dbt or SQL File tasks are
           used, `git_source` must be defined on the job.
         :param health: :class:`JobsHealthRules` (optional)
-          An optional set of health rules that can be defined for this job.
         :param idempotency_token: str (optional)
           An optional token that can be used 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
@@ -10472,9 +10506,7 @@ class JobsAPI:
     def update(
         self, job_id: int, *, fields_to_remove: Optional[List[str]] = None, new_settings: Optional[JobSettings] = None
     ):
-        """Update job settings partially.
-
-        Add, update, or remove specific settings of an existing job. Use the [_Reset_
+        """Add, update, or remove specific settings of an existing job. Use the [_Reset_
         endpoint](:method:jobs/reset) to overwrite all job settings.
 
         :param job_id: int
@@ -10512,9 +10544,7 @@ class JobsAPI:
     def update_permissions(
         self, job_id: str, *, access_control_list: Optional[List[JobAccessControlRequest]] = None
     ) -> JobPermissions:
-        """Update job permissions.
-
-        Updates the permissions on a job. Jobs can inherit permissions from their root object.
+        """Updates the permissions on a job. Jobs can inherit permissions from their root object.
 
         :param job_id: str
           The job for which to get or manage permissions.
@@ -10552,9 +10582,7 @@ class PolicyComplianceForJobsAPI:
     def enforce_compliance(
         self, job_id: int, *, validate_only: Optional[bool] = None
     ) -> EnforcePolicyComplianceResponse:
-        """Enforce job policy compliance.
-
-        Updates a job so the job clusters that are created when running the job (specified in `new_cluster`)
+        """Updates a job so the job clusters that are created when running the job (specified in `new_cluster`)
         are compliant with the current versions of their respective cluster policies. All-purpose clusters
         used in the job will not be updated.
 
@@ -10579,9 +10607,7 @@ class PolicyComplianceForJobsAPI:
         return EnforcePolicyComplianceResponse.from_dict(res)
 
     def get_compliance(self, job_id: int) -> GetPolicyComplianceResponse:
-        """Get job policy compliance.
-
-        Returns the policy compliance status of a job. Jobs could be out of compliance if a cluster policy
+        """Returns the policy compliance status of a job. Jobs could be out of compliance if a cluster policy
         they use was updated after the job was last edited and some of its job clusters no longer comply with
         their updated policies.
 
@@ -10604,9 +10630,7 @@ class PolicyComplianceForJobsAPI:
     def list_compliance(
         self, policy_id: str, *, page_size: Optional[int] = None, page_token: Optional[str] = None
     ) -> Iterator[JobCompliance]:
-        """List job policy compliance.
-
-        Returns the policy compliance status of all jobs that use a given policy. Jobs could be out of
+        """Returns the policy compliance status of all jobs that use a given policy. Jobs could be out of
         compliance if a cluster policy they use was updated after the job was last edited and its job clusters
         no longer comply with the updated policy.