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.
Contents
- 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::(\d{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
Valid Values:
SUBMITTED | PENDING | SCHEDULED | RUNNING | SUCCESS | FAILED | CANCELLING | CANCELLED
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
- billedResourceUtilization
-
The aggregate vCPU, memory, and storage that Amazon 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
- 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
- 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
-
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
, orCANCELLED
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
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: