Amazon Elastic Compute Cloud
API Reference (API Version 2013-02-01)
AWS Documentation » Amazon EC2 » API Reference » Actions » ResetImageAttribute
« 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...

ResetImageAttribute

Description

Resets an attribute of an AMI to its default value.

Note

The productCodes attribute cannot be reset.

Request Parameters

ImageId

The ID of the AMI.

Type: String

Default: None

Required: Yes

Attribute

The attribute to reset (currently you can only reset the launch permission attribute).

Type: String

Default: None

Valid value: launchPermission

Required: Yes

Response Elements

The following elements are returned in a ResetImageAttributeResponse 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 launchPermission attribute for the specified AMI.

https://ec2.amazonaws.com/?Action=ResetImageAttribute
&ImageId=ami-61a54008
&Attribute=launchPermission
&AUTHPARAMS

Example Response

<ResetImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
  <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
  <return>true</return>
</ResetImageAttributeResponse>
Document Conventions« PreviousNext »
Terms of UseDid this page help you?  Yes | No |  Tell us about it...