View a markdown version of this page

AWS::EMRServerless::JobRun - AWS CloudFormation
SyntaxPropertiesReturn values

This is the new CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS CloudFormation User Guide.

AWS::EMRServerless::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.

Syntax

To declare this entity in your CloudFormation template, use the following syntax:

JSON

{
  "Type" : "AWS::EMRServerless::JobRun",
  "Properties" : {
      "ApplicationId" : String,
      "ConfigurationOverrides" : ConfigurationOverrides,
      "ExecutionRoleArn" : String,
      "ExecutionTimeoutMinutes" : Integer,
      "JobDriver" : JobDriver,
      "Mode" : String,
      "Name" : String,
      "Tags" : [ Tag, ... ]
    }
}

YAML

Type: AWS::EMRServerless::JobRun
Properties:
  ApplicationId: String
  ConfigurationOverrides: 
    ConfigurationOverrides
  ExecutionRoleArn: String
  ExecutionTimeoutMinutes: Integer
  JobDriver: 
    JobDriver
  Mode: String
  Name: String
  Tags: 
    - Tag

Properties

ApplicationId

The ID of the application the job is running on.

Required: No

Type: String

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

Minimum: 1

Maximum: 64

Update requires: Replacement

ConfigurationOverrides

The configuration settings that are used to override default configuration.

Required: No

Type: ConfigurationOverrides

Update requires: Replacement

ExecutionRoleArn

Property description not available.

Required: No

Type: String

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

Minimum: 20

Maximum: 2048

Update requires: Replacement

ExecutionTimeoutMinutes

Returns the job run timeout value from the StartJobRun call. If you didn't specify a timeout, this value defaults to 720 minutes.

For BATCH mode job runs, the maximum value is 10080 minutes (7 days) starting with Amazon EMR release 7.11.

Required: No

Type: Integer

Minimum: 0

Maximum: 1000000

Update requires: Replacement

JobDriver

The job driver for the job run.

Required: No

Type: JobDriver

Update requires: Replacement

Mode

The mode of the job run.

Required: No

Type: String

Allowed values: BATCH | STREAMING

Update requires: Replacement

Name

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

Required: No

Type: String

Pattern: .*\S.*

Minimum: 1

Maximum: 256

Update requires: Replacement

Tags

The tags assigned to the job run.

Required: No

Type: Array of Tag

Maximum: 200

Update requires: Replacement

Return values

Ref

Fn::GetAtt

Arn

The execution role ARN of the job run.

CreatedAt

The date and time when the job run was created.

CreatedBy

The user who created the job run.

JobRunId

The ID of the job run.

ReleaseLabel

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

State

The state of the job run.

StateDetails

The state details of the job run.

UpdatedAt

The date and time when the job run was updated.