added
New Compliance Export API
almost 3 years ago by Lance Duvall
The Tenable.io API now supports compliance data exports. The compliance export API can be used to export data that is an aggregation or summary of all compliance scan data. The summary is updated with the latest audit results as new compliance scans are run. The compliance export API does not return results for individual scans.
New Compliance Export Endpoints
The new compliance export endpoints are described in the table below.
| New Endpoint | Name | Description |
|---|---|---|
| POST /compliance/export | Export compliance data | Exports compliance data that matches the request criteria. |
| GET /compliance/export/{export_uuid}/status | Get compliance export status | Returns the status of a compliance export request. Tenable.io processes the chunks in parallel so the chunks may not complete in order. |
| GET /compliance/export/{export_uuid}/chunks/{chunk_id} | Download compliance chunk | Downloads exported compliance data chunks by ID. Tenable.io processes the chunks in parallel. Chunks are available for download for up to 24 hours after they have been created. Tenable.io returns a 404 message for expired chunks. |
| POST /compliance/export/{export_uuid}/cancel | Cancel compliance export | Cancels the specified compliance export job. If you cancel an export job, Tenable.io finishes any chunk that is currently processing, terminates the processing of any unprocessed chunks, and updates the job status to CANCELLED. If a canceled job includes completed chunks, you can still download those chunks after cancellation. |
🛈 Note
If you do not wish to use any of the body parameters when starting a compliance export job with the POST /compliance/export endpoint you must still supply an empty JSON body, for example:
{}. If no request body is submitted with the POST request a500 Internal Server Errorwill be returned.