طلب عنوان URL


نشر
 https://api.dotcom-monitor.com/config_api_v1/devices/PostponeTimed

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

معلمات الرأس

Content-Type: application/json
مثال على نص المنشور للطلب الذي سيؤجل المراقبة للأجهزة المدرجة
{
"SetPostpone": [
  {
   "Device_ID": 7314,
   "Postpone_Min": 20
  },
  {
   "Device_ID": 7925,
   "Postpone_Min": 10,
   "Date_From": "19-May-2023 11:33"
  },
  {
   "Device_ID": 10764,
   "Postpone_Min": 30
  },
  {
   "Device_ID": 12090,
   "Postpone_Min": 900,
   "Date_From": "19-May-2023 11:33"
  }
]
}

معلمات الجسم

ميدان نوع مطلوب وصف
سيت تأجيل

صفيف الكائنات

صحيح

 يحتوي على معلمات لتعيين فترات توقف موقوتة في المراقبة لمجموعة الاختبارات المحددة.
Device_ID

إنت32

صحيح

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

الباحث

صحيح

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

مثال 1:

{
   "Device_ID": 7394,
   "Postpone_Min": 20
}

سيتم تأجيل (تعيين الصيانة) لمدة 10 دقائق للجهاز الذي يحمل المعرف 7394.

مثال 2. إلغاء تأجيل المراقبة:

{ 
"Device_ID":7394
"Postpone_Min": 0 
}

سيمكن المراقبة للجهاز بمعرف 7394 على الفور في لحظة الطلب.
Date_From

خيط

اختياري

 طابع زمني يعكس اللحظة التي سيتم فيها تأجيل الجهاز.

مثال:

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

سيتم تأجيل (تعيين الصيانة) لمدة 10 دقائق للجهاز الذي يحمل المعرف 7394 من التاريخ والوقت المحددين. يتم تعيين الوقت بناء على المنطقة الزمنية للمستخدم (التحويل التلقائي من جانب الخادم).

الاستجابة للنجاح

مثال على الاستجابة
{

"Success": true,

"Result": "Bulk timed postpone has been set."

}