Utility_Operations for the Amazon EC2 REST adapter
This section illustrates the adapter request and response for the Get Console Output Utility operation.
Get Console Output operation
The Get Console Output operation retrieves console output for a specified instance.
The console output for an instance is buffered and posted after an instance is booted, rebooted, or terminated. Amazon EC2 preserves the most recent 64 KB output, which is available for at least one hour after the latest post to the console output.
The following figure shows the sample <items> XML element for the Get Console Output operation.
Sample <items> XML element for the Get Console Output operation
<item>
<parameters>
<instance-id></instance-id>
</parameters>
</item>
</items>
The following table describes the adapter request elements for the Get Console Output operation.
Adapter request elements for the Get Console Output operation
Element | Definition | Required |
---|---|---|
<access-key> | Specifies the Amazon Web Services (AWS) access key You need to generate the AWS access key by going to the Security Credentials tab in the AWS console. | Conditional;
|
<secret-key> | Specifies the AWS secret access key You need to generate the AWS secret access key by going to the Security Credentials tab in the AWS console. | Conditional;
|
<region> | Specifies the region with which you want the adapter to communicate Amazon EC2 is hosted in multiple locations world-wide. You must specify the region in which you want the adapter to perform the actions. Valid values:
| No |
<operation-name> | Contains the name of the operation: get-console-output | Yes |
<instance-id> | Specifies the ID of the instance for which you want console output | Yes |
The following figure shows a sample adapter request for the Get Console Output operation.
Sample adapter request for the Get Console Output operation
<operation-name>get-console-output</operation-name>
<access-key>AKIA**********N8BT2Q</access-key>
<secret-key>WQisk8Irh********************8AiJx3VQVd</secret-key>
<region>us-east-1</region>
<parameters>
<instance-id>i-1420b93a</instance-id>
</parameters>
</amazon-ec2-rest-request>
The following figure shows the response for the sample adapter request for the Get Console Output operation.
Sample adapter response for the Get Console Output operation
<metadata>
<status>success</status>
</metadata>
<GetConsoleOutputResponse>
<instanceId>i-1420b93a</instanceId>
<timestamp>Mon Feb 03 12:51:47 GMT+05:30 2014</timestamp>
<output><![CDATA[Xen Minimal OS!
start_info: 0xae2000(VA)
nr_pages: 0x26700
shared_inf: 0x7ed22000(MA)
pt_base: 0xae5000(VA)
nr_pt_frames: 0x9
mfn_list: 0x9ae000(VA)
mod_start: 0x0(VA)
mod_len: 0
flags: 0x0
cmd_line: root=/dev/sda1 ro 4
stack: 0x96d840-0x98d840
MM: Init
_text: 0x0(VA)
_etext: 0x7dc7d(VA)
_erodata: 0x9a000(VA)
_edata: 0x9fce0(VA)
stack start: 0x96d840(VA)
_end: 0x9ade40(VA)
start_pfn: af1
max_pfn: 26700
Mapping memory range 0xc00000 - 0x26700000
setting 0x0-0x9a000 readonly
skipped 0x1000
MM: Initialise page allocator for c1f000(c1f000)-26700000(26700000)
MM: done
Demand map pfns at 26701000-2026701000.
Heap resides at 2026702000-4026702000.
Initialising timer interface
Initialising console ... done.
gnttab_table mapped at 0x26701000.
Initialising scheduler
Thread "Idle": pointer: 0x2026702050, stack: 0x26660000
Thread "xenstore": pointer: 0x2026702800, stack: 0x26670000
xenbus initialised on irq 1 mfn 0xe2c3e7
Thread "shutdown": pointer: 0x2026702fb0, stack: 0x26680000
Dummy main: start_info=0x98d940
Thread "main": pointer: 0x2026703760, stack: 0x26690000
"main" "root=/dev/sda1" "ro" "4"
vbd 2049 is hd0
****************** BLKFRONT for device/vbd/2049 *********
...........................................................
...........................................................
Starting atd: [ OK ]
Running cloud-init user-scripts (none found)[ OK ]
Amazon Linux AMI release 2013.09
Kernel 3.4.73-64.112.amzn1.x86_64 on an x86_64
ip-10-73-184-69 login: ]]>
</output>
</GetConsoleOutputResponse>
</amazon-ec2-rest-response>