Import uploaded scan

post https://cloud.tenable.com/scans/import

Import an existing scan that was previously uploaded using the POST /file/upload endpoint. Tenable Vulnerability Management supports scan imports up to 4 GB in size.

Note: You cannot import results from scans run more than 15 months ago.

Requires the Basic [16] user role. See Roles.

time	status	user agent
Retrieving recent requests…

Loading…

Responses

Response body

object

name

string

The name of the scan.

status

string

The status of the scan. For a list of possible values, see Scan Status.

integer

The unique ID of the scan.

last_modification_date

int32

For newly-created scans, the date on which the scan configuration was created. For scans that have been launched at least once, this attribute does not represent the date on which the scan configuration was last modified. Instead, it represents the date on which the scan was last launched, in Unix time format. Tenable Vulnerability Management updates this attribute each time the scan launches.

uuid

string

The UUID of the scan.

type

string

The type of scan (local, remote, or agent).

owner

string

The owner of the scan.

enabled

boolean

If true, the schedule for the scan is enabled.

read

boolean

If true, the scan has been read.

shared

boolean

If 1, the scan is shared with users other than the scan owner. The level of sharing is specified in the acls attribute of the scan details.

user_permissions

integer

The sharing permissions for the scan.

creation_date

integer

The creation date for the scan in Unix time.

control

boolean

If true, the scan has a schedule and can be launched.

starttime

string

For one-time scans, the starting time and date for the scan. For recurrent scans, the first date on which the scan schedule is active and the time that recurring scans launch based on the rrules attribute.

This attribute has the following format: YYYYMMDDTHHMMSS.

timezone

string

The timezone of the scheduled start time for the scan.

rrules

string

The interval at which the scan repeats. The interval is formatted as a string of three values delimited by semi-colons. These values are: the frequency (FREQ=ONETIME or DAILY or WEEKLY or MONTHLY or YEARLY), the interval (INTERVAL=1 or 2 or 3 ... x), and the days of the week (BYDAY=SU,MO,TU,WE,TH,FR,SA). For a scan that runs every three weeks on Monday Wednesday and Friday, the string would be FREQ=WEEKLY;INTERVAL=3;BYDAY=MO,WE,FR. If the scan is not scheduled to recur, this attribute is null. For more information, see rrules Format.

Note: To set the rrules parameter for an agent scan, the request must also include the following body parameters:

The uuid parameter must specify an agent scan template. For more information, see Tenable-Provided Agent Templates and the GET /editor/scan/templates endpoint.
The agent_group_id parameter must specify an agent group. For more information, see Agent Groups.

For an example request body for an agent scan, see Example Agent Scan: Recurring.

schedule_uuid

string

The UUID for a specific instance in the scan schedule.

Language

Credentials

Header

Request


xxxxxxxxxx
12
1
import requests
2
3
url = "https://cloud.tenable.com/scans/import"
4
5
headers = {
6
    "accept": "application/json",
7
    "content-type": "application/json"
8
}
9
10
response = requests.post(url, headers=headers)
11
12
print(response.text)


xxxxxxxxxx
19
 
1
{
2
  "scan": {
3
    "timezone": null,
4
    "id": 38,
5
    "last_modification_date": 1544219402,
6
    "status": "imported",
7
    "user_permissions": 128,
8
    "folder_id": null,
9
    "owner": "user2@example.com",
10
    "control": null,
11
    "starttime": null,
12
    "uuid": "e192840b-e7cc-4586-a482-4495758ed8560e3fa8eea4c7cb27",
13
    "rrules": null,
14
    "creation_date": 1544219402,
15
    "read": false,
16
    "name": "KitchenSinkScan",
17
    "shared": false
18
  }
19
}

200Returns the scan object.

409Returned if you attempt to import results from scans run more than 15 months ago.

429Returned if you attempt to send too many requests in a specific period of time. For more information, see Rate Limiting.

500Returned if Tenable Vulnerability Management fails to import the scan.