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...

ResetInstanceAttribute

Description

Resets an attribute of an instance to its default value. To reset the kernel or RAM disk, the instance must be in a stopped state. To reset the SourceDestCheck, the instance can be either running or stopped.

The SourceDestCheck attribute exists to enable a Network Address Translation (NAT) instance in a VPC to perform NAT. The attribute controls whether source/destination checking is enabled on the instance. The default value is true, which means checking is enabled. The value must be false for the instance to perform NAT. For more information, go to NAT Instances in the Amazon Virtual Private Cloud User Guide.

Request Parameters

NameDescriptionRequired

InstanceId

ID of the instance.

Type: String

Default: None

Yes

Attribute

Attribute to reset.

Type: String

Default: None

Valid Values: kernel | ramdisk | sourceDestCheck

Yes

Response Elements

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

NameDescription

requestId

The ID of the request.

Type: xsd:string

return

Returns true if the request succeeds. Otherwise, returns an error.

Type: xsd:boolean

Examples

Example Request

This example resets the kernel attribute.

https://ec2.amazonaws.com/?Action=ResetInstanceAttribute
&InstanceId=i-10a64379
&Attribute=kernel
&AUTHPARAMS

Example Response

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