Amazon Elastic Compute Cloud

2018/05/10 - Amazon Elastic Compute Cloud - 1 updated api methods

Changes  Enable support for latest flag with Get Console Output

GetConsoleOutput (updated) Link ΒΆ
Changes (request)
{'Latest': 'boolean'}

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 output from the EC2Config service.

GetConsoleOutput returns up to 64 KB of console output shortly after it's generated by the instance.

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.

You can optionally retrieve the latest serial console output at any time during the instance lifecycle. This option is only supported on C5, M5, and i3.metal instances.

See also: AWS API Documentation

Request Syntax

client.get_console_output(
    InstanceId='string',
    DryRun=True|False,
    Latest=True|False
)
type InstanceId

string

param InstanceId

[REQUIRED]

The ID of the instance.

type DryRun

boolean

param DryRun

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 .

type Latest

boolean

param Latest

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

Default: disabled ( false )

rtype

dict

returns

Response Syntax

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

Response Structure

  • (dict) --

    Contains the output of GetConsoleOutput.

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