ATataccama
Jobs

Get job

Retrieve a specific job, typically to read the error of a failed one.

Each job reports its status, the submittedAt, startedAt, and finishedAt timestamps, and, for a failed job, an error object with the failure reason.

get/processing/v1/jobs/{jobUrn}

Request

Path parameters

jobUrnstring uri required

A URN identifying a processing job.

Format: urn:ata:{tenant}:processing:job:{uuid}

Example: urn:ata:acme-corp:processing:job:123e4567-e89b-12d3-a456-426614174000.

Example:urn:ata:acme-corp:processing:job:123e4567-e89b-12d3-a456-426614174000

Response

The processing job.

urnstring uri required

A URN identifying a processing job.

Format: urn:ata:{tenant}:processing:job:{uuid}

Example: urn:ata:acme-corp:processing:job:123e4567-e89b-12d3-a456-426614174000.

typestring required

Type of the job.

namestring

Human-readable name of the job.

submittedAtstring date-time required

When the job was submitted to the workflow.

startedAtstring date-time

When the job started running.

finishedAtstring date-time

When the job finished.

durationinteger

Duration of the job.

statusstring required

@ExtensibleEnum The current status of the processing job: PENDING (not started yet), RUNNING, FINISHED (completed successfully), FAILED (did not complete — see error), CANCELED, or SKIPPED (there was nothing to run). The set is extensible.

Example response

{
  "urn": "urn:ata:acme-corp:processing:job:123e4567-e89b-12d3-a456-426614174000",
  "status": "PENDING"
}

Changes

No recorded changes to this operation across all 1 revision of this API.