Application Programming Interface Guide > Web Services Operations > Operations Reference > getMostRecentIntrospectionStatus
 
getMostRecentIntrospectionStatus
Get the results from the most recent introspection that was run and committed on the given data source.
Results are in the form of introspection change entries (which contain the path, type, and subtype of the resource that was introspected), the introspection action that occurred, and a message, if available, regarding introspection of that resource.
This operation returns different levels of introspection status based on the value of the detail request element:
NONE: Minimal information to indicate the final run state of the introspection task.
SIMPLE: Overall status plus counts.
FULL: List of introspection change entries, containing all entries and messages that occurred during the last completed and committed introspection.
If the data source has never successfully completed an introspection, the status response element is unset.
Location
/services/webservices/system/admin/resource/operations/
Request Elements
path: The path to the data source.
detail: The level of detail to include in the response. Valid values are NONE, SIMPLE, and FULL.
Response Elements
status (optional): The introspection status report. See Introspection Report Status Element.
Faults
DataSourceError: If a data source connection cannot be established, or if a data source request returns an error.
IllegalArgument: If the path or detail element is malformed.
NotFound: If a data source resource cannot be found at the given path.
Security: If the user does not have READ access on all items in path other than the last one.
Security: If the user does not have WRITE access on the last item in path.
Security: If the user does not have the ACCESS_TOOLS right.