URL-адрес запроса


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

Приостанавливает мониторинг устройства (например, во время периода обслуживания) на определенный период времени в заданную дату и время.

Чтобы отложить мониторинг устройства до включения вручную, используйте параметр Отложить в запросе на редактирование устройства.

Параметры пути

поле Type Обязательно описание
device_id

струна

true

Уникальный идентификатор устройства мониторинга. Чтобы запросить список идентификаторов устройств на платформе, см. API: Получить список устройств по платформам.

Чтобы просмотреть идентификатор устройства из учетной записи dotcom-monitor, откройте оконечную устройство в списке Диспетчер устройств для редактирования. В адресной строке браузера вы увидите что-то вроде:

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

УстройствоId’63698 является идентификатором устройства.

Параметры заголовка

Content-Type: application/json
Пример: Опубликовать тело запроса, которое отложит мониторинг на 10 минут с момента запроса:
{ 
  "Postpone_Min": 10, 
 }
Пример Опубликовать тело запроса, который отложит мониторинг на 10 минут на указанную дату и время
{ 
  "Postpone_Min": 10, 
  "Date_From": "14-May-2023 12:30" 
}

Параметры кузова

поле Type Обязательно описание
Postpone_min

int

true

Определяет временной промежуток в минутах, на который мониторинг будет приостановлен с момента запроса.

Пример 1:

{ 
"Postpone_Min": 10 
}

Отложит (установит техническое обслуживание) на 10 минут, в момент запроса.

Пример 2. Отложить мониторинг:

{ 
"Postpone_Min": 0 
}

Включит мониторинг отложенного устройства сразу в момент запроса.

Date_From

струна

необязательный

Временная метка, отражающая момент, когда устройство будет отложено.

Пример:

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

Отложит (установит техническое обслуживание) на 10 минут в указанную дату и время. Время устанавливается на основе часового пояса пользователя (автоконвертация на стороне сервера).

Реакция на успех

Пример ответа
{

"Success": true,

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

}