Glue / Client / get_session

get_session

Glue.Client.get_session(**kwargs)

Retrieves the session.

See also: AWS API Documentation

Request Syntax

response = client.get_session(
    Id='string',
    RequestOrigin='string'
)
Parameters:

  • Id (string) –

    [REQUIRED]

    The ID of the session.

  • RequestOrigin (string) – The origin of the request.

Return type:

dict

Returns:

Response Syntax

{
    'Session': {
        'Id': 'string',
        'CreatedOn': datetime(2015, 1, 1),
        'Status': 'PROVISIONING'|'READY'|'FAILED'|'TIMEOUT'|'STOPPING'|'STOPPED',
        'ErrorMessage': 'string',
        'Description': 'string',
        'Role': 'string',
        'Command': {
            'Name': 'string',
            'PythonVersion': 'string'
        },
        'DefaultArguments': {
            'string': 'string'
        },
        'Connections': {
            'Connections': [
                'string',
            ]
        },
        'Progress': 123.0,
        'MaxCapacity': 123.0,
        'SecurityConfiguration': 'string',
        'GlueVersion': 'string',
        'NumberOfWorkers': 123,
        'WorkerType': 'Standard'|'G.1X'|'G.2X'|'G.4X'|'G.8X'|'G.025X'|'Z.2X'|'G.12X'|'G.16X'|'R.1X'|'R.2X'|'R.4X'|'R.8X',
        'CompletedOn': datetime(2015, 1, 1),
        'ExecutionTime': 123.0,
        'DPUSeconds': 123.0,
        'IdleTimeout': 123,
        'ProfileName': 'string',
        'SessionType': 'LIVY'|'SPARK_CONNECT'
    }
}

Response Structure

  • (dict) –

    • Session (dict) –

      The session object is returned in the response.

      • Id (string) –

        The ID of the session.

      • CreatedOn (datetime) –

        The time and date when the session was created.

      • Status (string) –

        The session status.

      • ErrorMessage (string) –

        The error message displayed during the session.

      • Description (string) –

        The description of the session.

      • Role (string) –

        The name or Amazon Resource Name (ARN) of the IAM role associated with the Session.

      • Command (dict) –

        The command object.See SessionCommand.

        • 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.

      • DefaultArguments (dict) –

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

        • (string) –

          • (string) –

      • Connections (dict) –

        The number of connections used for the session.

        • Connections (list) –

          A list of connections used by the job.

          • (string) –

      • Progress (float) –

        The code execution progress of the session.

      • MaxCapacity (float) –

        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.

      • SecurityConfiguration (string) –

        The name of the SecurityConfiguration structure to be used with 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.

      • NumberOfWorkers (integer) –

        The number of workers of a defined WorkerType to use for the session.

      • WorkerType (string) –

        The type of predefined worker that is allocated when a session runs. Accepts a value of G.1X, G.2X, G.4X, G.8X, G.12X, G.16X, R.1X, R.2X, R.4X, or R.8X for Spark sessions. Accepts the value Z.2X for Ray sessions.

        The G.12X, G.16X, and R.1X through R.8X worker types are available only for Glue version 4.0 or later Spark ETL jobs in select Amazon Web Services Regions. For the supported Regions, see Configuring job properties for Spark jobs in the developer guide.

      • CompletedOn (datetime) –

        The date and time that this session is completed.

      • ExecutionTime (float) –

        The total time the session ran for.

      • DPUSeconds (float) –

        The DPUs consumed by the session (formula: ExecutionTime * MaxCapacity).

      • IdleTimeout (integer) –

        The number of minutes when idle before the session times out.

      • ProfileName (string) –

        The name of an Glue usage profile associated with the session.

      • SessionType (string) –

        The type of the session.

Exceptions