Menu
Amazon Elastic Compute Cloud
API Reference (API Version 2016-11-15)

GetConsoleOutput

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.

Request Parameters

The following parameters are for this specific action. For more information about required and optional parameters that are common to all actions, see Common Query Parameters.

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: Boolean

Required: No

InstanceId

The ID of the instance.

Type: String

Required: Yes

Latest

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

Default: disabled (false)

Type: Boolean

Required: No

Response Elements

The following elements are returned by the service.

instanceId

The ID of the instance.

Type: String

output

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

Type: String

requestId

The ID of the request.

Type: String

timestamp

The time at which the output was last updated.

Type: Timestamp

Errors

For information about the errors that are common to all actions, see Common Client Errors.

Examples

Example 1

This example retrieves the console output for the specified instance.

Sample Request

https://ec2.amazonaws.com/?Action=GetConsoleOutput &InstanceId=i-1234567890abcdef0 &AUTHPARAMS

Sample Response

<GetConsoleOutputResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/"> <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> <instanceId>i-1234567890abcdef0</instanceId> <timestamp>2010-10-14T01:12:41.000Z</timestamp> <output>TGludXggdmVyc2lvbiAyLjYuMTYteGVuVSAoYnVpbGRlckBwYXRjaGJhdC5hbWF6b25zYSkgKGdj YyB2ZXJzaW9uIDQuMC4xIDIwMDUwNzI3IChSZWQgSGF0IDQuMC4xLTUpKSAjMSBTTVAgVGh1IE9j dCAyNiAwODo0MToyNiBTQVNUIDIwMDYKQklPUy1wcm92aWRlZCBwaHlzaWNhbCBSQU0gbWFwOgpY ZW46IDAwMDAwMDAwMDAwMDAwMDAgLSAwMDAwMDAwMDZhNDAwMDAwICh1c2FibGUpCjk4ME1CIEhJ R0hNRU0gYXZhaWxhYmxlLgo3MjdNQiBMT1dNRU0gYXZhaWxhYmxlLgpOWCAoRXhlY3V0ZSBEaXNh YmxlKSBwcm90ZWN0aW9uOiBhY3RpdmUKSVJRIGxvY2t1cCBkZXRlY3Rpb24gZGlzYWJsZWQKQnVp bHQgMSB6b25lbGlzdHMKS2VybmVsIGNvbW1hbmQgbGluZTogcm9vdD0vZGV2L3NkYTEgcm8gNApF bmFibGluZyBmYXN0IEZQVSBzYXZlIGFuZCByZXN0b3JlLi4uIGRvbmUuCg==</output> </GetConsoleOutputResponse>

Example 2

This example retrieves the latest console output for the specified instance.

Sample Request

https://ec2.amazonaws.com/?Action=GetConsoleOutput &InstanceId=i-1234567890abcdef0 &Latest=true &AUTHPARAMS

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: