Get task run details

get

/20260430/aiDataPlatforms/{aiDataPlatformId}/workspaces/{workspaceKey}/taskRuns/{taskRunKey}

Returns detailed information about a task run with a given task run key.

Request

Path Parameters
Header Parameters
  • Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, please provide the request ID. The only valid characters for request IDs are letters, numbers, underscore, and dash.
Back to Top

Response

Supported Media Types

200 Response

Successful operation. Details for task run with given task run key is retrieved.
Headers
  • For optimistic concurrency control. See `if-match`.
  • Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : TaskRun
Type: object
A description of a task run.
Show Source
Nested Schema : ClusterSpec
Type: object
Cluster specification snapshot of a job.
Show Source
Nested Schema : lifecycleStates
Type: array
The collection of lifecycle states.
Show Source
Nested Schema : parameters
Type: array
An optional list of parameters.
Show Source
Nested Schema : retries
Type: array
List of task retries.
Show Source
Nested Schema : State
Type: object
The current state of the run.
Show Source
  • If there was an error executing the run, this field contains any available stack traces.
  • Default Value: false
    Set to true, if the job execution is canceled by the user or by the scheduler due to timeout.
  • A descriptive message of the current state.
  • Allowed Values: [ "PENDING", "QUEUED", "RUNNING", "SKIPPED", "INTERNAL_ERROR", "BLOCKED", "SUCCESS", "FAILED", "CANCELING", "CANCELED", "UPSTREAM_CANCELED", "UPSTREAM_FAILED", "EXCLUDED", "TIMED_OUT", "PAUSED_MAINTENANCE" ]
    Current state of execution.
Nested Schema : systemParameters
Type: object
Additional Properties Allowed
Show Source
Map of system parameters with their values for this job run.
Nested Schema : Task
Type: object
Discriminator: type
Properties of a task provided by the user.
Show Source
  • dependsOn
    Specifies the dependency graph of the task. All the tasks mentioned in this field need to be completed before executing this task.
  • Default Value: false
    An optional policy to specify whether to retry a task when it times out. The default behavior is to not retry on timeout.
  • Minimum Value: 0
    Maximum Value: 300
    Default Value: 0
    The maximum number of times to retry an unsuccessful run. A run is considered to be unsuccessful if it fails with status FAILED or INTERNAL_ERROR. Maximum value is 300.
  • Minimum Value: 0
    Maximum Value: 600000
    Default Value: 0
    An optional minimal interval in milliseconds between the start of the failed run and the subsequent retry run. If value is not provided, the run would be immediately retried. Maximum value is 10 mins (600000)
  • Default Value: ALL_SUCCESS
    Allowed Values: [ "ALL_SUCCESS", "ALL_DONE", "NONE_FAILED", "AT_LEAST_ONE_SUCCESS", "ALL_FAILED", "AT_LEAST_ONE_FAILED" ]
    The trigger rule based on which the current task execution is determined.
  • Minimum Length: 1
    Maximum Length: 100
    The display name of the task. User can specify a value for this.
  • Allowed Values: [ "NOTEBOOK_TASK", "PYTHON_TASK", "SPARK_SUBMIT_TASK", "IF_ELSE_TASK", "JOB_TASK", "JAR_TASK" ]
    The type of the task.
Nested Schema : Libraries
Type: object
List of libraries to be installed on the cluster.
Show Source
Nested Schema : NewClusterConfiguration
Type: object
The cluster configuration to create a new cluster.
Show Source
Nested Schema : AutoScale
Type: object
Properties required to automatically scale the clusters up and down based on load.
Show Source
Nested Schema : LifecycleState
Type: object
The lifecycle state of execution.
Match All
The lifecycle state of execution.
The lifecycle state of execution.
The lifecycle state of execution.
Show Source
Nested Schema : LifecycleState-allOf[1]
Type: object
Nested Schema : LifecycleState-allOf[2]
Type: object
Show Source
Nested Schema : Parameter
Type: object
Specifies the name and value of the defined parameter.
Show Source
  • Pattern: ^[\w\-.]+$
    The name of the defined parameter. May only contain alphanumeric characters, '_', '-', and '.'
  • Value of the defined parameter.
Nested Schema : TaskRunRetry
Type: object
Representation of a task run retry. Maximum of 10 retries are allowed.
Show Source
Nested Schema : dependsOn
Type: array
Specifies the dependency graph of the task. All the tasks mentioned in this field need to be completed before executing this task.
Show Source
  • DependsOn
    Specifies the dependency graph of the task. All the tasks mentioned in this field need to be completed before executing this task.
Nested Schema : DependsOn
Type: object
Specifies the dependency graph of the task. All the tasks mentioned in this field need to be completed before executing this task.
Show Source

400 Response

Bad Request (invalid query parameters, malformed headers, and so on).
Headers
  • Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error information.
Show Source

401 Response

Unauthorized (missing or expired credentials, and so on).
Headers
  • Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error information.
Show Source

404 Response

Not Found. The requested resource was not found.
Headers
  • Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error information.
Show Source

429 Response

Too Many Requests. Too many requests sent to the server in a short period.
Headers
  • Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error information.
Show Source

500 Response

Internal Server Error. The server encountered an unexpected condition preventing fulfilment of the request.
Headers
  • Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error information.
Show Source

Default Response

Unknown Error. Error is not recognized by the system.
Headers
  • Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Body ()
Root Schema : Error
Type: object
Error information.
Show Source
Back to Top