JobRun - Amazon EMR on EKS

JobRun

This entity describes a job run. A job run is a unit of work, such as a Spark jar, PySpark script, or SparkSQL query, that you submit to Amazon EMR on EKS.

Contents

arn

The ARN of job run.

Type: String

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

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

Required: No

clientToken

The client token used to start a job run.

Type: String

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

Pattern: .*\S.*

Required: No

configurationOverrides

The configuration settings that are used to override default configuration.

Type: ConfigurationOverrides object

Required: No

createdAt

The date and time when the job run was created.

Type: Timestamp

Required: No

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: No

executionRoleArn

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::(\d{12})?:(role((\u002F)|(\u002F[\u0021-\u007F]+\u002F))[\w+=,.@-]+)$

Required: No

failureReason

The reasons why the job run has failed.

Type: String

Valid Values: INTERNAL_ERROR | USER_ERROR | VALIDATION_ERROR | CLUSTER_UNAVAILABLE

Required: No

finishedAt

The date and time when the job run has finished.

Type: Timestamp

Required: No

id

The ID of the job run.

Type: String

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

Pattern: [0-9a-z]+

Required: No

jobDriver

Parameters of job driver for the job run.

Type: JobDriver object

Required: No

name

The name of the job run.

Type: String

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

Pattern: [\.\-_/#A-Za-z0-9]+

Required: No

releaseLabel

The release version of Amazon EMR.

Type: String

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

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

Required: No

retryPolicyConfiguration

The configuration of the retry policy that the job runs on.

Type: RetryPolicyConfiguration object

Required: No

retryPolicyExecution

The current status of the retry policy executed on the job.

Type: RetryPolicyExecution object

Required: No

state

The state of the job run.

Type: String

Valid Values: PENDING | SUBMITTED | RUNNING | FAILED | CANCELLED | CANCEL_PENDING | COMPLETED

Required: No

stateDetails

Additional details of the job run state.

Type: String

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

Pattern: .*\S.*

Required: No

tags

The assigned tags of the job run.

Type: String to string map

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

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

Key Pattern: .*\S.*

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

Value Pattern: .*\S.*

Required: No

virtualClusterId

The ID of the job run's virtual cluster.

Type: String

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

Pattern: [0-9a-z]+

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: