Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-14126767600.8 KB

Gets a Deadline Cloud job.

get/2023-10-12/farms/{farmId}/queues/{queueId}/jobs/{jobId}

Path parameters

farmIdstring required

The farm ID of the farm in the job.

queueIdstring required

The queue ID associated with the job.

jobIdstring required

The job ID.

Response

Success

jobIdstring required

The job ID.

namestring required

The name of the job.

lifecycleStatus'CREATE_IN_PROGRESS' | 'CREATE_FAILED' | 'CREATE_COMPLETE' | 'UPLOAD_IN_PROGRESS' | 'UPLOAD_FAILED' | 'UPDATE_IN_PROGRESS' | 'UPDATE_FAILED' | 'UPDATE_SUCCEEDED' | 'ARCHIVED' required

The life cycle status for the job.

lifecycleStatusMessagestring required

A message that communicates the status of the life cycle for the job.

priorityinteger required

The job priority.

createdAtstring date-time required

The date and time the resource was created.

createdBystring required

The user or system that created this resource.

updatedAtstring date-time

The date and time the resource was updated.

updatedBystring

The user or system that updated this resource.

startedAtstring date-time

The date and time the resource started running.

endedAtstring date-time

The date and time the resource ended running.

taskRunStatus'PENDING' | 'READY' | 'ASSIGNED' | 'STARTING' | 'SCHEDULED' | 'INTERRUPTING' | 'RUNNING' | 'SUSPENDED' | 'CANCELED' | 'FAILED' | 'SUCCEEDED' | 'NOT_COMPATIBLE'

The task run status for the job.

targetTaskRunStatus'READY' | 'FAILED' | 'SUCCEEDED' | 'CANCELED' | 'SUSPENDED' | 'PENDING'

The task status with which the job started.

taskRunStatusCountsobject

The number of tasks running on the job.

taskFailureRetryCountinteger

The total number of times tasks from the job failed and were retried.

storageProfileIdstring

The storage profile ID associated with the job.

maxFailedTasksCountinteger

The number of task failures before the job stops running and is marked as <code>FAILED</code>.

maxRetriesPerTaskinteger

The maximum number of retries per failed tasks.

parametersobject

The parameters for the job.

descriptionstring password
<p>The description of the job.</p> <important> <p>This field can store any content. Escape or encode this content before displaying it on a webpage or any other system that might interpret the content of this field.</p> </important>
maxWorkerCountinteger
<p>The maximum number of worker hosts that can concurrently process a job. When the <code>maxWorkerCount</code> is reached, no more workers will be assigned to process the job, even if the fleets assigned to the job's queue has available workers.</p> <p>If you don't set the <code>maxWorkerCount</code> when you create a job, this value is not returned in the response.</p>
sourceJobIdstring

The job ID for the source job.