1. Registry
  2. Packages
  3. AWS Cloud Control
  4. API Docs
  5. glue
  6. Session

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.76.0
published on Monday, Aug 24, 2026 by Pulumi
aws-native logo aws-native logo

We recommend new projects start with resources from the AWS provider.

Viewing docs for AWS Cloud Control v1.76.0
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:

    AwsId string
    The ID of the session.
    Command Pulumi.AwsNative.Glue.Inputs.SessionCommand
    Role string
    The IAM Role ARN.
    Connections Pulumi.AwsNative.Glue.Inputs.SessionConnectionsList
    DefaultArguments Dictionary<string, string>
    A map array of key-value pairs. Max is 75 pairs.
    Description string
    The description of the session.
    GlueVersion string
    The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.
    IdleTimeout int
    The number of minutes when idle before session times out. Default is the value of Timeout.
    MaxCapacity double
    The number of Glue data processing units (DPUs) that can be allocated when the job runs.
    NumberOfWorkers int
    The number of workers of a defined WorkerType to use for the session.
    RequestOrigin string
    The origin of the request.
    SecurityConfiguration string
    The name of the SecurityConfiguration structure to be used with the session.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    The tags belonging to the session.
    Timeout int
    The number of minutes before session times out.
    WorkerType Pulumi.AwsNative.Glue.SessionWorkerType
    The type of predefined worker that is allocated when a session runs.
    AwsId string
    The ID of the session.
    Command SessionCommandArgs
    Role string
    The IAM Role ARN.
    Connections SessionConnectionsListArgs
    DefaultArguments map[string]string
    A map array of key-value pairs. Max is 75 pairs.
    Description string
    The description of the session.
    GlueVersion string
    The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.
    IdleTimeout int
    The number of minutes when idle before session times out. Default is the value of Timeout.
    MaxCapacity float64
    The number of Glue data processing units (DPUs) that can be allocated when the job runs.
    NumberOfWorkers int
    The number of workers of a defined WorkerType to use for the session.
    RequestOrigin string
    The origin of the request.
    SecurityConfiguration string
    The name of the SecurityConfiguration structure to be used with the session.
    Tags TagArgs
    The tags belonging to the session.
    Timeout int
    The number of minutes before session times out.
    WorkerType SessionWorkerType
    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_workers number
    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.
    tags 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.
    awsId String
    The ID of the session.
    command SessionCommand
    role String
    The IAM Role ARN.
    connections SessionConnectionsList
    defaultArguments Map<String,String>
    A map array of key-value pairs. Max is 75 pairs.
    description String
    The description of the session.
    glueVersion String
    The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.
    idleTimeout Integer
    The number of minutes when idle before session times out. Default is the value of Timeout.
    maxCapacity Double
    The number of Glue data processing units (DPUs) that can be allocated when the job runs.
    numberOfWorkers Integer
    The number of workers of a defined WorkerType to use for the session.
    requestOrigin String
    The origin of the request.
    securityConfiguration String
    The name of the SecurityConfiguration structure to be used with the session.
    tags List<Tag>
    The tags belonging to the session.
    timeout Integer
    The number of minutes before session times out.
    workerType SessionWorkerType
    The type of predefined worker that is allocated when a session runs.
    awsId string
    The ID of the session.
    command SessionCommand
    role string
    The IAM Role ARN.
    connections SessionConnectionsList
    defaultArguments {[key: string]: string}
    A map array of key-value pairs. Max is 75 pairs.
    description string
    The description of the session.
    glueVersion string
    The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.
    idleTimeout number
    The number of minutes when idle before session times out. Default is the value of Timeout.
    maxCapacity number
    The number of Glue data processing units (DPUs) that can be allocated when the job runs.
    numberOfWorkers number
    The number of workers of a defined WorkerType to use for the session.
    requestOrigin string
    The origin of the request.
    securityConfiguration string
    The name of the SecurityConfiguration structure to be used with the session.
    tags Tag[]
    The tags belonging to the session.
    timeout number
    The number of minutes before session times out.
    workerType SessionWorkerType
    The type of predefined worker that is allocated when a session runs.
    aws_id str
    The ID of the session.
    command SessionCommandArgs
    role str
    The IAM Role ARN.
    connections SessionConnectionsListArgs
    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_workers int
    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.
    tags Sequence[TagArgs]
    The tags belonging to the session.
    timeout int
    The number of minutes before session times out.
    worker_type SessionWorkerType
    The type of predefined worker that is allocated when a session runs.
    awsId String
    The ID of the session.
    command Property Map
    role String
    The IAM Role ARN.
    connections Property Map
    defaultArguments Map<String>
    A map array of key-value pairs. Max is 75 pairs.
    description String
    The description of the session.
    glueVersion String
    The Glue version determines the versions of Apache Spark and Python that Glue supports. The GlueVersion must be greater than 2.0.
    idleTimeout Number
    The number of minutes when idle before session times out. Default is the value of Timeout.
    maxCapacity Number
    The number of Glue data processing units (DPUs) that can be allocated when the job runs.
    numberOfWorkers Number
    The number of workers of a defined WorkerType to use for the session.
    requestOrigin String
    The origin of the request.
    securityConfiguration String
    The name of the SecurityConfiguration structure to be used with the session.
    tags List<Property Map>
    The tags belonging to the session.
    timeout Number
    The number of minutes before session times out.
    workerType "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.
    CreatedOn 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.AwsNative.Glue.SessionStatus
    The session status.
    Arn string
    The Amazon Resource Name (ARN) of the session.
    CreatedOn string
    The time and date when the session was created.
    Id string
    The provider-assigned unique ID for this managed resource.
    Progress float64
    The code execution progress of the session.
    Status SessionStatus
    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 String
    The Amazon Resource Name (ARN) of the session.
    createdOn 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 SessionStatus
    The session status.
    arn string
    The Amazon Resource Name (ARN) of the session.
    createdOn 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 SessionStatus
    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 SessionStatus
    The session status.
    arn String
    The Amazon Resource Name (ARN) of the session.
    createdOn 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'.
    PythonVersion 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'.
    PythonVersion 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'.
    pythonVersion 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'.
    pythonVersion 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'.
    pythonVersion 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
    SessionStatusProvisioning
    PROVISIONING
    SessionStatusReady
    READY
    SessionStatusFailed
    FAILED
    SessionStatusTimeout
    TIMEOUT
    SessionStatusStopping
    STOPPING
    SessionStatusStopped
    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
    SessionWorkerTypeStandard
    Standard
    SessionWorkerTypeG1x
    G.1X
    SessionWorkerTypeG2x
    G.2X
    SessionWorkerTypeG025x
    G.025X
    SessionWorkerTypeG4x
    G.4X
    SessionWorkerTypeG8x
    G.8X
    SessionWorkerTypeZ2x
    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.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo aws-native logo

    We recommend new projects start with resources from the AWS provider.

    Viewing docs for AWS Cloud Control v1.76.0
    published on Monday, Aug 24, 2026 by Pulumi

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial