Skip to main content

console_screenshots

Creates, updates, deletes, gets or lists a console_screenshots resource.

Overview

Nameconsole_screenshots
TypeResource
Idaws.ec2.console_screenshots

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
image_datastringThe data that comprises the image.
instance_idstringThe ID of the instance.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_console_screenshotselectInstanceId, regionDryRun, WakeUpRetrieve a JPG-format screenshot of a running instance to help with troubleshooting. The returned content is Base64-encoded. For more information, see Instance console output in the Amazon EC2 User Guide.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
InstanceIdstringThe ID of the instance.
regionstringAWS region (default: us-east-1)
DryRunbooleanChecks whether you have the required permissions for the operation, 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.
WakeUpbooleanWhen set to true, acts as keystroke input and wakes up an instance that's in standby or "sleep" mode.

SELECT examples

Retrieve a JPG-format screenshot of a running instance to help with troubleshooting. The returned content is Base64-encoded. For more information, see Instance console output in the Amazon EC2 User Guide.

SELECT
image_data,
instance_id
FROM aws.ec2.console_screenshots
WHERE InstanceId = '{{ InstanceId }}' -- required
AND region = '{{ region }}' -- required
AND DryRun = '{{ DryRun }}'
AND WakeUp = '{{ WakeUp }}'
;