طلب عنوان URL


POST
 https://api.dotcom-monitor.com/config_api_v1/device/{device_id} / تأجيل الوقت

إيقاف مراقبة الجهاز مؤقتا (على سبيل المثال ، أثناء نافذة الصيانة) لفترة زمنية محددة في تاريخ ووقت معينين.

لتأجيل مراقبة الجهاز حتى يتم تمكينه يدويا، استخدم المعلمة تأجيل في طلب تحرير الجهاز.

معلمات المسار

ميدان نوع مطلوب وصف
device_id

خيط

صحيح

 المعرف الفريد لجهاز المراقبة. لطلب قائمة بمعرفات الأجهزة داخل النظام الأساسي، راجع واجهة برمجة التطبيقات: الحصول على قائمة الأجهزة حسب النظام الأساسي.

للاطلاع على معرف جهاز من داخل حساب dotcom-monitor الخاص بك، افتح الجهاز المستهدف في قائمة “إدارة الأجهزة” لتحريره. في شريط عنوان المتصفح، سترى شيئا مثل:

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

معرف الجهاز = 63698 هو معرف الجهاز.

معلمات الرأس

Content-Type: application/json
مثال على نص المنشور للطلب الذي سيؤجل المراقبة لمدة 10 دقائق من لحظة الطلب
{ 
  "Postpone_Min": 10, 
 }
مثال على نص الطلب الذي سيؤجل المراقبة لمدة 10 دقائق في التاريخ والوقت المحددين
{ 
  "Postpone_Min": 10, 
  "Date_From": "14-May-2023 12:30" 
}

معلمات الجسم

ميدان نوع مطلوب وصف
Postpone_min

الباحث

صحيح

 يحدد الفترة الزمنية بالدقائق التي سيتم فيها إيقاف المراقبة مؤقتا من لحظة الطلب.

مثال 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"

}