Lists the Device Defender audits that have been performed during a given time period.
Requires permission to access the ListAuditTasks action.
get/audit/tasks#startTime&endTime
Query parameters
startTimestring date-time required
The beginning of the time period. Audit information is retained for a limited time (90 days). Requesting a start time prior to what is retained results in an "InvalidRequestException".
endTimestring date-time required
The end of the time period.
taskType'ON_DEMAND_AUDIT_TASK' | 'SCHEDULED_AUDIT_TASK'
A filter to limit the output to the specified type of audit: can be one of "ON_DEMAND_AUDIT_TASK" or "SCHEDULED__AUDIT_TASK".
taskStatus'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'CANCELED'
A filter to limit the output to audits with the specified completion status: can be one of "IN_PROGRESS", "COMPLETED", "FAILED", or "CANCELED".
nextTokenstring
The token for the next set of results.
maxResultsinteger
The maximum number of results to return at one time. The default is 25.
Response
Success