URL de solicitud


POST
https://api.dotcom-monitor.com/config_api_v1/device/{device_id}/PostponeTimed

Pausa el monitoreo del dispositivo (por ejemplo, durante una ventana de mantenimiento) durante un período de tiempo específico en una fecha y hora determinadas.

Para posponer la supervisión del dispositivo hasta que se habilite manualmente, use el parámetro Posponer en la solicitud de edición del dispositivo.

Parámetros de ruta

Campo Tipo Obligatorio Descripción
device_id

Cadena

true

Identificador único de un dispositivo de supervisión. Para solicitar una lista de los ID de los dispositivos dentro de una plataforma, consulte API: Obtener lista de dispositivos por plataforma.

Para ver un identificador de dispositivo desde tu cuenta de monitor puntocom, abre el dispositivo de destino en la lista Administrador de dispositivos para editarlo. En la barra de direcciones del navegador, verás algo como:

https://user.dotcom-monitor.com/ClientID/DeviceEdit?pid=dc7f4ff2ca944dekjh1078b96707002&deviceId=63698&taskId=132834

El deviceId=63698 es el IDENTIFICADOR del dispositivo.

Parámetros de encabezado

Content-Type: application/json
Ejemplo Cuerpo posterior de la solicitud que pospondrá el monitoreo durante 10 minutos desde el momento de la solicitud
{ 
  "Postpone_Min": 10, 
 }
Ejemplo Cuerpo de publicación de la solicitud que pospondrá la supervisión durante 10 minutos en la fecha y hora especificadas
{ 
  "Postpone_Min": 10, 
  "Date_From": "14-May-2023 12:30" 
}

Parámetros del cuerpo

Campo Tipo Obligatorio Descripción
Postpone_min

Int

true

Define el período de tiempo en minutos durante el cual se detendrá la supervisión desde el momento de la solicitud.

Ejemplo 1:

{ 
"Postpone_Min": 10 
}

Pospondrá (establecerá el mantenimiento) durante 10 minutos, en el momento de la solicitud.

Ejemplo 2. Monitoreo no pospuesto:

{ 
"Postpone_Min": 0 
}

Habilitará la supervisión de un dispositivo pospuesto inmediatamente en el momento de la solicitud.

Date_From

Cadena

opcional

Marca de tiempo que refleja el momento en que se pospondrá el dispositivo.

Ejemplo:

{
 "Postpone_Min": 10,
 "Date_From": "14-May-2023 12:30"
}

Pospondrá (establecerá el mantenimiento) durante 10 minutos en la fecha y hora especificadas. La hora se establece en función de la zona horaria del usuario (conversión automática del lado del servidor).

Respuesta de éxito

Ejemplo de respuesta
{

"Success": true,

"Result": "Timed postpone for device 7394 has been set to 10"

}