Import File Formats
Exclusion Import File
Using the POST /file/upload and POST /exclusions/import API endpoints, you can import exclusions as a comma-separated values (.csv) file for use in scan configuration in Tenable Vulnerability Management.
This file is composed of a header and at least one line of data. Each line in the file must be separated by a new line break.
Header (Optional)
A header line in the file is optional. If included, the header must be the first line in the file and be formatted as follows:
id,name,description,members,creation_date,last_modification_date
Note
There are no spaces after the commas in this line.
Data (Required)
Each data line in the file represents one exclusion configuration.
Each data line is a comma-delimited string of fields described in the table below.
Note
Optional fields can be blank, but the associated comma separator must be present in the data line.
Field | Description | Required |
---|---|---|
id | An integer that uniquely identifies the exclusion. | optional |
name | The name of the exclusion. You can use any combination of alpha-numeric characters or symbols. | required |
description | A description for the exclusion. | required |
members | The target or targets where you want the scan exclusion to apply. This value can have the following formats:
| required |
creation_date | The Unix timestamp that Vulnerability Management uses as the creation date for the imported exclusion(s). | optional |
last_modification_date | The Unix timestamp that Vulnerability Management uses as the last modification date for the exclusion(s). | optional |
Example
id,name,description,members,creation_date,last_modification_date
1,Exclusion Rule 1,routers,"192.0.2.57,192.0.2.177,192.0.2.8",1561643735,1561643785
,Exclusion Rule 2,workstations,192.0.2.57-192.0.2.67,,
Updated about 2 months ago