الحصول على واجهة برمجة تطبيقات التنبيهات المتعلقة بالجهز
ينطبق على:
هل تريد تجربة Defender لنقطة النهاية؟ التسجيل للحصول على إصدار تجريبي مجاني.
ملاحظة
إذا كنت أحد عملاء حكومة الولايات المتحدة، فالرجاء استخدام معرفات URI المدرجة في Microsoft Defender لنقطة النهاية لعملاء حكومة الولايات المتحدة.
تلميح
للحصول على أداء أفضل، يمكنك استخدام الخادم الأقرب إلى موقعك الجغرافي:
- us.api.security.microsoft.com
- eu.api.security.microsoft.com
- uk.api.security.microsoft.com
- au.api.security.microsoft.com
- swa.api.security.microsoft.com
- ina.api.security.microsoft.com
وصف واجهة برمجة التطبيقات
استرداد جميع التنبيهات المتعلقة بجهاز معين.
القيود
- يمكنك الاستعلام عن الأجهزة التي تم تحديثها آخر مرة وفقا لفترة الاستبقاء التي تم تكوينها.
- قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 استدعاء في الساعة.
| نوع الإذن | إذن | اسم عرض الإذن |
|---|---|---|
| Application | Alert.Read.All | 'قراءة جميع التنبيهات' |
| Application | Alert.ReadWrite.All | 'قراءة جميع التنبيهات وكتابتها' |
| مفوض (حساب العمل أو المؤسسة التعليمية) | Alert.Read | "قراءة التنبيهات" |
| مفوض (حساب العمل أو المؤسسة التعليمية) | Alert.ReadWrite | "قراءة التنبيهات وكتابتها" |
ملاحظة
عند الحصول على رمز مميز باستخدام بيانات اعتماد المستخدم:
- يحتاج المستخدم إلى الحصول على إذن الدور التالي على الأقل: "عرض البيانات". لمزيد من المعلومات حول الأذونات، راجع إنشاء الأدوار وإدارتها.
- يحتاج المستخدم إلى الوصول إلى الجهاز، استنادا إلى إعدادات مجموعة الأجهزة. لمزيد من المعلومات حول إعدادات مجموعة الأجهزة، راجع إنشاء مجموعات الأجهزة وإدارتها.
يتم دعم إنشاء مجموعة الأجهزة في خطة Defender لنقطة النهاية 1 والخطة 2.
طلب HTTP
GET /api/machines/{id}/alerts
عناوين الطلبات
| الاسم | نوع | الوصف |
|---|---|---|
| إذن | سلسلة | الحامل {token}. مطلوب. |
نص الطلب
أجوف
استجابه
إذا كان ناجحا وكان الجهاز موجودا: 200 موافق مع قائمة كيانات التنبيه في النص الأساسي. إذا لم يتم العثور على الجهاز: 404 غير موجود.
تلميح
هل تريد معرفة المزيد؟ التفاعل مع مجتمع أمان Microsoft في مجتمع التكنولوجيا لدينا: Microsoft Defender for Endpoint Tech Community.