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
-
aiDataPlatformId(required): string
The [OCID](/iaas/Content/General/Concepts/identifiers.htm) of the AI Data Platform (Data Lake) instance.
-
taskRunKey(required): string
Task run key.
-
workspaceKey(required): string
The key of the Workspace
Header Parameters
-
opc-request-id: string
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.
Response
Supported Media Types
- application/json
200 Response
Successful operation. Details for task run with given task run key is retrieved.
Headers
-
etag: string
For optimistic concurrency control. See `if-match`.
-
opc-request-id: string
Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : TaskRun
Type:
objectA description of a task run.
Show Source
-
cleanupDuration:
integer(int64)
The time (in milliseconds) taken to terminate the cluster and to clean up any associated artifacts.
-
clusterSpec:
object ClusterSpec
Cluster specification snapshot of a job.
-
clusterValidationStartTime:
integer(int64)
The time at which the cluster validation started in epoch milliseconds.
-
endTime:
integer(int64)
The time at which the job execution started in epoch milliseconds.
-
executionDuration:
integer(int64)
The time (in milliseconds) taken to complete the job execution.
-
externalId:
string
The external ID of the task execution.
-
jobKey:
string
The OCID of the job.
-
jobRunKey:
string
The OCID of the job.
-
key(required):
string
The OCID of the task run.
-
lifecycleStates:
array lifecycleStates
The collection of lifecycle states.
-
name(required):
string
A user-friendly name. Does not have to be unique, and is changeable.
-
outputKey:
string
Minimum Length:
1Maximum Length:100A unique identifier for the output. -
parameters:
array parameters
An optional list of parameters.
-
parentJobRunKey:
string
The OCID of the job.
-
retries:
array retries
List of task retries.
-
retryAttempt:
integer(int32)
Sequence number of the current retry attempt. 0 for the original. 1, 2, 3, ... for subsequent retry attempts.
-
rootJobRunKey:
string
The OCID of the job.
-
setupDuration:
integer(int64)
The time (in milliseconds) taken to setup the cluster.
-
startTime:
integer(int64)
The time at which the job execution started in epoch milliseconds.
-
state:
object State
The current state of the run.
-
systemParameters:
object systemParameters
Additional Properties Allowed: additionalPropertiesMap of system parameters with their values for this job run.
-
task:
object Task
Discriminator:
typeProperties of a task provided by the user. -
taskKey:
string
Minimum Length:
1Maximum Length:100The display name of the task. User can specify a value for this. -
version:
integer(int32)
Current version of job run object in repository.
Nested Schema : ClusterSpec
Type:
objectCluster specification snapshot of a job.
Show Source
-
existingClusterKey:
string
The key of the cluster.
-
libraries:
object Libraries
List of libraries to be installed on the cluster.
-
newCluster:
object NewClusterConfiguration
The cluster configuration to create a new cluster.
Nested Schema : lifecycleStates
Type:
arrayThe collection of lifecycle states.
Show Source
-
Array of:
object LifecycleState
The lifecycle state of execution.
Nested Schema : parameters
Type:
arrayAn optional list of parameters.
Show Source
-
Array of:
object Parameter
Specifies the name and value of the defined parameter.
Nested Schema : retries
Type:
arrayList of task retries.
Show Source
-
Array of:
object TaskRunRetry
Representation of a task run retry. Maximum of 10 retries are allowed.
Nested Schema : State
Type:
objectThe current state of the run.
Show Source
-
errorTrace:
string
If there was an error executing the run, this field contains any available stack traces.
-
isUserCanceledOrTimedOut:
boolean
Default Value:
falseSet to true, if the job execution is canceled by the user or by the scheduler due to timeout. -
stateMessage:
string
A descriptive message of the current state.
-
status:
string
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:
objectAdditional Properties Allowed
Show Source
Map of system parameters with their values for this job run.
Nested Schema : Task
Type:
objectDiscriminator:
typeProperties of a task provided by the user.
Show Source
-
dependsOn:
array dependsOn
Specifies the dependency graph of the task. All the tasks mentioned in this field need to be completed before executing this task.
-
isRetryOnTimeout:
boolean
Default Value:
falseAn optional policy to specify whether to retry a task when it times out. The default behavior is to not retry on timeout. -
maxRetries:
integer(int32)
Minimum Value:
0Maximum Value:300Default Value:0The 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. -
minRetryIntervalMillis:
integer(int32)
Minimum Value:
0Maximum Value:600000Default Value:0An 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) -
runIf(required):
string
Default Value:
ALL_SUCCESSAllowed 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. -
taskKey(required):
string
Minimum Length:
1Maximum Length:100The display name of the task. User can specify a value for this. -
type(required):
string
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:
objectList of libraries to be installed on the cluster.
Show Source
-
jar:
string
URI of the jar to be installed.
Nested Schema : NewClusterConfiguration
Type:
objectThe cluster configuration to create a new cluster.
Show Source
-
autoScale:
object AutoScale
Properties required to automatically scale the clusters up and down based on load.
-
clusterName:
string
Minimum Length:
1Maximum Length:100A unique name for the job cluster. -
numWorkers:
integer(int32)
Number of worker nodes configured for this cluster.
-
sparkConf:
string
The spark configuration in key-value pairs.
-
sparkVersion:
string
The Spark version used to run the application.
Nested Schema : AutoScale
Type:
objectProperties required to automatically scale the clusters up and down based on load.
Show Source
-
maxWorkers:
integer(int32)
The maximum number of workers to which the cluster can scale up when overloaded.
-
minWorkers:
integer(int32)
The minimum number of workers to which the cluster can scale down when underused.
Nested Schema : LifecycleState
Type:
objectThe lifecycle state of execution.
Match All
The lifecycle state of execution.
The lifecycle state of execution.
The lifecycle state of execution.
Show Source
-
object
State
The current state of the run.
-
object
LifecycleState-allOf[1]
-
object
LifecycleState-allOf[2]
Nested Schema : LifecycleState-allOf[1]
Type:
objectNested Schema : LifecycleState-allOf[2]
Type:
Show Source
object-
endTime:
integer(int64)
The time at which the job execution started in epoch milliseconds.
-
startTime:
integer(int64)
The time at which the job execution started in epoch milliseconds.
Nested Schema : Parameter
Type:
objectSpecifies the name and value of the defined parameter.
Show Source
-
name(required):
string
Pattern:
^[\w\-.]+$The name of the defined parameter. May only contain alphanumeric characters, '_', '-', and '.' -
value:
string
Value of the defined parameter.
Nested Schema : TaskRunRetry
Type:
objectRepresentation of a task run retry. Maximum of 10 retries are allowed.
Show Source
-
cleanupDuration:
integer(int64)
The time (in milliseconds) taken to terminate the cluster and to clean up any associated artifacts.
-
clusterValidationStartTime:
integer(int64)
The time at which the cluster validation started in epoch milliseconds.
-
endTime:
integer(int64)
The time at which the job execution started in epoch milliseconds.
-
executionDuration:
integer(int64)
The time (in milliseconds) taken to complete the job execution.
-
externalId:
string
The external ID of the task execution.
-
outputKey:
string
Minimum Length:
1Maximum Length:100A unique identifier for the output. -
retryNumber:
integer(int32)
Sequence number of the retry attempt. 0 for the original. 1, 2, 3, ... for subsequent retry attempts.
-
setupDuration:
integer(int64)
The time (in milliseconds) taken to setup the cluster.
-
startTime:
integer(int64)
The time at which the job execution started in epoch milliseconds.
-
state:
object State
The current state of the run.
Nested Schema : dependsOn
Type:
arraySpecifies the dependency graph of the task. All the tasks mentioned in this field need to be completed before executing this task.
Show Source
-
Array of:
object 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:
objectSpecifies the dependency graph of the task. All the tasks mentioned in this field need to be completed before executing this task.
Show Source
-
outcome:
string
Specified on condition task dependencies. The outcome of the dependent task should be met for this task to be executed.
-
taskKey(required):
string
The name of the task that it depends on.
400 Response
Bad Request (invalid query parameters, malformed headers, and so on).
Headers
-
opc-request-id: string
Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error message.
401 Response
Unauthorized (missing or expired credentials, and so on).
Headers
-
opc-request-id: string
Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error message.
404 Response
Not Found. The requested resource was not found.
Headers
-
opc-request-id: string
Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error message.
429 Response
Too Many Requests. Too many requests sent to the server in a short period.
Headers
-
opc-request-id: string
Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error message.
500 Response
Internal Server Error. The server encountered an unexpected condition preventing fulfilment of the request.
Headers
-
opc-request-id: string
Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error message.
Default Response
Unknown Error. Error is not recognized by the system.
Headers
-
opc-request-id: string
Unique Oracle-assigned ID for the request. If you need to contact Oracle about a particular request, please provide the request ID.
Root Schema : Error
Type:
objectError information.
Show Source
-
code(required):
string
A short error code that defines the error, meant for programmatic parsing.
-
message(required):
string
A human-readable error message.