We recommend new projects start with resources from the AWS provider.
published on Monday, Aug 24, 2026 by Pulumi
We recommend new projects start with resources from the AWS provider.
published on Monday, Aug 24, 2026 by Pulumi
Resource Type definition for AWS::Glue::Session. Sessions provide an on-demand, serverless Apache Spark runtime environment for building, testing, and running data preparation and analytics applications.
Create Session Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Session(name: string, args: SessionArgs, opts?: CustomResourceOptions);@overload
def Session(resource_name: str,
args: SessionArgs,
opts: Optional[ResourceOptions] = None)
@overload
def Session(resource_name: str,
opts: Optional[ResourceOptions] = None,
aws_id: Optional[str] = None,
command: Optional[SessionCommandArgs] = None,
role: Optional[str] = None,
idle_timeout: Optional[int] = None,
description: Optional[str] = None,
glue_version: Optional[str] = None,
default_arguments: Optional[Mapping[str, str]] = None,
max_capacity: Optional[float] = None,
number_of_workers: Optional[int] = None,
request_origin: Optional[str] = None,
connections: Optional[SessionConnectionsListArgs] = None,
security_configuration: Optional[str] = None,
tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
timeout: Optional[int] = None,
worker_type: Optional[SessionWorkerType] = None)func NewSession(ctx *Context, name string, args SessionArgs, opts ...ResourceOption) (*Session, error)public Session(string name, SessionArgs args, CustomResourceOptions? opts = null)
public Session(String name, SessionArgs args)
public Session(String name, SessionArgs args, CustomResourceOptions options)
type: aws-native:glue:Session
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
resource "aws-native_glue_session" "name" {
# resource properties
}Parameters
- name string
- The unique name of the resource.
- args SessionArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args SessionArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args SessionArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args SessionArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args SessionArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Session Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Session resource accepts the following input properties:
- Aws
Id string - The ID of the session.
- Command
Pulumi.
Aws Native. Glue. Inputs. Session Command - Role string
- The IAM Role ARN.
- Connections
Pulumi.
Aws Native. Glue. Inputs. Session Connections List - Default
Arguments Dictionary<string, string> - A map array of key-value pairs. Max is 75 pairs.
- Description string
- The description of the session.
- Glue
Version string - The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.
- Idle
Timeout int - The number of minutes when idle before session times out. Default is the value of Timeout.
- Max
Capacity double - The number of Glue data processing units (DPUs) that can be allocated when the job runs.
- Number
Of intWorkers - The number of workers of a defined WorkerType to use for the session.
- Request
Origin string - The origin of the request.
- Security
Configuration string - The name of the SecurityConfiguration structure to be used with the session.
-
List<Pulumi.
Aws Native. Inputs. Tag> - The tags belonging to the session.
- Timeout int
- The number of minutes before session times out.
- Worker
Type Pulumi.Aws Native. Glue. Session Worker Type - The type of predefined worker that is allocated when a session runs.
- Aws
Id string - The ID of the session.
- Command
Session
Command Args - Role string
- The IAM Role ARN.
- Connections
Session
Connections List Args - Default
Arguments map[string]string - A map array of key-value pairs. Max is 75 pairs.
- Description string
- The description of the session.
- Glue
Version string - The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.
- Idle
Timeout int - The number of minutes when idle before session times out. Default is the value of Timeout.
- Max
Capacity float64 - The number of Glue data processing units (DPUs) that can be allocated when the job runs.
- Number
Of intWorkers - The number of workers of a defined WorkerType to use for the session.
- Request
Origin string - The origin of the request.
- Security
Configuration string - The name of the SecurityConfiguration structure to be used with the session.
-
Tag
Args - The tags belonging to the session.
- Timeout int
- The number of minutes before session times out.
- Worker
Type SessionWorker Type - The type of predefined worker that is allocated when a session runs.
- aws_
id string - The ID of the session.
- command object
- role string
- The IAM Role ARN.
- connections object
- default_
arguments map(string) - A map array of key-value pairs. Max is 75 pairs.
- description string
- The description of the session.
- glue_
version string - The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.
- idle_
timeout number - The number of minutes when idle before session times out. Default is the value of Timeout.
- max_
capacity number - The number of Glue data processing units (DPUs) that can be allocated when the job runs.
- number_
of_ numberworkers - The number of workers of a defined WorkerType to use for the session.
- request_
origin string - The origin of the request.
- security_
configuration string - The name of the SecurityConfiguration structure to be used with the session.
- list(object)
- The tags belonging to the session.
- timeout number
- The number of minutes before session times out.
- worker_
type "Standard" | "G.1X" | "G.2X" | "G.025X" | "G.4X" | "G.8X" | "Z.2X" - The type of predefined worker that is allocated when a session runs.
- aws
Id String - The ID of the session.
- command
Session
Command - role String
- The IAM Role ARN.
- connections
Session
Connections List - default
Arguments Map<String,String> - A map array of key-value pairs. Max is 75 pairs.
- description String
- The description of the session.
- glue
Version String - The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.
- idle
Timeout Integer - The number of minutes when idle before session times out. Default is the value of Timeout.
- max
Capacity Double - The number of Glue data processing units (DPUs) that can be allocated when the job runs.
- number
Of IntegerWorkers - The number of workers of a defined WorkerType to use for the session.
- request
Origin String - The origin of the request.
- security
Configuration String - The name of the SecurityConfiguration structure to be used with the session.
- List<Tag>
- The tags belonging to the session.
- timeout Integer
- The number of minutes before session times out.
- worker
Type SessionWorker Type - The type of predefined worker that is allocated when a session runs.
- aws
Id string - The ID of the session.
- command
Session
Command - role string
- The IAM Role ARN.
- connections
Session
Connections List - default
Arguments {[key: string]: string} - A map array of key-value pairs. Max is 75 pairs.
- description string
- The description of the session.
- glue
Version string - The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.
- idle
Timeout number - The number of minutes when idle before session times out. Default is the value of Timeout.
- max
Capacity number - The number of Glue data processing units (DPUs) that can be allocated when the job runs.
- number
Of numberWorkers - The number of workers of a defined WorkerType to use for the session.
- request
Origin string - The origin of the request.
- security
Configuration string - The name of the SecurityConfiguration structure to be used with the session.
- Tag[]
- The tags belonging to the session.
- timeout number
- The number of minutes before session times out.
- worker
Type SessionWorker Type - The type of predefined worker that is allocated when a session runs.
- aws_
id str - The ID of the session.
- command
Session
Command Args - role str
- The IAM Role ARN.
- connections
Session
Connections List Args - default_
arguments Mapping[str, str] - A map array of key-value pairs. Max is 75 pairs.
- description str
- The description of the session.
- glue_
version str - The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.
- idle_
timeout int - The number of minutes when idle before session times out. Default is the value of Timeout.
- max_
capacity float - The number of Glue data processing units (DPUs) that can be allocated when the job runs.
- number_
of_ intworkers - The number of workers of a defined WorkerType to use for the session.
- request_
origin str - The origin of the request.
- security_
configuration str - The name of the SecurityConfiguration structure to be used with the session.
-
Sequence[Tag
Args] - The tags belonging to the session.
- timeout int
- The number of minutes before session times out.
- worker_
type SessionWorker Type - The type of predefined worker that is allocated when a session runs.
- aws
Id String - The ID of the session.
- command Property Map
- role String
- The IAM Role ARN.
- connections Property Map
- default
Arguments Map<String> - A map array of key-value pairs. Max is 75 pairs.
- description String
- The description of the session.
- glue
Version String - The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.
- idle
Timeout Number - The number of minutes when idle before session times out. Default is the value of Timeout.
- max
Capacity Number - The number of Glue data processing units (DPUs) that can be allocated when the job runs.
- number
Of NumberWorkers - The number of workers of a defined WorkerType to use for the session.
- request
Origin String - The origin of the request.
- security
Configuration String - The name of the SecurityConfiguration structure to be used with the session.
- List<Property Map>
- The tags belonging to the session.
- timeout Number
- The number of minutes before session times out.
- worker
Type "Standard" | "G.1X" | "G.2X" | "G.025X" | "G.4X" | "G.8X" | "Z.2X" - The type of predefined worker that is allocated when a session runs.
Outputs
All input properties are implicitly available as output properties. Additionally, the Session resource produces the following output properties:
- Arn string
- The Amazon Resource Name (ARN) of the session.
- Created
On string - The time and date when the session was created.
- Id string
- The provider-assigned unique ID for this managed resource.
- Progress double
- The code execution progress of the session.
- Status
Pulumi.
Aws Native. Glue. Session Status - The session status.
- arn string
- The Amazon Resource Name (ARN) of the session.
- created_
on string - The time and date when the session was created.
- id string
- The provider-assigned unique ID for this managed resource.
- progress number
- The code execution progress of the session.
- status "PROVISIONING" | "READY" | "FAILED" | "TIMEOUT" | "STOPPING" | "STOPPED"
- The session status.
- arn str
- The Amazon Resource Name (ARN) of the session.
- created_
on str - The time and date when the session was created.
- id str
- The provider-assigned unique ID for this managed resource.
- progress float
- The code execution progress of the session.
- status
Session
Status - The session status.
- arn String
- The Amazon Resource Name (ARN) of the session.
- created
On String - The time and date when the session was created.
- id String
- The provider-assigned unique ID for this managed resource.
- progress Number
- The code execution progress of the session.
- status "PROVISIONING" | "READY" | "FAILED" | "TIMEOUT" | "STOPPING" | "STOPPED"
- The session status.
Supporting Types
SessionCommand, SessionCommandArgs
The SessionCommand that runs the job.- Name string
- Specifies the name of the SessionCommand. Can be 'glueetl' or 'gluestreaming'.
- Python
Version string - Specifies the Python version. The Python version indicates the version supported for jobs of type Spark.
- Name string
- Specifies the name of the SessionCommand. Can be 'glueetl' or 'gluestreaming'.
- Python
Version string - Specifies the Python version. The Python version indicates the version supported for jobs of type Spark.
- name string
- Specifies the name of the SessionCommand. Can be 'glueetl' or 'gluestreaming'.
- python_
version string - Specifies the Python version. The Python version indicates the version supported for jobs of type Spark.
- name String
- Specifies the name of the SessionCommand. Can be 'glueetl' or 'gluestreaming'.
- python
Version String - Specifies the Python version. The Python version indicates the version supported for jobs of type Spark.
- name string
- Specifies the name of the SessionCommand. Can be 'glueetl' or 'gluestreaming'.
- python
Version string - Specifies the Python version. The Python version indicates the version supported for jobs of type Spark.
- name str
- Specifies the name of the SessionCommand. Can be 'glueetl' or 'gluestreaming'.
- python_
version str - Specifies the Python version. The Python version indicates the version supported for jobs of type Spark.
- name String
- Specifies the name of the SessionCommand. Can be 'glueetl' or 'gluestreaming'.
- python
Version String - Specifies the Python version. The Python version indicates the version supported for jobs of type Spark.
SessionConnectionsList, SessionConnectionsListArgs
Specifies the connections used by the session.- Connections List<string>
- A list of connection names used by the session.
- Connections []string
- A list of connection names used by the session.
- connections list(string)
- A list of connection names used by the session.
- connections List<String>
- A list of connection names used by the session.
- connections string[]
- A list of connection names used by the session.
- connections Sequence[str]
- A list of connection names used by the session.
- connections List<String>
- A list of connection names used by the session.
SessionStatus, SessionStatusArgs
- Provisioning
PROVISIONING- Ready
READY- Failed
FAILED- Timeout
TIMEOUT- Stopping
STOPPING- Stopped
STOPPED
- Session
Status Provisioning PROVISIONING- Session
Status Ready READY- Session
Status Failed FAILED- Session
Status Timeout TIMEOUT- Session
Status Stopping STOPPING- Session
Status Stopped STOPPED
- "PROVISIONING"
PROVISIONING- "READY"
READY- "FAILED"
FAILED- "TIMEOUT"
TIMEOUT- "STOPPING"
STOPPING- "STOPPED"
STOPPED
- Provisioning
PROVISIONING- Ready
READY- Failed
FAILED- Timeout
TIMEOUT- Stopping
STOPPING- Stopped
STOPPED
- Provisioning
PROVISIONING- Ready
READY- Failed
FAILED- Timeout
TIMEOUT- Stopping
STOPPING- Stopped
STOPPED
- PROVISIONING
PROVISIONING- READY
READY- FAILED
FAILED- TIMEOUT
TIMEOUT- STOPPING
STOPPING- STOPPED
STOPPED
- "PROVISIONING"
PROVISIONING- "READY"
READY- "FAILED"
FAILED- "TIMEOUT"
TIMEOUT- "STOPPING"
STOPPING- "STOPPED"
STOPPED
SessionWorkerType, SessionWorkerTypeArgs
- Standard
Standard- G1x
G.1X- G2x
G.2X- G025x
G.025X- G4x
G.4X- G8x
G.8X- Z2x
Z.2X
- Session
Worker Type Standard Standard- Session
Worker Type G1x G.1X- Session
Worker Type G2x G.2X- Session
Worker Type G025x G.025X- Session
Worker Type G4x G.4X- Session
Worker Type G8x G.8X- Session
Worker Type Z2x Z.2X
- "Standard"
Standard- "G.1X"
G.1X- "G.2X"
G.2X- "G.025X"
G.025X- "G.4X"
G.4X- "G.8X"
G.8X- "Z.2X"
Z.2X
- Standard
Standard- G1x
G.1X- G2x
G.2X- G025x
G.025X- G4x
G.4X- G8x
G.8X- Z2x
Z.2X
- Standard
Standard- G1x
G.1X- G2x
G.2X- G025x
G.025X- G4x
G.4X- G8x
G.8X- Z2x
Z.2X
- STANDARD
Standard- G1X
G.1X- G2X
G.2X- G025X
G.025X- G4X
G.4X- G8X
G.8X- Z2X
Z.2X
- "Standard"
Standard- "G.1X"
G.1X- "G.2X"
G.2X- "G.025X"
G.025X- "G.4X"
G.4X- "G.8X"
G.8X- "Z.2X"
Z.2X
Tag, TagArgs
A set of tags to apply to the resource.Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
published on Monday, Aug 24, 2026 by Pulumi