EC2 / Client / get_console_output

get_console_output#

EC2.Client.get_console_output(**kwargs)#

Gets the console output for the specified instance. For Linux instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a computer. For Windows instances, the instance console output includes the last three system event log errors.

By default, the console output returns buffered information that was posted shortly after an instance transition state (start, stop, reboot, or terminate). This information is available for at least one hour after the most recent post. Only the most recent 64 KB of console output is available.

You can optionally retrieve the latest serial console output at any time during the instance lifecycle. This option is supported on instance types that use the Nitro hypervisor.

For more information, see Instance console output in the Amazon EC2 User Guide.

See also: AWS API Documentation

Request Syntax

response = client.get_console_output(
    InstanceId='string',
    DryRun=True|False,
    Latest=True|False
)
Parameters:

  • InstanceId (string) –

    [REQUIRED]

    The ID of the instance.

  • DryRun (boolean) – Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

  • Latest (boolean) –

    When enabled, retrieves the latest console output for the instance.

    Default: disabled ( false)

Return type:

dict

Returns:

Response Syntax

{
    'InstanceId': 'string',
    'Output': 'string',
    'Timestamp': datetime(2015, 1, 1)
}

Response Structure

  • (dict) –

    • InstanceId (string) –

      The ID of the instance.

    • Output (string) –

      The console output, base64-encoded. If you are using a command line tool, the tool decodes the output for you.

    • Timestamp (datetime) –

      The time at which the output was last updated.

Examples

This example gets the console output for the specified instance.

response = client.get_console_output(
    InstanceId='i-1234567890abcdef0',
)

print(response)

Expected Output:

{
    'InstanceId': 'i-1234567890abcdef0',
    'Output': '...',
    'Timestamp': datetime(2018, 5, 25, 21, 23, 53, 4, 145, 0),
    'ResponseMetadata': {
        '...': '...',
    },
}