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.025X'|'G.4X'|'G.8X'|'Z.2X',
        'CompletedOn': datetime(2015, 1, 1),
        'ExecutionTime': 123.0,
        'DPUSeconds': 123.0,
        'IdleTimeout': 123
    }
}

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, or G.8X for Spark sessions. Accepts the value Z.2X for Ray sessions.

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

Exceptions

• Glue.Client.exceptions.AccessDeniedException

• Glue.Client.exceptions.EntityNotFoundException

• Glue.Client.exceptions.InternalServiceException

• Glue.Client.exceptions.OperationTimeoutException

• Glue.Client.exceptions.InvalidInputException