JobRun

Information about a job run. A job run is a unit of work, such as a Spark JAR, Hive query, or SparkSQL query, that you submit to an Amazon EMR Serverless application.

applicationId

The ID of the application the job is running on.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: ^[0-9a-z]+$

Required: Yes

arn

The execution role ARN of the job run.

Type: String

Length Constraints: Minimum length of 60. Maximum length of 1024.

Pattern: ^arn:(aws[a-zA-Z0-9-]*):emr-serverless:.+:(\d{12}):\/applications\/[0-9a-zA-Z]+\/jobruns\/[0-9a-zA-Z]+$

Required: Yes

createdAt

The date and time when the job run was created.

Type: Timestamp

Required: Yes

createdBy

The user who created the job run.

Type: String

Length Constraints: Minimum length of 20. Maximum length of 2048.

Pattern: ^arn:(aws[a-zA-Z0-9-]*):(iam|sts)::(\d{12})?:[\w/+=,.@-]+$

Required: Yes

executionRole

The execution role ARN of the job run.

Type: String

Length Constraints: Minimum length of 20. Maximum length of 2048.

Pattern: ^arn:(aws[a-zA-Z0-9-]*):iam::([0-9]{12}):(role((\u002F)|(\u002F[\u0021-\u007F]+\u002F))[\w+=,.@-]+)$

Required: Yes

jobDriver

The job driver for the job run.

Type: JobDriver object

Note: This object is a Union. Only one member of this object can be specified or returned.

Required: Yes

jobRunId

The ID of the job run.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: ^[0-9a-z]+$

Required: Yes

releaseLabel

The Amazon EMR release associated with the application your job is running on.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: ^[A-Za-z0-9._/-]+$

Required: Yes

state

The state of the job run.

Type: String

Required: Yes

stateDetails

The state details of the job run.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Pattern: .*\S.*

Required: Yes

updatedAt

The date and time when the job run was updated.

Type: Timestamp

Required: Yes

attempt

The attempt of the job run.

Type: Integer

Valid Range: Minimum value of 1.

Required: No

attemptCreatedAt

The date and time of when the job run attempt was created.

Type: Timestamp

Required: No

attemptUpdatedAt

The date and time of when the job run attempt was last updated.

Type: Timestamp

Required: No

billedResourceUtilization

The aggregate vCPU, memory, and storage that AWS has billed for the job run. The billed resources include a 1-minute minimum usage for workers, plus additional storage over 20 GB per worker. Note that billed resources do not include usage for idle pre-initialized workers.

Type: ResourceUtilization object

Required: No

configurationOverrides

The configuration settings that are used to override default configuration.

Type: ConfigurationOverrides object

Required: No

endedAt

The date and time when the job was terminated.

Type: Timestamp

Required: No

executionTimeoutMinutes

Returns the job run timeout value from the StartJobRun call. If no timeout was specified, then it returns the default timeout of 720 minutes.

Type: Long

Valid Range: Minimum value of 0. Maximum value of 1000000.

Required: No

mode

The mode of the job run.

Type: String

Valid Values: BATCH | STREAMING

Required: No

name

The optional job run name. This doesn't have to be unique.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 256.

Pattern: .*\S.*

Required: No

networkConfiguration

The network configuration for customer VPC connectivity.

Type: NetworkConfiguration object

Required: No

queuedDurationMilliseconds

The total time for a job in the QUEUED state in milliseconds.

Type: Long

Required: No

retryPolicy

The retry policy of the job run.

Type: RetryPolicy object

Required: No

startedAt

The date and time when the job moved to the RUNNING state.

Type: Timestamp

Required: No

tags

The tags assigned to the job run.

Type: String to string map

Map Entries: Minimum number of 0 items. Maximum number of 200 items.

Key Length Constraints: Minimum length of 1. Maximum length of 128.

Key Pattern: ^[A-Za-z0-9 /_.:=+@-]+$

Value Length Constraints: Minimum length of 0. Maximum length of 256.

Value Pattern: ^[A-Za-z0-9 /_.:=+@-]*$

Required: No

totalExecutionDurationSeconds

The job run total execution duration in seconds. This field is only available for job runs in a COMPLETED, FAILED, or CANCELLED state.

Type: Integer

Required: No

totalResourceUtilization

The aggregate vCPU, memory, and storage resources used from the time the job starts to execute, until the time the job terminates, rounded up to the nearest second.

Type: TotalResourceUtilization object

Required: No

JobRun

Contents

See Also