AWS::EMRServerless::Application

The AWS::EMRServerless::Application resource specifies an EMR Serverless application. An application uses open source analytics frameworks to run jobs that process data. To create an application, you must specify the release version for the open source framework version you want to use and the type of application you want, such as Apache Spark or Apache Hive. After you create an application, you can submit data processing jobs or interactive requests to it.

Syntax

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

JSON

{
  "Type" : "AWS::EMRServerless::Application",
  "Properties" : {
      "Architecture" : String,
      "AutoStartConfiguration" : AutoStartConfiguration,
      "AutoStopConfiguration" : AutoStopConfiguration,
      "ImageConfiguration" : ImageConfigurationInput,
      "InitialCapacity" : [ InitialCapacityConfigKeyValuePair, ... ],
      "MaximumCapacity" : MaximumAllowedResources,
      "MonitoringConfiguration" : MonitoringConfiguration,
      "Name" : String,
      "NetworkConfiguration" : NetworkConfiguration,
      "ReleaseLabel" : String,
      "RuntimeConfiguration" : [ ConfigurationObject, ... ],
      "Tags" : [ Tag, ... ],
      "Type" : String,
      "WorkerTypeSpecifications" : {Key: Value, ...}
    }
}

YAML

Type: AWS::EMRServerless::Application
Properties:
  Architecture: String
  AutoStartConfiguration: 
    AutoStartConfiguration
  AutoStopConfiguration: 
    AutoStopConfiguration
  ImageConfiguration: 
    ImageConfigurationInput
  InitialCapacity: 
    - InitialCapacityConfigKeyValuePair
  MaximumCapacity: 
    MaximumAllowedResources
  MonitoringConfiguration: 
    MonitoringConfiguration
  Name: String
  NetworkConfiguration: 
    NetworkConfiguration
  ReleaseLabel: String
  RuntimeConfiguration: 
    - ConfigurationObject
  Tags: 
    - Tag
  Type: String
  WorkerTypeSpecifications: 
    Key: Value

Properties

Architecture

The CPU architecture of an application.

Required: No

Type: String

Allowed values: ARM64 | X86_64

Update requires: Some interruptions

AutoStartConfiguration

The configuration for an application to automatically start on job submission.

Required: No

Type: AutoStartConfiguration

Update requires: Some interruptions

AutoStopConfiguration

The configuration for an application to automatically stop after a certain amount of time being idle.

Required: No

Type: AutoStopConfiguration

Update requires: Some interruptions

ImageConfiguration

The image configuration applied to all worker types.

Required: No

Type: ImageConfigurationInput

Update requires: Some interruptions

InitialCapacity

The initial capacity of the application.

Required: No

Type: Array of InitialCapacityConfigKeyValuePair

Update requires: Some interruptions

MaximumCapacity

The maximum capacity of the application. This is cumulative across all workers at any given point in time during the lifespan of the application is created. No new resources will be created once any one of the defined limits is hit.

Required: No

Type: MaximumAllowedResources

Update requires: Some interruptions

MonitoringConfiguration

A configuration specification to be used when provisioning an application. A configuration consists of a classification, properties, and optional nested configurations. A classification refers to an application-specific configuration file. Properties are the settings you want to change in that file.

Required: No

Type: MonitoringConfiguration

Update requires: Some interruptions

Name

The name of the application.

Required: No

Type: String

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

Minimum: 1

Maximum: 64

Update requires: Replacement

NetworkConfiguration

The network configuration for customer VPC connectivity for the application.

Required: No

Type: NetworkConfiguration

Update requires: Some interruptions

ReleaseLabel

The EMR release associated with the application.

Required: Yes

Type: String

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

Minimum: 1

Maximum: 64

Update requires: Some interruptions

RuntimeConfiguration

The Configuration specifications of an application. Each configuration consists of a classification and properties. You use this parameter when creating or updating an application. To see the runtimeConfiguration object of an application, run the GetApplication API operation.

Required: No

Type: Array of ConfigurationObject

Minimum: 0

Maximum: 100

Update requires: Some interruptions

Tags

The tags assigned to the application.

Required: No

Type: Array of Tag

Update requires: No interruption

Type

The type of application, such as Spark or Hive.

Required: Yes

Type: String

Minimum: 1

Maximum: 64

Update requires: Replacement

WorkerTypeSpecifications

The specification applied to each worker type.

Required: No

Type: Object of WorkerTypeSpecificationInput

Update requires: Some interruptions

Return values

Ref

When you pass the logical ID of this resource to the intrinsic Ref function, Ref returns the ID of the application.

For more information about using the Ref function, see Ref.

Fn::GetAtt

The Fn::GetAtt intrinsic function returns a value for a specified attribute of this type. The following are the available attributes and sample return values.

For more information about using the Fn::GetAtt intrinsic function, see Fn::GetAtt.

ApplicationId

The ID of the application, such as ab4rp1abcs8xz47n3x0example.

Arn

The Amazon Resource Name (ARN) of the project.