---
title: "POST /applications"
method: POST
path: "/applications"
---

# POST /applications

`POST /applications`

Creates an application.

## Request body

- object
  - `name` string — The name of the application.
  - `releaseLabel` string, required — The Amazon EMR release associated with the application.
  - `type` string, required — The type of application you want to start, such as Spark or Hive.
  - `clientToken` string, required — The client idempotency token of the application to create. Its value must be unique for each request.
  - `initialCapacity` object — The capacity to initialize when the application is created.
  - `maximumCapacity` object — The maximum allowed cumulative resources for an application. No new resources will be created once the limit is hit.
    - `cpu` string — The maximum allowed CPU for an application.
    - `memory` string — The maximum allowed resources for an application.
    - `disk` string — The maximum allowed disk for an application.
  - `tags` object — The tags assigned to the application.
  - `autoStartConfiguration` object — The configuration for an application to automatically start on job submission.
    - `enabled` boolean — Enables the application to automatically start on job submission. Defaults to true.
  - `autoStopConfiguration` object — The configuration for an application to automatically stop after a certain amount of time being idle.
    - `enabled` boolean — Enables the application to automatically stop after a certain amount of time being idle. Defaults to true.
    - `idleTimeoutMinutes` integer — The amount of idle time in minutes after which your application will automatically stop. Defaults to 15 minutes.
  - `networkConfiguration` object — The network configuration for customer VPC connectivity.
    - `subnetIds` SubnetString[] — The array of subnet Ids for customer VPC connectivity.
    - `securityGroupIds` SecurityGroupString[] — The array of security group Ids for customer VPC connectivity.
  - `architecture` 'ARM64' | 'X86_64' — The CPU architecture of an application.
  - `imageConfiguration` object — The image configuration.
    - `imageUri` string — The URI of an image in the Amazon ECR registry. This field is required when you create a new application. If you leave this field blank in an update, Amazon EMR will remove the image configuration.
    - `applicationLevelDigestResolution` boolean — Boolean value indicating if the digest resolution is application level or workload level. If true, a custom image URI is resolved at application start time and all workloads submitted will use that image digest. If false, the custom image URI is resolved at the workload submission time.
  - `workerTypeSpecifications` object — The key-value pairs that specify worker type to <code>WorkerTypeSpecificationInput</code>. This parameter must contain all valid worker types for a Spark or Hive application. Valid worker types include <code>Driver</code> and <code>Executor</code> for Spark applications and <code>HiveDriver</code> and <code>TezTask</code> for Hive applications. You can either set image details in this parameter for each worker type, or in <code>imageConfiguration</code> for all worker types.
  - `runtimeConfiguration` Configuration[] — The <a href="https://docs.aws.amazon.com/emr-serverless/latest/APIReference/API_Configuration.html">Configuration</a> specifications to use when creating an application. Each configuration consists of a classification and properties. This configuration is applied to all the job runs submitted under the application.
    - `classification` string, required — The classification within a configuration.
    - `properties` unknown
    - `configurations` Configuration[] — A list of additional configurations to apply within a configuration object.
  - `monitoringConfiguration` object — The configuration setting for monitoring.
    - `s3MonitoringConfiguration` object — The Amazon S3 configuration for monitoring log publishing.
      - `logUri` string — The Amazon S3 destination URI for log publishing.
      - `encryptionKeyArn` string — The KMS key ARN to encrypt the logs published to the given Amazon S3 destination.
    - `managedPersistenceMonitoringConfiguration` object — The managed log persistence configuration for a job run.
      - `enabled` boolean — Enables managed logging and defaults to true. If set to false, managed logging will be turned off.
      - `encryptionKeyArn` string — The KMS key ARN to encrypt the logs stored in managed log persistence.
    - `cloudWatchLoggingConfiguration` object — The Amazon CloudWatch configuration for monitoring logs. You can configure your jobs to send log information to CloudWatch.
      - `enabled` boolean, required — Enables CloudWatch logging.
      - `logGroupName` string — The name of the log group in Amazon CloudWatch Logs where you want to publish your logs.
      - `logStreamNamePrefix` string — Prefix for the CloudWatch log stream name.
      - `encryptionKeyArn` string — The Key Management Service (KMS) key ARN to encrypt the logs that you store in CloudWatch Logs.
      - `logTypes` object — <p>The types of logs that you want to publish to CloudWatch. If you don't specify any log types, driver STDOUT and STDERR logs will be published to CloudWatch Logs by default. For more information including the supported worker types for Hive and Spark, see <a href="https://docs.aws.amazon.com/emr/latest/EMR-Serverless-UserGuide/logging.html#jobs-log-storage-cw">Logging for EMR Serverless with CloudWatch</a>.</p> <ul> <li> <p> <b>Key Valid Values</b>: <code>SPARK_DRIVER</code>, <code>SPARK_EXECUTOR</code>, <code>HIVE_DRIVER</code>, <code>TEZ_TASK</code> </p> </li> <li> <p> <b>Array Members Valid Values</b>: <code>STDOUT</code>, <code>STDERR</code>, <code>HIVE_LOG</code>, <code>TEZ_AM</code>, <code>SYSTEM_LOGS</code> </p> </li> </ul>
    - `prometheusMonitoringConfiguration` object — The monitoring configuration object you can configure to send metrics to Amazon Managed Service for Prometheus for a job run.
      - `remoteWriteUrl` string — The remote write URL in the Amazon Managed Service for Prometheus workspace to send metrics to.
  - `diskEncryptionConfiguration` object — The configuration object that allows encrypting local disks.
    - `encryptionContext` object — Specifies the optional encryption context that will be used when encrypting the data. An encryption context is a collection of non-secret key-value pairs that represent additional authenticated data.
    - `encryptionKeyArn` string — The KMS key ARN to encrypt local disks.
  - `interactiveConfiguration` object — The configuration to use to enable the different types of interactive use cases in an application.
    - `studioEnabled` boolean — Enables you to connect an application to Amazon EMR Studio to run interactive workloads in a notebook.
    - `livyEndpointEnabled` boolean — Enables an Apache Livy endpoint that you can connect to and run interactive jobs.
    - `sessionEnabled` boolean — Enables interactive sessions on the application. When set to <code>true</code>, you can start interactive sessions using the <code>StartSession</code> operation.
  - `schedulerConfiguration` object — The scheduler configuration for batch and streaming jobs running on this application. Supported with release labels emr-7.0.0 and above.
    - `queueTimeoutMinutes` integer — The maximum duration in minutes for the job in QUEUED state. If scheduler configuration is enabled on your application, the default value is 360 minutes (6 hours). The valid range is from 15 to 720.
    - `maxConcurrentRuns` integer — The maximum concurrent job runs on this application. If scheduler configuration is enabled on your application, the default value is 15. The valid range is 1 to 1000.
  - `identityCenterConfiguration` object — The IAM Identity Center Configuration accepts the Identity Center instance parameter required to enable trusted identity propagation. This configuration allows identity propagation between integrated services and the Identity Center instance.
    - `identityCenterInstanceArn` string — The ARN of the IAM Identity Center instance.
    - `userBackgroundSessionsEnabled` boolean — Enables user background sessions for this application so Livy sessions can continue running after users log out of their interactive notebook or their Identity Center sessions expire.
  - `jobLevelCostAllocationConfiguration` object — The configuration object that enables job level cost allocation.
    - `enabled` boolean — Enables job level cost allocation for the application.

## Response `200`

Success

- CreateApplicationResponse
  - `applicationId` string, required — The output contains the application ID.
  - `name` string — The output contains the name of the application.
  - `arn` string, required — The output contains the ARN of the application.

## Other responses

- `480` — ValidationException
- `481` — InternalServerException
- `482` — ResourceNotFoundException
- `483` — ConflictException

---

[API](https://skmtc.net/aws/apis/emr-serverless.md) · [All operations](https://skmtc.net/aws/apis/emr-serverless/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/emr-serverless/versions/d7a4ce0af1b7/schema)