Vai al contenuto principale
POST
/
scans
/
cve
/
scheduled
Crea Pianificazione Scansione
curl --request POST \
  --url https://api.altostrat.io/scans/cve/scheduled \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "Scansione Settimanale per Sede Principale",
  "day_of_week": 1,
  "time_of_day": "02:00",
  "every_n_weeks": 2,
  "timezone": "America/New_York",
  "min_cvss": 4,
  "warning_threshold": 7,
  "ignore_offline_sites\"": false,
  "notification_group\"": "security-alerts",
  "sites": [
    {
      "id": "9c3c1392-7f36-4240-85f2-273573c0384a",
      "subnet": "192.168.1.0/24"
    }
  ]
}'
{
  "id": "9c43cc95-f313-49a3-b632-524f7a24503b",
  "description": "Scansione Settimanale per Sede Principale",
  "day_of_week": 1,
  "time_of_day": "02:00",
  "every_n_weeks": 2,
  "timezone": "America/New_York",
  "min_cvss": 4,
  "warning_threshold": 7,
  "ignore_offline_sites": false,
  "next_scan_at": "2025-11-10T02:00:00-05:00",
  "running": false,
  "sites": [
    {
      "id": "9c3c1392-7f36-4240-85f2-273573c0384a",
      "subnet": "192.168.1.0/24"
    }
  ],
  "created_at": "2025-10-28T14:30:00Z",
  "updated_at": "2025-10-29T09:00:00Z",
  "status": "ready",
  "last_run_at": "2025-10-27T02:00:00-05:00",
  "notification_group": "security-alerts"
}

Authorizations

​
Authorization
string
header
required

Inserisci il tuo bearer token nel formato: Bearer {token}

Body

application/json

La configurazione per la nuova pianificazione di scansione.

​
description
string
required

Un nome leggibile per la pianificazione di scansione.

Example:

"Scansione Settimanale per Sede Principale"

​
day_of_week
integer
required

Il giorno della settimana in cui eseguire la scansione (0=Domenica, 1=Lunedì, ..., 6=Sabato).

Example:

1

​
time_of_day
string<time>
required

L'ora del giorno in cui eseguire la scansione in formato 24 ore (HH:mm).

Example:

"02:00"

​
every_n_weeks
integer
required

La frequenza della scansione in settimane (es. 2 per ogni 2 settimane). Minimo 2.

Example:

2

​
timezone
string
required

Il nome del database di fusi orari IANA (es. 'America/New_York', 'UTC').

Example:

"America/New_York"

​
min_cvss
number
required

Il punteggio CVSS minimo affinché una vulnerabilità sia inclusa nei report. Deve essere inferiore a warning_threshold.

Example:

4

​
warning_threshold
number
required

Il punteggio CVSS al quale una vulnerabilità è considerata un avviso ad alta priorità. Deve essere maggiore di min_cvss.

Example:

7

​
sites
object[]
required

Un elenco di siti e delle loro sottoreti da scansionare.

​
notification_group
string
required

L'identificatore di un gruppo di notifica per ricevere avvisi di scansione.

Example:

"security-alerts"

​
ignore_offline_sites
boolean

Se vero, la scansione non fallirà se un sito è offline. Il valore predefinito è falso.

Example:

false

Response

La pianificazione della scansione è stata creata con successo.

​
id
string<uuid>

L'identificatore univoco per la pianificazione di scansione.

Example:

"9c43cc95-f313-49a3-b632-524f7a24503b"

​
description
string

Un nome leggibile per la pianificazione di scansione.

Example:

"Scansione Settimanale per Sede Principale"

​
day_of_week
integer

Il giorno della settimana in cui eseguire la scansione (0=Domenica, 1=Lunedì, ..., 6=Sabato).

Example:

1

​
time_of_day
string

L'ora del giorno in cui eseguire la scansione in formato 24 ore (HH:mm).

Example:

"02:00"

​
every_n_weeks
integer

La frequenza della scansione in settimane (es. 2 per ogni 2 settimane).

Example:

2

​
timezone
string

Il fuso orario in cui è specificato time_of_day.

Example:

"America/New_York"

​
min_cvss
number

Il punteggio CVSS minimo affinché una vulnerabilità sia inclusa nei report.

Example:

4

​
warning_threshold
number

Il punteggio CVSS al quale una vulnerabilità è considerata un avviso ad alta priorità.

Example:

7

​
ignore_offline_sites
boolean

Se vero, la scansione non fallirà se un sito è offline.

Example:

false

​
next_scan_at
string<date-time>

Il timestamp calcolato per la prossima scansione pianificata.

Example:

"2025-11-10T02:00:00-05:00"

​
running
boolean

Indica se una scansione per questa pianificazione è attualmente in corso.

Example:

false

​
sites
object[]

Un elenco di siti e delle loro sottoreti da scansionare.

​
created_at
string<date-time>

Il timestamp di creazione della pianificazione.

Example:

"2025-10-28T14:30:00Z"

​
updated_at
string<date-time>

Il timestamp dell'ultimo aggiornamento della pianificazione.

Example:

"2025-10-29T09:00:00Z"

​
status
string

Lo stato attuale del ciclo di vita della pianificazione di scansione.

Example:

"ready"

​
last_run_at
string<date-time>

Il timestamp dell'ultima avvio di una scansione per questa pianificazione.

Example:

"2025-10-27T02:00:00-05:00"

​
notification_group
string

L'identificatore di un gruppo di notifica per ricevere avvisi di scansione.

Example:

"security-alerts"