Saltar al contenido principal
PUT
/
scans
/
cve
/
scheduled
/
{scanScheduleId}
Actualizar una Programación de Escaneo
curl --request PUT \
  --url https://api.altostrat.io/scans/cve/scheduled/{scanScheduleId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "Escaneo Semanal para Oficina Principal y Sucursal",
  "day_of_week": 2,
  "time_of_day": "03:00",
  "every_n_weeks": 2,
  "timezone": "America/Chicago",
  "min_cvss": 5,
  "warning_threshold": 8,
  "ignore_offline_sites\"": true,
  "notification_group\"": "security-alerts-critical",
  "sites": [
    {
      "id": "9c3c1392-7f36-4240-85f2-273573c0384a",
      "subnet": "192.168.1.0/24"
    },
    {
      "id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
      "subnet": "10.20.0.0/22"
    }
  ]
}'
{
  "id": "9c43cc95-f313-49a3-b632-524f7a24503b",
  "description": "Escaneo Semanal para Oficina 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

Ingrese su token de portador en el formato: Bearer {token}

Path Parameters

​
scanScheduleId
string<uuid>
required

El identificador único de la programación de escaneo a actualizar.

Example:

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

Body

application/json

La configuración actualizada para la programación de escaneo.

​
description
string
required

Un nombre legible por humanos para la programación de escaneo.

Example:

"Escaneo Semanal para Oficina Principal"

​
day_of_week
integer
required

El día de la semana para ejecutar el escaneo (0=Domingo, 1=Lunes, ..., 6=Sábado).

Example:

1

​
time_of_day
string<time>
required

La hora del día para ejecutar el escaneo en formato de 24 horas (HH:mm).

Example:

"02:00"

​
every_n_weeks
integer
required

La frecuencia del escaneo en semanas (p. ej., 2 para cada 2 semanas). Mínimo 2.

Example:

2

​
timezone
string
required

El nombre de la base de datos de zona horaria de la IANA (p. ej., 'America/New_York', 'UTC').

Example:

"America/New_York"

​
min_cvss
number
required

La puntuación CVSS mínima para que una vulnerabilidad se incluya en los informes. Debe ser menor que warning_threshold.

Example:

4

​
warning_threshold
number
required

La puntuación CVSS a partir de la cual una vulnerabilidad se considera una advertencia de alta prioridad. Debe ser mayor que min_cvss.

Example:

7

​
sites
object[]
required

Una lista de sitios y sus subredes a escanear.

​
notification_group
string
required

El identificador de un grupo de notificación para recibir alertas de escaneo.

Example:

"security-alerts"

​
ignore_offline_sites
boolean

Si es verdadero, el escaneo no fallará si un sitio está fuera de línea. El valor predeterminado es falso.

Example:

false

Response

La programación de escaneo se actualizó correctamente.

​
id
string<uuid>

El identificador único para la programación de escaneo.

Example:

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

​
description
string

Un nombre legible por humanos para la programación de escaneo.

Example:

"Escaneo Semanal para Oficina Principal"

​
day_of_week
integer

El día de la semana para ejecutar el escaneo (0=Domingo, 1=Lunes, ..., 6=Sábado).

Example:

1

​
time_of_day
string

La hora del día para ejecutar el escaneo en formato de 24 horas (HH:mm).

Example:

"02:00"

​
every_n_weeks
integer

La frecuencia del escaneo en semanas (p. ej., 2 para cada 2 semanas).

Example:

2

​
timezone
string

La zona horaria en la que se especifica time_of_day.

Example:

"America/New_York"

​
min_cvss
number

La puntuación CVSS mínima para que una vulnerabilidad se incluya en los informes.

Example:

4

​
warning_threshold
number

La puntuación CVSS a partir de la cual una vulnerabilidad se considera una advertencia de alta prioridad.

Example:

7

​
ignore_offline_sites
boolean

Si es verdadero, el escaneo no fallará si un sitio está fuera de línea.

Example:

false

​
next_scan_at
string<date-time>

La marca de tiempo calculada para el próximo escaneo programado.

Example:

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

​
running
boolean

Indica si un escaneo para esta programación está actualmente en progreso.

Example:

false

​
sites
object[]

Una lista de sitios y sus subredes a escanear.

​
created_at
string<date-time>

La marca de tiempo de cuándo se creó la programación.

Example:

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

​
updated_at
string<date-time>

La marca de tiempo de la última actualización de la programación.

Example:

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

​
status
string

El estado actual del ciclo de vida de la programación de escaneo.

Example:

"ready"

​
last_run_at
string<date-time>

La marca de tiempo de la última vez que se inició un escaneo para esta programación.

Example:

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

​
notification_group
string

El identificador de un grupo de notificación para recibir alertas de escaneo.

Example:

"security-alerts"