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](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).

# AWS::EMRServerless::Application
<a name="aws-resource-emrserverless-application"></a>

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
<a name="aws-resource-emrserverless-application-syntax"></a>

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

### JSON
<a name="aws-resource-emrserverless-application-syntax.json"></a>

```
{
  "Type" : "AWS::EMRServerless::Application",
  "Properties" : {
      "[Architecture](#cfn-emrserverless-application-architecture)" : String,
      "[AutoStartConfiguration](#cfn-emrserverless-application-autostartconfiguration)" : AutoStartConfiguration,
      "[AutoStopConfiguration](#cfn-emrserverless-application-autostopconfiguration)" : AutoStopConfiguration,
      "[IdentityCenterConfiguration](#cfn-emrserverless-application-identitycenterconfiguration)" : IdentityCenterConfiguration,
      "[ImageConfiguration](#cfn-emrserverless-application-imageconfiguration)" : ImageConfigurationInput,
      "[InitialCapacity](#cfn-emrserverless-application-initialcapacity)" : [ InitialCapacityConfigKeyValuePair, ... ],
      "[InteractiveConfiguration](#cfn-emrserverless-application-interactiveconfiguration)" : InteractiveConfiguration,
      "[MaximumCapacity](#cfn-emrserverless-application-maximumcapacity)" : MaximumAllowedResources,
      "[MonitoringConfiguration](#cfn-emrserverless-application-monitoringconfiguration)" : MonitoringConfiguration,
      "[Name](#cfn-emrserverless-application-name)" : String,
      "[NetworkConfiguration](#cfn-emrserverless-application-networkconfiguration)" : NetworkConfiguration,
      "[ReleaseLabel](#cfn-emrserverless-application-releaselabel)" : String,
      "[RuntimeConfiguration](#cfn-emrserverless-application-runtimeconfiguration)" : [ ConfigurationObject, ... ],
      "[SchedulerConfiguration](#cfn-emrserverless-application-schedulerconfiguration)" : SchedulerConfiguration,
      "[Tags](#cfn-emrserverless-application-tags)" : [ Tag, ... ],
      "[Type](#cfn-emrserverless-application-type)" : String,
      "[WorkerTypeSpecifications](#cfn-emrserverless-application-workertypespecifications)" : {Key: Value, ...}
    }
}
```

### YAML
<a name="aws-resource-emrserverless-application-syntax.yaml"></a>

```
Type: AWS::EMRServerless::Application
Properties:
  [Architecture](#cfn-emrserverless-application-architecture): String
  [AutoStartConfiguration](#cfn-emrserverless-application-autostartconfiguration): 
    AutoStartConfiguration
  [AutoStopConfiguration](#cfn-emrserverless-application-autostopconfiguration): 
    AutoStopConfiguration
  [IdentityCenterConfiguration](#cfn-emrserverless-application-identitycenterconfiguration): 
    IdentityCenterConfiguration
  [ImageConfiguration](#cfn-emrserverless-application-imageconfiguration): 
    ImageConfigurationInput
  [InitialCapacity](#cfn-emrserverless-application-initialcapacity): 
    - InitialCapacityConfigKeyValuePair
  [InteractiveConfiguration](#cfn-emrserverless-application-interactiveconfiguration): 
    InteractiveConfiguration
  [MaximumCapacity](#cfn-emrserverless-application-maximumcapacity): 
    MaximumAllowedResources
  [MonitoringConfiguration](#cfn-emrserverless-application-monitoringconfiguration): 
    MonitoringConfiguration
  [Name](#cfn-emrserverless-application-name): String
  [NetworkConfiguration](#cfn-emrserverless-application-networkconfiguration): 
    NetworkConfiguration
  [ReleaseLabel](#cfn-emrserverless-application-releaselabel): String
  [RuntimeConfiguration](#cfn-emrserverless-application-runtimeconfiguration): 
    - ConfigurationObject
  [SchedulerConfiguration](#cfn-emrserverless-application-schedulerconfiguration): 
    SchedulerConfiguration
  [Tags](#cfn-emrserverless-application-tags): 
    - Tag
  [Type](#cfn-emrserverless-application-type): String
  [WorkerTypeSpecifications](#cfn-emrserverless-application-workertypespecifications): 
    Key: Value
```

## Properties
<a name="aws-resource-emrserverless-application-properties"></a>

`Architecture`  <a name="cfn-emrserverless-application-architecture"></a>
The CPU architecture of an application.  
*Required*: No  
*Type*: String  
*Allowed values*: `ARM64 | X86_64`  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`AutoStartConfiguration`  <a name="cfn-emrserverless-application-autostartconfiguration"></a>
The configuration for an application to automatically start on job submission.  
*Required*: No  
*Type*: [AutoStartConfiguration](aws-properties-emrserverless-application-autostartconfiguration.md)  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`AutoStopConfiguration`  <a name="cfn-emrserverless-application-autostopconfiguration"></a>
The configuration for an application to automatically stop after a certain amount of time being idle.  
*Required*: No  
*Type*: [AutoStopConfiguration](aws-properties-emrserverless-application-autostopconfiguration.md)  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`IdentityCenterConfiguration`  <a name="cfn-emrserverless-application-identitycenterconfiguration"></a>
The IAM Identity Center configuration applied to enable trusted identity propagation.  
*Required*: No  
*Type*: [IdentityCenterConfiguration](aws-properties-emrserverless-application-identitycenterconfiguration.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`ImageConfiguration`  <a name="cfn-emrserverless-application-imageconfiguration"></a>
The image configuration applied to all worker types.  
*Required*: No  
*Type*: [ImageConfigurationInput](aws-properties-emrserverless-application-imageconfigurationinput.md)  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`InitialCapacity`  <a name="cfn-emrserverless-application-initialcapacity"></a>
The initial capacity of the application.  
*Required*: No  
*Type*: Array of [InitialCapacityConfigKeyValuePair](aws-properties-emrserverless-application-initialcapacityconfigkeyvaluepair.md)  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`InteractiveConfiguration`  <a name="cfn-emrserverless-application-interactiveconfiguration"></a>
The interactive configuration object that enables the interactive use cases for an application.  
*Required*: No  
*Type*: [InteractiveConfiguration](aws-properties-emrserverless-application-interactiveconfiguration.md)  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`MaximumCapacity`  <a name="cfn-emrserverless-application-maximumcapacity"></a>
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](aws-properties-emrserverless-application-maximumallowedresources.md)  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`MonitoringConfiguration`  <a name="cfn-emrserverless-application-monitoringconfiguration"></a>
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](aws-properties-emrserverless-application-monitoringconfiguration.md)  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`Name`  <a name="cfn-emrserverless-application-name"></a>
The name of the application.  
*Required*: No  
*Type*: String  
*Pattern*: `^[A-Za-z0-9._\/#-]+$`  
*Minimum*: `1`  
*Maximum*: `64`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`NetworkConfiguration`  <a name="cfn-emrserverless-application-networkconfiguration"></a>
The network configuration for customer VPC connectivity for the application.  
*Required*: No  
*Type*: [NetworkConfiguration](aws-properties-emrserverless-application-networkconfiguration.md)  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`ReleaseLabel`  <a name="cfn-emrserverless-application-releaselabel"></a>
The EMR release associated with the application.  
*Required*: Yes  
*Type*: String  
*Pattern*: `^[A-Za-z0-9._/-]+$`  
*Minimum*: `1`  
*Maximum*: `64`  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`RuntimeConfiguration`  <a name="cfn-emrserverless-application-runtimeconfiguration"></a>
The [Configuration](https://docs.aws.amazon.com/emr-serverless/latest/APIReference/API_Configuration.html) 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](https://docs.aws.amazon.com/emr-serverless/latest/APIReference/API_GetApplication.html) API operation.  
*Required*: No  
*Type*: Array of [ConfigurationObject](aws-properties-emrserverless-application-configurationobject.md)  
*Minimum*: `0`  
*Maximum*: `100`  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`SchedulerConfiguration`  <a name="cfn-emrserverless-application-schedulerconfiguration"></a>
The scheduler configuration for batch and streaming jobs running on this application. Supported with release labels emr-7.0.0 and above.  
*Required*: No  
*Type*: [SchedulerConfiguration](aws-properties-emrserverless-application-schedulerconfiguration.md)  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

`Tags`  <a name="cfn-emrserverless-application-tags"></a>
The tags assigned to the application.  
*Required*: No  
*Type*: Array of [Tag](aws-properties-emrserverless-application-tag.md)  
*Update requires*: [No interruption](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-no-interrupt)

`Type`  <a name="cfn-emrserverless-application-type"></a>
The type of application, such as Spark or Hive.  
*Required*: Yes  
*Type*: String  
*Minimum*: `1`  
*Maximum*: `64`  
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)

`WorkerTypeSpecifications`  <a name="cfn-emrserverless-application-workertypespecifications"></a>
The specification applied to each worker type.  
*Required*: No  
*Type*: Object of [WorkerTypeSpecificationInput](aws-properties-emrserverless-application-workertypespecificationinput.md)  
*Update requires*: [Some interruptions](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-some-interrupt)

## Return values
<a name="aws-resource-emrserverless-application-return-values"></a>

### Ref
<a name="aws-resource-emrserverless-application-return-values-ref"></a>

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 [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-ref.html).

### Fn::GetAtt
<a name="aws-resource-emrserverless-application-return-values-fn--getatt"></a>

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 [https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/intrinsic-function-reference-getatt.html).

#### 
<a name="aws-resource-emrserverless-application-return-values-fn--getatt-fn--getatt"></a>

`ApplicationId`  <a name="ApplicationId-fn::getatt"></a>
The ID of the application, such as `ab4rp1abcs8xz47n3x0example`.

`Arn`  <a name="Arn-fn::getatt"></a>
The Amazon Resource Name (ARN) of the EMR Serverless Application.