Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-142381,278956.3 KB

Gets information about a Device Defender audit.

Requires permission to access the DescribeAuditTask action.

get/audit/tasks/{taskId}

Path parameters

taskIdstring required

The ID of the audit whose information you want to get.

Response

Success

taskStatus'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'CANCELED'

The status of the audit: one of "IN_PROGRESS", "COMPLETED", "FAILED", or "CANCELED".

taskType'ON_DEMAND_AUDIT_TASK' | 'SCHEDULED_AUDIT_TASK'

The type of audit: "ON_DEMAND_AUDIT_TASK" or "SCHEDULED_AUDIT_TASK".

taskStartTimestring date-time

The time the audit started.

scheduledAuditNamestring

The name of the scheduled audit (only if the audit was a scheduled audit).

auditDetailsobject

Detailed information about each check performed during this audit.