OptionalattemptThe sequence number of this run attempt for a triggered job run. The initial attempt of a run has an attempt_number of 0. If the initial run attempt fails, and the job has a retry policy (max_retries > 0), subsequent runs are created with an original_attempt_run_id of the original attempt’s ID and an incrementing attempt_number. Runs are retried only until they succeed, and the maximum attempt_number is the same as the max_retries value for the job.
OptionalcleanupThe time in milliseconds it took to terminate the cluster and clean up any associated artifacts. The duration of a task run is the sum of the setup_duration, execution_duration, and the cleanup_duration. The cleanup_duration field is set to 0 for multitask job runs. The total duration of a multitask job run is the value of the run_duration field.
OptionalclusterThe cluster used for this run. If the run is specified to use a new cluster, this field is set once the Jobs service has requested a cluster for the run.
OptionalclusterA snapshot of the job’s cluster specification when this run was created.
OptionalcreatorThe creator user name. This field won’t be included in the response if the user has already been deleted.
OptionaldescriptionDescription of the run
OptionaleffectiveThe actual performance target used by the serverless run during execution. This can differ from the client-set performance target on the request depending on whether the performance mode is supported by the job type.
STANDARD: Enables cost-efficient execution of serverless workloads.PERFORMANCE_OPTIMIZED: Prioritizes fast startup and execution times through rapid scaling and optimized cluster performance.OptionaleffectiveThe id of the usage policy used by this run for cost attribution purposes.
OptionalendThe time at which this run ended in epoch milliseconds (milliseconds since 1/1/1970 UTC). This field is set to 0 if the job is still running.
OptionalexecutionThe time in milliseconds it took to execute the commands in the JAR or notebook until they completed, failed, timed out, were cancelled, or encountered an unexpected error. The duration of a task run is the sum of the setup_duration, execution_duration, and the cleanup_duration. The execution_duration field is set to 0 for multitask job runs. The total duration of a multitask job run is the value of the run_duration field.
OptionalgitAn optional specification for a remote Git repository containing the source code used by tasks. Version-controlled source code is supported by notebook, dbt, Python script, and SQL File tasks.
If git_source is set, these tasks retrieve the file from the remote repository by default. However, this behavior can be overridden by setting source to WORKSPACE on the task.
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.
OptionalhasIndicates if the run has more array properties (tasks, job_clusters) that are not shown. They can be accessed via :method:jobs/getrun endpoint.
It is only relevant for API 2.2 :method:jobs/listruns requests with expand_tasks=true.
OptionaljobA 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. If more than 100 job clusters are available, you can paginate through them using :method:jobs/getrun.
OptionaljobThe canonical identifier of the job that contains this run.
OptionaljobJob-level parameters used in the run
OptionaljobID of the job run that this run belongs to. For legacy and single-task job runs the field is populated with the job run ID. For task runs, the field is populated with the ID of the job run that the task run belongs to.
OptionalnextA token that can be used to list the next page of array properties.
OptionalnumberA unique identifier for this job run. This is set to the same value as run_id.
OptionaloriginalIf this run is a retry of a prior run attempt, this field contains the run_id of the original attempt; otherwise, it is the same as the run_id.
OptionaloverridingThe parameters used for this run.
OptionalqueueThe time in milliseconds that the run has spent in the queue.
OptionalrepairThe repair history of the run.
OptionalrunThe time in milliseconds it took the job run and all of its repairs to finish.
OptionalrunThe canonical identifier of the run. This ID is unique across all runs of all jobs.
OptionalrunAn optional name for the run. The maximum length is 4096 bytes in UTF-8 encoding.
OptionalrunThe URL to the detail page of the run.
OptionalrunOptionalscheduleThe cron schedule that triggered this run if it was triggered by the periodic scheduler.
OptionalsetupThe time in milliseconds it took to set up the cluster. For runs that run on new clusters this is the cluster creation time, for runs that run on existing clusters this time should be very short. The duration of a task run is the sum of the setup_duration, execution_duration, and the cleanup_duration. The setup_duration field is set to 0 for multitask job runs. The total duration of a multitask job run is the value of the run_duration field.
OptionalstartThe time at which this run was started in epoch milliseconds (milliseconds since 1/1/1970 UTC). This may not be the time when the job task starts executing, for example, if the job is scheduled to run on a new cluster, this is the time the cluster creation call is issued.
OptionalstateDeprecated. Please use the status field instead.
OptionalstatusOptionaltasksThe list of tasks performed by the run. Each task has its own run_id which you can use to call JobsGetOutput to retrieve the run results.
If more than 100 tasks are available, you can paginate through them using :method:jobs/getrun. Use the next_page_token field at the object root to determine if more results are available.
OptionaltriggerOptionaltrigger
Run was retrieved successfully