Application - Amazon EMR Serverless
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Application

Information about an application. Amazon EMR Serverless uses applications to run jobs.

Contents

applicationId

The ID of the application.

Type: String

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

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

Required: Yes

arn

The ARN of the application.

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]+$

Required: Yes

createdAt

The date and time when the application run was created.

Type: Timestamp

Required: Yes

releaseLabel

The Amazon EMR release associated with the application.

Type: String

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

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

Required: Yes

state

The state of the application.

Type: String

Valid Values: CREATING | CREATED | STARTING | STARTED | STOPPING | STOPPED | TERMINATED

Required: Yes

type

The type of application, such as Spark or Hive.

Type: String

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

Required: Yes

updatedAt

The date and time when the application run was last updated.

Type: Timestamp

Required: Yes

architecture

The CPU architecture of an application.

Type: String

Valid Values: ARM64 | X86_64

Required: No

autoStartConfiguration

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

Type: AutoStartConfig object

Required: No

autoStopConfiguration

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

Type: AutoStopConfig object

Required: No

imageConfiguration

The image configuration applied to all worker types.

Type: ImageConfiguration object

Required: No

initialCapacity

The initial capacity of the application.

Type: String to InitialCapacityConfig object map

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

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

Key Pattern: ^[a-zA-Z]+[-_]*[a-zA-Z]+$

Required: No

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.

Type: MaximumAllowedResources object

Required: No

monitoringConfiguration

The configuration setting for monitoring.

Type: MonitoringConfiguration object

Required: No

name

The name of the application.

Type: String

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

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

Required: No

networkConfiguration

The network configuration for customer VPC connectivity for the application.

Type: NetworkConfiguration object

Required: No

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.

Type: Array of Configuration objects

Array Members: Minimum number of 0 items. Maximum number of 100 items.

Required: No

stateDetails

The state details of the application.

Type: String

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

Pattern: .*\S.*

Required: No

tags

The tags assigned to the application.

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

workerTypeSpecifications

The specification applied to each worker type.

Type: String to WorkerTypeSpecification object map

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

Key Pattern: ^[a-zA-Z]+[-_]*[a-zA-Z]+$

Required: No

See Also

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