Skip to Content

Reset Instance Attribute operation

The Reset Instance Attribute operations resets the specified attribute of an instance to its default value.

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

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

<items>
   <item>
       <parameters>
           <instance-id></instance-id>
           <!--You have a CHOICE of the next 2 items at this level-->
           <kernel/>
           <ramdisk/>
       </parameters>
   </item>
</items>

The following table describes the elements for this adapter request. 

Adapter request elements for the Reset Instance Attribute operation

Element

Definition

Required

<wsdl-location>

Specifies the target Web Service Description Language (WSDL) URL for Amazon EC2

Examples:

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-instance-attribute

Yes

<instance-id>

Specifies the instance ID for the instance whose attribute value is to be reset

Yes

<kernel>

Specifies the kernel ID for the instance

No

<ramdisk>

Specifies the RAM disk ID for the instance

No

The following figure shows a sample adapter request for the Reset Instance Attribute operation. 

Sample adapter request for the Reset Instance 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-instance-attribute</operation-name>
   <parameters>
       <instance-id>i-bc6c52d4</instance-id>
       <kernel/>
   </parameters>
</amazon-ec2-request>

The following figure shows the response for the sample Reset Instance Attribute operation. 

Sample adapter response for the Reset Instance Attribute operation

<amazon-ec2-response>
   <metadata>
       <status>success</status>
   </metadata>
   <ResetInstanceAttributeResponse>
       <requestId>1e7b74a6-2327-4c22-92c1-f890a5def65c</requestId>
       <return>true</return>
   </ResetInstanceAttributeResponse>
</amazon-ec2-response>

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

TrueSight Orchestration Content 21.3