Amazon Elastic Compute Cloud
API Reference (API Version 2011-12-15)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

RebootInstances

Description

Requests a reboot of one or more instances. This operation is asynchronous; it only queues a request to reboot the specified instance(s). The operation will succeed if the instances are valid and belong to you. Requests to reboot terminated instances are ignored.

[Note]Note

If a Linux/UNIX instance does not cleanly shut down within four minutes, Amazon EC2 will perform a hard reboot.

Request Parameters

NameDescriptionRequired

InstanceId.n

One or more instance IDs.

Type: String

Default: None

Yes

Response Elements

The elements in the following table are wrapped in a RebootInstancesResponse structure.

NameDescription

requestId

The ID of the request.

Type: xsd:string

return

Returns true if successful. Otherwise, returns an error.

Type: xsd:boolean

Examples

Example Request

This example reboots two instances.

https://ec2.amazonaws.com/?Action=RebootInstances
&InstanceId.1=i-1a2b3c4d
&InstanceId.2=i-4d3acf62
&AUTHPARAMS

Example Response

<RebootInstancesResponse xmlns="http://ec2.amazonaws.com/doc/2011-12-15/">
  <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
  <return>true</return>
</RebootInstancesResponse>