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 24.3