Amazon Elastic Compute Cloud
API Reference (API Version 2014-10-01)
Did this page help you?  Yes | No |  Tell us about it...
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.



Gets the console output for the specified instance.

Instances do not have a physical monitor through which you can view their console output. They also lack physical controls that allow you to power up, reboot, or shut them down. To allow these actions, we provide them through the Amazon EC2 API and command line interface.

Instance console output is buffered and posted shortly after instance boot, reboot, and termination. Amazon EC2 preserves the most recent 64 KB output which is available for at least one hour after the most recent post.

For Linux/Unix instances, the instance console output displays the exact console output that would normally be displayed on a physical monitor attached to a machine. This output is buffered because the instance produces it and then posts it to a store where the instance's owner can retrieve it.

For Windows instances, the instance console output displays the last three system event log errors.

Request Parameters

For information about the common parameters that all actions use, see Common Query Parameters.


The ID of the instance.

Type: String

Default: None

Required: Yes

Response Elements

The following elements are returned in a GetConsoleOutputResponse element.


The ID of the request.

Type: xsd:string


The ID of the instance.

Type: xsd:string


The time the output was last updated.

Type: xsd:dateTime


The console output, Base64 encoded.

Type: xsd:string


The following are some of the client API errors you might encounter when using this request. For more information about common API errors, see Common Causes of Client Errors. For a summary of API error codes, see Client Error Codes.


Example Request

This example retrieves the console output for the specified instance.

Example Response

<GetConsoleOutputResponse xmlns="">