Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-142021,119944.8 KB

Creates a new session.

post/#X-Amz-Target=AWSGlue.CreateSession

Headers

X-Amz-Target'AWSGlue.CreateSession' required

Request body

Idstring required

The ID of the session request.

Descriptionstring

The description of the session.

Rolestring required

The IAM Role ARN

Timeoutinteger

The number of minutes before session times out. Default for Spark ETL jobs is 48 hours (2880 minutes), the maximum session lifetime for this job type. Consult the documentation for other job types.

IdleTimeoutinteger

The number of minutes when idle before session times out. Default for Spark ETL jobs is value of Timeout. Consult the documentation for other job types.

DefaultArgumentsobject

A map array of key-value pairs. Max is 75 pairs.

MaxCapacitynumber double

The number of Glue data processing units (DPUs) that can be allocated when the job runs. A DPU is a relative measure of processing power that consists of 4 vCPUs of compute capacity and 16 GB memory.

NumberOfWorkersinteger

The number of workers of a defined <code>WorkerType</code> to use for the session.

WorkerType'Standard' | 'G.1X' | 'G.2X' | 'G.025X'
<p>The type of predefined worker that is allocated to use for the session. Accepts a value of Standard, G.1X, G.2X, or G.025X.</p> <ul> <li> <p>For the <code>Standard</code> worker type, each worker provides 4 vCPU, 16 GB of memory and a 50GB disk, and 2 executors per worker.</p> </li> <li> <p>For the <code>G.1X</code> worker type, each worker maps to 1 DPU (4 vCPU, 16 GB of memory, 64 GB disk), and provides 1 executor per worker. We recommend this worker type for memory-intensive jobs.</p> </li> <li> <p>For the <code>G.2X</code> worker type, each worker maps to 2 DPU (8 vCPU, 32 GB of memory, 128 GB disk), and provides 1 executor per worker. We recommend this worker type for memory-intensive jobs.</p> </li> <li> <p>For the <code>G.025X</code> worker type, each worker maps to 0.25 DPU (2 vCPU, 4 GB of memory, 64 GB disk), and provides 1 executor per worker. We recommend this worker type for low volume streaming jobs. This worker type is only available for Glue version 3.0 streaming jobs.</p> </li> </ul>
SecurityConfigurationstring

The name of the SecurityConfiguration structure to be used with the session

GlueVersionstring

The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.

Tagsobject

The map of key value pairs (tags) belonging to the session.

RequestOriginstring

The origin of the request.

Response

Success