Amazon Elastic Compute Cloud
API Reference (API Version 2013-02-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did 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, see NAT Instances in the Amazon Virtual Private Cloud User Guide.

Request Parameters

InstanceId

The ID of the instance.

Type: String

Default: None

Required: Yes

Attribute

The attribute to reset.

Type: String

Default: None

Valid values: kernel | ramdisk | sourceDestCheck

Required: Yes

Response Elements

The following elements are returned in a ResetInstanceAttributeResponse element.

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-1a2b3c4d
&Attribute=kernel
&AUTHPARAMS

Example Response

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