crate::models::JobsRunsGetOutput200Response jobs_runs_get_output(run_id) 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 the dbutils.notebook.exit() call, you can use this endpoint to retrieve that value. Databricks restricts this API to return the first 5 MB of the output. To return a larger result, you can store job results in a cloud storage service. This endpoint validates that the run_id parameter is valid and returns an HTTP status code 400 if the run_id parameter is invalid. Runs are automatically removed after 60 days. If you to want to reference them beyond 60 days, you must save old run results before they expire. To export using the UI, see Export job run results. To export using the Jobs API, see Runs export.
Parameters
Name
Type
Description
Required
Notes
run_id
i64
The canonical identifier for the run. This field is required.
crate::models::JobsRunsList200Response jobs_runs_list(active_only, completed_only, job_id, offset, limit, run_type, expand_tasks, start_time_from, start_time_to) List runs for a job
List runs in descending order by start time.
Parameters
Name
Type
Description
Required
Notes
active_only
Option<bool>
If active_only is true, only active runs are included in the results; otherwise, lists both active and completed runs. An active run is a run in the PENDING, RUNNING, or TERMINATING. This field cannot be true when completed_only is true.
[default to false]
completed_only
Option<bool>
If completed_only is true, only completed runs are included in the results; otherwise, lists both active and completed runs. This field cannot be true when active_only is true.
[default to false]
job_id
Option<i64>
The job for which to list runs. If omitted, the Jobs service lists runs from all jobs.
offset
Option<i32>
The offset of the first run to return, relative to the most recent run.
[default to 0]
limit
Option<i32>
The number of runs to return. This value must be greater than 0 and less than 25\. The default value is 25\. If a request specifies a limit of 0, the service instead uses the maximum limit.
[default to 25]
run_type
Option<String>
The type of runs to return. For a description of run types, see Run.
expand_tasks
Option<bool>
Whether to include task and cluster details in the response.
[default to false]
start_time_from
Option<i32>
Show runs that started at or after this value. The value must be a UTC timestamp in milliseconds. Can be combined with start_time_to to filter by a time range.
start_time_to
Option<i32>
Show runs that started at or before this value. The value must be a UTC timestamp in milliseconds. Can be combined with start_time_from to filter by a time range.
crate::models::JobsRunsRepair200Response jobs_runs_repair(jobs_runs_repair_request) Repair a job run
Re-run one or more tasks. Tasks are re-run as part of the original job run, use the current job and task settings, and can be viewed in the history for the original job run.
crate::models::JobsRunsSubmit200Response jobs_runs_submit(jobs_runs_submit_request) 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. Use the jobs/runs/get API to check the run state after the job is submitted.