Jump to

• Request
• Response

Retrieve Job

get

[host-url]/dt-rest/v2/jobs/{jobId}

Retrieves a job by its ID.

Request

Path Parameters

• jobId(required): string
  The ID of the job to retrieve.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

A response object containing the retrieved job.

Body ()

Root Schema : RuntimeJobDTO

Match All

JSON that represents a job during runtime with additional job metadata, such as execution statistics, record statistics, and job variables.

Show Source

• object RuntimeJobBaseDTO
  Represents a job during runtime.
• object RuntimeJobDTO-allOf[1]
  JSON that represents a job during runtime with additional job metadata, such as execution statistics, record statistics, and job variables.

{
    "allOf":[
        {
            "$ref":"#/components/schemas/RuntimeJobBaseDTO"
        },
        {
            "type":"object",
            "description":"JSON that represents a job during runtime with additional job metadata, such as execution statistics, record statistics, and job variables.",
            "properties":{
                "executionStatistics":{
                    "type":"object",
                    "description":"Complex object: ExecutionStatisticsDTO"
                },
                "recordStatistics":{
                    "type":"object",
                    "description":"Complex object: RecordStatisticsDTO"
                },
                "synchronous":{
                    "type":"boolean"
                },
                "errorMessage":{
                    "type":"string"
                },
                "jobVariables":{
                    "type":"object",
                    "additionalProperties":{
                        "type":"string"
                    }
                }
            }
        }
    ]
}

Nested Schema : RuntimeJobBaseDTO

Type: object

Represents a job during runtime.

Show Source

• endDate: string (date-time)
• jobId: string
• jobName(required): string
• jobNumber: integer (int64)
• startDate: string (date-time)
• status: string
  Allowed Values: [ "WAITING", "ERROR", "RUNNING", "DONE", "WARNING", "QUEUED", "NOT_STARTED", "PREPARING", "VALID", "INVALID" ]

  Enumerates the possible statuses of a job.

  • Waiting: The Job is waiting to be executed.
  • Error: The Job terminated due to an error.
  • Running: The Job is being executed.
  • Done: The Job executed successfully.
  • Warning: The Job completed successfully but errors have been detected during the data quality check.
  • Queued: The Job is waiting for an agent to be available for its execution.
  • Not started: The Job has not started.
  • Preparing: The Job is preparing to be executed.
  • Valid: The Job is valid to be executed.
  • Invalid: The Job is not valid to be executed.

{
    "type":"object",
    "description":"Represents a job during runtime.",
    "required":[
        "jobName"
    ],
    "properties":{
        "status":{
            "$ref":"#/components/schemas/JobStatus"
        },
        "jobName":{
            "type":"string"
        },
        "jobNumber":{
            "type":"integer",
            "format":"int64"
        },
        "jobId":{
            "type":"string"
        },
        "startDate":{
            "type":"string",
            "format":"date-time"
        },
        "endDate":{
            "type":"string",
            "format":"date-time"
        }
    }
}

Nested Schema : RuntimeJobDTO-allOf[1]

Type: object

JSON that represents a job during runtime with additional job metadata, such as execution statistics, record statistics, and job variables.

Show Source

• errorMessage: string
• executionStatistics: object executionStatistics
  Complex object: ExecutionStatisticsDTO
• jobVariables: object jobVariables
  Additional Properties Allowed: additionalProperties
• recordStatistics: object recordStatistics
  Complex object: RecordStatisticsDTO
• synchronous: boolean

{
    "type":"object",
    "description":"JSON that represents a job during runtime with additional job metadata, such as execution statistics, record statistics, and job variables.",
    "properties":{
        "executionStatistics":{
            "type":"object",
            "description":"Complex object: ExecutionStatisticsDTO"
        },
        "recordStatistics":{
            "type":"object",
            "description":"Complex object: RecordStatisticsDTO"
        },
        "synchronous":{
            "type":"boolean"
        },
        "errorMessage":{
            "type":"string"
        },
        "jobVariables":{
            "type":"object",
            "additionalProperties":{
                "type":"string"
            }
        }
    }
}

Nested Schema : executionStatistics

Type: object

Complex object: ExecutionStatisticsDTO

Nested Schema : jobVariables

Type: object

Additional Properties Allowed

Show Source

• string

{
    "type":"object",
    "additionalProperties":{
        "type":"string"
    }
}

Nested Schema : recordStatistics

Type: object

Complex object: RecordStatisticsDTO

401 Response

Unauthorized

404 Response

Not Found

Back to Top