Find Alert by Alert ID operation


The Find Alert by Alert ID operation finds an alert by using the specified alert ID.

The following table describes the elements for the <items> XML element and adapter request for the Find Alert by Alert ID operation:

 Elements for the <items> XML element and adapter request for the Find Alert by Alert ID operation

The following figure shows the <items> XML element for the Find Alert by Alert ID operation:

 <items> XML element for the Find Alert by Alert ID operation

 <items>
<!--1 or more-->
 <operation-parameter>
   <search-parameters>
     <alert-id></alert-id>
   </search-parameters>
</items>

The following figure shows a sample adapter request for the Find Alert by Alert ID operation:

 Sample adapter request for the Find Alert by Alert ID operation

 <mom-request>
 <operation-name>get_data</operation-name>
 <operation-parameter>
   <search-parameters>
     <alert-id>632c4a2c-1e31-4097-a332-847bcb52bb62</alert-id>
   </search-parameters>
 </operation-parameter>
</mom-request>

The following table describes the adapter response elements for the Find Alert by Alert ID operation:

 Adapter response elements for the Find Alert by Alert ID operation

The following figure illustrates the adapter response for the sample Find Alert by Alert ID operation:

 Sample adapter response for the Find Alert by Alert ID operation

 <mom-response>
 <metadata>
   <status>success</status>
 </metadata>
 <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns:xsd="http://www.w3.org/2001/XMLSchema"xmlns:soap="http://
schemas.xmlssoap.org/soap/envelope/"
>
   <soap:Body>
     <GetDataResponse xmlns="http://www.microsoft.com/Enterprise
Management/Mom/Connector/V2"
>
       <GetDataResult>
         <NewAlerts>
           <Alert>
             <AckId>guid</AckId>
             <AlertId>guid</AlertId>
             <Name>string</Name>
             <ComputerId>guid</ComputerId>
             <ComputerName>string</ComputerName>
             <ComputerDomain>string</ComputerDomain>
             <Description>string</Description>
             <URL>string</URL>
             <Severity>Success or Information or Warning or Error or
               CriticalError or SecurityIssue or ServiceUnavailable</Severity>
             <OwnerName>string</OwnerName>
             <CustomField1>string</CustomField1>
             <CustomField2>string</CustomField2>
             <CustomField3>string</CustomField3>
             <CustomField4>string</CustomField4>
             <CustomField5>string</CustomField5>
             <RuleId>guid</RuleId>
             <RuleGroupId>guid</RuleGroupId>
             <Source>string</Source>
             <RepeatCount>int</RepeatCount>
             <TimeRaised>dateTime</TimeRaised>
             <TimeAdded>dateTime</TimeAdded>
             <ResolutionState>unsignedByte</ResolutionState>
             <ResolvedBy>string</ResolvedBy>
             <LastTimeStateModified>dateTime</LastTimeStateModified>
             <TimeLastModified>dateTime</TimeLastModified>
             <ModifiedBy>string</ModifiedBy>
             <ServerRole>string</ServerRole>
             <ServerRoleInstance>string</ServerRoleInstance>
             <Component>string</Component>
             <ComponentInstance>string</ComponentInstance>
             <ProblemState>Investigate or Inactive or Active</ProblemState>
             <TicketID>string</TicketID>
             <TimeOfFirstEvent>dateTime</TimeOfFirstEvent>
             <TimeOfLastEvent>dateTime</TimeOfLastEvent>
             <AlertHistory xsi:nil="true" />
           </Alert>
         </NewAlerts>
         <UpdatedAlerts>
           <Alert>
             <AckId>guid</AckId>
             <AlertId>guid</AlertId>
             <Name>string</Name>
             <ComputerId>guid</ComputerId>
             <ComputerName>string</ComputerName>
             <ComputerDomain>string</ComputerDomain>
             <Description>string</Description>
             <URL>string</URL>
             <Severity>Success or Information or Warning or Error or
               CriticalError or SecurityIssue or ServiceUnavailable</Severity>
             <OwnerName>string</OwnerName>
             <CustomField1>string</CustomField1>
             <CustomField2>string</CustomField2>
             <CustomField3>string</CustomField3>
             <CustomField4>string</CustomField4>
             <CustomField5>string</CustomField5>
             <RuleId>guid</RuleId>
             <RuleGroupId>guid</RuleGroupId>
             <Source>string</Source>
             <RepeatCount>int</RepeatCount>
             <TimeRaised>dateTime</TimeRaised>
             <TimeAdded>dateTime</TimeAdded>
             <ResolutionState>unsignedByte</ResolutionState>
             <ResolvedBy>string</ResolvedBy>
             <LastTimeStateModified>dateTime</LastTimeStateModified>
             <TimeLastModified>dateTime</TimeLastModified>
             <ModifiedBy>string</ModifiedBy>
             <ServerRole>string</ServerRole>
             <ServerRoleInstance>string</ServerRoleInstance>
             <Component>string</Component>
             <ComponentInstance>string</ComponentInstance>
             <ProblemState>Investigate or Inactive or Active</ProblemState>
             <TicketID>string</TicketID>
             <TimeOfFirstEvent>dateTime</TimeOfFirstEvent>
             <TimeOfLastEvent>dateTime</TimeOfLastEvent>
             <AlertHistory xsi:nil="true" />
           </Alert>
         </UpdatedAlerts>
       </GetDataResult>
     </GetDataResponse>
   </soap:Body>
 </soap:Envelope>
</mom-response>

 

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