مشاركة عبر

البحث عن الأجهزة حسب العلامة API

  • مقالة

ينطبق على:

هل تريد تجربة 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

وصف واجهة برمجة التطبيقات

البحث عن الأجهزة حسب العلامة.

startswith الاستعلام مدعوم.

القيود

  1. قيود المعدل لواجهة برمجة التطبيقات هذه هي 100 استدعاء في الدقيقة و1500 استدعاء في الساعة.

الأذونات

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

نوع الإذن اذن اسم عرض الإذن
Application Machine.Read.All 'قراءة جميع ملفات تعريف الجهاز'
Application Machine.ReadWrite.All 'قراءة جميع معلومات الجهاز وكتابتها'
مفوض (حساب العمل أو المؤسسة التعليمية) Machine.Read "قراءة معلومات الجهاز"
مفوض (حساب العمل أو المؤسسة التعليمية) Machine.ReadWrite "قراءة وكتابة معلومات الجهاز"

ملاحظة

عند الحصول على رمز مميز باستخدام بيانات اعتماد المستخدم:

يتم دعم إنشاء مجموعة الأجهزة في خطة Defender لنقطة النهاية 1 والخطة 2.

طلب HTTP

GET /api/machines/findbytag?tag={tag}&useStartsWithFilter={true/false}

عناوين الطلبات

الاسم نوع الوصف
التخويل سلسلة الحامل {token}. مطلوب.

طلب معلمات URI

الاسم نوع الوصف
العلامه سلسلة اسم العلامة. مطلوب.
useStartsWithFilter منطقي عند التعيين إلى صحيح، يبحث البحث عن جميع الأجهزة التي تحمل اسم العلامة التي تبدأ بالعلامة المحددة في الاستعلام. الإعدادات الافتراضية إلى false. اختياري.

نص الطلب

فارغه

استجابه

إذا نجحت - 200 موافق مع قائمة الأجهزة في نص الاستجابة.

المثال

طلب

فيما يلي مثال على الطلب.

GET https://api.securitycenter.microsoft.com/api/machines/findbytag?tag=testTag&useStartsWithFilter=true

تلميح

هل تريد معرفة المزيد؟ Engage مع مجتمع أمان Microsoft في مجتمعنا التقني: Microsoft Defender لنقطة النهاية Tech Community.