Pular para o conteúdo principal
GET
/
scans
/
cve
/
scheduled
/
{scanScheduleId}
Recuperar um Agendamento de Varredura
curl --request GET \
  --url https://api.altostrat.io/scans/cve/scheduled/{scanScheduleId} \
  --header 'Authorization: Bearer <token>'
{
  "id": "9c43cc95-f313-49a3-b632-524f7a24503b",
  "description": "Varredura Semanal do Escritório Principal",
  "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

Insira seu token bearer no formato: Bearer {token}

Path Parameters

​
scanScheduleId
string<uuid>
required

O identificador único do agendamento de varredura.

Example:

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

Response

O objeto de agendamento de varredura solicitado.

​
id
string<uuid>

O identificador único para o agendamento de varredura.

Example:

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

​
description
string

Um nome legível por humanos para o agendamento de varredura.

Example:

"Varredura Semanal do Escritório Principal"

​
day_of_week
integer

O dia da semana para executar a varredura (0=Domingo, 1=Segunda-feira, ..., 6=Sábado).

Example:

1

​
time_of_day
string

A hora do dia para executar a varredura no formato 24 horas (HH:mm).

Example:

"02:00"

​
every_n_weeks
integer

A frequência da varredura em semanas (ex 2 para a cada 2 semanas).

Example:

2

​
timezone
string

O fuso horário no qual o time_of_day é especificado.

Example:

"America/New_York"

​
min_cvss
number

A pontuação CVSS mínima para que uma vulnerabilidade seja incluída nos relatórios.

Example:

4

​
warning_threshold
number

A pontuação CVSS na qual uma vulnerabilidade é considerada um aviso de alta prioridade.

Example:

7

​
ignore_offline_sites
boolean

Se verdadeiro, a varredura não falhará se um site estiver offline.

Example:

false

​
next_scan_at
string<date-time>

O timestamp calculado para a próxima varredura agendada.

Example:

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

​
running
boolean

Indica se uma varredura para este agendamento está atualmente em andamento.

Example:

false

​
sites
object[]

Uma lista de sites e suas sub-redes a serem verificados.

​
created_at
string<date-time>

O timestamp de quando o agendamento foi criado.

Example:

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

​
updated_at
string<date-time>

O timestamp de quando o agendamento foi atualizado pela última vez.

Example:

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

​
status
string

O status atual do ciclo de vida do agendamento de varredura.

Example:

"ready"

​
last_run_at
string<date-time>

O timestamp de quando uma varredura para este agendamento foi iniciada pela última vez.

Example:

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

​
notification_group
string

O identificador de um grupo de notificação para receber alertas de varredura.

Example:

"security-alerts"