Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1422181132.4 KB

Creates and starts a new session on the specified application. The application must be in the <code>STARTED</code> state or have <code>AutoStart</code> enabled, and have interactive sessions enabled. This operation is supported for EMR release 7.13.0 and later.

post/applications/{applicationId}/sessions

Path parameters

applicationIdstring required

The ID of the application on which to start the session.

Request body

clientTokenstring required

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If you retry a request that completed successfully using the same client token, the server returns the successful response without performing the operation again.

executionRoleArnstring required

The execution role ARN for the session. Amazon EMR Serverless uses this role to access Amazon Web Services resources on your behalf during session execution.

tagsobject

The tags to assign to the session.

idleTimeoutMinutesinteger

The idle timeout in minutes for the session. After the session remains idle for this duration, Amazon EMR Serverless automatically terminates it.

namestring

The optional name for the session.

Response

Success

applicationIdstring required

The output contains the application ID on which the session was started.

sessionIdstring required

The output contains the ID of the session.

arnstring required

The output contains the ARN of the session.