Reset Image Attribute operation

The Reset Image Attribute operation resets an attribute of an Amazon Machine Image (AMI) to its default value.

The following figure shows a sample <items> XML element for the Reset Image Attribute operation:

Sample <items> XML element for the Reset Image Attribute operation

The following table describes the elements for this adapter request:

Adapter request elements for the Reset Image Attribute operation

Element	Definition	Required
<wsdl-location>	Specifies the target Web Service Description Language (WSDL) URL for Amazon EC2 Examples: http://ec2.amazonaws.com/doc/2009-11-30/ http://ec2.amazonaws.com/doc/2011-02-28/	Conditional: Required if not specified in the request If specified in the configuration and request, the value in the request overrides the value in the configuration
<endpoint-address>	Specifies the web service endpoint for the adapter to use while performing operations on Amazon EC2 instances across different regions Default value: US East region: http://us-east-1.ec2.amazonaws.com/	No
<signature-properties>	Specifies the mode for signing the adapter request	Conditional: Required if not specified in the configuration If <signature-properties mode = "key-files">, requires <private-key-file> and <certificate-file> If <signature-properties mode = "key-data">, requires <private-key-data> and <certificate-data>
<operation-name>	Contains the name of the operation: reset-image-attribute	Yes
<image-id>	Specifies the ID of the AMI on which the attribute is to be reset	Yes
<launch-permission>	Specifies the launch permissions set for the AMI This attribute is reset for the specified instance.	No

The following figure shows a sample adapter request for the Reset Image Attribute operation:

Sample adapter request for the Reset Image Attribute operation

<amazon-ec2-request>
   <wsdl-location>http://ec2.amazonaws.com/doc/2009-11-30/</wsdl-location>
    endpoint-address>http://us-east-1.ec2.amazonaws.com/</endpoint-address>
   <signature-properties mode = "key-files">
       <private-key-file>C:\Security\
pk-MJ5GIUNLM2XJ3VRJSYTKOFDWILELDQHB.PEM</private-key-file>
       <certificate-file>C:\Security\
cert-MJ5GIUNLM2XJ3VRJSYTKOFDWILELDQHB.PEM</certificate-file>
   </signature-properties>
   <operation-name>reset-image-attribute</operation-name>
   <parameters>
       <image-id>ami-82e301eb</image-id>
       <launch-permission/>
   </parameters>
</amazon-ec2-request>

The following figure shows a sample adapter response for the Reset Image Attribute operation:

Sample adapter response for the Reset Image Attribute operation

<amazon-ec2-response>
   <metadata>
       <status>success</status>
   </metadata>
   <ResetImageAttributeResponse>
       <requestId>7e05155d-a7f8-47d2-ac39-c0a17bb5e860</requestId>
       <return>true</return>
   </ResetImageAttributeResponse>
</amazon-ec2-response>

Reset Image Attribute operation

On this page