البحث عن الأجهزة بواسطة واجهة برمجة تطبيقات IP الداخلية
ينطبق على:
هل تريد تجربة 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
وصف واجهة برمجة التطبيقات
ابحث عن الأجهزة التي تمت رؤيتها باستخدام عنوان IP الداخلي المطلوب في النطاق الزمني قبل 15 دقيقة وبعد طابع زمني معين.
القيود
- يجب أن يكون الطابع الزمني المحدد في آخر 30 يوما.
- قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 استدعاء في الساعة.
الأذونات
أحد الأذونات التالية مطلوب لاستدعاء واجهة برمجة التطبيقات هذه. لمعرفة المزيد، بما في ذلك كيفية اختيار الأذونات، راجع استخدام واجهات برمجة تطبيقات Microsoft Defender لنقطة النهاية
| نوع الإذن | إذن | اسم عرض الإذن |
|---|---|---|
| Application | Machine.Read.All | 'قراءة جميع ملفات تعريف الجهاز' |
| Application | Machine.ReadWrite.All | 'قراءة جميع معلومات الجهاز وكتابتها' |
| مفوض (حساب العمل أو المؤسسة التعليمية) | Machine.Read | "قراءة معلومات الجهاز" |
| مفوض (حساب العمل أو المؤسسة التعليمية) | Machine.ReadWrite | "قراءة وكتابة معلومات الجهاز" |
ملاحظة
عند الحصول على رمز مميز باستخدام بيانات اعتماد المستخدم:
- ستتضمن الاستجابة الأجهزة التي يمكن للمستخدم الوصول إليها فقط استنادا إلى إعدادات مجموعة الأجهزة (لمزيد من المعلومات، راجع إنشاء مجموعات الأجهزة وإدارتها)
- يحتاج المستخدم إلى الحصول على إذن الدور التالي على الأقل: "عرض البيانات" (لمزيد من المعلومات، راجع إنشاء الأدوار وإدارتها)
- ستتضمن الاستجابة الأجهزة التي يمكن للمستخدم الوصول إليها فقط استنادا إلى إعدادات مجموعة الأجهزة (لمزيد من المعلومات، راجع إنشاء مجموعات الأجهزة وإدارتها)
يتم دعم إنشاء مجموعة الأجهزة في خطة Defender لنقطة النهاية 1 والخطة 2.
طلب HTTP
GET /api/machines/findbyip(ip='{IP}',timestamp={TimeStamp})
عناوين الطلبات
| الاسم | نوع | الوصف |
|---|---|---|
| إذن | سلسلة | الحامل {token}. مطلوب. |
نص الطلب
أجوف
استجابه
إذا نجحت - 200 موافق مع قائمة الأجهزة في نص الاستجابة. إذا لم يكن الطابع الزمني في آخر 30 يوما - 400 طلب غير صحيح.
مثل
طلب
فيما يلي مثال على الطلب.
GET https://api.securitycenter.microsoft.com/api/machines/findbyip(ip='10.248.240.38',timestamp=2019-09-22T08:44:05Z)
تلميح
هل تريد معرفة المزيد؟ التفاعل مع مجتمع أمان Microsoft في مجتمع التكنولوجيا لدينا: Microsoft Defender for Endpoint Tech Community.